Version 0.2.0 establishes the web-first foundation for AI Optimization Tool: a Vite frontend, FastAPI API, SQLAlchemy persistence, server-side sessions, owner-scoped streaming telemetry imports and analytics, and an administrator control plane.
This repository is independent from the desktop application. The first milestone intentionally delivers the platform shell and a secure end-to-end vertical slice; remaining analytics screens identify the next desktop capability to migrate instead of presenting placeholder results as real data.
Requirements: Python 3.12+, Node.js 22+, and PowerShell.
.env.example to .env and provide development values. Admin passwords must be at least 12 characters; omit them if bootstrap accounts are not needed..venv, install apps/api/requirements.txt, and run npm install.alembic upgrade head.npm run dev and open http://127.0.0.1:3000.Use npm run dev:web and npm run dev:api when separate terminals are preferable.
The API is served on port 8000 and Vite proxies /api to it. Development defaults to SQLite; production uses PostgreSQL.
Set POSTGRES_PASSWORD, a random SESSION_SECRET of at least 32 characters, explicit ALLOWED_ORIGINS, and optional ADMIN_SITH_PASSWORD / ADMIN_BEYOND_PASSWORD, then run:
docker compose up --build
Run database migrations as a release step before directing traffic to a new API version. Terminate TLS at the ingress. Production cookies are always marked Secure.
.\.venv\Scripts\python.exe -m pytest -q
npm test
npm run build
npm audit
Architecture, security, migration decisions, and operations are documented in docs/.
The telemetry schema, import state machine, limits, ownership rules, and next migration stage are documented in docs/TELEMETRY.md.
The durable worker and advanced analytics behavior are documented in docs/ADVANCED_PRODUCT.md.
PostgreSQL/SQLite topology, worker heartbeats, job leases, recovery, and scaling are documented in docs/ENTERPRISE_RUNTIME.md.