oil-price-monitoring

6 Commits 1 Branch 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
maxfandClaude	d6d034727b	feat: 邮箱找回密码 + 日志体系完善 + SMTP 配置补全 ## 功能 - 邮箱找回密码：新增 password_resets 表 + POST /api/auth/forgot-password （按接收邮箱反查用户 → 生成一次性 30 分钟令牌 → 复用 SMTP 发重置邮件，防枚举统一提示、复用登录限流器防刷）+ POST /api/auth/reset （校验令牌有效性 → bcrypt 更新密码 → 作废令牌 → 强制该用户全部会话下线）； H5 新增 /forgot、/reset 页面，登录页加"忘记密码"入口 - SMTP 全局配置补全：新增发件邮箱 smtp_user / 授权码 smtp_pass 字段（H5 + 小程序设置页同步展示与保存），GET 脱敏回显，修复"脱敏值含 * 被 POST 写回覆盖真实配置"的 bug - 新增 cmd/sendmail 真实发送工具（配置走环境变量，敏感信息不落库，已用 163 SMTP 465 隐式 SSL 实测发送成功） ## 日志体系 - 死配置 OIL_MONITOR_LOG_DIR 替换为 OIL_MONITOR_LOG_LEVEL （debug/info/warn/error，LevelVar 动态切换，上线默认 info 收敛日志） - 自定义 requestLogger 请求日志中间件（Debug 级：method/path/status/耗时/IP） - 外部交互日志统一：爬虫抓取 / SMTP / Webhook / 高德 regeo / 微信 code2session，成功 Debug、失败 Error、均带 dur_ms、URL 去 query 脱敏防 key/token 泄露 - 定时任务统一 runTask 包装：开始 Debug、完成+时长 Info、失败/panic Error （panic 被 recover，不连累调度器） ## 测试 - cron/scheduler_test.go：runTask 成功/失败/panic 三路径单测 - push/sender_test.go：本地假 SMTP 服务器完整发送会话链路 + 服务器拒绝失败路径 - db_test.go：表数量断言 11 → 12（新增 password_resets） ## 部署配置与文档 - Dockerfile / docker-compose.yml / .env.example / README：日志配置同步（删 /app/logs 目录与挂载，OIL_MONITOR_LOG_LEVEL） - .gitignore：忽略 internal/pkg 依赖缓存（349M，防误提交） - docs/10/21/22/23/24：同步 A18/A19 接口、password_resets 表、任务执行日志、SMTP 字段 Co-Authored-By: Claude <noreply@anthropic.com>	2026-09-28 10:26:59 +08:00
maxf	563052575a	阶段一（MVP 全栈）全部完成。最终交付如下： ## ✅ 完整系统已可运行 ``` F:\coding\oil-price-monitoring\ ├─ cmd/server/main.go 入口（DB + cron + HTTP） ├─ internal/ │ ├─ api/ A1-A17 全部接口 + 路由 + 前端挂载 │ ├─ auth/ bcrypt / 会话 / auth+admin 中间件 │ ├─ crawler/ 三路采集器（sina/ndrc/qiyoujiage）+ 测试 │ ├─ cron/ T1-T6 调度 + 预测 + 推送 + 工作日计算 │ ├─ db/ schema.sql（8 表）+ 迁移 + 测试 │ ├─ model/ 领域模型 │ ├─ push/ 飞书/企微/钉钉/SMTP 发送器 + 测试 │ ├─ service/ 共享 impact / province 服务 │ └─ web/ 前端 6 页面（embed 进二进制） ├─ Dockerfile + docker-compose.yml + .gitignore └─ docs/ 10.概要设计 + 20-24.详细设计（6 份） ``` ## 🚀 运行方式 ```bash # 本地 go run ./cmd/server # 打开 http://localhost:8080 # 服务器（Docker） docker compose up -d --build # 单镜像 ~20MB，数据挂载 ./data ``` ## ✅ 真实数据链路验证（本次开发实测） \| 链路 \| 结果 \| \|---\|---\| \| 新浪原油 \| `Brent=99.45 WTI=93.24`（实时） \| \| 发改委今日调控 \| 汽 +395 元/吨（应调+830）柴 +385（应调+800），生效 9/25 00:00 \| \| 31 省价格 \| 北京 92#=8.29 / 95#=8.83 / 98#=10.33 / 0#=8.02 \| \| API 端到端 \| dashboard/provinces/history/vehicles CRUD/settings/auth 全部通过 \| \| 前端页面 \| 6 页全部 200，静态资源正常 \| ## 📌 系统能力速览 - 匿名访客：看行情 / 省份切换（最近 5 省 LRU）/ 历史调价 / 浏览器定位（Geolocation→高德逆编码） - 登录用户：车辆管理（CRUD + 调价成本测算 + 加油建议）、个人推送渠道配置 - 后台自动：每日 05:00 原油采集→05:05 预测；调价日 16-18 点高频监测发改委→入库→重算预测→同步 31 省→按用户推送（飞书/企微/钉钉/SMTP） - admin：首用户自动成为管理员，可配高德 Key / SMTP 服务器	2026-09-24 21:13:58 +08:00

Author

SHA1

Message

Date

maxfandClaude

d6d034727b

feat: 邮箱找回密码 + 日志体系完善 + SMTP 配置补全

## 功能
- 邮箱找回密码：新增 password_resets 表 + POST /api/auth/forgot-password
  （按接收邮箱反查用户 → 生成一次性 30 分钟令牌 → 复用 SMTP 发重置邮件，
   防枚举统一提示、复用登录限流器防刷）+ POST /api/auth/reset
  （校验令牌有效性 → bcrypt 更新密码 → 作废令牌 → 强制该用户全部会话下线）；
  H5 新增 /forgot、/reset 页面，登录页加"忘记密码"入口
- SMTP 全局配置补全：新增发件邮箱 smtp_user / 授权码 smtp_pass 字段
  （H5 + 小程序设置页同步展示与保存），GET 脱敏回显，
  修复"脱敏值含 * 被 POST 写回覆盖真实配置"的 bug
- 新增 cmd/sendmail 真实发送工具（配置走环境变量，敏感信息不落库，
  已用 163 SMTP 465 隐式 SSL 实测发送成功）

## 日志体系
- 死配置 OIL_MONITOR_LOG_DIR 替换为 OIL_MONITOR_LOG_LEVEL
  （debug/info/warn/error，LevelVar 动态切换，上线默认 info 收敛日志）
- 自定义 requestLogger 请求日志中间件（Debug 级：method/path/status/耗时/IP）
- 外部交互日志统一：爬虫抓取 / SMTP / Webhook / 高德 regeo / 微信 code2session，
  成功 Debug、失败 Error、均带 dur_ms、URL 去 query 脱敏防 key/token 泄露
- 定时任务统一 runTask 包装：开始 Debug、完成+时长 Info、失败/panic Error
  （panic 被 recover，不连累调度器）

## 测试
- cron/scheduler_test.go：runTask 成功/失败/panic 三路径单测
- push/sender_test.go：本地假 SMTP 服务器完整发送会话链路 + 服务器拒绝失败路径
- db_test.go：表数量断言 11 → 12（新增 password_resets）

## 部署配置与文档
- Dockerfile / docker-compose.yml / .env.example / README：日志配置同步
  （删 /app/logs 目录与挂载，OIL_MONITOR_LOG_LEVEL）
- .gitignore：忽略 internal/pkg 依赖缓存（349M，防误提交）
- docs/10/21/22/23/24：同步 A18/A19 接口、password_resets 表、任务执行日志、SMTP 字段

Co-Authored-By: Claude <noreply@anthropic.com>

2026-09-28 10:26:59 +08:00

maxf

563052575a

阶段一（MVP 全栈）**全部完成**。最终交付如下：

## ✅ 完整系统已可运行

```
F:\coding\oil-price-monitoring\
├─ cmd/server/main.go           入口（DB + cron + HTTP）
├─ internal/
│  ├─ api/        A1-A17 全部接口 + 路由 + 前端挂载
│  ├─ auth/       bcrypt / 会话 / auth+admin 中间件
│  ├─ crawler/    三路采集器（sina/ndrc/qiyoujiage）+ 测试
│  ├─ cron/       T1-T6 调度 + 预测 + 推送 + 工作日计算
│  ├─ db/         schema.sql（8 表）+ 迁移 + 测试
│  ├─ model/      领域模型
│  ├─ push/       飞书/企微/钉钉/SMTP 发送器 + 测试
│  ├─ service/    共享 impact / province 服务
│  └─ web/        前端 6 页面（embed 进二进制）
├─ Dockerfile + docker-compose.yml + .gitignore
└─ docs/          10.概要设计 + 20-24.详细设计（6 份）
```

## 🚀 运行方式

```bash
# 本地
go run ./cmd/server           # 打开 http://localhost:8080

# 服务器（Docker）
docker compose up -d --build  # 单镜像 ~20MB，数据挂载 ./data
```

## ✅ 真实数据链路验证（本次开发实测）

| 链路 | 结果 |
|---|---|
| 新浪原油 | `Brent=99.45 WTI=93.24`（实时） |
| 发改委今日调控 | 汽 **+395 元/吨（应调+830）** 柴 +385（应调+800），生效 9/25 00:00 |
| 31 省价格 | 北京 92#=8.29 / 95#=8.83 / 98#=10.33 / 0#=8.02 |
| API 端到端 | dashboard/provinces/history/vehicles CRUD/settings/auth 全部通过 |
| 前端页面 | 6 页全部 200，静态资源正常 |

## 📌 系统能力速览

- **匿名访客**：看行情 / 省份切换（最近 5 省 LRU）/ 历史调价 / 浏览器定位（Geolocation→高德逆编码）
- **登录用户**：车辆管理（CRUD + 调价成本测算 + 加油建议）、个人推送渠道配置
- **后台自动**：每日 05:00 原油采集→05:05 预测；调价日 16-18 点高频监测发改委→入库→重算预测→同步 31 省→按用户推送（飞书/企微/钉钉/SMTP）
- **admin**：首用户自动成为管理员，可配高德 Key / SMTP 服务器

2026-09-24 21:13:58 +08:00