feat: 初始化考培练系统项目
- 从服务器拉取完整代码 - 按框架规范整理项目结构 - 配置 Drone CI 测试环境部署 - 包含后端(FastAPI)、前端(Vue3)、管理端 技术栈: Vue3 + TypeScript + FastAPI + MySQL
This commit is contained in:
77
docs/规划/团队基线.md
Normal file
77
docs/规划/团队基线.md
Normal file
@@ -0,0 +1,77 @@
|
||||
# 考培练系统团队基线
|
||||
|
||||
> 本文档为索引文件,指向实际的规范与约定文档
|
||||
>
|
||||
> 最后更新:2026-01-21
|
||||
|
||||
## 📄 主文档位置
|
||||
|
||||
**完整的团队基线规范请查看:**
|
||||
|
||||
👉 [规范与约定-团队基线.md](./全链路联调/规范与约定-团队基线.md)
|
||||
|
||||
## 📑 快速导航
|
||||
|
||||
### 技术栈规范(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](./全链路联调/联调经验汇总.md)
|
||||
|
||||
记录所有联调问题及解决方案,按时间倒序排列。
|
||||
|
||||
---
|
||||
|
||||
## 📐 相关规范文档
|
||||
|
||||
| 文档 | 说明 |
|
||||
|------|------|
|
||||
| [瑞小美系统技术栈标准与字符标准.md](./瑞小美系统技术栈标准与字符标准.md) | 技术栈、部署、字符标准 |
|
||||
| [瑞小美AI接入规范.md](./瑞小美AI接入规范.md) | AI 服务商、Key 管理、提示词规范 |
|
||||
| [部署架构-统一版.md](./部署架构-统一版.md) | 容器、网络、SSL 配置 |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user