4NK_template/docs/project/CONFIGURATION.md

Configuration — 4NK_template (projet)

Variables d’environnement (CI)

• Secrets CI uniquement (pas de secrets en clair)
• Variables agents : OPENAI_API_KEY, OPENAI_MODEL, OPENAI_API_BASE, OPENAI_TEMPERATURE
• Secret release: RELEASE_TOKEN (publication des releases via l’API Gitea)
• Variable optionnelle: GITEA_BASE_URL (ex: https://git.4nkweb.com)

Conventions

• Retours de ligne normalisés par CI
• Dossiers tests/logs et tests/reports réservés aux artefacts

Pré-requis agents

• bash requis (job CI bash-required)
• Fallback PowerShell utilisable localement

Gestion locale des secrets (~/.4nk_template/.env)

• Modèle fourni: scripts/env/.env.template (clés sans valeurs)
• Provisionnement automatique: scripts/env/ensure_env.sh
  • crée ~/.4nk_template/ (chmod 700) et ~/.4nk_template/.env (chmod 600) si absent
  • copie depuis le template puis demande de compléter
  • vérifie les variables essentielles (ex: OPENAI_API_KEY, OPENAI_MODEL)
• Chargement automatique: scripts/agents/run.sh source ~/.4nk_template/.env si présent

Lints Markdown

• Configuration: .markdownlint.json (MD013 à 200 colonnes, MD024 en siblings_only)
• CI: job markdownlint exécute markdownlint-cli sur tous les .md (hors archive/**)