save code

This commit is contained in:
xsl
2026-01-25 12:47:29 +08:00
parent f33a902c95
commit 688adc32d3
13 changed files with 1014 additions and 1122 deletions
+37
View File
@@ -0,0 +1,37 @@
# 后端开发目录
## 目录说明
### src/
源代码目录,包含所有后端业务逻辑代码。
#### controllers/
控制器层,处理HTTP请求和响应。
#### services/
服务层,实现业务逻辑。
#### models/
数据模型,定义数据库表结构。
#### routes/
路由定义,配置API端点。
#### middleware/
中间件,处理认证、日志等横切关注点。
#### utils/
工具函数,提供通用功能。
### tests/
测试目录,包含单元测试和集成测试。
### docs/
文档目录,包含API文档和技术文档。
### config/
配置目录,包含数据库配置、环境变量等。
## 工作规范
详见 [WORKSTANDARDS.md](WORKSTANDARDS.md)
+57
View File
@@ -0,0 +1,57 @@
# 后端程序员工作规范
## 工作目录
- **主目录**: `backend/`
- **代码目录**: `backend/src/`
- **测试目录**: `backend/tests/`
- **文档目录**: `backend/docs/`
- **配置目录**: `backend/config/`
## 开发规范
### 代码结构
```
backend/
├── src/ # 源代码
│ ├── controllers/ # 控制器
│ ├── services/ # 业务逻辑
│ ├── models/ # 数据模型
│ ├── routes/ # 路由定义
│ ├── middleware/ # 中间件
│ └── utils/ # 工具函数
├── tests/ # 单元测试和集成测试
├── docs/ # API文档和技术文档
├── config/ # 配置文件
└── requirements.txt # Python依赖(如使用Python
```
### 开发流程
1.`backend/src/` 中编写业务代码
2.`backend/tests/` 中编写单元测试
3.`backend/docs/` 中编写API文档
4. 提交前必须运行测试
### 代码提交规范
- 提交信息格式: `[backend] <类型>: <描述>`
- 类型: feat, fix, docs, style, refactor, test, chore
- 示例: `[backend] feat: 添加用户认证API`
### 禁止事项
- ❌ 不得在 `frontend/``testing/` 目录中工作
- ❌ 不得修改公共配置文件(需提交技术总监审批)
- ❌ 不得提交包含敏感信息的代码
## API文档要求
- 所有API必须在 `backend/docs/api.md` 中文档化
- 文档包含: 接口路径、请求方法、参数、返回值、错误码
- 使用OpenAPI/Swagger格式
## 测试要求
- 单元测试覆盖率 > 80%
- 所有新增功能必须有对应测试
- 测试文件命名: `test_<模块名>.py``<模块名>.test.js`
## 技术栈
- 语言: Python/Node.js/Go
- 框架: 根据项目需求选择
- 数据库: PostgreSQL/MySQL/MongoDB