create-vizion-digital-agency 1.2.2 → 1.2.4

package/README.md

@@ -8,21 +8,40 @@ 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** gaat in drie delen, en je ziet het hele stappenplan meteen bij de start:
-
-1. **Het project maken** (± 10 minuten). Eerst **alle instellingen**, per sectie: Onderdelen (mobiele app, AI-service),
-   Naam, Domein en poorten, Functies (organisaties, bestanden, virusscanner), Inloggen (social login, minimumleeftijd,
-   de eerste beheerder), E-mail (Brevo), Huisstijl en links, en de map. Pas daarna maakt de CLI het project, met alleen
-   wat je koos, en doet hij altijd zelf: de packages installeren, git met een eerste commit, alles starten in Docker en
-   controleren dat het werkt.
-2. **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`. De
-   assistent werkt per sectie: Je computer, GitHub (in de organisatie Vizion-Digital-Agency), 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, 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.
-3. **Naar de klant** (later, met `-- beheer`). Bij de echte livegang: het domein, de DNS, de e-mail en de afzender, de
+## 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 ja of nee, minimumleeftijd, de eerste beheerder), Huisstijl en links, en de map. Is de map niet leeg,
+   dan vraagt hij wat je wilt (een andere map, de oude weggooien, of stoppen).
+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 diensten van de app (e-mail met Brevo, en als je die koos de AI-service en social login: elk één stap
+   voor je computer, de test en live), De VPS en de opslag (TransIP, TransIP Object Store), Het domein (DNS doe jij, hij
+   zegt precies welke records), 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.
@@ -38,7 +57,9 @@ Stoppen mag altijd: met `-- beheer` ga je verder waar je was.
 - **Diensten:** bijv. de opslag of e-mail wisselen.
 - **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:** controleren, onderhoud, het verslag van Ansible.
+- **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.
 
@@ -53,8 +74,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.2";
+const VERSION = "1.2.4";
 /** 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";

package/package.json

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