# Colbec Demand OS Roadmap Board

Diese Ansicht ist aus `src/meta_ads/roadmap.py` generiert. Sie zeigt erledigte, laufende und offene Aufgaben nebeneinander und bleibt ueber `scripts/roadmap-contract-check.py` pruefbar.

## Lagebild

| Kennzahl | Wert |
| --- | ---: |
| Erledigt | 39 |
| In Arbeit | 0 |
| Offen | 5 |
| Fortschritt | 89% |

## Sechs parallele TODO-Listen

### Liste 1: Produkt und Revenue

Paid Audit, Pilot-Angebot, Packaging, Positionierung und Benchmark-Moat fuer zahlbare Retainer.

| Erledigt | In Arbeit | Offen |
| --- | --- | --- |
| **Version 1 Enterprise-Analyse aus PDF/MD uebernommen**<br>`v1-enterprise-analysis`<br>Analyse in Roadmap, MVP-Scope und Akzeptanzkriterien uebersetzen. |  |  |
| **Produktnarrativ auf Colbec Demand OS umstellen**<br>`colbec-product-framing`<br>Produktnarrativ in spaeteren UI- und Report-Oberflaechen konsequent halten. |  |  |
| **Paid Audit und 90-Day Premium Demand Pilot paketieren**<br>`pilot-offer-packaging`<br>Pilot-Angebot in Sales-Prozess, dev-meta und spaetere Angebots-PDFs einbetten. |  |  |
| **Sales Demo Kit mit dev-meta, Boardroom und Decision Dashboard**<br>`sales-demo-kit`<br>Demo Kit in Kundengespraechen validieren und Einwandbehandlung ausbauen. |  |  |
| **Benchmark Vault fuer Hospitality und Real Estate**<br>`benchmark-vault`<br>Observed Network Mode erst nach Mandanten-Consent, Auth, DPA, Mindestkohorte und Contributor-Dominance-Gate aktivieren. |  |  |
| **Buyer-ready Pilot Offer HTML fuer Sales-Gespraeche**<br>`pilot-offer-html-page`<br>Pilot Offer spaeter um Angebots-PDF und CRM-CTA erweitern. |  |  |

### Liste 2: UX und Boardroom

Premium Control Room, Decision Dashboard, Boardroom-HTML/PDF und Colbec-Designqualitaet.

| Erledigt | In Arbeit | Offen |
| --- | --- | --- |
| **Colbec UX Richtung fuer Control Room und Reports festlegen**<br>`colbec-ux-direction`<br>Designsystem und erste Dashboard-Wireframes in die spaetere Web-App ueberfuehren. |  | **PDF-/Tabellen-Export fuer Zielgruppen- und Strukturplaene**<br>`customer-export-pack`<br>Planungsoutputs als kundentaugliche PDF- und Tabellenartefakte mit Version, Kunde und Freigabestatus exportieren. |
| **Decision Dashboard statt Vanity-Metric-Dashboard**<br>`decision-dashboard`<br>Dashboard spaeter um Pacing, Verantwortliche, Faelligkeiten und persistente Decision Logs erweitern. |  |  |
| **Premium Boardroom PDF fuer Monatsentscheidungen**<br>`boardroom-pdf-export`<br>PDF-Layout spaeter mit Typografie, Pagination und signiertem Exportpfad veredeln. |  |  |
| **Boardroom Report Contract V1 mit Pflichtsektionen**<br>`boardroom-report-contract-v1`<br>Contract-Banner und Draft/Ready-Status im Boardroom-HTML sichtbar machen. |  |  |
| **Public Status Board ohne interne Roadmap-Details**<br>`public-status-board`<br>Status Board spaeter als client-safe Demo-Einstieg fuer Sales Calls nutzen. |  |  |
| **Control Room Menue macht PDF-Kernmodule sichtbar**<br>`real-menu-core-modules-visible`<br>Navigation spaeter mit Auth, Kundenauswahl und Rollenzugriff verknuepfen. |  |  |

### Liste 3: Planning und Blueprint Engine

Zielgruppen-, Kampagnen- und Budget-Blueprints ohne KI-Copy oder generierte Creatives.

| Erledigt | In Arbeit | Offen |
| --- | --- | --- |
| **Bestehender Campaign Planner erzeugt Meta-Entwuerfe**<br>`planner-draft-generation`<br>Planner als Blueprint Engine statt Content-Generator weiterentwickeln. |  |  |
| **Budget-Guardrails blockieren zu hohe Tagesbudgets**<br>`budget-guardrails`<br>Budgetlogik um Monatsbudget, Pacing und Budget-Split-Regeln erweitern. |  |  |
| **Keine Tool-Copy und keine KI-Creatives im Enterprise-MVP**<br>`no-ai-creative-guardrail`<br>Manuelle Creative-Slots in spaeteren Blueprints und Reports als feste Produktregel halten. |  |  |
| **Hospitality- und Real-Estate-Blueprint Library V1**<br>`blueprint-library-v1`<br>Blueprints spaeter in Planner-UI und Kundenbriefing-Ausgabe anzeigen. |  |  |
| **Zielgruppen-Planer als sichtbares Browsermodul**<br>`audience-planner-ui`<br>Planner spaeter um Export-PDF/Tabelle und Kundenvorlagen erweitern. |  |  |
| **Kampagnenstruktur-Generator mit Budget-Split und UTM**<br>`campaign-structure-generator-ui`<br>Strukturplan spaeter als PDF/Tabelle und kundenspezifisches Template exportieren. |  |  |

### Liste 4: Data Trust und Integrationen

Mandantenmodell, sichere Uploads, Importqualitaet, PII-Blocker und spaetere XLSX/CRM-Anbindung.

| Erledigt | In Arbeit | Offen |
| --- | --- | --- |
| **Tenant-, Client-, Brand- und Ad-Account-Domainmodell**<br>`tenant-domain-model`<br>Persistenzschicht spaeter auf Postgres/Dokploy uebertragen. |  | **Mandanten-, Kunden- und Ad-Account-Workspace mit Rollen**<br>`client-account-workspace-ui`<br>Login, Rollenmodell, Kundenauswahl, Ad-Account-Zuordnung und tenant-sichere Persistenz entwerfen. |
| **CSV Import Pipeline mit Mapping und Quality Score**<br>`data-trust-import-pipeline`<br>XLSX und Report-Snapshot-Persistenz spaeter ergaenzen; CSV-Kern ist vorhanden. |  | **Browser CSV/XLSX Upload mit Mapping-Preview und Import-Historie**<br>`browser-csv-xlsx-upload-workflow`<br>Upload-Flow hinter Real-Customer-Data-Gate, Retention Policy, PII-Scan und privater Persistenz bauen. |
| **Real Customer Data Gate vor echten Kundendaten**<br>`real-customer-data-gate`<br>Gate in spaeteren CLI/UI-Upload-Pfaden verpflichtend verdrahten. |  |  |
| **Import-Historie und ReportSnapshot-Persistenz**<br>`import-history-persistence`<br>Append-only JSONL spaeter auf Postgres oder privates Volume mit Locking migrieren. |  |  |
| **Mindestaggregation, Perioden- und Channel-Abgleich**<br>`minimum-aggregation-reconciliation`<br>Channel-Taxonomie spaeter kundenkonfigurierbar machen. |  |  |
| **PII Upload Scanner fuer Meta-Exports und spaetere Lead-Dateien**<br>`pii-upload-scanner`<br>Scanner bei XLSX und spaeteren UI-Uploads wiederverwenden. |  |  |

### Liste 5: Reporting und Intelligence

Semantische KPIs, Lead-/Booking-Qualitaet, CPQL, Booking Intent und entscheidungsfaehige Reports.

| Erledigt | In Arbeit | Offen |
| --- | --- | --- |
| **Semantischer KPI-Layer fuer Meta-, Site- und CRM-Daten**<br>`semantic-kpi-layer`<br>Pacing und Source-Separation in Report-Snapshots erweitern. |  | **Persistente Learnings, Notizen und Action Logs**<br>`persistent-decision-action-log`<br>DecisionItemV1 um gespeicherte Kunden-Notizen, Learnings, Verantwortliche und Statushistorie erweitern. |
| **Pacing Engine und Decision Intelligence Layer**<br>`pacing-decision-intelligence`<br>Segment-Rollups erst mit Taxonomie, Mindestvolumen und echten Zielwerten ergaenzen. |  |  |
| **Lead-/Booking-Qualitaetsimport fuer CPQL und Booking Intent**<br>`lead-booking-quality-import`<br>Periodenabgleich, Channel-Mapping und Mindestaggregation vor echten Kundendaten ergaenzen. |  |  |
| **Reporting Dashboard als sichtbarer KPI- und Data-Trust-Einstieg**<br>`reporting-dashboard-ui`<br>Browser-Upload erst nach Real-Data-Gate, Retention und Persistenz aktivieren. |  |  |

### Liste 6: Ops, Compliance und Runtime

Roadmap-Vertrag, Dokploy, Stage-Gates, Approval, Housing, Meta Write Lock und Live-Betrieb.

| Erledigt | In Arbeit | Offen |
| --- | --- | --- |
| **Pruefbarer Roadmap-Vertrag im Repository**<br>`roadmap-contract-foundation`<br>Roadmap-Contract in Security-Check und Tests halten. |  | **Live Meta API Writes bleiben bewusst offen/deferred**<br>`live-meta-api-writes`<br>Erst nach Data Trust, Approval, Audit, Stage und Kundenfreigabe erneut bewerten. |
| **Lokale Meta-Policy-Validation fuer riskante Claims**<br>`meta-policy-validation`<br>Policy in versionierte Governance mit Housing-Gate und PII-Scan ueberfuehren. |  |  |
| **Meta Client bleibt dry-run-first und blockiert Live-Writes**<br>`dry-run-publishing`<br>Dry-run-Verhalten bei jedem spaeteren API-Ausbau als Default erzwingen. |  |  |
| **Human Approval Gate fuer Publishing und Budgetaenderungen**<br>`human-approval-gate`<br>Approval-Events spaeter persistent speichern und in UI/Stage-Gate anzeigen. |  |  |
| **Dokploy-Plan fuer dev-meta und stage-meta dokumentieren**<br>`dokploy-dev-stage-plan`<br>Runtime Compose, Healthchecks und Smoke-Gates im Roadmap-Vertrag halten. |  |  |
| **Housing-/Real-Estate-Compliance-Gate**<br>`housing-compliance-gate`<br>Audit-Event-Persistenz und Policy-Versionierung spaeter ergaenzen. |  |  |
| **dev-meta Dokploy Runtime mit synthetischen Daten**<br>`dokploy-dev-meta-deploy`<br>dev-meta nach jedem main-Deploy mit Runtime Doctor und Public Smoke pruefen. |  |  |
| **GitHub Repo fuer Dokploy sichtbar machen**<br>`github-repo-dokploy-link`<br>main pushen und Dokploy-Provider auf docker-compose.yml ausrichten. |  |  |
| **stage-meta Gate fuer pilotfaehige Demo**<br>`stage-meta-gate`<br>Stage-Public-Smoke nach erstem stage-meta Deploy mit STAGE_PUBLIC_URL regelmaessig ausfuehren. |  |  |
| **Interne Roadmap-Routen optional schuetzen**<br>`internal-roadmap-protection`<br>Dokploy-Token fuer stage-meta vor erster Kundendemo setzen und Browser-Auth-Option bewerten. |  |  |
| **dev-meta Postdeploy Gate fuer dauerhafte Pruefbarkeit**<br>`dev-meta-postdeploy-gate`<br>Gate nach jedem Dokploy-Deploy ausfuehren und spaeter als GitHub Actions Workflow automatisieren. |  |  |

## Vollstaendiges TODO-Ledger

| ID | Status | Prio | Bereich | Owner | Naechster Schritt | Abnahme |
| --- | --- | --- | --- | --- | --- | --- |
| `v1-enterprise-analysis` | Erledigt | P0 | Produktstrategie | Product Strategy Agent | Analyse in Roadmap, MVP-Scope und Akzeptanzkriterien uebersetzen. | PDF/MD ist als Quelle referenziert und die V1-Produktprinzipien sind in ROADMAP_STATUS sichtbar. |
| `roadmap-contract-foundation` | Erledigt | P0 | Roadmap Governance | Programming Agent | Roadmap-Contract in Security-Check und Tests halten. | scripts/roadmap-contract-check.py laeuft lokal und in tests/test_roadmap_contract_check.py. |
| `planner-draft-generation` | Erledigt | P1 | Planning Engine | Programming Agent | Planner als Blueprint Engine statt Content-Generator weiterentwickeln. | Bestehende Tests fuer Draft-Erzeugung bleiben gruen; neuer No-AI-Creative-Guard folgt als P0. |
| `budget-guardrails` | Erledigt | P0 | Policy | Compliance Agent | Budgetlogik um Monatsbudget, Pacing und Budget-Split-Regeln erweitern. | Policy-Test blockiert Budgets ueber dem konfigurierten Limit. |
| `meta-policy-validation` | Erledigt | P0 | Policy | Compliance Agent | Policy in versionierte Governance mit Housing-Gate und PII-Scan ueberfuehren. | Riskante Claim-Phrasen werden aktuell blockiert; Erweiterung ist als P0 sichtbar. |
| `dry-run-publishing` | Erledigt | P0 | Meta API | Meta API Agent | Dry-run-Verhalten bei jedem spaeteren API-Ausbau als Default erzwingen. | MetaAdsClient(dry_run=True) erzeugt nur Preview; Live-Adapter ist nicht implementiert. |
| `colbec-product-framing` | Erledigt | P0 | Produktstrategie | Product Strategy Agent | Produktnarrativ in spaeteren UI- und Report-Oberflaechen konsequent halten. | README, Roadmap und UX-Dokumente nennen Demand OS, Premium Ads Control Room, menschliche Creatives und Data Trust als Kern. |
| `pilot-offer-packaging` | Erledigt | P0 | Revenue | Product Strategy Agent | Pilot-Angebot in Sales-Prozess, dev-meta und spaetere Angebots-PDFs einbetten. | docs/PILOT_OFFER.md wird aus PilotOfferPackage V1 generiert und enthaelt Zielkunde, Scope, Preisanker, Zahlungslogik, Nicht-Ziele, No-AI-Creative und Real-Data-Gates. |
| `sales-demo-kit` | Erledigt | P1 | Revenue | Product Strategy Agent | Demo Kit in Kundengespraechen validieren und Einwandbehandlung ausbauen. | docs/SALES_DEMO_KIT.md wird aus SalesDemoKit V1 generiert und fuehrt dev-meta, Boardroom, Decision Dashboard, Lead Quality, Grenzen, Talk Track und Paid-Audit-Abschluss zusammen. |
| `no-ai-creative-guardrail` | Erledigt | P0 | Creative Governance | Compliance Agent | Manuelle Creative-Slots in spaeteren Blueprints und Reports als feste Produktregel halten. | Planner erzeugt keine Headline/Primary-Text-Vorschlaege mehr; Tests pruefen menschliche Creative-Slots. |
| `blueprint-library-v1` | Erledigt | P1 | Planning Engine | Programming Agent | Blueprints spaeter in Planner-UI und Kundenbriefing-Ausgabe anzeigen. | Vier versionierte Blueprint-Registry-Eintraege sind testbar, budgetplausibel, Real-Estate-aware und ohne KI-Copy. |
| `audience-planner-ui` | Erledigt | P0 | Planning UX | UX Agent | Planner spaeter um Export-PDF/Tabelle und Kundenvorlagen erweitern. | /audience-planner und /audience-planner.json zeigen Interessen, Alter, Geo, Ausschluesse, Budgetsplit und Compliance als manuelle Meta-Business-Manager-Vorlage ohne KI-Copy. |
| `campaign-structure-generator-ui` | Erledigt | P0 | Planning UX | Programming Agent | Strukturplan spaeter als PDF/Tabelle und kundenspezifisches Template exportieren. | /campaign-structure und /campaign-structure.json erzeugen planning-only Kampagnen, Anzeigengruppen, Budget-Splits, Naming, UTM-Regel, manuelle Creative-Slots und Guardrails. |
| `human-approval-gate` | Erledigt | P0 | Governance | Compliance Agent | Approval-Events spaeter persistent speichern und in UI/Stage-Gate anzeigen. | ApprovalRequest, AuditEvent und Publishing Policy erzwingen explizite Freigabe fuer Live-Writes. |
| `dokploy-dev-stage-plan` | Erledigt | P0 | Deployment | DevOps Agent | Runtime Compose, Healthchecks und Smoke-Gates im Roadmap-Vertrag halten. | docs/DOKPLOY_DEPLOYMENT.md und ops/dokploy Beispiele beschreiben dev-meta synthetic-only, stage-meta guarded und konkrete Compose-Pfade. |
| `colbec-ux-direction` | Erledigt | P1 | UX | UX Agent | Designsystem und erste Dashboard-Wireframes in die spaetere Web-App ueberfuehren. | docs/COLBEC_UX_DIRECTION.md und roadmap-dashboard.html beschreiben Tonalitaet, Layoutprinzipien und No-Growth-Hype-Regeln. |
| `tenant-domain-model` | Erledigt | P0 | Data Model | Data Platform Agent | Persistenzschicht spaeter auf Postgres/Dokploy uebertragen. | Tenant-ID ist in Client, Brand und AdAccount Pflicht; Tests pruefen Isolation und Cross-Tenant-Blocker. |
| `data-trust-import-pipeline` | Erledigt | P0 | Data Trust | Data Platform Agent | XLSX und Report-Snapshot-Persistenz spaeter ergaenzen; CSV-Kern ist vorhanden. | Import prueft Pflichtfelder, Zahlenformate, Duplikate, PII, Spend/Impression-Plausibilitaet und gibt Quality Score aus. |
| `real-customer-data-gate` | Erledigt | P0 | Data Trust | Data Platform Agent | Gate in spaeteren CLI/UI-Upload-Pfaden verpflichtend verdrahten. | RealCustomerDataContext blockiert echte Daten ohne DPA/AVV, Zweck, Datenklasse, Retention, Zugriff, Backup, Secrets und Human Approval. |
| `import-history-persistence` | Erledigt | P0 | Data Trust | Data Platform Agent | Append-only JSONL spaeter auf Postgres oder privates Volume mit Locking migrieren. | ImportManifest V1 kann append-only ohne Rohdaten gespeichert, im ReportSnapshot verlinkt und im Boardroom Contract sichtbar gemacht werden. |
| `minimum-aggregation-reconciliation` | Erledigt | P0 | Data Trust | Data Platform Agent | Channel-Taxonomie spaeter kundenkonfigurierbar machen. | Reconciliation-Gate blockiert CPQL/Revenue-Ausgabe bei zu kleiner Aggregation, Perioden- oder Waehrungs-Mismatch. |
| `semantic-kpi-layer` | Erledigt | P0 | Reporting | Data Platform Agent | Pacing und Source-Separation in Report-Snapshots erweitern. | KPI-Formeln fuer Spend, CPM, CTR, CPC, LPV, CVR, CPA/CPL und Frequency sind zentral versioniert und getestet. |
| `pacing-decision-intelligence` | Erledigt | P1 | Reporting | Data Platform Agent | Segment-Rollups erst mit Taxonomie, Mindestvolumen und echten Zielwerten ergaenzen. | Decision Dashboard, Boardroom HTML/Markdown und JSON koennen DecisionItemV1 mit Owner, Due Date, Impact, Risiko, Status und Evidence sichtbar ausgeben. |
| `boardroom-pdf-export` | Erledigt | P0 | Client Deliverables | UX Agent | PDF-Layout spaeter mit Typografie, Pagination und signiertem Exportpfad veredeln. | Boardroom PDF wird als echter PDF-Binary ueber CLI und /boardroom-report.pdf erzeugt, enthaelt Contract-Version, Snapshot-ID, KPI-Version, Draft/Ready-Status, Source Separation und Decision Intelligence. |
| `boardroom-report-contract-v1` | Erledigt | P0 | Client Deliverables | UX Agent | Contract-Banner und Draft/Ready-Status im Boardroom-HTML sichtbar machen. | BoardroomReportV1 definiert Contract-Version, Snapshot-ID, Pflichtsektionen, KPI-Version, Source-Status, Approval-Status, Compliance Note und Exportstatus. |
| `decision-dashboard` | Erledigt | P1 | UX | UX Agent | Dashboard spaeter um Pacing, Verantwortliche, Faelligkeiten und persistente Decision Logs erweitern. | CLI und Web-Preview zeigen Readiness, Data Quality, Source Notes, Entscheidungs-Lanes und naechste Massnahmen aus ReportSnapshot. |
| `housing-compliance-gate` | Erledigt | P0 | Compliance | Compliance Agent | Audit-Event-Persistenz und Policy-Versionierung spaeter ergaenzen. | Riskante Targeting-Felder und enge Geo-Radien werden fuer Housing blockiert oder hart gewarnt. |
| `pii-upload-scanner` | Erledigt | P0 | Privacy | Security Agent | Scanner bei XLSX und spaeteren UI-Uploads wiederverwenden. | MVP blockiert E-Mail, Telefon, IP, Lead IDs, Name-/Adress-Header und erlaubt nur aggregierte Reporting-Exports. |
| `lead-booking-quality-import` | Erledigt | P2 | Revenue Intelligence | Data Platform Agent | Periodenabgleich, Channel-Mapping und Mindestaggregation vor echten Kundendaten ergaenzen. | Aggregat-CSV fuer qualifizierte Leads, Termine, Buchungen und Umsatz wird PII-geprueft, blockiert Rohdaten und speist CPQL/Booking Quality in Report und Dashboard. |
| `reporting-dashboard-ui` | Erledigt | P0 | Reporting UX | Data Platform Agent | Browser-Upload erst nach Real-Data-Gate, Retention und Persistenz aktivieren. | /reporting-dashboard und /reporting-dashboard.json zeigen synthetische Meta-CSV-Auswertung mit Spend, Impressions, CPM, CTR, CPC, Conversions, CPA, Frequency, CPQL, Bookings, Source Separation und Enterprise Next Steps. |
| `benchmark-vault` | Erledigt | P2 | Moat | Product Strategy Agent | Observed Network Mode erst nach Mandanten-Consent, Auth, DPA, Mindestkohorte und Contributor-Dominance-Gate aktivieren. | Benchmark Vault V1 startet im Reference Mode, erzwingt Mindestkohorte fuer Network Mode, blockiert Identifier/PII-Risiken und zeigt extern nur aggregierte Vergleichswerte ohne interne Notizen. |
| `pilot-offer-html-page` | Erledigt | P0 | Revenue | Product Strategy Agent | Pilot Offer spaeter um Angebots-PDF und CRM-CTA erweitern. | /pilot-offer rendert eine browserfaehige Kaeuferseite; /pilot-offer.md bleibt als Markdown-Artefakt erhalten. |
| `public-status-board` | Erledigt | P0 | UX | UX Agent | Status Board spaeter als client-safe Demo-Einstieg fuer Sales Calls nutzen. | /status-board und /status-board.json zeigen sechs Workstreams, Zaehler und Meta-Write-Lock ohne Owner, Gates, Abnahme oder Next-Step-Details. |
| `real-menu-core-modules-visible` | Erledigt | P0 | UX | UX Agent | Navigation spaeter mit Auth, Kundenauswahl und Rollenzugriff verknuepfen. | / zeigt eine echte Hauptnavigation zu Zielgruppen-Planer, Kampagnenstruktur, Reporting Dashboard, Boardroom, Roadmap und Status; Kernmodule sind smoke-faehig und client-safe. |
| `dokploy-dev-meta-deploy` | Erledigt | P1 | Deployment | DevOps Agent | dev-meta nach jedem main-Deploy mit Runtime Doctor und Public Smoke pruefen. | dev-meta ist live erreichbar, nutzt keine echten Kundendaten, zeigt die Roadmap und Meta-Writes sind false. |
| `github-repo-dokploy-link` | Erledigt | P0 | Deployment | DevOps Agent | main pushen und Dokploy-Provider auf docker-compose.yml ausrichten. | GitHub-App sieht rb007x75/meta-ads; lokales git remote -v zeigt origin; Dokploy General/GitHub kann main auswaehlen. |
| `stage-meta-gate` | Erledigt | P1 | Deployment | DevOps Agent | Stage-Public-Smoke nach erstem stage-meta Deploy mit STAGE_PUBLIC_URL regelmaessig ausfuehren. | scripts/stage-meta-release-gate.sh prueft Roadmap, generierte Artefakte, Stage Compose, Runtime Doctor und optional Public Smoke samt /readyz Safety JSON. |
| `internal-roadmap-protection` | Erledigt | P0 | Security | Security Agent | Dokploy-Token fuer stage-meta vor erster Kundendemo setzen und Browser-Auth-Option bewerten. | INTERNAL_ROADMAP_TOKEN schuetzt Roadmap, Audit- und Workstream-JSON-Routen; stage-meta /readyz bleibt ohne aktiven Schutz rot. |
| `dev-meta-postdeploy-gate` | Erledigt | P1 | Deployment | DevOps Agent | Gate nach jedem Dokploy-Deploy ausfuehren und spaeter als GitHub Actions Workflow automatisieren. | scripts/dev-meta-postdeploy-gate.sh prueft Roadmap, Generatoren, Compose, Runtime Doctor, Public Smoke, /readyz und public status JSON. |
| `client-account-workspace-ui` | Offen | P0 | Enterprise Workspace | Product Engineering Agent | Login, Rollenmodell, Kundenauswahl, Ad-Account-Zuordnung und tenant-sichere Persistenz entwerfen. | Nutzer koennen Kunden/Ad Accounts getrennt auswaehlen; Rollen und Tenant-Isolation sind testbar und echte Daten bleiben ohne Freigabe gesperrt. |
| `browser-csv-xlsx-upload-workflow` | Offen | P0 | Data Trust | Data Platform Agent | Upload-Flow hinter Real-Customer-Data-Gate, Retention Policy, PII-Scan und privater Persistenz bauen. | CSV und XLSX aus Meta Business Manager koennen im Browser hochgeladen, gemappt, validiert, historisiert und ohne Rohdatenleck reportfaehig gemacht werden. |
| `persistent-decision-action-log` | Offen | P1 | Reporting | Data Platform Agent | DecisionItemV1 um gespeicherte Kunden-Notizen, Learnings, Verantwortliche und Statushistorie erweitern. | Monatliche Boardroom-Entscheidungen lassen sich pro Kunde speichern, wiederfinden und im naechsten Report als Verlauf anzeigen. |
| `customer-export-pack` | Offen | P1 | Client Deliverables | UX Agent | Planungsoutputs als kundentaugliche PDF- und Tabellenartefakte mit Version, Kunde und Freigabestatus exportieren. | Zielgruppen-Planer und Kampagnenstruktur koennen als PDF oder Tabelle exportiert und 1:1 im Meta Business Manager nachgebaut werden. |
| `live-meta-api-writes` | Offen | P3 | Meta API | Meta API Agent | Erst nach Data Trust, Approval, Audit, Stage und Kundenfreigabe erneut bewerten. | Keine Kampagne, kein Budget, keine Audience und kein Pixel wird ohne explizites Gate geaendert. |

## Release Gates

| Gate | Ziel | Punkte |
| --- | --- | --- |
| Roadmap-Vertrag | Jeder Status muss maschinenpruefbar bleiben. | v1-enterprise-analysis, roadmap-contract-foundation |
| MVP Data Trust Gate | Keine Kundenreports ohne Importvalidierung, KPI-Version und Report-Snapshot. | tenant-domain-model, data-trust-import-pipeline, real-customer-data-gate, import-history-persistence, minimum-aggregation-reconciliation, semantic-kpi-layer, client-account-workspace-ui, browser-csv-xlsx-upload-workflow |
| Report und Client Deliverable Gate | Kundenartefakte bleiben versioniert, exportierbar, entscheidungsfaehig und nachvollziehbar. | decision-dashboard, boardroom-pdf-export, boardroom-report-contract-v1, reporting-dashboard-ui, persistent-decision-action-log, customer-export-pack |
| Compliance und Privacy Gate | Keine Real-Estate- oder Lead-Daten ohne Housing Gate, PII Scanner und Approval. | housing-compliance-gate, pii-upload-scanner, human-approval-gate |
| Dokploy dev-meta/stage-meta Gate | Runtime erst nach synthetischem Dev, File-Secrets, Smoke und Stage-Freigabe. | dokploy-dev-stage-plan, github-repo-dokploy-link, dokploy-dev-meta-deploy, stage-meta-gate, internal-roadmap-protection, dev-meta-postdeploy-gate |
| Meta Write Lock | Live-Writes bleiben blockiert, bis ein explizites Enterprise Approval existiert. | dry-run-publishing, live-meta-api-writes |
