1.5 KiB
CrisisPulse: Federated Resource Orchestration (MVP)
This repository implements a production-grade MVP for CrisisPulse, a federated resource orchestration platform intended for disaster-relief camp networks. The MVP focuses on core primitives: local ledger with delta-sync, a contract registry (Graph-of-Contracts), adapters for domain-specific devices, a governance ledger, privacy-preserving summaries, and a testbed for cross-domain collaboration.
CrisisPulse also includes a tiny but extensible CrisisPolicy DSL (crisispolicy.py) to bootstrap interoperability across NGOs and humanitarian devices. This DSL is designed to be incrementally enhanced alongside the Graph-of-Contracts and adapters.
Structure overview:
- src/idea168_crisispulse_federated_resource/: Python package with core modules
- tests/: unit tests for core primitives
- AGENTS.md: architecture, tech stack, testing commands, and contribution rules
- test.sh: reproducible test runner that also builds the package
- READY_TO_PUBLISH: marker file indicating readiness for publish (created by intention when ready)
How to run locally:
- Install dependencies: python -m pip install -e .
- Run tests: bash test.sh
- Review README for project goals and architecture details.
This is a minimal, production-oriented MVP designed to be extended by follow-up iterations.
Documentation: See docs/CRISISPULSE_MVP_SPEC.md for a concrete MVP blueprint focused on a two-adapter (solar and water) setup and offline delta-sync workflows.