devsite/obsidian-site-docs/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 (+ instrumentation Langfuse)
│   ├── .env               # Secrets Python (Langfuse, etc.) — non committé
│   └── observability.py   # Init client Langfuse (no-op safe)
├── start-my-site.ps1      # Script de démarrage
├── stop-my-site.ps1       # Script d'arrêt propre
└── package.json           # Dépendances frontend

Observabilité : le chatbot GrasBot est tracé dans une instance Langfuse self-hosted (langfuse.fernandgrascalvet.com). Chaque question déclenche une trace ask avec spans retrieval / prompt_build / ollama-chat, plus des scores auto (grounded, retrieval_relevance) et des tags. Voir docs-site-interne/langfuse-observability.md pour le détail.

Contenu : compétences, réalisations IA et ordre d’affichage

• Ordre de la liste /competences : champ order sur le content-type compétence. Selon la version de Strapi, l’API renvoie attributes.order (v4) ou order (v5) — le front unifie cela (voir getOrder() dans app/competences/page.jsx).
• Fiche /competences/[slug] : affiche des vignettes (projets de type realisation-ia liés à la compétence) dès qu’il en existe ; sinon, rendu de la fiche richtext « classique ».
• Détail d’une réalisation : route /competences/[slug]/[realisation] (même gabarit de contenu qu’une fiche portfolio).
• Documentation détaillée (tableau des routes, champs Strapi, lien avec GrasBot) : docs-site-interne/02-frontend-next.md et, côté API chatbot, docs-site-interne/04-api-llm-et-chatbot.md (section Parcours public).

🚀 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.

Améliorations :

• Configuration centralisée via un tableau $services (plus de duplication entre les 3 blocs).
• Détection du port déjà occupé : si un service tourne déjà, il n'est pas relancé (évite EADDRINUSE).
• Portabilité : chemins résolus via $PSScriptRoot, pas de J:\my-next-site codé en dur.
• -NoExit sur chaque fenêtre : le message d'erreur reste visible si un service crashe au démarrage.
• Bilan final : nombre de services lancés / déjà actifs / échecs.

Arrêt des services

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

Termine les processus qui écoutent les ports 1337 (Strapi), 3000 (Next.js) et 8000 (FastAPI). Ne touche pas aux autres processus Node de ta machine. Les fenêtres PowerShell lancées par start-my-site.ps1 restent ouvertes (à fermer manuellement). En cas d'échec sur certains PIDs → relancer dans un PowerShell admin.

Note encodage : les deux scripts PowerShell sont encodés en UTF-8 avec BOM. C'est nécessaire pour que Windows PowerShell 5.1 (version par défaut) les lise correctement avec les emojis et accents. PowerShell 7 n'a pas ce souci mais reste compatible avec le BOM.

🔧 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
• Santé : http://localhost:8000/health — renvoie status, ollama_url, llm_model, métadonnées vault, et observability.langfuse_enabled.
• Recharger le vault à chaud : POST http://localhost:8000/reload-vault — à appeler après création/modification d'une note dans vault-grasbot/ (sinon load_vault() reste en cache mémoïsé jusqu'au prochain redémarrage d'uvicorn).

Tuning du pipeline LLM : les paramètres Ollama (num_ctx, num_predict, think), la troncature des sources RAG secondaires (SEARCH_SECONDARY_MAX_CHARS, SEARCH_SECONDARY_KEEP_RATIO), le system prompt anti-hallucination et la note bio-fernand sont documentés en détail dans docs-site-interne/langfuse-observability.md (section Tuning du pipeline — 2026-04-23).

📊 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 : 2026-04-24 Version Cursor : 2.0.77 OS : Windows Server 2025