Prototype implementation

CLAUDE.md

@@ -6,11 +6,48 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 **Vergabe Teilnahme** is a web-based tender/bid management system (internal collaboration tool) that supports a company through the full lifecycle of public and private procurement bids — from initial research through post-award retrospective. The language of the application and all domain documentation is **German**.
 
-This repo is currently **pre-implementation**. The authoritative requirements are in `wiki/ProductRequirementsDocument.md`.
+The authoritative requirements are in `wiki/ProductRequirementsDocument.md`. Technical architecture in `wiki/ArchitectureBlueprint.md`. Use cases in `wiki/UseCaseCatalog.md`.
 
-## Planned Tech Stack
+## Tech Stack
 
-The .gitignore targets **Python** (Django, Flask, uv, Ruff, pytest). No framework or tooling has been selected yet — check for a `pyproject.toml`, `Pipfile`, or `requirements.txt` before assuming.
+**Django 6.x** · **uv** (package manager) · **Tailwind CSS v4** (via Vite) · **HTMX 2.x** · **Alpine.js 3.x** · **PostgreSQL 16+** (psycopg3)
+
+## Entwicklungs-Commands
+
+```bash
+make db           # PostgreSQL via Docker starten (oder infra-postgres-1 verwenden)
+make dev          # Django-Dev-Server (Port 8000)
+make css          # Tailwind CSS im Watch-Modus
+make migrate      # Migrations generieren und ausführen
+make test         # pytest ausführen
+make lint         # ruff + mypy
+uv run manage.py test vergabe_teilnahme.apps.<app>   # Einzelne App testen
+uv run pytest vergabe_teilnahme/apps/<app>/tests/    # Einzelne Testdatei
+```
+
+## Projektstruktur
+
+```
+vergabe_teilnahme/
+├── apps/           # Alle Django-Apps
+│   ├── core/       # FlexibleModel, CustomAttribute, EntityFieldConfig, Freigabe
+│   ├── accounts/   # Mitarbeiter (AbstractUser)
+│   └── ...         # je eine App pro Fachdomäne
+├── settings/       # base.py, dev.py, prod.py
+└── urls.py
+
+static/
+├── src/main.css    # Tailwind-Quelldatei (mit @layer components und @theme brand tokens)
+├── vendor/         # HTMX, Alpine.js (lokal, kein CDN)
+└── dist/           # Build-Output (gitignored)
+
+workplans/          # Ralph-Loop-Workplans (WP-0001 bis WP-0012)
+wiki/               # PRD, Blueprint, Use-Case-Katalog
+```
+
+## Shared Infrastructure Note
+
+Port 5432 is used by `infra-postgres-1` (the Custodian shared PostgreSQL container). The `vergabe_db` database and `vergabe` user are created there. `docker-compose.dev.yml` documents the intended standalone setup but is not started when infra container is active.
 
 ## Domain Model — Key Concepts