This directory is reserved for the database-backed progress and authentication migration set.
The current application uses storage.py and a local JSON state file. Before public multi-user deployment:
- Introduce a repository abstraction behind
storage.py. - Use SQLite for single-instance installations and PostgreSQL for hosted deployments.
- Add migrations for users, refresh tokens, profiles, puzzle attempts, solves, and achievements.
- Make
DATABASE_URLselect the backend and run migrations as a release step, not during web requests. - Keep an export/import path from
~/.lux/state.jsonfor existing CLI users.
Do not treat the Compose PostgreSQL service as active application persistence until these migrations and repository changes land.