create-vizion-digital-agency 1.2.1 → 1.2.3

package/README.md

@@ -8,24 +8,58 @@ npm create vizion-digital-agency@latest -- beheer    # in (een map van) een proj
 npm create vizion-digital-agency@latest -- --help    # alle opties
 ```
 
-**Een nieuw project:** je beantwoordt de vragen, en de CLI maakt het project met alleen wat je kiest. Daarna doet hij
-altijd zelf: de packages installeren, git met een eerste commit, alles starten in Docker en controleren dat het werkt.
-Dan begint de **opzet-assistent**: GitHub, de VPS bij TransIP, back-ups (TransIP Object Store), e-mail (Brevo), DNS (dat
-doe jij; hij zegt precies welke records), de server met Ansible (meteen in Tailscale; daarna is poort 22 dicht),
-bewaking, foutmeldingen en de eerste uitrol tot de site antwoordt. Wat hij zelf kan, doet hij; wat alleen jij kunt
-(iets bestellen, een account maken, inloggen met 2FA, de DNS), legt hij stap voor stap uit. Stoppen mag altijd.
+## Voordat je begint
+
+Eén keer per computer, meer niet:
+
+| Wat | Hoe | Klaar als |
+| --- | --- | --- |
+| **Node.js 24** (LTS) | Windows: `winget install OpenJS.NodeJS.LTS` · macOS: `brew install node@24` | `node -v` geeft `v24.…` |
+| **Git**, met je naam | `winget install Git.Git` · `brew install git`; dan `git config --global user.name "Je Naam"` en `user.email` | `git --version` werkt |
+| **Toegang tot GitHub** | Je account in de organisatie **Vizion-Digital-Agency** (een beheerder nodigt je uit; 2FA aan). De eerste keer opent Git een browser om in te loggen | `git ls-remote https://github.com/Vizion-Digital-Agency/create-vizion-digital-agency` geeft geen fout |
+| **Docker Desktop** | docker.com (Windows: met WSL 2), minstens 4 GB geheugen | Docker Desktop draait |
+| **Een password manager** | Bitwarden of 1Password | Open, als je begint |
+
+**De rest regelt de prompt:** de packages van het project, de GitHub-CLI en de Tailscale-app (die installeert hij, na
+een ja), een SSH-sleutel, en de accounts (bij elke stap zegt hij welk account, waar je het maakt en wat je plakt).
+Elke keer: Docker Desktop aan, en start in de map waar je projecten staan.
+
+**Een nieuw project** begint met **het takenplan**: één genummerde lijst van alles, per sectie, van de eerste vraag tot
+de klant. Dezelfde lijst zie je daarna steeds terug, met ✓ voor wat klaar is.
+
+1. **Het project: alle instellingen** (± 10 minuten): Onderdelen (mobiele app, AI-service), Naam, Domein en poorten
+   (standaard het testdomein), Functies (wat er altijd in zit, en organisaties, bestanden, virusscanner), Inloggen
+   (social login, minimumleeftijd, de eerste beheerder), E-mail (altijd Brevo), Huisstijl en links, en de map.
+2. **Op je computer:** pas dan maakt de CLI het project, met alleen wat je koos, en doet hij altijd zelf: installeren,
+   git met een eerste commit, alles starten in Docker en controleren dat het werkt.
+3. **Live op het testdomein** (de opzet-assistent, meteen daarna): elk project komt eerst live op
+   `<naam>.ontwikkel-viziondigitalagency.nl`, met de e-mail vanaf `noreply@auth.ontwikkel-viziondigitalagency.nl`. Per
+   sectie: De VPS en de opslag (TransIP, TransIP Object Store), Domein en e-mail (DNS doe jij, hij zegt precies welke
+   records; Brevo), De server (Ansible, meteen in Tailscale; daarna is poort 22 dicht), Bewaking en foutmeldingen, De
+   diensten van de app, **GitHub** (de repository in de organisatie Vizion-Digital-Agency, pas nu, in één keer compleet),
+   Live, en Afronden. Wat hij zelf kan, doet hij; wat alleen jij kunt (iets bestellen, een account maken, inloggen met
+   2FA, de DNS), legt hij stap voor stap uit.
+4. **Later: naar de klant** (met `-- beheer`): bij de echte livegang het domein, de DNS, de e-mail en de afzender, de
+   links, het logo en de accounts van de klant.
+
+Stoppen mag altijd: met `-- beheer` ga je verder waar je was.
 
 **`-- beheer`** is een dashboard in de terminal voor alles daarna:
 
 - **Overzicht:** het project in één scherm.
 - **Live gaan:** de checklist, met per punt "Regelen".
-- **Opzetten:** de opzet-assistent, verder waar je was.
+- **Naar de klant:** van het testdomein naar de echte livegang, met per punt wat klaar is en "Regelen".
+- **Opzetten:** de opzet-assistent, per sectie, verder waar je was.
 - **Onderdelen en keuzes:** later aan- of uitzetten, met behoud van je eigen werk. Het dashboard ziet ook wat je zelf
   weghaalde of toevoegde.
 - **Diensten:** bijv. de opslag of e-mail wisselen.
-- **Instellingen:** het domein, de links naar de voorwaarden en de privacyverklaring, het logo.
-- **Server en onderhoud:** controleren, onderhoud, het verslag van Ansible.
+- **Instellingen:** elke instelling van het project met zijn waarde (geheimen alleen "ingevuld" of "leeg"); elke
+  instelling of API-sleutel opnieuw invullen; het domein, de links naar de voorwaarden en de privacyverklaring, het logo.
+- **Server en onderhoud:** wat er vanzelf gebeurt (op de server elke nacht en elke zondag, op GitHub elke maandag en
+  bij elke update van Dependabot), wat jij doet, **onderhoud nu** (zonder op zondag te wachten), en **groot onderhoud**:
+  een back-up maken, de onderhoudspagina aan (de app even offline), en weer uit. Ook: controleren, het verslag van Ansible.
 - **Versie en updates:** bijwerken naar een nieuwe versie van de template.
+- **Je computer** en **Techniek:** of alles klaarstaat, en elke techniek met waar de uitleg staat.
 
 Zonder dashboard (bijv. in een script):
 
@@ -38,8 +72,8 @@ npm create vizion-digital-agency@latest -- beheer wissel backups|bestanden # de
 npm create vizion-digital-agency@latest -- beheer server <opdracht>       # Ansible: controle, onderhoud, setup, project, test
 ```
 
-Wat er vooraf klaar moet staan, staat in elk project in `docs/1-voorbereiden.md`; het stappenplan in
-`docs/2-opzetten-en-live-zetten.md`, en alles na de livegang in `docs/3-na-de-livegang.md`.
+Alles wat je doet, van voorbereiden tot onderhoud, staat daarna in elk project in één document: `docs/stappenplan.md`
+(deel 1 voorbereiden, deel 2 `npm create`, deel 3 `-- beheer` en onderhoud).
 
 Dit pakket is alleen de opstarter. De componenten staan in een privé repository van Vizion Digital Agency en worden
 met je eigen Git-toegang opgehaald; zonder toegang tot die repository doet dit pakket niets.

package/index.mjs

@@ -18,7 +18,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import * as ui from "@clack/prompts";
 
 /** Gelijk houden met package.json (npm test controleert dat). */
-const VERSION = "1.2.1";
+const VERSION = "1.2.3";
 /** Afspraak met cli/run.mjs; alleen ophogen als de aanroep van run() verandert. */
 const CONTRACT = 1;
 const REPOSITORY = "https://github.com/Vizion-Digital-Agency/create-vizion-digital-agency.git";
@@ -42,8 +42,9 @@ ${bold("Vizion Digital Agency")}: een nieuw project, en alles daarna
   --answers <bestand> Zonder vragen: alle antwoorden uit een JSON-bestand (voor scripts en tests)
 
   Een bestaand project (in de root of een map daarvan):
-  beheer              Het dashboard: het overzicht, live gaan (de checklist), de opzet, onderdelen en keuzes aan of uit,
-                      diensten wisselen, instellingen, de server en onderhoud, bijwerken naar een nieuwe versie
+  beheer              Het dashboard: het overzicht, live gaan (de checklist), naar de klant (van het testdomein naar de
+                      echte livegang), de opzet, onderdelen en keuzes aan of uit, diensten wisselen, alle instellingen
+                      (bekijken en opnieuw invullen), de server en onderhoud, bijwerken naar een nieuwe versie
   beheer status       Het overzicht als tekst
   beheer opzet [stap] De opzet-assistent, of meteen één stap (bijv. beheer opzet bewaking)
   beheer bijwerken    Naar de nieuwste versie van de template; je eigen wijzigingen blijven staan

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-vizion-digital-agency",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Nieuwe projecten van Vizion Digital Agency, en beheren: npm create vizion-digital-agency",
   "type": "module",
   "bin": {