Go to file
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
.claude feat: Genex Chain 区块链完整实现 — cosmos/evm v0.5.1 应用链 + 9合约 + 合规集成 2026-02-14 23:40:37 -08:00
backend fix: RegexRouter 精确匹配 outbox 表,防止 heartbeat 事件污染消费者 2026-02-15 07:04:17 -08:00
blockchain feat: Genex Chain 区块链完整实现 — cosmos/evm v0.5.1 应用链 + 9合约 + 合规集成 2026-02-14 23:40:37 -08:00
docs docs: 06-区块链开发指南 v3.0 量产版 — 去除全部MVP/阶段性限制 2026-02-14 18:47:55 -08:00
frontend feat: 三端集成 App升级 + 内部推送 + FCM外部推送框架 (genex-mobile/admin-app/mobile) 2026-02-13 07:02:14 -08:00
.gitignore chore: Ignore Claude Code config and Flutter auto-generated files 2026-02-11 07:28:02 -08:00
README.md Update company names and structure (Inc. for West, Ltd. for Asia) 2026-01-28 00:15:01 -08:00

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

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