feat: 初始化考培练系统项目

- 从服务器拉取完整代码
- 按框架规范整理项目结构
- 配置 Drone CI 测试环境部署
- 包含后端(FastAPI)、前端(Vue3)、管理端

技术栈: Vue3 + TypeScript + FastAPI + MySQL
This commit is contained in:
111
2026-01-24 19:33:28 +08:00
commit 998211c483
1197 changed files with 228429 additions and 0 deletions

View 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 配置 |