hailin/gcx - gcx - AI Wolves Team

Commit Graph

Author	SHA1	Message	Date
hailin	4feea2667c	refactor(admin-web): 实现 Clean Architecture + Zustand + Redux Toolkit 按要求重构架构，从扁平的 React Context + useState 升级为大厂标准模式： Clean Architecture 分层： domain/entities/ — 业务实体 (AdminUser/User/Issuer/AppVersion) domain/repositories/ — Repository 接口（契约层） infrastructure/http/ — HttpClient（替代旧 api-client.ts） infrastructure/repositories/ — Repository 实现（AuthRepository/UserRepository）状态管理（大厂混合模式）： Zustand useAuthStore — 轻量客户端状态：登录会话 + localStorage 持久化 Zustand useUIStore — UI 偏好：sidebar 折叠状态持久化 Redux uiSlice — 全局通知队列、globalLoading Redux usersSlice — 用户列表筛选/分页 client state React Query — 服务端数据 fetching/缓存（保留）更新： providers.tsx — 加入 Redux Provider，移除旧 AuthProvider auth-context.tsx — 向下兼容层，re-export Zustand store api-client.ts — 向下兼容层，re-export httpClient AdminLayout.tsx — 使用 Zustand auth/ui store Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-04 19:18:20 -08:00
hailin	e8d9bdc2fb	fix(api): 修复前后端 API 对接 — 响应结构+字段名对齐端到端审查发现并修复 4 类前后端不匹配问题: ## 1. 响应结构嵌套不匹配后端返回 `{ data: { user, tokens: { accessToken, refreshToken } } }` 但 miniapp/admin-app/admin-web 均按扁平结构解析 - miniapp services/auth.ts: 新增 AuthResponse→LoginResult 映射层 - miniapp store/auth.ts: 从 `resp.tokens.accessToken` 取 token - admin-app auth_service.dart: LoginResult.fromJson 优先从 tokens 子对象取 - admin-web auth-context.tsx: 从 `result.tokens.accessToken` 取 token ## 2. 密码登录字段名不匹配后端 LoginDto 字段为 `identifier`, 但 admin-app 发 `email`, admin-web 发 `email` - admin-app: `'email' → 'identifier'` - admin-web: `{ email, password } → { identifier: email, password }` ## 3. 注册 password 字段必填 vs 前端可选 miniapp h5-register 只收集手机+验证码, 不传 password, 会触发 400 校验 - backend RegisterDto: password 改为 @IsOptional - auth.service.ts: 未传 password 时自动生成随机密码 ## 4. miniapp LoginResult 类型导出 - 导出 LoginResult 接口供外部使用 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-23 21:39:26 -08:00
hailin	3a57b0fd4d	feat: 全平台API对齐 — 4个前端应用55+页面接入真实后端API 跨越 genex-mobile、admin-app、admin-web、miniapp 四个前端应用，将所有页面从 mock 硬编码数据替换为真实后端 API 调用，同时补建后端缺失的 27+ 个端点，实现前后端完整联通。 ## 后端新增 (4个微服务, 27+端点) ### issuer-service — 5个新Controller, 19个新文件 - IssuerStatsController: GET /issuers/me/stats, /credit (发行商仪表盘统计+信用) - IssuerFinanceController: GET/POST balance/stats/transactions/withdraw/reconciliation - IssuerStoreController: CRUD /issuers/me/stores + /employees (门店+员工管理) - RedemptionController: POST scan/manual/batch, GET history/today-stats (核销) - CouponBatchController: POST issue/recall/price-adjust, GET operations (批量操作) - CouponController扩展: GET /search, /:id/nearby-stores, /:id/similar - 新实体: Employee, Redemption; Store 增加 level/parentId - 新迁移: 032_create_stores_employees_redemptions.sql ### trading-service (Go) - GET /api/v1/trades/my/orders — 用户订单列表(分页+状态筛选) - POST /api/v1/trades/coupons/:id/transfer — 券转赠 ### user-service - GET/PUT /api/v1/users/me/settings — 用户偏好设置(语言/货币/通知) ### auth-service - POST /api/v1/auth/send-sms-code — 发送短信验证码(Redis存储, 5分钟TTL) - POST /api/v1/auth/login-phone — 手机号+验证码登录(自动注册) ### Kong 路由 - 新增5条路由: issuers/me, redemptions, coupons/batch, trades/my, trades/coupons ## genex-mobile (Flutter, 2页) - HomePage: 接入 CouponApiService.getFeaturedCoupons() + getHoldingsSummary() - WalletCouponsPage: 接入持仓列表API, 支持Tab状态筛选 - 修复 NotificationService/PushService 7+2个路径缺少 /api/v1/ 前缀 - 新增 CouponApiService, CouponModel, HoldingsSummaryModel ## admin-app (Flutter发行商控制台, 11页 + router + i18n) - 修复 NotificationService 7个路径 + PushService 2个路径前缀 - 新增9个Service: auth, issuer, coupon, finance, credit, store, redemption, analytics, ai_chat - 11页全部从 StatelessWidget→StatefulWidget, mock→API: IssuerLoginPage(SMS登录), Dashboard(统计), CouponList(分页+筛选), CreateCoupon(提交审核), CouponDetail(详情), Redemption(扫码/手动/批量核销), Finance(余额/流水/对账), Credit(评分), StoreManagement(门店+员工), AiAgent(真实AI对话), Settings(资料+登出) - 所有页面添加 loading/error/pull-to-refresh 状态 ## admin-web (Next.js 15管理后台, 24页) - 新建API基础设施: api-client.ts(axios), auth-context.tsx, use-api.ts(react-query) - providers.tsx 接入 QueryClientProvider + AuthProvider - 24页全部替换 useState(mockArray) 为 useApi<T>('/api/v1/admin/...'): Dashboard, Users, Issuers, Coupons, Trading, Risk, Finance, System, Compliance(SAR/SEC/License/SOX/Tax/IPO), Analytics(User/Coupon/MM/Consumer), Disputes, Chain, Reports, Merchant, Agent, Insurance - 所有页面添加 TypeScript 接口, loading/error 状态, 'use client' 指令 - 状态比较改用原始API字符串(非t()翻译值) ## miniapp (Taro/React小程序, 20页) - 新建API基础设施: config/index.ts, utils/request.ts(Taro.request封装), store/auth.ts - 新增8个Service: auth, coupon, my-coupon, user, trading, wallet, notification, ai - 20页全部替换硬编码数据为Service调用: Home, Search, Detail, Purchase, PaymentSuccess, MyCoupons, MyCouponDetail, Redeem, Transfer, Profile, Orders, Messages, Wallet, Settings, KYC, AIChat, Login, H5Share, H5Activity, H5Register - 统一 useState+useEffect 数据获取模式, 错误处理, 加载状态 ## 统计 - 新建文件: ~51个 (后端26 + 前端25) - 修改文件: ~93个 (后端24 + 前端69) - 新增后端端点: 27+ - 前端页面接入API: 55+ (genex-mobile 2 + admin-app 11 + admin-web 24 + miniapp 20) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-22 22:53:07 -08:00

Author

SHA1

Message

Date

hailin

4feea2667c

refactor(admin-web): 实现 Clean Architecture + Zustand + Redux Toolkit

按要求重构架构，从扁平的 React Context + useState 升级为大厂标准模式：

Clean Architecture 分层：
  domain/entities/          — 业务实体 (AdminUser/User/Issuer/AppVersion)
  domain/repositories/      — Repository 接口（契约层）
  infrastructure/http/      — HttpClient（替代旧 api-client.ts）
  infrastructure/repositories/ — Repository 实现（AuthRepository/UserRepository）

状态管理（大厂混合模式）：
  Zustand useAuthStore      — 轻量客户端状态：登录会话 + localStorage 持久化
  Zustand useUIStore        — UI 偏好：sidebar 折叠状态持久化
  Redux uiSlice             — 全局通知队列、globalLoading
  Redux usersSlice          — 用户列表筛选/分页 client state
  React Query               — 服务端数据 fetching/缓存（保留）

更新：
  providers.tsx             — 加入 Redux Provider，移除旧 AuthProvider
  auth-context.tsx          — 向下兼容层，re-export Zustand store
  api-client.ts             — 向下兼容层，re-export httpClient
  AdminLayout.tsx           — 使用 Zustand auth/ui store

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

2026-03-04 19:18:20 -08:00

hailin

e8d9bdc2fb

fix(api): 修复前后端 API 对接 — 响应结构+字段名对齐

端到端审查发现并修复 4 类前后端不匹配问题:

## 1. 响应结构嵌套不匹配
后端返回 `{ data: { user, tokens: { accessToken, refreshToken } } }`
但 miniapp/admin-app/admin-web 均按扁平结构解析

- miniapp services/auth.ts: 新增 AuthResponse→LoginResult 映射层
- miniapp store/auth.ts: 从 `resp.tokens.accessToken` 取 token
- admin-app auth_service.dart: LoginResult.fromJson 优先从 tokens 子对象取
- admin-web auth-context.tsx: 从 `result.tokens.accessToken` 取 token

## 2. 密码登录字段名不匹配
后端 LoginDto 字段为 `identifier`, 但 admin-app 发 `email`, admin-web 发 `email`

- admin-app: `'email' → 'identifier'`
- admin-web: `{ email, password } → { identifier: email, password }`

## 3. 注册 password 字段必填 vs 前端可选
miniapp h5-register 只收集手机+验证码, 不传 password, 会触发 400 校验

- backend RegisterDto: password 改为 @IsOptional
- auth.service.ts: 未传 password 时自动生成随机密码

## 4. miniapp LoginResult 类型导出
- 导出 LoginResult 接口供外部使用

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

2026-02-23 21:39:26 -08:00

hailin

3a57b0fd4d

feat: 全平台API对齐 — 4个前端应用55+页面接入真实后端API

跨越 genex-mobile、admin-app、admin-web、miniapp 四个前端应用，
将所有页面从 mock 硬编码数据替换为真实后端 API 调用，
同时补建后端缺失的 27+ 个端点，实现前后端完整联通。

## 后端新增 (4个微服务, 27+端点)

### issuer-service — 5个新Controller, 19个新文件
- IssuerStatsController: GET /issuers/me/stats, /credit (发行商仪表盘统计+信用)
- IssuerFinanceController: GET/POST balance/stats/transactions/withdraw/reconciliation
- IssuerStoreController: CRUD /issuers/me/stores + /employees (门店+员工管理)
- RedemptionController: POST scan/manual/batch, GET history/today-stats (核销)
- CouponBatchController: POST issue/recall/price-adjust, GET operations (批量操作)
- CouponController扩展: GET /search, /:id/nearby-stores, /:id/similar
- 新实体: Employee, Redemption; Store 增加 level/parentId
- 新迁移: 032_create_stores_employees_redemptions.sql

### trading-service (Go)
- GET /api/v1/trades/my/orders — 用户订单列表(分页+状态筛选)
- POST /api/v1/trades/coupons/:id/transfer — 券转赠

### user-service
- GET/PUT /api/v1/users/me/settings — 用户偏好设置(语言/货币/通知)

### auth-service
- POST /api/v1/auth/send-sms-code — 发送短信验证码(Redis存储, 5分钟TTL)
- POST /api/v1/auth/login-phone — 手机号+验证码登录(自动注册)

### Kong 路由
- 新增5条路由: issuers/me, redemptions, coupons/batch, trades/my, trades/coupons

## genex-mobile (Flutter, 2页)
- HomePage: 接入 CouponApiService.getFeaturedCoupons() + getHoldingsSummary()
- WalletCouponsPage: 接入持仓列表API, 支持Tab状态筛选
- 修复 NotificationService/PushService 7+2个路径缺少 /api/v1/ 前缀
- 新增 CouponApiService, CouponModel, HoldingsSummaryModel

## admin-app (Flutter发行商控制台, 11页 + router + i18n)
- 修复 NotificationService 7个路径 + PushService 2个路径前缀
- 新增9个Service: auth, issuer, coupon, finance, credit, store, redemption, analytics, ai_chat
- 11页全部从 StatelessWidget→StatefulWidget, mock→API:
  IssuerLoginPage(SMS登录), Dashboard(统计), CouponList(分页+筛选),
  CreateCoupon(提交审核), CouponDetail(详情), Redemption(扫码/手动/批量核销),
  Finance(余额/流水/对账), Credit(评分), StoreManagement(门店+员工),
  AiAgent(真实AI对话), Settings(资料+登出)
- 所有页面添加 loading/error/pull-to-refresh 状态

## admin-web (Next.js 15管理后台, 24页)
- 新建API基础设施: api-client.ts(axios), auth-context.tsx, use-api.ts(react-query)
- providers.tsx 接入 QueryClientProvider + AuthProvider
- 24页全部替换 useState(mockArray) 为 useApi<T>('/api/v1/admin/...'):
  Dashboard, Users, Issuers, Coupons, Trading, Risk, Finance, System,
  Compliance(SAR/SEC/License/SOX/Tax/IPO), Analytics(User/Coupon/MM/Consumer),
  Disputes, Chain, Reports, Merchant, Agent, Insurance
- 所有页面添加 TypeScript 接口, loading/error 状态, 'use client' 指令
- 状态比较改用原始API字符串(非t()翻译值)

## miniapp (Taro/React小程序, 20页)
- 新建API基础设施: config/index.ts, utils/request.ts(Taro.request封装), store/auth.ts
- 新增8个Service: auth, coupon, my-coupon, user, trading, wallet, notification, ai
- 20页全部替换硬编码数据为Service调用:
  Home, Search, Detail, Purchase, PaymentSuccess,
  MyCoupons, MyCouponDetail, Redeem, Transfer,
  Profile, Orders, Messages, Wallet, Settings, KYC, AIChat,
  Login, H5Share, H5Activity, H5Register
- 统一 useState+useEffect 数据获取模式, 错误处理, 加载状态

## 统计
- 新建文件: ~51个 (后端26 + 前端25)
- 修改文件: ~93个 (后端24 + 前端69)
- 新增后端端点: 27+
- 前端页面接入API: 55+ (genex-mobile 2 + admin-app 11 + admin-web 24 + miniapp 20)

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

2026-02-22 22:53:07 -08:00

3 Commits