@fraza/core 0.3.6 → 0.3.8

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 (6) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/README.md +75 -35
  3. package/THIRD-PARTY-NOTICES.md +2 -2
  4. package/changelog.json +43 -0
  5. package/dist/shared/lib/version.js +1 -1
  6. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,22 @@ Historique des versions publiées de `@fraza/core`.
4
4
 
5
5
  Ce fichier est généré par `fraza-module changelog` à partir des messages de commit. Ne pas le modifier à la main.
6
6
 
7
+ ## 0.3.8 (2026-10-25)
8
+
9
+ ### Documentation
10
+
11
+ - add start command in README (e5c953d)
12
+
13
+ ## 0.3.7 (2026-10-25)
14
+
15
+ ### Refontes
16
+
17
+ - **README** : update landing page to remove redundant commands (fe88136)
18
+
19
+ ### Autres
20
+
21
+ - **README** : update content and structure (2a08dbf)
22
+
7
23
  ## 0.3.6 (2026-10-25)
8
24
 
9
25
  Maintenance interne, aucun changement de comportement.
package/README.md CHANGED
@@ -1,57 +1,97 @@
1
- # Fraza
1
+ <img src="https://docs.fraza.ca/readme/core.png" alt="Fraza : ce qui reste à écrire, c'est votre projet" width="100%">
2
2
 
3
- Fraza est un starter kit Next.js avec un back-office modulaire, conçu au Québec. `@fraza/core` est son paquet principal : il apporte à un projet Next.js ordinaire les comptes, la connexion, les rôles, une administration complète et les services que tout projet web refait à chaque fois. Les fonctionnalités s'ajoutent par des modules `@fraza/module-*`, et le projet reste le vôtre.
3
+ Fraza branche dans un projet Next.js ordinaire les comptes, les rôles, une administration extensible, les courriels, les fichiers et les paiements. Conçu au Québec.
4
4
 
5
- > [!WARNING]
6
- > Fraza est en version `0.x`. L'API, la structure et les fonctionnalités peuvent encore changer : une nouvelle version mineure peut contenir un changement cassant.
7
-
8
- ## Fonctionnalités
5
+ ```sh
6
+ npx @fraza/start
7
+ ```
9
8
 
10
- - **Authentification** : inscription, connexion, mot de passe oublié, vérification du courriel, invitations.
11
- - **Administration** : tableau de bord avec widgets, utilisateurs, rôles et permissions, profil, mode sombre.
12
- - **Modules** : chaque module apporte ses tables, ses écrans d'admin, ses permissions et ses routes, sans modifier le core.
13
- - **Site public** : pages servies à la racine du domaine, avec un système de templates.
14
- - **Routeur API** : API REST avec authentification, protection CSRF et limitation du débit.
15
- - **Courriels** : gabarits écrits avec React Email.
16
- - **Stockage** : fichiers sur un stockage objet compatible S3.
17
- - **Paiements** : intégration Stripe.
18
- - **Tâches planifiées** : exécution de tâches programmées.
19
- - **Outillage** : commandes `fraza-db`, `fraza-modules`, `fraza-key`, `fraza-doctor` et `fraza-update`.
9
+ [Documentation](https://docs.fraza.ca/docs) · [Installation](https://docs.fraza.ca/docs/demarrage/installation) · [Modules](https://docs.fraza.ca/docs/modules)
20
10
 
21
- ## Documentation
22
-
23
- Toute la documentation vit dans [docs/](./docs/index.md).
11
+ > [!WARNING]
12
+ > Fraza est en version `0.x`. Une nouvelle version mineure peut contenir un changement cassant.
24
13
 
25
- | Section | Contenu |
26
- |---|---|
27
- | [Démarrage](./docs/01-demarrage/index.md) | De l'installation au premier module, à lire dans l'ordre. |
28
- | [Guides](./docs/02-guides/index.md) | Un cas d'usage par page. |
29
- | [Référence](./docs/03-reference/index.md) | Chaque module, fonction, commande et variable d'environnement. |
30
- | [Architecture](./docs/04-architecture/index.md) | Principes, frontières serveur/client, build, sécurité, design system. |
31
- | [Contribution](./docs/05-contribution/index.md) | Conventions de code, de rédaction, de commit et publication. |
32
- | [Modules](./docs/06-modules/index.md) | Usage des modules officiels `@fraza/module-*` et `@fraza-pro/module-*`. |
14
+ ## Points forts
33
15
 
34
- La documentation est **livrée dans le package** : un projet qui installe `@fraza/core` la trouve sous `node_modules/@fraza/core/dist/docs/`, pour la version exacte qu'il utilise.
16
+ - **Un back-office complet dès le départ.** Connexion, inscription, invitations, utilisateurs, rôles et permissions, tableau de bord, mode sombre.
17
+ - **Extensible sans toucher au core.** Un module apporte ses tables, ses écrans, ses permissions et ses routes. Il s'installe avec npm et s'active par une variable.
18
+ - **Les services de tous les projets.** Routeur API avec CSRF et limitation du débit, courriels React Email, stockage compatible S3, paiements Stripe, tâches planifiées.
19
+ - **La documentation dans le paquet.** `node_modules/@fraza/core/dist/docs/` porte la documentation de la version installée, lisible hors ligne, par vous comme par un agent.
35
20
 
36
21
  ## Démarrage rapide
37
22
 
23
+ Dans un dossier vide, avec Node.js 20.12 ou plus et une base PostgreSQL 14 ou plus :
24
+
38
25
  ```bash
39
- npm config set "@fraza:registry" https://registry.fraza.ca/
40
26
  npx @fraza/start
27
+ ```
28
+
29
+ Renseignez `FRAZA_DATABASE_URL` dans le `.env.local` créé, puis :
30
+
31
+ ```bash
41
32
  npx fraza-db init
42
33
  npm run dev
43
34
  ```
44
35
 
45
- Aucun compte n'est demandé : le core et les modules gratuits se lisent librement sur le registre. Le détail, et la connexion pour les modules Pro, est dans [Installation](./docs/01-demarrage/01-installation.md).
36
+ Ouvrez `http://localhost:3000/auth` pour créer le premier compte, qui reçoit le rôle `admin`. Le détail est dans [Installation](https://docs.fraza.ca/docs/demarrage/installation).
37
+
38
+ ## Ajouter un module
39
+
40
+ ```bash
41
+ npm i @fraza/module-pages
42
+ ```
43
+
44
+ ```dotenv
45
+ # .env.local
46
+ FRAZA_MODULE_PAGES=true
47
+ ```
48
+
49
+ ```bash
50
+ npx fraza-modules sync
51
+ npx fraza-db init
52
+ ```
53
+
54
+ | Module | Paquet | Licence |
55
+ |---|---|---|
56
+ | [Pages](https://docs.fraza.ca/docs/modules/pages) | `@fraza/module-pages` | MIT |
57
+ | [Posts](https://docs.fraza.ca/docs/modules/posts) | `@fraza/module-posts` | MIT |
58
+ | [Médias](https://docs.fraza.ca/docs/modules/medias) | `@fraza/module-medias` | MIT |
59
+ | [Formulaires](https://docs.fraza.ca/docs/modules/forms) | `@fraza/module-forms` | MIT |
60
+ | [Facturation](https://docs.fraza.ca/docs/modules/facturation) | `@fraza-pro/module-billing` | Fraza Pro |
61
+ | [Rendez-vous](https://docs.fraza.ca/docs/modules/booking) | `@fraza-pro/module-booking` | Fraza Pro |
62
+ | [Fichiers](https://docs.fraza.ca/docs/modules/drive) | `@fraza-pro/module-drive` | Fraza Pro |
63
+
64
+ Le core et les modules gratuits s'installent depuis npmjs, sans compte. Les modules Pro demandent un compte sur `https://registry.fraza.ca/`.
65
+
66
+ ## Commandes
67
+
68
+ | Commande | Rôle |
69
+ |---|---|
70
+ | `fraza-db` | Créer, tester et supprimer les tables du core et des modules. |
71
+ | `fraza-modules` | Régénérer les manifestes des modules, blocs et templates. |
72
+ | `fraza-doctor` | Diagnostiquer le projet : variables manquantes, modules, paquets, vulnérabilités. |
73
+ | `fraza-update` | Mettre à jour le core, les icônes et les modules en une commande. |
74
+ | `fraza-key` | Écrire le jeton du registre pour les modules Pro. |
75
+
76
+ Chaque commande est détaillée dans la [référence des CLI](https://docs.fraza.ca/docs/reference/cli).
77
+
78
+ ## Documentation
79
+
80
+ | Section | Contenu |
81
+ |---|---|
82
+ | [Découverte](https://docs.fraza.ca/docs/decouverte) | Ce qu'est Fraza, sans rien installer. |
83
+ | [Démarrage](https://docs.fraza.ca/docs/demarrage) | De l'installation au premier module, à lire dans l'ordre. |
84
+ | [Guides](https://docs.fraza.ca/docs/guides) | Un cas d'usage par page. |
85
+ | [Référence](https://docs.fraza.ca/docs/reference) | Chaque fonction, commande et variable d'environnement. |
86
+ | [Architecture](https://docs.fraza.ca/docs/architecture) | Principes, frontières serveur/client, sécurité, design system. |
87
+ | [Contribution](https://docs.fraza.ca/docs/contribution) | Conventions de code, de rédaction, de commit et publication. |
46
88
 
47
89
  ## Sécurité
48
90
 
49
- Pour signaler une faille de sécurité, voir [SECURITY.md](./SECURITY.md).
91
+ N'ouvrez pas d'issue publique pour une faille. Écrivez à **security@hyko.cx**. La politique complète est dans [SECURITY.md](./SECURITY.md).
50
92
 
51
93
  ## Licence
52
94
 
53
- Licence MIT. Copyright (c) 2026 HYKO. Voir [LICENSE](./LICENSE).
54
-
55
- Ce paquet fait partie de Fraza Libre. Les dépendances tierces et leurs licences sont listées dans [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md).
95
+ MIT. Copyright (c) 2026 HYKO. Voir [LICENSE](./LICENSE). Les dépendances tierces sont listées dans [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md).
56
96
 
57
- Les modules Facturation, Rendez-vous et Fichiers (`@fraza-pro/module-billing`, `@fraza-pro/module-booking`, `@fraza-pro/module-drive`) sont distribués à part, sous la licence Fraza Pro. Leur installation demande un compte sur le registre. Le modèle est expliqué dans [Licence et propriété](./docs/04-architecture/07-licence-et-propriete.md).
97
+ Le core et les modules Pages, Posts, Médias et Formulaires forment Fraza Libre. Les modules Facturation, Rendez-vous et Fichiers sont sous la licence Fraza Pro, une licence par projet en production : voir [Licence et propriété](https://docs.fraza.ca/docs/architecture/licence-et-propriete).
package/THIRD-PARTY-NOTICES.md CHANGED
@@ -19,7 +19,7 @@ Il est généré par `fraza-module notices` à partir de l'arbre réellement ins
19
19
 
20
20
  | Paquet | Version | Licence |
21
21
  |---|---|---|
22
- | `@fraza/icons` | 0.3.9 | MIT |
22
+ | `@fraza/icons` | 0.3.10 | MIT |
23
23
  | `node-cron` | 4.2.1 | ISC |
24
24
  | `pg` | 8.20.0 | MIT |
25
25
  | `pg-cloudflare` | 1.3.0 | MIT |
@@ -146,7 +146,7 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
146
146
 
147
147
  ## Textes de licence
148
148
 
149
- ### @fraza/icons@0.3.9
149
+ ### @fraza/icons@0.3.10
150
150
 
151
151
  Licence : MIT
152
152
 
package/changelog.json CHANGED
@@ -1,6 +1,49 @@
1
1
  {
2
2
  "name": "@fraza/core",
3
3
  "versions": [
4
+ {
5
+ "version": "0.3.8",
6
+ "date": "2026-10-25",
7
+ "breaking": [],
8
+ "envAdded": [],
9
+ "envRemoved": [],
10
+ "templateChanged": [],
11
+ "action": [],
12
+ "entries": [
13
+ {
14
+ "type": "docs",
15
+ "scope": null,
16
+ "subject": "add start command in README",
17
+ "hash": "e5c953d",
18
+ "breaking": false
19
+ }
20
+ ]
21
+ },
22
+ {
23
+ "version": "0.3.7",
24
+ "date": "2026-10-25",
25
+ "breaking": [],
26
+ "envAdded": [],
27
+ "envRemoved": [],
28
+ "templateChanged": [],
29
+ "action": [],
30
+ "entries": [
31
+ {
32
+ "type": "refactor",
33
+ "scope": "README",
34
+ "subject": "update landing page to remove redundant commands",
35
+ "hash": "fe88136",
36
+ "breaking": false
37
+ },
38
+ {
39
+ "type": "Refactor",
40
+ "scope": "README",
41
+ "subject": "update content and structure",
42
+ "hash": "2a08dbf",
43
+ "breaking": false
44
+ }
45
+ ]
46
+ },
4
47
  {
5
48
  "version": "0.3.6",
6
49
  "date": "2026-10-25",
package/dist/shared/lib/version.js CHANGED
@@ -1,4 +1,4 @@
1
- const CORE_VERSION = "0.3.6";
1
+ const CORE_VERSION = "0.3.8";
2
2
  export {
3
3
  CORE_VERSION
4
4
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fraza/core",
3
- "version": "0.3.6",
3
+ "version": "0.3.8",
4
4
  "description": "Starter kit Next.js avec un back-office modulaire, conçu au Québec.",
5
5
  "publishConfig": {
6
6
  "access": "public"