48 lines
1.9 KiB
Markdown
48 lines
1.9 KiB
Markdown
|
# 技术栈（Tech Stack）
|
|||
|
|
|
|||
|
|
> “用什么”的统一速查表。选型与理由在此集中维护；“怎么把它们搭起来”见 [架构设计](04-architecture.md)。
|
|||
|
|
> 未定项必须标为待定，不要让 agent 在代码里自行决定。
|
|||
|
|
|
|||
|
|
## 一、技术栈一览
|
|||
|
|
|
|||
|
|
| 维度 | 选型 | 状态 | 理由 / 说明 |
|
|||
|
|
| --- | --- | --- | --- |
|
|||
|
|
| 前端框架 | 【例如 React / Vue / go-app / 原生】 | 【已定 / 待定】 | 【理由】 |
|
|||
|
|
| UI 样式方案 | 【例如 CSS / Tailwind / 组件库】 | 【已定 / 待定】 | 【理由】 |
|
|||
|
|
| 状态管理 | 【例如框架内置 / Zustand / Redux】 | 【已定 / 待定】 | 【理由】 |
|
|||
|
|
| 后端 | 【例如 Go net/http / FastAPI / NestJS】 | 【已定 / 待定】 | 【理由】 |
|
|||
|
|
| 数据库 | 【例如 SQLite / Postgres / MySQL】 | 【已定 / 待定】 | 【理由】 |
|
|||
|
|
| 鉴权方式 | 【例如 Session Cookie / JWT / 无账号】 | 【已定 / 待定】 | 【理由】 |
|
|||
|
|
| 部署方式 | 【例如单二进制 / Docker / Vercel】 | 【已定 / 待定】 | 【理由】 |
|
|||
|
|
| 测试 | 【例如 go test / pytest / vitest】 | 【已定 / 待定】 | 【理由】 |
|
|||
|
|
|
|||
|
|
## 二、决策记录与演进
|
|||
|
|
|
|||
|
|
- 【选型 1】：现在选择【方案】，因为【理由】。未来在【条件】出现时再评估【替代方案】。
|
|||
|
|
- 【选型 2】：当前不引入【工具 / 框架】，避免【复杂度】。
|
|||
|
|
|
|||
|
|
## 三、构建与运行命令
|
|||
|
|
|
|||
|
|
| 用途 | 命令 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| 安装依赖 | `【命令】` |
|
|||
|
|
| 本地开发 | `【命令】` |
|
|||
|
|
| 构建 | `【命令】` |
|
|||
|
|
| 测试 | `【命令】` |
|
|||
|
|
| 格式化 / 静态检查 | `【命令】` |
|
|||
|
|
|
|||
|
|
Windows PowerShell 如有差异，单独列出：
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
# 示例
|
|||
|
|
npm install
|
|||
|
|
npm run dev
|
|||
|
|
npm test
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 四、依赖纪律
|
|||
|
|
|
|||
|
|
- 新增第三方依赖前，先说明用途、替代方案和维护成本。
|
|||
|
|
- 不确定的技术选型先更新本文，再进入代码。
|
|||
|
|
- 不允许同一职责并存两套框架或两套状态管理方案。
|