# Project Scope Document
## Kampong Speu Provincial Demographic Management System (KSP-DMS)

**Document Code:** KSP-DMS-DOC-SCOPE-01  
**Version:** 1.0 (Draft Proposal)  
**Date:** November 2026  

---

## 1. Project Inclusions (In-Scope)

### 1.1 Geographic Scope
The geographical boundary is strictly limited to **Kampong Speu Province**, encompassing:
- 1 Provincial Administration Center (Chbar Mon)
- 8 Districts & Municipalities:
  1. Chbar Mon Municipality (ក្រុងច្បារមន)
  2. Basedth District (ស្រុកបាសិត)
  3. Kong Pisei District (ស្រុកគងពិសី)
  4. Aoral District (ស្រុកឱរ៉ាល់)
  5. Oudong Me Chey Municipality / Samaki Meanchey (ស្រុកឧដុង្គម៉ែជ័យ / សាមគ្គីមានជ័យ)
  6. Phnom Sruoch District (ស្រុកភ្នំស្រួច)
  7. Samraong Tong District (ស្រុកសំរោងទង)
  8. Thpong District (ស្រុកថ្ពង)
- Associated subordinate Communes (ឃុំ/សង្កាត់) and Villages (ភូមិ).

### 1.2 Functional Capabilities Included
1. **Administrative Boundary Management:** Hierarchical CRUD for administrative boundaries with soft deletion.
2. **Household Registry:** Managing physical dwelling locations, household types, and active member rosters.
3. **Person Registry:** Core demographic profiles (Name in Khmer/English, Gender, DOB, Marital Status).
4. **Vital Events Tracking:** Birth notices, Death notices, In-Migration, Out-Migration.
5. **Workflow & Governance:** Staged batch submissions, reviewer verification, approval/rejection notes, and historical audit logs.
6. **Data Quality Engine:** Automated detection of logical anomalies (e.g. impossible ages, orphaned children).
7. **Spatial Visualization:** Aggregated choropleth map rendering via Leaflet with synthetic GeoJSON boundaries.
8. **REST API v1:** Token-secured API endpoints for future mobile synchronization.
9. **Bilingual Localization:** Complete Khmer and English language support.

---

## 2. Explicit Exclusions (Out-of-Scope)

| Item | Reason for Exclusion |
| :--- | :--- |
| **Real National ID Card Integration** | Out of scope for local prototype; national ID API requires Ministry authorization. |
| **Real Citizen Data** | Strictly prohibited by non-negotiable safety rules; synthetic data used exclusively. |
| **Detailed Employment & Income Tracking** | Disabled until specific legal mandates and data privacy decrees are confirmed. |
| **Individual GPS Dwelling Pinpoints** | Excluded by privacy policy; spatial mapping is aggregated to commune boundaries. |
| **Public Cloud Deployment** | Excluded; local-first deployment on provincial infrastructure only. |
| **Commercial Payment Gateways** | Non-commercial civic administrative platform. |
| **Direct Production Mobile Client Deployment** | Flutter client is planned for future phase; REST API v1 is provided and verified. |

---

## 3. Scope Change Management
Any expansion of this scope must be formally requested via a Scope Change Proposal (SCP) evaluated by the Lead Architect and approved by the Provincial Project Steering Committee.
