From 5fdb47b817de06f0445fcaa3f2aff7ec6542085a Mon Sep 17 00:00:00 2001 From: "June A." <40224657+fuguswarm@users.noreply.github.com> Date: Wed, 3 Dec 2025 03:31:25 +0700 Subject: [PATCH 1/9] README for Milestone 1 updates Updated README with enhanced milestone details, badge changes, and future F15 expansion. --- README.md | 212 +++++++++++++++++++++++++++++++++--------------------- 1 file changed, 131 insertions(+), 81 deletions(-) diff --git a/README.md b/README.md index e4b63a5..262b85f 100644 --- a/README.md +++ b/README.md @@ -1,99 +1,149 @@ # ๐ŸŒ‰ HashiRWA โ€” Fund 14 -### Milestone 1: Data Foundation & Validation Pipeline -![Status](https://img.shields.io/badge/Status-In%20Progress-teal?style=flat-square) -![Milestone](https://img.shields.io/badge/Milestone-1-blueviolet?style=flat-square) -![Fund](https://img.shields.io/badge/Catalyst-Fund%2014-red?style=flat-square) -![Track](https://img.shields.io/badge/Track-RWA-orange?style=flat-square) -![Language](https://img.shields.io/badge/Language-Python-yellow?style=flat-square) +## Milestone 1: Data Foundation & Validation Pipeline -> **Future Notice:** -> HashiRWA is currently being delivered under **Fund 14**. -> A future **Fund 15** expansion will build on this dataset with product-level metadata, tokenization pathways, and oracle integration. A dedicated F15 section will be added once Fund 14 milestones are completed. +![Status](https://img.shields.io/badge/Status-In%20Progress-blue) +![Milestone](https://img.shields.io/badge/Milestone-1-purple) +![Catalyst](https://img.shields.io/badge/Catalyst-Fund%2014-orange) +![Track](https://img.shields.io/badge/Track-RWA-yellow) +![Language](https://img.shields.io/badge/Language-Python-green) -## Overview +--- + +## ๐Ÿ“Œ Future Notice + +HashiRWA is currently being delivered under **Fund 14**. +A future **Fund 15** expansion will build on this dataset with product-level metadata, tokenization pathways, and oracle integration. +A dedicated F15 section will be added once Fund 14 milestones are completed. + +--- + +## ๐Ÿ“˜ Overview This repository contains **Milestone 1 of HashiRWA**, funded under **Project Catalyst โ€” Fund 14 (RWA Track)**. -The milestone establishes the initial data foundation needed to onboard issuers, validate collected information, and prepare for future enrichment and on-chain compatibility. +Milestone 1 establishes the initial data foundation required to onboard Japanese agricultural producers, validate collected information, and prepare for future enrichment and on-chain compatibility. Milestone 1 delivers: -- a clean and standardized `issuers.csv` dataset -- a validation tool for quality assurance -- photo evidence for issuer verification -- directory structure for future datasets -- schema designed to align with upcoming CIP-68 metadata work - -This forms the base layer for all later development phases. - -## 1. Data Schema (`issuers.csv`) - -The schema used in Fund 14 Milestone 1 includes the following fields: - -| Column | Description | -|---------------------------|---------------------------------------------------------------------| -| **issuer_id** | Unique ID for each issuer | -| **company_name** | Company or producer name | -| **brand_or_product_line** | Brand or product line | -| **product_name** | Name of the showcased product | -| **category** | Product category (e.g., Tea, Sake, Snacks) | -| **certifications** | Certifications held | -| **cert_ids_or_details** | Certification numbers or details | -| **prefecture_or_region** | Japanese prefecture or region | -| **booth** | Expo booth number | -| **website** | Official website | -| **event** | Event where the data was collected | -| **collector** | Sapient team data collector | -| **program** | Program type (e.g., pilot) | -| **nda_required** | yes / no | -| **status** | pending / verified / active / inactive / rejected / archived | -| **evidence_url** | Optional URL to supporting documents | -| **photo_proof_url** | Photo proof taken at the expo | -| **collected_date** | ISO date (YYYY-MM-DD) | -| **visibility** | public / private / hidden | -| **notes** | Additional comments | - -This schema supports clean ingestion, structured sorting, and future RWA metadata mapping. - -## 2. Validation Tool (`validate_issuers.py`) - -A custom Python validation script ensures consistency and data quality across all `issuers.csv` entries. + +- โœ”๏ธ A clean and standardized **issuers.csv** dataset +- โœ”๏ธ A Python-based **validation tool** for issuer metadata +- โœ”๏ธ Photo evidence for issuer verification +- โœ”๏ธ Directory structure for future datasets +- โœ”๏ธ A schema aligned with emerging metadata standards (CIP-68/CIP-113) +- โœ”๏ธ Base preparation for producer onboarding workflows + +This forms the data backbone for all later development phases. + +--- + +## ๐Ÿ“ Repository Structure +hashirwa/ +โ”œโ”€โ”€ data/ # issuer dataset (issuers.csv) +โ”œโ”€โ”€ proof/ # photo evidence for verification +โ”œโ”€โ”€ scripts/ # validation tool (validate_issuers.py) +โ”œโ”€โ”€ mockups/ # UI/UX outlines for later milestones +โ”œโ”€โ”€ docs/ # supporting reference material +โ”œโ”€โ”€ tech/ # engineering notes & strict-mode documentation +โ””โ”€โ”€ README.md + + +--- + +## ๐Ÿ“Š 1. Data Schema (`issuers.csv`) + +The dataset includes the following fields: + +| Column | Description | +|--------|-------------| +| issuer_id | Unique ID for each issuer | +| company_name | Company or producer name | +| brand_or_product_line | Brand or product line | +| product_name | Name of the showcased product | +| category | Product category (Tea, Sake, Snacks, etc.) | +| certifications | Certifications held | +| cert_ids_or_details | Certification numbers or details | +| prefecture_or_region | Japanese prefecture or region | +| booth | Expo booth number | +| website | Official website | +| event | Event where data was collected | +| collector | Sapient team data collector | +| program | Program type (e.g., pilot) | +| nda_required | yes / no | + +--- + +## ๐Ÿงช 2. Validation Tool (`validate_issuers.py`) + +A custom Python validator ensures clean and consistent metadata across all entries. ### Features - Required field checks - URL validation - ISO date formatting -- Allowed enums (`status`, `visibility`, `nda_required`) -- Duplicate issuer detection -- Whitespace and comma-handling normalization -- Optional strict mode for evidence URLs +- Enum enforcement (`status`, `visibility`, `nda_required`) +- Duplicate detection +- Whitespace & comma normalization -## Usage +> Extended developer usage (strict mode, write-fixed CSV) is documented in +> ๐Ÿ‘‰ `/tech/README.md` -### Strict mode (recommended for future milestones) -```bash -python scripts/validate_issuers.py data/issuers.csv +--- + +## ๐Ÿ–ผ๏ธ 3. Verification Photos (`/proof`) + +Folder includes: +- Booth photography +- Packaging / product photos +- Certification evidence +- Producer authenticity materials + +These support milestone verification requirements. + +--- + +## ๐Ÿงฉ 4. Mockups & UX (Foundational) + +High-level UI/UX mockups illustrating: +- Onboarding flow +- Listing details +- Admin review process + +These guide future functional milestones. + +--- + +## ๐Ÿ“Œ Evidence of Milestone Completion + +Milestone 1 evidence includes: + +1. **Dataset:** `data/issuers.csv` +2. **Validation tool:** `scripts/validate_issuers.py` +3. **Verification photos:** `/proof` +4. **Documentation:** README + `tech/README.md` +5. **Directory structure / mockups** +6. **Commit history** showing milestone progress + +*(The functional platform demo โ€” onboarding โ†’ approval โ†’ listing โ†’ metadata endpoint โ€” is delivered in a separate repository.)* + +--- + +## ๐Ÿ”ฎ Future Extension (Fund 15) + +- Product-level metadata for tokenization +- Valuation & pricing models +- Oracle integration +- Expanded issuer onboarding UI +- Marketplace testnet listing +- Full CIP-68 compatibility +- Smart contract workflows + +A dedicated F15 section will be added after Fund 14 milestones are completed. + +--- + +## ๐Ÿ“œ License + +MIT License. -python scripts/validate_issuers.py data/issuers.csv --write-fixed data/issuers_clean.csv -hashirwa/ -โ”‚ -โ”œโ”€โ”€ data/ -โ”‚ โ”œโ”€โ”€ issuers.csv -โ”‚ โ””โ”€โ”€ proof/ -โ”‚ โ”œโ”€โ”€ haranoseichahonpo.jpg -โ”‚ โ”œโ”€โ”€ miyagi-farm.jpg -โ”‚ โ”œโ”€โ”€ tomin-namazake.jpg -โ”‚ โ”œโ”€โ”€ kouzou-shuzo.jpg -โ”‚ โ”œโ”€โ”€ unique-bosai.jpg -โ”‚ โ”œโ”€โ”€ marutomo-bussan.jpg -โ”‚ โ”œโ”€โ”€ kimuraya-seafood.jpg -โ”‚ โ”œโ”€โ”€ sawarabi.jpg -โ”‚ โ”œโ”€โ”€ ako-aranami-salt.jpg -โ”‚ โ””โ”€โ”€ sankyo-foods.jpg -โ”‚ -โ”œโ”€โ”€ scripts/ -โ”‚ โ””โ”€โ”€ validate_issuers.py -โ”‚ -โ”œโ”€โ”€ README.md -โ””โ”€โ”€ LICENSE From a40a403f642384e47b9159c489b92338ccf0b213 Mon Sep 17 00:00:00 2001 From: "June A." <40224657+fuguswarm@users.noreply.github.com> Date: Wed, 3 Dec 2025 11:27:44 +0700 Subject: [PATCH 2/9] Update repository structure --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 262b85f..e96a55a 100644 --- a/README.md +++ b/README.md @@ -37,16 +37,16 @@ This forms the data backbone for all later development phases. --- ## ๐Ÿ“ Repository Structure + hashirwa/ -โ”œโ”€โ”€ data/ # issuer dataset (issuers.csv) -โ”œโ”€โ”€ proof/ # photo evidence for verification -โ”œโ”€โ”€ scripts/ # validation tool (validate_issuers.py) -โ”œโ”€โ”€ mockups/ # UI/UX outlines for later milestones -โ”œโ”€โ”€ docs/ # supporting reference material -โ”œโ”€โ”€ tech/ # engineering notes & strict-mode documentation +โ”œโ”€โ”€ data/ # issuer dataset (issuers.csv) +โ”œโ”€โ”€ proof/ # photo evidence for verification +โ”œโ”€โ”€ scripts/ # validation tool (validate_issuers.py) +โ”œโ”€โ”€ mockups/ # UI/UX outlines for later milestones +โ”œโ”€โ”€ docs/ # supporting reference material +โ”œโ”€โ”€ tech/ # engineering notes & strict-mode documentation โ””โ”€โ”€ README.md - --- ## ๐Ÿ“Š 1. Data Schema (`issuers.csv`) From 26bdd0679a827ff4641b4a253055bd5b9cf4f8d9 Mon Sep 17 00:00:00 2001 From: "June A." <40224657+fuguswarm@users.noreply.github.com> Date: Wed, 3 Dec 2025 11:29:51 +0700 Subject: [PATCH 3/9] Update README with repository structure details Added a detailed repository structure section to the README. --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index e96a55a..717e525 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,9 @@ This forms the data backbone for all later development phases. ## ๐Ÿ“ Repository Structure +### Repository Structure + +```plaintext hashirwa/ โ”œโ”€โ”€ data/ # issuer dataset (issuers.csv) โ”œโ”€โ”€ proof/ # photo evidence for verification @@ -46,6 +49,7 @@ hashirwa/ โ”œโ”€โ”€ docs/ # supporting reference material โ”œโ”€โ”€ tech/ # engineering notes & strict-mode documentation โ””โ”€โ”€ README.md +``` --- From 179b627611eb0aa4cb13a1998ca2853e3e1f5fce Mon Sep 17 00:00:00 2001 From: Thomas Wedler <11072595+Fugu18@users.noreply.github.com> Date: Thu, 4 Dec 2025 11:28:45 +0100 Subject: [PATCH 4/9] Create screenshots.md --- proof/screenshots.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 proof/screenshots.md diff --git a/proof/screenshots.md b/proof/screenshots.md new file mode 100644 index 0000000..20a8c07 --- /dev/null +++ b/proof/screenshots.md @@ -0,0 +1,24 @@ +## Proof-of-achievement M1 Screenshots + +The foundation Platform interface and backend are live as demonstrated in the video walkthrough. + +Please find below screenshots for the relevant parts as well: + +### Dashboard + +![Dashboard](https://github.com/Sapient-Predictive-Analytics/hashirwa/blob/tech/m1/proof/01_dashboard.jpg) + +### Admin Panel + +![Admin Panel](https://github.com/Sapient-Predictive-Analytics/hashirwa/blob/tech/m1/proof/02_admin_panel.jpg) + +### Database Entry + +![First entry](https://github.com/Sapient-Predictive-Analytics/hashirwa/blob/tech/m1/proof/03_database_entry.jpg) +*This screenshot shows the JSON format onboarding data for the first customer, done during the demo video. Admin panel will show all entries directly from the database* + +### Cardano Transaction Detail + +![Preprod Explorer](https://github.com/Sapient-Predictive-Analytics/hashirwa/blob/tech/m1/proof/04_mint_transaction_details.jpg) + +These UTxO, mint and on-chain metadata can be verified at https://preprod.cardanoscan.io/transaction/3ce7adb5714ca14a53dc355a0b39599e3b710fbce4150595a8e0833378b726de From 20736ca4c69b1008f38d619fe1bebf0996856a51 Mon Sep 17 00:00:00 2001 From: "June A." <40224657+fuguswarm@users.noreply.github.com> Date: Thu, 18 Dec 2025 16:15:55 +0700 Subject: [PATCH 5/9] Create .keep --- docs/milestones/.keep | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/milestones/.keep diff --git a/docs/milestones/.keep b/docs/milestones/.keep new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/docs/milestones/.keep @@ -0,0 +1 @@ + From 36eb5b045155c4e9d4ad0684b0c6dea591e1a383 Mon Sep 17 00:00:00 2001 From: "June A." <40224657+fuguswarm@users.noreply.github.com> Date: Thu, 18 Dec 2025 16:17:25 +0700 Subject: [PATCH 6/9] Create README.md --- docs/milestones/M1_completed/README.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/milestones/M1_completed/README.md diff --git a/docs/milestones/M1_completed/README.md b/docs/milestones/M1_completed/README.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/docs/milestones/M1_completed/README.md @@ -0,0 +1 @@ + From 771686bf6ff209bf8523e5275ecc4243b0b4c301 Mon Sep 17 00:00:00 2001 From: "June A." <40224657+fuguswarm@users.noreply.github.com> Date: Thu, 18 Dec 2025 16:18:28 +0700 Subject: [PATCH 7/9] Create README.md --- docs/milestones/M2_in_progress/README.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/milestones/M2_in_progress/README.md diff --git a/docs/milestones/M2_in_progress/README.md b/docs/milestones/M2_in_progress/README.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/docs/milestones/M2_in_progress/README.md @@ -0,0 +1 @@ + From c15daee5f293c1c219bff7bea2803785e27cc17f Mon Sep 17 00:00:00 2001 From: "June A." <40224657+fuguswarm@users.noreply.github.com> Date: Thu, 18 Dec 2025 16:34:51 +0700 Subject: [PATCH 8/9] Delete docs/milestone-1-report.md --- docs/milestone-1-report.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 docs/milestone-1-report.md diff --git a/docs/milestone-1-report.md b/docs/milestone-1-report.md deleted file mode 100644 index 88f18f5..0000000 --- a/docs/milestone-1-report.md +++ /dev/null @@ -1 +0,0 @@ -# Milestoneโ€‘1 Report (Draft) From 693b9ab223d0a80f553b83de31707d83f6b5a898 Mon Sep 17 00:00:00 2001 From: "June A." <40224657+fuguswarm@users.noreply.github.com> Date: Thu, 18 Dec 2025 16:37:22 +0700 Subject: [PATCH 9/9] Add README for completed Milestone 1 Document the completion of Milestone 1 for HashiRWA. --- docs/milestones/M1_completed/README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/milestones/M1_completed/README.md b/docs/milestones/M1_completed/README.md index 8b13789..145f6eb 100644 --- a/docs/milestones/M1_completed/README.md +++ b/docs/milestones/M1_completed/README.md @@ -1 +1,10 @@ +# Milestone 1 โ€“ Completed + +Milestone 1 for **HashiRWA** has been completed and approved through the Project Catalyst milestone review process. + +This milestone focused on establishing the foundational components required for subsequent development, including initial data structures, documentation, and platform readiness. + +All required deliverables, evidence, and verification materials were submitted via the Catalyst milestone portal and have been formally reviewed and approved. + +With Milestone 1 completed, the project proceeds to Milestone 2, which focuses on data integration and oracle connectivity.