create-vizion-digital-agency 3.0.0 → 3.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +20 -17
  2. package/index.mjs +4 -4
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,18 +1,17 @@
1
1
  # create-vizion-digital-agency
2
2
 
3
- Nieuwe projecten van Vizion Digital Agency maken, live zetten, onderhouden en up-to-date houden (versie 3.0.0):
3
+ Nieuwe projecten van Vizion Digital Agency maken, live zetten, onderhouden en up-to-date houden (versie 3.1.0):
4
4
 
5
5
  ```bash
6
6
  npm create vizion-digital-agency@latest # een nieuw project; daarna begint de opzet-assistent vanzelf
7
7
  npm create vizion-digital-agency@latest -- --help # alle opties
8
8
  ```
9
9
 
10
- Daarna werk je in (een map van) het project met vijf npm-scripts; elk roept
10
+ Daarna werk je in (een map van) het project met vier npm-scripts; elk roept
11
11
  `npm create vizion-digital-agency@latest -- <commando>` aan:
12
12
 
13
13
  ```bash
14
- npm run overzicht # alles zien en aanpassen
15
- npm run opzet # de opzet-assistent, verder waar je was (of één stap: npm run opzet -- <stap>)
14
+ npm run opzet # het takenplan: alles zien, elke stap (ook opnieuw), en alles veranderen
16
15
  npm run onderhoud # de server en het onderhoud
17
16
  npm run updates # de template-update en de pull request van Dependabot
18
17
  npm run live # naar live: main precies gelijk aan staging
@@ -35,7 +34,7 @@ een ja), een SSH-sleutel, en de accounts (bij elke stap zegt hij welk account, w
35
34
  Elke keer: Docker Desktop aan, en start in de map waar je projecten staan.
36
35
 
37
36
  **Een nieuw project** begint met **het takenplan**: één genummerde lijst van alles, per sectie, van de eerste vraag tot
38
- de klant. Dezelfde lijst zie je daarna steeds terug, met ✓ voor wat klaar is.
37
+ de klant. Dezelfde lijst zie je daarna steeds terug (`npm run opzet`), met ✓ voor wat klaar is en ◀ bij de volgende stap.
39
38
 
40
39
  1. **Het project: alle instellingen** (± 10 minuten): Onderdelen (mobiele app, AI-service), Naam, Domein en poorten
41
40
  (standaard het testdomein), Functies (wat er altijd in zit, en organisaties, bestanden, virusscanner), Inloggen
@@ -52,23 +51,26 @@ de klant. Dezelfde lijst zie je daarna steeds terug, met ✓ voor wat klaar is.
52
51
  is poort 22 dicht), Het domein (DNS doe jij, hij zegt precies welke records), Bewaking en foutmeldingen, **GitHub**
53
52
  (de repository in de organisatie Vizion-Digital-Agency, pas nu, in één keer compleet), Live, en Afronden. Wat hij
54
53
  zelf kan, doet hij; wat alleen jij kunt (iets bestellen bij TransIP, een account maken, inloggen met 2FA, de DNS),
55
- legt hij stap voor stap uit. Een stap stoppen kan altijd met Ctrl+C: daarna kies je opnieuw, overslaan of stoppen.
56
- 4. **Livegang naar de klant** (de laatste sectie; hij vraagt of je die nu wilt, of later met `npm run opzet`): het domein
54
+ legt hij stap voor stap uit. Je kiest steeds zelf een regel uit de lijst (de volgende staat al geselecteerd); een stap stoppen kan
55
+ altijd met Ctrl+C, en dan ben je terug in de lijst.
56
+ 4. **Livegang naar de klant** (de laatste sectie: pas de volgende als al het andere klaar is; je doet hem als het zover
57
+ is, met `npm run opzet`): het domein
57
58
  van de klant, de DNS, de e-mail en de afzender, de links en het logo, social login publiceren, live op zijn domein,
58
59
  de app in de stores, en de overdracht. Elke stap vink je zelf af als je hem zonder de assistent deed.
59
60
 
60
- Stoppen mag altijd: met `npm run opzet` ga je verder waar je was.
61
+ Stoppen mag altijd (**Klaar**): met `npm run opzet` ga je verder waar je was.
61
62
 
62
- **Alles daarna** doe je met de vijf npm-scripts van het project. Ze werken zoals `npm create`: eerst laten ze zien hoe
63
+ **Alles daarna** doe je met de vier npm-scripts van het project. Ze werken zoals `npm create`: eerst laten ze zien hoe
63
64
  het ervoor staat, dan vragen ze wat je wilt doen.
64
65
 
65
- - **`npm run overzicht`:** alles zien en aanpassen. De keuzes en onderdelen (aan of uit, met behoud van je eigen werk),
66
- de branch, **elke instelling en zijn waarde** (op je computer, live en op staging; geheimen alleen "ingevuld" of
67
- "leeg"), de `.env`-bestanden (compleet, in git, op de server), het domein, de links, de opslag van de back-ups of de
68
- bestanden wisselen, of je computer klaarstaat, en elke techniek met waar de uitleg staat.
69
- - **`npm run opzet`** (`npm run opzet -- <stap>`, bijv. `npm run opzet -- bewaking`): de opzet-assistent, verder waar
70
- je was, of één stap opnieuw. Ook de sectie **Livegang naar de klant**: elke stap daarvan doe je met de assistent, of
71
- vink je zelf af.
66
+ - **`npm run opzet`:** het takenplan. Bovenaan hoe het project ervoor staat (de template-versie, de branch, live en
67
+ staging, de onderdelen en functies, per `.env`-bestand: compleet, in de kluis, op de server; problemen op je computer;
68
+ afwijkingen van `vizion.json`; de voortgang), daaronder de hele lijst met ✓ of ○ en **◀ volgende**. Je kiest zelf een
69
+ regel ("Waar wil je heen?"), ook een eerdere om hem opnieuw te doen of iets te veranderen. Elke regel opent een pagina
70
+ met wat er staat (**elke instelling en zijn waarde** op je computer, live en op staging; geheimen alleen "ingevuld"
71
+ of "leeg") en de acties: een stap doen of opnieuw doen, een instelling veranderen, onderdelen en functies aan of uit
72
+ (met behoud van je eigen werk), het domein, de links en het logo, de opslag wisselen, naar live, afvinken. Als
73
+ laatste **Alle instellingen (.env)**. Eén stap meteen: `npm run opzet -- <stap>` (bijv. `npm run opzet -- bewaking`).
72
74
  - **`npm run onderhoud`:** de server. Alles controleren, **onderhoud nu** (zonder op zondag te wachten; ook met
73
75
  herstart), een back-up nu, de onderhoudspagina aan of uit (voor **groot onderhoud**), een belastingtest, de
74
76
  instellingen op de server zetten, de server opnieuw goedzetten, inloggen met ssh, en het laatste verslag van Ansible.
@@ -82,7 +84,8 @@ het ervoor staat, dan vragen ze wat je wilt doen.
82
84
  `-- --report <bestand>` (het verslag als Markdown), `-- --from <versie>` (een project zonder `vizion.json`).
83
85
  - **`npm run live`:** naar live: `main` precies gelijk aan `staging`, met een tag `live-<datum>-<n>`.
84
86
 
85
- Vóór v3.0.0 deed `-- beheer` dit allemaal; dat bestaat sinds v3.0.0 niet meer.
87
+ Vóór v3.0.0 deed `-- beheer` dit allemaal; dat bestaat sinds v3.0.0 niet meer. `npm run overzicht` (v3.0.0) bestaat
88
+ sinds v3.1.0 niet meer: alles daarvan zit in `npm run opzet`.
86
89
 
87
90
  Alles wat je daarna moet weten, staat kort in elk project in `docs/cheatsheet.md`; de verdieping in `docs_specifiek/`,
88
91
  één document per laag (het stappenplan met alle accounts in `docs_specifiek/samenhang.md`). Werken gaat altijd via dezelfde route: lokaal op je eigen
package/index.mjs CHANGED
@@ -3,7 +3,7 @@
3
3
  * create-vizion-digital-agency: nieuwe projecten van Vizion Digital Agency, en alles daarna (de commando's).
4
4
  *
5
5
  * npm create vizion-digital-agency@latest [map] een nieuw project (daarna start de opzet vanzelf)
6
- * npm run overzicht | onderhoud | updates | opzet | live alles daarna, in de map van het project (die scripts
6
+ * npm run opzet | onderhoud | updates | live alles daarna, in de map van het project (die scripts
7
7
  * roepen npm create vizion-digital-agency@latest -- <commando> aan)
8
8
  *
9
9
  * Dit is alleen de opstarter en bevat zelf geen componenten. Hij zoekt de nieuwste release van de (privé) repository,
@@ -19,7 +19,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
19
19
  import * as ui from "@clack/prompts";
20
20
 
21
21
  /** Gelijk houden met package.json (npm test controleert dat). */
22
- const VERSION = "3.0.0";
22
+ const VERSION = "3.1.2";
23
23
  /** Afspraak met cli/run.mjs; alleen ophogen als de aanroep van run() verandert. */
24
24
  const CONTRACT = 1;
25
25
  const REPOSITORY = "https://github.com/Vizion-Digital-Agency/create-vizion-digital-agency.git";
@@ -42,14 +42,14 @@ ${bold("Vizion Digital Agency")}: een nieuw project, en alles daarna
42
42
  --answers <bestand> Zonder vragen: alle antwoorden uit een JSON-bestand (voor scripts en tests)
43
43
 
44
44
  Een bestaand project (in de map van het project; de npm-scripts roepen dit aan):
45
- npm run overzicht Alles zien (keuzes, onderdelen, branch, de .env-bestanden lokaal en op de server) en aanpassen
45
+ npm run opzet Het takenplan: waar je bent, wat nog open staat; kies zelf een regel (ook een eerdere, om iets
46
+ opnieuw te doen of te veranderen: elke instelling, onderdeel, functie, het domein). Eén stap: -- <stap>
46
47
  npm run onderhoud De server: controleren, onderhoud, een back-up, de onderhoudspagina, een belastingtest
47
48
  npm run updates De template-update, de pull request van Dependabot, vergelijken met de template
48
49
  --dry-run alleen laten zien wat de template-update zou veranderen
49
50
  --yes de template-update zonder vragen (voor scripts)
50
51
  --report <bestand> het verslag ook als Markdown wegschrijven
51
52
  --from <versie> alleen voor een project zonder vizion.json: met welke versie het gemaakt is
52
- npm run opzet De opzet-assistent (verder waar je was), of één stap: npm run opzet -- <stap>
53
53
  npm run live Naar live: main precies gelijk aan staging
54
54
 
55
55
  Altijd:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-vizion-digital-agency",
3
- "version": "3.0.0",
3
+ "version": "3.1.2",
4
4
  "description": "Nieuwe projecten van Vizion Digital Agency, en beheren: npm create vizion-digital-agency",
5
5
  "type": "module",
6
6
  "bin": {