# 考培练系统团队基线

> 本文档为索引文件，指向实际的规范与约定文档
> 
> 最后更新：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 配置 |


