Initial TicketTracker release

README.md

@@ -0,0 +1,101 @@
+# TicketTracker
+
+WebApp zum Erfassen von Ticket-Sessions mit Pausen, Minutenrundung und monatlichem Abschlussprozess.
+Sessions können in Monats- und Tagesansichten ausgewertet, bewertet, geschlossen, wieder geöffnet und gelöscht werden.
+
+## Dokumentation
+
+- [Benutzeranleitung](docs/user-guide.md)
+- [Docker Release / Gitea Deployment](docs/docker-release.md)
+
+## Stack
+
+- Frontend: Next.js + React + shadcn/ui + Tailwind CSS
+- Backend: Node.js + Express + TypeScript
+- Datenbank: PostgreSQL 17, wahlweise extern via `DATABASE_URL` oder als Container im Docker-Stack
+- Deployment: ein Docker-Container, Backend serviert das gebaute Frontend
+
+shadcn/ui liefert kopierbare, lokal versionierte React-Komponenten auf Basis von Tailwind CSS. Die App nutzt ein eigenes Dark-Mode-Theme mit responsiven Layouts für Desktop und Mobile.
+
+## Lokal starten
+
+Als einzelner lokaler Server auf Port `3910`:
+
+```bash
+npm install
+export DATABASE_URL='postgresql://user:pass@localhost:5432/tickettracker'
+export ADMIN_USERNAME='admin'
+export ADMIN_PASSWORD='ein-sicheres-passwort'
+npm run serve:local
+```
+
+Danach ist die App unter `http://localhost:3910` erreichbar.
+
+Beim ersten Start wird automatisch ein Admin angelegt, wenn noch keine Benutzer existieren. Ohne `ADMIN_PASSWORD` wird `admin/admin` verwendet; das ist nur als Notfall-Fallback gedacht.
+
+Für die getrennte Entwicklung:
+
+```bash
+npm install
+export DATABASE_URL='postgresql://user:pass@localhost:5432/tickettracker'
+PORT=3001 npm run dev:backend
+API_PROXY_TARGET=http://127.0.0.1:3001 PORT=3910 npm run dev:frontend
+```
+
+Frontend: `http://localhost:3910`
+Backend/API: `http://localhost:3001`
+
+## Docker
+
+Externe PostgreSQL-Datenbank:
+
+```bash
+docker build -t tickettracker:local .
+docker run --rm -p 3910:3000 \
+  -e DATABASE_URL='postgresql://user:pass@host:5432/tickettracker' \
+  tickettracker:local
+```
+
+Compose mit externer Datenbank:
+
+```bash
+cp .env.docker-external.example .env.docker-external
+docker compose --env-file .env.docker-external -f compose.yml up -d
+```
+
+Compose mit PostgreSQL 17 im Stack:
+
+```bash
+cp .env.docker-postgres.example .env.docker-postgres
+docker compose --env-file .env.docker-postgres -f compose.postgres.yml up -d
+```
+
+## Gitea Container Registry
+
+Vor dem ersten Push einmal anmelden:
+
+```bash
+docker login git.d-razz.de
+```
+
+Dann Image bauen und pushen:
+
+```bash
+chmod +x scripts/build-and-push-gitea.sh
+./scripts/build-and-push-gitea.sh
+```
+
+Auf dem Docker-Server:
+
+```bash
+docker compose --env-file .env.docker-external -f compose.yml up -d
+```
+
+Wenn noch kein Gitea-Repository existiert, erst in Gitea `michael/tickettracker` leer anlegen und danach:
+
+```bash
+chmod +x scripts/init-gitea-repo.sh
+./scripts/init-gitea-repo.sh
+git branch -M main
+git push -u origin main
+```