🏛️ NDIS Integration Module

This module connects RABS to the Australian National Disability Insurance Scheme (NDIS) ecosystem.
It automates claims, maintains price-guide compliance, tracks participant spending, and produces mandatory reports.

---

1. Scope & Objectives

Objective	Outcome
Bulk-upload service bookings & claims	Generate CSV/XLSX batches ready for NDIS or Xero import.
Real-time spend tracking for participants	Account pages display budget vs spend vs forecast.
Continuous compliance monitoring	Scrape official NDIS price guides; raise diffs for review.
Document generation	Auto-fill Incident / Change-of-Circumstance forms from schedule or event triggers.
Audit-ready history	Immutable ledger of every claim, correction, and price-guide version used.

---

2. High-Level Architecture

               RABS Core DB
                      ▲
                      │ REST / RPC
   ┌───────────────────┴───────────────────┐
   │            NDIS Service              │───►  SFTP / Portal Upload (CSV/XLSX)
   └────────────────────────────────────────┘
                      ▲
                      │ (web-scrape / RSS)
   ┌───────────────────┴───────────────────┐
   │            ComplianceBot             │───► internalmonologue (PRICE_GUIDE_UPDATE)
   └────────────────────────────────────────┘

Front-end: Spend Dash → /ndis/accounts/:id

---

3. Data Model (PostgreSQL)

Table	Purpose	Key Columns
ndis_price_guides	Snapshot of the official Support Catalogue	id, version, effective_from, item_code, description, unit_price, vector
ndis_claim_batches	Header rows for bulk uploads	id, period_start, period_end, status, file_path, guid_version
ndis_claim_lines	Individual booking lines within a batch	id, batch_id, participant_id, service_date, item_code, units, claim_amt
ndis_participant_ledger	Running spend & budget per participant	id, participant_id, budget_total, budget_spent, forecast_remaining
ndis_compliance_events	Price-guide diffs & document-gen triggers	id, event_type, payload_json, vector, created_at

Notes:

• ndis_price_guides.description is embedded (vector) for fast fuzzy lookup by the LLM.
• ndis_context_bucket stores recurring claim errors to prevent repeat mistakes.

---

4. API Endpoints

Method & Path	Purpose	Auth Scope
POST /ndis/batch/build	Assemble a claim batch for a given period.	ndis:write
GET /ndis/batch/:id/download	Download the generated CSV/XLSX file.	ndis:read
GET /ndis/participants/:id/ledger	Data for budget vs spend dashboard.	ndis:read + owner

---

5. Key Workflows

1. Bulk Upload – Nightly job queries bookings, validates against current price guide, creates batch file, marks status READY. Operator uploads to portal and marks SUBMITTED via API.
2. Price-Guide Sync – ComplianceBot scrapes the official NDIS site daily. On change, it inserts the new guide into ndis_price_guides and emits a PRICE_GUIDE_UPDATE event.
3. Document Generation – Event-driven service auto-fills official PDF templates (e.g., Change of Circumstance) and stores them in the document store.

---

🔗 Related Docs

• ../../02_Brainframe_Cognitive_Architechture/02_Reasoning_&_Memory/04_Context_Buckets_Lessons_Learned.md
• ../../02_Brainframe_Cognitive_Architechture/03_LLM_&_Prompts/01_Central_LLM_Gateway.md
• ../../02_Brainframe_Cognitive_Architechture/00_Introduction_to_the_Brainframe.md