104 Commits
| Author | SHA1 | Message | Date |
|---|---|---|---|
 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> |
|
|
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> |
|
|
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¤t_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> |
|
|
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> |