Configuration

La configuration est lue dans conf/<env>.ini, où <env> vaut la variable d'environnement APP_ENV (prod par défaut, testing pour les tests). Les commentaires commencent par ; (le # n'est pas accepté par PHP).

data/conf/prod.ini est écrit par l'assistant d'installation à partir de conf/prod.sample.ini, avec les paramètres de la base et des secrets aléatoires (jwtsecret, password_salt, sync_token) ; avec Docker, il se trouve dans /data/conf/prod.ini. Il contient des secrets : il est ignoré par Git et ne doit jamais être publié. Après une modification à la main, rien n'est à redémarrer (le fichier est relu à chaque requête), sauf le conteneur Docker pour SYNC_INTERVAL.

Les réglages modifiés depuis le portail sont, eux, enregistrés en base (voir Réglages en base).

[global]

Clé	Valeurs	Description
log_level	debug, info, warning, error	Niveau minimal des logs (data/logs/carbure_AAAAMMJJ.log). En debug, les erreurs PHP sont affichées et les réponses JSON indentées.
development	true / false	Indicateur de mode développement, écrit à false par l'assistant (sans effet actuellement)
savings_category	nom	Catégorie dont les transactions (avec ses sous-catégories) constituent l'épargne de l'onglet Tendances ; Epargne par défaut, casse et accents ignorés
public_url	URL	Facultatif : adresse publique de Carbure (https://carbure.exemple.fr), annoncée aux agents IA qui se connectent par OAuth. Par défaut, déduite de la requête : à renseigner si le proxy HTTPS n'envoie pas X-Forwarded-Proto

[database]

Clé	Description
db_hostname	Hôte MariaDB/MySQL
db_port	Port (3306 par défaut ; 3307 pour MariaDB 10 sur Synology)
db_username, db_password	Identifiants
db_name	Nom de la base

[cleansing]

regex_label["/FACTURE CARTE DU \d{6}\s*/"]="CB "
regex_label["/\s(CARTE.*|CARTE|CART|CAR|CA|C)$/"]=""
regex_label["/(PRLV SEPA.*)(ECH.*|MDT.*)$/"]="$1"

Expressions régulières appliquées, dans l'ordre, au libellé en majuscules de chaque transaction importée.

Ne pas modifier sans migration

Le libellé nettoyé entre dans l'UUID des transactions. Changer ces règles fait réimporter les transactions existantes sous un autre UUID (doublons).

[auth]

Clé	Description
jwtsecret	Secret HMAC des JWT (durée de validité : 30 jours), généré par l'assistant d'installation. Un administrateur le renouvelle depuis le portail (bandeau affiché si le secret est faible) ; le changer déconnecte tous les clients.
password_salt	Sel des anciens mots de passe SHA-256, utilisé seulement pour les migrer vers bcrypt à la connexion
sync_token	Secret permettant au planificateur d'appeler /api/bank/sync sans JWT. Vide = seul un utilisateur connecté peut lancer la synchro.

[woob]

Clé	Description
woob_path	Commande woob : binaire local (/usr/bin/woob), conteneur (docker run -v …:/root/ ltoinel/woob:3.7 woob) ou, dans l'image Docker, env HOME=/data/woob woob (variable CARBURE_WOOB_PATH)
woob_transactions	Nombre d'opérations demandées par appel (--count)
woob_logging	Niveau de log de woob
woob_debug	true pour journaliser la sortie complète de woob
woob_auto_update	true pour laisser woob mettre à jour ses modules

[apns]

Clé	Description
apns_bundle_id	Bundle ID de l'app iOS (sujet APNs)
apns_auth_method	token (clé .p8, recommandé) ou certificate
apns_key_path	Chemin de la clé .p8, absolu ou relatif au dossier data/ (ex. conf/certs/AuthKey_XXXX.p8, soit data/conf/certs/AuthKey_XXXX.p8)
apns_key_id, apns_team_id	Identifiants Apple Developer
apns_certificate_path, apns_certificate_password	Pour l'authentification par certificat
apns_environment	production ou sandbox
apns_endpoint	Facultatif : URL APNs imposée (tests), à la place de celle déduite de apns_environment

Les clés .p8 placées dans data/conf/certs/ sont ignorées par Git.

Réglages en base

Les réglages modifiés depuis le portail sont enregistrés dans la table settings (name, value) et non dans le fichier :

Réglage	Valeurs	Modifié dans
mcp_enabled	1 / 0 (désactivé par défaut)	Onglet Agent IA, interrupteur Serveur MCP activé (administrateur)

Variables d'environnement

Variable	Rôle
APP_ENV	Nom du fichier de configuration (prod par défaut)
DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD, LANGUAGE, CARBURE_WOOB_PATH	Valeurs proposées par l'assistant d'installation (Docker) ; le mot de passe de l'environnement n'est utilisé que pour cette base
SYNC_INTERVAL	Docker : intervalle de la synchronisation automatique, en secondes