admin/goodgo-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(osm): note 2025 VN admin reform — vn_districts now holds ward/commune layer
Some checks failed
CI / AI Services (Python) — Smoke (push) Failing after 35s
Details
Deploy / Build Web Image (push) Failing after 30s
Details
Deploy / Build AI Services Image (push) Failing after 11s
Details
E2E Tests / Playwright E2E (push) Failing after 37s
Details
CI / Lint → Typecheck → Test → Build (22) (push) Failing after 11m1s
Details
Deploy / Build API Image (push) Failing after 10m40s
Details
Backup Verification / Backup Restore Verification (push) Failing after 14s
Details
Deploy / Deploy to Staging (push) Has been cancelled
Details
Deploy / Smoke Test Staging (push) Has been cancelled
Details
CI / E2E Tests (push) Has been cancelled
Details
Deploy / Rollback Staging (push) Has been cancelled
Details
Deploy / Deploy to Production (push) Has been cancelled
Details
Deploy / Smoke Test Production (push) Has been cancelled
Details
Deploy / Rollback Production (push) Has been cancelled
Details
Security Scanning / Dependency Audit (pnpm) (push) Failing after 6s
Details
Security Scanning / Trivy Scan — API Image (push) Failing after 42s
Details
Security Scanning / Trivy Scan — Web Image (push) Failing after 27s
Details
Security Scanning / Trivy Scan — AI Services Image (push) Failing after 26s
Details
Security Scanning / Trivy Filesystem Scan (push) Failing after 23s
Details
Security Scanning / Security Gate (push) Failing after 1s
Details
CodeQL Analysis / CodeQL (javascript-typescript) (push) Failing after 49s
Details

Browse Source 
Vietnam dropped the district administrative level in the 2025 reform
(Nghị quyết về sắp xếp đơn vị hành chính). Only two levels remain:
province (level=4) and ward/commune (level=6).

OSM has updated tagging accordingly: every former xã/phường/thị trấn
that survived the merge is now `admin_level=6`, no `admin_level=8`
features for VN. Our sync confirmed this — 3,189 level=6 units inserted
across 33 provinces, level=8 returns zero.

The schema column "vn_districts" stays as-is to avoid a cascade-rename
across IndustrialPark / ProjectDevelopment / Property FKs. Documented
the semantic shift in osm-data-model.md so future ops don't think
something is broken when wards are empty.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Ho Ngoc Hai
2026-05-01 13:13:26 +07:00
parent 884a8d2a63
commit 1e9ef567a9
1 changed files with 2 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/osm-data-model.md
View File

@@ -9,8 +9,8 @@ the query patterns that use them.
| Table | Source | Geometry | Sync cadence | Used by |
|-------|--------|----------|--------------|---------|
| `vn_provinces` | OSM `boundary=administrative + admin_level=4` | MultiPolygon | Weekly (Mon 02:30 ICT) | `GeoLookupService`, KCN sync, address auto-fill |
| `vn_districts` | OSM `admin_level=6` | MultiPolygon | Weekly (Wed 02:30 ICT) | Same as above |
| `vn_wards` | OSM `admin_level=8` | MultiPolygon | Weekly (Sat 02:30 ICT) | Same as above |
| `vn_districts` | OSM `admin_level=6` | MultiPolygon | Weekly (Wed 02:30 ICT) | Same as above. **After the 2025 reform** this table effectively holds the new ward / commune layer (~3,200 units), since Vietnam dropped the district level. The schema name is kept for backwards-compat with goodgo's existing FK references. |
| `vn_wards` | OSM `admin_level=8` | MultiPolygon | Weekly (Sat 02:30 ICT) | Same as above. **Note**: after the 2025 admin reform Vietnam only uses level=4 (province) + level=6 (ward/commune). OSM doesn't currently tag any VN feature with admin_level=8, so this table will stay empty until/unless the policy changes. Kept for forward-compat. |
| `Poi` | OSM nodes/ways/relations matching 20 category selectors | Point | Daily 1 category rotation (02:00 ICT) | `/poi/nearby`, `/poi/by-bbox`, listing sidebar, search filter |
| `TransportLine` | OSM `route=subway|train|highway` relations | MultiLineString | Monthly | Distance scoring, planned for Phase 2 UX |
| `IndustrialPark` | OSM `landuse=industrial` ways/relations | Point + MultiPolygon boundary | Monthly (1st 03:00 ICT, 4 chunks) | `/industrial/parks/*`, KCN catalog |