Déploiement Cloudflare Pages

Le site de documentation est déployé sur Cloudflare Pages via l'intégration Git.

Configuration Cloudflare Pages

Paramètre	Valeur
Répertoire source	website
Commande de build	npm run build
Répertoire de sortie	build
Branche de production	main
URL	https://docs-logidav.pages.dev

Développement local

cd website

# Installer les dépendances
npm ci

# Lancer le serveur de développement (hot reload)
npm start

# Build de production
npm run build

# Prévisualiser le build
npm run serve

Processus de déploiement

1. Push sur main → déploiement automatique en production
2. Push sur une branche feature → déploiement de preview avec URL temporaire
3. Rollback → via le dashboard Cloudflare Pages, revenir à un déploiement précédent

Déploiement manuel (fallback)

cd website
npm run build
# Le contenu de website/build/ peut être servi par n'importe quel hébergeur statique

Fichiers de configuration

Fichier	Rôle
website/static/_headers	Politique de cache Cloudflare
website/static/_redirects	Redirections d'URLs legacy MkDocs
website/docusaurus.config.ts	Configuration du site
website/sidebars.ts	Structure de la navigation latérale

Migration depuis MkDocs

L'ancien site MkDocs utilisait Python/Material theme. Le nouveau site Docusaurus utilise Node/React. Les changements :

Aspect	Ancien (MkDocs)	Nouveau (Docusaurus)
Langage	Python	Node.js
Build	mkdocs build	npm run build
Config	mkdocs.yml	docusaurus.config.ts
Thème	Material	Docusaurus Classic
Recherche	Built-in	@easyops-cn/docusaurus-search-local
Diagrammes	pymdownx.superfences	@docusaurus/theme-mermaid

URLs legacy

Les redirections suivantes sont configurées dans static/_redirects pour préserver les URLs MkDocs :

Ancienne URL	Nouvelle URL
/operations/sales-import-workflow/	/docs/workflows/sales-import
/cronjobs/	/docs/reference/cronjobs/
/integrations/	/docs/integrations/
/development/	/docs/getting-started/