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

2521 Commits

Author SHA1 Message Date
hailin 05e590ef04 fix(pre-planting): 修复可结算收益重复计算 
pre-planting getMyRewards API 错误地将所有分配记录金额算作
settleableUsdt（包括 PENDING 状态的待领取奖励）。
预种奖励的 PENDING/SETTLEABLE 状态由 wallet-service 管理，
reward-service 的 getMyRewardSummary 已包含预种可结算部分，
不应重复累加。

修复：
- 后端 getMyRewards 返回 settleableUsdt: 0
- 前端"我"页面和"兑换"页面不再额外加预种 settleableUsdt

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 03:34:22 -08:00
hailin d1be7173be fix(admin-web): 引荐树节点点击导航到用户详情页 
setTreeRootUser 只更新树不更新页面顶部信息，导致数据不同步。
改为 router.push 导航，页面整体刷新保持一致。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 03:13:42 -08:00
hailin cf07712a8c fix(mobile): 兑换页可结算收益聚合正常认种+预种金额 
之前只显示正常认种的 settleableUsdt，未包含预种收益，
导致有预种收益但显示"暂无可结算收益"。
现在并行获取两者并累加，与"我"页面保持一致。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 03:11:13 -08:00
hailin 5392c47e47 fix(admin-web): 引荐关系树节点点击切换为该节点为根显示 
点击节点后以该节点为根重新加载树，显示其祖先链和一级下线。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 03:00:45 -08:00
hailin e715fd2504 fix(admin-web): 引荐关系树节点点击跳转到用户详情页 
之前点击只切换树根节点，不导航。改为 router.push 跳转。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 02:55:56 -08:00
hailin 292c6518ba fix(admin-web): 隐藏钱包流水表格的类型和关联订单列 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 02:49:59 -08:00
hailin 0ac131a3b7 fix(admin-web): 钱包流水表格备注列显示不全 
各列均为 flex:1 等宽导致备注内容被 ellipsis 截断，
调整各列 flex 比例并允许备注列换行显示完整文本。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 02:41:31 -08:00
hailin 1157760d4d fix(pre-planting): 补充社区/省团队/市团队 API 缺失的 treeCount 参数 
三个接口调用时未传 treeCount，导致 authorization-service 收到
Number(undefined)=NaN，addMonthlyTrees(NaN) 使字段变为 NaN，
Prisma upsert 报 PrismaClientValidationError。

修复：全部传 treeCount=0（预种不计入月度考核），
省团队补充 provinceCode，市团队补充 cityCode，
同时修正社区/团队接口返回格式为 distributions 数组。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 02:30:35 -08:00
hailin e32658fc5e fix(pre-planting): 修复 authorization-service 响应包装格式解析 
authorization-service 全局 TransformInterceptor 将响应包装为
{ success, data: T, timestamp }，预种客户端需读取 response.data.data
而非 response.data。此前因解析失败静默 fallback 到系统账户。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 02:22:01 -08:00
hailin a15a4a97b1 fix(docker): 为 planting-service 添加 AUTHORIZATION_SERVICE_URL 环境变量 
planting-service 缺少 AUTHORIZATION_SERVICE_URL 配置，
默认回退到 http://localhost:3006，在容器内无法访问 authorization-service，
导致所有授权分配请求失败走 fallback。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 02:15:23 -08:00
hailin d880242807 fix(pre-planting): 修复 authorization-service API 路径错误 
预种 client 使用 /internal/authorization/... 但 authorization-service
全局前缀为 api/v1，实际路由是 /api/v1/authorization/...。
路径不对导致所有请求 404 → catch → fallback → 全部进系统账户。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 02:04:09 -08:00
hailin 530aeb2a6f feat(authorization): 新增行政区划代码↔中文名映射表，修复省市公司查询不到的问题 
authorization_roles表的regionCode存储格式不一致（有中文名"北京"、"广东省"也有数字代码"110100"），
但查询时统一传入6位数字代码，导致findProvinceCompanyByRegion/findCityCompanyByRegion永远返回null。

新增 RegionCodeResolver 静态映射表（34个省+333个地级市），
将精确匹配 regionCode = provinceCode 改为多形式匹配 regionCode IN (所有可能形式)。
此修复同时影响正常认种和预种的省区域/市区域/省团队/市团队权益分配。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 01:41:48 -08:00
hailin b9ddda2532 fix(pre-planting): 修复省市代码格式不一致导致授权分配失败 
预种DTO接收2位省代码(如"44")和4位市代码(如"4401")，
但authorization-service需要6位标准格式(如"440000"/"440100")。
- resolveAllocations中新增padEnd(6,'0')标准化转换
- fallback系统账户生成从padStart改为padEnd（右补零）
- 正常认种不受影响（SelectProvinceCityDto直接接收6位格式）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-01 01:23:55 -08:00
hailin 3be7b47678 feat(pre-planting+mobile): 预种奖励在"我"页面展示 
## 问题
预种奖励直接走 planting-service → wallet-service，绕过 reward-service，
导致前端"我"页面读 reward-service 的 summary/settleable 数据时看不到预种奖励。

## 方案
前端同时读 reward-service（正常认种）和 planting-service（预种），合并展示。

## 后端（planting-service）
- PrePlantingRewardEntryRepository: 新增 findByRecipientAccountSequence() 方法，
  按收款方账户查询预种奖励记录（注入 PrismaService 替代事务 client）
- PrePlantingController: 新增 GET /pre-planting/my-rewards 端点，
  返回当前用户作为收款方收到的预种奖励汇总+明细列表
  格式与 reward-service 的 settleable 对齐（id, rightType, usdtAmount, sourceOrderNo 等）

## 前端（Flutter mobile-app）
- PrePlantingService: 新增 getMyRewards() 方法 + PrePlantingMyRewards/PrePlantingRewardItem 数据类
- profile_page.dart: 并行调用 prePlantingService.getMyRewards()，
  将预种奖励转为 SettleableRewardItem 合并到可结算列表，
  summary.settleableUsdt 也加上预种金额

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 22:03:53 -08:00
hailin f32748c1d5 fix(pre-planting): 修复推荐链 API 调用的 URL 路径和返回格式解析 
1. URL: /referrals/:id/chain → /referral/chain/:id（与正常认种对齐）
2. 返回格式: 正确解析 { ancestors: [{accountSequence, hasPlanted}] }
   之前错误期望 { directReferrer: {...} }，导致有推荐人也被当成无推荐人

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 21:39:07 -08:00
hailin 545e897c1f fix(pre-planting): 预种省/市区域 API 传 treeCount=0，不计入考核 
预种 1 份 = 1/5 棵树，如果将 portionCount 作为 treeCount 传给
authorization-service，会导致省/市公司月度考核进度被多算 5 倍。

修正：传 treeCount=0，预种阶段不累计考核棵数。
等 5 份合成 1 棵完整树后，由合成流程负责累计 1 棵的考核进度。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 20:57:27 -08:00
hailin 1c71cda2ec fix(pre-planting): 修复省/市区域权益分配的三个 bug 
问题：
1. 省/市区域 API 调用缺少必需的 treeCount 参数，导致 authorization-service
   报错，每次都走 fallback 路径
2. fallback 路径没有对省/市代码做 padStart(6,'0') 补位，
   生成了错误的账户ID（如 944 而非 9440000，84401 而非 8440100）
3. API 返回格式解析错误：authorization-service 返回
   { distributions: [{accountSequence, ...}] }，但预种客户端错误地期望
   { accountSequence: string }，导致取到 undefined

修复：
- getProvinceAreaDistribution / getCityAreaDistribution 新增 portionCount 参数
- 正确解析 distributions 数组，优先取非系统账户（省/市公司）
- fallback 中使用 padStart(6,'0') 确保 7 位标准账户 ID 格式
- resolveAllocations 调用时传入 portionCount

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 20:53:12 -08:00
hailin 6a659ca718 feat(admin-web): 省/市区域账户添加点击查看明细功能 
RegionAccountsSection 新增：
- 每行添加"查看明细"按钮，点击展开该账户分类账流水
- 明细表包含 时间/类型/金额/余额/来源账户/来源备注/备注 7列
- 复用 getAllLedger API 的 provinceAccountsLedger/cityAccountsLedger 数据
- 行点击和按钮点击均可展开/收起
- 新增 clickableRow/selectedRow CSS 样式

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 20:37:12 -08:00
hailin bf50810830 feat(wallet+admin-web): 系统账户流水增加来源用户账户和来源备注列 
问题：系统账户（S0000000001等）、省/市区域/团队账户的流水明细
只显示 allocationType 英文标识，无法追溯是哪个用户的认种产生的。

解决方案：从 wallet_ledger_entries.payload_json.metadata 中提取
sourceAccountSequence 和 memo 字段，通过 API 返回给前端展示。

后端 wallet-service 改动：
- LedgerEntryDTO 新增 sourceAccountSequence / sourceMemo 两个可选字段
- 新增 extractPayloadInfo() 辅助函数统一从 payloadJson 提取信息
- 替换所有 5 处 LedgerEntryDTO 映射，使用 extractPayloadInfo()
- 向后兼容：旧记录无 metadata 时返回 null，不影响已有功能

前端 admin-web 改动：
- LedgerEntryDTO 类型新增 sourceAccountSequence / sourceMemo 字段
- 固定账户明细表格和分类账明细表格增加"来源账户"和"来源备注"列
- 新增 .sourceAccount 样式（等宽字体显示账户序列号）

数据来源说明：
- 正常认种：reward-service 传入 metadata 含完整中文 memo 和 sourceAccountSequence
- 预种：planting-service 传入 metadata 含 sourceAccountSequence 和中文 memo
- 历史记录（2026-01-04前）：metadata 可能为空，显示为"-"

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 20:22:40 -08:00
hailin 90fad63fed fix(wallet): 优化流水memo避免正常认种来源信息重复 
正常认种的 reward-service memo 已含"来自用户Dxxx的认种"，
增加 hasSourceInfo 检查，包含"来自"时不再重复拼接来源账户。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 20:10:09 -08:00
hailin 299c82fc4f fix(wallet): 流水备注增加来源用户AccountSequence和订单号 
所有分配类型（系统账户/区域账户/用户钱包/社区权益）的流水 memo
从原来的纯英文标识改为：中文描述 | 来源: 账户序列号 (订单号)
例: [预种] 预种成本费 | 来源: D26022600000 (PPLMM6670DO9VETGK)

修改方法:
- 新增 buildAllocationMemo() 统一从 metadata 中提取 memo/sourceAccountSequence
- 替换 allocateToSystemAccount/allocateToUserWallet/allocateCommunityRight/allocateToRegionAccount 中的 memo 生成
- 兼容无 metadata 的历史调用（回退到 allocationType 英文标识）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 20:08:52 -08:00
hailin 05aacc0d5b fix(admin-web): 系统账户流水备注列显示完整内容 
移除 .memo 的 max-width/overflow/ellipsis/nowrap 截断样式，
改为 word-break: break-word 自动换行，确保备注全文可见。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 19:55:45 -08:00
hailin 19fca05a81 fix(pre-planting): 预种权益分配metadata与正常认种对齐 + 删除retry-rewards 
1. executeAllocations() metadata 修复：
   - 原：仅传 { source: 'PRE_PLANTING' }，wallet流水缺失所有业务信息
   - 现：传完整 metadata（rightType, sourceOrderNo, sourceAccountSequence,
     treeCount, provinceCode, cityCode, memo），与正常认种 reward-service 一致
   - wallet-service 的 prePlantingPrefix() 通过 metadata.source 添加[预种]前缀

2. SHARE_RIGHT PENDING 机制说明（无代码变更）：
   - 预种侧只确定收款人，全部标记 SETTLED 发给 wallet-service
   - wallet-service.allocateToUserWallet() 内部根据收款方 hasPlanted 判断：
     已种→SETTLEABLE / 未种→PENDING(24h过期归总部)
   - 与正常认种走同一套 wallet-service 代码

3. 删除无用的 retry-rewards 端点及其 WalletServiceClient 依赖

不涉及历史数据修改，不影响正常认种流程。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 19:27:16 -08:00
hailin d9c238702e feat(pre-planting): 预种权益流水备注添加[预种]前缀 
wallet-service 新增 prePlantingPrefix 私有方法，
当 FundAllocationItem.metadata.source === 'PRE_PLANTING' 时，
在流水 memo 中添加 "[预种] " 前缀，使用户可区分预种与普通认种权益。

仅影响 pre-planting 新增的分配流水，不修改任何普通认种 memo。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 12:34:01 -08:00
hailin 1d0e4352df fix(pre-planting): 修复预种权益资金分配字段名错误（allocationType 丢失） 
原 executeAllocations 使用了错误的 FundAllocationItem 字段名：
- targetAccountId → 应为 targetId
- 缺少 allocationType 字段
- targetType 错误地使用了 rightType 值而非 'USER'|'SYSTEM'

导致所有预种订单的 SHARE_RIGHT/COMMUNITY_RIGHT 等权益分配静默失败，
资金未能分配到推荐人/社区/省市账户，同时流水明细中也不显示预种记录。

修复内容：
1. WalletServiceClient 新增 allocatePrePlantingFunds 方法（使用正确格式）
2. executeAllocations 改用新方法，正确设置 targetType/targetId/allocationType
3. InternalPrePlantingController 新增 POST /admin/retry-rewards 历史数据修复端点

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 12:29:03 -08:00
hailin 62bbbca609 Revert "fix(ledger): REWARD_EXPIRED条目显示权益类型+已过期标签" 
This reverts commit 4bd40970d0.
 2026-02-28 12:04:07 -08:00
hailin 4bd40970d0 fix(ledger): REWARD_EXPIRED条目显示权益类型+已过期标签 
- 奖励过期条目显示具体权益名（分享权益/省团队权益等）+ 红色"已过期"标签
- 图标改为灰色 timer_off，金额文字改为灰色，背景微灰
- 与正常权益收入条目有明显视觉区分

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 12:01:36 -08:00
hailin 724fb08be4 fix(contribution): 发布过期份额同步事件 + 管理后台/挖矿app状态显示 
- contribution-service: swapContributionForMerge 作废旧份额记录后，
  立即发布 ContributionRecordSynced outbox 事件（isExpired=true），
  mining-admin-service 收到后 upsert syncedContributionRecord
- mining-admin-web: 算力记录状态列改为绿色"有效"/红色"无效"
- mining-app: 贡献值记录卡片始终显示有效/无效状态标签

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 11:35:55 -08:00
hailin a904c8bd42 feat(ledger): 预种份额在流水明细中显示合并合同下载按钮 
- 移除硬编码"预种无合同"逻辑
- PPL 份额点击详情时，查找是否有对应的已签署合并记录
- 有签署合同则显示查看/下载按钮，调用预种合并合同 PDF 接口
- 同时新增 _viewMergeContractPdf / _downloadMergeContractPdf 方法

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 11:19:27 -08:00
hailin 1431c89684 fix(pre-planting): Decimal -> Number in totalAmount reduce 2026-02-28 11:01:37 -08:00
hailin cd73b2dec4 fix(pre-planting): 签署合同前检查实名认证 + 修正合同金额 
- getMergeContractPdf: KYC 为 null 时返回 400，不允许查看合同
- getMergeContractPdf: 从源订单汇总实际绿积分金额，CNY = 绿积分 × 1.1
- Flutter: KYC 错误时显示专用提示 + "去完成实名认证" 按钮

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 10:59:26 -08:00
hailin b1e5e6b29f feat(pre-planting): 合并合同走完整签署流程（PDF展示+手写签名） 
- planting-service: 新增 GET /merges/:mergeNo/contract-pdf 接口，复用现有 PDF 模板
- planting-service: PrePlantingApplicationService 注入 PdfGeneratorService/IdentityServiceClient
- pre_planting_service.dart: 新增 downloadMergeContractPdf，signMergeContract 简化返回值
- 新建 PrePlantingMergeSigningPage：PDF展示→滚动到底→确认法律效力→手写签名→提交
- pending_contracts_page: 合并卡片点击跳签名页（prePlantingMergeSigning）
- pre_planting_merge_detail_page: 签署按钮跳签名页，移除直接调用逻辑
- 新增路由 /pre-planting/merge-signing/:mergeNo

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 10:35:22 -08:00
hailin 2ad1936126 fix(pre-planting): 合并详情页 USDT 改为绿积分 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 10:17:12 -08:00
hailin b17bf82443 feat(pre-planting): 新增 GET /merges/:mergeNo 合并详情接口 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 10:07:53 -08:00
hailin 7bad0a8935 fix(pre-planting): 修复编译错误（getMerges→getMyMerges、RoutePaths 缺失导入、Future.wait 类型） 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 10:00:17 -08:00
hailin b9b23c36d7 feat(pre-planting): 合并后走正常签合同流程，购买第5份直接跳合并详情页 
- pre_planting_service: CreatePrePlantingOrderResponse 增加 merged/mergeNo 字段
- pre_planting_purchase_page: 购买成功若触发合并，直接跳转合并详情签合同
- contract_check_service: 注入 PrePlantingService，checkAll 增加预种待签合并检查
- pending_contracts_page: 同时展示普通合同和预种合并待签卡片，复用现有签合同弹窗流程
- injection_container: contractCheckServiceProvider 注入 prePlantingService

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 09:51:21 -08:00
hailin 26dcd1d2de fix(pre-planting): 修复购买省市名称存储及多项购买失败问题 
== 问题修复 ==

1. 购买失败：NestJS 返回数组 message 导致 Flutter 类型转换错误
   - 症状：List<dynamic> is not a subtype of String
   - 原因：ValidationPipe 校验失败时 message 字段为 List<String>（每条字段错误一条），
     Flutter _handleDioError 直接用 data['message'] 作为 String 参数导致运行时崩溃
   - 修复：api_client.dart 中对 rawMsg 判断是否 List，若是则 join(', ')

2. 续购省市为空导致 400 校验失败
   - 症状：续购时后端返回 "provinceCode should not be empty"
   - 原因：购买页面续购分支未传入省市，导致 provinceCode/cityCode 为 null
   - 修复：pre_planting_purchase_page.dart 中续购时使用 _position?.provinceCode

3. 购买请求携带 provinceName/cityName 被后端 forbidNonWhitelisted 拒绝
   - 症状：400 "property provinceName should not exist"
   - 原因：前端发送名称字段，但 PurchasePrePlantingDto 未声明这些字段
   - 修复：在 DTO 中添加 @IsOptional() 的 provinceName / cityName 字段

== 功能新增 ==

4. 预种持仓表新增省市名称存储（参照正式认种的处理方式）
   - 迁移：20260228000000_add_province_city_name_to_position
   - Prisma schema：PrePlantingPosition 新增 provinceName / cityName 可空字段
   - 聚合根：addPortions() 接受可选 provinceName/cityName，首购时写入，续购忽略
   - Repository：save/toDomain 同步处理名称字段
   - Application Service：purchasePortion 透传名称，getPosition 返回名称
   - Controller：purchase 端点透传 dto.provinceName / dto.cityName

5. 预种合并时算力精确回滚（contribution-service）
   - 新增 9a-team 步骤：事务内查询即将作废的 TEAM_LEVEL/TEAM_BONUS 算力记录
   - 新增 9c-team 步骤：按账户聚合后精确 decrement 上游推荐人的各档位 pending 和 effective
   - 目的：确保旧份额算力精确回滚，避免新树算力 9d 叠加后造成双倍计入

== UI 优化 ==
   - 购买页面将 "USDT" 改为 "绿积分"（单价、总价、成功提示）

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 08:02:14 -08:00
hailin 20b8d41212 feat(pre-planting): 支持省市名称存储，参照正常认种处理方式 
- PurchasePrePlantingDto 添加可选字段 provinceName/cityName，
  与 SelectProvinceCityDto 保持一致，解决 NestJS forbidNonWhitelisted 400 错误
- pre_planting_positions 表新增 province_name/city_name 列（迁移）
- PrePlantingPosition aggregate 增加 provinceName/cityName 字段
- addPortions() 接受并存储省市名称
- getPosition() 返回 provinceName/cityName 供续购时显示

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 07:48:47 -08:00
hailin 5aa17b05c5 fix(pre-planting): 代码审查修复 2 处小问题 
1. handler: 删除冗余三元表达式（两边相同），改用 new Date(raw) 直接解析
2. service: swapContributionForMerge 增加源订单数量不足时的 warn 日志（不阻断执行）

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 07:28:30 -08:00
hailin 4c6fd424b5 feat(pre-planting): 合成树后算力切换（预种 5 份合同签署触发） 
当用户购买满5份预种后合成1棵树并签署合同时，自动执行算力切换：
1. 作废5份份额的算力记录（is_expired=true，remark 标注合成原因，已挖积分不受影响）
2. 从认种人账户扣减旧个人算力（保持账户余额准确）
3. 以1棵完整树的算力单价创建新算力记录（remark 标注来源订单）
4. 写入 pre_planting_synced_merges 幂等标记

== 实现方式 ==
- 触发节点：Debezium CDC on pre_planting_merges.mining_enabled_at（null → 非null）
- 新增 Debezium table：public.pre_planting_merges
- 新增 Kafka topic 订阅：cdc.pre-planting.public.pre_planting_merges
- 新增 handler：PrePlantingMergeSyncedHandler（解析 CDC 事件）
- 新增 service 方法：swapContributionForMerge（核心算力切换逻辑）
- 新增常量：PRE_PLANTING_MERGE_SOURCE_ID_OFFSET = 20B（区别于份额的 10B 偏移）
- 新增 DB 表：pre_planting_synced_merges（幂等标记，migration 已包含）

== 幂等保证 ==
- CDC 层：processedCdcEvent 表（sourceTopic + offset 唯一）
- 业务层：contribution_records WHERE sourceAdoptionId=20B+mergeId 存在性检查
- 标记层：pre_planting_synced_merges（best-effort，事务提交后写入）

== 对现有系统的影响 ==
- 零修改现有 contribution 调度器 / freeze scheduler
- 团队分润账户净效果≈0（旧5份=1棵树，切换后金额一致）

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 07:22:09 -08:00
hailin eea38b2b86 fix(pre-planting): 购买页面和弹窗中 USDT 改为绿积分 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 07:20:51 -08:00
hailin 9b6effe63d debug(pre-planting): 添加购买流程详细日志以排查 List cast 错误 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 07:19:35 -08:00
hailin 606d3c0b22 fix(pre-planting): 修复购买失败时 List<dynamic> 类型转换错误和续购省市缺失 
1. api_client.dart: NestJS validation error 返回 message 为数组时，
   用 join(', ') 转为字符串，避免直接传给 ApiException(String) 崩溃
2. pre_planting_purchase_page.dart: 续购时传 _position 中已保存的
   provinceCode/cityCode，满足后端 DTO 必填校验

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 06:56:49 -08:00
hailin 2d7b02aa96 fix(pre-planting): 修复预种页面 5 个 UI 问题（纯前端，零后端改动） 
=== 问题 1：流水明细合同按钮 500 错误 ===
文件: ledger_detail_page.dart
原因: 预种订单（PPL 前缀）无合同，但流水详情弹窗显示「查看合同/下载合同」按钮
修复: _showTransactionDetail 检测 refOrderId.startsWith('PPL')，
      预种订单传 showContractButtons: false，弹窗不渲染合同按钮区

=== 问题 2：流水备注显示英文 ===
文件: ledger_detail_page.dart
原因: 备注字段存储的是 'Plant payment (from frozen)'（后端写入，不改后端）
修复: _TransactionDetailSheet 展示备注时，若订单号以 PPL 开头则显示「预种」

=== 问题 3：预种明细订单金额单位错误 ===
文件: pre_planting_position_page.dart
修复: '${order.totalAmount.toInt()} USDT' → '${order.totalAmount.toInt()} 绿积分'

=== 问题 4：省市显示数字代码（如 44 · 4401）===
文件: pre_planting_position_page.dart / pre_planting_purchase_page.dart
原因: provinceName/cityName 为 null 时回退显示 provinceCode/cityCode
修复:
  - position 页：条件改为 provinceName != null && cityName != null，无中文名则不显示省市行
  - purchase 页：加载时不再 fallback 到代码；锁定显示无名称时显示「已锁定」；
    购买确认弹窗省市行无名称时显示「-」

=== 问题 5：「合并进度」改为「合成进度」===
文件: pre_planting_position_page.dart / pre_planting_purchase_page.dart
修复: 两处 Text('合并进度') → Text('合成进度')

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 06:25:38 -08:00
hailin f4c9535e12 feat(capability): 补齐全部后端 API 能力拦截 
## 背景
审计发现 13 项用户能力中，部分后端 API 端点缺少 @RequireCapability
拦截，用户可绕过前端 UI 限制直接调用 API。本次逐服务补齐。

## Phase 1: 高优先级 — 操作端点

### auth-service
- POST /auth/password/change → @RequireCapability('PROFILE_EDIT')
  修改登录密码需要 PROFILE_EDIT 能力
- POST /auth/trade-password/set → @RequireCapability('PROFILE_EDIT')
  设置交易密码需要 PROFILE_EDIT 能力
- POST /auth/trade-password/change → @RequireCapability('PROFILE_EDIT')
  修改交易密码需要 PROFILE_EDIT 能力
- POST /auth/trade-password/verify → @RequireCapability('TRADING')
  验证交易密码是交易前置步骤，需要 TRADING 能力

### trading-service
- POST /c2c/orders/:orderNo/cancel → @RequireCapability('C2C')
  C2C 取消订单是唯一缺失 C2C 能力检查的操作端点

## Phase 2: 低优先级 — 查看端点

### trading-service
- GET /trading/orders → VIEW_RECORDS (用户订单列表)
- GET /trading/trades → VIEW_RECORDS (成交记录)
- GET /transfers/history → VIEW_RECORDS (划转历史)
- GET /p2p/transfers/:accountSequence → VIEW_RECORDS (P2P转账历史)
- GET /c2c/orders/my → VIEW_RECORDS (我的C2C订单)

### contribution-service
- GET /contribution/accounts/:accountSequence/active → VIEW_ASSET
- GET /contribution/accounts/:accountSequence/planting-ledger → VIEW_RECORDS

## 能力覆盖总览 (补齐后)
| 能力 | 端点数 | 状态 |
|------|--------|------|
| LOGIN | 全局 | ✅ JwtAuthGuard 拦截 |
| TRADING | 3 | ✅ createOrder, cancelOrder, verifyTradePassword |
| C2C | 6 | ✅ create, take, cancel, confirmPayment, confirmReceived, uploadProof |
| TRANSFER_IN | 1 | ✅ transferIn |
| TRANSFER_OUT | 1 | ✅ transferOut |
| P2P_SEND | 1 | ✅ transfer |
| KYC | 1 | ✅ submitKyc |
| PROFILE_EDIT | 3 | ✅ changePassword, setTradePassword, changeTradePassword |
| VIEW_ASSET | 2 | ✅ getMyAsset, getActiveContribution |
| VIEW_TEAM | 2 | ✅ getMyTeamInfo, getDirectReferrals |
| VIEW_RECORDS | 6 | ✅ 各服务历史记录端点 |
| P2P_RECEIVE | 0 | 仅前端展示控制（无后端操作端点） |
| MINING_CLAIM | 0 | mining-service 需后续重构(@Public 类级别) |

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 05:22:37 -08:00
hailin 97f8b7339f fix(auth): LOGIN 能力禁用后强制下线已登录用户 
## 问题
管理员在后台禁用用户的 LOGIN 能力后，该用户仍然可以正常使用 mining-app。
原因是 LOGIN 检查只在登录/刷新 token 时执行，已持有有效 JWT（7天有效期）
的用户不会被影响，直到 token 过期才会被拦截。

## 修复

### 后端 - JwtAuthGuard (auth-service)
- 在 JWT 验证通过后，增加 LOGIN 能力实时检查
- 调用 CapabilityService.isCapabilityEnabled() 查询 Redis 缓存
- LOGIN 被禁用时返回 403 ForbiddenException（"您的账户已被限制登录"）
- 采用 fail-open 策略：Redis/DB 查询失败时放行，不影响正常用户
- 每次认证请求多一次 Redis GET（<1ms），对当前用户规模无性能影响

### 前端 - mining-app API Client
- 新增 onLoginDisabled 全局回调（类似现有的 onUnauthorized）
- Dio 拦截器检测 403 响应中包含"限制登录"关键词时触发回调
- 回调执行：清除用户状态 + 跳转登录页（与 401 处理一致）

## 影响范围
- 所有使用 @UseGuards(JwtAuthGuard) 的端点都会实时检查 LOGIN 能力
- 管理员禁用 LOGIN 后，用户下一次 API 请求即被拦截并强制下线
- 不影响公开端点（登录、注册等不经过 JwtAuthGuard 的接口）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-28 05:01:37 -08:00
hailin a7f2008bc2 feat(pre-planting): 添加算力补偿调度器，修复 transfer_order_no schema 一致性 
问题：CDC 后置回调失败（如迁移未就绪）后，pre_planting_synced_orders 记录
status=PAID 但 contributionDistributed=false，没有机制重新触发算力计算。

修复：
1. 新增 PrePlantingContributionScheduler（每 5 分钟）：
   - 扫描未分配算力的 PAID 预种订单
   - 调用 processUndistributedOrders() 补偿分配
   - Redis 分布式锁防并发
2. 注册到 PrePlantingCdcModule 的 providers

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 03:08:06 -08:00
hailin b747555927 fix(contribution-service): 补充缺失的 transfer_order_no 迁移文件 
schema.prisma 中 ContributionRecord / SystemContributionRecord /
UnallocatedContribution 三个模型均新增了 transferOrderNo 字段，
但历史上只有 0001_init 一个迁移文件，导致生产数据库中缺少该列。

新增迁移 20260228000001_add_transfer_order_no：
- ALTER TABLE contribution_records ADD COLUMN transfer_order_no
- ALTER TABLE system_contribution_records ADD COLUMN transfer_order_no
- ALTER TABLE unallocated_contributions ADD COLUMN transfer_order_no
- 对应 3 个索引（与 schema @@index 一致）
- 使用 IF NOT EXISTS 保证幂等性

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 03:00:40 -08:00
hailin 390e5ccb19 fix(pre-planting): 用 orderNo 替代 BigInt 自增 ID 作为 CDC 关联键 
问题：Debezium CDC 事件中 Prisma @map("order_id") 字段以 DB 列名
order_id 发送，而代码访问 data.id 导致 undefined → BigInt 转换失败。

修复方案（遵循"用 orderNo 业务键关联"原则）：
- pre-planting-order-synced.handler.ts：
  * PrePlantingOrderSyncResult 改为 { orderNo: string }
  * handleCreateOrSnapshot/handleUpdate 均用 order_no 字段
  * syncToTrackingTable upsert where 改为 { orderNo }
  * ensureAdoptionMarker 入参从 orderId bigint 改为 orderNo string
    - markerAdoptionId = PRE_PLANTING_SOURCE_ID_OFFSET + hash(orderNo)
  * isAlreadyDistributed 改为 findUnique({ where: { orderNo } })
  * calculateAfterCommit 传 result.orderNo
- pre-planting-contribution.service.ts：
  * calculateForPrePlantingOrder 入参从 bigint 改为 string(orderNo)
  * findUnique({ where: { orderNo } }) 查询，用存储的 originalOrderId 计算偏移
  * 所有日志/update 中 originalOrderId 替换为 orderNo
  * processUndistributedOrders 改为传 order.orderNo，orderBy 改为 createdAt
- schema.prisma：orderNo 字段新增 @unique 约束
- migration SQL：CREATE UNIQUE INDEX on order_no 列

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 02:31:04 -08:00
hailin 560674f2e9 fix(pre-planting): 无推荐关系用户购买预种时 404 导致整笔交易失败 
问题：PrePlantingReferralClient.getReferralChain() 生产环境遇到 404
（用户无推荐人）时直接 throw error，导致整个购买事务回滚，
无推荐关系的用户（测试账号、直接注册用户）完全无法购买预种份额。

修复：AxiosError status === 404 时返回 { directReferrer: null }，
与"直接注册、无推荐人"的正常业务场景对齐，不阻断购买流程。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-28 02:13:29 -08:00