hailin
/
rwadurian
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
2,432 Commits 1 Branch 10 Tags 175 MiB
Commit Graph

2432 Commits

Author SHA1 Message Date
hailin eda39b982d fix(mobile-app): 修复切换窗口期 NotificationBadge 混账号请求问题 
问题（通过日志发现）：
账号切换时存在一个 storage 空窗期（旧数据已清除、新数据尚未恢复完成）。
在此期间，NotificationBadgeNotifier 的 30s 定时器恰好触发，导致：
- _loadUnreadCount() 从 authProvider 内存读到旧账号 userSerialNum
- HTTP interceptor 从 storage 读到已恢复的新账号 accessToken
- 发出混账号请求：?userSerialNum=旧账号 + Authorization: Bearer 新账号token
日志证据：
  _restoreAccountData() 执行期间出现
  GET /notifications/unread-count?userSerialNum=D26022600000
  Authorization: Bearer [D26022600001的token]

修复：

1. notification_badge_provider.dart
   新增 stopAutoRefresh() 公开方法，取消 30s 定时器而不 dispose，
   Provider invalidate 重建后会自动重启定时器。

2. account_switch_page.dart - _switchToAccount
   在 onBeforeRestore 中补加：
     ref.read(notificationBadgeProvider.notifier).stopAutoRefresh()
   确保切换空窗期内 notificationBadge 定时器不触发。

   同时移除 UI 层冗余的 saveCurrentAccountData() 调用——
   switchToAccount() 内部已有此步骤，无需重复。

   日志步骤从 [1/6]...[6/6] 更新为 [1/5]...[5/5]，
   并在 onBeforeRestore 注释中说明停止各定时器的原因。

切换空窗期现在所有定时器均已停止：
  ✓ walletStatusProvider (60s)
  ✓ pendingActionPollingService (4s)
  ✓ notificationBadgeProvider (30s)  ← 本次新增
  ✓ TelemetryUploader (30s)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-25 09:09:37 -08:00
hailin 825c8a32e4 chore(mobile-app): 补全多账号切换流程的关键日志，便于验证与排查 
切换流程中的每一步现在都有清晰的日志输出，方便通过 adb logcat
或 flutter logs 验证切换行为是否符合预期。

account_switch_page.dart - 三条路径全部覆盖：

_switchToAccount（切换账号）：
  [1/6] 保存当前账号数据
  [2/6] 调用 switchToAccount()
  [3/6] onBeforeRestore - 停止 walletStatus/pendingAction 轮询、暂停遥测
  [4/6] invalidate authProvider / walletStatusProvider / notificationBadgeProvider
  [5/6] 恢复遥测上传
  [6/6] 导航到 ranking 页面

_addNewAccount（添加新账号）：
  [1/5] 保存当前账号数据
  [2/5] 停止定时器
  [3/5] 调用 logoutCurrentAccount()
  [4/5] invalidate 三个 Provider
  [5/5] 导航到 guide 页面

_deleteAccount（删除账号）：
  删除前打印目标账号，删除后打印剩余账号数

profile_page.dart - _performLogout（退出登录）：
  [1/4] 停止 walletStatus/pendingAction 轮询
  [2/4] 调用 logoutCurrentAccount()
  [3/4] invalidate 三个 Provider
  [4/4] 导航到 guide 页面

每条关键操作完成后打印 ✓ 确认符号，便于逐步验证。
每条路径用 ========== 分隔符标识开始/完成，日志易于 grep 过滤。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-25 09:04:14 -08:00
hailin e02bcf418c fix(mobile-app): 升级弹窗禁止点击外部或返回键关闭，必须通过按钮操作 
问题：
检测到新版本弹出升级对话框时，用户点击弹窗外部区域或按系统返回键
即可直接关闭弹窗，绕过升级提示，导致用户可能永远不会注意到更新。

修复：
对所有 3 个升级弹窗统一加两层防护：
- barrierDismissible: false — 禁止点击弹窗外部区域关闭
- PopScope(canPop: false) — 禁止系统返回键关闭

涉及弹窗：
1. self_hosted_updater.dart - _showSelfHostedUpdateDialog（自建APK更新）
2. self_hosted_updater.dart - _showMarketUpdateDialog（应用市场引导更新）
3. update_service.dart - _checkGooglePlayUpdate（Google Play 更新）

用户必须通过弹窗内按钮操作：
- 非强制更新：点击「稍后」/「暂时不更新」关闭，或点击「立即更新」开始更新
- 强制更新：只有「立即更新」按钮，无法跳过

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-25 08:01:52 -08:00
hailin 8f8a9230d0 fix(mobile-app): 修复多账号切换数据串号问题，完善存储隔离与状态重置 
问题：
多账号切换时，前一个账号的推荐码、种植省市、缓存数据等会串到下一个账号，
同时定时器（钱包轮询、通知刷新、遥测上传）未正确停止/重启，
导致旧账号的 API 请求混入新账号上下文。

修复内容：

1. StorageKeys 补充种植省市常量（storage_keys.dart）
   - 新增 plantingProvinceName/Code、plantingCityName/Code 4个常量
   - 将硬编码的 key 统一收口，确保隔离列表引用一致

2. MultiAccountService 补全隔离列表（multi_account_service.dart）
   - _accountSecureKeys 新增 inviterReferralCode（修复邀请码串号）
   - _accountLocalKeys 新增 4个种植省市key + cachedAppAssets +
     cachedCustomerServiceContacts（修复种植/缓存数据串号）
   - switchToAccount() 新增 onBeforeRestore 回调参数，用于在
     storage清空后、恢复新数据前 停止定时器

3. AccountSwitchPage 三层状态重置（account_switch_page.dart）
   - _switchToAccount: onBeforeRestore 内停止 walletStatus 轮询、
     pendingAction 轮询、telemetry 上传；返回后 invalidate
     authProvider/walletStatusProvider/notificationBadgeProvider，
     最后 resumeAfterLogin 恢复遥测
   - _addNewAccount: 退出前停止定时器，退出后 invalidate Provider

4. ProfilePage 退出登录补全清理（profile_page.dart）
   - _performLogout: 退出前停止 walletStatus/pendingAction 轮询，
     退出后 invalidate 三个 Provider

5. 页面 key 统一引用 StorageKeys 常量
   - planting_location_page.dart 和 authorization_apply_page.dart
     将硬编码 key 替换为 StorageKeys.plantingXxx 常量

关键时序（switchToAccount 内部）：
  save → clear → onBeforeRestore(停timer) → restore → 返回
  → invalidate Provider（此时storage已恢复新数据）→ resume telemetry → navigate

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-25 06:13:05 -08:00
hailin a5a69645b4 fix(trading): 流通池改为显示已挖矿产出总量，解决显示为0的问题 
前端"流通池"原来读取 circulationPool（交易流通池），因系统尚无卖出交易故为 0。
现改为读取 totalMined（全网已挖矿产出的积分股总量 = 用户已挖 + 系统已挖）。

后端新增 getTotalMinedFromMiningService() 方法，调用 mining-service 的
GET /mining/progress 接口获取 totalDistributed。

注意：价格公式中的 circulationPool 保持不变，仍用交易流通池参与计算。
新增的 totalMined 字段仅用于前端展示。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-25 02:54:26 -08:00
hailin 27db2a5aa2 fix(snapshot): 修复备份进行中被删除导致容器崩溃的问题 
1. checkDone 中 statSync 加 try-catch，文件被删时 reject 而非 uncaught crash
2. 删除 API 禁止删除 RUNNING 状态的任务，返回 409 Conflict
3. compose 补充 restart: unless-stopped，防止异常退出后服务不可用

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-25 01:30:44 -08:00
hailin 18675f083c fix(admin-web): 滚动区域改到 nav 内部，避免裁掉 toggle 按钮 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 06:55:32 -08:00
hailin 31d3eabcf8 fix(admin-web): 侧边栏菜单项过多时支持滚动，底部不再被截断 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 06:46:15 -08:00
hailin e32ef9b9ff fix(frontend): snapshot.types 补充 MPC_POSTGRES 类型和标签 
后端新增了 MPC_POSTGRES 备份目标，前端 BackupTarget 类型和
BACKUP_TARGET_LABELS 缺少对应项导致复选框无法渲染。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 04:19:57 -08:00
hailin 716b37041e fix(snapshot): PG_HOST 改用容器名 rwa-postgres 避免跨网络 DNS 冲突 
snapshot-service 同时在 rwa-network 和 mpc-network 中，
服务名 "postgres" 在两个网络都存在导致解析到 mpc-postgres。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 04:02:01 -08:00
hailin b6fb421316 feat(snapshot): 新增 MPC PostgreSQL 备份目标 
MPC 系统使用独立的 PostgreSQL 实例 (mpc-postgres)，之前不在备份范围内。
新增 MPC_POSTGRES handler，通过 MPC_PG_* 环境变量连接，snapshot-service
加入 mpc-network 实现跨 compose 网络访问。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 03:12:16 -08:00
hailin 26e55a649f feat(snapshot): 进度显示增加文件大小信息，完成项显示 "完成 (29.4 MB)" 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 02:59:07 -08:00
hailin ff28615fc3 fix(admin-web): Dockerfile 构建时传入 SNAPSHOT_SERVICE_URL build arg 
Next.js rewrites 在构建阶段烘焙，运行时环境变量不生效

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 02:53:03 -08:00
hailin de361e24f6 fix(infra): 网关 nginx 添加 snapshot-api 代理 + admin-web 配置 SNAPSHOT_SERVICE_URL 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 02:44:46 -08:00
hailin 30f1355bb4 fix(admin-web): snapshots 页面补上 PageContainer 包裹，恢复侧边栏 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 02:27:43 -08:00
hailin 08161c64d4 fix(snapshot): API 响应补上 progressMsg 字段 
toSnapshotResponse 手动映射字段时遗漏了 progressMsg，
导致前端轮询拿不到 MB 进度消息。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 02:11:42 -08:00
hailin 8855491637 feat(snapshot): 进度精度升级 — Float百分比 + MB消息存DB 
- schema: progress Int→Float，新增 progressMsg 字段
- PG handler: 百分比保留2位小数(toFixed(2))，不再 Math.floor
- orchestrator: 每2秒写DB时同时写 progressMsg (含MB信息)
- 前端: 百分比显示 toFixed(1)，message 优先读 progressMsg

效果: 113GB库每次轮询进度条和MB数都有变化，不再卡在整数百分比

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 01:57:47 -08:00
hailin 9cbc0ba580 fix(snapshot): DATABASE_URL 改绝对路径，修复 SQLite 每次重建丢数据 
Prisma 的 file:./data/snapshot.db 相对于 schema.prisma 所在目录
(/app/prisma/)，实际创建在 /app/prisma/data/snapshot.db，不在
volume 挂载的 /app/data/ 下，导致容器重建后数据丢失。

改为 file:/app/data/snapshot.db 绝对路径，确保 SQLite 存入
volume 挂载目录，数据跨容器持久化。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 01:48:24 -08:00
hailin 7b7bfcac93 fix(snapshot): onModuleInit 增加扫描临时目录清理孤儿文件 
SQLite 可能因重建丢失任务记录，导致 onModuleInit 仅靠查数据库
无法清理遗留的临时目录。新增逻辑：启动时扫描临时目录所有子目录，
若数据库中不存在对应任务则直接删除。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 01:45:24 -08:00
hailin 669a8a7248 fix(snapshot): 进度写 DB 改为每 2 秒一次，避免前端长时间显示 0% 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 01:40:32 -08:00
hailin f14f685ea9 fix(snapshot): PG 进度改字节百分比 + Redis 备份防崩溃 + 启动清理遗留任务 
- postgres-backup: 用 pg_database_size 做分母，统计 stdout 字节数算进度（与 pv 方案一致）
- redis-backup: BGSAVE 后先 copyFileSync 到临时目录再打包，防止 tar-stream Size mismatch 崩溃
- orchestrator: onModuleInit 清理遗留 RUNNING 任务，标记 FAILED 并删除临时文件
- docker-compose: 临时文件改挂宿主机 /tmp 目录，方便手动清理

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 01:30:52 -08:00
hailin 38efa891b8 fix(snapshot): Dockerfile 添加 SNAPSHOT_SERVICE_URL build ARG 
Next.js rewrites 在 build 时烘焙到 routes-manifest.json，
运行时环境变量无法覆盖。需要通过 Docker build ARG 在构建时传入。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 00:43:33 -08:00
hailin ee94f1420d fix(snapshot): 前端 API 改走 Next.js rewrites 代理 + WebSocket 改 REST 轮询 
- snapshot.api.ts: 从直连 localhost:port 改为 /api/snapshots/* 走 Next.js 代理
- next.config: 两个前端都添加 /api/snapshots/:path* → snapshot-service 代理规则
- docker-compose.2.0-snapshot.yml: overlay 中追加 mining-admin-web 的 SNAPSHOT_SERVICE_URL
- useSnapshotWebSocket → useSnapshotPolling: 2秒轮询 GET /snapshots/:id 获取进度
- 移除 socket.io-client 依赖（Next.js standalone 不支持 WebSocket proxy）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-24 00:37:41 -08:00
hailin 9a88fb473a fix(snapshot): Dockerfile 安装 postgresql-client-16 匹配目标 PG 版本 
bookworm 默认 postgresql-client 是 15，目标数据库是 PG16
添加 PGDG 源安装 postgresql-client-16

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-23 23:20:45 -08:00
hailin 470dc1ccd0 fix(snapshot): PostgreSQL 备份从 pg_basebackup 改为 pg_dumpall 
pg_basebackup -D - -Ft -z 在 PG15 中不支持同时 WAL streaming
改用 pg_dumpall | gzip 逻辑备份，更轻量且不需要 replication 权限

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-23 23:18:52 -08:00
hailin a4689d5e8b fix(snapshot): 修复 listSnapshots 分页参数 NaN 问题 
NestJS @Query() 返回 string，需手动 parseInt 再传给 Prisma

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-23 23:15:26 -08:00
hailin b8b4305ea5 fix(snapshot): Dockerfile 添加 ca-certificates 修复 mc 下载 SSL 错误 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-23 23:11:07 -08:00
hailin 685aced4e4 fix(snapshot): 修复 6 个 TypeScript 严格模式编译错误 
- infrastructure.module: handler union type 修正
- minio-storage.adapter: obj.name 可选属性安全检查
- minio-backup.handler: listAllObjects 返回 string[] 避免 BucketItem.name 可选问题

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-23 23:10:08 -08:00
hailin 18c9f8b389 chore(snapshot): 添加 snapshot-service package-lock.json 
Docker build 的 npm ci 需要 lock 文件。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-23 23:06:42 -08:00
hailin ef2f0f67bf chore: 更新前端 package-lock.json 同步 socket.io-client 依赖 
添加 socket.io-client 到 package.json 后未同步 lock 文件，
导致 Docker 构建时 npm ci 报 EUSAGE 错误。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-23 21:56:28 -08:00
hailin cf07eb03be feat(snapshot): 数据快照备份服务全量实现（纯新增，零侵入） 
一套代码两处部署的在线备份编排服务，为 1.0 认种分配系统和 2.0 算力挖矿系统
分别提供 PostgreSQL / Redis / Kafka / ZooKeeper / MinIO / Uploads 的在线备份能力。
管理员在 admin-web / mining-admin-web 中选择备份目标和存储方式，点击备份后系统
串行执行各组件备份，通过 Socket.IO WebSocket 实时推送进度到前端。

## 后端 snapshot-service（NestJS 10 + Prisma 5 + SQLite）

架构: DDD 四层（api / application / domain / infrastructure）

- api 层:
  · SnapshotController — REST API（创建/查询/删除/下载）含 Range/206 断点续传
  · SnapshotGateway — Socket.IO WebSocket 实时推送 5 类事件
  · HealthController — 健康检查
  · CreateSnapshotDto — class-validator 验证
  · toSnapshotResponse — BigInt→string 序列化

- application 层:
  · SnapshotOrchestratorService — 核心编排引擎
    - startSnapshot() 异步启动，不阻塞 HTTP
    - 按 PG→Redis→Kafka→ZK→MinIO→Uploads 顺序串行执行
    - 单目标失败不中断整体任务
    - MinIO 模式: 备份完上传到 MinIO 后删除本地临时文件
    - LOCAL 模式: 保留在服务器临时目录供下载
    - @Cron(EVERY_HOUR) 自动清理过期本地备份（默认 72h）
    - runningTaskId 防止并发执行

- domain 层:
  · BackupTarget 枚举（6 种目标）+ BACKUP_TARGET_ORDER 执行顺序
  · SnapshotStatus 枚举（PENDING/RUNNING/COMPLETED/FAILED）
  · StorageType 枚举（MINIO/LOCAL）
  · BackupHandler 接口 + BACKUP_HANDLER_TOKEN

- infrastructure 层:
  · 6 个备份 Handler（均实现 BackupHandler 接口）:
    - PostgresBackupHandler: pg_basebackup 通过网络流式备份，解析 stderr 进度
    - RedisBackupHandler: BGSAVE + LASTSAVE 轮询 + 打包 dump.rdb/AOF
    - KafkaBackupHandler: archiver 打包数据卷，按字节计算进度
    - ZookeeperBackupHandler: archiver 打包 data/ + log/
    - MinioBackupHandler: SDK 列举并下载所有桶（排除备份桶）后打包
    - UploadsBackupHandler: archiver 打包上传文件目录
  · 2 个存储适配器:
    - MinioStorageAdapter: fPutObject 上传 / removeObjects 批量删除
    - LocalStorageAdapter: 本地临时目录管理 + 过期清理
  · PrismaService (SQLite) + SnapshotRepository (完整 CRUD)
  · BACKUP_HANDLER_TOKEN 工厂: 根据 AVAILABLE_TARGETS 环境变量过滤可用 handler

- Prisma Schema (SQLite):
  · SnapshotTask: 主表，targets 存 JSON 字符串，totalSize 用 BigInt
  · SnapshotDetail: 明细表，每个目标一行，@@index([taskId])
  · onDelete: Cascade 级联删除

- Dockerfile: 多阶段构建，生产镜像安装 postgresql-client + mc (MinIO CLI)
  SQLite 使用 prisma db push 而非 migrate deploy

- 部署端口: 1.0 系统 = 3099，2.0 系统 = 3199

## Docker Compose overlay（纯新增，不修改现有 docker-compose）

- docker-compose.snapshot.yml (1.0):
  · 挂载 redis_data/kafka_data/zookeeper_data/zookeeper_log/admin_uploads_data 只读卷
  · AVAILABLE_TARGETS=POSTGRES,REDIS,KAFKA,ZOOKEEPER,MINIO,UPLOADS
  · 依赖 postgres + redis 健康检查

- docker-compose.2.0-snapshot.yml (2.0 standalone):
  · 挂载 redis_2_data/mining-admin-uploads/trading-uploads 只读卷
  · AVAILABLE_TARGETS=POSTGRES,REDIS,UPLOADS
  · 依赖 postgres-2 + redis-2 健康检查

## 前端 admin-web（Next.js 15 + SCSS）

- 新增 /snapshots 页面: 创建备份表单 + 实时进度条 + 历史列表 + 下载/删除
- 新增 useSnapshotWebSocket hook: Socket.IO 连接 + 5 类事件监听
- 新增 snapshot.api.ts: 独立 fetch（不走通用 apiClient，snapshot 服务独立端口）
- 新增 snapshot.types.ts: 共享类型定义
- 新增 page.module.scss: 表单/进度条/表格样式
- 修改 Sidebar.tsx: 添加「数据快照」菜单项
- package.json: 添加 socket.io-client 依赖

## 前端 mining-admin-web（Next.js 14 + Tailwind CSS）

- 新增 /snapshots 页面: 同 admin-web 功能，Tailwind CSS 风格
- 新增 useSnapshotWebSocket hook
- 新增 snapshot.api.ts + snapshot.types.ts
- 修改 sidebar.tsx: 添加「数据快照」菜单项 + HardDrive 图标
- package.json: 添加 socket.io-client 依赖

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-23 21:53:09 -08:00
hailin e690a55c8e style(transfer): 树转让 3 页面从暗夜主题改为 App 标准浅色棕金主题 
问题：树转让的 transfer_list_page、transfer_initiate_page、
transfer_detail_page 三个页面使用了深色暗夜主题（#1A1A2E 背景 +
#16213E 卡片），与 App 其余 40+ 功能页面的浅色棕金主题不一致。

修改内容（3 个文件，纯样式重写，零业务逻辑变更）：

1. 页面背景：#1A1A2E → 渐变 #FFF7E6 → #EAE0C8（与 planting_quantity_page 一致）
2. 卡片背景：#16213E → #99FFFFFF 半透明白 + boxShadow（与认种页一致）
3. AppBar：深色背景白字 → 透明背景 + 金色返回键(#D4AF37) + 棕色标题(#5D4037)
4. 正文文字：Colors.white/white70 → #5D4037 棕色 / #745D43 次级棕色
5. 输入框：#16213E 填充 → #99FFFFFF 填充 + #EAE0C8 边框
6. 按钮：ElevatedButton → GestureDetector+Container（高度 56，与全局一致）
7. 分割线：Colors.white24 → #EAE0C8
8. Tab 栏：暗色系 → 半透明白卡片容器 + 金色指示器
9. Saga 时间线未完成节点：white 20% → #EAE0C8 暖色
10. 对话框：系统默认 → #FFF7E6 背景 + 棕色文字

样式参考基准：planting_quantity_page.dart（现有认种数量页）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-23 20:25:25 -08:00
hailin a11e4d0261 fix(pre-planting): 修复 5 个预种模块 Bug + 补全 3 服务 migration 
Bug #1 (HIGH): allocateFunds 从 Prisma 事务内移到事务外
  - pre-planting-reward.service.ts: distributeRewards 拆为
    prepareAndPersistRewards（事务内持久化）+ executeAllocations（事务后转账）
  - pre-planting-application.service.ts: 事务后调用 executeAllocations

Bug #2 (HIGH): signContract 后触发 hasPlanted
  - 签约事务成功后发布 PlantingOrderPaid 到 planting-events topic
  - wallet-service 消费后执行 markUserAsPlanted + settleUserPendingRewards
  - event-publisher.service.ts: 新增 publishRawToPlantingEvents 方法

Bug #3 (MEDIUM): PENDING 推荐奖励改为全部 SETTLED
  - 与现有认种行为对齐，推荐奖励立即发放

Bug #4 (HIGH): 补全 3 个服务的数据库迁移文件
  - planting-service: 4 张预种表（orders/positions/merges/reward_entries）
  - admin-service: 1 张配置表（pre_planting_configs）+ 默认数据
  - contribution-service: 4 张 CDC 追踪表（synced_orders/positions/freeze_states/processed_cdc_events）

Bug #5 (LOW): 合并循环 if→while，支持一次购买多份触发多次合并

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-23 18:09:14 -08:00
hailin b14ad94e85 docs: RWA 通缩经济模型设计 —— 商业案例分析 
新增经济模型深度分析文档，从数学公式层面拆解平台的代币经济设计：

- 四池架构：100亿销毁池 vs 200万挖矿池的不对称设计
- 两个数学证明：价格永涨（M>0）+ 无泡沫（市值≤池子余额）
- 除数的魔术：100亿→200万，同一笔钱价格放大5000倍
- 真实分配逻辑：token占比决定盈亏，价格曲线只是显示效果
- 四年桥梁：销毁机制精确衔接果树第5年结果的真实收入
- 五层咬合：数学、心理、法律、时间、叙事的精密配合

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-20 07:57:07 -08:00
hailin c3e43b81e9 docs: 平台全景架构大纲 + 预种计划实施方案 
新增两份项目核心文档：

1. platform-overview.md — 平台全景架构大纲（551 行）
   - RWADurian 1.0 认种分配系统 + 2.0 算力挖矿系统完整梳理
   - 13 个微服务架构、核心业务流程、CDC 数据桥梁
   - 推荐层级体系、代币与链上体系、安全运维要点
   - 可作为开发、运维、新成员 onboarding 的单一事实来源

2. pre-planting-implementation-plan.md — 3171 预种计划实施方案（745 行）
   - 核心原则：纯新增，零侵入（现有代码文件一行不改）
   - 架构决策：planting-service 内独立模块，非新服务
   - 完整的事件流、数据模型、API 设计
   - 六大服务的实现步骤与变更文件清单

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 03:49:01 -08:00
hailin b3a3652f21 feat(transfer): 树转让功能全量实现（纯新增，零侵入） 
实现已认种果树所有权在用户间转让的完整功能。采用方案一：
独立 transfer-service 微服务 + Saga 编排器模式。

=== 架构设计 ===
- Saga 编排器 8 步正向流程：卖方确认 → 冻结资金 → 锁定树 →
  变更所有权 → 调整算力 → 更新统计 → 结算资金 → 完成
- 补偿回滚：任一步骤失败自动反向补偿（解冻资金 → 解锁树）
- 13 种状态：PENDING → SELLER_CONFIRMED → PAYMENT_FROZEN →
  TREES_LOCKED → OWNERSHIP_TRANSFERRED → CONTRIBUTION_ADJUSTED →
  STATS_UPDATED → PAYMENT_SETTLED → COMPLETED / CANCELLED /
  FAILED / ROLLING_BACK / ROLLED_BACK

=== Phase 1-2: transfer-service（独立微服务） ===
新建文件：
- Prisma Schema：transfer_orders + transfer_status_logs + outbox_events
- Domain：TransferOrder 聚合根 + TransferFeeService（5% 手续费）
- Application：TransferApplicationService + SagaOrchestratorService
- Infrastructure：Kafka 事件消费/生产 + Outbox Pattern
- API：TransferController（用户端）+ AdminTransferController（管理端）
- External Clients：wallet/planting/identity-service HTTP 客户端
- Docker + 环境配置

=== Phase 3: 现有微服务扩展（纯追加） ===
planting-service：
- Prisma schema 追加 transferLockId 可空字段
- InternalTransferController：锁定/解锁/执行 3 个新端点
- Kafka handlers：transfer-lock/execute/rollback 事件处理
- main.ts 追加 Kafka consumer group 配置

referral-service：
- PlantingTransferredHandler：处理转让后团队统计更新
- TeamStatisticsAggregate 追加 handleTransfer() 方法
- TeamStatisticsRepository 追加 adjustForTransfer() 方法
- ProvinceCityDistribution 追加 transferTrees() 方法

contribution-service：
- TransferOwnershipHandler：处理所有权变更事件
- TransferAdjustmentService：算力调整（879 行核心逻辑）
- Prisma schema 追加 transferOrderId 可空字段
- ContributionAccount 追加 applyTransferAdjustment() 方法

=== Phase 4A: wallet-service（3 个新内部端点） ===
新建文件：
- FreezeForTransferDto / UnfreezeForTransferDto / SettleTransferDto
- FreezeForTransferCommand / UnfreezeForTransferCommand / SettleTransferPaymentCommand
- InternalTransferWalletController（POST freeze/unfreeze/settle-transfer）

修改文件：
- wallet-application.service.ts 追加 3 组方法（+437 行）：
  freezeForTransfer / unfreezeForTransfer / settleTransferPayment
  （乐观锁 + 3 次重试 + Prisma $transaction + 幂等检查）
- 结算操作：单事务内更新 3 个钱包（买方扣减 + 卖方入账 + 手续费归集）

=== Phase 4B: admin-web（转让管理页面） ===
新建文件：
- transferService.ts：API 调用服务 + 完整类型定义
- useTransfers.ts：React Query hooks（list/detail/stats/forceCancel）
- /transfers/page.tsx：列表页（统计卡片 + 搜索筛选 + 分页 + 13 种状态 badge）
- /transfers/[transferOrderNo]/page.tsx：详情页（Saga 时间线 + 状态日志 + 强制取消）
- transfers.module.scss：完整样式

修改文件：
- endpoints.ts 追加 TRANSFERS 端点配置
- Sidebar.tsx 追加「转让管理」菜单项
- hooks/index.ts 追加 useTransfers 导出

=== Phase 4C: mobile-app（转让 UI） ===
新建文件：
- transfer_service.dart：Flutter API 服务 + Model（TransferOrder/Detail/StatusLog）
- transfer_list_page.dart：转让记录列表（全部/转出/转入 Tab + 下拉刷新）
- transfer_detail_page.dart：转让详情（Saga 时间线 + 确认/取消操作）
- transfer_initiate_page.dart：发起转让表单（手续费自动计算）

修改文件：
- injection_container.dart 追加 transferServiceProvider
- route_paths.dart + route_names.dart 追加 3 个路由
- app_router.dart 追加 3 个 GoRoute
- profile_page.dart 追加「发起转让」+「转让记录」按钮行

=== 基础设施 ===
- docker-compose.yml 追加 transfer-service 容器配置
- deploy.sh 追加 transfer-service 部署
- init-databases.sh 追加 transfer_db 数据库初始化

=== 纯新增原则 ===
所有变更均为追加式修改，不修改任何现有业务逻辑：
- 新增 nullable 字段（不影响现有数据）
- 新增 enum 值（不影响现有枚举使用）
- 新增 providers/controllers（不影响现有依赖注入）
- 新增页面/路由（不影响现有页面行为）

回滚方式：删除 transfer-service 目录 + 移除各服务中带 [2026-02-19] 标记的代码

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 03:44:02 -08:00
hailin 765a4f41d3 feat(pre-planting): Admin Web 预种管理页面 + Sidebar 入口 
[2026-02-17] Admin Web 预种计划管理页面完整实现

新增文件：
- (dashboard)/pre-planting/page.tsx: 预种管理页面
  - 预种开关控制卡片（开启/关闭 + 状态徽章）
  - 四格统计卡片（总订单、总份数、总金额、合成树数）
  - Tab 切换：预种订单 / 用户持仓 / 合并记录
  - 订单表格：订单号、用户、份数、金额、状态标签、时间
  - 持仓表格：用户、累计份数、待合并进度、合成树数、省市
  - 合并表格：合并号、用户、树数、来源订单、合同状态、挖矿状态
  - 搜索过滤、刷新、加载/错误/空状态处理
- pre-planting.module.scss: 页面样式
  - 开关状态卡片（渐变背景，开/关不同主题色）
  - 统计网格（4列响应式）
  - Tab、表格、状态标签样式

修改文件：
- Sidebar.tsx: 新增"预种管理"菜单项（数据统计与系统维护之间）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 05:54:21 -08:00
hailin 63ae7662a4 feat(pre-planting): Admin Web 预种计划 Service 层 
[2026-02-17] Admin Web 预种管理 API 服务 + React Query Hooks

新增文件：
- endpoints.ts: PRE_PLANTING 端点组（config/toggle/orders/positions/merges/stats）
- prePlantingService.ts: 预种管理服务（开关配置、订单/持仓/合并查询、统计汇总）
  - 完整 TypeScript 类型定义（Config, Stats, Order, Position, Merge）
  - 分页列表请求/响应类型
- usePrePlanting.ts: React Query hooks
  - Query key factory（层级化参数化）
  - usePrePlantingConfig/Stats/Orders/Positions/Merges
  - useTogglePrePlantingConfig（mutation + 自动刷新）
- hooks/index.ts: 导出新 hooks

所有端点走 admin-service 的 PrePlantingAdminModule
与现有认种管理完全独立

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 05:48:58 -08:00
hailin 03f5c4af28 feat(pre-planting): Profile 页面添加预种计划入口 
[2026-02-17] 在 Profile 页面认种按钮下方新增预种计划入口

新增内容（纯新增，不改现有逻辑）：
- _goToPrePlantingPurchase()：跳转预种购买页
- _goToPrePlantingPosition()：跳转预种持仓页
- _buildPrePlantingButtons()：两个并排按钮
  - 左侧「预种购买」：金色主题，跳转购买页
  - 右侧「预种持仓」：棕色主题，跳转持仓页

布局位置：认种按钮正下方，主内容卡片上方
现有功能零影响，仅新增 3 个方法 + 1 处布局插入

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 05:44:48 -08:00
hailin d248f92443 feat(pre-planting): Mobile App 预种合并详情页完整实现 
[2026-02-17] 预种合并详情页面 (pre_planting_merge_detail_page.dart)

完整功能：
- 合并信息卡片：合并号、合并时间、份数→树数、总价值、省市
- 合同签署状态卡片：待签署/已签署/已过期，含签署时间
- 挖矿状态卡片：已开启/未开启，含开启时间
- 来源订单列表：编号圆标 + 订单号 + 金额，逐条展示 5 笔订单
- 签约确认弹窗：列出签约后解锁的权限（交易/提现/授权/挖矿）
- 底部签约按钮：仅待签署状态显示，含加载状态
- 签约成功后自动刷新页面状态

UI 风格与全局一致：渐变背景、金色主色调、卡片容器

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 05:43:17 -08:00
hailin 99f5070552 feat(pre-planting): Mobile App 预种持仓页面完整实现 
[2026-02-17] 预种持仓页面 (pre_planting_position_page.dart)

完整功能：
- 持仓概览卡片：累计份数、待合并份数、已合成树数（三列统计）
- 合并进度条：当前 N/5 份进度可视化 + 文字提示
- 省市信息显示（已锁定的省市）
- Tab 切换：预种订单 / 合并记录
- 预种订单列表：订单号、份数、金额、状态标签（待支付/已支付/已合并）
- 合并记录列表：合并号、树数、来源订单数、合同状态标签
- 待签约合并记录高亮显示 + "点击签署合同"提示
- 点击合并记录跳转到合并详情页
- 顶部快捷购买按钮
- 下拉刷新、错误重试、空状态提示

UI 风格与全局一致：渐变背景、金色主色调、卡片阴影

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 05:41:34 -08:00
hailin 8a4508fe0d feat(pre-planting): Mobile App 预种购买页面完整实现 
[2026-02-17] 预种计划购买页面 (pre_planting_purchase_page.dart)

完整功能：
- 并行加载数据（余额 + 配置 + 资格 + 持仓）
- 余额卡片：显示绿积分可用余额，支持刷新
- 合并进度卡片：显示当前 N/5 份进度条 + 已合成树数
- 省市选择：首次购买使用 city_pickers 选择，续购自动锁定复用
- 份数选择器：+/- 按钮 + 输入框，自动校验余额和资格限制
- 价格明细：单价 3171 USDT、最大可购买数、本次总价
- 购买确认弹窗：含合并预告（购买后将自动合成提示）
- 开关关闭禁用态：显示不可购买原因
- 错误重试、加载中状态完备

UI 风格与现有认种页面 (planting_quantity_page) 完全一致：
- 渐变背景 (#FFF7E6 → #EAE0C8)
- 金色主色调 (#D4AF37)
- 棕色文字 (#5D4037)
- 卡片容器带阴影

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 05:38:44 -08:00
hailin 1f9129d220 feat(pre-planting): Mobile App 预种计划路由注册 + 占位页面 
[2026-02-17] 新增预种计划的 GoRouter 路由和占位页面：

1. route_paths.dart / route_names.dart（各 +5 行）
   - /pre-planting/purchase  购买页
   - /pre-planting/position  持仓页
   - /pre-planting/merge/:mergeNo  合并详情页

2. app_router.dart（+28 行）
   - 3 个 GoRoute 注册

3. 占位页面（3 个新文件）
   - pre_planting_purchase_page.dart
   - pre_planting_position_page.dart
   - pre_planting_merge_detail_page.dart
   后续将逐步填充完整 UI

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 05:33:26 -08:00
hailin 27751731e8 feat(pre-planting): Mobile App 预种计划 Service 层 
[2026-02-17] 新增预种计划的 Flutter 端 API 服务层：

1. pre_planting_service.dart（新增）
   - PrePlantingService：预种 API 调用（配置/资格/持仓/订单/合并/签约）
   - 数据模型：PrePlantingPosition、PrePlantingOrder、PrePlantingMerge 等
   - 与现有 PlantingService 完全独立

2. api_endpoints.dart（+10 行）
   - 添加 /pre-planting/* 端点常量

3. injection_container.dart（+9 行）
   - 注册 prePlantingServiceProvider

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 05:31:39 -08:00
hailin e1cd8ed7f2 feat(pre-planting): 3171 预种计划 2.0 算力集成（contribution-service CDC 模块） 
Phase 5：将预种数据集成到 contribution-service 2.0 算力体系。

=== 新增文件（11 个） ===
- prisma/pre-planting/schema.prisma：独立 Prisma schema（4 张追踪表）
- PrePlantingPrismaService + Module：独立 PrismaClient
- PrePlantingCdcConsumerService：独立 CDC 消费者（consumer group: contribution-pre-planting-cdc）
- PrePlantingOrderSyncedHandler：订单 CDC handler + synced_adoptions marker 插入
- PrePlantingPositionSyncedHandler：持仓 CDC handler
- PrePlantingCdcDispatcher：CDC 事件分发器
- PrePlantingContributionService：1/5 算力计算（复用领域计算器）
- PrePlantingFreezeScheduler：每日冻结/解冻调度（凌晨 5 点）
- PrePlantingCdcModule：模块注册
- constants.ts：10B 偏移量、冻结期限等常量

=== 隔离保证 ===
- 独立 Kafka consumer group（contribution-pre-planting-cdc）
- 独立 CDC topics（cdc.pre-planting.public.*）
- 独立 Prisma schema + generated client
- sourceAdoptionId 使用 10,000,000,000 偏移避免 ID 冲突
- synced_adoptions marker: contributionDistributed=true + treeCount=0
- 不更新 NetworkAdoptionProgress（预种不推高全网算力系数）
- 现有代码文件零修改（仅 app.module.ts 加 1 行 import）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 05:25:14 -08:00
hailin 010b0392fd feat(pre-planting): 3171 预种计划 1.0 全量实现（纯新增，零侵入） 
预种计划（拼种团购）：用户以 3171 USDT/份参与认种（1棵树的1/5价格），
累计5份自动合成1棵树，触发合同签署并解除交易/提现限制。

涉及服务（现有代码仅 app.module.ts 加 1 行 import，其余全部为新增文件）：
- planting-service: PrePlantingModule（独立聚合根、购买/合并/签约/分配）
- admin-service: 预种开关管理（PrePlantingConfig 表 + API）
- referral-service: PrePlantingStatsModule（消费预种事件更新团队统计）
- authorization-service: PrePlantingGuardModule（未合并不可申请授权）
- wallet-service: PrePlantingGuardModule（未合并不可提现）

新增数据表：pre_planting_orders, pre_planting_positions,
pre_planting_merges, pre_planting_reward_entries, pre_planting_configs

新增 Kafka Topics：pre-planting.portion.purchased, pre-planting.merged,
pre-planting.contract.signed

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 05:06:03 -08:00
hailin 875f86c263 fix(reporting): 修复 contract.signed 事件 BigInt(undefined) 错误 
根因：planting-service 发送的 contract.signed 消息为嵌套结构
  { eventName: 'contract.signed', data: { orderNo, userId, ... } }
但 reporting-service handleContractSigned 按扁平结构解析
  message.userId → undefined → BigInt(undefined) → TypeError
导致 ~200 次/10分钟持续报错。

修复：
- 消息类型改为匹配实际嵌套格式 { eventName, data: { ... } }
- 解构 message.data 后再访问各字段
- 添加 userId 防御性检查，避免再次 BigInt 崩溃
- 与 referral-service ContractSigningHandler 消息结构保持一致

影响范围：仅 reporting-service 活动记录，不影响核心业务流程
(referral-service / reward-service 已正确处理嵌套格式)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 07:59:16 -08:00
hailin 2a725af83e fix: Debezium CDC 全面安全加固 (1.0 + 2.0) 
问题背景:
  - 1.0 生产环境发现 6 个孤儿 replication slot, WAL 积压 8.6GB (已清理)
  - 1.0 使用 Debezium 2.4, 存在 DBZ-7316 (WAL 无限积压) bug
  - 1.0 和 2.0 均无 max_slot_wal_keep_size 安全阀 (已在线设置 10GB)
  - 2.0 outbox connector 使用 pg_logical_emit_message 心跳, 不经 publication
  - 2.0 outbox connector RegexRouter regex=".*" 导致 heartbeat 污染消费者

修复内容:

[docker-compose.yml - 1.0 基础设施]
  - Debezium: 2.4 → 2.5.4.Final (修复 DBZ-7316)
  - PostgreSQL: 添加 max_slot_wal_keep_size=10GB
  - Debezium REST API: 端口绑定 127.0.0.1 (防 SSRF 注入)
  - PostgreSQL: 端口绑定 127.0.0.1 (防公网直连)
  - Kafka Connect: 添加 OFFSET_FLUSH_INTERVAL_MS=10s

[docker-compose.2.0.yml - 2.0 基础设施]
  - Debezium: 2.5 → 2.5.4.Final (锁定精确版本)
  - PostgreSQL: 添加 max_slot_wal_keep_size=10GB
  - Kafka Connect: 添加 OFFSET_FLUSH_INTERVAL_MS=10s

[1.0 Connector 配置 - identity/authorization]
  - 添加 heartbeat.action.query (INSERT INTO debezium_heartbeat TABLE 方式)
  - 之前只有 heartbeat.interval.ms 无 action.query, 心跳不生效

[2.0 Outbox Connector 配置 - 5个全部更新]
  - heartbeat: pg_logical_emit_message → INSERT INTO debezium_heartbeat TABLE 方式
    (TABLE 方式经过 publication → Debezium 消费 → 推进 confirmed_flush_lsn)
  - RegexRouter: regex ".*" → ".*outbox_events" (只路由 outbox 事件, heartbeat 走默认 topic)
  - table.include.list: 添加 debezium_heartbeat (确保心跳变更生成 Kafka 消息)
  - publication.autocreate.mode: filtered → disabled (使用预创建的 publication)
  - auth/contribution: 添加 signal channel 配置 (支持增量快照数据重放)

经验总结:
  1. pg_logical_emit_message 写 WAL 但不经 publication, 无法推进 confirmed_flush_lsn
  2. RegexRouter regex=".*" 把所有变更(含 heartbeat)路由到 outbox topic, 污染消费者
  3. 删除 Kafka Connect connector 不会自动清理 PostgreSQL replication slot
  4. max_slot_wal_keep_size 是 sighup 级参数, 可在线 ALTER SYSTEM + pg_reload_conf

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 07:32:13 -08:00
hailin 54eb472faa fix(debezium): 添加 heartbeat.action.query 防止 WAL 无限积压 
问题根因:
- 5个 Debezium outbox connector 配置了 heartbeat.interval.ms=10000
  但缺少 heartbeat.action.query，导致低写入频率的数据库
  (auth/contribution/mining-wallet) 无法向 PostgreSQL 回传
  confirmed_flush_lsn 确认位点
- PostgreSQL 无法回收旧 WAL，磁盘占用持续增长至 293GB

修复方案 (参考 Debezium 创始人 Gunnar Morling 推荐):
- 使用 pg_logical_emit_message() 代替心跳表方案
- 每10秒向 WAL 写入逻辑解码消息，绕过 publication 过滤
- 无需建表、无需改 table.include.list、无需改 publication
- 不产生额外 Kafka 消息，对消费端零影响
- 要求 PostgreSQL >= 14 (当前 16.11)

影响范围: 全部5个 outbox connector 配置文件
操作方式: PUT /connectors/{name}/config 热更新，触发 task 重启

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 02:44:38 -08:00
hailin ab9212cefa security: 基础设施端口绑定 127.0.0.1，封堵公网暴露 
PostgreSQL(5432)、Redis(6379)、Debezium REST API(8084) 此前绑定
0.0.0.0，直接暴露在公网。安全审查发现 Debezium 已被注入 3 个恶意
connector（SSRF 攻击尝试读取 /etc/passwd），恶意 connector 已清除。

修改内容：
- PostgreSQL: 0.0.0.0:5432 → 127.0.0.1:5432
- Redis: 0.0.0.0:6379 → 127.0.0.1:6379
- Debezium: 0.0.0.0:8084 → 127.0.0.1:8084

deploy-mining.sh 通过 docker exec 和 localhost 访问，不受影响。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-14 19:23:42 -08:00