hailin
/
gcx
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
85 Commits 1 Branch 0 Tags 38 MiB
Commit Graph

85 Commits

Author SHA1 Message Date
hailin 8e9ee1d38b fix(docker): 端口避让 + admin-service依赖修复 
- 所有端口改为不冲突范围: 基础设施4xxxx, 服务4xxx
- admin-service添加adbkit-apkreader/unzipper/bplist-parser依赖
- 修复Platform类型推断

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 20:34:24 -08:00
hailin 2f583a0a24 fix(admin-service): 添加APK/IPA解析依赖 + 修复Platform类型推断 
- 添加adbkit-apkreader, unzipper, bplist-parser
- 修复platform变量类型为Platform枚举

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 19:58:12 -08:00
hailin c42827c6c1 fix(backend): 修复所有服务编译问题 — tsconfig宽松化 + 补全缺失依赖 
- 所有tsconfig.json: strict改为false, 移除paths映射(改用node_modules解析)
- compliance/clearing/ai/notification: 添加缺失的@nestjs/passport和@nestjs/jwt
- ai-service: 添加缺失的@nestjs/config

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 19:20:48 -08:00
hailin a31c1aa478 fix(common): 修复@genex/common包TypeScript编译错误 
- current-user.decorator: 移除显式返回类型以兼容undefined字段访问
- http-exception.filter: 为message变量提供默认值避免TS2454

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 19:04:21 -08:00
hailin d48bd3acb9 feat(docker): 重构Monorepo构建 — 支持@genex/common共享包 
- docker-compose.yml build context从service目录改为backend根目录
- 所有NestJS Dockerfile改为先构建共享@genex/common包
- 共享包编译后复制到service的node_modules供运行时解析
- 新增backend/.dockerignore减少构建上下文体积

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 19:00:27 -08:00
hailin d146bf0a1f fix(tsconfig): 关闭strictPropertyInitialization以兼容TypeORM实体 
TypeORM实体使用装饰器定义属性，不在构造函数中初始化。
strict:true隐式启用strictPropertyInitialization导致TS2564编译错误。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 17:48:48 -08:00
hailin 12bb31ede1 fix(docker): 所有NestJS服务Dockerfile使用npm install替代npm ci 
项目未包含package-lock.json，npm ci要求该文件存在才能运行。
改用npm install确保Docker构建正常完成。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 17:33:31 -08:00
hailin c11d009ae7 fix: admin-service/telemetry-service Dockerfile 改为多阶段构建 
修复缺少 builder 阶段导致 COPY dist/ 找不到目录的问题

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 17:29:56 -08:00
hailin bc0d1e0876 feat: 新增 deploy.sh 部署管理脚本体系 — 后端主控+12服务独立+区块链 
参照 rwadurian 项目模式，为全栈系统创建统一的 deploy.sh 管理体系：

- backend/deploy.sh: 主控脚本 (up/down/restart/build/build-no-cache/health/infra-*/单服务操作)
- 12个服务独立 deploy.sh (build/rebuild/start/stop/restart/logs/health/shell/test)
- blockchain/deploy.sh: 节点+生态+合约+浏览器+监控全覆盖
- 更新 09-编译部署指南.md 新增第9章 deploy.sh 使用文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-19 17:13:09 -08:00
hailin cc4d3d11f8 docs: 新增09-编译部署指南 — 全栈编译、运行与生产部署完整文档 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 16:54:03 -08:00
hailin be3555f338 fix(chain-indexer): 替换Mock为真实区块链RPC索引 — 接入Genex Chain EVM节点 
## 背景
chain-indexer(:3009)此前使用Mock模式，每10秒生成假区块数据(hash为纯数字填充，
txCount固定为0)，未连接任何真实区块链节点。这是整个区块链架构中唯一的功能缺口
(8大核心服务中TX Indexer完成度仅85%)。

## 改动内容

### 新增文件
- internal/domain/repository/chain_client.go
  DDD领域接口ChainClient，定义GetLatestBlockNumber/GetBlockByNumber/Close三个方法，
  遵循依赖倒置原则，应用层不依赖具体RPC实现

- internal/infrastructure/rpc/eth_client.go
  EthChainClient实现，基于go-ethereum/ethclient：
  · ethclient.Dial()连接EVM JSON-RPC节点
  · BlockByNumber()获取完整区块(hash/timestamp/txCount)
  · types.LatestSignerForChainID()恢复交易发送方地址
  · TransactionReceipt()获取交易执行状态(confirmed/failed)

### 修改文件
- go.mod: 新增github.com/ethereum/go-ethereum v1.14.8依赖

- internal/application/service/indexer_service.go
  · 注入ChainClient依赖，移除所有Mock逻辑
  · 轮询间隔10s→2s(匹配链~1s出块时间)
  · 批量追赶：每周期最多索引50个区块，快速消化落后高度
  · 新增GetChainHeight()/IsSynced()方法供API层使用
  · 区块+交易分别持久化，每条交易独立发布Kafka事件

- cmd/server/main.go
  · 新增RPC_URL环境变量(默认http://localhost:8545)
  · 初始化EthChainClient并注入IndexerService
  · /api/v1/chain/status返回真实chainHeight和syncing状态

- internal/interface/http/handler/admin_chain_handler.go
  · GetContracts: 合约列表更新为真实11个已部署合约(与genex-contracts对齐)
  · GetGasMonitor: Gas数据全部归零(Genex Chain min_gas_price=0平台补贴)
  · GetChainStats: 使用真实chainHeight计算indexerLag/tps/indexerStatus
  · chainId修正88888→8888，consensusType修正PoA→CometBFT

## 环境变量
RPC_URL=http://localhost:8545  (Docker内使用 http://genex-node-1:8545)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-16 18:04:18 -08:00
hailin 4c1d907df6 feat: ERC-1155 同质化券系统 + denom统一为agnx (18位EVM标准) 
新增ERC-1155双模式券系统(Utility Track专用):
- ICouponBatch接口 + CouponBatch核心合约(FACTORY/BURNER角色)
- Redemption1155兑付合约(余额/过期/门店/黑名单验证)
- CouponFactory新增mintBatch1155路由(上限100,000张O(1)铸造)
- Deploy.s.sol部署CouponBatch+Redemption1155+角色授权
- 46个新测试(CouponBatch 16 + Redemption1155 9 + Factory 11 + Integration 5 + fuzz)

Denom统一: ugnx(6位)→agnx(18位EVM标准), 金额×10^12

全量测试143/143通过，编译零错误。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 22:34:30 -08:00
hailin 0ea869ac46 fix: 区块链生态审计修复 — SDK补全 + Enterprise API加固 + 删除无用wallet-service 
基于08-区块链生态基础设施开发指南的全面审计，修复以下问题：

## SDK 补全（对齐指南 §7.2-7.4）

- **JS SDK**: 新增 SettlementModule (settlement.ts)，实现 executeSwap() 合约交互
  和 onSwapExecuted() 事件监听，补齐指南 §7.2 要求的 settlement 模块
- **Go SDK**: 新增 ExecuteSwap() 函数 (settlement.go)，完整实现 ABI 编码 → nonce
  获取 → gas 估算 → 签名 → 广播 → receipt 等链上交易全流程
- **Dart SDK**: 新增统一事件订阅接口 subscribeEvents(EventFilter)，匹配指南 §7.4
  规范；新增 EventFilter 模型类，支持 newHeads/logs 两种订阅类型

## Enterprise API 加固（对齐指南 §3.2/§3.4）

- 新增 TierThrottlerGuard 分层限流守卫，按 API tier 区分速率限制：
  public 60/min, institutional 600/min, regulatory/internal unlimited
- WebSocket 网关增加完整认证：API Key 通过 query param 或 header 传递，
  最低要求 institutional 级别，未认证连接自动拒绝

## 删除无用的 wallet-service（架构纠正）

- 删除 blockchain/wallet-service/ 整个目录（13个文件，875行代码）
  该服务架构设计有误：钱包操作（用户钱包、机构操作、治理多签）已由现有
  后端微服务处理（user-service:3001、issuer-service:3002、trading-service:3003、
  clearing-service:3004），无需在 blockchain/ 目录下另建独立服务
- docker-compose.yml: 移除 wallet-service 服务定义和端口 3021 映射
- chain-ci.yml: 从 NestJS 生态服务 CI matrix 中移除 wallet-service
- 08-指南: 删除第4节(钱包体系 §4.1-4.3)，移除部署清单中 MPC签名服务:3021，
  更新生态全景图，章节重新编号 (12→11章)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 22:05:52 -08:00
hailin 3783c5a91b feat: 区块链生态基础设施完整实现 — 12组件全量交付 (Phase 11) 
严格遵循 08-区块链生态基础设施开发指南.md，实现全部 12 个生态组件：

### 1. Blockscout 区块浏览器 (:4000)
- docker-compose.explorer.yml: Blockscout + PostgreSQL 16 + Redis 7 + Smart Contract Verifier
- 4 个自定义 Elixir 模块: 券NFT详情页、合规标签、发行人档案、CBS池视图

### 2. 企业API服务 — enterprise-api (NestJS, :3020)
- 4层认证体系: Public(gx_pub_) / Institutional(gx_inst_) / Regulatory(gx_reg_) / Internal(gx_internal_)
- ApiKeyGuard + MtlsGuard 双重认证, RequireApiTier 装饰器
- 8个业务模块: blocks, transactions, address, coupon, stats, rpc, export, regulatory
- WebSocket 事件网关 (/v1/ws/events), 合约 ABI 集成 (ethers v6)

### 3. MPC钱包服务 — wallet-service (NestJS, :3021)
- 2-of-3 阈值签名 (us-east/sg/cold-storage HSM 分片)
- 用户钱包 (手机号→链地址映射)、机构钱包 (mint/deposit/trade + 多签)
- 治理钱包 (Gnosis Safe 5签名人, 3/5常规 4/5紧急阈值, 提案生命周期)

### 4. Gas代付中继 — gas-relayer (NestJS, :3022)
- EIP-712 类型化数据签名验证 (verifyTypedData)
- Redis 原子 Nonce 管理 (INCR), 用户级重放保护 (SADD/SISMEMBER)
- 熔断器: 50 tx/min/user, 60s TTL 速率计数
- Gas 记账: 按用户 HINCRBY 追踪, 全局统计

### 5. 测试网水龙头 — faucet-service (NestJS, :3023)
- 每地址每24h: 100 GNX (native transfer) + 10,000 test USDC (MockUSDC.mint)
- Redis SETEX 冷却追踪, ThrottlerModule 10 req/min 全局限流

### 6. 跨链桥监控 — bridge-monitor (Go/Gin, :3024)
- Axelar 桥定期对账 (默认5分钟间隔)
- 偏差 > 0.01% 自动触发紧急暂停 + Webhook 告警 (Slack/PagerDuty)
- Prometheus metrics: TVL, locked/minted, discrepancy, reconciliation count

### 7. 链监控 — chain-monitor (Prometheus + Grafana + AlertManager)
- Prometheus: 抓取 CometBFT(26660) + EVM(6065) + 全部生态服务 + node-exporter
- 14 条告警规则: 共识/EVM/存储/网络/中继器/桥/业务 7 大类
- AlertManager: warning→Slack(4h), critical→PagerDuty(30m)
- Grafana: 12 面板仪表盘 (区块高度/出块时间/验证者/TX吞吐/内存池/中继余额/券铸造/桥TVL等)

### 8. 开发者SDK — 三端覆盖
- **JS SDK** (genex-sdk-js): GenexClient + CouponModule + BlockModule + EventModule(WebSocket自动重连)
- **Go SDK** (genex-sdk-go): ethclient 封装, SubscribeFilterLogs/SubscribeNewHead 事件订阅
- **Dart SDK** (genex-sdk-dart): JsonRpcClient(HTTP+批量) + WebSocketClient(eth_subscribe)
  - 7 模型类, ABI 编码工具, 合约地址配置, GNX 余额格式化

### 9. 归档节点 — archive-node.toml
- pruning = "nothing" 全历史状态保留
- debug/trace API 开启, 8192MB block cache
- snapshot-interval = 1000 供新节点快速同步

### 10. 合约安全CI — GitHub Actions
- contract-security.yml: Foundry Tests + Slither (crytic/slither-action) + Mythril + Blockscout 合约验证
- chain-ci.yml: Go build/test/lint + NestJS matrix build (4服务) + Dart analyze

### 11. Docker Compose 更新
- ecosystem profile 集成: enterprise-api, wallet-service, gas-relayer, faucet, bridge-monitor, archive node
- `docker compose --profile ecosystem up -d` 一键启动全部生态服务

### 端口分配
3020=企业API, 3021=钱包, 3022=Gas中继, 3023=水龙头, 3024=桥监控
4000=Blockscout, 9090=Prometheus, 3030=Grafana, 8600=归档节点EVM

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 18:03:04 -08:00
hailin 02a597c252 docs: 新增08-区块链生态基础设施开发指南 — 链生态完整工具链 
独立于06-区块链开发指南（链内核），本文档覆盖Genex Chain量产运营所需的全部生态基础设施：

1. 区块浏览器（Blockscout）
   - EVM兼容配置、券NFT定制详情页、合规标签系统
   - 发行方档案页、验证节点面板、Gas补贴统计

2. 企业API服务（:3020）
   - 4层认证：公开API Key / 机构mTLS / 监管mTLS+证书 / 内部服务间mTLS
   - 公开端点（区块/交易/券查询）、机构端点（批量导出/WebSocket）、监管端点（地址图谱/Travel Rule/冻结）

3. 三层钱包体系
   - 用户抽象钱包：MPC 2-of-3门限签名，用户无感（手机号=身份）
   - 机构托管钱包：HSM/Fireblocks，多签审批，白名单+限额
   - 治理多签钱包：Gnosis Safe 3/5或4/5，合约升级/冻结/参数调整

4. Gas Relayer（Meta-TX中继器，:3022）
   - EIP-712签名验证、防重放nonce、Relayer热钱包自动补充

5. 链监控运维（Prometheus + Grafana）
   - 14项关键指标：共识/EVM/存储/网络/业务/Relayer/跨链桥
   - AlertManager → PagerDuty / Slack

6. 测试网水龙头（:3023）
7. 开发者SDK（JS/Go/Dart三语言）
8. 归档节点（pruning=nothing，全历史状态）
9. 跨链桥监控（Axelar资产对账，自动暂停）
10. 合约安全CI（Slither + Mythril + 第三方审计）
11. 完整端口分配（3020-3024 + 4000 + 9090）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 17:12:46 -08:00
hailin 9e0152ca0d fix: RegexRouter 精确匹配 outbox 表，防止 heartbeat 事件污染消费者 
问题根因 (rwadurian 生产环境发现):
  - transforms.route.regex=".*" 将所有 CDC 变更事件（包括 heartbeat 表）
    统一路由到 outbox topic，导致消费者收到非 outbox 格式的消息
  - 消费者无法解析 heartbeat 消息 → prisma:error + "Unknown event format" 告警
  - 每 10 秒一次 heartbeat × 5 个 connector = 持续的日志噪音

修复方案:
  - transforms.route.regex 从 ".*" 改为 ".*outbox"
  - 只有匹配 *outbox 的 topic（即真正的 outbox 表变更）才被路由到目标 topic
  - heartbeat/signal 表的变更走默认 topic 命名（无消费者监听，自动过期）
  - heartbeat 仍在 table.include.list 中，确保 Kafka offset 正常推进
    → confirmed_flush_lsn 持续前进 → WAL 不积压

验证 (rwadurian 生产环境):
  - 修复后 mining-admin-service "Unknown event format" 告警清零
  - WAL lag 从 540MB 降至 30-97MB 正常波动
  - 5 个 connector 全部 RUNNING，heartbeat 正常（5s 内更新）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 07:04:17 -08:00
hailin 127f2cdd81 feat: Debezium CDC 安全加固 + WAL 防护 (来自 rwadurian 生产事故经验) 
## 背景
rwadurian 2.0 服务器发生 Debezium CDC 事故:
- DBZ-7316 bug: Debezium ≤2.4 的 searchWalPosition 循环不推进 confirmed_flush_lsn
- PostgreSQL WAL 从正常涨到 306GB, 磁盘占用 23% → 修复后降至 6%
- Kafka Connect REST API 暴露公网, 被注入 3 个恶意 SSRF connector
- pg_logical_emit_message 心跳无效: 写入 WAL 但不经过 publication

## 变更内容

### 1. Debezium 版本锁定 (docker-compose.yml)
- debezium/connect:2.5 → debezium/connect:2.5.4.Final
- 2.5.1 修复 DBZ-7316, 2.5.4 为该系列最终稳定版

### 2. PostgreSQL WAL 安全阀 (docker-compose.yml)
- 新增 max_slot_wal_keep_size=10GB
- 限制单个 replication slot 最多保留 10GB WAL
- 超限后 PostgreSQL 使 slot 失效, 防止磁盘被吃满

### 3. 端口安全加固 (docker-compose.yml)
绑定 127.0.0.1, 禁止公网访问:
- PostgreSQL 5432 (数据库直连)
- Redis 6379 (无密码保护)
- Kafka Connect 8083 (SSRF 注入风险)
- Kafka 29092 (外部访问端口)
- Kong Admin 8001 (路由篡改风险)
- MinIO Console 9001 (默认密码)

### 4. 基础设施可用性 (docker-compose.yml)
- 所有基础设施服务添加 restart: unless-stopped
- Kafka Connect 添加 OFFSET_FLUSH_INTERVAL_MS=10s (默认 60s)

### 5. Debezium 支持表 (040_create_debezium_support.sql)
- debezium_heartbeat: 心跳表, singleton 约束, INSERT...ON CONFLICT DO UPDATE
- debezium_signal: 信号表, 用于增量快照等运维操作
- debezium_outbox_publication: 包含 outbox + heartbeat + signal 三表

### 6. Connector 配置 (scripts/debezium/outbox-connector.json)
- heartbeat TABLE 方式 (非 pg_logical_emit_message)
- publication.autocreate.mode=disabled (使用预建 publication)
- signal.enabled.channels=source,kafka (支持增量快照重放)
- ExtractNewRecordState + RegexRouter transforms

### 7. 部署脚本 (scripts/debezium/register-connectors.sh)
- 等待 Kafka Connect 就绪
- 支持创建和更新 connector
- 验证 connector 状态

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 06:42:03 -08:00
hailin a1293e8445 feat: Genex Chain 区块链完整实现 — cosmos/evm v0.5.1 应用链 + 9合约 + 合规集成 
区块链核心 (blockchain/genex-chain/):
- app.go: 真实 Cosmos SDK BaseApp, 20+ 模块注册 (auth/bank/staking/evm/feemarket/erc20/ibc...)
- genesis.go: EVM/FeeMarket/Mint 创世状态, NoBaseFee=true (Gas补贴)
- compliance_integration.go: ComplianceAnteHandler 桥接到 SDK ante 链
  TX → OFAC/TravelRule/Structuring 拦截 → cosmos/evm AnteHandler → Mempool
- cmd/genexd/: 完整 CLI (init/start/keys/query/tx + EVM JSON-RPC/WS)
- x/evm/ante/: 链级合规拦截 (OFAC + Travel Rule ≥$3k + Structuring 24h检测), 18 tests
- x/evm/keeper/: Gas 费覆盖 (平台补贴 + EIP-1559 预留), 13 tests

智能合约 (blockchain/genex-contracts/):
- 9 合约: CouponFactory, Coupon(ERC-721), Settlement, Redemption,
  Compliance, Treasury, Governance, ExchangeRateOracle, CouponBackedSecurity
- 3 接口: ICoupon, ICompliance, IChainlinkPriceFeed
- Deploy.s.sol: Transparent Proxy 部署 + 角色授权
- 102/102 Foundry tests (含 fuzz + 集成)

链参数: Bech32=genex, Denom=agnx(18d), EVM ChainID=8888, ≤1s出块
部署: Docker 6节点 (3创世+2机构+1监管), docker-compose.yml

修复:
- ComplianceAnteHandler 集成到真实 Cosmos SDK ante handler 链 (§6/§16)
- init-testnet.sh denom 从 ugnx 修正为 agnx + 18位精度金额 (§13)

指南符合性: 06-区块链开发指南.md 21节中17节完全符合, 4节偏差已修复/标注

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-14 23:40:37 -08:00
hailin 0c70a030ea docs: 06-区块链开发指南 v3.0 量产版 — 去除全部MVP/阶段性限制 
变更明细：
- 链设计参数：共识机制从"初期平台运营"改为"平台+合格机构验证节点"
- 节点运营：去掉"未来开放"，直接定义多机构验证节点架构
- CouponFactory：移除Utility-only硬编码限制，开放Utility+Securities双轨制
  - Securities Track增加合格投资者验证+Broker-Dealer合规检查
- 新增第11节"多机构验证节点架构"：
  - 4类节点（创世验证/机构验证/监管观察/全节点）准入条件
  - 生产验证节点CometBFT共识配置（出块≤1s）
  - 部署拓扑（Genex x3 + 机构 x4+ + 监管 x3）
- GNX代币：去掉"待法律意见书后开放"措辞，改为"需合规审批"
  - 代币分配去掉"预留设计"标签
- CBS资产证券化：从Phase 4接口预留升级为完整合约实现
  - createPool（券收益流打包）
  - purchaseShares（合格投资者份额认购）
  - setCreditRating（链下评级机构写入）
  - distributeYield（到期收益按份额分配）
- Gas策略保持不变（前期补贴+未来可通过Governance调整）
- 章节重新编号（11→21共21节）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-14 18:47:55 -08:00
hailin 184a7d16db feat: 三端集成 App升级 + 内部推送 + FCM外部推送框架 (genex-mobile/admin-app/mobile) 
从 rwadurian/frontend/mobile-app 移植升级系统和通知系统到 Genex 三个 Flutter 客户端，
适配目标项目轻量架构（ValueNotifier 替代 Riverpod，Dio HTTP 客户端，移除 screenutil）。

## 新增核心模块 (每个 app 13 个 Dart 文件)

### 升级系统 (core/updater/)
- UpdateService: 统一升级服务单例，支持 Google Play + 自建服务器双渠道
- VersionChecker: 版本检测器，调用 GET /api/app/version/check
- DownloadManager: APK 下载管理，支持断点续传 + SHA256 校验
- ApkInstaller: APK 安装器 (Platform Channel)
- AppMarketDetector: 应用市场来源检测
- SelfHostedUpdater: 自建服务器渠道更新对话框 (i18n 化)
- GooglePlayUpdater: Google Play 应用内更新

### 通知系统 (core/services/ + core/providers/)
- NotificationService: 通知 + 公告 API 服务
  - GET /notifications, /notifications/unread-count
  - PUT /notifications/:id/read
  - GET /announcements, /announcements/unread-count
  - PUT /announcements/:id/read, /announcements/read-all
- NotificationBadgeManager: 未读徽章管理器
  - ValueNotifier<int> 驱动 UI
  - 30秒定时自动刷新 + 前后台切换刷新 (WidgetsBindingObserver)

### FCM 推送框架 (core/push/)
- PushService: Firebase 推送服务框架
  - Firebase 代码注释保护，无配置文件时静默跳过
  - 设备 token 注册 POST /device-tokens
  - 待 Firebase 配置文件就绪后取消注释即可启用

### HTTP 客户端 (core/network/)
- ApiClient: Dio 封装单例，baseUrl = https://api.gogenex.cn

## Android 原生配置 (每个 app)
- AndroidManifest.xml: 添加 REQUEST_INSTALL_PACKAGES 权限 + FileProvider
- res/xml/file_paths.xml: FileProvider 路径配置
- MainActivity.kt: APK 安装器 + 应用市场检测 MethodChannel

## UI 层改造 (每个 app)
- main.dart: 异步启动，初始化 UpdateService/PushService/NotificationBadgeManager
- MainShell: 消息 Tab 徽章改为 ValueListenableBuilder 动态未读数，进入后 3 秒检查更新
- SettingsPage: StatefulWidget 化，动态版本号 (PackageInfo)，点击版本号手动检查更新
- MessagePage: 移除 mock 数据，接入 NotificationService API，4 Tab 分类 + 下拉刷新 + 标记已读

## i18n 新增 (~35 keys/语言)
- update.*: 25 个升级相关 keys
- notification.*: 9 个通知相关 keys
- genex-mobile: 4 语言 (zh_CN/zh_TW/en/ja) 分文件
- admin-app: 3 语言 (zh_CN/en_US/ja_JP) 内联单文件
- mobile: 4 语言 (zh_CN/zh_TW/en/ja) 分文件

## 三端差异化配置
| App | MethodChannel 前缀 | applicationId |
|-----|-------------------|---------------|
| genex-mobile | cn.gogenex.consumer | cn.gogenex.consumer |
| admin-app | cn.gogenex.issuer | cn.gogenex.issuer |
| mobile | cn.gogenex.mobile | cn.gogenex.mobile |

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-13 07:02:14 -08:00
hailin 8adead23b6 feat: 设备推送系统 — FCM/APNs/HMS/小米/OPPO/vivo 多通道推送 + PROMOTION广告类型 
新增设备推送通道架构，支持6大推送平台的多通道路由:

【SQL迁移】
- 039_create_device_tokens.sql: device_tokens表 (userId, platform, channel, token, deviceId等)
- announcements表新增 PROMOTION 类型约束

【Domain层 — 实体/接口/端口】
- DeviceToken实体: DevicePlatform枚举(ANDROID/IOS) + PushChannel枚举(FCM/APNS/HMS/XIAOMI/OPPO/VIVO)
- IDeviceTokenRepository: 6个仓储方法 (findActive/upsert/deactivate/countByChannel)
- IPushChannelProvider端口: PushPayload/PushResult类型 + 6个DI Symbol
- AnnouncementType枚举: 新增 PROMOTION (广告/促销推送)

【Infrastructure层 — 持久化/推送通道】
- DeviceTokenRepositoryImpl: TypeORM实现，支持批量IN查询(每批500)、token upsert
- 6个推送通道Provider (mock骨架，结构完整可直接替换为真实SDK):
  · FcmPushProvider — Google FCM (firebase-admin)
  · ApnsPushProvider — Apple APNs (HTTP/2直连，中国区必需)
  · HmsPushProvider — 华为HMS Push Kit
  · XiaomiPushProvider — 小米Mi Push
  · OppoPushProvider — OPPO Push
  · VivoPushProvider — vivo Push
- PushNotificationProvider重构: 从mock改为委托PushDispatcherService

【Application层 — 服务】
- PushDispatcherService: 核心调度器
  · sendToUser/sendToUsers → 查device tokens → 按channel分组 → 路由到对应provider
  · 自动清理无效token (shouldDeactivateToken)
- DeviceTokenService: 设备token注册/注销/查询
- AnnouncementService: 公告创建后自动触发设备推送
  · BY_TAG → 解析tag对应userIds → pushDispatcher.sendToUsers
  · SPECIFIC → 直接推送指定userIds

【Interface层 — DTO/Controller】
- RegisterDeviceTokenDto/UnregisterDeviceTokenDto: Swagger + class-validator
- DeviceTokenController: POST/DELETE/GET /device-tokens (JWT认证)

【Module注册】
- notification.module.ts: 新增DeviceToken实体、DEVICE_TOKEN_REPOSITORY、
  6个push channel provider DI绑定、PushDispatcherService、DeviceTokenService、
  DeviceTokenController

推送链路: 公告创建 → triggerPush → PushDispatcher → 查token → 按channel分组 → FCM/APNs/HMS/小米/OPPO/vivo

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-12 23:48:52 -08:00
hailin acaec56849 feat: 全12服务DDD重构 + 公告定向推送系统 (移植自rwadurian) 
## 一、DDD + Clean Architecture 重构 (全12服务)

对全部12个微服务(9 NestJS + 3 Go)实施严格的DDD分层:

### NestJS 服务 (9个):
- auth-service: JWT策略已在domain层
- user-service: 新增 5 个 repository interface + implementation,
  5 个 value objects (Email/Phone/KycLevel/Money), 3 组 domain events
- issuer-service: 新增 5 个 repository interface + implementation,
  3 个 value objects, 2 组 domain events, external AI client port
- clearing-service: 新增 5 个 repository interface + implementation,
  2 个 value objects, domain events
- compliance-service: 新增 7 个 repository interface + implementation,
  2 个 value objects, domain events, audit logger service
- ai-service: 新增 conversation repository + TypeORM entity,
  AI agent client port 移至 domain/ports/
- notification-service: 新增 notification repository interface +
  implementation, channel providers, value objects
- telemetry-service: 新增 3 个 repository interface + implementation
- admin-service: 新增 app-version repository interface + implementation

### Go 服务 (3个):
- trading-service: 重构为 domain/application/infrastructure 分层,
  新增 repository interface + postgres 实现, matching engine 移入
  application/service, 新增 value objects (Price/Quantity/OrderSide/OrderType),
  Kafka event publisher
- translate-service: 新增 repository interface + postgres 实现,
  value objects (Address/ChainType)
- chain-indexer: 新增 repository interface + postgres 实现,
  value objects (BlockHeight/TxHash), Kafka event publisher

### 关键模式:
- NestJS: Symbol token DI (provide: Symbol → useClass: Impl)
- Go: compile-time interface check (var _ Interface = (*Impl)(nil))
- TypeORM entity 保留 domain methods (pragmatic DDD)
- Repository interface 在 domain/, 实现在 infrastructure/persistence/

## 二、公告定向推送系统 (ported from rwadurian)

在 notification-service 中新增 Announcement 公告体系,
支持管理端向全体/标签/指定用户推送消息:

### 数据库:
- 038_create_announcements.sql: 5张新表
  - announcements (公告主表)
  - announcement_tag_targets (标签定向)
  - announcement_user_targets (用户定向)
  - announcement_reads (已读记录)
  - user_tags (用户标签)

### 三种定向模式:
- ALL: 推送给全体用户
- BY_TAG: 按标签筛选用户 (用户标签与公告标签有交集)
- SPECIFIC: 指定用户ID列表

### 新增文件 (15个):
- 5 个 TypeORM entity (Announcement + Read + TagTarget + UserTarget + UserTag)
- 2 个 repository interface (IAnnouncementRepository 11方法, IUserTagRepository 6方法)
- 2 个 repository 实现 (TypeORM QueryBuilder, targeting filter SQL)
- 2 个 application service (AnnouncementService, UserTagService)
- 2 个 DTO 文件 (announcement.dto.ts, user-tag.dto.ts)
- 1 个 controller 文件 (含3个controller: AdminAnnouncement/AdminUserTag/UserAnnouncement)
- 1 个 migration SQL

### API 端点:
管理端:
  POST   /admin/announcements       创建公告(含定向配置)
  GET    /admin/announcements       公告列表
  GET    /admin/announcements/:id   公告详情
  PUT    /admin/announcements/:id   更新公告
  DELETE /admin/announcements/:id   删除公告
  GET    /admin/user-tags           所有标签(含用户数)
  POST   /admin/user-tags/:userId   添加用户标签
  DELETE /admin/user-tags/:userId   移除用户标签
  PUT    /admin/user-tags/:userId/sync  同步用户标签

用户端:
  GET    /announcements             用户公告(按定向过滤+已读状态)
  GET    /announcements/unread-count  未读数
  PUT    /announcements/:id/read    标记已读
  PUT    /announcements/read-all    全部已读

### 设计决策:
- Announcement 与现有 Notification 并存 (双轨):
  Notification = 事件驱动1:1通知, Announcement = 管理端广播/定向
- rwadurian accountSequences → gcx userIds (UUID)
- rwadurian Prisma → gcx TypeORM

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-12 21:11:24 -08:00
hailin 66781d47b3 chore: 提交 user-service package-lock.json 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-12 18:35:03 -08:00
hailin e20c321d12 refactor: 遥测与版本管理拆分为独立微服务 (telemetry-service + admin-service) 
架构重构: 将遥测(Telemetry)和版本管理(App Version)从 user-service 拆分为两个独立微服务，
严格遵循 DDD + Clean Architecture 四层架构。

新增服务:
- telemetry-service (:3011) — 用户心跳检测、事件采集、DAU统计、Prometheus指标
  - domain: 3实体 + 3值对象(EventName/InstallId/TimeWindow) + 2领域事件
  - infrastructure: Redis(Sorted Set心跳) + Kafka(事件发布) + Prometheus(5指标)
  - 定时任务: 每分钟在线快照、每小时清理过期、凌晨DAU精确计算、滚动DAU更新
- admin-service (:3012) — APK/IPA版本管理、OTA更新、MinIO文件存储
  - domain: 1实体 + 4值对象(VersionCode/VersionName/FileSha256/DownloadUrl)
  - infrastructure: MinIO(文件上传/下载) + APK/IPA解析器
  - 移动端: 检查更新API(无认证) + 下载重定向(预签名URL)
  - 管理端: 版本CRUD + 上传解析 + 启禁用

user-service 清理:
- 删除24个已迁移文件(4实体+4服务+4基础设施+5控制器+6DTO+1gitkeep)
- 移除不再需要的依赖: @nestjs/schedule, minio, prom-client, kafkajs
- 精简 user.module.ts，仅保留用户核心功能(Profile/KYC/Wallet/Message/Admin)

基础设施更新:
- Kong: 遥测路由 → telemetry-service:3011, 版本路由 → admin-service:3012
- docker-compose: 新增2个服务容器 + MinIO app-releases bucket
- 07开发指南: 更新为独立服务架构描述

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-12 18:30:39 -08:00
hailin 4da8a373f2 refactor: 全项目清除MVP字样，统一为正式系统用语 
## 变更范围：21个文件，覆盖全栈

### SRS需求文档 (4个文件，20处修改)

docs/券金融平台-软件需求规格.md (7处):
- "MVP策略" → "运营策略"/"合规策略"
- "MVP阶段GNX不上交易所" → "Phase 1阶段GNX不上交易所"
- "MVP同步" → "同步发布"
- "MVP阶段优先级" → "阶段优先级"
- "Phase 1（MVP）" → "Phase 1（基础平台）"
- "基础发行与交易（MVP，仅Utility Track）" → "基础发行与交易（仅Utility Track）"

docs/券金融平台-需求规格综合评估报告.md (4处):
- "MVP分期" → "阶段分期"
- "MVP回避策略" → "合规回避策略"
- "MVP仅Utility Track" → "Phase 1仅Utility Track"

docs/闲券交易平台-架构开发需求.md (4处):
- "MVP阶段只开放" → "当前阶段只开放"
- "Phase 1（MVP）" → "Phase 1（基础平台）"
- "基础平台（MVP，仅Utility Track）" → "基础平台（仅Utility Track）"

docs/闲券平台-软件开发需求.md (5处):
- "MVP阶段用户不接触" → "当前阶段用户不接触"
- "MVP策略" → "运营策略"
- "Phase 1（MVP）" → "Phase 1（基础平台）"
- "Phase 1 — MVP" → "Phase 1 — 基础平台"

### 后端服务代码 (7个文件，13处修改)

trading-service (Go):
- admin_trade_handler.go: 3处 "for MVP"/"In MVP" 注释清除
- admin_mm_handler.go: 2处 "In MVP"/"for MVP" 注释清除

chain-indexer (Go):
- admin_chain_handler.go: 1处 "for MVP" 注释清除

compliance-service (NestJS):
- admin-compliance.service.ts: 3处 "(mock for MVP)" 注释清除

issuer-service (NestJS):
- admin-issuer.service.ts: 1处 "For MVP" 注释清除
- admin-merchant.service.ts: 2处 "For MVP" 注释清除

notification-service (NestJS):
- event-consumer.service.ts: 1处 "In MVP" 注释清除

### 前端代码 (10个文件)

mobile (5个文件):
- i18n: en/zh_cn/zh_tw/ja 4语言 "MVP版本仅支持" → "当前仅支持"
- i18n key: proMode.mvpNote → proMode.trackNote
- pro_mode_page.dart: 更新key引用

genex-mobile (5个文件):
- 同mobile，4语言+1页面引用全部更新

### 验证结果
全项目grep (?i)\bMVP\b = 0 matches，彻底清除完毕

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-12 18:13:47 -08:00
hailin 0bf1df0f7a feat: 补全遥测/版本管理完整功能 + 清除全部开发指南中的MVP字样 
## 功能补全 (12个新文件 + 6个修改)

DTO验证类 (6):
- batch-events.dto.ts — 批量事件上报验证(ArrayMaxSize 500, ValidateNested)
- heartbeat.dto.ts — 心跳上报验证(installId, appVersion)
- query-dau.dto.ts — DAU查询+事件查询验证(IsDateString, 分页)
- check-update.dto.ts — 检查更新验证(platform IsIn, version_code IsInt)
- create-version.dto.ts — 创建/更新版本验证(CreateVersionDto + UpdateVersionDto)
- upload-version.dto.ts — 上传版本验证(multipart/form-data字段)

基础设施 (3):
- package-parser.service.ts — APK解析(adbkit-apkreader) + IPA解析(unzipper+bplist-parser)
- telemetry-producer.service.ts — Kafka事件发布(telemetry.session.started + telemetry.heartbeat)
- telemetry-metrics.service.ts — Prometheus 5指标(online_users/dau/heartbeat_total/events_total/batch_duration)

控制器 (1):
- metrics.controller.ts — GET /metrics 端点(Prometheus格式)

功能增强:
- admin-version.controller.ts — 新增POST /parse解析预览端点 + upload自动解析填充元数据
- app-version.controller.ts — 新增GET /download/:id下载端点(302重定向MinIO)
- telemetry.service.ts — 集成Prometheus计数器+直方图 + Kafka事件发布
- telemetry-scheduler.service.ts — 快照/DAU时更新Prometheus指标
- user.module.ts — 注册MetricsController + TelemetryMetricsService + TelemetryProducerService + PackageParserService
- package.json — 新增prom-client依赖

## 开发指南MVP清除 (4个文件)

- 00-UI设计需求.md — "MVP阶段" → "当前阶段"
- 05-后端开发指南.md — "Phase 1 (MVP)" → "Phase 1 (基础平台)"
- 06-区块链开发指南.md — 清除所有MVP引用(合约注释/代币用途/Gas模型/预留接口)
- 07-遥测与版本管理开发指南.md — 清除MVP理由, 删除"可选"标记

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-12 18:09:10 -08:00
hailin 5a66b3071f feat: 新增用户遥测(Telemetry)与移动端OTA版本管理功能 
## 遥测系统 (Telemetry)
- 心跳检测: 客户端60s上报心跳，Redis Sorted Set实时计算在线用户数(180s窗口)
- 事件采集: 批量上报客户端事件(会话/页面/操作)，写入PostgreSQL telemetry_events表
- DAU统计: 基于app_session_start事件按userId/installId去重
  - 实时近似: Redis HyperLogLog (PFADD/PFCOUNT)
  - 精确计算: 每天凌晨1:00从事件表聚合，支持平台/地区维度
- 在线快照: 每分钟记录在线用户数快照，支持1m/5m/1h区间聚合查询
- 定时任务: @nestjs/schedule驱动 (每分钟快照/每小时清理/凌晨DAU/滚动DAU)

## 版本管理 (App Version / OTA Update)
- 版本CRUD: 管理员创建/编辑/删除/启禁用版本记录
- 文件上传: APK/IPA上传至MinIO(app-releases bucket)，自动计算SHA256
- 强制更新: isForceUpdate标志，客户端据此决定是否阻断使用
- 检查更新API: GET /app/version/check?platform=android&current_version_code=200
- 预签名下载: MinIO presigned URL (24h有效)

## 新增文件清单 (18个新文件 + 3个修改)

数据库迁移 (4):
- 032_create_telemetry_events.sql — 事件日志表(append-only, BIGSERIAL)
- 033_create_daily_active_stats.sql — DAU日统计表(day PK, JSONB平台/地区)
- 034_create_online_snapshots.sql — 在线快照表(每分钟记录)
- 035_create_app_versions.sql — 应用版本表(platform CHECK, 唯一索引)

TypeORM实体 (4):
- telemetry-event.entity.ts — 遥测事件(userId, installId, eventName, properties)
- online-snapshot.entity.ts — 在线快照(ts, onlineCount, windowSeconds)
- daily-active-stats.entity.ts — DAU统计(day PK, dauByPlatform/Region JSONB)
- app-version.entity.ts — 应用版本(Platform enum, @VersionColumn乐观锁)

Redis基础设施 (1):
- presence-redis.service.ts — ZADD心跳 + ZCOUNT在线 + PFADD/PFCOUNT DAU

业务服务 (4):
- telemetry.service.ts — 批量事件入库 + 心跳记录 + 在线/DAU查询
- telemetry-scheduler.service.ts — 4个Cron定时任务
- app-version.service.ts — checkUpdate + CRUD + toggle + 重复检测
- file-storage.service.ts — MinIO上传(SHA256) + presigned下载URL

HTTP控制器 (4):
- telemetry.controller.ts — POST events(无需认证) + POST heartbeat + GET online
- admin-telemetry.controller.ts — GET /admin/telemetry/dau|events|realtime
- app-version.controller.ts — GET /app/version/check (移动端)
- admin-version.controller.ts — 完整CRUD + multipart上传 + toggle启禁用

修改文件 (3):
- user.module.ts — 注册4实体+4控制器+5服务+ScheduleModule
- package.json — 新增@nestjs/schedule, minio, @types/multer
- kong.yml — 新增4条Kong路由(telemetry, admin/telemetry, app/version, admin/versions)

文档 (1):
- docs/guides/07-遥测与版本管理开发指南.md — 完整开发指导(参考rwadurian适配)

注: admin遥测路径为/admin/telemetry，避免与issuer-service的/admin/analytics冲突

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-12 17:53:50 -08:00
hailin ad93bc728f feat: 完成全部后端微服务开发 (10服务/373文件/15586行代码) 
## 架构概览
- 10个微服务: 7 NestJS + 3 Go/Gin
- DDD + Clean Architecture (Domain/Application/Infrastructure/Interface 四层)
- Kong API Gateway (8080) 统一入口
- PostgreSQL + Redis + Kafka(KRaft) + MinIO 基础设施

## 微服务清单
| 服务 | 技术 | 端口 | 职责 |
|------|------|------|------|
| auth-service | NestJS | 3010 | JWT双Token认证(15min+7d)、注册/登录/刷新/登出 |
| user-service | NestJS | 3001 | 用户Profile、KYC审核、钱包(充值/提现)、消息 |
| issuer-service | NestJS | 3002 | 发行方入驻、券CRUD/搜索/购买、定价引擎、信用评分 |
| trading-service | Go/Gin | 3003 | 撮合引擎(价格-时间优先)、订单簿、做市商API |
| clearing-service | NestJS | 3004 | 交易结算、退款、Breakage、ASC 606会计分录 |
| compliance-service | NestJS | 3005 | AML(5模式)、OFAC筛查、Travel Rule、SAR报告 |
| ai-service | NestJS | 3006 | ACL反腐败层→外部AI Agent集群(含本地降级) |
| translate-service | Go/Gin | 3007 | 区块链地址映射翻译 |
| notification-service | NestJS | 3008 | 推送/短信/邮件/站内通知、事件消费 |
| chain-indexer | Go/Gin | 3009 | 区块链索引器(Mock) |

## Admin API (18个管理模块)
覆盖admin-web全部18+页面:
Dashboard、用户管理、系统管理、用户分析、发行方管理、券管理、
券分析、商户核销、交易监控、做市商管理、财务管理、报表中心、
风控中心、合规审计、争议处理、保险理赔、AI Agent面板、通知管理

## 数据库
- 31个SQL迁移 (000-031) + 种子数据
- 乐观锁(@VersionColumn) + 悲观锁(SELECT FOR UPDATE) + Redis分布式锁
- Outbox Pattern保证消息可靠投递 + 24h幂等窗口

## 共享包
- @genex/common: Guards/Decorators/DTOs/Outbox/Health/Locking/AI-Client
- @genex/kafka-client: 生产者/消费者/Topic定义/KRaft集群支持

## 部署与测试
- docker-compose.yml: 全栈一键启动
- Swagger文档: 7个NestJS服务 /docs 端点
- E2E测试脚本: scripts/run-e2e.sh (Auth→Profile→Wallet→Trading→Admin)
- 迁移脚本: scripts/migrate.sh + scripts/test-setup.sh

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-12 17:09:12 -08:00
hailin c58b2df728 feat: 小程序功能移植，新增12页面+160 i18n keys，覆盖率提升至~70% 
新增页面：search, purchase(重写), payment-success, my-coupon-detail,
transfer, ai-chat, orders(重写), messages, wallet(只读), settings, kyc
增强：detail页新增附近门店和相似好券模块
导航：首页搜索→search, 券卡→detail→purchase, 我的券→my-coupon-detail,
个人中心菜单→wallet/messages/ai-chat/settings/kyc

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-12 04:16:33 -08:00
hailin 3cdb6a5eb9 feat: 全部前端项目完成国际化(i18n)，支持中/英/日三语言 
- miniapp (Taro/React): 11个页面/组件，~300翻译键
- admin-app (Flutter): 19个页面，475翻译键 (zh_CN/en_US/ja_JP)
- admin-web (Next.js): 25个视图+布局，2000+翻译键
- mobile (Flutter): 33+页面/组件，686翻译键 (zh_CN/zh_TW/en/ja)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-12 03:45:37 -08:00
hailin 5bc1cbe4d8 feat: 完成全量国际化(i18n)，支持简中/繁中/英文/日文四语言 
## 概述
实现 Genex Mobile 全量国际化支持，覆盖全部 UI 字符串。
支持语言：简体中文(zh_CN)、繁体中文(zh_TW)、英文(en)、日文(ja)。
共计 720+ 翻译键值对，涉及 51 个文件。

## 新增文件
- lib/app/i18n/strings/zh_cn.dart — 简体中文翻译（基础语言）
- lib/app/i18n/strings/zh_tw.dart — 繁体中文翻译
- lib/app/i18n/strings/en.dart — 英文翻译
- lib/app/i18n/strings/ja.dart — 日文翻译
- lib/app/i18n/locale_manager.dart — 全局语言/货币状态管理器

## i18n 基础架构
- AppLocalizations: 基于 Map<String, String> 的翻译查找
- AppLocalizationsDelegate: Flutter 本地化委托集成
- context.t('key') 扩展方法：便捷取用翻译文本
- 回退链：缺失 key → zh_CN → key 本身
- LocaleManager: ValueNotifier<Locale?> 响应式语言切换
- 货币绑定：根据 locale 自动匹配货币符号(CNY/TWD/USD/JPY)

## 页面级国际化（46 个文件）
### 认证模块 (auth)
- welcome_page, login_page, register_page, forgot_password_page

### 券模块 (coupons)
- home_page, market_page, search_page, coupon_detail_page
- my_coupons_page, my_coupon_detail_page, wallet_coupons_page
- order_confirm_page, payment_page, payment_success_page
- redeem_qr_page, receive_coupon_sheet

### 交易模块 (trading)
- trading_page, trading_detail_page, sell_order_page, transfer_page

### 钱包模块 (wallet)
- wallet_page, deposit_page, withdraw_page, transaction_records_page

### 用户模块 (profile)
- profile_page, settings_page, kyc_page
- payment_management_page, pro_mode_page

### 消息模块 (message)
- message_page, message_detail_page

### 商户模块 (merchant)
- merchant_home_page, merchant_ai_assistant_page

### 发行方模块 (issuer)
- issuer_main_page

### AI 模块 (ai_agent)
- agent_chat_page, ai_fab

### 公共组件 (shared/widgets)
- coupon_card, price_tag, status_tag, empty_state
- ai_confirm_dialog, kyc_badge

### 应用层 (app)
- main.dart (本地化委托/Locale解析配置)
- main_shell.dart, app_localizations.dart, pubspec.yaml

## 技术处理
- Widget getter → method(BuildContext): 需要 context 的属性转为方法
- const 默认参数 → nullable: 无法在 const 中使用 context.t()，改为可空参数在 build() 中解析
- Mock 数据保留中文：示例/演示数据将来自 API，无需国际化
- 语言选择器原生显示：中文/English/日本語 等按各语言原生名称展示

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-12 00:16:00 -08:00
hailin b639e8c823 feat: 设置页面新增货币选择器和语言选择器 
- 设置页面从StatelessWidget改为StatefulWidget
- 新增货币选择器bottom sheet，支持USD/CNY/EUR/GBP/JPY/HKD
- 新增语言选择器bottom sheet，支持简体中文/繁體中文/English/日本語
- 通知开关改为可交互状态
- 货币subtitle动态显示已选货币代码和符号

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 21:18:11 -08:00
hailin 003b571f94 refactor: 交易页面改为券+行业分类模式，移除交易对tabs 
- market_page: 移除券/法币/数字货币/稳定币tabs，改为行业分类过滤(餐饮/购物/娱乐/出行/生活/运动)
- market_page: 新增排序栏(折扣率/价格/到期时间)，二级市场改为券名+品牌+行业标签展示
- trading_detail_page: 移除SBUX/USDT交易对概念，改为券信息卡片+配置货币符号
- trading_detail_page: 新增券信息卡片(品牌/行业/信用评级/面值/到期)，价格显示折扣率
- 计价货币由用户在"我的→设置"中配置，默认跟随语言

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 20:55:24 -08:00
hailin d9c953149b refactor: 重写转赠页面为混合方案 
- 顶部两个并排入口卡片：扫码转赠 / 输入ID(邮箱/手机/接收ID)
- 最近转赠人列表：显示联系方式类型标签、脱敏联系方式、上次转赠时间
- 联系方式有效期机制：90天过期后灰显，点击提示重新验证
- 底部sheet选券流程：选方式 → 选券 → 确认转赠 → 成功
- 转赠记录摘要：显示最近转出/转入记录
- 移除旧的好友列表设计，改为地址式转赠（类似加密钱包）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 19:13:01 -08:00
hailin 8bbd56a86c refactor: 我的钱包 → 持仓，统一交易所语境 
- 首页卡片: "我的钱包" → "持仓"
- 完整页面标题: "我的钱包" → "我的持仓"
- 图标: account_balance_wallet → inventory_2 (仓位/库存)
- 更新注释和 main.dart 描述

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 18:58:47 -08:00
hailin b9f36176ed fix: 修复 wallet_coupons_page 缺少 CouponStatus 导入和错误引用 
- 添加 coupon_card.dart 导入以获取 CouponStatus 枚举
- AppTypography.display → AppTypography.displayLarge
- AppColors.couponFood → AppColors.couponDining

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 18:43:37 -08:00
hailin b1a0f29f06 refactor: 轻量化首页钱包卡片，新增完整钱包页面 
- 首页钱包区域从重量级(stats+filter+coupon cards+actions)
  精简为轻量卡片(汇总信息+4个快捷入口)，点击进入完整钱包页
- 新增 wallet_coupons_page.dart：融合"我的券"全部功能
  (汇总面板+4-Tab筛选+券列表+转赠/出售快捷操作+接收券)
- 分类网格从6项(3列)扩展为8项(4列x2行)：
  限时抢购/新券首发/折扣排行/即将到期/比价/转让市场/热门交易/全部
- HomePage 从 StatefulWidget 简化为 StatelessWidget
- main.dart 新增 /wallet/coupons 路由

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 18:39:22 -08:00
hailin b63414542b feat: Create genex-mobile app with coupon lifecycle management redesign 
基于 frontend/mobile 创建全新的 genex-mobile 应用，重新设计为券的生命周期管理平台。

## 底部导航重构 (5 tabs → 4 tabs)
- 首页 / 交易 / 消息 / 我的
- 移除独立的"我的券"Tab，功能合并到首页券钱包中
- "市场"重命名为"交易"，图标改为行情图标

## 首页改造
### 券钱包（替代原Banner轮播区域）
- 紫色渐变卡片展示"我的钱包"，含券数量统计（可使用/待核销/已过期）
- 水平滚动的券迷你卡片列表，支持Tab筛选（全部/可使用/待核销/已过期）
- 快捷操作栏：接收 / 转赠 / 出售 / 核销
- 接收功能：点击弹出底部Sheet，展示接收ID和接收二维码
  - 对方可通过扫码或输入ID转赠券到钱包
  - 接收ID支持一键复制

### 分类网格重新设计（从商品品类改为省钱机制）
- 原8个商品分类（餐饮/购物/娱乐/出行/生活/品牌/折扣/全部）
- 改为6个省钱导向分类：限时抢购 / 新券首发 / 折扣排行 / 即将到期 / 比价 / 全部分类
- 3列×2行布局，每个入口强调"怎么省"而非"卖什么"

### 其他区域保持不变
- AI智能推荐卡片
- 精选好券列表
- AI FAB浮动按钮

## 交易页（币安交易所风格）
### 一级市场（打新申购 / Launchpad风格）
- 券发行卡片：品牌信息 / 发行价 / 面值 / 折扣 / 发行量
- 销售进度条和百分比
- 状态标签：即将开始（含倒计时）/ 申购中 / 已结束

### 二级市场（交易所行情列表）
- 交易对分类Tab：券/法币 | 券/数字货币 | 券/稳定币 | 收藏
- 行情列表：交易对名称 / 最新价格 / 24h涨跌幅（红绿色块）
- 成交量和USD等价显示
- 支持的交易对示例：SBUX/USD, NIKE/BTC, AMZN/USDT 等

### 交易对详情页（K线 + 盘口 + 下单）
- 价格头部：当前价 / 24h涨跌 / OHLC数据（高/低/开盘/成交量）
- K线图（含模拟蜡烛图渲染 + 成交量柱状图）
- 时间周期选择器：1m / 5m / 15m / 1h / 4h / 1D / 1W
- 交易深度：买卖盘口（Bid/Ask）带深度条可视化
- 下单表单：买入/卖出切换 / 限价单/市价单 / 价格数量输入 / 比例快选（25%/50%/75%/100%）
- 当前委托和历史委托列表
- 底部买入/卖出快捷按钮

## 券详情页增强
- 新增"附近可用门店"区域（LBS定位功能入口）
- 展示附近门店列表：门店名 / 距离 / 营业状态

## 技术细节
- 保持原有设计系统：紫色主色调 #6C5CE7 / Material 3 / 亮色模式
- Flutter analyze 零错误通过
- 所有新增页面使用 mock 数据，便于后续接入真实API

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 17:57:16 -08:00
hailin 0ca11bddb1 chore: Ignore Claude Code config and Flutter auto-generated files 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 07:28:02 -08:00
hailin 87d54be200 fix: Remove infinite minimumSize from ElevatedButton/OutlinedButton theme 
The theme set minimumSize: Size(double.infinity, 52) which creates
an internal ConstrainedBox(w=Infinity) inside every button. This
crashes when any button is placed in unbounded width context (Row).
Changed to Size(0, 52) — GenexButton's LayoutBuilder handles width.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 07:15:20 -08:00
hailin 665e494b4a fix: Prevent GenexButton crash with unbounded width constraints 
Use LayoutBuilder to detect whether parent provides bounded width.
When fullWidth=true in an unbounded context (e.g. Row without
Expanded), gracefully fall back to content-sized width instead of
forcing SizedBox(width: double.infinity) which triggers
"BoxConstraints forces an infinite width" assertion.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 07:08:09 -08:00
hailin 5abb614d03 feat: Wire all navigation callbacks across mobile and admin-app 
Replace empty onPressed/onTap placeholder callbacks with actual
Navigator route calls so all pages are navigable during testing.

Mobile (16 pages):
- Auth flow: welcome → login/register → main shell, forgot password
- Home: search bar → /search, coupon cards → /coupon/detail, AI FAB → /ai-chat
- Market: coupon cards → /coupon/detail
- Coupon detail: buy → /order/confirm
- Order confirm: payment auth → /payment
- Payment: confirm → /payment/success (fixed route typo)
- Payment success: buttons → /main (clear stack)
- My coupons: cards → /coupon/mine/detail
- My coupon detail: transfer → /transfer, sell → /sell
- Search: result cards → /coupon/detail
- Profile: KYC → /kyc, payment → /payment/manage, wallet → /wallet,
  trading → /trading, pro mode → /pro-mode, settings → /settings,
  logout → / (clear stack)
- Settings: KYC → /kyc, logout → / (clear stack)
- Wallet: deposit → /wallet/deposit, withdraw → /wallet/withdraw,
  records → /wallet/records
- Messages: items → /message/detail

Admin-app (13 pages):
- Dashboard: AI insight → createCoupon, credit suggestion → credit
- Coupon list: coupon cards → couponDetail, FAB → createCoupon
- Create coupon: save draft → pop back
- Settings: store mgmt, employee mgmt → storeManagement,
  AI assistant → aiAgent, tier upgrade → credit, logout → login
- Financing analysis: AI recommendation → aiAgent
- Onboarding: complete → main shell
- Login: register link → onboarding
- Fix: pass BuildContext to _buildTierCard in settings_page.dart

Both apps verified building successfully (flutter build apk --debug).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 06:54:22 -08:00
hailin 5f3e660b05 feat: Add Flutter build configuration for admin-app and mobile 
- Initialize Android/iOS platform code for both Flutter apps
  - admin-app: cn.gogenex.issuer (Genex发行方)
  - mobile: cn.gogenex.consumer (Genex消费者端)
- Configure Android build.gradle.kts with:
  - Release signing config (keystore + key.properties)
  - Debug build type with .debug applicationId suffix
  - Release build type with ProGuard minification
  - minSdk 21, targetSdk from Flutter
- Fix Flutter 3.38 API compatibility:
  - CardTheme → CardThemeData
  - TabBarTheme → TabBarThemeData
  - DialogTheme → DialogThemeData
- Implement missing ForgotPasswordPage for mobile
- Create cross-platform build scripts (build.sh + build.bat)
  - Supports: debug/release/clean/run modes
  - Supports: apk/appbundle/ios platforms
  - Unified build-output/ directory for APK artifacts
- All 4 builds verified: debug + release × 2 apps

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 06:22:13 -08:00
hailin d49200e876 feat: Wire all view components to Next.js App Router routes 
- Create (admin) route group with AdminLayout wrapper
- Add page.tsx route files for all 25 view pages (dashboard, issuers,
  users, trading, risk, compliance, system, disputes, coupons, finance,
  chain, reports, merchant, agent, insurance, analytics sub-pages,
  compliance sub-pages)
- Update AdminLayout to use Next.js usePathname/useRouter for real
  URL-based navigation instead of internal state
- Add 'use client' directive to view components using useState hooks
- Fix 404 on /dashboard by creating proper App Router route structure

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 05:37:28 -08:00
hailin 9ce42ed5ac chore: Switch domain from admin.gogenex.com to admin.gogenex.cn 
使用国内 .cn 域名用于 ICP 备案，支持国内 IP 直连加速。
国际域名 gogenex.com 保留在 Namecheap 不受影响。

变更:
- deploy.sh: 默认域名/邮箱改为 admin.gogenex.cn
- nginx 配置: 重命名为 admin.gogenex.cn.conf，替换所有域名引用
- DEPLOY.md: 更新所有域名引用

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 05:18:22 -08:00
hailin a2a42ebf23 docs: Add deployment guide for admin-web (DEPLOY.md) 
完整的部署文档，涵盖:
- 环境要求与项目结构
- 3 步快速部署流程
- deploy.sh 全部命令参考 (Docker + Nginx + SSL)
- 自定义域名部署说明
- Docker 三阶段构建说明
- SSL 证书管理 (自动续期、手动续期、强制重申)
- Nginx HTTPS 配置特性说明
- 常见问题排查 (端口占用、构建失败、SSL 失败、日志查看)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 02:00:40 -08:00
hailin 51f4c60fe5 feat: Add Nginx + Let's Encrypt SSL support to admin-web deploy.sh 
deploy.sh 新增 nginx 子命令，支持一键安装 Nginx 反向代理和
Let's Encrypt SSL 证书，参考 rwadurian api-gateway 的实现模式。

新增命令:
  - nginx install [domain] [email]: 完整安装流程 (5步)
    1. 自动安装 nginx + certbot 依赖
    2. 部署 HTTP 临时配置 (含 ACME 验证路径)
    3. certbot webroot 方式申请 SSL 证书
    4. 部署 HTTPS 完整配置 (从 nginx/ 目录读取)
    5. 配置证书自动续期钩子 (renew hook)
  - nginx ssl [domain] [email]: 仅申请/续期证书
  - nginx status: 查看 Nginx 服务和证书状态
  - nginx reload: 重载 Nginx 配置

新增文件:
  - nginx/admin.gogenex.com.conf: HTTPS 配置模板
    含 HTTP→HTTPS 重定向、TLS 1.2/1.3、HSTS、Gzip、
    安全头、Next.js 静态资源长缓存、反向代理到 :3000

默认域名: admin.gogenex.com
默认邮箱: admin@gogenex.com

使用方式:
  1. ./deploy.sh start              # 先启动 Docker 容器
  2. sudo ./deploy.sh nginx install # 安装 Nginx + SSL
  3. 访问 https://admin.gogenex.com

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 01:58:07 -08:00
hailin 29958602db fix: Move src/pages/ to src/views/ to avoid Next.js Pages Router conflict 
Next.js treats `src/pages/` as the Pages Router and requires every file
to have a default export. Our page components use named exports
(e.g. `export const DashboardPage`) since they are UI view components,
not Next.js route handlers.

Rename to `src/views/` so Next.js only uses the App Router (`src/app/`).
The App Router page.tsx files will import from `@/views/` as needed.

24 files moved: src/pages/**/*.tsx → src/views/**/*.tsx

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 01:48:23 -08:00
hailin b2c81090f8 fix: Resolve TypeScript strict-mode error in IpoReadinessPage 
The milestones array only had 'progress' and 'pending' status values,
causing TS to infer the status type as 'progress' | 'pending'. The
template code then compared m.status === 'done' which TS flagged as
unreachable. Fix by explicitly typing the array to include all three
possible status values: 'done' | 'progress' | 'pending'.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 01:46:24 -08:00
hailin 79689c5f95 fix: Make Dockerfile tolerant of missing package-lock.json 
The initial project has no node_modules or package-lock.json yet.
Use wildcard COPY for lock file and fallback to `npm install`
when lock file doesn't exist. Once lock file is generated and
committed, it will automatically use the faster `npm ci`.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 01:39:14 -08:00