edge-latency-aware-cross-ve.../README.md

28 lines
1.6 KiB
Markdown

# ELAC-Plan (Edge-Latency Aware Cross-Venue Execution Planner)
This repository implements a production-oriented MVP of ELAC-Plan: an edge-native federation for cross-venue execution planning with privacy-preserving signals and deterministic delta-sync.
- Primitives map to canonical primitives used across adapters:
- Objects: LocalProblem
- Morphisms: SharedVariables
- DualVariables: DualVariables
- PlanDelta: PlanDelta
- Governance/AuditLog: GovernanceAuditLog (stubbed for now)
- MVP adapters:
- NBBOFeedAdapter: translates NBBO-like feeds into SharedVariables
- BrokerGatewayAdapter: simulates broker API publishing of PlanDelta
- Solver: LocalSolver (toy solver)
- API: FastAPI app exposing /problems and /status to drive LocalProblem -> PlanDelta flow
- Packaging: Python packaging metadata in pyproject.toml; tests with pytest; build via python -m build
How to run (dev):
- Run tests: ./test.sh
- Run API locally (example): uvicorn elac_plan.api:app --reload
This is a minimal but production-conscious MVP intended to be extended by adding governance ledger, secure aggregation, and real adapters in subsequent iterations.
Interop and roadmap
- See docs/elac_plan_interop.md for a minimal DSL sketch and EnergiBridge-style interoperability planning (LocalProblem/SharedVariables/PlanDelta/DualVariables/AuditLog).
- The MVP already includes two adapters (NBBOFeedAdapter and BrokerGatewayAdapter) and a toy LocalSolver for end-to-end delta-sync.
- The plan includes phases for governance, secure aggregation, cross-venue demos, and HIL testing; reference SDK and sample DSL are provided for integration with other domains.