🌿 QualiSite

Site vitrine et outil de gestion interne pour l'entreprise QualiSite : backend Express / TypeScript + frontend Next.js 16 (React 19).
Développé dans le cadre d'un stage — projet d'apprentissage fullstack.

C'est la méthode recommandée. Le docker-compose.yml lance le frontend (port 3000), le backend (port 3001) et une base PostgreSQL (port 5435).

1. Configurer l'environnement

cp backend/.env.example backend/.env
# Renseigner JWT_SECRET, RESEND_API_KEY, etc.

2. Lancer

docker compose up --build -d

• Frontend : http://localhost:3000
• Backend API : http://localhost:3001
• Base de données : port 5435

cd backend && npm install
npm run dev        # rechargement auto (tsx --watch)

Routes disponibles :

cd frontend && npm install
npm run dev

Ouvrir http://localhost:3000.

cd backend
npm run db:migrate    # Nouvelle migration Prisma
npm run db:seed       # Données de test
npm run db:reset      # Reset complet BDD

QualiSite/
├── docker-compose.yml
├── backend/
│   ├── prisma/
│   │   ├── schema.prisma           # Modèle de données
│   │   └── migrations/             # Historique des migrations
│   └── src/
│       ├── app.ts                  # Point d'entrée Express
│       ├── controllers/            # Logique métier (auth, projets, services, contacts)
│       ├── routers/                # Définition des routes
│       ├── middlewares/            # Auth JWT, gestion d'erreurs, validation
│       ├── models/                 # Seeding BDD
│       └── lib/                    # Mailer, upload, token, logger
└── frontend/
    ├── app/
    │   ├── page.tsx                # Page d'accueil (vitrine)
    │   └── admin/                  # Backoffice (login, projets, services, contacts)
    └── components/                 # Composants réutilisables

Le site est hébergé sur un Raspberry Pi 5 exposé via un tunnel Cloudflare (sans port ouvert ni IP publique).

URL publique : https://qualisite.alithiel31.dev

Internet → Cloudflare Tunnel → qualisite-frontend (port 3000)

• Docker + Docker Compose installés
• cloudflared installé et authentifié (cloudflared login)

# Rebuilder et relancer sur le RPi
docker compose up --build -d

⚠️ Migration ponctuelle (une seule fois) — stockage des uploads Les images uploadées sont désormais persistées via un volume Docker nommé (backend_uploads_prod) plutôt que d'être embarquées dans l'image ou committées dans le dépôt. Avant de redéployer cette version, sauvegardez le contenu actuel de /app/uploads du conteneur backend-prod en cours d'exécution puis copiez-le dans le nouveau volume, sous peine de perdre les images déjà en ligne :

docker cp $(docker compose ps -q backend-prod):/app/uploads /tmp/uploads-backup
docker compose up --build -d
docker cp /tmp/uploads-backup/. $(docker compose ps -q backend-prod):/app/uploads

- hostname: qualisite.alithiel31.dev
  service: http://localhost:3000

Projet de stage — usage interne QualiSite.