Entwickler

Einstieg für PXL-Entwickler und Contributors am Repository iamsaad82/GutachtenOS.

Stack

Komponente	Technologie
App	Next.js 16 (App Router), React 19, TypeScript
Styling	Tailwind 4, Design-Tokens in src/styles/tokens.css
DB / Auth	Supabase (Shared Postgres, Schema gutachtenos), eigenes GoTrue
Hosting Prod	Coolify auf PXL App-VPS, Image via GHCR
Docs Site	VitePress (dieses Site), getrennt deploybar

Repository-Layout

src/
  app/           # Next.js Routes
  features/      # Feature-Module (actions, components, lib)
  core/          # Types, Constants, Utils
  components/    # Shared UI
  services/      # Supabase, APIs
docs/            # Single Source of Truth (Markdown)
docs-site/       # VitePress Build
supabase/migrations/
scripts/         # Verify, Cron, Pilot-Prep
.cursor/rules/   # Agent-Regeln (nicht auf Docs-Site)

Wichtige Dokumente

Thema	Link
Architektur	architektur.md
Projektablauf & Release	projektablauf.md
Datenmodell	db_structure.md
Tasks & Changelog	project_specs.md
Auth	entwickler/auth.md · vollständig auth.md
Design-System	design-system.md (GitHub-Links auf Site)
Agent / KI	maschine/AGENTS.md

Lokale Entwicklung

npm install
cp .env.example .env.local   # Werte aus Team-Vault
npm run dev                    # http://localhost:3000
npm run type-check
npm run build                  # next build --webpack

Docs Site lokal

cd docs-site && npm install && npm run dev   # http://localhost:5173

Konventionen

• Deutsch in UI und Doku
• Server Actions für Mutationen, RLS + tenant_id Pflicht
• Kein Commit von Secrets — siehe .cursor/rules/gutachtenos-core.mdc
• Feature-Delivery: Code + project_specs.md + ggf. pflichtenheft + Migration → db_structure.md