ๅคงๅๆ ธๅฟ็ณป็ปๆจๅนฟไธ็บฟๅฎๆถๆๆฅ้ฉพ้ฉถ่ฑ
Real-time Command Cockpit for Enterprise System Rollout
ๅบไบ Vue 3ใEChartsใFastAPI ไธ MySQL HeatWave AutoML ๆๅปบ็ไผไธ็บง้ซๅฏๅบฆใๅคๅฑๅๅๅณ็ญๆๆฅไธญๅฟ
็ฎไฝไธญๆ ยท English ยท ๆๆกฃ็ดขๅผ ยท ๅฝๅ็ถๆ ยท ๅทฒ็ฅ้ฎ้ข ยท ็ฌฌไธๆนๅฃฐๆ ยท ๅๆดๆฅๅฟ
2026-10-07 ้จ็ฝฒๆนๅผ่กฅๅ ๏ผCI ไป ๆง่ก่ดจ้ๆฃๆฅใๅ จ้ๆผ็คบๆฐๆฎ้ Git ๅๅทไฟๅญ๏ผ ้่ฟ็ฌ็ซๆฌๅฐ MySQL ๅๅงๅๅๅช่ฏป่ฟ่ก๏ผไธ้่ฆๆง็ไบง็ฏๅขใ ๅฏๅจๆญฅ้ชค่ง ๆผ็คบ้จ็ฝฒใไปฅไธ่ชๅจ้จ็ฝฒๆ่ฟฐไฟ็ไธบๅๅฒ่ฏดๆ๏ผๅทฒ่ขซๆฌๆกๅไปฃใ
Deployment update: CI runs checks only. The bundled full demo seed initializes an independent local MySQL database; see the demo guide above. Earlier automatic deployment descriptions are historical.
2026-10-07 ๅคไปฝ่ฟ็งป่กฅๅ ๏ผGitHub ไธป็บฟไธไธคไธชๆ ็ญพๅทฒๅๆญฅๆธ ็ๅ็ๅๅฒ๏ผๅ จ้ๆฐๆฎๅ ้่ฟ่ฟ็ซฏๅ ้ๆ ก้ชใ ้จ็ฝฒ Secrets ไฟ็ๅจ GitHub ็ๆบๅฏ้ ็ฝฎไธญ๏ผๆชๅฏผๅบๅ ฅๅบ๏ผ็ไบงๆๅกไธๆบๆฐๆฎๅบๅฐๆชๅ็จใ ่ฏฆ็ป้ชๆถไธๅฟๅ็ญพๅ็ GitHub ้ช่ฏ้ๅถ่ง ๅฝๅ็ถๆใ
Backup update: GitHub now contains the cleaned history and verified full demo package. Deployment Secrets remain in GitHub configuration; production retirement is pending. See the current state above for verification limits.
2026-10-07 ๅ็จ่กฅๅ ๏ผMOD ็ไบงๆๅกใๅฎๆถไปปๅกๅไธๅฑ Nginx ๅ ฅๅฃๅทฒๅ ณ้ญ๏ผๆบๅบไธ้จ็ฝฒๆไปถไฟ็ใ ๅ ฑไบซๆฐๆฎๅบๅ MODO ๆชๅ็จ๏ผGitHub Secrets ไฟ็ๅค็จใไปฅไธโ็ไบงๅฐๆชๅ็จโ่ฏดๆๅฑไบๆญคๅ้ถๆฎตใ
Retirement update: MOD production services, scheduled jobs and its Nginx entry are disabled. Source data and deployment files remain; the shared database, MODO and GitHub Secrets are preserved.
2026-10-08 ไฟ็ๆนๆก๏ผๆๆๆ่ ๅณๅฎ๏ผ็ไบงๆฐๆฎไฟ็ๅค็จ๏ผๅๆถๅ ๅบๆ่ฎฎใ ๆจกๆๅจๅ MOD HeatWave ่ชๅจๅ ่ฝฝใ้่ฎญไฟๆๅ็จ๏ผๆชๅธ่ฝฝๅทฒๅ ่ฝฝ่กจ๏ผไธๅๆญขๅ ฑไบซๆฐๆฎๅบใ
Retention update: Production data remains available for future use. Source deletion is cancelled; the simulator and MOD HeatWave automatic loading/retraining remain disabled. Already loaded tables have not been unloaded, and the shared database remains active.
2026-10-08 ็ญพๅไฟฎๅค๏ผๅ ญไธชๆฐๅขๅทฅไฝๆไบคๅทฒ็จ GitHub ้็ง้ฎ็ฎฑ้ๆฐ็ญพๅ๏ผๅ จ้จ้่ฟ GitHub Verified๏ผ ไปฃ็ ใๆฐๆฎไธไธคไธชๆขๆๆ ็ญพๆชๆนใไปฅไธๅฟๅ้ฎ็ฎฑ้ช่ฏ้ๅถๅฑไบไฟฎๅคๅ้ถๆฎต๏ผๆ ๅฐๅ้ชๆถ่ง ๅฝๅ็ถๆใ
Signature update: All six recent work commits were re-signed using the GitHub noreply email and are GitHub Verified. Code, data and the two existing tags are unchanged; the earlier email verification limitation is historical.
2026-10-08 ไบ็ซฏๅ็จ่กฅๅ ๏ผMOD ็ 12 ๅผ HeatWave ่กจๅทฒๅธ่ฝฝ๏ผๆบๅบๆฐๆฎไฟ็ใ ไธๅฑ CloudFront ๅๅๅทฒๅ็จไฝๆชๅ ้ค๏ผๅ ถไป้กน็ฎไธๅ ฑไบซๆๅกๆชๆนใ ๅๆก MOD ๅๅ่งฃๆๅ ้ค็ญๅพ GCP ้ๆฐ่ฎค่ฏ๏ผๅฝๅ่ฎฐๅฝไปไฟ็ใไปฅไธโๅฐๆชๅธ่ฝฝโ่ฏดๆๅฑไบๆญคๅ้ถๆฎตใ
Cloud retirement update: MOD's 12 HeatWave tables are unloaded and source data is retained. Its CloudFront distribution is disabled and preserved. Removal of the single MOD DNS record is pending GCP reauthentication; other resources remain unchanged.
Important
MOD ๆฏ็จไบๆผ็คบ้ช่ฏใไธๅกไปฟ็ไธๅทฅ็จ็ ็ฉถ็ๅฎๆด็ณป็ปใๅคงๅฑๅฑ็คบ็ 3,200+ ๆบๆๅไฝใ41,000+ ไบบๅใ490 ไธ่ดขๅกๅญ่ฏๅๅ จไธๅกๆต่ฝฌไบไปถ๏ผๅไธบ่ชไธปๆ็ๅผๆ็ๆ็ๅ่งๅๆๆฐๆฎ๏ผๅ จ็จไธไฝฟ็จไปปไฝ็ๅฎไผไธๆๆๆฐๆฎใ
ๆดๆฐๆฅๆ๏ผ2026-09-23 ยท ็ถๆ๏ผ็ฐ่ก้กน็ฎๆฆ่ง ยท ็ฐ่ก็ๆฌ๏ผv0.10.0
้็จ่ๅด๏ผ็ณป็ปๅฎไฝใ่ฟ่กๆถๆใๅ
ญๅฑๅไบใๅผๅๆๅไธไปๅบๅฏผ่ช
MOD ๅฐ่ทจ 34 ไธช็็บง่กๆฟๅบใๆฐๅๅฎถๅ็บงๅไฝใๅคๆนๆฌกๆจ่ฟ็ๅคงๅๆ ธๅฟไธๅก็ณป็ปๅปบ่ฎพๆจๅนฟ่ฟ็จ๏ผ่ฝฌๅไธบไธๅฅ้ขๅ้ซๅฑๅณ็ญไธไธ็บฟไฝๆ็ๅฏ่งๅๆๆฅ้ฉพ้ฉถ่ฑใ
ๅฎๆ็ ดไบไผ ็ปไฟกๆฏๅๅปบ่ฎพไธญโ่ฟๅบฆ็ๅจๆฅใๆ ธๅฏนๆ่กจๆ ผใ้ฃ้ฉ้ ็ต่ฏโ็ๅฒ่ฃๆจกๅผ๏ผๆๅทฅ็จๅปบ่ฎพ่ฟๅบฆใๆนๆฌกไธ็บฟๆจ่ฟใไธๅก่ฟ่ฅไฝ่ฏใๅ่ฝจๆ ธๅฏนไธ่ดๆงใๅ่ง็็ฃไธ AI ๆบ่ฝ็ ๅค่ไธบไธๆกๅฎๆดใๅฏ็ฉฟ้็็ฎก็ไธป็บฟใๆฏ้กนๅฎ่งๅคง็็ป่ฎบ๏ผๅๅฏไธ้ฎไธ้ปๆ ธ้ช่ณๅ ทไฝๆบๆใๆนๆฌกใๅทฅๅบไธๅๅงไธๅก่ฏๆฎใ
้ฉพ้ฉถ่ฑ็ฑ 6 ไธช้ซๅฏๅบฆใไบ็ธๅ ณ่็ไธๅฑๅคงๅฑๆๆ๏ผๆๆๅฑๅนๅ ฑไบซๅ จๅฑ Pinia ๅๅบๅผ็ถๆไธๅบๅฑๆฐๆฎๅฟซ็ ง๏ผ
| ๅฑๅนๆจกๅ | ๆ ธๅฟๅฎไฝไธๅณ็ญ้็น |
|---|---|
| A ยท ้กน็ฎๆป่ง (Overview) | ไบๅๆๅฟๅฏผ่ชใ็ๅๅฐๅพไธ่ๅจๆ่ฆใ่ทจๅ่ถๅฟใไปๆฅๅๅๅ่กๅจ้ๅ |
| B ยท ๅปบ่ฎพ่ฟๅบฆ (Construction) | ๅปบ่ฎพๆฆ่งใ้ถๆฎตไปปๅก็ฉ้ตใๆปๅ็ๅใไธ็บฟ้จ็ฆใๆฐๆฎๅฐฑ็ปชๅๅธธ้ฉปๅฐ่ดฆ้ข่ง |
| C ยท ไธ็บฟๆจๅนฟ (Rollout) | ๆนๆฌกๅฝๅๆไธๅๅฒ็ฌๅกใๅบๅๆจ่ฟ็ผบๅฃใ่็ณปไบบไพๅคๅๅไฝไธ็บฟๅฐ่ดฆ |
| D ยท ไธๅก่ฟ่ฅ (Operations) | ๅๆฎโๅญ่ฏโ้ๆ็ซฏๅฐ็ซฏ้พ่ทฏใๆฅๅๅใๅ่ฝจๆ ธๅฏนๅๆฐๆฎ่ดจ้ๅฎก่ฎก |
| E ยท ๅ่ง็็ฃ (Compliance) | ๅ่งๆ่ฆใ้ฃ้ฉๆ ็ญพใๆฒป็ๅทฅๅๆต่ฝฌใๅฎๆถๅนฟๆญๅ้ฎ้ขไธ้ป |
| F ยท ้ฃ้ฉไธๆบ่ฝ็ ๅค (Risk & AI) | ้ฆ่ฆ็ถ้ขไธ่กๅจไผๅ ็บงใ้ฃ้ฉๅๅธใๆจกๅๆฒป็ๅๆฏๆฅๅณ็ญ็ฎๆฅ |
- ็ฎก็ๅณ็ญ้ฉฑๅจ็็ซไฝๅไบ๏ผๆฏไธชๅพ่กจไธๆๆ ๅกๅๆๅกไบๅณ็ญใๅฏนๆฏใไธ้ปๆ่ฟ่ฅๅจไฝ๏ผๆ็ปๅ่ไธๅฎ็่ฃ ้ฅฐๆงๅจๆใ
- ้ซๆ็ไธๅก่ฟ่ฝฌไธไธฅๆ ผไผ่ฎกๅพ็จฝ๏ผๅ ็ฝฎๅๆงๆ็ๅผๆ๏ผ้ตๅพชใไผไธไผ่ฎกๅๅใๅ จๅคฉๅๆจกๆไผไธไฝๆฏ่ๅพ๏ผ8:30-11:30, 13:30-17:00๏ผใๆๆซๅฒๅบๅๅขๅผ็จ่ฟ้้กน็ๅฎ่ฎฐ่ดฆใๅ จๅบ 490 ไธๅญ่ฏๅ่ดท 0 ไธๅนณใ0 ๅญคๅฟๅๆฎใ0 ็ฉฟ่ถๆชๆฅ็่ฟ่ๆถ้ดๆฐๆฎใ
- SWR ๅ ๅญๅฟซ็ งๅ็ผๅฒๆบๅถ๏ผSLA < 1.0s๏ผ๏ผๅ็ซฏ้็จ Stale-While-Revalidate ๅผๆญฅ้ข็ญๆบๅถ๏ผๅๅฐๆฅๅฃๆฏซ็ง็บงๆ้ๅๅบ๏ผๅ ็ฝฎๅๆๅฟซ็ งๅ ๅบ๏ผไฟ้ๆ็ซฏๅทๅฏๅจๆ็ฝ็ปๆณขๅจๆถ้กต้ข้ถ็ฝๅฑใ้ถ่ฝฌๅใ
- ๆนไปไธไฝๅ ๅญๅ ้ไธๆบๅจๅญฆไน ๏ผMySQL HeatWave ๅ ๅญ้็พคๅ ่ฝฝ 9 ๅผ ๆ ธๅฟๅๆๅคง่กจ๏ผๆฏๆๅไธ็บงๆ็ปๅฎๆถ่ๅ่ฎก็ฎไธ AutoML ้ฃ้ฉ่ฏๅใ
- ้ซๅฏๅบฆๅๅบๅผๅฏ่งๅไธ็ปไธ่ง่งๅฅ็บฆ๏ผVue 3 + ECharts 6 ๅฎ็ฐ 34 ็ไปฝ็ข้ๅฐๅพ็ฉฟ้ไบคไบใ่ทจ้ขๆฟ่ๅจใๅจๆ็ง็บงๆถ้ไธ่ช้ๅบ็ผฉๆพใ
- ็ฐไปฃ่ฝฏไปถๅทฅ็จไธๅถๅบฆๅๆฒป็๏ผ
- ๆฌๅฐไธ CI ๅค็จ็ฑปๅๆฃๆฅใๅๅ ๆต่ฏใ้ๆๅฅ็บฆใๆๅปบๅๆๆกฃๆฒป็้จ็ฆ๏ผๆๆผ็งป็ๆต่ฏๆฐ้ไธๅจ README ๆๅทฅๅบๅ๏ผ
- CI/CD ๅฏ็จ OpenSSH ControlMaster ่ฟๆฅๅค่ทฏๅค็จ๏ผๆๅคงๆๅ่ชๅจๅ้จ็ฝฒๅฏ้ ๆง๏ผ
- ๅฝปๅบๅ็จ GitHub Issues๏ผๅ จ้ข่ฝฌๅๅ ่ๅๆง็ๆฌๅฐๅทฒ็ฅ้ฎ้ข๏ผKI๏ผ็ๅฝๅจๆๆฒป็ไฝ็ณป๏ผADR-0014๏ผ๏ผ
- ๅบไบ
git-cliff2.13.1 ้ๅฎ็ๆฌ่ชๅจ็ๆ็ปๆๅๅๅธๅๆดๆฅๅฟใ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Global DNS / CDN โ
โ Edge Acceleration & Security โ
โโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโ
โ HTTPS / TLS
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Nginx Origin Gate โ
โ Reverse Proxy & Path Routing โ
โโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโ
โ (Static Assets) โ (API Proxy /api/*)
โผ โผ
โโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโ
โ Vue 3 SPA โ โ FastAPI Backend โ
โ Responsive UI โ โ Read-Only API โ
โโโโโโโโโโโฌโโโโโโโโโโ โโโโโโโโโโโฌโโโโโโโโโโ
โ (Offline SWR) โ (Query & Cache)
โผ โผ
โโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโ
โ Bundled Snapshot โ โ MySQL HeatWave โ
โ Offline Guard โ โ In-Memory & AutoMLโ
โโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโฒโโโโโโโโโโ
โ (Transaction Feed)
โ (Autonomous Loop)
โโโโโโโโโโโดโโโโโโโโโโ
โ mod-simulator โ
โ Synthetic Engine โ
โโโโโโโโโโโโโโโโโโโโโ
ๆถๆๅๅฑ่ฏดๆ๏ผ
- ่พน็ผ้ฒๆคไธๅ จ็ๅ ้๏ผGlobal DNS / CDN๏ผ๏ผๆไพๅบไบ่พน็ผ่็น็ DDoS ้ฒๆคใTLS ็ป็ปไธๅฐฑ่ฟ่ฎฟ้ฎๅ ้ใ
- ๆบ็ซๅๅไปฃ็้จ็ฆ๏ผNginx Origin Gate๏ผ๏ผ็ปไธๅฎๅ
จ้จ็ฆ๏ผไธฅๆ ผ้็ฆป็ง็ฝๆๅก๏ผ่ด่ดฃ
/assets/*ๅ็ซฏ้ๆ่ตๆบ็ดๅไธ/api/*ๅ็ซฏๆฅๅฃๅฎๅ จๅๅไปฃ็ใ - ๅ็ซฏไบคไบ้ฉพ้ฉถ่ฑ๏ผVue 3 SPA๏ผ๏ผๅบไบ Vue 3ใTypeScript ไธ ECharts ๆๅปบ็ๅๅบๅผๆๆฅ็ๆฟ๏ผๅ ็ฝฎ็ฆป็บฟๅฟซ็ งๅ ๅบ๏ผBundled Snapshot๏ผ๏ผไฟ้ๅทๅฏๅจไธ็ฝ็ปๆณขๅจๆถ้ถ็ฝๅฑใ้ถ่ฝฌๅใ
- ้ซๆง่ฝๅ็ซฏๆ ธๅฟ๏ผFastAPI Backend๏ผ๏ผๅช่ฏป้ซๆง่ฝๅผๆญฅไธๅกๆฅๅฃๅฑ๏ผๅบไบ SWR ๆบๅถๅผๆญฅ้ข็ญๅ ๅญ็ผๅญ๏ผไฟๆๅ จๆฅๅฃ SLA < 1.0sใ
- ๆนไปไธไฝๆฐๆฎไธๆบๅจๅญฆไน ๅบๅบง๏ผMySQL HeatWave๏ผ๏ผๆฏๆๅไธ็บงๆ็ปๅๅญๅ ๅญๅๆไธ AutoML ๆบ่ฝ้ฃ้ฉ็ ๅคๆจกๅใ
- ้ซไฟ็ไธๅกไปฟ็ๅผๆ๏ผmod-simulator๏ผ๏ผๅ จๅคฉๅๆ็ๅฎไฝๆฏ่ๅพ้ฉฑๅจไธๅกๅๆฎไธไผ่ฎกๅญ่ฏๆผๅๆจ่ฟ๏ผไธบ็ณป็ปๆไพๅ่งๅๆๆฐๆฎๆบใ
ๆ ๅ็ไบงไบคไป็ฑ GitHub Actions ๆตๆฐด็บฟๅจไปฃ็ push ่ณ main ๅๆฏๆถ่ชๅจ่งฆๅๅ
จ้้จ็ฆๆฃ้ชไธ็ไบงๆบๅๅญ่ฝฏ้พ้จ็ฝฒ๏ผ่ฟ่กๅญๆฎไธฅๆ ผไฟ็ๅจไปฃ็ ๅบไนๅคใ
| ๆถๆๅฑ็บง | ๆ ธๅฟๆๆฏ้ๅ |
|---|---|
| ๅ็ซฏๅคงๅฑ (Frontend) | Vue 3.5ใTypeScript 5.9ใPiniaใECharts 6.1ใTailwind CSSใVite |
| ๅ็ซฏๆฅๅฃ (Backend) | FastAPIใPython 3.13.16ใSQLAlchemy 2.0ใUvicornใPydantic |
| ๆฐๆฎไธๆนไปๅ ้ (Data) | MySQL 8.4 HeatWaveใHeatWave In-Memory ClusterใAutoML |
| ่ดจ้ไธๅฎๅ จไฟ้ (QA) | PytestใVitestใPlaywrightใRuffใvue-tscใESLintใStylelintใpre-commitใdetect-secretsใgitlintใLychee ไธ MOD ไธๆๅฅ็บฆ |
| ้จ็ฝฒไธไบคไป่ฟ็ปด (Ops) | Nginxใsystemdใๅๅญ็ๆฌ่ฝฏ้พๅๆขใGitHub ActionsใFail2ban ้ฒๆค |
ๅ็ฝฎๅผๅ็ฏๅข๏ผPython 3.13.16ใuvใNode.js 26.10.0ใpnpm 12.8.1 ไธ Makeใ
Node ไธ pnpm ็ๆฌ็ไปๅบ็บงไบๅฎๆบไธบ .tool-versions๏ผasdf ็จๆทๅฏๅจไปๅบๆ น็ฎๅฝ่ฟ่ก asdf installใ
# 1. ๅฏๅจๅ็ซฏ API ๆๅก๏ผ็ป็ซฏ 1๏ผ
cd backend
uv sync --all-extras
uv run uvicorn app.main:app --host 127.0.0.1 --port 8100
# 2. ๅฏๅจๅ็ซฏ้ฉพ้ฉถ่ฑ๏ผ็ป็ซฏ 2๏ผ
cd frontend
pnpm install
pnpm dev
# ๆฌๅฐ่ฎฟ้ฎ๏ผhttp://127.0.0.1:5173/ๅ็ซฏๅทฒๅ ็ฝฎ็ฆป็บฟๅๆๅฟซ็ งๆฐๆฎ๏ผๆ ้้ ็ฝฎๆฌๅฐๆฐๆฎๅบๅณๅฏๅฎๆดไฝ้ชๅ ญๅฑ่ๅจไบคไบใ่ฅ้่ฟๆฅๆฐๆฎๅบ๏ผ่ฏทๅ่
docs/development/้ ็ฝฎๆฌๅฐ็ฏๅขๆไปถใ ไปๅบไธๅๅไธญๅฝๅฐๅพๅ ไฝๆฐๆฎ๏ผๅฐๅพ้ป่ฎคๆพ็คบๆช้ ็ฝฎ็ถๆใ้จ็ฝฒ่ ๅชๆๅจ่ช่ก็กฎ่ฎคๆฐๆฎๆๆใ็ฐๅฟๆงไธ้็จๆณ่งๅ๏ผ ๆๅบ้่ฟVITE_CHINA_MAP_GEOJSON_URLๆไพๅ ผๅฎน ECharts ็ GeoJSONFeatureCollectionใ
ๆไบคไปฃ็ ๅ่ฏทๆง่กๅ จ้่ดจ้้จ็ฆ๏ผ
make check| ๅ ณ้ฎๆๆกฃ | ็จ้่ฏดๆ |
|---|---|
| AGENTS.md | ไบบ็ฑปไธ AI ็ผ็ ๅฉๆๅฟ ้กปไธฅๆ ผ้ตๅฎ็ไปๅบ็บข็บฟไธๆ้ซ็บฆๆ |
| ENFORCEMENT.md | ๅจๆไบคใๆต่ฏใๅๅธๅจไฝ็นๅผบๅถๆง่ก็ๅฎๅ จไธๆฒป็้ธ้จ |
| CONTRIBUTING.md | ๆ ๅๅผๅใ่ช้ชใๆๆกฃๅๆญฅไธๅๅญๆไบคๅทฅไฝๆต |
| SUPPORT.md / SECURITY.md | ๅ ฌๅ ฑๆฏๆ่พน็ไธ็งๅฏๆผๆดๆฅๅๅๆ |
| ็ฌฌไธๆน็ปไปถไธๆฐๆฎๆฅๆบๅฃฐๆ (THIRD_PARTY_NOTICES.md) | ็ฌฌไธๆน็ปไปถๅฃฐๆใไธญๅฝๅฐๅพๆฐๆฎ้็ฆป็ญ็ฅไธไฝฟ็จ่พน็ |
| ๅฝๅ็ถๆไบๅฎ (CURRENT-STATE.md) | ๅฝๅ่ฟ่ก็ฏๅขใๆฐๆฎ่งๆจกไธๆๆฏไบๅฎ็ๅฏไธๅฎๆนๅ ฅๅฃ |
| ๆๆกฃๆป็ดขๅผ (INDEX.md) | ็ฐ่กๆถๆใๅผๅๆ ๅใADR ๅณ็ญใๅๅฒ่ตๆไธๆไฝ่พน็ๆป่ง |
| ๅทฒ็ฅ้ฎ้ข็ๆฟ (KNOWN-ISSUES.md) | ็ณป็ปๆๆฏๅบๅกไธ็ผบ้ท็ๆฟ๏ผๅทฒๆ ADR-0014 ้ญ็ฏ็ฎก็๏ผ |
| ๅๆดๆฅๅฟ (CHANGELOG.md) | ๅบไบ git-cliff ็ฑ่ฏญไนๅๆไบค่ชๅจ็ๆ็็ๆฌๅ่กๅๅฒ |
MOD ่ช็ ไปฃ็ ้ตๅพช MIT License ๅผๆบๅ่ฎฎใไปๅบใไพ่ต้ไธ้ป่ฎคๆๅปบๅไธๅ
ๅซไธญๅฝๅฐๅพๅ ไฝๆฐๆฎ๏ผ
ๅฐๅพ่ฝๅไป
ๅจ้จ็ฝฒ่
้่ฟ VITE_CHINA_MAP_GEOJSON_URL ๆพๅผๆไพๅนถ่ช่ก็กฎ่ฎคๅ่ง็ๆฐๆฎๆบๅๅฏ็จใ
็ฌฌไธๆน็ปไปถๅฃฐๆๅๅฐๅพไฝฟ็จ่พน็่ง็ฌฌไธๆน็ปไปถไธๆฐๆฎๆฅๆบๅฃฐๆใ
Updated: 2026-09-23 ยท Status: Active project overview ยท Current release: v0.10.0
Scope: System positioning, architecture, 6-screen storytelling, development guide, and repository navigation
MOD transforms the complex, multi-stage rollout of an enterprise-level core business system across 34 provincial regions and thousands of sub-units into a high-density, decision-ready visual command center.
It replaces the traditional, fragmented approach of "tracking progress via status reports, reconciling data across spreadsheets, and resolving risks through phone calls" with a unified, drillable management thread connecting construction milestones, rollout readiness, operational evidence, dual-run accounting reconciliation, compliance posture, and AI-driven decision briefings. Every top-level finding can be seamlessly drilled down into specific organizations, batches, stages, and raw business records.
The command cockpit comprises 6 dense, interconnected screens sharing global Pinia reactive state and in-memory data snapshots:
| Screen | Core Purpose & Decision Focus |
|---|---|
| A ยท Overview | Five-domain navigation, regional map and linked summaries, cross-domain trends, daily changes, and action queue |
| B ยท Construction | Construction overview, stage matrix, lagging regions, go-live gates, data readiness, and persistent ledger preview |
| C ยท Rollout | Current and historical batch progress, regional rollout gaps, contact exceptions, and unit rollout ledger |
| D ยท Operations | End-to-end document, voucher, and integration flow, daily throughput, dual-run reconciliation, and quality audits |
| E ยท Compliance | Compliance summary, risk tags, governance workflow, live activity, and issue drill-down |
| F ยท Risk & Intelligence | Primary bottlenecks, action priorities, risk distribution, model governance, and daily decision briefings |
- Decision-Centric Visual Storytelling: Every chart and card directly supports decision-making, comparative analysis, drill-down, or operational follow-up.
- High-Fidelity Synthetic Operations & Rigorous Accounting: Powered by an autonomous simulation engine following standard enterprise accounting rules. Generates realistic diurnal rhythms (8:30-11:30, 13:30-17:00), month-end closing surges, and VAT input/output tracking. Across 4.9M vouchers, there are exactly 0 debit/credit imbalances, 0 orphan records, and 0 future date anomalies.
- SWR In-Memory Snapshot Double Buffering (SLA < 1.0s): Employs Stale-While-Revalidate caching for millisecond API responses with asynchronous backend prewarming. Bundled fallback snapshots guarantee zero white-screen and zero-spinner resilience even during cold starts or network fluctuations.
- Lakehouse In-Memory Acceleration & AutoML: 9 core analytics tables are loaded into the MySQL HeatWave in-memory cluster, enabling instant multi-million row aggregations and automated risk scoring.
- Dense, Responsive Visualization: Vue 3 and ECharts 6 deliver interactive 34-region map penetration, cross-panel filtering, a real-time ticking clock, and auto-scaling layouts.
- Enterprise Engineering Rigor:
- Local and CI workflows share type, unit, static-contract, build, and documentation gates; volatile test counts are derived rather than copied into this README;
- CI/CD hardened with OpenSSH ControlMaster connection multiplexing for rapid, reliable deployments;
- GitHub Issues deprecated in favor of a locally governed Known Issues (KI) lifecycle system (ADR-0014);
- Reproducible release changelogs generated automatically with pinned
git-cliff2.13.1.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Global DNS / CDN โ
โ Edge Acceleration & Security โ
โโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโ
โ HTTPS / TLS
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Nginx Origin Gate โ
โ Reverse Proxy & Path Routing โ
โโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโ
โ (Static Assets) โ (API Proxy /api/*)
โผ โผ
โโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโ
โ Vue 3 SPA โ โ FastAPI Backend โ
โ Responsive UI โ โ Read-Only API โ
โโโโโโโโโโโฌโโโโโโโโโโ โโโโโโโโโโโฌโโโโโโโโโโ
โ (Offline SWR) โ (Query & Cache)
โผ โผ
โโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโ
โ Bundled Snapshot โ โ MySQL HeatWave โ
โ Offline Guard โ โ In-Memory & AutoMLโ
โโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโฒโโโโโโโโโโ
โ (Transaction Feed)
โ (Autonomous Loop)
โโโโโโโโโโโดโโโโโโโโโโ
โ mod-simulator โ
โ Synthetic Engine โ
โโโโโโโโโโโโโโโโโโโโโ
Architecture Layer Breakdown:
- Global DNS / CDN: Edge-level DDoS protection, TLS termination, and accelerated static asset routing.
- Nginx Origin Gate: Origin-side security ingress routing
/assets/*to frontend static artifacts and reverse-proxying/api/*to the FastAPI backend. - Vue 3 SPA: Interactive command cockpit built with Vue 3, TypeScript, and ECharts, featuring bundled snapshot fallbacks to guarantee zero spinners during cold starts or network lags.
- FastAPI Backend: Read-only asynchronous service layer utilizing SWR prewarming caches to uphold strict SLA < 1.0s.
- MySQL HeatWave: Lakehouse in-memory columnar acceleration for multi-million row aggregations and integrated AutoML risk attribution.
- mod-simulator: High-fidelity autonomous simulation engine driving realistic enterprise business transaction and accounting voucher streams.
Standard production delivery runs through GitHub Actions CI/CD upon push to main with full quality gates and atomic release symlinks on the dedicated production host. Runtime credentials remain strictly outside Git.
| Layer | Core Technologies |
|---|---|
| Frontend | Vue 3.5, TypeScript 5.9, Pinia, ECharts 6.1, Tailwind CSS, Vite |
| Backend | FastAPI, Python 3.13.16, SQLAlchemy 2.0, Uvicorn, Pydantic |
| Data & Acceleration | MySQL 8.4 HeatWave, HeatWave In-Memory Cluster, AutoML |
| Quality & Assurance | Pytest, Vitest, Playwright, Ruff, vue-tsc, ESLint, Stylelint, pre-commit, detect-secrets, gitlint, Lychee, and MOD-specific contracts |
| Operations & Delivery | Nginx, systemd, atomic release symlinks, GitHub Actions, Fail2ban |
Prerequisites: Python 3.13.16, uv, Node.js 26.10.0, pnpm 12.8.1, and Make.
The repository-level Node and pnpm version source is .tool-versions; asdf users can run asdf install from the repository root.
# 1. Start Backend API Service (Terminal 1)
cd backend
uv sync --all-extras
uv run uvicorn app.main:app --host 127.0.0.1 --port 8100
# 2. Start Frontend Cockpit (Terminal 2)
cd frontend
pnpm install
pnpm dev
# Local access: http://127.0.0.1:5173/The frontend includes bundled synthetic snapshot data, allowing complete exploration of all 6 screens without configuring a local database. To connect to a database, see
docs/development/for environment configuration. The repository does not distribute China map geometry, so the map honestly reports an unconfigured source by default. A deployer may setVITE_CHINA_MAP_GEOJSON_URLto an ECharts-compatible GeoJSONFeatureCollectiononly after independently confirming its authorization, currency, and regulatory suitability.
Run the full quality gate before committing:
make check| Entry | Purpose |
|---|---|
| AGENTS.md | Mandatory red lines and constraints for humans and AI agents |
| ENFORCEMENT.md | Action-time safety and governance gates enforced during development |
| CONTRIBUTING.md | Standard development, verification, doc sync, and commit workflows |
| SUPPORT.md / SECURITY.md | Public support boundaries and private vulnerability reporting prerequisites |
| Third-Party Notices (THIRD_PARTY_NOTICES.md) | Third-party component notices, China-map data isolation policy, and usage boundaries |
| Current State (CURRENT-STATE.md) | Canonical source of truth for runtime, data, and architecture facts |
| Documentation Index (INDEX.md) | Master directory for architecture standards, ADRs, operations, and history |
| Known Issues (KNOWN-ISSUES.md) | Defect and technical debt tracker (governed per ADR-0014) |
| Changelog (CHANGELOG.md) | Automated release history generated from verified Git commits |
MOD-authored code is released under the MIT License. The repository, dependency lock, and default build
contain no China map geometry. Map rendering is enabled only when a deployer explicitly supplies a source through
VITE_CHINA_MAP_GEOJSON_URL after independently confirming compliance. See the
Third-Party Notices for component notices and map-use boundaries.