spb/hilmacorp

1# CLAUDE.md — Plateforme Web Hilmacorp.ai23## Objectif du projet45Construire 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.67---89## ⚠️ RÈGLE OBLIGATOIRE — En-tête de chaque fichier1011**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 :1213```14/**15 * Author: Simon-Pierre Boucher16 * Contact: contact@spboucher.ai17 * Project: Hilmacorp.ai — Web Platform18 * File: <chemin/nom-du-fichier>19 * Description: <courte description du rôle du fichier>20 */21```2223Exemples selon le type de fichier :2425- **JS / TS / TSX / CSS** : bloc `/** ... */`26- **HTML** : `<!-- Author: Simon-Pierre Boucher | Contact: contact@spboucher.ai | ... -->`27- **Python / Shell / YAML** : lignes commençant par `#`28- **Markdown** : bloc de commentaire HTML `<!-- ... -->` en tête de fichier29- **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`).3031**Ne jamais créer ou modifier un fichier sans vérifier la présence de cet en-tête.**3233---3435## Stack technique recommandé3637- **Framework** : Next.js 14+ (App Router) avec TypeScript38- **Styles** : Tailwind CSS39- **Composants** : composants React réutilisables, design system léger40- **i18n** : support français / anglais (next-intl ou équivalent)41- **Déploiement cible** : Vercel ou infrastructure privée (le code doit rester portable)42- **SEO** : métadonnées complètes, Open Graph, sitemap, robots.txt43- **Formulaire de contact** : API route avec validation, envoi vers `contact@spboucher.ai`4445---4647## Structure du site (pages)48491. **Accueil (`/`)**50   - Hero : « Hilmacorp.ai builds intelligent systems for organizations that want to work, analyze, decide, and innovate differently. »51   - Présentation courte de l'entreprise52   - Aperçu des services principaux avec liens53   - Appel à l'action (contact / démonstration)54552. **À propos (`/about`)**56   - Mission : rendre l'IA avancée utile, accessible et opérationnelle pour les organisations de toutes tailles57   - 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)58   - Vision de l'entreprise59603. **Fondateurs (`/founders`)**61   - **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.62   - **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.63644. **Services (`/services`)** — une page index + sous-pages ou sections pour :65   - Agents IA et automatisation intelligente66   - Grands modèles de langage (approche indépendante des fournisseurs, routage multi-modèles)67   - IA privée et locale (déploiements open-weight, Apple Silicon, GPU, architectures hybrides)68   - RAG — Retrieval-Augmented Generation (citations, contrôles d'accès, journaux d'audit)69   - Analyse de données et recherche (finance, immobilier, veille concurrentielle, prévision…)70   - IA multimodale (texte, images, PDF, tableaux, audio, vidéo, données structurées)71   - Stratégie et consultation IA (évaluations d'opportunités, feuilles de route, POC, formation)72   - Développement logiciel sur mesure (plateformes, APIs, tableaux de bord, intégrations)73745. **Sécurité et déploiement responsable (`/security`)**75   - 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.76776. **Industries (`/industries`)**78   - Services financiers, immobilier, éducation, recherche académique, services professionnels, administration publique, technologie, consultation, assurance, juridique et conformité, médias, commerce de détail.79807. **Contact (`/contact`)**81   - Formulaire (nom, organisation, courriel, message)82   - Courriel de contact affiché : **contact@spboucher.ai**8384---8586## Directives de design8788- Esthétique sobre, technologique et crédible : fond sombre ou clair épuré, typographie soignée, beaucoup d'espace blanc.89- Éviter les templates génériques; le design doit paraître intentionnel et distinctif.90- Palette suggérée : tons neutres profonds + un accent (bleu profond ou vert technologique).91- Responsive obligatoire (mobile-first).92- Accessibilité : contrastes AA minimum, navigation clavier, balises sémantiques.93- Performance : images optimisées, chargement paresseux, score Lighthouse ≥ 90.9495---9697## Contenu9899- 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.100- Ton : professionnel, clair, orienté résultats. Pas de jargon marketing vide.101102---103104## Conventions de développement105106- TypeScript strict activé.107- Composants dans `components/`, pages dans `app/`, contenus i18n dans `messages/` ou `locales/`.108- Un composant = un fichier. Nommage PascalCase pour les composants.109- Commits atomiques avec messages clairs.110- Tests de base pour les API routes (formulaire de contact).111- Aucune clé API ou secret dans le code — utiliser les variables d'environnement (`.env.example` fourni).112113---114115## Checklist avant livraison116117- [ ] En-tête **Simon-Pierre Boucher / contact@spboucher.ai** présent dans chaque fichier118- [ ] Site bilingue FR/EN fonctionnel119- [ ] Toutes les pages listées ci-dessus créées120- [ ] Formulaire de contact fonctionnel avec validation121- [ ] SEO et métadonnées configurés122- [ ] Responsive vérifié (mobile, tablette, desktop)123- [ ] Lighthouse ≥ 90 (performance, accessibilité, SEO)124- [ ] `README.md` avec instructions d'installation et de déploiement125