# BreakPilot – Projektstruktur (Stand: lokal, Dezember 2025)

## Root-Verzeichnis (~/Projekte/arbeitsblatt-app/backend)

- `main.py`  
  FastAPI-Backend mit den API-Routen (Upload, Analyse, Pipeline etc.).  
  Dieses Backend wird unter `/api` in die Frontend-App eingehängt.

- `ai_processor.py`  
  Logik für die Kommunikation mit der KI (OpenAI), Verarbeitung der Arbeitsblätter usw.

- `learning_units.py`  
  Interne Datenstrukturen / Logik für Lernbausteine.

- `learning_units_api.py`  
  (Optional) API-Endpunkte rund um Lernbausteine; kann später ebenfalls als Router eingebunden werden.

- `original_service.py`  
  Historische/ursprüngliche Service-Logik; dient als Referenz und Backup.

- `frontend/`  
  Paket mit allen Frontend-Routen und der HTML-Oberfläche (siehe unten).

- `tools/`  
  Hilfsskripte, z. B. zum Extrahieren der alten /app-HTML in das neue Frontend-Modul.

- `venv/`  
  Virtuelle Python-Umgebung für dieses Projekt.

---

## Ordner `frontend/`

- `__init__.py`  
  Markiert den Ordner als Python-Paket.

- `app.py`  
  Zentrale FastAPI-App für **Frontend + Backend-Kombination**.  
  - Mountet das Backend aus `main.py` unter `/api`  
  - Include der Frontend-Router (`home`, `preview`, `studio`)

  Startbefehl für die gesamte App:
  ```bash
  cd ~/Projekte/arbeitsblatt-app/backend
  source venv/bin/activate
  uvicorn frontend.app:app --reload