30 lines
1.4 KiB
Markdown
30 lines
1.4 KiB
Markdown
# AidMesh: Federated, Privacy-Preserving Disaster Response Orchestrator
|
||
|
||
Overview
|
||
- AidMesh provides a privacy-preserving, offline-first orchestration framework for disaster relief planning across partner organizations. It models core primitives as a Graph-of-Contracts (GoC) with:
|
||
- Objects: LocalProblems (per-site relief tasks)
|
||
- Morphisms: SharedSignals and DualVariables
|
||
- PlanDelta: cryptographically-tagged actions
|
||
- AuditLog / PrivacyBudget: provenance and privacy controls
|
||
- Time rounds: delta-sync cadence for islanded operation and deterministic replay
|
||
|
||
Delivery Goal
|
||
- A production-ready skeleton with a small, testable core ensuring end-to-end delta-sync between partners over TLS-like channels, plus a toy ADMM-lite solver for cross-organization optimization.
|
||
|
||
What’s included
|
||
- Core data models (dataclasses)
|
||
- Lightweight ADMM-lite solver
|
||
- Toy adapters for onboarding (SupplyDepotController, FieldDistributionPlanner)
|
||
- Basic tests and packaging metadata (pyproject.toml)
|
||
- test.sh that runs pytest and builds the package
|
||
|
||
How to use
|
||
- Run tests: ./test.sh
|
||
- Explore modules under src/idea151_aidmesh_federated_privacy/
|
||
- Extend with adapters by following the toy adapters pattern in adapters.py
|
||
|
||
Contribution
|
||
- See AGENTS.md for architectural details and contribution guidelines.
|
||
|
||
Note: This repository is intended as a production-ready, testable chunk that can be extended by subsequent teams in the SWARM.
|