1.3 KiB
1.3 KiB
技术需求
开发与协作规范
- 文档管理：根目录新建“开发文档”文件夹，每次新功能开发后更新“开发文档/功能迭代记录.md”（含开发流程+架构图）。
- API文件：统一存放至APP目录下“API”文件夹。
- 需求对齐：编写新代码前，先阅读“开发文档/需求文档.md”与“开发文档/功能迭代记录.md”。
前端优化
- 技术栈：React、Shadcn UI、Tailwind CSS。
- 强制要求：引入Skeleton组件实现骨架屏预加载。
- 风格适配：Vant UI+Tailwind微调模拟iOS风格（字体栈→San Francisco；颜色/阴影/圆角→像素级匹配截图；布局间距→1:1校准）。
- 交互优化：路由切换添加
<transition>动画（滑动/淡入淡出）；数据加载时显示van-skeleton骨架屏。
后端规范
- 语言：Python (FastAPI/Flask)
- 依赖管理：使用
pip或poetry管理依赖，安装前检查requirements.txt。 - 安全：运行系统命令前评估安全性（避开黑名单命令，如
rm -rf）。 - AI能力：需集成 LLM 调用接口与向量处理能力。
数据库
- 核心数据库：MongoDB（需支持向量检索以适配 AI 功能）。
- 查询要求：支持基于语义的 AI 模糊查询与推荐。