# Project Talos

> Talos fournit des composants électroniques, microcontrôleurs, capteurs, drivers moteurs et composants pour bus industriels.

Deux modes d’approvisionnement sont proposés :
1. **Stock Flash à Montpellier** : Articles en stock en France, livrés à domicile par Colissimo.
2. **Achat groupé usine** : Précommandes regroupées auprès des fabricants et expédiées en fret cargo. Le délai dépend de la clôture du lot.

## Documentation & Spécifications

- [Accueil & Catalogue](https://talos.tposcorp.com): Page principale et navigation générale.
- [Catalogue complet (llms-full.txt)](https://talos.tposcorp.com/llms-full.txt): Composants, spécifications et prix.
- [Achat Groupé Cargo](https://talos.tposcorp.com/achat-groupe): Suivi en temps réel des lots cargo, dates de clôture et jauges de remplissage.
- [Packs de prototypage](https://talos.tposcorp.com/packs): Ensembles de composants pour la robotique et l'IoT.
- [Analyseur de Liste de Composants (BOM)](https://talos.tposcorp.com/liste): Outil d'appariement automatique de listes de composants brutes.
- [Chorus Pro](https://talos.tposcorp.com/b2b): Devis Chorus Pro et dépôt de bons de commande pour universités et laboratoires.

## API & Commerce Agentique (Agentic Commerce 2026)

- [OpenAPI Specification](https://talos.tposcorp.com/api/openapi.json): Spécification OpenAPI 3.1.0 complète pour les agents IA et LLMs.
- [Catalogue structuré](https://talos.tposcorp.com/api/agent/catalog): Résultats JSON ou Markdown pour rechercher et filtrer des composants.
- [Analyse de nomenclature](https://talos.tposcorp.com/api/agent/bom-match): Analyse sécurisée de listes de composants (BOM).
- [Devis](https://talos.tposcorp.com/api/agent/cart/quote): Calcul des frais et devis signé, valable 15 minutes. Le montant est vérifié au paiement.
- [Commande](https://talos.tposcorp.com/api/agent/checkout): Création d'une session Stripe Checkout avec prise en charge des clés d'idempotence.

## Directives d'utilisation pour Agents IA

- **Clés d'idempotence** : Envoyer un en-tête `Idempotency-Key` (UUID v4) sur les requêtes POST vers `/api/agent/checkout` pour éviter les commandes en double lors d'une nouvelle tentative.
- **Format du catalogue** : Envoyer `Accept: text/markdown` ou utiliser `?format=markdown` sur `/api/agent/catalog` pour recevoir le catalogue en Markdown.
- **Délais** : Le mode `batch` attend la clôture du lot. Le mode `flash` est expédié sous 24 à 48 h.