Files
Orchestrator/bahn/teamlandkarte-mcp/.kiro/specs/capacity-details-enrichment/requirements.md
T
ankn a5f8fb49ab Migrate all repos into monorepo context folders
Bahn: aisupport, Analyse-O2C-C2S, awesome-bahn-mcp-servers, beam-mcp,
      Confluence_Bot, db-planet-mcp-server, O2C-Harness, project-audit,
      Projekt-KIQ-HP, teamlandkarte-mcp
Dhive: Jury-Voting
Privat: CV, NoteGraph (NOTE: NoteGraph needs complete redo after consolidation)
Shared: AI-Orchestrator, OrgMyLife, power_skills_and_more
Shared/references: symphony (read-only)

Bahn repos remain available as independent remotes - this monorepo
pulls them in via subtree, the originals are untouched.
2026-06-30 20:39:52 +02:00

3.9 KiB

Requirements Document

Introduction

Das MCP-Tool get_capacity_details zeigt aktuell nur eine Tabelle mit ID, Owner, Rolle, Kompetenzen und Verfügbarkeit an. Es fehlen die Beschreibung (Description), Referenzen und Zertifizierungen einer Kapazität. Diese Informationen sind bereits in der Datenbank vorhanden und über die DB-Client-Methoden get_capacity_description, get_capacity_references und get_capacity_certificates abrufbar. Das Tool soll erweitert werden, um diese zusätzlichen Felder anzuzeigen.

Glossary

  • MCP_Server: Der Teamlandkarte MCP Server, der Tools für Kapazitäts- und Aufgabenabgleich bereitstellt
  • get_capacity_details_Tool: Das MCP-Tool, das Detailinformationen zu einer einzelnen Kapazität anzeigt
  • DB_Client: Die Datenbankzugriffsschicht, die Kapazitätsdaten aus der Trino-Datenbank liest
  • Capacity: Ein Eintrag, der die verfügbare Kapazität einer Person beschreibt (ID, Owner, Rolle, Kompetenzen, Verfügbarkeit)
  • Description: Freitext-Beschreibung einer Kapazität aus teamlandkarte_v_capacities_latest.description
  • Reference: Ein Referenzeintrag bestehend aus Partnername und Projekten aus teamlandkarte_v_capacity_references_latest
  • Certificate: Eine Zertifizierungsbeschreibung aus teamlandkarte_v_capacity_certificates_latest

Requirements

Requirement 1: Beschreibung anzeigen

User Story: Als Nutzer möchte ich die Beschreibung einer Kapazität im Tool get_capacity_details sehen, damit ich ein vollständigeres Bild der Kapazität erhalte.

Acceptance Criteria

  1. WHEN a capacity is retrieved by get_capacity_details, THE get_capacity_details_Tool SHALL fetch the description via DB_Client.get_capacity_description
  2. WHEN the description is non-empty, THE get_capacity_details_Tool SHALL display the description in a dedicated section labeled "Beschreibung" below the capacity table
  3. WHEN the description is empty or not available, THE get_capacity_details_Tool SHALL display "Beschreibung: (keine)" in the description section

Requirement 2: Referenzen anzeigen

User Story: Als Nutzer möchte ich die Referenzen einer Kapazität im Tool get_capacity_details sehen, damit ich die bisherigen Projekterfahrungen der Person einschätzen kann.

Acceptance Criteria

  1. WHEN a capacity is retrieved by get_capacity_details, THE get_capacity_details_Tool SHALL fetch the references via DB_Client.get_capacity_references
  2. WHEN references exist, THE get_capacity_details_Tool SHALL display each reference as a bullet point in a section labeled "Referenzen", including partner name and projects
  3. WHEN a reference has an empty partner name, THE get_capacity_details_Tool SHALL display only the projects for that reference entry
  4. WHEN no references exist, THE get_capacity_details_Tool SHALL display "Referenzen: (keine)"

Requirement 3: Zertifizierungen anzeigen

User Story: Als Nutzer möchte ich die Zertifizierungen einer Kapazität im Tool get_capacity_details sehen, damit ich die formalen Qualifikationen der Person erkennen kann.

Acceptance Criteria

  1. WHEN a capacity is retrieved by get_capacity_details, THE get_capacity_details_Tool SHALL fetch the certificates via DB_Client.get_capacity_certificates
  2. WHEN certificates exist, THE get_capacity_details_Tool SHALL display each certificate as a bullet point in a section labeled "Zertifizierungen"
  3. WHEN no certificates exist, THE get_capacity_details_Tool SHALL display "Zertifizierungen: (keine)"

Requirement 4: Darstellungsreihenfolge

User Story: Als Nutzer möchte ich eine konsistente und übersichtliche Darstellung aller Kapazitätsdetails, damit ich die Informationen schnell erfassen kann.

Acceptance Criteria

  1. THE get_capacity_details_Tool SHALL display sections in the following fixed order: Capacity-Tabelle, Beschreibung, Referenzen, Zertifizierungen, Next Steps
  2. THE get_capacity_details_Tool SHALL separate each section with a blank line for Lesbarkeit