config.env.example

# ====================================
# CONFIGURATION DU WORKSPACE
# ====================================

# Nom du workspace principal
# Utilisé pour identifier le projet dans les logs et les configurations
WORKSPACE_NAME="mon-projet"

# Groupe de projets
# Utilisé pour organiser les projets par domaine
PROJECT_GROUP="main"  # Groupe principal pour tous les projets
SHARED_GROUP="shared"  # Groupe pour les composants partagés

# ====================================
# ENVIRONNEMENTS DE DÉVELOPPEMENT
# ====================================

# Frontend : Next.js
# Framework : Utilisé pour la documentation et les références
# SDK : Utilisé pour les commandes npm et les imports
ENV_FRONT_FRAMEWORK="Next.js"
ENV_FRONT_SDK="next"

# Backend : Python
# Utilisé pour les services backend et les scripts
ENV_BACK="python"

# ====================================
# CHEMINS DU WORKSPACE
# ====================================

# Chemin racine du workspace
# Point d'entrée pour tous les chemins relatifs
WORKSPACE_ROOT="/chemin/vers/workspace"

# ====================================
# STRUCTURE DU PROJET
# ====================================

# Noms des composants du projet
# Utilisés pour construire les chemins et identifier les services
PROJECT_NAME_1="frontend-app"  # Frontend Next.js
PROJECT_NAME_2="backend-service"   # Backend Python
PROJECT_NAME_3="core-service"      # Core service
PROJECT_NAME_4="documentation"      # Documentation

# Descriptions des composants
# Utilisées pour la documentation et l'interface utilisateur
PROJECT_1_DESCRIPTION="Frontend application (Next.js)"
PROJECT_2_DESCRIPTION="Backend API service (Python/FastAPI)"
PROJECT_3_DESCRIPTION="Core business logic and shared utilities"
PROJECT_4_DESCRIPTION="Project documentation and guides"

# Groupes de projets
# Utilisés pour organiser les composants par domaine fonctionnel
# - "${PROJECT_GROUP}" : tous les composants du projet principal
# - "${SHARED_GROUP}" : composants partagés entre projets
PROJECT_1_GROUP="${PROJECT_GROUP}"      # frontend
PROJECT_2_GROUP="${PROJECT_GROUP}"      # backend
PROJECT_3_GROUP="${PROJECT_GROUP}"      # core
PROJECT_4_GROUP="${PROJECT_GROUP}"      # docs

# Dépendances entre projets
PROJECT_1_DEPENDS_ON="backend-service,core-service"
PROJECT_2_DEPENDS_ON="core-service"
PROJECT_3_DEPENDS_ON=""
PROJECT_4_DEPENDS_ON=""

# Ports des services
PROJECT_1_PORT="3000"
PROJECT_2_PORT="8000"

# Configuration cursor-template
CURSOR_TEMPLATE_NAME="cursor-template"
CURSOR_TEMPLATE_DESCRIPTION="Cursor Templates and Configuration"
CURSOR_TEMPLATE_GROUP="${SHARED_GROUP}"  # Composant partagé

# Chemins absolus vers les composants
# Utilisés pour les commandes et les vérifications de fichiers
PROJECT_1_PATH="${WORKSPACE_ROOT}/${PROJECT_NAME_1}"  # Frontend
PROJECT_2_PATH="${WORKSPACE_ROOT}/${PROJECT_NAME_2}"  # Backend
PROJECT_3_PATH="${WORKSPACE_ROOT}/${PROJECT_NAME_3}"  # Core
PROJECT_4_PATH="${WORKSPACE_ROOT}/${PROJECT_NAME_4}"  # Documentation

# ====================================
# FICHIERS DE CONFIGURATION
# ====================================

# Chemins des fichiers de configuration Cursor
# Utilisés pour l'initialisation et la configuration du projet
CURSOR_TEMPLATE_PATH="${WORKSPACE_ROOT}/cursor-template"  # Templates et configurations
CURSOR_CONFIG_PATH="${CURSOR_TEMPLATE_PATH}/config.env"   # Variables d'environnement
CURSOR_WORKSPACE_PATH="${CURSOR_TEMPLATE_PATH}/workspace.json"  # Structure du workspace
CURSOR_RULES_FILE="${CURSOR_TEMPLATE_PATH}/.cursorrules"  # Règles de développement
CURSOR_CONFIG_FILE="${CURSOR_TEMPLATE_PATH}/cursorconfig.json"  # Configuration technique

# ====================================
# TYPES DE COMPOSANTS
# ====================================

# Définition des types de composants
# Utilisés pour la validation et la documentation
COMPONENT_TYPE_FRONTEND="frontend"    # Applications Next.js
COMPONENT_TYPE_BACKEND="backend"      # Services Python/FastAPI
COMPONENT_TYPE_CORE="core"           # Services principaux
COMPONENT_TYPE_DOC="doc"             # Documentation du projet
COMPONENT_TYPE_CONFIG="config"       # Fichiers de configuration

# ====================================
# VERSIONS DES OUTILS
# ====================================

## Frontend
NEXT_VERSION="14.0.0"              # Framework Next.js
REACT_EMAIL_VERSION="0.7.0"        # Templates d'emails
RESEND_VERSION="2.0.0"            # Service d'envoi d'emails
ZUSTAND_VERSION="4.5.0"           # Gestion d'état
CLERK_VERSION="4.12.1"            # Authentification
TAILWIND_VERSION="3.4.0"          # Styles CSS
SHADCN_VERSION="0.8.0"            # Composants UI
VITEST_VERSION="2.1.0"            # Tests unitaires
PLAYWRIGHT_VERSION="1.40.0"       # Tests E2E
ESLINT_VERSION="8.56.0"           # Linting JavaScript/TypeScript

## Backend
PYTHON_VERSION="3.12.1"           # Runtime Python
LANGCHAIN_VERSION="0.0.100"       # Framework RAG
QDRANT_VERSION="1.5.0"            # Base vectorielle
QDRANT_JS_VERSION="1.4.0"         # Client JavaScript Qdrant
SUPABASE_VERSION="2.26.0"         # Base de données
DRIZZLE_VERSION="1.1.0"           # ORM
REDIS_VERSION="4.6.0"             # Cache et files d'attente
PYTEST_VERSION="7.4.0"            # Tests Python
BLACK_VERSION="23.9.0"            # Formatage Python

## DevOps
DOCKER_VERSION="24.0.0"           # Conteneurisation
DOCKER_COMPOSE_VERSION="2.22.0"   # Orchestration

## Package Managers
NODE_VERSION="20.10.0"             # Runtime Node.js
PNPM_VERSION="8.0.0"              # Gestionnaire de paquets Node.js

# ====================================
# SCRIPTS ET WORKFLOWS
# ====================================

# Scripts d'initialisation et de vérification
INIT_SCRIPT="${CURSOR_TEMPLATE_PATH}/utils/init_conversation.sh"
CHECK_INIT_SCRIPT="${CURSOR_TEMPLATE_PATH}/utils/check_init.sh"
CHECK_WORKSPACE_SCRIPT="${CURSOR_TEMPLATE_PATH}/utils/check_workspace_path.sh"
CHECK_SCRIPT="${CHECK_INIT_SCRIPT}"  # Alias pour la compatibilité

# Fichiers d'analyse et de vérification
WORKSPACE_ANALYSIS_FILE="${CURSOR_TEMPLATE_PATH}/utils/workspace_analysis"
WORKSPACE_ANALYSIS_PREVIOUS="${CURSOR_TEMPLATE_PATH}/utils/workspace_analysis.previous"
LAST_DATE_CHECK_FILE="${CURSOR_TEMPLATE_PATH}/utils/last_date_check"

# Configuration système
MIN_MEMORY_GB="8"  # Mémoire RAM minimale en GB
MIN_DISK_SPACE="10G"  # Espace disque minimal
MIN_CPU_CORES="2"  # Nombre minimal de cœurs CPU

# Documentation des outils
NEXT_DOC="Next.js"
LANGCHAIN_DOC="LangChain"

# Workflows CI/CD
WORKFLOW_NEXT="${CURSOR_TEMPLATE_PATH}/workflows/next.yml"     # Pipeline Frontend
WORKFLOW_PYTHON="${CURSOR_TEMPLATE_PATH}/workflows/python.yml"  # Pipeline Backend