# Commits et versioning — Olhar-API

## Scopes Conventional Commits

Le format global est défini dans les règles workspace (`commit.md`). Scopes spécifiques à ce projet :

| Scope | Usage |
|-------|-------|
| `auth` | Authentification, JWT, sécurité |
| `user` | Entité utilisateur, inscription, profil |
| `photo` | Gestion des photos (upload, listing, métadonnées) |
| `db` | Migrations Flyway, schéma |
| `config` | Configuration Spring, OpenAPI, CORS |
| `ci` | Workflows Gitea Actions |
| `docs` | Documentation technique ou fonctionnelle |

## Versioning dans build.gradle

La version est définie dans `build.gradle` :

```groovy
version = '0.1.0'
```

Règles de bump (semver) :
- `PATCH` : correction de bug, ajout mineur, refactoring
- `MINOR` : nouvelle fonctionnalité complète et fonctionnelle
- `MAJOR` : changement cassant d'API ou livraison majeure

Mettre à jour `version` dans `build.gradle` à chaque commit significatif.

## Convention de branches

- `main` : code stable, toujours fonctionnel et buildable
- `feat/<nom>` : nouvelles fonctionnalités
- Merger dans `main` uniquement quand les tests passent.