Rawabit

Future generations accounting, policy impact, trust framework, and long-term governance sandbox.

GOVERNANCE SANDBOX — NOT LEGAL, FINANCIAL, OR INVESTMENT ADVICE

Rawabit is a runnable, safety-bounded reference MVP for future generations governance. It uses fictional or synthetic demo data only and keeps regulated integrations behind documented adapter boundaries.

Architecture

flowchart LR
  Portal[futures-portal] --> API[Node HTTP API]
  API --> Core[packages/core deterministic domain engine]
  Core --> Seed[data/samples synthetic fixtures]
  API --> Contracts[OpenAPI 3.1 + JSON Schemas]
  Core -. future adapter .-> Postgres[(PostgreSQL)]
  Core -. future adapter .-> MinIO[(MinIO)]

Loading

MVP features

• Future Generations Index dashboard
• Natural, fiscal, human, and social capital accounts
• Policy proposal intake and Future Impact Statement generation
• Citizens' assembly workflow and public response tracker
• Model law/template library and future bond sandbox calculator

Prerequisites

Tool	Version	Required for
Node.js	20+	API, tests, static portal
npm	bundled with Node	script runner
Docker Compose	v2+	optional service topology validation
GitHub CLI	latest	optional publication and roadmap issues

One-command local setup

npm run verify && npm start

Open http://localhost:4174. The local API also serves /openapi.json.

Environment

Copy .env.example if you want to override defaults.

Variable	Default	Purpose
PORT	4174	Local API and portal port
APP_ENV	development	Runtime mode label
DATA_MODE	synthetic	Documents the demo-data boundary

Demo data

Seed data lives in data/samples/seed.json. It is fictional or synthetic and intentionally small enough for tests and code review.

API examples

curl http://localhost:4174/health
curl http://localhost:4174/v1/indicators

Route	Purpose
GET /v1/indicators	List fictional future indicators
POST /v1/policies	Create policy proposal
POST /v1/policies/:id/impact-run	Run future impact model
GET /v1/impact-runs/:id	Get impact run
POST /v1/assemblies	Create citizens' assembly
POST /v1/assemblies/:id/recommendations	Create assembly recommendation
GET /v1/templates	List educational legal templates
POST /v1/bond-scenarios/sandbox	Run future bond sandbox calculator
GET /v1/audit/events	List audit events

Verification

npm run lint
npm run build
npm test
npm run verify

Privacy, safety, and compliance limits

• No legally binding trust creation, securities, debt offerings, investment products, or sovereign fund controls.
• Legal templates are educational examples requiring professional legal, financial, actuarial, climate, and public-sector review.
• Long-term projections are scenario illustrations, not forecasts or public finance advice.

Read NOT_FOR_PRODUCTION.md, docs/safety-boundaries.md, and docs/security-privacy.md before extending this MVP.

Arabic quick start

Arabic setup notes are in docs/ar/QUICKSTART.md.

Roadmap

• Add UN SEEA-style natural capital importer
• Build climate scenario adapter
• Peer-review Future Generations Index methodology
• Integrate citizens' assembly workflow with Shura
• Draft future bond sandbox limitation note

Contributing

See CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md.

License

Apache-2.0. See LICENSE.