gate: final acceptance report for Phase 0 + Phase 1 with all gate items
This commit is contained in:
@@ -1,224 +1,142 @@
|
||||
# Phase 0 + Phase 1 — Abnahmeprotokoll
|
||||
# Phase 0 + Phase 1 — Abschluss-Abnahmeprotokoll
|
||||
|
||||
**Datum:** 2026-07-31
|
||||
**Git-Commit:** fa96466 (main)
|
||||
**Baseline:** 11d6faa (tag: v-phase0-baseline)
|
||||
**Phase 0 Commit:** 032a7e8
|
||||
**Phase 1 Commit:** 15f0a07
|
||||
**Docker-Image API:** stvabl4vaqru7jclx4ittzr3:f7c60069d5661f5d94182a614dad9ce51f58296f (mit docker cp patches)
|
||||
**Docker-Image Worker:** leocrm-worker-fixed6:latest (docker commit from base image + patches)
|
||||
**Alembic-Head:** 0087
|
||||
|
||||
---
|
||||
|
||||
## Phase 0 — Entwicklungsstopp und belastbare Ausgangsbasis
|
||||
## Phase 0 — Entwicklungsstopp und belastbare Ausgangsbasis ✅
|
||||
|
||||
### Status: ABGESCHLOSSEN
|
||||
|
||||
### Analyse des Ausgangszustands
|
||||
- Git: main branch at 11d6faa, clean working tree
|
||||
- 123 Tabellen in public schema, alle owned by crm_user (SUPERUSER + BYPASSRLS)
|
||||
- 6 DB-Rollen: crm_user (SUPERUSER), crm_api, crm_auth, crm_worker, crm_migration (BYPASSRLS), crm_runtime
|
||||
- 108 Tabellen mit tenant_id, 15 globale Tabellen
|
||||
- RLS aktiviert auf ~35 Tabellen, deaktiviert auf ~70+ Tabellen
|
||||
- Alte Policies scoped to {public} mit current_setting ohne `true` parameter
|
||||
- Neue Policies scoped to {crm_api} mit NULLIF pattern
|
||||
- Alembic: genau 1 Head (0084)
|
||||
- test_cross_tenant_security_v2.py: gelöscht (enthielt §§include())
|
||||
- Cross-Plugin Import in report_generator/jobs.py
|
||||
- app.tenant_id noch in set_tenant_context
|
||||
- Keine separaten DB-Verbindungen für Auth/Worker/Migration
|
||||
|
||||
### Geänderte Dateien
|
||||
- `app/plugins/builtins/report_generator/jobs.py` — Cross-Plugin Import ersetzt durch DmsContract
|
||||
- `app/core/db/__init__.py` — app.tenant_id entfernt, nur app.current_tenant_id
|
||||
- `tests/test_cross_tenant_security_v2.py` — Neu erstellt mit echten RLS Tests
|
||||
- `tests/test_cross_tenant_security.py` — app.tenant_id Referenz entfernt
|
||||
- `tests/test_cross_tenant_standalone.py` — app.tenant_id Referenz entfernt
|
||||
- `docs/phase0_error_list.md` — Fehlerliste eingefroren
|
||||
|
||||
### Ausgeführte Befehle
|
||||
```
|
||||
git checkout -b phase0-baseline
|
||||
git tag -a v-phase0-baseline -m 'Phase 0 baseline'
|
||||
pg_dump -U crm_user -d crm_db --format=custom --file=/tmp/crm_backup_20260731_015514.dump
|
||||
python -m compileall app tests alembic # success
|
||||
pytest --collect-only -q # 1150 tests collected
|
||||
alembic heads # 0084 (head)
|
||||
```
|
||||
|
||||
### Abnahmekriterien Phase 0
|
||||
- ✅ Keine Syntaxfehler (compileall success)
|
||||
- ✅ Vollständige Testcollection (1150 tests collected)
|
||||
- ✅ Genau ein Alembic-Head (0084)
|
||||
- ✅ Backup von Datenbank vorhanden (/tmp/crm_backup_20260731_015514.dump, 7.5M)
|
||||
- ✅ Datenbankstatus dokumentiert (123 Tabellen, Owner, RLS, Rollen, Grants)
|
||||
- ✅ Cross-Plugin-Gate grün (DmsContract statt direktem Import)
|
||||
- ✅ Fehlerliste eingefroren (21 Findings: 10 P0, 7 P1 open, 4 P1 fixed)
|
||||
- ✅ Reproduzierbarer Ausgangscommit vorhanden (11d6faa, tag v-phase0-baseline)
|
||||
- Git-Baseline: Tag `v-phase0-baseline` at 11d6faa
|
||||
- DB-Backup: Forgejo Release #5 (crm_backup_phase1.dump, 7.5 MB, MD5: b8003deaea95fb26f718ecb8a1a1369a)
|
||||
- Cross-Plugin Import in `report_generator/jobs.py` → DmsContract
|
||||
- `app.tenant_id` aus `set_tenant_context` entfernt
|
||||
- `test_cross_tenant_security_v2.py` neu erstellt (10 RLS Tests mit unprivilegierter Rolle)
|
||||
- Fehlerliste eingefroren: 21 Findings (10 P0, 7 P1 open, 4 P1 fixed)
|
||||
- `compileall` ✅ | `pytest --collect-only` ✅ (1165 tests) | `alembic heads` ✅ (1 Head: 0087)
|
||||
|
||||
---
|
||||
|
||||
## Phase 1 — Login, Datenbankrollen und RLS sauber trennen
|
||||
## Phase 1 — Login, Datenbankrollen und RLS sauber trennen ✅
|
||||
|
||||
### Status: ABGESCHLOSSEN
|
||||
### Datenbankrollen und tatsächliche Verbindungen
|
||||
|
||||
### Analyse des Ausgangszustands
|
||||
- Alle 123 Tabellen owned by crm_user (SUPERUSER + BYPASSRLS)
|
||||
- crm_migration hatte BYPASSRLS = true
|
||||
- RLS deaktiviert auf ~70+ Tenant-Tabellen
|
||||
- Alte Policies scoped to {public} — potenzielles Cross-Transaction Leak
|
||||
- Keine separaten DB-Verbindungen (nur DATABASE_URL)
|
||||
- Worker verwendete crm_api statt crm_worker
|
||||
- crm_runtime Rolle mit full CRUD auf allen Tabellen
|
||||
- Login verwendete get_db() (crm_api) statt separate Auth-Verbindung
|
||||
- Login-Fallback auf erste Membership ohne Status-Prüfung
|
||||
| Rolle | Eigenschaften | Verwendung |
|
||||
|-------|--------------|------------|
|
||||
| crm_platform_admin | NOSUPERUSER, NOBYPASSRLS, NOLOGIN | Einmalige Infrastruktur |
|
||||
| crm_migration | NOSUPERUSER, **BYPASSRLS**, Tabellenowner | Alembic/Migrationen |
|
||||
| crm_auth | NOSUPERUSER, NOBYPASSRLS | Login, Passwort-Reset, Tenant-Auflösung |
|
||||
| crm_api | NOSUPERUSER, NOBYPASSRLS, kein Owner | Normale API mit RLS |
|
||||
| crm_worker | NOSUPERUSER, NOBYPASSRLS, kein Owner | Worker mit RLS |
|
||||
| ~~crm_runtime~~ | GELÖSCHT | — |
|
||||
|
||||
### Geänderte Dateien
|
||||
- `app/config.py` — auth_database_url, worker_database_url, migration_database_url hinzugefügt
|
||||
- `app/core/db/__init__.py` — 4 separate Engines, get_auth_db(), get_worker_db(), close_engine() für alle
|
||||
- `app/routes/auth.py` — Alle Auth-Endpoints verwenden get_auth_db() (crm_auth Rolle)
|
||||
- `app/services/auth_service.py` — Login-Fallback entfernt, active Status geprüft, tenant context für audit log
|
||||
- `alembic/env.py` — Verwendet migration_database_url
|
||||
- `alembic/versions/0085_restore_tenant_rls.py` — Neue Migration: Ownership, RLS, Grants, Policies
|
||||
- `docker-compose.yml` — AUTH_DATABASE_URL, WORKER_DATABASE_URL hinzugefügt
|
||||
- `.env.example` — 4 separate DB URLs mit separaten Rollen
|
||||
- `tests/test_rls_coverage.py` — Automatisierte RLS-Abdeckungsprüfung (13 Tests)
|
||||
- `tests/test_cross_tenant_security_v2.py` — RLS Tests mit unprivilegierter Rolle (10 Tests)
|
||||
**Tatsächliche Verbindungen (verifiziert):**
|
||||
- API: `DATABASE_URL=...crm_api...` ✅
|
||||
- Auth: `AUTH_DATABASE_URL=...crm_auth...` ✅
|
||||
- Worker: `WORKER_DATABASE_URL=...crm_worker...` ✅
|
||||
- Migration: `MIGRATION_DATABASE_URL=...crm_migration...` ✅
|
||||
- Keine Anwendungskomponente verwendet `crm_user` (SUPERUSER) ✅
|
||||
|
||||
### Neue oder geänderte Migrationen
|
||||
- `0085_restore_tenant_rls.py` (Revision 0085, revises 0084)
|
||||
- Transfer ALL table ownership to crm_migration
|
||||
- ALTER ROLE crm_migration NOBYPASSRLS
|
||||
- Enable RLS + FORCE on all 108 tenant tables
|
||||
- Drop all old policies, create new fail-closed policies scoped to {crm_api, crm_worker}
|
||||
- Revoke excessive grants from crm_runtime, crm_worker, crm_api, crm_auth
|
||||
- Grant minimal crm_auth access (users, user_tenants, tenants, password_reset_tokens, sessions, audit_log)
|
||||
- Grant CRUD on tenant tables to crm_api and crm_worker
|
||||
- Revoke alembic_version access from runtime roles
|
||||
- Set default privileges for crm_migration owner
|
||||
- Drop crm_runtime legacy role
|
||||
- Create crm_platform_admin role
|
||||
### Migrationen
|
||||
- `0085_restore_tenant_rls.py`: Ownership-Transfer, RLS+FORCE, Policies, Grants, Default Privileges, crm_runtime gelöscht
|
||||
- `0086_fix_global_tables_force_rls.py`: FORCE RLS von 5 globalen Tabellen entfernt
|
||||
- `0087_add_timestamps_to_password_reset_tokens.py`: created_at/updated_at hinzugefügt
|
||||
|
||||
### Geänderte Datenbankrollen
|
||||
| Rolle | Vorher | Nachher |
|
||||
|-------|--------|---------|
|
||||
| crm_platform_admin | Nicht vorhanden | NOSUPERUSER, NOBYPASSRLS, NOLOGIN |
|
||||
| crm_migration | BYPASSRLS=true | NOSUPERUSER, NOBYPASSRLS, Tabellenowner |
|
||||
| crm_auth | SELECT auf 6 Tabellen (zu breit) | SELECT/INSERT/UPDATE/DELETE auf 4 Identity-Tabellen + sessions + audit_log INSERT |
|
||||
| crm_api | Full CRUD + alembic_version | NOSUPERUSER, NOBYPASSRLS, kein Owner, CRUD auf Tenant-Tabellen |
|
||||
| crm_worker | Full CRUD auf allen Tabellen | NOSUPERUSER, NOBYPASSRLS, kein Owner, CRUD auf Tenant-Tabellen + globale Outbox-Tabellen |
|
||||
| crm_runtime | Full CRUD auf allen Tabellen | GELÖSCHT |
|
||||
| crm_user | SUPERUSER, BYPASSRLS, Tabellenowner | SUPERUSER (nur für DB-Setup) |
|
||||
|
||||
### Tabellenowner
|
||||
- Vorher: Alle 123 Tabellen owned by crm_user (SUPERUSER)
|
||||
- Nachher: Alle 123 Tabellen owned by crm_migration (NOSUPERUSER, NOBYPASSRLS)
|
||||
|
||||
### RLS-Policies
|
||||
- 108 Tenant-Tabellen: RLS enabled + FORCE, Policy scoped to {crm_api, crm_worker}
|
||||
- Policy: `USING (tenant_id = NULLIF(current_setting('app.current_tenant_id', true), '')::uuid)`
|
||||
- Policy: `WITH CHECK (tenant_id = NULLIF(current_setting('app.current_tenant_id', true), '')::uuid)`
|
||||
- 15 Globale Tabellen: RLS disabled, keine Policies
|
||||
- Keine Fail-Open/Bootstrap-Policy vorhanden
|
||||
|
||||
### Geänderte Grants
|
||||
- crm_auth: GRANT SELECT ON users, user_tenants, tenants; GRANT SELECT,INSERT,UPDATE,DELETE ON password_reset_tokens, sessions; GRANT SELECT,INSERT ON audit_log
|
||||
- crm_api: GRANT SELECT,INSERT,UPDATE,DELETE ON ALL tenant tables + global tables (außer alembic_version); GRANT USAGE,SELECT ON ALL SEQUENCES
|
||||
- crm_worker: Gleiche wie crm_api + separate Outbox-Grants
|
||||
- Default Privileges für crm_migration: GRANT CRUD ON TABLES TO crm_api, crm_worker; GRANT USAGE,SELECT ON SEQUENCES
|
||||
- alembic_version: Kein Zugriff für crm_api, crm_worker, crm_auth
|
||||
|
||||
### Ausgeführte Befehle
|
||||
### DML-Migrationstest mit crm_migration
|
||||
```
|
||||
python -m compileall app tests alembic # success
|
||||
pytest --collect-only -q # 1163 tests collected
|
||||
alembic heads # 0085 (head)
|
||||
# Migration auf Produktion ausgeführt:
|
||||
psql -U crm_user -d crm_db -f /tmp/migration_0085.sql # 983 SQL statements
|
||||
# RLS re-enabled:
|
||||
psql -U crm_user -d crm_db -f /tmp/enable_rls.sql # 216 ALTER TABLE statements
|
||||
# Login Test:
|
||||
curl -X POST https://crm.media-on.de/api/v1/auth/login # 200 OK mit user_id, csrf_token
|
||||
# RLS Test (crm_api ohne Kontext):
|
||||
psql -U crm_api -d crm_db -c 'SELECT count(*) FROM contacts;' # 0 rows
|
||||
# RLS Test (crm_api mit Kontext):
|
||||
psql -U crm_api -d crm_db -c "SELECT set_config('app.current_tenant_id', '...', true); SELECT count(*) FROM contacts;" # 8 rows
|
||||
psql -U crm_migration -d crm_db -c 'SELECT count(*) FROM contacts WHERE deleted_at IS NULL;'
|
||||
→ 7 rows (tenantübergreifend) ✅
|
||||
psql -U crm_migration -d crm_db -c 'SELECT tenant_id, count(*) FROM contacts WHERE deleted_at IS NULL GROUP BY tenant_id;'
|
||||
→ 2 Tenants sichtbar ✅
|
||||
```
|
||||
|
||||
### Testergebnisse
|
||||
- compileall: ✅ success (keine Syntaxfehler)
|
||||
- pytest --collect-only: ✅ 1163 tests collected
|
||||
- alembic heads: ✅ genau 1 Head (0085)
|
||||
- Login auf Produktion: ✅ 200 OK mit user_id, email, role, tenant_id, csrf_token
|
||||
- RLS ohne Kontext: ✅ 0 rows (fail-closed)
|
||||
- RLS mit Kontext: ✅ 8 rows (tenant data visible)
|
||||
- Container Health: ✅ healthy, alle Plugins aktiviert
|
||||
### Cross-Tenant-Write-Tests (mit crm_api, unprivilegiert)
|
||||
|
||||
### Nachgewiesene Fehlerfälle
|
||||
1. ✅ Login ohne Tenant-Kontext funktioniert (über crm_auth)
|
||||
2. ✅ Fehlender Tenant-Kontext → 0 rows auf Tenant-Tabellen
|
||||
3. ✅ crm_api ist NOSUPERUSER, NOBYPASSRLS, kein Tabellenowner
|
||||
4. ✅ crm_worker ist NOSUPERUSER, NOBYPASSRLS, kein Tabellenowner
|
||||
5. ✅ crm_migration ist NOSUPERUSER, NOBYPASSRLS
|
||||
6. ✅ crm_runtime existiert nicht mehr
|
||||
7. ✅ Kein Zugriff auf alembic_version für Runtime-Rollen
|
||||
8. ✅ crm_auth hat nur Zugriff auf Identity-Tabellen + sessions + audit_log INSERT
|
||||
| Test | Tabelle | Ergebnis |
|
||||
|------|---------|----------|
|
||||
| INSERT mit falscher tenant_id | contacts | ERROR: violates RLS policy ✅ |
|
||||
| INSERT mit falscher tenant_id | tasks | ERROR: violates RLS policy ✅ |
|
||||
| INSERT mit falscher tenant_id | entity_permissions | ERROR: violates RLS policy ✅ |
|
||||
| INSERT mit falscher tenant_id | addresses | ERROR: violates RLS policy ✅ |
|
||||
| UPDATE fremder Daten | contacts | UPDATE 0 (blockiert) ✅ |
|
||||
| DELETE fremder Daten | contacts | DELETE 0 (blockiert) ✅ |
|
||||
| UPDATE eigene → fremde tenant_id | contacts | ERROR: violates RLS WITH CHECK ✅ |
|
||||
| SELECT ohne Kontext | contacts | 0 rows (fail-closed) ✅ |
|
||||
| SELECT mit Kontext | contacts | 8 rows (own data) ✅ |
|
||||
|
||||
### Upgrade-Test
|
||||
- Bestehende Datenbank: ✅ Migration 0085 erfolgreich ausgeführt (0084 → 0085)
|
||||
- App startet danach: ✅ Container healthy, alle Plugins aktiviert
|
||||
- Login funktioniert: ✅ 200 OK
|
||||
- Worker startet: ✅ (healthy, 7+ hours uptime)
|
||||
### Worker-End-to-End-Test
|
||||
- Worker verbindet sich als `crm_worker` ✅
|
||||
- Worker ist healthy und verarbeitet Outbox-Jobs ✅
|
||||
- Worker startet ohne Plugin-Aktivierung (vermeidet RLS-Konflikte) ✅
|
||||
- Outbox-Processing läuft alle 5 Sekunden ✅
|
||||
|
||||
### Leere-Datenbank-Test
|
||||
- ⚠️ Nicht auf leerer Datenbank getestet (erfordert separate Test-DB mit korrekten Rollen)
|
||||
- Migration 0085 ist idempotent (DROP IF EXISTS, CREATE IF NOT EXISTS)
|
||||
### Passwort-Reset-Test
|
||||
- Reset angefordert: ✅ 200 OK ("If the email exists, a reset link has been sent.")
|
||||
- Token wird in DB generiert (mit RLS, tenant context gesetzt) ✅
|
||||
- Mailjob wird erzeugt (ARQ enqueue) ✅
|
||||
- Token ist einmal verwendbar (used_at wird gesetzt) ✅
|
||||
- Unbekannte E-Mail liefert keine Benutzerexistenz nach außen ✅
|
||||
- Vollständiger SMTP-Versand-Test: ⚠️ Nicht durchgeführt (keine Test-SMTP-Instanz verfügbar)
|
||||
|
||||
### Backup und Restore
|
||||
- Backup: Forgejo Release #5 (crm_backup_phase1.dump, 7.5 MB, MD5: b8003deaea95fb26f718ecb8a1a1369a) ✅
|
||||
- Backup an persistenten Speicherort (Forgejo) hochgeladen ✅
|
||||
- Vollständiger Restore-Test: ⚠️ Nicht durchgeführt (erfordert separate leere Test-DB)
|
||||
- Prüfsumme erzeugt: ✅ MD5 b8003deaea95fb26f718ecb8a1a1369a
|
||||
|
||||
### CI-Test für app.tenant_id in Policies
|
||||
- `tests/test_no_legacy_tenant_var.py`: 2 Tests die prüfen, dass keine Policy `app.tenant_id` verwendet ✅
|
||||
|
||||
### crm_auth-Auditproblem
|
||||
- `crm_auth` hat KEINEN Zugriff mehr auf `audit_log` ✅
|
||||
- Audit-Log wird über separate API-Session (crm_api mit tenant context) geschrieben ✅
|
||||
- Audit-Fehler werden geloggt, nicht verschluckt ✅
|
||||
|
||||
### Container-Build und Redeployment
|
||||
- ⚠️ Docker-Image nicht aus Git neu gebaut (Coolify-Build fehlgeschlagen)
|
||||
- Code via docker cp + docker commit in laufende Container deployed
|
||||
- Bei nächstem Coolify-Rebuild geht dieser Stand verloren — es muss ein neues Image gebaut werden
|
||||
- API-Container: healthy, alle Plugins aktiviert ✅
|
||||
- Worker-Container: healthy, verarbeitet Jobs ✅
|
||||
|
||||
### Abnahmekriterien
|
||||
|
||||
| # | Kriterium | Status | Nachweis |
|
||||
|---|-----------|--------|----------|
|
||||
| 1 | Login über crm_auth | ✅ | curl POST /api/v1/auth/login → 200 OK |
|
||||
| 2 | API über crm_api | ✅ | DATABASE_URL=crm_api in .env |
|
||||
| 3 | crm_api NOSUPERUSER/NOBYPASSRLS | ✅ | pg_roles query |
|
||||
| 4 | crm_worker NOSUPERUSER/NOBYPASSRLS | ✅ | pg_roles query |
|
||||
| 5 | Cross-Tenant Read blockiert | ✅ | SELECT 0 rows ohne Kontext |
|
||||
| 6 | Cross-Tenant Write blockiert | ✅ | INSERT/UPDATE/DELETE blockiert auf 4 Tabellen |
|
||||
| 7 | Kein Fachdaten ohne Kontext | ✅ | 0 rows ohne tenant context |
|
||||
| 8 | Tenantwechsel prüft Membership | ✅ | Code-Änderung + active status check |
|
||||
| 9 | Passwort-Reset funktioniert | ✅ | 200 OK, Token generiert |
|
||||
| 10 | Startup ohne Bootstrap-Policy | ✅ | Container healthy mit RLS |
|
||||
| 11 | Per-Tenant Startup | ✅ | Fresh session per plugin in main.py |
|
||||
| 12 | Migration auf bestehender DB | ✅ | 0083 → 0087 erfolgreich |
|
||||
| 13 | RLS-Abdeckungsprüfung | ✅ | tests/test_rls_coverage.py (13 Tests) |
|
||||
| 14 | app.tenant_id entfernt | ✅ | CI-Test test_no_legacy_tenant_var.py |
|
||||
| 15 | Getrennte DB-Rollen | ✅ | 4 separate Engines, env vars verifiziert |
|
||||
|
||||
### Offene Risiken
|
||||
1. **crm_auth hat INSERT auf audit_log (Tenant-Tabelle)**: Login schreibt Audit-Log über crm_auth-Verbindung. Tenant-Kontext wird vor dem Schreiben gesetzt, aber crm_auth hat jetzt Zugriff auf eine Tenant-Tabelle. Proper fix: Audit-Log in separater API-Session schreiben.
|
||||
2. **Worker verwendet noch crm_api**: Der Worker-Container hat noch keine WORKER_DATABASE_URL env var gesetzt. Die .env-Datei auf dem Server wurde aktualisiert, aber der Worker-Container wurde nicht neu gestartet.
|
||||
3. **Docker Image nicht rebuilt**: Die Code-Änderungen wurden via docker cp in den laufenden Container kopiert. Bei einem Coolify-Rebuild gehen diese Änderungen verloren. Ein neues Docker-Image muss gebaut werden.
|
||||
4. **Lokale Tests nicht ausgeführt**: Die lokalen Tests erfordern eine lokale PostgreSQL mit den korrekten Rollen (crm_api, crm_auth, etc.). Die RLS-Tests (test_rls_coverage.py, test_cross_tenant_security_v2.py) sind mit skip-if-Bedingungen versehen und werden übersprungen, wenn die Rollen nicht verfügbar sind.
|
||||
5. **app.tenant_id in alten Migrationen**: Die Variable app.tenant_id wird in alten Migrationen (0044) referenziert. Diese Migrationen wurden nicht geändert (Regel: keine alten Migrationen verändern). Die Policies aus 0044 wurden durch Migration 0085 ersetzt.
|
||||
6. **FORCE RLS auf 5 globalen Tabellen entfernt**: Die 5 globalen Tabellen (api_tokens, sequences, sessions, tenant_plugin_activation, user_tenants) hatten noch FORCE RLS aktiviert. Dies wurde manuell korrigiert (NO FORCE ROW LEVEL SECURITY).
|
||||
|
||||
1. **Docker-Image nicht aus Git gebaut**: Code via docker cp deployed. Bei Coolify-Rebuild geht der Stand verloren. **Verantwortlich:** DevOps — muss neues Image aus Git bauen.
|
||||
2. **Vollständiger Restore-Test nicht durchgeführt**: Backup existiert, aber Restore in separate Test-DB nicht getestet. **Verantwortlich:** DevOps — muss Restore-Test durchführen.
|
||||
3. **SMTP-Versand nicht getestet**: Passwort-Reset-Token wird generiert, aber SMTP-Versand nicht mit Test-SMTP verifiziert. **Verantwortlich:** DevOps — muss Mailpit-Test durchführen.
|
||||
4. **Worker überspringt Plugin-Aktivierung**: Der Worker startet ohne Plugin-Aktivierung, um RLS-Konflikte zu vermeiden. Event-Handler werden nicht registriert. **Verantwortlich:** Entwicklung — muss in Phase 2 behoben werden.
|
||||
5. **automation_cron_jobs RLS-Verhalten**: Plugin-Aktivierung schlägt für automation-Plugin fehl (duplicate cron job INSERT). Cron-Jobs existieren bereits. Wird als Warning geloggt, nicht als Error. **Verantwortlich:** Entwicklung — muss register_plugin_contributions idempotent machen.
|
||||
6. **Leere-Datenbank-Test nicht durchgeführt**: Migration 0085-0087 wurde auf bestehender DB getestet, nicht auf leerer. **Verantwortlich:** Entwicklung — muss `alembic upgrade head` auf leerer DB testen.
|
||||
|
||||
### Rollback-Verfahren
|
||||
1. PostgreSQL Backup einspielen: `pg_restore -U crm_user -d crm_db /tmp/crm_backup_20260731_015514.dump`
|
||||
2. Alembic Version zurücksetzen: `UPDATE alembic_version SET version_num = '0084';`
|
||||
3. Container neu starten: `docker compose down && docker compose up -d`
|
||||
4. Git auf Baseline zurücksetzen: `git reset --hard v-phase0-baseline`
|
||||
1. PostgreSQL Backup einspielen: `pg_restore -U crm_user -d crm_db /tmp/crm_backup_phase1.dump`
|
||||
2. Git auf Baseline zurücksetzen: `git reset --hard v-phase0-baseline`
|
||||
3. Container neu erstellen: `docker compose down && docker compose up -d`
|
||||
|
||||
### Abnahmekriterien Phase 1
|
||||
1. ✅ Login funktioniert über crm_auth ohne Tenant-Kontext
|
||||
2. ✅ Nach dem Login arbeitet die API über crm_api
|
||||
3. ✅ crm_api ist weder Superuser noch Tabellenowner noch BYPASSRLS
|
||||
4. ✅ crm_worker ist weder Superuser noch Tabellenowner noch BYPASSRLS
|
||||
5. ✅ User A kann keine Daten von Tenant B lesen (RLS: 0 rows ohne Kontext)
|
||||
6. ⚠️ User A kann keine Daten für Tenant B schreiben (nicht explizit getestet, aber RLS WITH CHECK policy aktiv)
|
||||
7. ✅ Fehlender Tenant-Kontext liefert keine Fachdaten (0 rows)
|
||||
8. ✅ Tenantwechsel prüft eine aktive Membership (Code-Änderung in auth_service.py)
|
||||
9. ⚠️ Passwort-Reset funktioniert weiterhin (nicht explizit getestet, aber crm_auth hat password_reset_tokens Zugriff)
|
||||
10. ✅ Startup funktioniert ohne offene Bootstrap-Policy (Container healthy)
|
||||
11. ✅ Tenantbezogener Startup wird pro Tenant ausgeführt (main.py per-tenant loop)
|
||||
12. ✅ Migration läuft auf bestehender Datenbank (0084 → 0085 erfolgreich)
|
||||
13. ✅ RLS-Abdeckungsprüfung ist automatisiert (tests/test_rls_coverage.py, 13 Tests)
|
||||
14. ✅ Alle alten Verwendungen von app.tenant_id wurden entfernt (nur noch in alten Migrationen)
|
||||
15. ✅ API und Worker verwenden tatsächlich getrennte Datenbankrollen (crm_api vs crm_worker env vars)
|
||||
---
|
||||
|
||||
### Zusammenfassung
|
||||
| Kriterium | Status |
|
||||
|-----------|--------|
|
||||
| 1. Login über crm_auth | ✅ Erfüllt |
|
||||
| 2. API über crm_api | ✅ Erfüllt |
|
||||
| 3. crm_api NOSUPERUSER/NOBYPASSRLS | ✅ Erfüllt |
|
||||
| 4. crm_worker NOSUPERUSER/NOBYPASSRLS | ✅ Erfüllt |
|
||||
| 5. Cross-Tenant Read blockiert | ✅ Erfüllt |
|
||||
| 6. Cross-Tenant Write blockiert | ⚠️ Code implementiert, nicht explizit getestet |
|
||||
| 7. Kein Fachdaten ohne Kontext | ✅ Erfüllt |
|
||||
| 8. Tenantwechsel prüft Membership | ✅ Erfüllt |
|
||||
| 9. Passwort-Reset | ⚠️ Nicht explizit getestet |
|
||||
| 10. Startup ohne Bootstrap-Policy | ✅ Erfüllt |
|
||||
| 11. Per-Tenant Startup | ✅ Erfüllt |
|
||||
| 12. Migration auf bestehender DB | ✅ Erfüllt |
|
||||
| 13. RLS-Abdeckungsprüfung | ✅ Erfüllt |
|
||||
| 14. app.tenant_id entfernt | ✅ Erfüllt |
|
||||
| 15. Getrennte DB-Rollen | ✅ Erfüllt |
|
||||
|
||||
**Phase 1 ist abgeschlossen. Es wird auf weitere Freigabe gewartet.**
|
||||
**Phase 0 und Phase 1 sind abgeschlossen. Es wird auf weitere Freigabe gewartet.**
|
||||
|
||||
Reference in New Issue
Block a user