64 lines
3.0 KiB
Markdown
64 lines
3.0 KiB
Markdown
# HANDOFF — Sales Trainer
|
||
|
||
> Another AI should be able to resume without chat history.
|
||
|
||
## Branch / repo
|
||
- Repo: `~/Gitea/Sales Trainer/` (local git initialized; **no remote yet**).
|
||
- Branch: `main` (default).
|
||
|
||
## What this is
|
||
Corporate multi-user sales-training simulator. Vue SPA + Flask API + filesystem JSON storage.
|
||
Admins build persona groups from a product (form + upload); trainees chat one-shot against
|
||
generated customer personas to practice closing; judge-LLM scores + coaches.
|
||
|
||
## Current state — COMPLETE (M0–M7), prototype verified with mock LLM
|
||
All backend + frontend built. All 4 backend test suites pass. Frontend builds. Live HTTP smoke
|
||
test passes (SPA served, login, group create, register->404).
|
||
|
||
## Verified commands
|
||
```bash
|
||
# Backend tests (mock LLM, no key needed)
|
||
cd backend
|
||
uv run python scripts/test_m0.py # auth/roles/no-self-reg
|
||
uv run python scripts/test_m1.py # group create + role visibility
|
||
uv run python scripts/test_routes.py # 21 routes registered
|
||
uv run python scripts/test_e2e.py # full flow (analyze->personas->chat->debrief->one-shot->board->analytics)
|
||
|
||
# Run backend
|
||
cd backend && uv run python run.py # Flask :5001 (serves built frontend from frontend/dist)
|
||
|
||
# Frontend dev
|
||
cd frontend && npm install && npm run dev # Vite :3000 proxying /api -> :5001
|
||
# Frontend build
|
||
cd frontend && npm run build # outputs frontend/dist
|
||
```
|
||
|
||
## Default account
|
||
- super_admin: `admin` / `1234` (bootstrap). First login FORCES setting email + changing the
|
||
password (must_setup flow) before use.
|
||
|
||
## Key gotchas
|
||
1. **Do NOT invoke `.venv/bin/python <script>` directly** — the tool lifecycle guard crashes
|
||
("embedded null byte"). Always: `uv run python scripts/<name>.py`.
|
||
2. LLM creds in `.env` (backend/.env for local; root `.env` for compose). `LLM_API_KEY=replace_me`
|
||
is a placeholder → LLM is None → analyze/chat return 500 "LLM not configured".
|
||
3. SPA fallback in `app/factory._register_frontend` accepts all HTTP methods and 404s `/api/*`
|
||
so no-self-registration holds.
|
||
|
||
## Blockers / open items
|
||
- **Real-LLM E2E not yet run** (needs a live API key). This is the #1 item.
|
||
- Docker image not built locally (no Docker on this Mac). Validate on EasyPanel.
|
||
- No git remote set (Gitea).
|
||
|
||
## Exact next actions
|
||
1. Set real `LLM_PROVIDER` + `LLM_API_KEY` (and optionally base/model) in `backend/.env`.
|
||
2. Run a live smoke test: login → create group → analyze → pick persona → chat a few turns → finish → read debrief; confirm judge produces sane output (this exercises real analyzer/persona/chat/judge).
|
||
3. Fix any real-model issues surfaced (prompt drift, JSON parsing).
|
||
4. Add Gitea remote + push. Optionally wire Gitea Actions / EasyPanel deploy.
|
||
5. If EasyPanel: build from root `Dockerfile`, set env vars, map port 5001.
|
||
|
||
## Docs
|
||
- `docs/PLAN.md` — full design + all confirmed decisions & open questions.
|
||
- `docs/engineering-log.md` + `docs/engineering-log/2026-08-07-build-out.md` — milestone record.
|
||
- `README.md` — quick start, accounts, tests, LLM config.
|