# Configuration Gitea — 4NK_template (projet)

## 1. Repository

- Activer les Actions (workflows `.gitea/workflows/*.yml`)
- Vérifier les templates d’issues/PR

## 2. Protections de branches

- Reviews requises avant merge
- Status checks requis (CI verte)
- Mise à jour obligatoire de la branche avant merge

## 3. Secrets et variables

- Secrets: `OPENAI_API_KEY` (optionnel), `RELEASE_TOKEN` (obligatoire pour publier les releases via API Gitea)
- Variables: paramètres de CI non sensibles, ex: `OPENAI_MODEL`, `OPENAI_API_BASE`, `OPENAI_TEMPERATURE`, `BASE_URL`

### Ajouter `RELEASE_TOKEN`

- Aller dans Repository Settings → Secrets → New Repository Secret
- Nom: `RELEASE_TOKEN` ; Valeur: un token personnel avec portée API sur le dépôt
- Le job `release-create` utilisera ce secret lors d’un push de tag `v*`

### Runner Gitea (labels)

- Configurez votre runner avec labels: `self-hosted,linux`
- Option A (runner dédié): `gitea/act_runner` via docker-compose dans `runner/`
- Option B (conteneur unifié): `RUNNER_MODE=runner` dans `docker-compose.ci.yml` + `BASE_URL` et `REGISTRATION_TOKEN`
  - Enregistrement (automatisé par entrypoint si variables présentes)
  - Démarrage: `docker compose -f docker-compose.ci.yml up -d`

## 4. Workflows requis

- `code-quality`, `unit-tests`, `documentation-tests`, `security-audit`
- `deployment-checks`, `bash-required`, `markdownlint`, `release-guard`, `release-create`
- (Optionnels) `agents-smoke`, `openia-agents`
- (Conteneur unifié) job custom pour builder et lancer `docker-compose.ci.yml` si nécessaire

## 5. Processus PR

- Branche dédiée, PR petite et ciblée
- CI verte, review approuvée
- Doc et changelog à jour