diff --git a/NOTES.md b/NOTES.md
new file mode 100644
index 0000000..65cf242
--- /dev/null
+++ b/NOTES.md
@@ -0,0 +1,58 @@
+# Projekt-Notizen – Arzt-Termine
+
+## Umstellung auf Next.js (Juli 2026)
+
+Das Projekt wurde vom getrennten **React/Vite-Frontend + Express/MongoDB-Backend**
+auf eine **einzelne Next.js-App** (App Router) umgestellt. Design und Layout sind
+bewusst an das Projekt `../werte-next` angelehnt.
+
+### Was gemacht wurde
+
+- **Architektur:** Next.js 16 (App Router), React 19, Tailwind 4, TypeScript.
+  - UI: Client-Komponenten in `components/` (`TabLayout`, `AppointmentForm`,
+    `AppointmentList`, `ConfirmationModal`), Seiten in `app/`.
+  - API: Next.js Route Handler unter `app/api/appointments` (GET/POST/PUT/DELETE,
+    Soft-Delete via `deleted`-Flag).
+  - DB: MongoDB-Zugriff in `lib/db.ts` (gecachter Client, DB `appointmentsdb`,
+    Collection `appointments`).
+  - Kein Login/Auth (wie zuvor, bewusst so).
+- **Design von werte-next übernommen:** Rahmenbox, Farben #CCCCFF/#85B7D7/#FFFFDD,
+  Tabellen-Liste, Footer mit Version/Datum.
+- **Tabs:**
+  - **Termine** (`/`): Formular + Liste **nur offener** Termine.
+  - **Liste** (`/liste`): **alle** Termine, Checkbox aktiv (erledigt umschaltbar).
+- **Darstellung erledigter Termine:** blassere Textfarbe (kein Durchstreichen),
+  ans Ende sortiert.
+- **Eingabeformular** auf 60 % Breite reduziert, zentriert.
+- Spalten **Arzt / Fachrichtung / Bemerkungen** linksbündig.
+- **Druckansicht** der aktuellen offenen Termine ab heute beibehalten.
+- Altes `frontend/`- und `backend/`-Verzeichnis entfernt; Vite-Überbleibsel
+  `public/vite.svg` gelöscht.
+
+### Git
+
+- Umgesetzt auf Branch `use_next`, per Fast-Forward nach `main` gemergt und
+  gepusht (Remote: gitea.fuerst-stuttgart.de/admin/aerzte). Branch danach gelöscht.
+- Security-Review durchgeführt: keine relevanten Schwachstellen.
+
+## Deployment
+
+- Image bauen & pushen: `./deploy.sh [tag]`
+  → `docker.citysensor.de/aerzte-next`
+- Auf dem Server (Dockge): `docker compose -f docker-compose.prod.yml up -d`
+- **Wichtig – Datenerhalt:** Beim Umstieg vom alten auf den neuen Stack den
+  **gleichen Dockge-Stack-Namen `aerzte`** beibehalten. Dann werden die benannten
+  Volumes (`aerzte_mongodb_data` / `aerzte_mongodb_config`) automatisch
+  wiederverwendet und die MongoDB-Daten bleiben erhalten.
+  Nur `docker compose down` **ohne** `-v` verwenden. (Hat funktioniert.)
+- Bei zwingend neuem Stack-Namen: alte Volumes als `external` mit altem Namen
+  einbinden.
+
+## Umgebungsvariablen
+
+| Variable            | Beschreibung                                  |
+| ------------------- | --------------------------------------------- |
+| `MONGO_URI`         | MongoDB-Verbindung inkl. Datenbankname        |
+| `MONGO_ROOT_USER`   | Root-User für den MongoDB-Container (Compose) |
+| `MONGO_ROOT_PASSWD` | Root-Passwort für den MongoDB-Container        |
+| `APP_PORT`          | Host-Port der App (Standard: 3000)            |