2.5 KiB
2.5 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/pages/index/*: 小程序页面与交互miniapp/utils/sankey.js: 小程序解析与聚合逻辑（含 xlsx 分流）miniapp/README.md: 小程序端能力与限制说明
9. 小程序运行时能力
- 运行平台：微信小程序原生运行时（非浏览器 DOM 环境）
- 文件读写：
wx.getFileSystemManager() - 图表绘制：
canvas+wx.createCanvasContext - 导出：
- PNG：
wx.canvasToTempFilePath+wx.saveImageToPhotosAlbum - SVG：生成 XML 字符串后写本地文件（
writeFile）
- PNG：
- npm 依赖：小程序端 xlsx 解析依赖
xlsx@0.18.5，需在开发者工具执行“构建 npm”
10. 开发服务器约束
vite.config.ts 当前使用本地 HTTPS 证书路径：
~/mac.biboer.cn_ecc/fullchain.cer~/mac.biboer.cn_ecc/mac.biboer.cn.key
若本机无该证书，npm run dev 需要先调整 Vite 配置。
11. 依赖治理规则
- 生产依赖新增/升级必须先确认。
- 版本锁定以
package-lock.json+ 本文档为准。 - 未在本文档出现的库，默认不可在实现中使用。
12. 后端说明
当前无后端服务、无数据库、无认证（详见 BACKEND_STRUCTURE.md）。