Fixes #1830 Merge v1.3.2-rc.1 into develop for mosip-data

AGENTS.md

@@ -0,0 +1,72 @@
+# AGENTS.md
+
+This file provides guidance to AI agents when working with code in this repository.
+
+## What This Repository Is
+
+This is the **MOSIP Master Data Repository** — a data-only repo containing sample/sandbox master data for the [MOSIP identity platform](https://docs.mosip.io/1.2.0/id-lifecycle-management). It has no application code, no build system, and no test suite. Changes here feed directly into MOSIP database initialization and upgrades.
+
+## Data Layout
+
+```
+mosip_master/xlsx/       ← Canonical source: 37 Excel files (edit these)
+mosip_master/csv/        ← Primary CSV source used by the masterdata-loader
+mosip_master_csv/csv/    ← Auto-generated from xlsx via CI (do not edit manually)
+mosip_master/data_upgrade/ ← Version-to-version delta migration scripts
+```
+
+**Key rule:** Only edit files in `mosip_master/xlsx/` or `mosip_master/csv/`. The `mosip_master_csv/csv/` directory is regenerated automatically by the `xlsx-to-csv` GitHub Actions workflow on every PR — manual edits there will be overwritten.
+
+## Workflows
+
+### xlsx-to-csv (`.github/workflows/xlsx-to-csv.yml`)
+Triggers on PR open/sync or manual `workflow_dispatch`. Converts every `.xlsx` in `mosip_master/xlsx/` to CSV using `xlsx2csv` and commits the result into `mosip_master_csv/csv/` on the PR branch. Requires the `ACTION_PAT` secret.
+
+To trigger manually: GitHub → Actions → "xlsx-to-csv" → Run workflow.
+
+### push-trigger (`.github/workflows/push-trigger.yml`)
+Validates the full data load pipeline end-to-end:
+1. Spins up PostgreSQL 16 in Docker
+2. Runs `mosipdev/postgres-init:develop` to create the `mosip_master` schema
+3. Runs `mosipdev/masterdata-loader:develop` to load CSV data from this repo
+4. Checks for loader errors
+
+This is the closest thing to a "test" for this repo. A passing run confirms the data is loadable.
+
+## Data Entities
+
+The master data covers:
+
+| Domain | Key files |
+|---|---|
+| Identity | `identity_schema`, `ui_spec`, `dynamic_field` |
+| Templates | `template`, `template_type` |
+| Devices | `device_master`, `device_spec`, `device_type` |
+| Machines | `machine_master`, `machine_spec`, `machine_type` |
+| Locations | `location`, `loc_hierarchy_list`, `zone`, `zone_user` |
+| Registration | `registration_center`, `reg_center_type`, `reg_working_nonworking` |
+| Documents | `valid_document`, `doc_category`, `doc_type`, `applicant_valid_document` |
+| Lookup | `language`, `title`, `reason_list`, `blocklisted_words` |
+
+**`identity_schema.csv`** is the most complex file — it embeds full JSON Schema Draft-07 definitions inside CSV cells. Each row is one schema version per language (e.g. `eng, 1001, 0.1, ...`). Schema ID 1001 = standard identity; 1002 = Mosip Identity for handle.
+
+## Data Upgrade Scripts
+
+`mosip_master/data_upgrade/` contains **delta** migrations (not full datasets) between MOSIP versions:
+
+- `1.1.5.5_to_1.2.0.1/` — Dynamic field format changed (array → object per language); UI spec split into separate table; new machine/template types
+- `1.2.0.1_to_1.3.0/` — Template additions and updates only
+
+**To run an upgrade:**
+```bash
+cd mosip_master/data_upgrade/<version>/
+cp upgrade.properties upgrade.local.properties
+# Fill in DB_SERVERIP, SU_USER_PWD, UPGRADE_DOMAIN_NAME, admin creds, language codes
+bash upgrade.sh upgrade.local.properties
+```
+
+The Python helper scripts (`data-uploader.py`, `migration-ui_spec.py`, `migration-dynamicfield.py`) authenticate against the MOSIP Admin API and/or connect directly to PostgreSQL. They are invoked by `upgrade.sh` via `upgrade_commands.txt`.
+
+## Masterdata Reference
+
+Full field definitions and valid values: https://docs.mosip.io/1.2.0/id-lifecycle-management/support-systems/administration/masterdata-guide

README.md

@@ -1,7 +1,18 @@
 # Sample Data
 
 ## Overview
-This repo contains data that is uploaded into MOSIP during [sandbox installation](https://docs.mosip.io/1.2.0/deployment/sandbox-deployment). The data needs to be reviewed and modified for a country specific deployment. Refer to [Masterdata Guide](https://docs.mosip.io/1.2.0/deployment/masterdata-guide). 
+This repo contains data that is uploaded into MOSIP during [sandbox installation](https://docs.mosip.io/1.2.0/setup/deploymentnew/getting-started#mosip-installations). The data needs to be reviewed and modified for a country specific deployment. Refer to [Masterdata Guide](https://docs.mosip.io/1.2.0/id-lifecycle-management/support-systems/administration/masterdata-guide). 
+
+## For Build and Run
+Data initialization is performed through the **Master Data Loader** as part of the [postgres-init](https://github.com/mosip/postgres-init/tree/release-1.3.x) repository.
+
+## Contribution & Community
+
+• To learn how you can contribute code to this application, [click here](https://docs.mosip.io/1.2.0/community/code-contributions).
+
+• If you have questions or encounter issues, visit the [MOSIP Community](https://community.mosip.io/) for support.
+
+• For any GitHub issues: [Report here](https://github.com/mosip/mosip-data/issues)
 
 ## License
 This project is licensed under the terms of [Mozilla Public License 2.0](LICENSE).

THIRD-PARTY-NOTICES.txt

@@ -0,0 +1,19 @@
+THIRD-PARTY-NOTICES
+
+This project includes third-party packages that are distributed under various open-source licenses. Below is a list of packages and their associated licenses.
+
+================================================================================
+Package: actions/checkout
+Version: 2.*.*
+License: MIT License
+Homepage: https://github.com/actions/checkout
+================================================================================
+
+================================================================================
+Package: PostgreSQL (Docker Official Image)
+Version: 16
+License: PostgreSQL License
+Homepage: https://hub.docker.com/_/postgres
+================================================================================
+
+Full license texts and additional details for each of the above packages are available in the license/ directory of this repository. Please refer to those files or the original source of each package for complete legal terms and conditions.