Busflow Docs

Internal documentation portal

Skip to content

Implementation Plan ​

Goal ​

Einen belastbaren, umsetzungsreifen Arbeitsplan fĂŒr die L2-D-Detailanalyse der Kern-APs AP1–AP6, AP7a, AP8 und AP9 erstellen, sodass die spĂ€tere Analyse Frascati-Scorecard, F&E-Splits, Antragstext-Verbesserungen und L2-C-Inputs ohne Nachfragen produzieren kann.

Gemeinsamer Ergebnis- und Run-Contract ​

  • Kanonischer Ergebnisordner: docs/1-projects/bsfz-funding/funding-drilldown-L2-results/.
  • PrimĂ€res Ergebnis dieses Drilldowns: docs/1-projects/bsfz-funding/funding-drilldown-L2-results/L2-D-result.md.
  • Hauptdokument-Edits nur ausfĂŒhren, wenn der jeweilige L2-Scope sie explizit erlaubt; sonst konkrete Patch-/TextvorschlĂ€ge im Ergebnisdokument festhalten.
  • Reihenfolge/Gates: G → A → B → D/E/F → C → H. Abweichungen mĂŒssen im Ergebnis als Annahme oder Blocker markiert werden.

Tasks ​

  1. Kontext- und Scope-Abgleich durchfĂŒhren

    • File: docs/1-projects/bsfz-funding/funding-drilldown-L1.md
    • File: docs/1-projects/bsfz-funding/funding-drilldown-L2-D.md
    • Changes: Keine Edits; relevante L2-D-Vorgaben extrahieren: AP-Scope, Nicht-Scope, erwartete Ergebnisartefakte, Akzeptanzkriterien, offene L1-Hypothesen und Randbedingungen.
    • Acceptance: Arbeitsnotizen enthalten explizit alle 9 AP-Slots: AP1, AP2, AP3, AP4, AP5, AP6, AP7a, AP8, AP9; Commerce-APs und Kandidaten-APs sind als out-of-scope markiert.
  2. Pfad-Mapping der in L1/L2-D genannten Quellen auf aktuelle Repository-Struktur erstellen

    • File: docs/1-projects/bsfz-funding/funding-work-packages.md
    • File: docs/1-projects/bsfz-funding/bsfz-antrag-vorhaben.md
    • File: docs/1-projects/bsfz-funding/bsfz-ablehnungsrisiken.md
    • File: docs/1-projects/bsfz-funding/forschungszulagengesetz.md
    • Changes: Keine Edits; Mapping-Tabelle fĂŒr veraltete Pfade aus L2-D (docs/strategy/..., docs/protocols/..., docs/supporting/...) auf tatsĂ€chliche Pfade anlegen.
    • Acceptance: FĂŒr jede genannte Quelle ist entweder ein existierender Pfad oder ein klarer Fehl-/KlĂ€rfall dokumentiert.
  3. AP-spezifische Themenliste finalisieren

    • File: Diverse Dokumente unter docs/2-areas/... and docs/3-resources/...
    • Changes: Keine Edits; pro AP eine Themenmatrix mit inhaltlichen Schwerpunkten und technischen Unsicherheiten erstellen.
    • Acceptance: Themenmatrix deckt AP1–AP9 vollstĂ€ndig ab.
  4. Frascati-Bewertungsraster definieren

    • File: docs/1-projects/bsfz-funding/forschungszulagengesetz.md
    • File: docs/1-projects/bsfz-funding/bsfz-ablehnungsrisiken.md
    • Changes: Keine Edits; ein konsistentes Ampelraster fĂŒr Neuartigkeit, UnwĂ€gbarkeit und PlanmĂ€ĂŸigkeit definieren, inklusive kurzer BegrĂŒndungsfelder und stĂ€rkstem/schwĂ€chstem inhaltlichen Nachweis pro Kriterium.
    • Acceptance: Raster erzeugt genau 27 Pflichtfelder (9 APs × 3 Kriterien) und verhindert leere/unklare EintrĂ€ge.
  5. AP-Analyse-Template vorbereiten

    • File: docs/1-projects/bsfz-funding/funding-work-packages.md
    • File: docs/1-projects/bsfz-funding/bsfz-antrag-vorhaben.md
    • Changes: Keine Edits; pro AP ein wiederholbares Template festlegen: Kurzbeschreibung, Forschungsfrage, Frascati-Score, F&E-/Engineering-Split, StundenplausibilitĂ€t, AbhĂ€ngigkeiten, AntragstextqualitĂ€t, Gutachter-Einwand, Verteidigungstext ≀200 Zeichen, konkrete VerbesserungsvorschlĂ€ge.
    • Acceptance: Template enthĂ€lt alle relevanten Untersuchungsfragen aus L2-D.
  6. Stunden- und F&E-Split-Methode festlegen

    • File: docs/1-projects/bsfz-funding/funding-work-packages.md
    • Changes: Keine Edits; Methode fĂŒr Prozent-Splits definieren: Forschungsanteil nur bei technischem Erkenntnisgewinn/Experiment/UnwĂ€gbarkeit; Standard-Engineering fĂŒr CRUD, UI, DevOps-Basis, bekannte Integration, Dokumentationsroutine. AP1-Split als Referenzkalibrierung verwenden.
    • Acceptance: Jeder spĂ€tere AP-Split muss Prozentwert, Stundenbereich, BegrĂŒndung und Abgrenzungssatz enthalten; AP1 ĂŒbernimmt vorhandenen Split, alle anderen werden neu hergeleitet.
  7. AP1–AP3 analysieren lassen/ausfĂŒhren: Vorhaben 1 und erste Vorhaben-2-Kernrisiken

    • File: apps/api/docs/tax-engine.md
    • File: docs/3-resources/decisions/adr-006-costing-pricing-separation.md
    • File: docs/3-resources/decisions/adr-012-toms-tax-deferral.md
    • File: docs/3-resources/decisions/adr-015-tax-ledger-entry-cardinality.md
    • File: docs/3-resources/protocols/offline-sync-protocol.md
    • File: docs/3-resources/decisions/adr-017-offline-sync-protocol.md
    • File: docs/3-resources/schemas/schema-operations.md
    • File: docs/3-resources/reference/eu-561-compliance-research.md
    • File: docs/3-resources/protocols/dispatch-availability-engine.md
    • Changes: Keine Direktedits; Analyseergebnisse in das AP-Template ĂŒbertragen.
    • Acceptance: AP1 benennt die SB-2/ADR-012-Chronologie als Risikoeintrag; AP2 trennt Offline-Sync-Forschung von Standard-Sync; AP3 bewertet Cross-Tenant/EU-561-UnwĂ€gbarkeit und inhaltliche Substanz.
  8. AP4–AP7a analysieren lassen/ausfĂŒhren: Event-, KI-, Pricing- und Broadcast-Kern

    • File: docs/3-resources/decisions/adr-004-tenant-isolation-strategy.md
    • File: docs/3-resources/decisions/adr-019-change-events-polymorphic-audit-trail.md
    • File: docs/3-resources/events/event-catalog.md
    • File: docs/2-areas/architecture/workflow-orchestration.md
    • File: docs/2-areas/architecture/ai.md
    • File: docs/3-resources/protocols/mcp-agent-bridge.md
    • File: docs/2-areas/architecture/validation-strategy.md
    • File: docs/3-resources/protocols/notification-pipeline-protocol.md
    • File: docs/3-resources/protocols/incident-broadcast-protocol.md
    • File: docs/1-projects/docs-hub-deploy/docs-hub.md
    • File: docs/3-resources/protocols/kalkulations-engine.md
    • File: docs/3-resources/protocols/price-matrix-variant-spec.md
    • Changes: Keine Direktedits; Analyseergebnisse in das AP-Template ĂŒbertragen.
    • Acceptance: AP5 wird explizit auf Catch-All-Risiko und mögliche Ausgliederung der Booking-Mutation-Erweiterung geprĂŒft; AP6 wird nie isoliert, sondern nur mit AP1-Verzahnung bewertet; AP7a enthĂ€lt Verweisplatzhalter auf L2-E fĂŒr AP26-Abgrenzung, ohne diese selbst zu formulieren.
  9. AP8–AP9 analysieren lassen/ausfĂŒhren: Realtime Commerce und Agentic Governance

    • File: docs/2-areas/architecture/realtime-strategy.md
    • File: docs/3-resources/schemas/schema-commerce.md
    • File: docs/2-areas/strategy/agentic-led-company-spec.md
    • File: docs/3-resources/decisions/adr-020-agentic-company-governance.md
    • Changes: Keine Direktedits; Analyseergebnisse in das AP-Template ĂŒbertragen.
    • Acceptance: AP8 trennt technische Concurrent-Hold-/Seatmap-UnwĂ€gbarkeit von Commerce-Feature-Implementierung; AP9 wird als konzeptionell/spec-basiert markiert und enthĂ€lt eine Go-/Risk-Empfehlung fĂŒr Einreichung trotz fehlendem Code.
  10. Antragstext-QualitĂ€t gegen Sprach-Check prĂŒfen

  • File: docs/1-projects/bsfz-funding/bsfz-antrag-vorhaben.md
  • File: docs/1-projects/bsfz-funding/bsfz-ablehnungsrisiken.md
  • Changes: Keine Direktedits; konkrete ÄnderungsvorschlĂ€ge pro AP formulieren, aber keine read-only-Dateien Ă€ndern.
  • Acceptance: Jede Empfehlung nennt die betroffene Stelle/Überschrift im Antragstext, das Problem (Feature-Sprache, Gesetzes-/Compliance-Fokus, zu abstrakt, zu breit) und eine prĂ€gnante Ersatzformulierung.
  1. Task entfĂ€llt (ehemals BeweislĂŒcken-Report).

  2. L2-C-Übergabeinput erstellen

  • File: docs/1-projects/bsfz-funding/bsfz-ablehnungsrisiken.md
  • Changes: Keine Direktedits; kompakten Abschnitt fĂŒr L2-C vorbereiten: pro AP F&E-Split, wahrscheinlichster Gutachter-Einwand, Verteidigungstext ≀200 Zeichen, Teilablehnungsrelevanz/AbhĂ€ngigkeit.
  • Acceptance: L2-C kann daraus Querschnittsmuster und Teilablehnungsstrategie ĂŒbernehmen, ohne AP-Dokumente erneut vollstĂ€ndig zu lesen.
  1. Ergebnisartefakt schreiben und intern prĂŒfen
  • File: docs/1-projects/bsfz-funding/funding-drilldown-L2-results/L2-D-result.md
  • Changes: Neues Analyse-Ergebnisdokument anlegen oder, falls eine andere Zielstruktur vorgegeben wird, entsprechend verwenden. Keine Änderungen an funding-work-packages.md, bsfz-antrag-vorhaben.md oder sonstigen read-only-Quellen.
  • Acceptance: Ergebnisdokument enthĂ€lt die erwarteten L2-D-Artefakte: Frascati-Scorecard, F&E-/Engineering-Split-Tabelle, Gutachter-EinwĂ€nde mit Verteidigung, Verbesserungsliste und Stunden-PlausibilitĂ€ts-Tabelle.
  1. Akzeptanz- und VollstĂ€ndigkeitscheck durchfĂŒhren
  • File: docs/1-projects/bsfz-funding/funding-drilldown-L2-D.md
  • File: docs/1-projects/bsfz-funding/funding-drilldown-L2-results/L2-D-result.md
  • Changes: Keine Edits außer ggf. Korrekturen im neuen Ergebnisdokument.
  • Acceptance: Checkliste bestĂ€tigt: 27 Frascati-Felder vollstĂ€ndig; 9 F&E-Splits mit Prozent und BegrĂŒndung; AP26↔AP7a nur als L2-E-AbhĂ€ngigkeit referenziert; alle Gutachter-Verteidigungen ≀200 Zeichen; keine DirektĂ€nderungen an read-only-Dateien.

Pflichtformat: Input fĂŒr L2-C ​

Die Ergebnisdatei muss eine maschinenlesbare Übergabetabelle mit identischer Struktur zu D/E/F enthalten:

APGo/No-GoF&E %Standard-Engineering %schwĂ€chstes Frascati-KriteriumHaupteinwandVerteidigungBeweislĂŒcke

ZusÀtzlich sind AbhÀngigkeiten/Teilablehnungsrelevanz kurz zu markieren, damit L2-C Muster-, Audit- und Teilablehnungslogik konsolidieren kann.

Files to Modify ​

  • docs/1-projects/bsfz-funding/funding-drilldown-L2-results/L2-D-result.md - empfohlenes neues Ergebnisdokument fĂŒr die eigentliche L2-D-Analyse mit Tabellen und ÄnderungsvorschlĂ€gen.

New Files ​

  • docs/1-projects/bsfz-funding/funding-drilldown-L2-results/L2-D-result.md - zentrales Ergebnisartefakt der spĂ€teren L2-D-AusfĂŒhrung.

Dependencies ​

  • Task 1 muss vor allen anderen Tasks abgeschlossen sein, um Scope-Fehler zu vermeiden.
  • Task 2 und Task 3 mĂŒssen vor den AP-Analysen (Tasks 7–9) abgeschlossen sein.
  • Task 4 bis Task 6 definieren Bewertungsraster und mĂŒssen vor Tasks 7–10 abgeschlossen sein.
  • Task 8 hĂ€ngt fĂŒr AP7a inhaltlich von L2-E ab, aber nur hinsichtlich der AP26↔AP7a-Abgrenzung; L2-D darf dafĂŒr einen Platzhalter/Verweis erfassen.
  • Task 10 hĂ€ngt von den AP-Analysen ab, weil Antragstext-Empfehlungen AP-spezifisch begrĂŒndet werden mĂŒssen.
  • Task 12 hĂ€ngt von Tasks 7–10 ab.
  • Task 13 hĂ€ngt von allen Analyse- und Konsolidierungstasks ab.
  • Task 14 ist der finale QualitĂ€tscheck.

Risks ​

  • docs/1-projects/bsfz-funding/context.md war beim Planen nicht vorhanden; falls ein Parent-Kontext erwartet wurde, muss dieser nachgereicht und gegen diesen Plan abgeglichen werden.
  • Die L1/L2-D-Quelldokumente enthalten alte Pfade (docs/strategy, docs/protocols, docs/supporting/reference), wĂ€hrend die aktuelle Repo-Struktur PARA-Pfade nutzt (docs/1-projects, docs/2-areas, docs/3-resources). Pfad-Mapping ist ein zwingender erster Arbeitsschritt.
  • AP9 ist nur spezifikativ belegt; ein zu positives Scoring ohne Code-/Prototyp-Risiko wĂ€re angreifbar.
  • AP5 ist mit mehreren Erweiterungen sehr breit; ohne klare Split-/Ausgliederungsempfehlung droht Catch-All-Wahrnehmung.
  • AP6 kann isoliert als Standard-DDD/Refactoring wirken; alle Bewertungen und TextvorschlĂ€ge mĂŒssen AP1-Verzahnung sichtbar machen.
  • AP1 hat eine bekannte Chronologie-SchwĂ€che (SB-2/ADR-012); sie darf nicht ĂŒberdeckt oder wegformuliert werden.
  • AP7a darf keine eigene AP26-Abgrenzung erfinden; die Entscheidung liegt bei L2-E.
  • Rechtliche/steuerliche Aussagen zur FörderfĂ€higkeit und F&E-Stundenabgrenzung sind als Arbeitsgrundlage zu kennzeichnen und sollten durch Steuerberater/FZulG-Berater validiert werden.
  • Keine read-only-Quellen direkt editieren; Änderungen nur als konkrete VorschlĂ€ge im neuen Ergebnisdokument formulieren.

Internal documentation — Busflow