Corporate Adventure (Flask)

Web app for an IRL “adventure” game with a simple “corporate system” theme:

• Participants register only if their name is on an imported roster (CSV/YAML)
• Login system (name + password)
• Participant dashboard shows their position and corporate credit
• Organizers (flagged in the roster) can adjust credits and a company-wide evaluation score

Setup

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Run

export SECRET_KEY='change-me'
python3 run.py

Then open http://127.0.0.1:5000.

Default admin (first run only)

On first run only when there are no users yet, the app will auto-create:

• username: admin
• password: hroch112

You can override these before first run:

export DEFAULT_ADMIN_USERNAME='admin'
export DEFAULT_ADMIN_PASSWORD='hroch112'

Database

By default the app uses SQLite at instance/app.db and creates tables on startup.

You can override:

export DATABASE_URL='sqlite:////absolute/path/to/app.db'

Roster import format

CSV headers:

• name (required)
• role (participant or organizer, default participant)
• position (optional)
• initial_credit (optional integer)

YAML: list of objects with the same keys.

Smoke test checklist

1. Start the app (python3 run.py) and open http://127.0.0.1:5000.\n
2. Create an organizer in the roster:\n
   • Go to /register (it should fail until a roster is imported).\n
   • Temporarily import a roster as an organizer by preloading a roster entry directly in SQLite, or (recommended) first add a roster import file and use an organizer account.\n
   • Easiest path for a first run: create instance/app.db and insert a roster entry for yourself, then register and set your role to organizer, then use the UI.\n
3. In Admin → Import roster, upload a file like:\n
   • CSV:\n

     name,role,position,initial_credit\n
     Alice Example,organizer,HR Lead,10\n
     Bob Example,participant,Engineer,0\n
     ```\n
     

4. Register users:\n
   • /register with a roster name should succeed.\n
   • /register with a non-roster name should be rejected.\n
5. Organizer actions:\n
   • /admin/adjust-credit changes credit and adds a ledger entry.\n
   • /admin/company changes evaluation and adds a ledger entry.\n
6. Participant dashboard:\n
   • /dashboard shows credit + company evaluation.