998211c483
- 从服务器拉取完整代码 - 按框架规范整理项目结构 - 配置 Drone CI 测试环境部署 - 包含后端(FastAPI)、前端(Vue3)、管理端 技术栈: Vue3 + TypeScript + FastAPI + MySQL
78 lines
2.5 KiB
Markdown
78 lines
2.5 KiB
Markdown
# 考培练系统团队基线
|
||
|
||
> 本文档为索引文件，指向实际的规范与约定文档
|
||
>
|
||
> 最后更新：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 配置 |
|
||
|
||
|