# 技术需求

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