Aller au contenu

Projet Soretour

Localisation sur le VPS : /home/debian/soretour Acces : https://soretour.poleelevage.fr via Cloudflare Tunnel → http://node-dev-env:3000

Stack technique

Element Technologie
Framework Next.js (TypeScript)
Runtime Node.js 20 (Alpine)
Base de donnees Supabase
UI Components shadcn/ui (components.json)
CSS PostCSS (Tailwind CSS)
Tests Vitest
Linting ESLint (eslint.config.mjs)

Structure du projet

/home/debian/soretour/
├── src/                    # Code source principal
├── public/                 # Assets statiques
├── supabase/               # Config et migrations Supabase
├── tests/                  # Tests Vitest
├── _bmad/                  # Methodologie BMAD (specifications)
├── _bmad-output/           # Outputs generes par BMAD
│   └── archive/
│       └── 2025-12-29/
├── components.json         # Config shadcn/ui
├── next.config.ts          # Config Next.js
├── next-env.d.ts           # Types Next.js
├── postcss.config.mjs      # Config PostCSS/Tailwind
├── eslint.config.mjs       # Config ESLint
├── tsconfig.json           # Config TypeScript
├── vitest.config.ts        # Config Vitest
├── package.json            # Dependances
├── test-accounts.md        # Comptes de test
├── test-data/              # Donnees de test
├── CLAUDE.md               # Instructions pour Claude AI
└── README.md               # Documentation

Methodologie BMAD

Le projet utilise la methodologie BMAD (presence des dossiers _bmad et _bmad-output), qui est un framework de developpement assiste par IA structurant le projet en phases (Brief, Mapping, Architecture, Development).

Deploiement Docker

Stack Portainer (actuelle)

version: "3.8"
services:
  node-dev:
    image: node:20-alpine
    container_name: node-dev-env
    working_dir: /soretour
    volumes:
      - /home/debian/soretour:/soretour
    user: "1000:1000"
    command: sh -c "npm install && npm run dev"   # DEV
    # command: sh -c "npm install && npm run build && npm start"  # PROD
    restart: unless-stopped
    cpus: 0.75
    mem_limit: 1536m
    networks:
      - shared_network

networks:
  shared_network:
    external: true

Mode dev

L'application tourne en mode developpement (npm run dev). Pour passer en production, commenter la ligne command active et decommenter celle avec npm run build && npm start.

Ressources limitees

Le conteneur est bride a 0.75 vCPU et 1536 Mo de RAM pour eviter de saturer le VPS (4 vCores, 8 Go total).

Commandes utiles

# Voir les logs de l'app
docker logs node-dev-env

# Relancer l'app
docker restart node-dev-env

# Acceder au shell du conteneur
docker exec -it node-dev-env sh

# Lancer les tests
docker exec -it node-dev-env npx vitest

Points a documenter / clarifier

  • Detailler l'architecture de src/ (pages, composants, API routes)
  • Documenter les variables d'environnement Supabase necessaires
  • Documenter les comptes de test (test-accounts.md)
  • Preciser si le projet est en dev ou prod sur le VPS
  • Ajouter un .env.example si pas deja present

Voir aussi