23 lines
1.3 KiB
Markdown
23 lines
1.3 KiB
Markdown
|
# 技术需求
|
|||
|
|
|
|||
|
|
## 开发与协作规范
|
|||
|
|
- **文档管理**：根目录新建“开发文档”文件夹，每次新功能开发后更新“开发文档/功能迭代记录.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 模糊查询与推荐。
|