Documentation Changelog
Page Info
What: Records major structural changes and content updates to this knowledge base Audience: All readers — see what has changed recently in the documentation Prerequisites: None Reading time: 2 minutes Owner: Deposit & Withdrawal Product Team
2026-04-29 · Operations Manual Module Enhancement (Incorporating 12 Internal Documents)
Type: Content enhancement + New pages
Consolidated 12 internal business documents from the /hk/ directory (withdrawal process guidelines, eDDA troubleshooting guide, fund CRM introduction, BOCHK auto-deposit rules, ICBC statements, fund configuration tables, etc.), incorporating operations knowledge not covered by existing documentation into the ops/ module.
New Pages
| Page | Path | Description |
|---|---|---|
| CRM Operations Map | /ops/crm-guide | Full-module CRM navigation (20+ paths), permission matrix, collection info quick reference |
| eDDA Troubleshooting Guide | /ops/edda-troubleshoot | Hang Seng/HSBC dual-channel troubleshooting Runbook, bank-specific failure scenarios, help center URL quick reference |
Enhanced Existing Pages
| Page | New Content |
|---|---|
| Manual Matching Guide | Auto-matching vs smart reminder dual systems, matching rule code quick reference (A–E), BOCHK statement type routing table, auto-approval risk control rules (rate/amount/multi-account limits), account opening deposit special rules, deposit instruction management, grayscale release impact |
| Withdrawal Approval Guide | Daily processing timeline (08:30–15:55), six withdrawal method Runbooks (BST/same-bank/FPS/cheque/CHATS/wire), high-risk approval process (4 scenarios + template questions + monthly sampling), max withdrawable amount formula, large withdrawal thresholds, withdrawal pre-check list (12 error codes) |
| Reversal/Refund Guide | Refund management module three-step Runbook (register → review → process), CRM operation path additions |
| Scheduled Tasks & Monitoring | ICBC dual-AZ disaster recovery architecture (5 types of production issues), BOCHK dual-path statement monitoring (B2E + FTP S16 correlation rules), auto-matching runtime windows |
Configuration Updates
config.mtssidebar Part 4 expanded from 4 items to 6 (added CRM Operations Map, eDDA Troubleshooting Guide)config.mtsnav Operations dropdown menu updated accordinglydeposit/edda.mdanddeposit/troubleshoot.mdadded cross-references to eDDA Troubleshooting Guide
2026-04-28 · Knowledge Base Architecture Upgrade (Benchmarking Industry Leaders)
Type: Architecture governance + New pages + Format transformation
Benchmarked against industry-leading knowledge bases (Stripe/Adyen/GitLab/Cloudflare) to address 10 architectural gaps.
New Pages
| Page | Path | Description |
|---|---|---|
| Unified Error Code Center | /appendix/error-codes | Consolidates all bank error codes and system status codes — one page for all codes |
| Architecture Decision Records (ADR) | /appendix/decisions | 7 key design decisions in "Context → Options → Decision → Consequences" format |
| SCB | /banks/scb | SCB bank integration details (FPS, Webhook, Book Transfer) |
| CGB | /banks/cgb | CGB bank integration details (FPS API batch processing) |
| ICBC Asia | /banks/icbc | B2E direct connect API details |
| EWB | /banks/ewb | CSV/BAI2 + sub-account system |
| CCB Asia | /banks/ccb | API statements + BOCO matching |
| DBS | /banks/dbs | Sub-account priority matching mode |
| Bank of Communications | /banks/bankcomm | Sub-account + BOCO cross-border standard |
| CMB | /banks/cmb | Socket binary protocol details |
| MS | /banks/ms | Protobuf/SRPC protocol details |
| Airstar | /banks/airstar | REST API + RSA-OAEP details |
Architecture Improvements
| Improvement | Description |
|---|---|
| DRI Owner Identification | Each page info block now includes page owner/team |
| Role-based Entry Points | Homepage added role-based (Product/Operations/New Joiner/Developer) reading paths |
| Error Code Index | Deposit/Withdrawal troubleshooting pages added error-code-based quick navigation |
| Runbook Format | Operations manual 4 pages added standardized Runbook annotations (Alert → Evaluate → Act → Verify) |
| config.mts | Sidebar added Error Code Center and ADR pages |
2026-04-28 · Comprehensive Restructuring
Type: Structural reorganization + Content deepening + Experience optimization
This is the complete upgrade of the knowledge base from v1 to v2.0. The goal is to help product managers not only understand business logic, but also determine "if X needs to change, what's impacted and what needs modification".
Structural Changes
| Change | Description |
|---|---|
| Withdrawal chapter reorganization | Original approval.md split into lifecycle.md (Lifecycle), rules.md (Rules Manual), channels.md (Channel Execution) |
| New FAQ page | Consolidated 20+ high-frequency questions from across the site, categorized by business domain |
| New changelog | This page, recording documentation evolution history |
| Navigation optimization | Top nav bar changed to dropdown groups, Deposit/Withdrawal/Operations each expand sub-menus |
| Sidebar completion | edda.md and flow-collection.md added to sidebar |
| Footer | Added global footer with documentation attribution |
Factual Errors Corrected
| Error | Correction |
|---|---|
| BST bank list included "HSBC, Hang Seng" | Corrected to "CMB, MS, Airstar" |
| eDDI processing time stated as 09:00 | Corrected to 07:00 (consistent with code and edda.md) |
| eDDA/eDDI described as withdrawal channel | Corrected to "deposit direct debit only" |
| Matching time window inconsistent across pages | Unified to -3~+2 days (standard) / -3~+4 days (BOCHK) |
| TransType missing 203/207/209/220 | Added complete list |
| DepositType missing STOCK_HOLD(21) / FUND_PURCHASE_HOLD(31) | Added complete list |
Content Deepening
Deposit System (deposit/):
panorama.md: Added specific processing time windows, per-transaction/daily limits, eDDI-specific deposit types for each methodmatching.md: Added per-bank matching rule matrix (extracted from 14 Match classes), matching engine skip rulesreference.md: Added complete DepositType enum, timeout rejection day configurationtroubleshoot.md: Added abnormal deposit detection rule change guide- All 4 files added
If requirements changecollapsible blocks
Withdrawal System (withdraw/):
rules.md: High-risk determination 3 worked examples, OM account identification logic and OmWithdrawDeduct flowreference.md: Added CMB/MS limit descriptions (DB configuration rather than hardcoded), improved fee rules- Added
If requirements changecollapsible blocks
Operations Manual (ops/):
matching-guide.md: Added CRM navigation path table, field mapping table, decision flow diagram, escalation paths, SLA targetsapproval-guide.md: Added CRM navigation paths, channel selection decision matrix (Mermaid), processing timeliness SLAreversal-guide.md: Added pre-reversal checklist (6 items), post-reversal verification checklist (5 items)monitoring.md: Corrected eDDI times, added alert escalation matrix (Critical/High/Medium three levels)- All 4 files added
If requirements changecollapsible blocks
Bank Pages (banks/):
bochk.md: Expanded from skeleton to complete page (B2E protocol, statement field mapping, matching rules, FPS/FTS withdrawal)hsbc.md: Expanded from skeleton to complete page (MT910 collection, eDDA/eDDI details, token bucket, matching rules)hangseng.md: Expanded from skeleton to complete page (5 statement types, eDDI serialization, digital certificates, grayscale deployment)matrix.md: Hang Seng deposit statement column changed from-to actual protocol
Experience Optimization
- Enabled VitePress built-in full-text search (with Chinese support)
- Enabled in-page TOC (table of contents)
- Top navigation changed to dropdown groups for direct access to common pages
- Added global footer
2026-04 · Initial Release
Type: Created from scratch
- Established the base documentation structure with 6 sections (Getting Started / Deposit / Withdrawal / Banks / Operations / Appendix)
- Completed initial content for 22 pages
- Set up VitePress + Mermaid site framework
- Created homepage custom components (HomeStats, HomeRoutes, HomeFlow, HomeChapters)