# 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 : ``` /** * Author: Simon-Pierre Boucher * Contact: contact@spboucher.ai * Project: Hilmacorp.ai — Web Platform * File: * Description: */ ``` 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 "` 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) 1. **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) 2. **À 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 3. **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. 4. **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) 5. **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. 6. **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. 7. **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