create-vizion-digital-agency 2.1.0 → 3.0.0

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 +40 -35
  2. package/index.mjs +13 -17
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,13 +1,23 @@
1
1
  # create-vizion-digital-agency
2
2
 
3
- Nieuwe projecten van Vizion Digital Agency maken, live zetten, beheren en up-to-date houden. Er zijn twee commando's:
3
+ Nieuwe projecten van Vizion Digital Agency maken, live zetten, onderhouden en up-to-date houden (versie 3.0.0):
4
4
 
5
5
  ```bash
6
6
  npm create vizion-digital-agency@latest # een nieuw project; daarna begint de opzet-assistent vanzelf
7
- npm create vizion-digital-agency@latest -- beheer # in (een map van) een project: het dashboard voor alles daarna
8
7
  npm create vizion-digital-agency@latest -- --help # alle opties
9
8
  ```
10
9
 
10
+ Daarna werk je in (een map van) het project met vijf npm-scripts; elk roept
11
+ `npm create vizion-digital-agency@latest -- <commando>` aan:
12
+
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>)
16
+ npm run onderhoud # de server en het onderhoud
17
+ npm run updates # de template-update en de pull request van Dependabot
18
+ npm run live # naar live: main precies gelijk aan staging
19
+ ```
20
+
11
21
  ## Voordat je begint
12
22
 
13
23
  Eén keer per computer, meer niet:
@@ -43,44 +53,39 @@ de klant. Dezelfde lijst zie je daarna steeds terug, met ✓ voor wat klaar is.
43
53
  (de repository in de organisatie Vizion-Digital-Agency, pas nu, in één keer compleet), Live, en Afronden. Wat hij
44
54
  zelf kan, doet hij; wat alleen jij kunt (iets bestellen bij TransIP, een account maken, inloggen met 2FA, de DNS),
45
55
  legt hij stap voor stap uit. Een stap stoppen kan altijd met Ctrl+C: daarna kies je opnieuw, overslaan of stoppen.
46
- 4. **Livegang naar de klant** (de laatste sectie; hij vraagt of je die nu wilt, of later met `-- beheer`): het domein
56
+ 4. **Livegang naar de klant** (de laatste sectie; hij vraagt of je die nu wilt, of later met `npm run opzet`): het domein
47
57
  van de klant, de DNS, de e-mail en de afzender, de links en het logo, social login publiceren, live op zijn domein,
48
58
  de app in de stores, en de overdracht. Elke stap vink je zelf af als je hem zonder de assistent deed.
49
59
 
50
- Stoppen mag altijd: met `-- beheer` ga je verder waar je was.
51
-
52
- **`-- beheer`** is een dashboard in de terminal voor alles daarna:
53
-
54
- - **Overzicht:** het project in één scherm.
55
- - **Onderdelen:** alles van het project op één plek, in dezelfde secties en volgorde als bij het maken: eerst wat je
56
- bij `npm create` koos (de onderdelen, de naam, het domein, de functies, het inloggen, de huisstijl en de links), dan
57
- elke stap van de opzet-assistent. Elke regel opent een pagina met **elke instelling en zijn waarde** (op je computer,
58
- live en op staging; geheimen alleen "ingevuld" of "leeg"), en daar verander je wat je wilt: een instelling of
59
- API-sleutel, een onderdeel of functie aan of uit (met behoud van je eigen werk), of de stap opnieuw. Bij de stappen
60
- GitHub en Live: **Naar live: main = staging**. Als laatste de sectie **Livegang naar de klant**: elke stap daarvan
61
- doe je met de assistent, of vink je zelf af.
62
- - **Server en onderhoud:** wat er vanzelf gebeurt (op de server elke nacht en elke zondag, op GitHub de 1e van de maand Dependabot), wat
63
- jij doet (ook elke maand de template-update), **onderhoud nu** (zonder op zondag te wachten), en **groot onderhoud**:
64
- een back-up maken, de onderhoudspagina aan (de app even offline), en weer uit. Ook: controleren, het verslag van Ansible.
65
- - **Updates:** de **template-update** naar een nieuwe versie van de template (je eigen werk blijft staan; conflicten
66
- opent hij in VS Code, en daarna gaat het via `staging` naar live), en **de pull request van Dependabot binnenhalen**
67
- (de 1e van de maand één pull request met alle nieuwe versies; eerst naar `staging`, waar Husky alles controleert, dan
68
- **Naar live**).
69
- - **Je computer** en **Techniek:** of alles klaarstaat, en elke techniek met waar de uitleg staat.
70
-
71
- Zonder dashboard (bijv. in een script):
60
+ Stoppen mag altijd: met `npm run opzet` ga je verder waar je was.
72
61
 
73
- ```bash
74
- npm create vizion-digital-agency@latest -- beheer status # het overzicht als tekst
75
- npm create vizion-digital-agency@latest -- beheer opzet [stap] # de opzet-assistent, of één stap (bijv. opzet bewaking)
76
- npm create vizion-digital-agency@latest -- beheer bijwerken [--dry-run] # de template-update (eerst kijken kan)
77
- npm create vizion-digital-agency@latest -- beheer keuze <id> aan|uit # een onderdeel of keuze aan- of uitzetten
78
- npm create vizion-digital-agency@latest -- beheer wissel backups|bestanden # de opslag wisselen
79
- npm create vizion-digital-agency@latest -- beheer server <opdracht> # Ansible: controle, onderhoud, setup, project, staging
80
- ```
62
+ **Alles daarna** doe je met de vijf npm-scripts van het project. Ze werken zoals `npm create`: eerst laten ze zien hoe
63
+ het ervoor staat, dan vragen ze wat je wilt doen.
64
+
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.
72
+ - **`npm run onderhoud`:** de server. Alles controleren, **onderhoud nu** (zonder op zondag te wachten; ook met
73
+ herstart), een back-up nu, de onderhoudspagina aan of uit (voor **groot onderhoud**), een belastingtest, de
74
+ instellingen op de server zetten, de server opnieuw goedzetten, inloggen met ssh, en het laatste verslag van Ansible.
75
+ Een opdracht van Ansible rechtstreeks: `npm run server -- <opdracht>` (controle, onderhoud, setup, project, staging).
76
+ - **`npm run updates`:** de **template-update** naar een nieuwe versie van de template (je eigen werk blijft staan;
77
+ conflicten opent hij in VS Code, en daarna gaat het via `staging` naar live), **de pull request van Dependabot
78
+ binnenhalen** (de 1e van de maand één pull request met alle nieuwe versies; eerst naar `staging`, waar Husky alles
79
+ controleert, dan naar live), en **Klopt het project nog met de template?**: per bestand vergelijken met een vers
80
+ project van dezelfde versie, bekijken in VS Code of terugzetten (de `.env`-bestanden en de kluis blijven altijd staan).
81
+ Zonder vragen: `npm run updates -- --dry-run` (alleen bekijken), `-- --yes` (de template-update zonder vragen),
82
+ `-- --report <bestand>` (het verslag als Markdown), `-- --from <versie>` (een project zonder `vizion.json`).
83
+ - **`npm run live`:** naar live: `main` precies gelijk aan `staging`, met een tag `live-<datum>-<n>`.
84
+
85
+ Vóór v3.0.0 deed `-- beheer` dit allemaal; dat bestaat sinds v3.0.0 niet meer.
81
86
 
82
- Alles wat je daarna moet weten, staat in elk project in `docs/handboek.md` (het handboek: van begin tot eind); de
83
- verdieping (het stappenplan en de naslag) in `docs-backup/`. Werken gaat altijd via dezelfde route: lokaal op je eigen
87
+ Alles wat je daarna moet weten, staat kort in elk project in `docs/cheatsheet.md`; de verdieping in `docs_specifiek/`,
88
+ één document per laag (het stappenplan met alle accounts in `docs_specifiek/samenhang.md`). Werken gaat altijd via dezelfde route: lokaal op je eigen
84
89
  branch `feature/<wat>` of `fix/<wat>` (alles in Docker) → samenvoegen in `staging` en pushen (Husky draait eerst de
85
90
  volledige controle op je computer; daarna staat het op `staging.<domein>`) → `main` precies gelijk aan `staging` (geen
86
91
  nieuwe controle, een tag `live-<datum>-<n>`), en GitHub zet het live.
package/index.mjs CHANGED
@@ -1,9 +1,10 @@
1
1
  #!/usr/bin/env node
2
2
  /**
3
- * create-vizion-digital-agency: nieuwe projecten van Vizion Digital Agency, en bestaande beheren.
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 create vizion-digital-agency@latest -- beheer alles daarna, in (een map van) het project
6
+ * npm run overzicht | onderhoud | updates | opzet | live alles daarna, in de map van het project (die scripts
7
+ * roepen npm create vizion-digital-agency@latest -- <commando> aan)
7
8
  *
8
9
  * Dit is alleen de opstarter en bevat zelf geen componenten. Hij zoekt de nieuwste release van de (privé) repository,
9
10
  * haalt die op met git (met jouw eigen GitHub-toegang) en start daarna cli/run.mjs uit die kopie. Zo werkt iedereen
@@ -18,7 +19,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
18
19
  import * as ui from "@clack/prompts";
19
20
 
20
21
  /** Gelijk houden met package.json (npm test controleert dat). */
21
- const VERSION = "2.1.0";
22
+ const VERSION = "3.0.0";
22
23
  /** Afspraak met cli/run.mjs; alleen ophogen als de aanroep van run() verandert. */
23
24
  const CONTRACT = 1;
24
25
  const REPOSITORY = "https://github.com/Vizion-Digital-Agency/create-vizion-digital-agency.git";
@@ -34,27 +35,22 @@ const HELP = `
34
35
  ${bold("Vizion Digital Agency")}: een nieuw project, en alles daarna
35
36
 
36
37
  npm create vizion-digital-agency@latest [map]
37
- npm create vizion-digital-agency@latest -- beheer [opdracht]
38
38
 
39
39
  Nieuw project:
40
40
  [map] Waar het project komt (standaard: deze map als hij leeg is, anders een nieuwe map).
41
41
  Daarna installeert de CLI alles, maakt git, start en controleert het, en begint de opzet-assistent.
42
42
  --answers <bestand> Zonder vragen: alle antwoorden uit een JSON-bestand (voor scripts en tests)
43
43
 
44
- Een bestaand project (in de root of een map daarvan):
45
- beheer Het dashboard: het overzicht; Onderdelen (het hele takenplan, met per regel elke instelling:
46
- bekijken en veranderen, aan of uit, de stap opnieuw; als laatste de livegang naar de klant,
47
- zelf af te vinken); de server en onderhoud; bijwerken naar een nieuwe versie
48
- beheer status Het overzicht als tekst
49
- beheer opzet [stap] De opzet-assistent, of meteen één stap (bijv. beheer opzet bewaking)
50
- beheer bijwerken Naar de nieuwste versie van de template; je eigen wijzigingen blijven staan
51
- --dry-run alleen laten zien wat er zou veranderen
52
- --yes geen vragen (voor scripts)
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
46
+ npm run onderhoud De server: controleren, onderhoud, een back-up, de onderhoudspagina, een belastingtest
47
+ npm run updates De template-update, de pull request van Dependabot, vergelijken met de template
48
+ --dry-run alleen laten zien wat de template-update zou veranderen
49
+ --yes de template-update zonder vragen (voor scripts)
53
50
  --report <bestand> het verslag ook als Markdown wegschrijven
54
51
  --from <versie> alleen voor een project zonder vizion.json: met welke versie het gemaakt is
55
- beheer keuze <id> aan|uit Een onderdeel of keuze later aan- of uitzetten (bijv. keuze virusscan aan)
56
- beheer wissel backups|bestanden De opslag wisselen (bijv. naar TransIP Object Store)
57
- beheer server <opdracht> Ansible op de server (controle, onderhoud, setup, project, test)
52
+ npm run opzet De opzet-assistent (verder waar je was), of één stap: npm run opzet -- <stap>
53
+ npm run live Naar live: main precies gelijk aan staging
58
54
 
59
55
  Altijd:
60
56
  --ref <ref> Een andere versie gebruiken: een tag (v1.2.0) of branch (main). Standaard: de nieuwste release
@@ -71,7 +67,7 @@ const { values: options, positionals } = parseArgs({
71
67
  ref: { type: "string" },
72
68
  local: { type: "boolean" },
73
69
  answers: { type: "string" },
74
- // beheer bijwerken
70
+ // npm run updates
75
71
  "dry-run": { type: "boolean" },
76
72
  yes: { type: "boolean" },
77
73
  report: { type: "string" },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-vizion-digital-agency",
3
- "version": "2.1.0",
3
+ "version": "3.0.0",
4
4
  "description": "Nieuwe projecten van Vizion Digital Agency, en beheren: npm create vizion-digital-agency",
5
5
  "type": "module",
6
6
  "bin": {