Aller au contenu principal

Configuration

Cette page explique comment configurer PCH-SIG pour votre environnement.

Variables d'environnement​

Backend (.env)​

Fichier : backend/.env

# Environnement
APP_ENV=prod
APP_SECRET=votre_secret_unique_32_caracteres

# Base de donnees
DATABASE_URL="postgresql://pch_admin:pch_secure_2025@pch_postgres:5432/pch_sig?serverVersion=15&charset=utf8"

# Redis
REDIS_URL=redis://redis_secure_2025@pch_redis:6379

# JWT
JWT_SECRET_KEY=%kernel.project_dir%/config/jwt/private.pem
JWT_PUBLIC_KEY=%kernel.project_dir%/config/jwt/public.pem
JWT_PASSPHRASE=votre_passphrase_jwt

# Email
MAILER_DSN=smtp://pch_mailpit:1025

# CORS
CORS_ALLOW_ORIGIN='^https?://(localhost|192\.168\.1\.213)(:[0-9]+)?$'

Frontend (.env)​

Fichier : frontend/.env

# URL de l'API (relative pour production)
REACT_APP_API_URL=/api

# Activer le mode debug
REACT_APP_DEBUG=false
Important

Ne commitez jamais les fichiers .env contenant des secrets en production. Utilisez .env.local.

Configuration Backend​

Base de donnees​

Fichier : backend/config/packages/doctrine.yaml

doctrine:
    dbal:
        url: '%env(resolve:DATABASE_URL)%'
        charset: utf8
    orm:
        auto_generate_proxy_classes: false
        naming_strategy: doctrine.orm.naming_strategy.underscore_number_aware
        auto_mapping: true

Cache Redis​

Fichier : backend/config/packages/cache.yaml

framework:
    cache:
        app: cache.adapter.redis
        default_redis_provider: '%env(REDIS_URL)%'

JWT​

Fichier : backend/config/packages/lexik_jwt_authentication.yaml

lexik_jwt_authentication:
    secret_key: '%env(resolve:JWT_SECRET_KEY)%'
    public_key: '%env(resolve:JWT_PUBLIC_KEY)%'
    pass_phrase: '%env(JWT_PASSPHRASE)%'
    token_ttl: 3600        # 1 heure

    # Refresh token
    token_extractors:
        authorization_header:
            enabled: true
            prefix: Bearer

CORS​

Fichier : backend/config/packages/nelmio_cors.yaml

nelmio_cors:
    defaults:
        origin_regex: true
        allow_origin: ['%env(CORS_ALLOW_ORIGIN)%']
        allow_methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS']
        allow_headers: ['Content-Type', 'Authorization']
        max_age: 3600

Configuration Nginx​

Frontend​

Fichier : deploy/nginx-conf/default.conf

server {
    listen 80;
    server_name _;
    root /usr/share/nginx/html;
    index index.html;

    # Compression gzip
    gzip on;
    gzip_types text/plain text/css application/json application/javascript;

    # SPA routing
    location / {
        try_files $uri $uri/ /index.html;
    }

    # Proxy API vers backend
    location /api {
        proxy_pass http://pch_nginx_backend:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    # Cache assets
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}

Backend​

Fichier : deploy/nginx-conf/backend.conf

server {
    listen 80;
    server_name _;
    root /app/public;
    index index.php;

    location / {
        try_files $uri /index.php$is_args$args;
    }

    location ~ ^/index\.php(/|$) {
        fastcgi_pass pch_backend:9000;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        internal;
    }

    location ~ \.php$ {
        return 404;
    }
}

Configuration du Menu​

Desactiver des modules​

Depuis l'interface : Parametres > Configuration du menu

Ou via l'API :

{
  "menu": {
    "menages": true,
    "beneficiaires": true,
    "cycles": true,
    "carte": false,
    "kobo": false
  }
}

Configuration des Permissions​

Fichier de reference​

Fichier : backend/config/reference.php

return [
    'permissions' => [
        'registre.menages_view',
        'registre.menages_create',
        'registre.menages_edit',
        'registre.menages_delete',
        'registre.menages_validate',
        'transferts.cycles_view',
        'transferts.cycles_create',
        // ...
    ],

    // Les rôles et leurs permissions sont gérés en base de données.
    // Voir Paramètres > Rôles dans l'interface d'administration.
    // Consulter la page Rôles et Permissions pour la liste complète.
];

Configuration Email​

Production (SMTP)​

MAILER_DSN=smtp://user:password@smtp.example.com:587

Developpement (Mailpit)​

MAILER_DSN=smtp://pch_mailpit:1025

Interface Mailpit : http://localhost:8025

Configuration Logging​

Fichier : backend/config/packages/monolog.yaml

monolog:
    handlers:
        main:
            type: rotating_file
            path: '%kernel.logs_dir%/%kernel.environment%.log'
            level: info
            max_files: 10

        console:
            type: console
            process_psr_3_messages: false
            channels: ["!event", "!doctrine"]

Prochaines etapes​