ChristophandClaude Opus 5.5
68033d7cec
Arbeitspakete mit Aufwand (≈ 24,5 PW), Kalenderplan KW 40/2026 bis KW 6/2027 für zwei Entwickler, Meilensteine M1–M4, Zulieferungen des Kunden, Risiken und Aufgabenliste (inkl. Meilisearch-Test). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
145 lines
10 KiB
Markdown
145 lines
10 KiB
Markdown
# KI-BauIN – Projekt- und Zeitplan (MVP)
|
||
|
||
Stand: 1. Oktober 2026 (KW 40). Wird nach dem Kundentermin (KW 42) zum Detailplan geschärft.
|
||
|
||
## 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 des Kunden. 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, Referenz-MKAs |
|
||
| AP3 | KI-API-Anbindung: 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 |
|
||
| 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 |
|
||
| 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. | KI-API-Client, 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 des Kunden (Soll-Termine)
|
||
|
||
| Bis | Was | Gebraucht für |
|
||
|---|---|---|
|
||
| KW 41 | Antworten auf die ★-Fragen, Termin, API-Dokumentation, Tech-Stack-Vorgaben | Detailplan, AP3 |
|
||
| KW 42 | Beispieldateien (GAEB, MKA als PDF + GAEB, Matrix-Vorlage), Kopie der relevanten Lauffenburg-Dateien | AP5, AP9 |
|
||
| KW 43 | API-Testzugang (OCR, Embedding, Reranker; LLM falls vorhanden); Entscheidung Rollenmodell, Freigabe-Variante, 2FA-Pflicht | AP1, AP3, AP8 |
|
||
| KW 46 | Staging-VM mit Zugang, Domain und Zertifikat | AP11, M2 |
|
||
| KW 47 | 10–20 abgeschlossene MKAs mit Bewertung (Referenzfälle) | AP2 Teil 2, AP12 |
|
||
| KW 48 | Kuratierte Wissensbasis (VOB, DB-Richtlinien, Standardleistungstexte, Vorlagen) | AP4, AP7 |
|
||
| KW 51 | 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 |
|
||
| Kein LLM verfügbar | 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 ausgelastet | Lange Wartezeiten | Alles asynchron; Priorität für Suchanfragen 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**
|
||
- [x] Entwicklungsumgebung (WSL2, Docker, Sail), Repo mit gitleaks-Hook
|
||
- [x] Laravel 13, Livewire 4, TallStackUI 4, Fortify (2FA, Passkeys), Spatie
|
||
- [x] Mehrsprachigkeit (Deutsch Standard, Englisch)
|
||
- [x] CLAUDE.md, Tech-Stack-Doku, Projektplan
|
||
|
||
**KW 41**
|
||
- [ ] Fragenliste an den Kunden schicken, Termin für KW 42 vereinbaren (inkl. Lauffenburg-Walkthrough)
|
||
- [ ] API-Dokumentation, Tech-Stack-Vorgaben und Beispieldateien 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.
|