AEDIS — Interactive Transparency Simulation

A demonstration of how a transparency-first public-spending system could work. This is a simulation / prototype, not a live government or financial system.

Run it (zero database setup — uses SQLite)

python -m venv venv
venv\Scripts\activate          # Windows
# source venv/bin/activate     # Mac/Linux
pip install -r requirements.txt
python app.py

Then open these in a browser:

• http://localhost:5000/ Steward console (run a region: allocate, solicit bids, accept/reject, tick, audit)
• http://localhost:5000/portal Public Transparency Portal (National / By State / Global / Flagged Cases)
• http://localhost:5000/reserve Central Bank Reserve portal (needs-index credit model, absorption ceiling)
• http://localhost:5000/case Why this matters — real cited fraud cases (Feeding Our Future, HHS freeze)

All four are linked from each other's headers.

Verify everything works

Run any of the test files (each spins up the app against a throwaway SQLite db and asserts on real behavior):

python smoke_test.py                 # core game loop
python registry_test.py              # licensing eligibility logic
python licensing_flow_test.py        # bid solicit/review/accept/reject flow
python dashboard_contract_test.py    # dashboard API contract
python portal_test.py                # public portal API
python world_test.py                 # 50-state generation + global view
python case_test.py                  # /case page content + on-message check
python reserve_test.py               # central-bank credit model + API

File map

Backend / data:

• app.py Flask app: all routes + API endpoints
• models.py SQLAlchemy models (DO NOT DELETE — code, not data)
• extensions.py Shared db instance
• aedis_registry.py Company registry + licensing eligibility (WA slice)
• aedis_public_world.py Hand-authored seeded jobs (incl. the real-style scams)
• aedis_world_gen.py Procedural fill for all 50 states + global country roster
• aedis_reserve.py Central-bank needs-index credit model

Frontend (static/):

• index.html Steward console
• portal.html Public transparency portal
• reserve.html Central bank reserve portal
• case.html Real-cases / why-AEDIS page

Notes

• The instance/ folder holds the SQLite database; delete it to reset data. (Not needed between normal runs.)
• venv/ is the virtual environment; keep it to avoid reinstalling.
• All figures in the portal/reserve screens are illustrative. The reserve model shows a proposed design with visible inflation/absorption guardrails — it does not claim money creation has no effect on a currency.