Documentation publique

Ce que Bz Info démontre comme système.

Une lecture éditorialisée de l’architecture du portfolio : frontend multilingue, backend NestJS, chat temps réel, analytics first-party, admin et qualité.

Crédibilité par le produit

Le site lui-même sert de preuve : contenu localisé, API, back-office, temps réel, SEO et documentation cohérente.

Respect du visiteur

Les interactions restent utiles, mesurées et privacy-first, sans tracking agressif ni interface intrusive.

Maintenabilité

Les contenus, routes, composants et contrats sont séparés pour permettre l’évolution sans bricolage.

Carte de lecture

Les sections suivent le trajet réel du système public vers l’exploitation.

01

Frontend

Les pages restent des orchestrateurs. Les textes publics vivent dans des modules localisés, les slugs sont centralisés et le sitemap expose les alternates.

02

Backend

Le backend gère contact, disponibilité, chat, chatbot, leads, notifications, audit logs et analytics first-party.

03

Admin

L’admin permet de suivre les demandes, leads, conversations, disponibilité, monitoring, logs et statistiques utiles.

04

Qualité

La qualité cible les risques : typecheck, lint, build, tests backend par module, smoke flows et documentation d’environnement.

Une documentation utile relie site, API, admin, qualité et décisions.

La documentation sert de passerelle entre ce que le site public annonce, ce que l’API garantit, ce que l’admin opère et ce que les rapports qualité permettent de décider.

Frontend

Next.js, contenu typé et SEO multilingue

Les pages restent des orchestrateurs. Les textes publics vivent dans des modules localisés, les slugs sont centralisés et le sitemap expose les alternates.

Routes fr/en/ar/es/de/nl avec correspondance logique stable.

RTL arabe au niveau document et styles logiques quand nécessaire.

Metadata, canonical, hreflang et Open Graph générés par page.

Backend

API NestJS orientée conversion et opérations

Le backend gère contact, disponibilité, chat, chatbot, leads, notifications, audit logs et analytics first-party.

DTOs validés et documentation Swagger.

WebSocket Socket.IO pour visiteurs et admin.

Aucune clé IA ou donnée sensible exposée côté frontend.

Admin

Back-office produit pour superviser le système

L’admin permet de suivre les demandes, leads, conversations, disponibilité, monitoring, logs et statistiques utiles.

Authentification admin dédiée.

Realtime pour conversations support.

Analytics orientées décision plutôt que vanity metrics.

Qualité

Validation pragmatique et production-aware

La qualité cible les risques : typecheck, lint, build, tests backend par module, smoke flows et documentation d’environnement.

Scripts de validation réels du monorepo.

Respect des contrats API existants.

Documentation interne séparée de la documentation publique.

Architecture vivante

Cette documentation publique montre le niveau d’exigence sans exposer de secrets.

Pour un audit, une mission backend ou une plateforme produit complète, la page contact permet de partager le contexte.