AI-assisted timetable generator built with Next.js + React + TypeScript, with local Coder/Reviewer loop and Python execution bridge.
- App entry:
src/app/page.tsx - Layout + global styles:
src/app/layout.tsx,src/app/globals.css - Main feature UI:
src/features/timetable/TimetableApp.tsx
- Provider connectivity test:
POST /api/provider/test - Server-side LLM chat proxy:
POST /api/ai/chat
- User configures provider in UI (
SettingsModal). - Orchestrator runs in browser (
runLocalAgent). - Coder and Reviewer call LLM through server route (
/api/ai/chat). - Generated Python is executed through bridge (
executeGeneratedCode). - Result is rendered as timetable table and exported to Excel in UI (
handleDownloadExcel).
- Reviewer reject is enforced and retried with bounded rounds in
runLocalAgent. - Browser-side fake execution stub has been removed; if IPC is missing, bridge throws explicit error in
python-bridge.ts.
- Install:
npm install - Dev:
npm run dev - Build:
npm run build - Lint:
npm run lint
- Do not commit real secrets from
.env*. - Keep provider/API keys out of source files and docs.