hailin
0bf1df0f7a
## 功能补全 (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> |
||
|---|---|---|
| backend | ||
| docs | ||
| frontend | ||
| .gitignore | ||
| README.md | ||
README.md
Global Coupon Exchange
Website: gogenex.com
Brand Naming Strategy
This project adopts a regional branding strategy, using different brand names for different markets while maintaining brand family consistency.
Brand Structure
| Market | Brand | Abbr | Description |
|---|---|---|---|
| Western (US/Europe) | Genex | GNX | Derived from Generation + Exchange, familiar Western naming style |
| Asian (including China) | Gensen / 券信 | GS | "Gensen" from Cantonese pronunciation of Chinese characters "券信" |
Unified Domain
- gogenex.com - Single global domain for all markets
- Subdomains or paths for regional content (e.g., gogenex.com/cn, gogenex.com/asia)
Naming Logic
Genex (Western Markets)
- Gen = Generation / Generic / Genesis
- ex = Exchange
- Natural pronunciation, similar to well-known Western brands like FedEx, Amex
- Professional, modern, and trustworthy fintech image
Gensen / 券信 (Asian Markets)
- 券 (Quan) = Coupon / Voucher
- 信 (Xin) = Trust / Credit
- Gensen = Romanization of Cantonese pronunciation "gyun seon"
- Use Chinese characters "券信" in Mainland China
- Use romanized "Gensen" in other Asian regions
- Two characters conveying core values: coupon trading + trust guarantee
Brand Consistency
Genex ←── "Gen-" prefix ──→ Gensen
↑ ↑
└─────── Same brand family ────┘
↓
券信 (Chinese localization)
- Genex and Gensen share the "Gen-" prefix, establishing brand family recognition
- Gensen directly transliterates to 券信, providing seamless connection
- Global users can recognize these as regional versions of the same platform
Usage Scenarios
| Scenario | Western Markets | Asian Markets (non-China) | China Market |
|---|---|---|---|
| Company Name | GoGenex Inc. | Gensen Asia Ltd. | 券信科技有限公司 |
| App Name | Genex | Gensen | 券信 |
| Domain | gogenex.com | gogenex.com/asia | gogenex.com/cn |
| Social Media | @gogenex | @gensen_official | @券信official |
Note on Company Structure:
- Inc. (Corporation) for Western markets: Better for VC funding, stock issuance, and potential IPO
- Ltd. (Limited) for Asian markets: Common structure in Asia-Pacific region
- Social media handles use variations to avoid conflicts with existing accounts
Legal & Operations
Due to varying financial regulations across countries, each regional brand will:
- Operate as an independent legal entity
- Comply with local regulatory requirements
- Share core technology platform and philosophy
- Establish brand association through parent company
Project Overview
Global Coupon Exchange (GCX) is a coupon asset trading platform designed to provide users with secure and convenient trading services for digital assets such as coupons, gift cards, and vouchers.
Core Features
- Coupon asset listing and trading
- Secure transaction matching mechanism
- Multi-currency settlement support
- User credit system
Tech Stack
TBD
Documentation
For detailed development documentation, please refer to the docs directory.
License
TBD