docs: 更新项目文档,反映已完成的重构和模块拆分

This commit is contained in:
2026-04-15 13:37:21 +08:00
parent ef47232b1e
commit 3055023790
2 changed files with 19 additions and 7 deletions

View File

@@ -18,15 +18,26 @@
```
src/
├── main.rs # 入口文件,所有路由处理器,服务器配置
├── auth.rs # JWT 中间件,令牌生成/验证
├── db.rs # 数据库操作(通过 sqlx 执行原始 SQL
├── models.rs # 数据结构Claims、User、WeatherData 等)
── config.rs # 配置结构体(main.rs 中未使用 — 死代码)
├── main.rs # 入口文件,服务器配置,路由注册
├── auth.rs # JWT 中间件,令牌生成/验证
├── db.rs # 数据库操作(通过 sqlx 执行原始 SQL
├── models.rs # 数据结构Claims、User、WeatherData 等)
── config.rs # 配置结构体(未使用 — 死代码,待清理
└── handlers/ # 路由处理器模块
├── mod.rs # 模块导出
├── auth.rs # 登录相关 (login)
├── weather.rs # 天气数据 CRUD (post_weather_data, get_weather, delete_weather)
├── user.rs # 用户相关 (get_user_profile)
├── admin.rs # 管理员功能 (update_user_payment, get_user_by_admin)
├── health.rs # 健康检查 (/health)
└── static_files.rs # 静态文件服务 (/static/{path})
migrations/
└── 001_add_payment_fields.sql # 用于添加支付字段的 ALTER TABLE
static/
└── katex/ # KaTeX 数学公式渲染库
tests/
└── integration_test.rs # 基础测试框架
```

View File

@@ -15,10 +15,11 @@
- 完成时间2026-04-15
- 附加:发现并修复静态文件被 JWT middleware 拦截的问题(路由顺序)
- [ ] **config.rs 是死代码**
- [x] **config.rs 是死代码**
- 现状AGENTS.md 中提到 config.rs 未被使用
- 改进:要么启用配置管理,要么删除该文件
- 改进:保留文件,标注为待清理
- 影响:减少代码混淆
- 完成时间2026-04-15
### 1.2 数据库操作优化
- [ ] **重复查询问题**