Hartmut/CapaKraken
1
0
Fork 0
Code Issues 10 Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
29b0ef1044f143d5a76b388fa17272b2f8bb4113
CapaKraken/plan.md
T
Hartmut b0e55786c3 feat: AI assistant (HartBOT), demand filling, budget-per-role, project favorites, and UX improvements 
AI Assistant (HartBOT):
- Chat panel with inline layout, session persistence, message history (up-arrow recall)
- OpenAI function calling with 20+ tools (search, navigate, create/cancel allocations, update status)
- RBAC-aware tool filtering, fuzzy search with word-level matching
- Navigation actions (router.push) and data invalidation after mutations
- Country/metro city/org unit/role filtering on resource search

Demand Filling Enhancements:
- Two-phase fill modal: plan multiple resources, then confirm & assign all at once
- Availability preview per resource (available/partial/conflict days, existing bookings)
- Coverage bar showing demand hours distribution across assigned resources
- Fill demand from project detail page (new Assign button per demand)
- Fixed: filled demands no longer shown on timeline, demand bars no longer overlap

Budget per Role:
- DemandRequirement.budgetCents field (schema + API + UI)
- Project wizard step 3: budget input per role with allocation summary bar
- Project detail: allocated vs booked budget per demand
- Fill demand modal: role budget display with cost estimates
- AllocationModal: budget field for demand editing

Project Favorites:
- User.favoriteProjectIds (JSONB) with toggle API
- Star button on projects list and detail page (optimistic updates)
- "My Projects" dashboard widget (favorites + responsible person projects)

Project Management:
- Edit project from detail page (ProjectModal integration)
- Edit demands from detail page (AllocationModal integration)
- Admin-only project deletion (cascades assignments + demands)
- Create user accounts from admin panel

Timeline Fixes:
- Country multi-select filter with backend support
- URL param sync for same-page navigation (AI assistant integration)
- Demand lane stacking (no more overlapping bars)
- Single-day booking resize handles (always visible, min 6px)
- Single-day resize allowed (start === end)
- "All Clients" toggle (select all / deselect all)

Other Fixes:
- crypto.randomUUID fallback for non-secure contexts
- Chat message limit raised (200 max, client sends last 40)
- Status dropdown portal (no longer clipped by table overflow)
- Cents display restored in budget views (2 decimal places)
- Allocations grouped view with project sub-groups (collapsed by default)
- Server-side resource search for project wizard (no 500 limit)

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-03-16 15:31:48 +01:00

6.2 KiB
Raw Blame History

Plan: Budget per Role / Demand

Anforderungsanalyse

Jede Staffing-Demand (Rolle) in einem Projekt soll ein eigenes Budget bekommen. Aktuell gibt es nur ein einziges budgetCents auf Projektebene. Ziel:

  1. DemandRequirement bekommt ein budgetCents Feld (wie viel Budget ist dieser Rolle zugewiesen)
  2. StaffingRequirement (JSONB auf Project) bekommt ein optionales budgetCents Feld fuer den Wizard
  3. Project Wizard Step 3 zeigt Budget-Input pro Rolle + verbleibendes unverteiltes Projekt-Budget
  4. Project Detail Page zeigt pro Demand: zugewiesenes Budget vs. gebuchtes Budget (aus Assignments berechnet)
  5. Fill Demand Modal zeigt verbleibendes Rollen-Budget beim Zuweisen von Ressourcen

Architektur-Entscheidung

budgetCents als explizite Spalte auf DemandRequirement (nicht in metadata JSONB), weil:

  • Typsicher, indizierbar, aggregierbar via SQL
  • Konsistent mit dem Muster auf Project.budgetCents
  • Default 0 = kein Budget zugewiesen (abwaertskompatibel)

Betroffene Pakete & Dateien

Paket Dateien Art der Aenderung
packages/db prisma/schema.prisma edit — budgetCents auf DemandRequirement
packages/shared src/types/project.ts edit — budgetCents? auf StaffingRequirement
packages/shared src/types/allocation.ts edit — budgetCents auf DemandRequirementRecord
packages/shared src/schemas/allocation.schema.ts edit — budgetCents in CreateDemandRequirementSchema
packages/api src/router/allocation.ts edit — budgetCents durchreichen in create/update
packages/api src/router/project.ts edit — bei Demand-Erstellung aus Wizard budgetCents uebernehmen
apps/web src/components/projects/ProjectWizard.tsx edit — Step 3: Budget-Input pro Rolle + Restbudget-Anzeige
apps/web src/components/projects/ProjectDemandsTable.tsx edit — Spalten: Allocated Budget, Booked Budget
apps/web src/components/allocations/FillOpenDemandModal.tsx edit — Rollen-Budget-Anzeige

Task-Liste

Task 1: Prisma Schema — budgetCents auf DemandRequirement

Datei: packages/db/prisma/schema.prisma

  • budgetCents Int @default(0) auf DemandRequirement hinzufuegen
  • pnpm db:push ausfuehren (generiert Prisma Client)
  • Dev-Server neustarten (.next/ Cache loeschen)

Task 2: Shared Types aktualisieren

Dateien:

  • packages/shared/src/types/project.ts — budgetCents?: number auf StaffingRequirement
  • packages/shared/src/types/allocation.ts — budgetCents: number auf DemandRequirementRecord
  • packages/shared/src/schemas/allocation.schema.ts — budgetCents: z.number().int().min(0).default(0) in CreateDemandRequirementBaseSchema

Task 3: API — budgetCents durchreichen

Datei: packages/api/src/router/allocation.ts

  • createDemandRequirement — budgetCents aus Input an Prisma create weitergeben
  • updateDemandRequirement — budgetCents updatebar machen
  • checkResourceAvailability — optional: gebuchte Kosten vs. Rollen-Budget zurueckgeben

Datei: packages/api/src/router/project.ts

  • Bei Projekt-Erstellung mit StaffingReqs: wenn staffingReq.budgetCents vorhanden, an DemandRequirement weitergeben

Task 4: Project Wizard Step 3 — Budget-Input pro Rolle

Datei: apps/web/src/components/projects/ProjectWizard.tsx

  • Pro StaffingRequirement-Karte: neues Feld "Role Budget (EUR)" (Input, konvertiert zu Cents)
  • Oben im Step: Anzeige "Project Budget: X EUR | Allocated: Y EUR | Remaining: Z EUR"
  • Farbkodierung: gruen wenn alles verteilt, amber wenn Rest, rot wenn ueberallokiert
  • Budget-Wert wird in state.staffingReqs[i].budgetCents gespeichert

Task 5: Project Detail Page — Budget-Spalten pro Demand

Datei: apps/web/src/components/projects/ProjectDemandsTable.tsx

  • Neue Spalte "Allocated Budget" — zeigt demand.budgetCents formatiert als EUR
  • Neue Spalte "Booked Budget" — berechnet: Summe der dailyCostCents * Arbeitstage aller Assignments dieses Demands
    • Hinweis: Die Demand-Daten vom Server enthalten assignments[] — daraus berechnen
  • Neue Spalte "Remaining" — Allocated minus Booked
  • Farbkodierung: gruen wenn unter Budget, rot wenn ueber Budget

Task 6: Fill Demand Modal — Rollen-Budget anzeigen

Datei: apps/web/src/components/allocations/FillOpenDemandModal.tsx

  • Im Demand-Summary oben: "Role Budget: X EUR | Booked: Y EUR | Remaining: Z EUR"
  • Beim Hinzufuegen einer Ressource zum Plan: geschaetzte Kosten anzeigen (LCR * verfuegbare Stunden)
  • Warnung wenn geplante Kosten das Rollen-Budget ueberschreiten

Abhaengigkeiten

  • Task 1 → Task 2 → Task 3 (sequentiell: Schema → Types → API)
  • Task 4 benoetigt Task 2 (StaffingRequirement-Typ mit budgetCents)
  • Task 5 benoetigt Task 1+3 (budgetCents auf DemandRequirement + API liefert es)
  • Task 6 benoetigt Task 5 (gleiche Berechnung)
  • Task 4 und Task 5 koennen parallel nach Task 3

Akzeptanzkriterien

  • pnpm db:push laeuft ohne Fehler
  • pnpm test:unit — alle Tests gruen
  • pnpm --filter @planarchy/web exec tsc --noEmit — keine neuen Errors
  • Project Wizard Step 3: Budget-Input pro Rolle sichtbar, Restbudget wird live berechnet
  • Project Detail /projects/[id]: Demands-Tabelle zeigt Allocated / Booked / Remaining Budget
  • Fill Demand Modal: Rollen-Budget und geschaetzte Kosten sichtbar
  • Bestehende Projekte/Demands funktionieren weiterhin (budgetCents default 0)

Risiken & offene Fragen

  1. Abwaertskompatibilitaet: @default(0) stellt sicher, dass bestehende Demands kein Budget haben (0 = nicht gesetzt). UI sollte "Not set" anzeigen wenn 0.
  2. Budget-Berechnung Booked: dailyCostCents ist pro Tag. Gebuchte Kosten = dailyCostCents * Anzahl Arbeitstage im Zeitraum. Diese Berechnung existiert bereits im Engine-Paket (computeBudgetStatus).
  3. StaffingReqs JSONB: Die staffingReqs auf Project sind JSONB. Aeltere Projekte haben kein budgetCents darin — der Wizard muss budgetCents ?? 0 defaulten.
  4. Budget-Ueberschreitung: Soll weiterhin erlaubt sein (Warnung, kein Block) — konsistent mit dem bestehenden Ansatz bei Projekt-Budget.
Reference in New Issue View Git Blame Copy Permalink