Fase 3 — Definitieve deployment

Doel

De definitieve klantsite bouwen (met de input uit de intake) en deployen naar het Cloudflare-account dat speciaal voor deze klant is aangemaakt.

Wanneer gebruik je dit

• Status in registry is intake-ontvangen
• Klant heeft betaald
• Je hebt een Cloudflare-account aangemaakt voor deze klant waar info@zakelijkgroeien.nl als Super Administrator is uitgenodigd (en die invite is geaccepteerd)

Caution

De klant-accounts blijven in ons eigen beheer. De klant krijgt geen toegang tot het Cloudflare-dashboard; wij hosten voor hen.

Voorbereiding (eenmalig per klant)

A. Cloudflare-account opzetten

1. Log in als info@zakelijkgroeien.nl op dash.cloudflare.com
2. Maak een nieuw account aan met de klantnaam (bv. "Jan de Vries BV")
3. Bevestig het account via de mail die binnenkomt
4. Noteer de Account ID (rechterkant van het account home scherm)

Tip

De CLOUDFLARE_DEPLOYER_TOKEN die we gebruiken is gescoped op All accounts, dus nieuwe klantaccounts zijn automatisch bereikbaar — geen nieuwe token per klant.

B. Domein via Versio

De klant bezit meestal het domein. Wij zetten alleen een CNAME bij hun registrar (Versio of anders) die wijst naar de Cloudflare Pages preview. Details volgen in fase 4 / custom domain setup.

Stappen

1. Open het dashboard

intake-portal.pages.dev → zoek de client met status intake-ontvangen → klik op Deploy.

2. Vul het deploy-modal

Veld	Wat vul je in
Cloudflare Account ID	Account ID uit de voorbereiding
Domein	Uiteindelijke domein van de klant (bv. jandevries.nl)
Regenereer	✓ aangevinkt = opnieuw genereren mét intake-data (aanbevolen)

Klik op Start Deploy.

3. Wat gebeurt er

Workflow generate-final-site.yml draait:

1. Registry wordt geüpdatet met cloudflare_account_id en domein
2. Als regenereer = true:
   • Laadt de intake-data (intakes/{token}/intake_responses.json)
   • Laadt de LinkedIn-baseline (intakes/{token}/linkedin_payload.json)
   • Roept generate.py aan voor een nieuwe variatie mét klantfeedback
   • Review-loop zoals fase 1
3. Astro build wordt uitgevoerd
4. Wrangler deployt naar Pages-project in het klant-account
5. Cloudflare API call koppelt het custom domein aan het project
6. Registry-status gaat naar definitief

Duurt meestal 6–10 minuten. Volg op: github.com/zakelijkgroeien/ai-website-builder/actions

4. Verifieer de live-site

Dashboard toont de live-URL zodra de deploy groen is. Check:

• [ ] Site laadt op https://{klantdomein}
• [ ] Contactformulier werkt (als aanwezig)
• [ ] Geen console errors
• [ ] Mobiele weergave oké

Deploy zónder regeneratie

Handig als je handmatig content hebt aangepast op de sites/{slug} branch en alleen die staat wilt deployen.

In het dashboard: vink Regenereer uit.

Via CLI:

python deploy_definitief.py --client-slug jan-de-vries --no-regenereer

Backup: CLI

# Eenmalig koppelen (als je niet via dashboard-modal gaat)
python setup_client.py --client-slug jan-de-vries \
  --cloudflare-account-id ABC123 --domein jandevries.nl

# Deploy triggeren
python deploy_definitief.py --client-slug jan-de-vries

Troubleshooting

Authentication error [code: 10000]

De CLOUDFLARE_DEPLOYER_TOKEN heeft geen toegang tot het klant-account. Oorzaken:

• info@zakelijkgroeien.nl heeft de invite op het klant-account nog niet geaccepteerd
• De token is gescoped op één specifiek account in plaats van All accounts
• De token is aangemaakt vóór de invite-acceptatie (zeldzaam maar komt voor)

Fix: regenereer de token met Account Resources → All accounts en update het GitHub secret.

Resource not accessible by personal access token

De GITHUB_PAT mist Actions: write scope. Ga naar je fine-grained PAT in GitHub settings en voeg die permission toe voor deze repo.

Pages project already exists

Normaal — de workflow skipt het aanmaken en gebruikt het bestaande project. Geen actie nodig.

Custom domain blijft op 'Verifying'

Controleer of de CNAME bij Versio correct is gezet naar {slug}.pages.dev. DNS-propagatie kan tot 30 min duren.

Na succes

• [ ] Status in registry is definitief
• [ ] Live-URL werkt
• [ ] Klant geïnformeerd met login-instructies voor Keystatic (als je die aanbiedt voor eigen content-updates)
• [ ] Versio CNAME staat correct

De site is nu volledig in productie. Verdere content-updates gaan via de Keystatic CMS op de sites/{slug} branch — redeploy-on-content-change.yml zorgt dat elke commit automatisch een rebuild triggert.