# CLAUDE.md — Plateforme Web Hilmacorp.ai

# Objectif du projet

Construire le site web officiel de Hilmacorp.ai, une entreprise d'intelligence artificielle fondée par Simon-Pierre Boucher et Massamba Mbaye. Le site doit être moderne, professionnel, rapide et bilingue (français / anglais), et présenter l'entreprise, ses services, ses fondateurs et sa vision.

# ⚠️ RÈGLE OBLIGATOIRE — En-tête de chaque fichier

Chaque fichier créé dans ce projet (code, config, style, composant, script, etc.) DOIT commencer par l'en-tête suivant, adapté à la syntaxe de commentaire du langage :

text

/**
 * Author: Simon-Pierre Boucher
 * Contact: contact@spboucher.ai
 * Project: Hilmacorp.ai — Web Platform
 * File: <chemin/nom-du-fichier>
 * Description: <courte description du rôle du fichier>
 */

Exemples selon le type de fichier :

JS / TS / TSX / CSS : bloc /** ... */
HTML : 
Python / Shell / YAML : lignes commençant par #
Markdown : bloc de commentaire HTML  en tête de fichier
JSON : exception — pas de commentaire possible; ajouter si pertinent un champ "_author": "Simon-Pierre Boucher <contact@spboucher.ai>" quand le schéma le permet (ex. package.json → champ author).

Ne jamais créer ou modifier un fichier sans vérifier la présence de cet en-tête.

# Stack technique recommandé

Framework : Next.js 14+ (App Router) avec TypeScript
Styles : Tailwind CSS
Composants : composants React réutilisables, design system léger
i18n : support français / anglais (next-intl ou équivalent)
Déploiement cible : Vercel ou infrastructure privée (le code doit rester portable)
SEO : métadonnées complètes, Open Graph, sitemap, robots.txt
Formulaire de contact : API route avec validation, envoi vers contact@spboucher.ai

# Structure du site (pages)

Accueil (/)
- Hero : « Hilmacorp.ai builds intelligent systems for organizations that want to work, analyze, decide, and innovate differently. »
- Présentation courte de l'entreprise
- Aperçu des services principaux avec liens
- Appel à l'action (contact / démonstration)
À propos (/about)
- Mission : rendre l'IA avancée utile, accessible et opérationnelle pour les organisations de toutes tailles
- Approche (processus itératif en 8 étapes : identifier le problème → évaluer données/infrastructure → concevoir l'architecture → prototype → tests → mesure de la valeur → déploiement contrôlé → amélioration continue)
- Vision de l'entreprise
Fondateurs (/founders)
- Simon-Pierre Boucher : recherche en IA, grands modèles de langage (LLM), agents IA, analyse de données, modélisation financière, développement logiciel, systèmes IA avancés, modèles open-weight, infrastructure locale, systèmes multimodaux, workflows agentiques.
- Massamba Mbaye : leadership, développement stratégique, opérations d'affaires, partenariats, déploiement commercial de technologies innovantes, lien entre capacités techniques et besoins organisationnels.
Services (/services) — une page index + sous-pages ou sections pour :
- Agents IA et automatisation intelligente
- Grands modèles de langage (approche indépendante des fournisseurs, routage multi-modèles)
- IA privée et locale (déploiements open-weight, Apple Silicon, GPU, architectures hybrides)
- RAG — Retrieval-Augmented Generation (citations, contrôles d'accès, journaux d'audit)
- Analyse de données et recherche (finance, immobilier, veille concurrentielle, prévision…)
- IA multimodale (texte, images, PDF, tableaux, audio, vidéo, données structurées)
- Stratégie et consultation IA (évaluations d'opportunités, feuilles de route, POC, formation)
- Développement logiciel sur mesure (plateformes, APIs, tableaux de bord, intégrations)
Sécurité et déploiement responsable (/security)
- Contrôles d'accès par rôles, authentification sécurisée, chiffrement, hébergement privé de modèles, workflows d'approbation humaine, monitoring, journalisation, validation des sorties.
Industries (/industries)
- Services financiers, immobilier, éducation, recherche académique, services professionnels, administration publique, technologie, consultation, assurance, juridique et conformité, médias, commerce de détail.
Contact (/contact)
- Formulaire (nom, organisation, courriel, message)
- Courriel de contact affiché : contact@spboucher.ai

# Directives de design

Esthétique sobre, technologique et crédible : fond sombre ou clair épuré, typographie soignée, beaucoup d'espace blanc.
Éviter les templates génériques; le design doit paraître intentionnel et distinctif.
Palette suggérée : tons neutres profonds + un accent (bleu profond ou vert technologique).
Responsive obligatoire (mobile-first).
Accessibilité : contrastes AA minimum, navigation clavier, balises sémantiques.
Performance : images optimisées, chargement paresseux, score Lighthouse ≥ 90.

# Contenu

Tout le contenu textuel provient du document de présentation Hilmacorp.ai (mission, services, approche, vision). Reprendre ce contenu fidèlement, en versions française et anglaise.
Ton : professionnel, clair, orienté résultats. Pas de jargon marketing vide.

# Conventions de développement

TypeScript strict activé.
Composants dans components/, pages dans app/, contenus i18n dans messages/ ou locales/.
Un composant = un fichier. Nommage PascalCase pour les composants.
Commits atomiques avec messages clairs.
Tests de base pour les API routes (formulaire de contact).
Aucune clé API ou secret dans le code — utiliser les variables d'environnement (.env.example fourni).

# Checklist avant livraison

En-tête Simon-Pierre Boucher / contact@spboucher.ai présent dans chaque fichier
Site bilingue FR/EN fonctionnel
Toutes les pages listées ci-dessus créées
Formulaire de contact fonctionnel avec validation
SEO et métadonnées configurés
Responsive vérifié (mobile, tablette, desktop)
Lighthouse ≥ 90 (performance, accessibilité, SEO)
README.md avec instructions d'installation et de déploiement