hailin
e450bef7cd
Add 116 UI prototype files across 4 frontend applications, achieving ~95% coverage of all functional requirements from development guides. ## mobile/ (Flutter Consumer + Merchant App) — 48 files - Auth: welcome, login, register, forgot-password - Coupons: home, market, search, detail, my-coupons, my-coupon-detail, order-confirm, payment, payment-success, redeem-qr - Trading: trading, sell-order (AI pricing), transfer - Wallet: wallet, deposit, withdraw, transaction-records - Profile: profile, kyc (L0-L3), settings, payment-management, pro-mode (WalletConnect, chain address, tx hash, track selection) - AI Agent: agent-chat, ai-fab (floating button with unread count) - Merchant: merchant-home (scanner, confirm, success, history, dashboard), merchant-ai-assistant (redeem assist, traffic prediction, anomaly alerts) - Message: message-list, message-detail - Issuer: issuer-main-page - Shared widgets: coupon-card, price-tag, credit-badge, kyc-badge, status-tag, empty-state, skeleton-loader, confirm-sheet, genex-button, ai-confirm-dialog (3-level risk confirmation) - Theme: app-colors, app-typography, app-spacing, app-theme - i18n: zh-CN, en-US, ja-JP ## admin-app/ (Flutter Issuer Console) — 27 files - Auth: issuer-login - Onboarding: 5-step enterprise onboarding with AI compliance check - Dashboard: issuer-dashboard (stats, AI insight, credit/quota), user-portrait (age/geo/preference/repurchase/AI insight) - Coupon management: list, create (template-based, AI pricing), detail (recall/delist), batch-operations (issue/recall/price-adjust) - Redemption: scan-to-redeem with offline mode - Finance: overview, reconciliation (auto-reconcile, export PDF/Excel), financing-analysis (cost-benefit, liquidity, risk indicators, AI strategy) - Credit: credit-scoring (4-factor, tier progress, AI suggestions), quota-management (usage gauge, type breakdown, tier upgrade, increase requests) - AI Agent: full conversation UI with quick actions - Settings: account, notification, support, tier display - Store management: hierarchy (HQ/regional/store), employee roles - Shared: ai-suggestion-card - Theme: app-colors, app-theme, app-typography, app-spacing - i18n: zh-CN, en-US, ja-JP ## admin-web/ (React + Next.js Platform Admin) — 26 files - Layout: AdminLayout with collapsible sidebar, 10 nav sections - Dashboard: key metrics, transaction feed, system health - Users: user management with KYC filtering, risk tags - Issuers: issuer review with AI pre-screening, credit rating display - Trading: real-time monitor, order book, abnormal detection - Risk: risk dashboard, AI warnings, suspicious transactions, OFAC logs - Compliance: SAR/CTR management, audit logs, AI report generation - SEC Filing: S-1/10-K/10-Q/8-K tracker, filing timeline, auto-disclosure - License management: FinCEN MSB, BitLicense, MTL (48 states), renewal alerts - SOX compliance: ICFR/ITGC/access/change-mgmt controls, deficiency tracking - Tax compliance: Federal + 4 states, 8 IRS forms, tax calendar - IPO readiness: 28-item checklist (legal/financial/SOX/governance/insurance), blocker tracking, milestone timeline, category progress, key contacts - Finance: fee revenue, settlement queue, breakage tracking - Disputes: case management with SLA countdown, chain evidence - Analytics: user (DAU/MAU, cohort retention, geographic), coupon (category, breakage, secondary market), market-maker (TVL, spread, health, risk alerts), consumer-protection (complaints, CSAT, fund utilization, non-compliant issuers) - Insurance: consumer protection fund, claims, IPO checklist overview - Chain monitor: smart contract status, blockchain metrics - Reports: platform-wide report center - AI Agent panel: session stats, top questions, module accuracy - Merchant redemption: stats, store ranking, real-time feed - Design tokens: CSS custom properties (colors, typography, spacing, shadows) - i18n: zh-CN, en-US, ja-JP ## miniapp/ (Taro Mini Program + H5) — 15 files - Pages: home, detail, purchase, orders, my-coupons, login, redeem, profile - H5 pages: h5-share, h5-activity (countdown, featured coupons), h5-register (benefits, phone/SMS form, WeChat login) - Components: coupon-card, ai-guide (recommendation bar + purchase bubble), share-card (brand header, QR code, coupon info) - i18n: zh-CN, en-US, ja-JP ## Design System - Primary: #6C5CE7 (innovation purple), Material 3 style - Consistent design tokens across all platforms - Zero blockchain terminology — "我的券" not "NFT", "订单号" not "TX Hash" - Utility Track MVP only; Securities Track reserved as "coming soon" ## Not included (by design) - Data/Domain layers (API, state management, business logic) — UI prototypes only - Securities Track full UI — MVP focuses on Utility Track - P2 "求购" (want-to-buy) feature — marked as optional Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> |
||
|---|---|---|
| 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