BauIN/docs/projektplan.md

KI-BauIN – Projekt- und Zeitplan (MVP)

Stand: 1. Oktober 2026 (KW 40). Wird nach dem Kundentermin (KW 42) zum Detailplan geschärft.

Beteiligte

• ITM: Anbieter der KI-API (OCR, Embeddings, Reranker, ggf. Sprachmodell), Projektleitung und abrechnende Firma.
• BauIn: Endkunde. Liefert Fachdaten (LVs, MKAs, Bewertungsmatrizen), stellt den Fachexperten und nutzt das System.
• „Kunde“ meint in diesem Dokument BauIn; wo ITM gemeint ist, steht ITM.

Rahmen und Annahmen

• Ziel des MVP: Nachtragsprüfung „dem Grunde nach“ am Pilotprojekt, von der hochgeladenen MKA bis zur exportierten Bewertungsmatrix, mit Rollen und Rechten, Protokoll und lokalem Betrieb.
• Nicht im MVP: Prüfung der Höhe nach (inkl. Mengenvergleich aus D11), DMS und E-Mail-Anbindung, Österreich, Bauzeitenplan-Analyse (siehe „Später“).
• Aufwand: rund 25 Personenwochen (PW), mit Risikopuffer 28–29 PW.
• Team (Annahme): zwei Entwickler mit KI-Unterstützung.
  • A (du): Backend, KI-Anbindung, Suche, Prüflogik
  • B (Kollege): Oberfläche mit TallStackUI, GAEB-Import, Betrieb
  • Mit nur einem Entwickler verdoppelt sich die Dauer ab Phase 2 (siehe Variante unten).
• Pause: KW 52–53 (21.12.2026 – 03.01.2027).
• Abhängigkeit: Viele Pakete brauchen Zulieferungen von ITM (KI-API) und BauIn (Fachdaten, Fachexperte). Kommen sie später als unten geplant, verschiebt sich der Plan entsprechend.

Meilensteine

	Termin	Ergebnis	Termin mit dem Kunden
M1	Ende KW 43 (23.10.)	Grundgerüst: Login/2FA, Benutzer und Rollen, Projekte und Lose, Upload, Protokoll; Detailplan steht	Demo (30 min)
M2	Ende KW 47 (20.11.)	Pilot-LVs importiert und durchsuchbar, erste ~5 Dokumente gemeinsam mit „passt / passt nicht“ bewertet; Staging beim Kunden läuft	Prüftermin (60 min)
M3	Ende KW 51 (18.12.)	Erste MKA durchgängig: Vorschläge, Feedback, Regeln, Excel-Export	Präsentation (60–90 min)
M4	Ende KW 4/2027 (29.01.)	Alle Pilot-MKAs durchlaufen, Trefferquote und Zeitersparnis gemessen; Produktion abgesichert	Abschlusspräsentation, Entscheidung über Ausbau
Puffer	KW 5–6/2027	für Verzögerungen bei Zulieferungen oder GAEB-Import	–

Laufend: wöchentlich 30 min Jour fixe mit dem Fachexperten; alle zwei Wochen eine kurze Demo (KW 43, 45, 47, 49, 51, 2, 4).

Arbeitspakete und Aufwand

AP	Inhalt	PW	Wer	Wann	Hängt ab von
AP0	Klärung, Kundentermine, Jour fixe, Dokumentation	1,0	A+B	laufend	–
AP1	Fundament: Umgebung ✓, Laravel/TallStackUI ✓, Mehrsprachigkeit ✓, CI, Datenmodell (Mandant, Land, Projekt, Los, Dokument), Rollen/Rechte mit Benutzerverwaltung, privater Upload und Download, Protokoll, Länderstruktur	4,0 (1,0 erledigt)	A+B	KW 40–43	Rollenmodell (Kunde)
AP2	Meilisearch-Test: Teil 1 mit erzeugten Vektoren, Teil 2 mit echten Vektoren und Referenzfällen	0,5	A	KW 41 / KW 46–47	Teil 2: API-Zugang (ITM), Referenz-MKAs (BauIn)
AP3	Anbindung KI-API ITM: Client für OCR, Embeddings, Reranker (+ LLM), Jobs mit Wiederholung und Status, Überwachung, ggf. Webhook-Eingang	1,5	A	KW 44–45	API-Doku und Testzugang (ITM)
AP4	Dokumentverarbeitung und Suche: OCR → Abschnitte → Embeddings → MySQL + Meilisearch, Neuaufbau des Index, hybride Suche mit Pflichtfilter für Rechte	2,0	A	KW 45–47	AP3
AP5	GAEB-Import (D86/X86): Parser, LV-Baum, Vorbemerkungen, LV-Ansicht, MKA-Import (PDF + GAEB)	2,5	B	KW 44–46	Beispieldateien
AP6	Prüfassistent Stufe 1 (ohne LLM): Vergleichspositionen mit Reranker, Prüfmaske, Feedback je Aspekt, Confidence	2,5	A+B	KW 48–49	AP4, AP5
AP7	Prüfassistent Stufe 2 (mit LLM): Prompts, strukturierte Antwort, Prüfung der Antwort, Begründung mit Quellen	2,0	A	KW 50–51	LLM-Zugang (ITM)
AP8	Regeln, Referenzfälle, einstellbare Freigaben, Versionen	2,0	B	KW 50–51	Freigabe-Variante (Kunde)
AP9	Bewertungsmatrix, MKA-Status, Freigabe durch Projektleiter, Excel-Export	1,0	B	KW 51	Matrix-Vorlage
AP10	Wissensbasis-Oberfläche, Dashboard, Benachrichtigungen, Auswertungen	1,0	B	KW 47, KW 2	–
AP11	Betrieb: Staging und Produktion (Nginx, PHP-FPM, systemd, Cron, Meilisearch), Deployment, verschlüsselte Backups, Alarmierung, Restore-Test	1,5	B	KW 46–47, KW 3	VMs, Backup-Ziel
AP12	Pilot: alle MKAs durchlaufen, messen, nachschärfen (Prompts, Gewichtung, Quantisierung)	2,0	A+B	KW 1–3/2027	Referenzfälle, Fachexperte
AP13	Design aus Claude Design als TallStackUI-Designsystem übernehmen	1,0	B	KW 42–43	Designentwurf
	Summe	≈ 24,5

Zeitplan nach Kalenderwochen (2 Entwickler)

KW	Datum	A (Backend, KI, Suche)	B (Oberfläche, Import, Betrieb)	Kunde / gemeinsam
40	28.09.–04.10.	✓ Umgebung, Grundgerüst, TallStackUI, Mehrsprachigkeit, Doku	–	–
41	05.–11.10.	Meilisearch-Test Teil 1; Datenmodell Kern	CI in Gitea Actions; Benutzerverwaltung beginnen	Fragenliste raus, Termin vereinbaren; Claude Design Durchgang 1
42	12.–18.10.	Upload, privater Speicher, Download mit Rechteprüfung, Vertraulichkeit	Rollen und Rechte, Projekt-Mitglieder; Design-Feedback	Kundentermin + Lauffenburg-Walkthrough
43	19.–25.10.	Detailplan nach Kundenantworten; Protokoll; Länderstruktur	Designsystem übernehmen (AP13)	M1 Demo
44	26.10.–01.11.	Client KI-API ITM, Jobs, Status	GAEB-Parser	–
45	02.–08.11.	Überwachung, Webhook-Eingang (falls nötig); Dokumentverarbeitung	GAEB: LV-Baum, Vorbemerkungen, LV-Ansicht	Demo
46	09.–15.11.	Embeddings → MySQL + Meilisearch; Meilisearch-Test Teil 2	MKA-Import; Staging einrichten	–
47	16.–22.11.	Hybride Suche mit Rechte-Filter, Neuaufbau des Index	Wissensbasis-Oberfläche; Staging fertig	M2 Prüftermin (erste ~5 Dokumente)
48	23.–29.11.	Vergleichspositionen + Reranker, Confidence	Prüfmaske	–
49	30.11.–06.12.	Feedback-Speicherung, Referenzfälle	Prüfmaske fertig, Feedback-Oberfläche	Demo
50	07.–13.12.	LLM-Beurteilung: Prompts, strukturierte Antwort	Regeln: Dialog, Freigaben, Einstellungen	–
51	14.–20.12.	Begründung mit Quellen, Prüfung der Antwort	Bewertungsmatrix, Excel-Export	M3 Präsentation
52–53	21.12.–03.01.	Pause	Pause	–
1	04.–10.01.	Pilot: alle MKAs durchlaufen, messen	Pilot begleiten, Fehler beheben	Fachexperte bewertet
2	11.–17.01.	Nachschärfen (Prompts, Gewichtung, Quantisierung)	Dashboard, Auswertungen, Benachrichtigungen	Demo
3	18.–24.01.	Feinschliff, Fehler	Produktion: Backups, Alarmierung, Restore-Test	–
4	25.–31.01.	Auswertung, Übergabe	Doku Betrieb	M4 Abschluss
5–6	01.–14.02.	Puffer	Puffer	–

Variante mit einem Entwickler: M1 Ende KW 44, M2 Ende KW 51, M3 Ende KW 8/2027, M4 Ende KW 13/2027 (Anfang April).

Zulieferungen von ITM und BauIn (Soll-Termine)

Bis	Von	Was	Gebraucht für
KW 41	ITM	API-Dokumentation der KI-API (OCR, Embedding, Reranker, ggf. Sprachmodell)	AP3
KW 41	BauIn, ITM	Antworten auf die ★-Fragen, Termin	Detailplan
KW 42	BauIn	Beispieldateien (GAEB, MKA als PDF + GAEB, Matrix-Vorlage), Kopie der relevanten Lauffenburg-Dateien	AP5, AP9
KW 43	ITM	Testzugang zur KI-API (OCR, Embedding, Reranker; Sprachmodell falls vorhanden)	AP3
KW 43	BauIn	Entscheidung Rollenmodell, Freigabe-Variante, 2FA-Pflicht	AP1, AP8
KW 46	klären	Staging-VM mit Zugang, Domain und Zertifikat	AP11, M2
KW 47	BauIn	10–20 abgeschlossene MKAs mit Bewertung (Referenzfälle)	AP2 Teil 2, AP12
KW 48	BauIn	Kuratierte Wissensbasis (VOB, DB-Richtlinien, Standardleistungstexte, Vorlagen)	AP4, AP7
KW 51	klären	Produktions-VM, Backup-Ziel und Aufbewahrungsdauer	AP11

Risiken

Risiko	Auswirkung	Gegenmaßnahme
Zulieferungen kommen spät	Pakete verschieben sich	Soll-Termine früh vereinbaren; vorziehen, was unabhängig ist
ITM bietet kein Sprachmodell an	AP7 entfällt vorerst	Stufe 1 (Suche + Reranker) ist allein schon nützlich; Zeit in AP8/AP10 umschichten
GAEB 90 (D86) statt XML	GAEB-Import aufwendiger	Beispieldatei früh anfordern; fertige Bibliothek prüfen
Meilisearch mit 4.096 Dimensionen zu langsam	Suche muss umgebaut werden	Test in KW 41; Plan B Qdrant
KI-API ITM ausgelastet	Lange Wartezeiten	Alles asynchron; Priorität für Suchanfragen bei ITM erfragen; Cache
Fachexperte wenig verfügbar	Kein Feedback, keine Messung	Feste Jour-fixe-Termine; Referenzfälle früh anfordern

Aufgabenliste (nächste zwei Wochen)

Erledigt

• Entwicklungsumgebung (WSL2, Docker, Sail), Repo mit gitleaks-Hook
• Laravel 13, Livewire 4, TallStackUI 4, Fortify (2FA, Passkeys), Spatie
• Mehrsprachigkeit (Deutsch Standard, Englisch)
• CLAUDE.md, Tech-Stack-Doku, Projektplan

KW 41

• Fragenliste an den Kunden schicken, Termin für KW 42 vereinbaren (inkl. Lauffenburg-Walkthrough)
• API-Dokumentation bei ITM, Beispieldateien bei BauIn anfordern
• Claude Design: Durchgang 1 (Designsystem, Layout, Prüfmaske, Regeldialog)
• Meilisearch-Test Teil 1 (erzeugte 4.096-dim. Vektoren, z. B. 50.000 Stück): Indexierungszeit, Antwortzeit mit Filtern, RAM und Platte; jeweils ohne und mit binärer Quantisierung
• Datenmodell Kern: Mandant, Land, Projekt, Los, Dokument (Kategorie, Vertraulichkeit), Mitgliedschaften
• CI in Gitea Actions: Tests, Pint, PHPStan
• Commits nach Gitea pushen

KW 42

• Kundentermin durchführen, Antworten in Plan und Doku übernehmen
• Rollen und Rechte (Spatie, ggf. Teams je Projekt), Benutzerverwaltung im Admin-Bereich
• Upload, privater Speicher, Download mit Rechteprüfung
• Design-Feedback an Claude Design, Durchgang 2

Später im Plan (bereits vorgemerkt)

• Meilisearch-Test Teil 2 (KW 46–47): Trefferquote mit echten API-Vektoren und Referenzfällen, ohne/mit binärer Quantisierung, vor und nach dem Reranker
• Push-Mirror zum Gitea des Kunden einrichten, sobald die Adresse vorliegt
• 2FA-Pflicht umsetzen, falls der Kunde das entscheidet

Später (nicht im MVP)

• Prüfung der Höhe nach, inkl. Mengen- und Preisvergleich (D11)
• Dokumentenmanagement, E-Mail-/Exchange-Anbindung
• Österreich (ÖNORM B 2110/B 2118, ÖNORM A 2063)
• Bauzeitenplan-Analyse
• Weitere Sprachen

Nebenprojekt außerhalb des Budgets

• datenschleuse (lokaler Scanner/Bereiniger, Prompt in Prompt_Datenschleuse.md): mindestens Phase 1–2 fertig, bevor echte Kundendateien mit Claude bearbeitet werden. Bis dahin gehen echte Kundendateien nicht an Claude.