# (RE)Sources Relationnelles

Plateforme de partage de ressources relationnelles à destination des citoyens
(simulation d'un projet du Ministère des Solidarités et de la Santé).
Projet collaboratif — **CDA / CESI — Groupe 1**.

Application web développée avec **Laravel 12** (architecture MVC), conteneurisée
avec **Docker** et déployée en continu via **Gitea Actions**.

- Application : https://app.sam-coffre.duckdns.org
- Dépôt Git : https://gitea.sam-coffre.duckdns.org/

## Stack technique

| Élément | Technologie |
|---------|-------------|
| Framework | Laravel 12 (PHP 8.2) |
| Base de données | MySQL / MariaDB (SQLite en test) |
| Serveur web | Nginx (reverse proxy + TLS) |
| Conteneurisation | Docker / Docker Compose |
| Gestion de version | Git + Gitea |
| CI/CD | Gitea Actions |
| Qualité de code | Laravel Pint |
| Tests | PHPUnit |

## Installation en local

```bash
git clone https://gitea.sam-coffre.duckdns.org/<groupe>/ressources-relationnel.git
cd ressources-relationnel
cp .env.example .env
composer install
php artisan key:generate
php artisan migrate --seed
npm install && npm run build
php artisan serve
```

## Développement

```bash
# Lancer les tests automatisés
php artisan test

# Vérifier le style de code
vendor/bin/pint --test

# Corriger automatiquement le style de code
vendor/bin/pint
```

## Déploiement

Le déploiement est **automatisé** : un `push` sur la branche `master` déclenche
la CI (qualité + tests) puis, si tout est vert, le déploiement en production.
Voir [`docs/02-plan-de-deploiement.md`](docs/02-plan-de-deploiement.md).

## Documentation (rendu bloc INFCDAAL3)

La documentation technique « Déployer et sécuriser » est dans le dossier
[`docs/`](docs/README.md) :

- [Plan de sécurisation](docs/01-plan-de-securisation.md)
- [Plan de déploiement](docs/02-plan-de-deploiement.md)
- [Gestion des versions](docs/03-gestion-des-versions.md)
- [Gestion des évolutions](docs/04-gestion-des-evolutions.md)

## Licence

Projet pédagogique — usage limité au cadre de la formation.