1.9 KiB
1.9 KiB
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）。