Add MVP operational readiness checks
This commit is contained in:
50
docs/coolify-deployment.md
Normal file
50
docs/coolify-deployment.md
Normal file
@@ -0,0 +1,50 @@
|
||||
# Coolify Deployment
|
||||
|
||||
## Environment Variables
|
||||
|
||||
Set production values in Coolify and Convex secrets, not in source code.
|
||||
|
||||
- `APP_ENV`
|
||||
- `NEXT_PUBLIC_APP_URL`
|
||||
- `NEXT_PUBLIC_CONVEX_URL`
|
||||
- `NEXT_PUBLIC_CONVEX_SITE_URL`
|
||||
- `CONVEX_DEPLOYMENT`
|
||||
- `BETTER_AUTH_SECRET`
|
||||
- `GOOGLE_GEOCODING_API_KEY`
|
||||
- `GOOGLE_PLACES_API_KEY`
|
||||
- `PAGESPEED_API_KEY`
|
||||
- `PAGESPEED_TIMEOUT_MS`
|
||||
- `OPENROUTER_API_KEY`
|
||||
- `OPENROUTER_MODEL_CLASSIFICATION`
|
||||
- `OPENROUTER_MODEL_MULTIMODAL_AUDIT`
|
||||
- `OPENROUTER_MODEL_GERMAN_COPY`
|
||||
- `OPENROUTER_MODEL_QUALITY_REVIEW`
|
||||
- `OPENROUTER_APP_NAME`
|
||||
- `OPENROUTER_APP_URL`
|
||||
- `SMTP_HOST`
|
||||
- `SMTP_PORT`
|
||||
- `SMTP_USER`
|
||||
- `SMTP_PASSWORD`
|
||||
- `SMTP_FROM`
|
||||
- `RYBBIT_API_URL`
|
||||
- `RYBBIT_API_KEY`
|
||||
- `NEXT_PUBLIC_RYBBIT_SITE_ID`
|
||||
- `TASK8_BROWSER_ASSET_URL`
|
||||
|
||||
## Build And Runtime
|
||||
|
||||
Coolify commands:
|
||||
|
||||
- Install: `pnpm install --frozen-lockfile`
|
||||
- Build: `pnpm build`
|
||||
- Start: `pnpm start`
|
||||
|
||||
Expose Port 3000 from the Next.js container.
|
||||
|
||||
## Playwright
|
||||
|
||||
Website enrichment uses `playwright-core` with a hosted Chromium bundle. Configure `TASK8_BROWSER_ASSET_URL` to a reachable browser asset. If the platform image also installs system browser dependencies, keep them aligned with the Chromium bundle used by `@sparticuz/chromium-min`.
|
||||
|
||||
## Domains
|
||||
|
||||
Set `NEXT_PUBLIC_APP_URL` to the public dashboard Domain. Configure Convex deployment URLs in `NEXT_PUBLIC_CONVEX_URL` and `NEXT_PUBLIC_CONVEX_SITE_URL`. Public audit links assume the same app domain unless a reverse proxy maps `/audit/*` separately.
|
||||
46
docs/verification.md
Normal file
46
docs/verification.md
Normal file
@@ -0,0 +1,46 @@
|
||||
# MVP Verification Notes
|
||||
|
||||
Diese Checkliste ist die wiederholbare manuelle Prüfung für die kritischen MVP-Flows.
|
||||
|
||||
## Login
|
||||
|
||||
1. `/login` öffnen.
|
||||
2. Mit Admin-Zugang anmelden.
|
||||
3. Prüfen, dass `/dashboard` erreichbar ist und geschützte Routen ohne Session zurück zu `/login` gehen.
|
||||
|
||||
## Kampagnenlauf
|
||||
|
||||
1. Kampagne mit deutscher PLZ und aktivem Status anlegen.
|
||||
2. `Jetzt ausführen` starten.
|
||||
3. In Kampagnen-Run-Logs prüfen, dass der Lauf `pending/running/succeeded` oder ein sichtbarer Fehlerstatus wird.
|
||||
|
||||
## Audit-Generierung
|
||||
|
||||
1. Lead mit Website durch Enrichment/PageSpeed laufen lassen.
|
||||
2. Prüfen, dass PageSpeed-Erfolg oder -Fehler Audit-Generierung queued.
|
||||
3. Im Outreach Review Workspace prüfen, dass Audit-Text, Quellen und Skills sichtbar sind.
|
||||
|
||||
## Freigabe
|
||||
|
||||
1. Public-Audit-Text editieren.
|
||||
2. Änderungen speichern.
|
||||
3. Audit veröffentlichen und öffentliche Audit-URL öffnen.
|
||||
|
||||
## Versand
|
||||
|
||||
1. E-Mail-Betreff und Text prüfen.
|
||||
2. E-Mail freigeben.
|
||||
3. Finale SMTP-Bestätigung kontrollieren und senden.
|
||||
4. Bei SMTP-Fehler prüfen, dass der Datensatz retrybar bleibt und keine Credentials angezeigt werden.
|
||||
|
||||
## Follow-up
|
||||
|
||||
1. Nach Erstversand prüfen, dass ein Follow-up-Draft mit Due-Date entsteht.
|
||||
2. Follow-up erst nach manueller Review/Freigabe senden.
|
||||
3. `Antwort erhalten` oder `Kein Interesse` setzen und prüfen, dass Follow-up-Prompts verschwinden.
|
||||
|
||||
## Analytics
|
||||
|
||||
1. Öffentliche Audit-Seite öffnen und CTA klicken.
|
||||
2. `/dashboard/analytics` prüfen.
|
||||
3. Convex-Metriken und Rybbit-Fehlerzustand bzw. Rybbit-Signale kontrollieren.
|
||||
Reference in New Issue
Block a user