Nathéo CMS

Un CMS moderne et performant développé avec Symfony

Documentation · Signaler un bug · Demander une fonctionnalité

</div>

📋 Table des matières

À propos
Prérequis
Aperçu
Installation
Configuration
Utilisation
Commandes disponibles
Tests
Documentation
Contribution
Contributeurs
Licence

🚀 À propos

Nathéo est un système de gestion de contenu (CMS) moderne développé avec Symfony, offrant une solution flexible et performante pour la création et la gestion de sites web. Le projet privilégie la modularité, la sécurité et l'expérience utilisateur.

Fonctionnalités principales

🎨 Interface d'administration moderne et responsive
🔒 Système d'authentification et de permissions robuste
📝 Gestion de contenu flexible
🌍 Support multilingue (FR, EN, ES)
⚡ Performance optimisée
🎯 Architecture modulaire

⚙️ Prérequis

Avant de commencer, assurez-vous d'avoir installé les éléments suivants :

| Composant | Version requise | Notes | |----------------|----------------------|---------------------------------| | PHP | 8.4 ou supérieur | Extensions recommandées ci-dessous | | Composer | 2.8.9 ou supérieur | Gestionnaire de dépendances PHP | | Yarn | 1.22.22 ou supérieur | Gestionnaire de paquets JavaScript | | Base de données | Voir ci-dessous | MySQL ou PostgreSQL |

Base de données supportées

PostgreSQL : 15.2 ou supérieur
MySQL : 8.2 ou supérieur (par défaut)

📌 Note : Pour utiliser PostgreSQL ou une autre base de données, consultez la documentation de configuration.

Extensions PHP recommandées

ext-ctype, ext-iconv, ext-pdo, ext-pdo_mysql, ext-json, ext-mbstring

🖼️ Aperçu

Un aperçu de l'interface en quelques écrans.

<div align="center"> <table> <tr> <td align="center"> <img height="400" alt="Authentification" src="https://github.com/user-attachments/assets/93232a83-c482-4ff0-8143-f658c4c168d9"/> <br/> <sub>Authentification</sub> </td> <td align="center"> <img height="400" alt="Mon compte" src="https://github.com/user-attachments/assets/76f5ec36-5558-481e-8668-dd9339264b6b"/> <br/> <sub>Mon compte</sub> </td> <td align="center"> <img height="400" alt="FAQ" src="https://github.com/user-attachments/assets/607f475a-bae4-4114-a881-0de482aef588"/> <br/> <sub>Une FAQ</sub> </td> </tr> </table> </div>

📦 Installation

Installation rapide (développement)

⚠️ Attention : Cette procédure est prévue pour un environnement de développement.
Pour une installation en production, consultez la documentation d'installation production.

1. Cloner le dépôt

git clone https://github.com/counteraccro/natheo.git
cd natheo

2. Installer les dépendances

composer install

3. Configurer l'environnement

Créez une copie du fichier .env en .env.local :

cp .env .env.local

Modifiez les variables suivantes dans .env.local :

APP_ENV=dev
APP_DEBUG=1
NATHEO_SCHEMA=natheo
DATABASE_URL="mysql://user:password@127.0.0.1:3306/natheo?serverVersion=8.2"

4. Installation automatique du CMS

Cette commande exécute automatiquement les étapes 5, 6 et 7 :

php bin/console natheo:install

<details> <summary><strong>Installation manuelle (optionnel)</strong></summary>

Si vous préférez effectuer l'installation étape par étape :

5. Créer la base de données

php bin/console doctrine:database:create

6. Créer le schéma de base de données

php bin/console doctrine:schema:create

7. Charger les données de test

php bin/console doctrine:fixtures:load

</details>

8. Compiler les assets

yarn install
yarn dev

🛠️ Configuration

Configuration du Virtual Host

Pour accéder au CMS en développement :

Créez un virtual host pointant vers : [chemin-vers-natheo]/public
Exemple de configuration Apache :

<VirtualHost *:80>
    ServerName www.local.natheo
    ServerAlias  local.natheo
    DocumentRoot "[chemin-vers-natheo]/public"
    
    <Directory "[chemin-vers-natheo]/public">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Ajoutez l'entrée dans votre fichier hosts :

127.0.0.1    natheo.local

💻 Utilisation

Accès à l'interface d'administration

Une fois l'installation terminée :

Accédez à : http://natheo.local/admin/fr/dashboard/index
Connectez-vous avec les identifiants par défaut :

Email : user.demo@mail.fr
Mot de passe : user.demo@mail.fr

🔐 Important : Changez immédiatement ces identifiants en production !

📝 Commandes disponibles

Commandes principales

| Commande | Description | |----------|-------------| | php bin/console natheo:install | Installation complète du CMS | | php bin/console messenger:consume async -vv | Traitement des tâches asynchrones | | php bin/console doctrine:fixtures:load | Chargement des données de test |

Gestion des traductions

Générer/extraire les traductions pour une langue :

# Français
php bin/console translation:extract --force --format=yaml fr

# Anglais
php bin/console translation:extract --force --format=yaml en

# Espagnol
php bin/console translation:extract --force --format=yaml es

Compilation des assets

# Mode développement avec watch
yarn dev

# Mode production
vite build

🧪 Tests

Lancer la suite de tests unitaires :

bin/phpunit

📚 Documentation

La documentation complète est disponible en ligne :

Documentation officielle : https://counteraccro.github.io/natheo.doc/
Guide d'installation : Installation
Configuration de la base de données : Configuration BDD
Installation en production : Mode production

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

🍴 Fork le projet
🔨 Créer une branche pour votre fonctionnalité (git checkout -b feature/AmazingFeature)
✅ Commit vos changements (git commit -m 'Add some AmazingFeature')
📤 Push vers la branche (git push origin feature/AmazingFeature)
🎉 Ouvrir une Pull Request

👥 Contributeurs

<table> <tr> <td align="center"> <a href="https://github.com/counteraccro"> <img src="https://avatars.githubusercontent.com/u/3640049?v=4" width="100px;" alt="Counteraccro"/><br /> <sub><b>Counteraccro</b></sub> </a><br /> <sub>Fondateur & Lead Developer</sub> </td> <td align="center"> <a href="https://github.com/MaxenceMahieux"> <img src="https://avatars.githubusercontent.com/u/139382475?v=4" width="100px;" alt="MaxenceMahieux"/><br /> <sub><b>Maxence Mahieux</b></sub> </a><br /> <sub>Co-fondateur & Admin Système</sub><br /> <sub><a href="https://github.com/MaxenceMahieux/flaase-cli-rust">Projet : Flaase CLI</a></sub> </td> </tr> </table>

📄 Licence

Ce projet est sous licence GNU-V3. Voir le fichier LICENSE pour plus de détails.

Développé avec ❤️ par l'équipe Nathéo

⬆ Retour en haut