devsite/CONFIGURATION_SITE.md

Configuration du Site Web - Documentation Complète

📋 Vue d'ensemble

Ce site utilise une architecture full-stack moderne avec :

• Frontend : Next.js avec TypeScript et Tailwind CSS
• Backend CMS : Strapi
• API IA : FastAPI avec intégration Ollama
• Démarrage automatique : Planificateur de tâches Windows

🏗️ Architecture

my-next-site/
├── app/                    # Application Next.js
├── cmsbackend/            # Backend Strapi
├── llm-api/               # API FastAPI pour IA
├── start-my-site.ps1      # Script de démarrage
└── package.json           # Dépendances frontend

🚀 Démarrage Rapide

Script Automatique (Recommandé)

cd J:\my-next-site
.\start-my-site.ps1

Ce script lance automatiquement les 3 services dans des fenêtres PowerShell séparées.

🔧 Commandes Manuelles

1. Frontend Next.js

cd J:\my-next-site
npm run dev

• URL : http://localhost:3000
• Mode : Développement avec Turbopack
• Rechargement : Automatique

2. Backend Strapi (CMS)

cd J:\my-next-site\cmsbackend
npm run develop

• Interface Admin : http://localhost:1337/admin
• API : http://localhost:1337/api
• Mode : Développement

3. API FastAPI (IA)

cd J:\my-next-site\llm-api
uvicorn api:app --host 0.0.0.0 --port 8000 --reload

• API : http://localhost:8000
• Endpoint IA : http://localhost:8000/ask?q=votre_question
• Documentation : http://localhost:8000/docs

📊 Ports Utilisés

Service	Port	URL
Next.js	3000	http://localhost:3000
Strapi	1337	http://localhost:1337
FastAPI	8000	http://localhost:8000
Ollama	11434	http://localhost:11434

🔄 Démarrage Automatique

Configuration Actuelle

• Méthode : Planificateur de tâches Windows
• Nom de la tâche : "Lancement site web dino"
• État : Ready (Prêt)

Gestion de la Tâche Planifiée

Voir les détails

Get-ScheduledTask -TaskName "Lancement site web dino" | Get-ScheduledTaskInfo

Démarrer manuellement

Start-ScheduledTask -TaskName "Lancement site web dino"

Arrêter la tâche

Stop-ScheduledTask -TaskName "Lancement site web dino"

Désactiver/Réactiver

# Désactiver
Disable-ScheduledTask -TaskName "Lancement site web dino"

# Réactiver
Enable-ScheduledTask -TaskName "Lancement site web dino"

Interface Graphique

Win + R → taskschd.msc

Cherchez "Lancement site web dino" dans la liste.

🛠️ Dépannage

Arrêter Tous les Processus

# Arrêter Node.js
taskkill /f /im node.exe

# Arrêter Python/FastAPI
taskkill /f /im python.exe

Nettoyer les Caches

# Cache Next.js
cd J:\my-next-site
Remove-Item .next -Recurse -Force -ErrorAction SilentlyContinue

# Cache Strapi
cd J:\my-next-site\cmsbackend
Remove-Item .cache -Recurse -Force -ErrorAction SilentlyContinue

Réinstaller les Dépendances

# Frontend
cd J:\my-next-site
npm install

# Backend Strapi
cd J:\my-next-site\cmsbackend
npm install

# API Python (si environnement virtuel)
cd J:\my-next-site\llm-api
pip install fastapi uvicorn[standard] requests

🐍 Configuration Python/FastAPI

Dépendances Requises

fastapi==0.115.8
uvicorn[standard]==0.38.0
requests==2.32.3

Problèmes Courants

• Erreur uvicorn : Vérifiez l'installation avec pip show uvicorn
• Port occupé : Changez le port dans le script ou tuez le processus
• Ollama non disponible : Vérifiez que Ollama fonctionne sur le port 11434

Installation Propre (Recommandée)

cd J:\my-next-site\llm-api
python -m venv venv
venv\Scripts\activate
pip install fastapi uvicorn[standard] requests

📝 Scripts Disponibles

Frontend (package.json)

{
  "dev": "next dev --turbopack",
  "build": "next build", 
  "start": "next start",
  "lint": "next lint"
}

Backend Strapi (cmsbackend/package.json)

{
  "develop": "strapi develop",
  "build": "strapi build",
  "start": "strapi start"
}

🔍 Vérifications de Santé

Vérifier que tous les services fonctionnent

# Next.js
curl http://localhost:3000

# Strapi
curl http://localhost:1337/admin

# FastAPI
curl http://localhost:8000/docs

# Ollama
curl http://localhost:11434/api/generate

Vérifier les processus actifs

# Processus Node.js
Get-Process node -ErrorAction SilentlyContinue

# Processus Python
Get-Process python -ErrorAction SilentlyContinue

🌐 Configuration Réseau

Accès Externe

Si vous voulez accéder au site depuis d'autres machines :

• Next.js : Modifier next.config.ts pour accepter les connexions externes
• Strapi : Configurer config/server.ts
• FastAPI : Déjà configuré avec --host 0.0.0.0

Pare-feu Windows

Assurez-vous que les ports sont ouverts :

# Ouvrir les ports dans le pare-feu
New-NetFirewallRule -DisplayName "Next.js" -Direction Inbound -Port 3000 -Protocol TCP -Action Allow
New-NetFirewallRule -DisplayName "Strapi" -Direction Inbound -Port 1337 -Protocol TCP -Action Allow
New-NetFirewallRule -DisplayName "FastAPI" -Direction Inbound -Port 8000 -Protocol TCP -Action Allow

📚 Ressources Utiles

• Next.js Documentation : https://nextjs.org/docs
• Strapi Documentation : https://docs.strapi.io
• FastAPI Documentation : https://fastapi.tiangolo.com
• Ollama Documentation : https://ollama.ai/docs

🔧 Maintenance

Mise à jour des dépendances

# Frontend
cd J:\my-next-site
npm update

# Backend
cd J:\my-next-site\cmsbackend
npm update

# Python packages
pip list --outdated
pip install --upgrade package_name

Sauvegarde

Pensez à sauvegarder régulièrement :

• Base de données Strapi (cmsbackend/database/)
• Configuration (cmsbackend/config/)
• Assets (app/assets/)

---

Dernière mise à jour : $(Get-Date -Format "dd/MM/yyyy HH:mm") Version Cursor : 2.0.77 OS : Windows Server 2025