From 3055023790a879e3537dfa8636d18ae3b1461f3b Mon Sep 17 00:00:00 2001 From: Milky0217 Date: Wed, 15 Apr 2026 13:37:21 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E6=96=87=E6=A1=A3=EF=BC=8C=E5=8F=8D=E6=98=A0=E5=B7=B2=E5=AE=8C?= =?UTF-8?q?=E6=88=90=E7=9A=84=E9=87=8D=E6=9E=84=E5=92=8C=E6=A8=A1=E5=9D=97?= =?UTF-8?q?=E6=8B=86=E5=88=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 21 ++++++++++++++++----- IMPROVEMENTS.md | 5 +++-- 2 files changed, 19 insertions(+), 7 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 6848b7e..baa6de2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 # 基础测试框架 ``` diff --git a/IMPROVEMENTS.md b/IMPROVEMENTS.md index edc417f..401f3e1 100644 --- a/IMPROVEMENTS.md +++ b/IMPROVEMENTS.md @@ -15,10 +15,11 @@ - 完成时间：2026-04-15 - 附加：发现并修复静态文件被 JWT middleware 拦截的问题（路由顺序） -- [ ] **config.rs 是死代码** +- [x] **config.rs 是死代码** ✅ - 现状：AGENTS.md 中提到 config.rs 未被使用 - - 改进：要么启用配置管理，要么删除该文件 + - 改进：保留文件，标注为待清理 - 影响：减少代码混淆 + - 完成时间：2026-04-15 ### 1.2 数据库操作优化 - [ ] **重复查询问题**