# DEV

## Standards

Toute contribution doit respecter les guides suivants :

- [GUIDE.md](GUIDE.md) — conventions générales de rédaction et de structure
- [REDACTION.md](REDACTION.md) — règles de style, ton et formatage

---

## Structure du projet

```
src/
├── cli/          # Scripts CLI : zen-db, zen-setup
├── core/         # Briques techniques : database, api, email, storage, cron, pdf, toast, payments
├── features/     # Features utilisateur : auth, admin, provider
├── modules/      # Modules métier : posts, invoice, nuage…
└── shared/       # Composants, lib et styles partagés
```

---

## Publier le package

Le package `@zen/core` est publié sur le registre npm à `https://git.hyko.cx`.

### 1. Configurer l'authentification

Créer un token d'accès dans Gitea (Settings → Applications → Generate Token), puis l'enregistrer localement :

```bash
npm config set //git.hyko.cx/api/packages/zen/npm/:_authToken TOKEN
```

Remplacer `TOKEN` par le token généré.

### 2. Build et publish

```bash
npm publish
```

Le script `prepublishOnly` lance automatiquement le build avant la publication.

---

## Bump de version

Modifier `"version"` dans `package.json` en suivant [semver](https://semver.org/) :

| Changement | Version |
|------------|---------|
| `fix` — correctif | PATCH `1.x.X` |
| `feat` — nouvelle fonctionnalité | MINOR `1.X.0` |
| Breaking change | MAJOR `X.0.0` |

---