998211c483
- 从服务器拉取完整代码 - 按框架规范整理项目结构 - 配置 Drone CI 测试环境部署 - 包含后端(FastAPI)、前端(Vue3)、管理端 技术栈: Vue3 + TypeScript + FastAPI + MySQL
2.5 KiB
2.5 KiB
考培练系统团队基线
本文档为索引文件，指向实际的规范与约定文档
最后更新：2026-01-21
📄 主文档位置
完整的团队基线规范请查看：
📑 快速导航
技术栈规范（2026-01-18 更新）
| 层级 | 技术要求 |
|---|---|
| 前端语言 | TypeScript（禁止 JavaScript） |
| 前端框架 | Vue 3 + Vite |
| 包管理器 | pnpm（禁止 npm/yarn） |
| 代码规范 | ESLint 必须配置 |
| UI 组件库 | Element Plus |
数据库规范
- 数据库数据规范
- 字符集与排序规则（utf8mb4 + utf8mb4_unicode_ci）
- 用户姓名字段规范
前端规范
- 静态资源访问规范
- API响应数据访问规范
- 前端API调用条件检查规范（2026-01-17新增）
- SCSS样式开发规范
后端规范
- 时区与时间处理规范
- SQLAlchemy joinedload规范
- JSON字段处理规范
Docker 部署规范（2026-01-18 新增）
- 镜像版本：禁用 latest，使用具体版本号
- 日志配置：必须配置轮转（max-size: 10m, max-file: 3）
- 资源限制：前端 256M，后端 512M
- 敏感信息：禁止硬编码，使用 env_file
AI 服务开发规范（2026-01-21 更新）
- 统一服务：通过
AIService调用，禁止直接请求 API - 配置来源：从管理库
kaopeilian_admin.tenant_configs加载（按 TENANT_CODE） - 服务商策略：首选 4sapi.com → 备选 OpenRouter（自动降级）
- 提示词文件：
prompts/{功能名}_prompts.py，必须包含PROMPT_META - db_session：必须传入，用于记录调用日志
- 无外部平台依赖：所有 AI 功能使用 Python 原生实现
- 容器环境变量：必须配置
TENANT_CODE和ADMIN_DB_*连接信息
系统集成规范
- HTTP响应拦截器规范
📝 联调经验汇总
记录所有联调问题及解决方案，按时间倒序排列。
📐 相关规范文档
| 文档 | 说明 |
|---|---|
| 瑞小美系统技术栈标准与字符标准.md | 技术栈、部署、字符标准 |
| 瑞小美AI接入规范.md | AI 服务商、Key 管理、提示词规范 |
| 部署架构-统一版.md | 容器、网络、SSL 配置 |