c1ca3b9b44
- Présentation de la plateforme web pour les adhérents KAZ. - Détails sur les fonctionnalités, l'architecture technique et les prérequis. - Instructions pour l'installation et le démarrage rapide du projet. - Normes de développement documentées.
2.5 KiB
Plateforme web pour les adhérents KAZ
Objectif
Cette application web permet aux adhérents de l'association KAZ de gérer leur compte en agrégeant les données des utilisateurs dispersées dans plusieurs outils de l'écosystème.
Fonctionnalités (Version 1)
- Connexion sécurisée : Accès réservé aux adhérents à l'administration.
- Visualisation des données : Affichage des informations personnelles de l'utilisateur.
- Modification du profil : Possibilité de changer l'adresse e-mail de secours.
Architecture technique
- Frontend : Twig + Tailwind CSS
- Backend : PHP 8.4 / Symfony
- Base de données : PostgreSQL
- Intégration : Communication via API avec les outils de KAZ (notamment OpenLDAP).
Cette base est conçue pour évoluer et intégrer de nouveaux outils et fonctionnalités à l'avenir.
Prérequis
- PHP 8.4 ou supérieur
- Composer : (Gestionnaire de dépendances PHP)
- Symfony CLI (Interface en ligne de commande Symfony)
- PostgreSQL (Système de gestion de base de données)
- IDE recommandé : PhpStorm ou VSCode
Vérifier les prérequis : symfony check:requirements
Normes de développement
Le projet suit les standards de développement suivants :
- Git Flow : Modèle de gestion de branches.
- Conventional Commits : Norme pour les messages de commit.
Quick start
1. Installation des dépendances
Clonez le projet et installez les dépendances avec Composer :
composer install
2. Configuration de l'environnement
Copiez le fichier .env en .env.local et configurez vos accès à la base de données et à l'API :
cp .env .env.local
3. Base de données
Créez la base de données et exécutez les migrations :
php bin/console doctrine:database:create
php bin/console doctrine:migrations:migrate
4. Installation des assets
Le projet utilise AssetMapper. Installez les dépendances JS :
php bin/console importmap:install
5. Lancement du serveur
Utilisez le serveur Symfony pour lancer le projet localement :
symfony serve -d
L'application sera accessible sur https://127.0.0.1:8000.
Projet développé pour KAZ.