71 lines
1.9 KiB
Markdown
71 lines
1.9 KiB
Markdown
# TECH_STACK.md
|
||
|
||
## 1. 目的
|
||
本文件锁定当前项目技术栈与精确版本，避免生成代码时发生版本漂移。
|
||
|
||
关联文档：
|
||
- PRD.md
|
||
- IMPLEMENTATION_PLAN.md
|
||
|
||
## 2. 运行环境
|
||
- Node.js: `24.11.0`
|
||
- npm: `11.6.1`
|
||
- OS（当前开发环境）: macOS
|
||
|
||
## 3. Web 框架与构建
|
||
- Vue: `3.5.28`
|
||
- Vite: `7.3.1`
|
||
- @vitejs/plugin-vue: `6.0.4`
|
||
- TypeScript: `5.9.3`
|
||
- vue-tsc: `3.2.4`
|
||
|
||
## 4. 核心业务依赖
|
||
- echarts: `5.6.0`
|
||
- papaparse: `5.5.3`
|
||
- xlsx (SheetJS): `0.18.5`
|
||
|
||
## 5. 代码质量与测试
|
||
- vitest: `3.2.4`
|
||
- eslint: `8.57.1`
|
||
- @typescript-eslint/eslint-plugin: `8.55.0`
|
||
- @typescript-eslint/parser: `8.55.0`
|
||
- eslint-plugin-vue: `9.33.0`
|
||
- vue-eslint-parser: `9.4.3`
|
||
- eslint-config-prettier: `10.1.8`
|
||
- prettier: `3.8.1`
|
||
|
||
## 6. 类型依赖
|
||
- @types/node: `24.10.13`
|
||
- @types/papaparse: `5.5.2`
|
||
|
||
## 7. NPM Scripts（唯一入口）
|
||
- `npm run dev`: 启动开发服务器
|
||
- `npm run build`: 类型检查 + 生产构建
|
||
- `npm run preview`: 预览构建产物
|
||
- `npm run type-check`: 仅类型检查
|
||
- `npm run lint`: ESLint 检查
|
||
- `npm run test`: Vitest 单测
|
||
- `npm run format`: Prettier 检查
|
||
|
||
## 8. 目录与模块边界
|
||
- `src/core/*`: 纯业务逻辑（解析、聚合、类型）
|
||
- `src/App.vue`: Web 页面与交互
|
||
- `src/styles.css`: 全局样式
|
||
- `src/theme-presets.ts`: 主题色预设
|
||
- `miniapp/*`: 小程序骨架
|
||
|
||
## 9. 开发服务器约束
|
||
`vite.config.ts` 当前使用本地 HTTPS 证书路径：
|
||
- `~/mac.biboer.cn_ecc/fullchain.cer`
|
||
- `~/mac.biboer.cn_ecc/mac.biboer.cn.key`
|
||
|
||
若本机无该证书，`npm run dev` 需要先调整 Vite 配置。
|
||
|
||
## 10. 依赖治理规则
|
||
- 生产依赖新增/升级必须先确认。
|
||
- 版本锁定以 `package-lock.json` + 本文档为准。
|
||
- 未在本文档出现的库，默认不可在实现中使用。
|
||
|
||
## 11. 后端说明
|
||
当前无后端服务、无数据库、无认证（详见 BACKEND_STRUCTURE.md）。
|