generated from coulomb/repo-seed
37 lines
2.0 KiB
Markdown
37 lines
2.0 KiB
Markdown
# CLAUDE.md
|
||
|
||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||
|
||
## Project Overview
|
||
|
||
**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`.
|
||
|
||
## Planned 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.
|
||
|
||
## Domain Model — Key Concepts
|
||
|
||
The system manages **Ausschreibungen** (tenders) through 8 phases:
|
||
|
||
| Phase | Name |
|
||
|-------|------|
|
||
| 1 | Recherche & Unterlagen bereitstellen |
|
||
| 2 | Teilnahmeentscheidung treffen |
|
||
| 3 | Detaillierte Durchsicht & offene Punkte |
|
||
| 4 | Bieterfragen, Subunternehmer, offene Punkte klären |
|
||
| 5 | Preismodell dokumentieren |
|
||
| 6 | Unterlagen finalisieren |
|
||
| 7 | Abgabe |
|
||
| 8 | Zuschlag / Nachbetrachtung |
|
||
|
||
Core entities: `Ausschreibung`, `Los` (lot), `Anforderung` (requirement), `Aufgabe` (task), `Bieterfrage` (bidder question), `Dokument`, `Subunternehmer`, `Preispunkt` (price point), `Marktbegleiter` (competitor), `Nachweis` (compliance certificate), `Referenz`, `Freigabe` (approval), `Nachbetrachtung` (retrospective).
|
||
|
||
**Vergleichsgewicht** (comparison weight): price points carry a weight in [0.0, 2.0] (default 1.0). Weighted averages use `Σ(value × weight) / Σ(weight)`; points with weight 0.0 are excluded from averages entirely.
|
||
|
||
## Custodian State Hub
|
||
|
||
This repo is tracked by the Custodian State Hub. At session start inside this repo, call `get_domain_summary("<domain_slug>")` via the `state-hub` MCP tool. End every non-trivial session with `add_progress_event()`.
|