rwadurian/frontend/mobile-app/lib/core/services
hailin a55201b3b3 feat(referral+mobile): 功能6 — App 团队预种数量展示
纯新增实现,不修改任何现有业务逻辑,对现有系统零风险。

## 后端 — referral-service

新建 TeamPrePlantingController(JWT 认证),2 个公开端点:

1. GET /referral/me/team-pre-planting
   - 返回当前用户的个人预种份数、团队预种总量
   - 返回直推成员列表及每人的预种份数
   - 从 TeamStatistics 表读取(CDC 事件维护的数据)

2. GET /referral/me/team-pre-planting/members?limit=20&offset=0
   - 分页返回全部团队成员的预种明细(仅有预种份数 > 0 的成员)
   - 使用 ancestor_path 数组查询所有下级用户
   - JOIN team_statistics 获取每人的 selfPrePlantingPortions

Kong 网关无需修改(/api/v1/referral/* 已覆盖)。

## 前端 — Flutter mobile-app

新建 TeamPrePlantingPage 页面:
- 顶部统计卡片:个人预种 + 团队预种总量
- 直推预种明细列表(所有用户可见)
- 全部团队成员预种明细(仅市/省公司管理者可见,分页加载更多)
- 普通用户看到锁定提示"仅市公司/省公司管理者可查看"

入口:个人中心页预种按钮行新增绿色「团队预种」按钮。

## 文件清单

新建文件:
- backend/.../controllers/team-pre-planting.controller.ts(核心后端控制器)
- frontend/.../pages/team_pre_planting_page.dart(Flutter 团队预种页面)

微量修改(仅追加新行):
- controllers/index.ts: +1 行 export
- api.module.ts: +2 行 import/注册
- api_endpoints.dart: +2 行端点常量
- referral_service.dart: +4 模型类 +2 API 方法
- route_paths.dart, route_names.dart: +1 行路由定义
- app_router.dart: +1 import +1 GoRoute
- profile_page.dart: 预种按钮行追加第三个按钮

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 07:15:17 -08:00
..
account_service.dart fix(mobile-app): 修复头像更新未同步到账号列表的问题 2025-12-27 10:25:19 -08:00
app_asset_service.dart fix(app-assets): 修复公开API路径双重前缀 + Kong网关路由缺失 2026-02-05 04:36:53 -08:00
auth_event_service.dart feat(auth): 实现修改密码API和Token过期自动跳转登录 2025-12-23 20:25:56 -08:00
authorization_service.dart fix(mobile): 改进用户详情页风格和火柴人进度计算 2025-12-24 01:41:41 -08:00
contract_check_service.dart fix(pre-planting): 修复编译错误(getMerges→getMyMerges、RoutePaths 缺失导入、Future.wait 类型) 2026-02-28 10:00:17 -08:00
contract_signing_service.dart feat(mobile-app): 增强合同PDF下载可靠性和用户体验 2026-01-09 07:12:21 -08:00
customer_service_contact_service.dart feat(customer-service): 客服联系方式从硬编码改为后台可配置 2026-02-05 05:00:25 -08:00
deposit_service.dart fix(mobile-app): always fetch deposit address from server in deposit_service 2026-01-04 10:17:41 -08:00
leaderboard_service.dart fix(mobile-app): correct leaderboard status API path 2026-01-04 03:45:55 -08:00
maintenance_service.dart feat(mobile-app,admin): 添加系统维护功能和通知徽章功能 2025-12-27 23:26:01 -08:00
multi_account_service.dart fix(mobile-app): 增加切换账号全局防护,彻底解决切换期间自动退出登录 2026-02-26 12:41:45 -08:00
notification_service.dart feat(notification): 新增强制阅读弹窗功能(管理员可配置 requiresForceRead) 2026-02-27 19:33:51 -08:00
pending_action_check_service.dart feat(pending-actions): add user pending actions system 2026-01-02 18:22:51 -08:00
pending_action_polling_service.dart feat(mobile-app): 添加待办操作轮询机制 2026-01-05 05:36:18 -08:00
pending_action_service.dart feat(pending-actions): add special deduction feature for admin-created user actions 2026-01-03 07:04:46 -08:00
planting_service.dart fix(mobile-app): 修复认种订单解析和状态检查问题 2026-01-09 02:49:31 -08:00
pre_planting_service.dart feat(pre-planting): 预种方案调整 — 18870 USDT/棵,10份合1树 2026-03-01 18:32:32 -08:00
referral_service.dart feat(referral+mobile): 功能6 — App 团队预种数量展示 2026-03-02 07:15:17 -08:00
reward_service.dart feat(ledger): add detailed ledger entry views with source tracking 2026-01-03 20:09:17 -08:00
system_config_service.dart fix(app-assets): 修复公开API路径双重前缀 + Kong网关路由缺失 2026-02-05 04:36:53 -08:00
transfer_service.dart fix(transfer): 修复转让记录 API 路径与参数不匹配 2026-03-01 23:35:09 -08:00
tree_pricing_service.dart feat(pre-planting): 预种方案调整 — 18870 USDT/棵,10份合1树 2026-03-01 18:32:32 -08:00
wallet_service.dart feat(ledger): 流水明细显示来源用户ID + 统计兼容历史批量转换数据 2026-03-01 10:41:11 -08:00