@fraza/start 0.3.13 → 0.3.15

package/CHANGELOG.md

@@ -4,6 +4,33 @@ Historique des versions publiées de `@fraza/start`.
 
 Ce fichier est généré par `fraza-module changelog` à partir des messages de commit. Ne pas le modifier à la main.
 
+## 0.3.15 (2026-10-29)
+
+Maintenance interne, aucun changement de comportement.
+
+## 0.3.14 (2026-10-28)
+
+### Ruptures
+
+- leave the local development setup to fraza-dev init
+- generate compose.yaml, fraza-dev scripts and a first test
+
+### Ajouts
+
+- **start** : generate compose.yaml, fraza-dev scripts and a first test (359a957)
+
+### Corrections
+
+- **start** : start npm through a shell on Windows in generate-notices (ab746c9)
+
+### Refontes
+
+- **start** : leave the local development setup to fraza-dev init (e5a5f0e)
+
+### Autres
+
+- drop the Gitea workflow, tests run locally (01b5765)
+
 ## 0.3.13 (2026-10-26)
 
 Maintenance interne, aucun changement de comportement.

package/README.md

@@ -21,7 +21,7 @@ npx @fraza/start
 ## Prérequis
 
 - Node.js 20.12 ou plus.
-- Une base PostgreSQL 14 ou plus.
+- Docker, pour les services locaux du `compose.yaml` : PostgreSQL, S3 et boîte de réception. Sans Docker, une base PostgreSQL 14 ou plus.
 - Un dossier vide. Seules les métadonnées d'éditeur ou de git y sont tolérées : `.git`, `.vscode`, `.idea`, `.DS_Store`, `LICENSE`.
 
 ## Utilisation
@@ -32,38 +32,43 @@ Dans le dossier du nouveau projet :
 npx @fraza/start
 ```
 
-Renseignez au moins `FRAZA_DATABASE_URL` dans `.env.local`. `npx fraza-doctor` liste les variables qui manquent vraiment. Créez ensuite les tables et démarrez :
+Puis démarrez les services locaux, créez les tables et lancez le site :
 
 ```bash
+npm run services
 npx fraza-db init
 npm run dev
 ```
 
-Ouvrez `http://localhost:3000/auth` pour créer le premier compte, qui reçoit le rôle `admin`.
+`.env.local` est déjà rempli pour les services du `compose.yaml` : il n'y a rien à saisir. `npm run services` choisit des ports libres pour cette machine et les y écrit. Ouvrez l'adresse affichée par `npm run dev`, d'habitude `http://localhost:3000/auth`, pour créer le premier compte, qui reçoit le rôle `admin`. Les courriels du site arrivent dans la boîte de réception affichée par `npm run services`.
+
+Sans Docker, faites viser `FRAZA_DATABASE_URL` vers votre PostgreSQL dans `.env.local`, et posez `FRAZA_EMAIL_PROVIDER=log` pour lire les courriels dans le terminal. Voir [Développer en local](https://docs.fraza.ca/docs/guides/developper-en-local).
+
+Un collègue qui clone le projet lance les mêmes trois commandes : `npm run dev` crée son `.env.local` depuis `.env.example`.
 
 ## Ce que fait le CLI
 
 1. Crée le projet avec `create-next-app` 16.4.3, la version de Next contre laquelle le core est validé.
 2. Remplace le dossier `app/` de Next par les gabarits Fraza : administration, authentification, API, page d'accueil, pages d'erreur, gabarits de page, exemples de blocs, `theme.js`, `instrumentation.js` et `jsconfig.json`.
-3. Ajoute les scripts `dev`, `build` et `postinstall`, qui lancent `fraza-modules sync`.
+3. Ajoute les scripts `dev` (`fraza-dev`, qui lance `fraza-modules sync` puis `next dev`), `build` et `postinstall` (`fraza-modules sync`).
 4. Masque l'indicateur de développement de Next dans `next.config.mjs`.
 5. Ajoute `!.env.example` et `app/.fraza/` au `.gitignore`, en gardant la règle `.env*` de Next.
 6. Ajoute un bloc Fraza à l'`AGENTS.md`, qui renvoie un agent à la documentation livrée dans `node_modules/@fraza/core/dist/docs/`.
 7. Écrit le `.npmrc` du projet, sans jeton.
 8. Installe `@fraza/core`.
-9. Crée `.env.example`, suivi par git, et `.env.local`, ignoré par git, avec `FRAZA_ENCRYPTION_KEY` générée et `NEXT_PUBLIC_URL` locale. Crée aussi `.env.development.local`, ignoré par git, avec `NEXT_PUBLIC_URL=http://localhost:3000` et `FRAZA_DEVKIT=true`.
+9. Crée `.env.example`, suivi par git, avec les valeurs locales du `compose.yaml`, et `.env.local`, ignoré par git, la même copie avec `FRAZA_ENCRYPTION_KEY` générée.
+10. Lance `npx fraza-dev init` du core, qui ajoute le développement local : le `compose.yaml` des services, les scripts `services`, `services:stop`, `services:reset` et `test`, un premier test dans `test/`, et le `distDir` du serveur de test dans `next.config.mjs`. La même commande sert à un projet créé par une version antérieure.
 
 ## Variables d'environnement
 
 | Fichier | Contenu | Suivi par git |
 |---|---|---|
-| `.env.example` | La liste des variables, sans aucune valeur secrète. Une variable ajoutée par le projet y entre aussi. | Oui |
-| `.env.local` | Les valeurs de cette machine : base de données, stockage, courriel, clés. | Non |
-| `.env.development.local` | Les valeurs du développement local, lues seulement par `npm run dev` : URL locale et devkit de l'admin. | Non |
+| `.env.example` | La liste des variables, avec les valeurs locales du `compose.yaml` et aucune valeur secrète. Une variable ajoutée par le projet y entre aussi. | Oui |
+| `.env.local` | Les valeurs de cette machine : ports locaux, clé de chiffrement, clés de test. | Non |
 
 En production, les variables se saisissent dans la plateforme d'hébergement, jamais dans un fichier suivi par git. Partez de `.env.example` pour la liste.
 
-**Copiez `FRAZA_ENCRYPTION_KEY` telle quelle depuis `.env.local`, et ne la changez jamais.** Tout ce que le site chiffre en base l'est avec cette clé : une nouvelle clé rend ces données illisibles. Gardez-en une copie hors du serveur.
+**Copiez `FRAZA_ENCRYPTION_KEY` telle quelle depuis `.env.local`, et ne la changez jamais.** Tout ce que le site chiffre en base l'est avec cette clé : une nouvelle clé rend ces données illisibles. Gardez-en une copie dans le coffre de l'équipe, hors du serveur.
 
 La liste complète est dans [Variables d'environnement](https://docs.fraza.ca/docs/reference/configuration/variables-d-environnement).
 

package/bin/cli.js

@@ -10,7 +10,7 @@ import {
 	MIN_NODE,
 	REGISTRY_HOST,
 	findConflictingEntries,
-	hideDevIndicators,
+	completeNextConfig,
 	isSupportedNode,
 	withFrazaGitignore,
 	withFrazaScripts,
@@ -133,7 +133,7 @@ async function initProject() {
 		fs.cpSync(templatesPath, cwd, { recursive: true, force: true });
 		done('Gabarits copiés');
 
-		if (hideDevIndicators(path.join(cwd, 'next.config.mjs'))) {
+		if (completeNextConfig(path.join(cwd, 'next.config.mjs'))) {
 			done('Indicateur de développement de Next masqué dans next.config.mjs');
 		} else {
 			fail('next.config.mjs non reconnu : ajouter `devIndicators: false` à la main');
@@ -169,18 +169,26 @@ async function initProject() {
 		const env = writeEnvFiles(envTemplate, cwd);
 		if (env.example) done('.env.example créé à partir du modèle de @fraza/core');
 		if (env.local) done('.env.local créé, FRAZA_ENCRYPTION_KEY générée');
-		if (env.development) done('.env.development.local créé (URL locale, devkit activé)');
+
+		// Le développement local appartient au core : compose.yaml, scripts
+		// services et test, premier test, distDir du serveur de test. La même
+		// commande l'ajoute à un projet existant.
+		step('Mise en place du développement local (fraza-dev init)');
+		execSync('npx fraza-dev init', { stdio: 'inherit' });
 
 		const file = (name) => `${c.cyan}${name}${c.reset}`;
 		const dim = (text) => `${c.dim}${text}${c.reset}`;
 
 		console.log(`\n  ${c.green}${c.bold}Projet prêt.${c.reset} Étapes suivantes :\n`);
-		console.log(`  ${dim('1.')} Remplir les variables de ${file('.env.local')}, à commencer par ${file('FRAZA_DATABASE_URL')}`);
-		console.log(`     ${dim('Ce fichier reste sur cette machine. Le modèle sans secret,')} ${file('.env.example')}${dim(', est suivi par git.')}`);
+		console.log(`  ${dim('1.')} Démarrer les services locaux : PostgreSQL, S3 et boîte de réception (Docker)`);
+		console.log(`     ${dim('npm run services')}`);
+		console.log(`     ${dim('Sans Docker : viser son propre PostgreSQL dans')} ${file('.env.local')}${dim(', et')} ${file('FRAZA_EMAIL_PROVIDER=log')}${dim('.')}`);
 		console.log(`  ${dim('2.')} Initialiser la base de données`);
 		console.log(`     ${dim('npx fraza-db init')}`);
 		console.log(`  ${dim('3.')} Démarrer le site`);
 		console.log(`     ${dim('npm run dev')}\n`);
+		console.log(`  ${file('.env.local')} ${dim('porte les valeurs de cette machine. Le modèle sans secret,')} ${file('.env.example')}${dim(', est suivi par git :')}`);
+		console.log(`  ${dim('un collègue qui clone le projet lance les mêmes trois commandes.')}\n`);
 
 		console.log(`  ${c.bold}En production :${c.reset} les variables se saisissent dans la plateforme d'hébergement (Coolify, par exemple),`);
 		console.log(`  ${dim('jamais dans un fichier suivi par git.')} ${file('FRAZA_ENCRYPTION_KEY')} ${dim('se copie telle quelle depuis')} ${file('.env.local')}${dim(' :')}`);

package/bin/project.js

@@ -113,30 +113,48 @@ export function writeAgentsBlock(agentsPath, block) {
 }
 
 /**
- * Masque l'indicateur de développement de Next dans le `next.config.mjs` écrit
- * par `create-next-app`. Le fichier est complété, jamais remplacé : avec
+ * Lignes que start ajoute à la configuration de Next, chacune repérée par sa
+ * clé. `devIndicators: false` masque l'indicateur de développement de Next.
+ * Le `distDir` du serveur de test vient ensuite de `fraza-dev init`, qui le
+ * pose aussi sur un projet existant.
+ */
+const NEXT_CONFIG_LINES = [
+	{ key: 'devIndicators', line: '  devIndicators: false,' },
+];
+
+/**
+ * Complète le `next.config.mjs` écrit par `create-next-app` avec les lignes de
+ * `NEXT_CONFIG_LINES`. Le fichier est complété, jamais remplacé : avec
  * Turbopack, `create-next-app` peut y brancher Tailwind (règle `turbopack.rules`
  * vers `@tailwindcss/turbopack`, sans `postcss.config.mjs`). Un gabarit qui
- * l'écraserait laisserait alors le projet sans aucun style.
+ * l'écraserait laisserait alors le projet sans aucun style. Une clé déjà
+ * présente n'est pas touchée.
  * @param {string} configPath
  * @returns {boolean} `false` si le fichier manque ou n'a pas la forme attendue.
  */
-export function hideDevIndicators(configPath) {
+export function completeNextConfig(configPath) {
 	if (!fs.existsSync(configPath)) return false;
 
 	const existing = fs.readFileSync(configPath, 'utf-8');
-	if (existing.includes('devIndicators')) return true;
+	const missing = NEXT_CONFIG_LINES.filter(({ key }) => !existing.includes(key));
+	if (missing.length === 0) return true;
 
 	const pattern = /(const nextConfig = \{\n)/;
 	if (!pattern.test(existing)) return false;
 
-	fs.writeFileSync(configPath, existing.replace(pattern, '$1  devIndicators: false,\n'));
+	const lines = missing.map(({ line }) => `${line}\n`).join('');
+	fs.writeFileSync(configPath, existing.replace(pattern, () => `const nextConfig = {\n${lines}`));
 	return true;
 }
 
 /**
- * Complète le `package.json` écrit par `create-next-app` : `fraza-modules sync`
- * avant `next dev` et `next build`, et à chaque installation.
+ * Complète le `package.json` écrit par `create-next-app` :
+ *
+ * - `dev` passe par `fraza-dev`, qui crée `.env.local` s'il manque, choisit le
+ *   port du site pour cette machine, lance `fraza-modules sync` puis `next dev` ;
+ * - `build` et `postinstall` lancent `fraza-modules sync`.
+ *
+ * Les scripts `services*` et `test` viennent ensuite de `fraza-dev init`.
  * @param {object} pkg
  * @param {Record<string, string>} siteOverrides
  * @returns {object} Un nouvel objet, `pkg` n'est pas modifié.
@@ -144,7 +162,7 @@ export function hideDevIndicators(configPath) {
 export function withFrazaScripts(pkg, siteOverrides = {}) {
 	const next = { ...pkg, scripts: { ...pkg.scripts } };
 	next.scripts.postinstall = 'fraza-modules sync';
-	next.scripts.dev = 'fraza-modules sync && next dev';
+	next.scripts.dev = 'fraza-dev';
 	next.scripts.build = 'fraza-modules sync && next build';
 	next.scripts.audit = 'npm audit --omit=dev';
 
@@ -258,34 +276,21 @@ export function fillLocalEnv(template, { key = randomBytes(32).toString('hex'),
 }
 
 /**
- * Contenu de `.env.development.local` : les valeurs du développement local, que
- * Next.js ne lit qu'avec `next dev` et qui passent avant `.env.local`. On y met
- * l'origine locale et le devkit de l'admin, qui ne doivent jamais aller en
- * production.
- */
-export const DEVELOPMENT_ENV = [
-	'# Valeurs du développement local, lues par Next.js avec `next dev` seulement,',
-	'# avant celles de .env.local. Ignoré par git.',
-	'NEXT_PUBLIC_URL=http://localhost:3000',
-	'FRAZA_DEVKIT=true',
-	'',
-].join('\n');
-
-/**
- * Crée `.env.example` (copie du modèle du core, suivie par git), `.env.local`
- * (la même copie remplie pour cette machine, ignorée par git) et
- * `.env.development.local` (`DEVELOPMENT_ENV`, ignoré par git). Un fichier qui
+ * Crée `.env.example` (copie du modèle du core, suivie par git) et `.env.local`
+ * (la même copie remplie pour cette machine, ignorée par git). Un fichier qui
  * existe déjà n'est jamais remplacé.
+ *
+ * Il n'y a pas de `.env.development.local` : il passerait avant `.env.local` et
+ * figerait `NEXT_PUBLIC_URL`, que `fraza-dev` fait suivre au port du site.
  * @param {string} templatePath `node_modules/@fraza/core/.env.example`.
  * @param {string} projectDir
- * @returns {{ example: boolean, local: boolean, development: boolean }} Les fichiers créés.
+ * @returns {{ example: boolean, local: boolean }} Les fichiers créés.
  */
 export function writeEnvFiles(templatePath, projectDir) {
 	const template = fs.readFileSync(templatePath, 'utf-8');
 	const examplePath = path.join(projectDir, '.env.example');
 	const localPath = path.join(projectDir, '.env.local');
-	const developmentPath = path.join(projectDir, '.env.development.local');
-	const created = { example: false, local: false, development: false };
+	const created = { example: false, local: false };
 
 	if (!fs.existsSync(examplePath)) {
 		fs.writeFileSync(examplePath, template);
@@ -296,9 +301,5 @@ export function writeEnvFiles(templatePath, projectDir) {
 		fs.writeFileSync(localPath, fillLocalEnv(template), { mode: 0o600 });
 		created.local = true;
 	}
-	if (!fs.existsSync(developmentPath)) {
-		fs.writeFileSync(developmentPath, DEVELOPMENT_ENV);
-		created.development = true;
-	}
 	return created;
 }

package/bin/version.js

@@ -1,2 +1,2 @@
 // AUTO-GÉNÉRÉ par `fraza-module sync-version`, ne pas modifier à la main.
-export const STARTER_VERSION = '0.3.13';
+export const STARTER_VERSION = '0.3.15';

package/changelog.json

@@ -1,6 +1,61 @@
 {
   "name": "@fraza/start",
   "versions": [
+    {
+      "version": "0.3.15",
+      "date": "2026-10-29",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": []
+    },
+    {
+      "version": "0.3.14",
+      "date": "2026-10-28",
+      "breaking": [
+        "leave the local development setup to fraza-dev init",
+        "generate compose.yaml, fraza-dev scripts and a first test"
+      ],
+      "envAdded": [],
+      "envRemoved": [],
+      "templateChanged": [
+        "compose.yaml",
+        "test/site.test.js"
+      ],
+      "action": [],
+      "entries": [
+        {
+          "type": "refactor",
+          "scope": "start",
+          "subject": "leave the local development setup to fraza-dev init",
+          "hash": "e5a5f0e",
+          "breaking": true
+        },
+        {
+          "type": "ci",
+          "scope": null,
+          "subject": "drop the Gitea workflow, tests run locally",
+          "hash": "01b5765",
+          "breaking": false
+        },
+        {
+          "type": "fix",
+          "scope": "start",
+          "subject": "start npm through a shell on Windows in generate-notices",
+          "hash": "ab746c9",
+          "breaking": false
+        },
+        {
+          "type": "feat",
+          "scope": "start",
+          "subject": "generate compose.yaml, fraza-dev scripts and a first test",
+          "hash": "359a957",
+          "breaking": true
+        }
+      ]
+    },
     {
       "version": "0.3.13",
       "date": "2026-10-26",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fraza/start",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "description": "CLI pour créer un projet Fraza avec Next.js",
   "publishConfig": {
     "access": "public"