Documentation Telaria

Table des matières organisée par type de contenu.

📂 Sources

• Docs actives : racine (source de vérité)
• Contenu historique : inputs/legacy/ (lecture seule, archive OneTLD)

🧑 Qui je suis

Vision et positionnement

• Philosophie du projet — "La documentation est le produit"
• Principes d'ingénierie — Standards techniques, sécurité by design
• Domaines d'expertise — 10 domaines (SysAdmin → Gouvernance)

Vitrine

• Portrait technique — Récit narratif, bilan de compétences, démonstration en acte
• Trajectoire — Double activité Telaria + Adoption IA

Compétences

• Les 10 compétences — Taxonomie des domaines d'expertise (source du tag skills)

🏗️ Ce que je construis

Spécifications IA

• Vitrine IA — cadre et architecture — Expression de besoin : MCP, chatbot RAG, veille (1 cœur + 3 surfaces)
• Vitrine IA — Lot 0 : cœur RAG — Spec du socle : ingestion, embeddings, index vectoriel, retrieval
• Vitrine IA — Lot 1 : serveur MCP — Spec consolidée du serveur MCP (tlr-mcp), V1 lecture seule
• Vitrine IA — Lot 2 : chatbot RAG — Assistant documentaire web (Q/R + citations)
• Vitrine IA — Lot 3 : veille agentique — Pipeline planifié (collecte → résumé → classification → proposition)
• Vitrine IA — Lot 3 : catalogue de sources — Top 10 flux V1 + réserve V2+
• Brief — microservice embeddings — Brief de lancement de l'instance Python (tlr-embeddings)
• Documentation web (/docs) — telaria-doc navigable depuis le site (treeview, rendu Markdown accessible)

Architecture applicative

• Architecture technique (codexia) — Infra, application, sécurité de l'app (vision d'ensemble dans tlr-blueprint)
• Authentification, compte et 2FA — Comptes, connexion, 2FA, token API
• Recherche interne (telaria-search) — Architecture du moteur de recherche
• CMS éditorial (telaria-cms) — Pages éditoriales et légales
• Backoffice (telaria-admin) — Administration du site

Design et UI

• Design system — Radix Colors, Bento layout, typographie
• UI (Interface utilisateur) — Palettes, composants, dashboard
• Branding — Identité visuelle
• Bootstrap — Configuration et personnalisation
• Panorama des options d'application — Enjeux et technologies
• PWA (Progressive Web App) — Installation, hors ligne, mise en cache
• PWA - Implémentation — Périmètre et phasage
• Apps natives (iOS/Android) — iOS/Android
• Cross-platform natif — React Native, Flutter, .NET MAUI
• Hybrid WebView — Ionic, Capacitor, Cordova
• Desktop wrapper — Electron, Tauri

Bundles et Composants

• Index des bundles — Vue d'ensemble
• tlr-mcp — Serveur MCP (PHP/Symfony)

🛠️ Comment je travaille

VPS — Infrastructure de production

Parcours chronologique de la mise en production, du provisionement au déploiement de l'IA.

• 01 — Provisionnement VPS
• 02 — Stack web (Apache, PHP, MySQL)
• 03 — Vhosts multisite
• 04 — TLS/HTTPS
• 05 — Sécurité système
• 06 — Performance
• 07 — Email et délivrabilité
• 08 — Déploiement application
• 09 — IA et embeddings
• 10 — MCP

Architecture et BDD

• Schéma BDD — Telaria — 23 tables MySQL (4 bundles) + SQLite RAG ; patterns Doctrine
• Architecture Symfony — Bundles, DI, multisite, CMS, auth

Guides — Infrastructure et déploiement

• Déploiement — Installation VPS Ubuntu, Apache, MySQL
• Installation locale (WSL2) — Stack RAG en dev : PHP 8.5 + sqlite-vec, microservice docker-compose, amorçage de l'index
• Stack de production — Vue d'ensemble de la stack en prod
• Email — DKIM et délivrabilité — Signature DKIM, relais OVH, SPF/DMARC
• SSL/TLS — Certificats Let's Encrypt, configuration
• HSTS — HTTP Strict Transport Security
• Headers de sécurité (Apache) — Sécurisation des en-têtes HTTP
• Confidentialité et RGPD — Posture confidentialité / RGPD du projet
• Performances HTTP (Brotli, Cache, Mesures) — Compression, cache, mesures curl
• DNS OVH (sous-domaines) — Configuration DNS wildcard
• Déployer un nouveau domaine — Runbook NDD complet : DNS, TLS, page d'attente, e-mail délivrable (OpenDKIM + relais OVH)
• Fiche mémo — nouveau domaine — Aide-mémoire express (commandes + DNS + checklist)
• Runbook d'exploitation — Mise à jour, supervision, sauvegardes, incidents
• Surveillance des connexions VPS — Monitoring réseau (ss, états, ports), Fail2ban

Guides — Développement et workflow

• Patterns PHP/Symfony — Plugin DI, Messenger, EventSubscriber, Security, Twig extensions, Rate Limiter
• Stack Frontend — AssetMapper, Turbo Frames, Stimulus, Bootstrap 5.3, organisation CSS/templates
• Pattern dashboard modulaire — Dashboard configurable par ConfigSectionInterface
• Hooks Git — Automatisation, pré-commit, pre-push, configuration
• Stratégie de tests — Intégration plutôt que mocké, outillage avant push
• Conventions Git — Conventional Commits, signature, normalisation
• IA (Intelligence Artificielle) — Concepts, technologies, PhpStorm
• Tuning environnement agent LLM — Méthode universelle + cas d'étude (Claude Code chez Mathieu)
• Gouvernance MCP multi-instances — Tokens et scopes par rôle d'instance Claude (Atlas, Lead Tech, Chef…)
• GitHub — Stratégie de branche (solo + IA), protection en mode équipe
• Releases (GitFlow) — Workflow de release, versioning
• Composer (bundles) — Installation et gestion des bundles

🌐 Spécifications Officielles (RFC)

⚠️ Rédaction des fiches RFC en stand-by (priorité donnée à l'initiative IA) — seule RFC 9110 est disponible pour l'instant.

• Index des RFC — Présentation et liste des RFC
• RFC 9110 (HTTP Semantics) — Standard HTTP actuel

🏗️ Spécifications Techniques (normes web)

• Spécifications web (standards) — Cartographie des normes : HTTP/TLS, HTML/DOM/Fetch (WHATWG), CSS, ECMAScript, PHP/PSR, SQL/MySQL, Symfony

♿ Accessibilité (RGAA 4.1 niveau AA)

• Politique d'accessibilité — Vue d'ensemble et engagement
• EPUB et documentation accessible — Format EPUB, génération Pandoc
• Interface utilisateur — Composants, ARIA, navigation clavier
• Contenus éditoriaux — Rédaction, médias, tableaux
• API et intégrations — Documentation API, OpenAPI, webhooks

🎓 Tutoriels Pédagogiques

• Index des tutoriels — Vue d'ensemble

Accessibilité

• EPUB Accessible — Structure et normes W3C/Daisy
• Treeview accessible — Navigation arborescente ARIA
• Markdown accessible en Symfony — Pipeline CDX-MD, rendu accessible, RGAA

IA

• Index des tutos IA — parcours guidé — Du cœur RAG au serveur MCP jusqu'aux applications
• Microservice d'embeddings (Python/FastAPI) — Service d'inférence consommé par Symfony
• Serveur MCP sur VPS — Installation d'un serveur MCP
• Serveur MCP minimal en Symfony — Exposer un outil via MCP (stdio, JSON-RPC)
• Brancher MCP sur Claude Desktop / Cursor — Connexion côté client
• Brancher MCP sur Claude Code (CLI) — .mcp.json par repo, token scopé par instance
• Index vectoriel sqlite-vec — Stockage et recherche de vecteurs embarqués
• RAG de bout en bout — Assembler ingestion → retrieval → génération
• Prompt caching (Claude) — Réduire le coût des appels LLM
• Accessibilité d'une interface de chat — RGAA AA pour le chatbot
• Veille automatisée (Scheduler + Messenger) — Pipeline de veille planifié
• Token API haché (SHA-512) en Symfony — Auth opaque, hash SHA-512, protection BREACH

Sécurité

• Token API haché (SHA-512) en Symfony — (aussi listé sous IA)
• 2FA en Symfony (scheb/2fa-bundle) — E-mail + trusted device, flux Symfony Security

Markdown

• Tutos Markdown — Parcours en 8 chapitres
  • Bases et structure
  • Emphase et typographie
  • Listes et tâches
  • Liens et images
  • Code et citations
  • Tableaux GFM
  • Échappements et HTML
  • Structurer un document
• Spécification Markdown Telaria — Profil CDX-MD 1 (CommonMark + GFM, directives internes)

SVG

• Tutos SVG — Parcours en 13 chapitres (avec aperçus)
  • Bases et structure
  • Coordonnées, viewBox, unités
  • Formes de base
  • Style et peinture
  • Paths
  • Groupes, defs, use
  • Transformations
  • Texte
  • Gradients et patterns
  • Clipping et masking
  • Filtres
  • Animation
  • Accessibilité SVG

🤖 Outils IA

Les 59 fiches pédagogiques (base de connaissance IA — modules 1-10, annexes A1-A5) ont été migrées vers le dépôt adoption-corpus (corpus RAG pour adoption-app).

🔧 Outils et Automatisation

• tlr-cli — CLI Bash pour automatisation Telaria
  • CLI — Interface en ligne de commande
  • Installation — Installation et configuration
  • Modules — Architecture modulaire
  • Tests — Tests automatisés
  • Vhosts — Gestion des virtual hosts Apache

📋 Pilotage et Gestion de Projet

Méthodologie

• Optimisation RAG de la doc — Règles d'écriture doc-side + contrat d'ingestion côté cœur RAG
• Scrum (Méthodologie) — Organisation Scrum solo

Planification

• Roadmap — Décisions et axes de travail
• Wishlist — Idées futures

Veille Technique

• Index veille technique — Sujets de recherche
  • IA et intégration (RAG, modèles locaux)
  • RGPD et protection des données
  • Validation d'adresses postales
  • Organisation des contenus

📝 Templates Réutilisables

• README snippet — Template README minimal

📖 Référence

• Glossaire des acronymes — 50+ termes (RGAA, WCAG, ARIA, etc.)
• Qualité — Règles de qualité documentaire

🗺️ Navigation par domaine d'expertise

Les 10 domaines ci-dessous sont la taxonomie de référence : voir 01-qui-je-suis/competences.md (source du tag skills des cartouches).

SysAdmin

03-comment-je-travaille/vps/ (10 étapes), guides/deployment.md, guides/install-locale.md, guides/ssl-tls.md, guides/dsn-ovh.md, guides/nouveau-domaine.md, guides/runbook.md, tools/bash/

SecOps

guides/ssl-tls.md, guides/hsts.md, guides/security-headers.md, guides/deployment.md, guides/nouveau-domaine.md, tutos/securite-token-api-symfony.md, tutos/2fa-symfony-scheb.md

DevOps

guides/github.md, guides/releases.md, guides/composer.md, guides/git-hooks.md, guides/git-conventions.md, tools/bash/

Backend

02-ce-que-je-construis/specs/architecture.md, 03-comment-je-travaille/bdd/schema.md, guides/architecture-symfony.md, guides/patterns-symfony.md, guides/composer.md, 02-ce-que-je-construis/bundles/

Frontend

guides/frontend-stack.md, 02-ce-que-je-construis/specs/design.md, 02-ce-que-je-construis/specs/ui.md, 02-ce-que-je-construis/specs/branding.md, 02-ce-que-je-construis/specs/bootstrap.md, tutos/svg/

Accessibility

03-comment-je-travaille/accessibility/, 02-ce-que-je-construis/specs/design.md, tutos/treeview-accessible.md, tutos/markdown-accessible-symfony.md

Quality

guides/tests.md, quality.md, 01-qui-je-suis/vision/ingenierie.md, guides/hsts.md, tutos/markdown/

Privacy

guides/privacy.md, pilotage/veille/ (RGPD)

AI

02-ce-que-je-construis/specs/ia-vitrine.md, guides/ia.md, 02-ce-que-je-construis/bundles/tlr-mcp.md, tutos/ia/, pilotage/rag-optimisation.md

Gouvernance

01-qui-je-suis/vision/, pilotage/, guides/releases.md