Bienvenue dans Clartt 👋 ​
Tu es au bon endroit pour comprendre comment Clartt est construit et comment le faire tourner. Cette documentation centralise tout : la stack, les environnements et le guide d'installation, pour qu'un nouveau dev soit opérationnel rapidement.
💡 Pressé·e de coder ? File directement vers le guide d'installation.
Le projet en deux mots ​
Clartt est une plateforme SaaS pensée pour les sociétés de services et la gestion des droits musicaux. Elle couvre la gestion des clients et des contrats, la facturation, l'import de catalogues (CSV, PDF, formats SACEM/BDO…) et une assistance IA capable de lire, classer et fouiller les documents.
C'est un monorepo : 4 applications indépendantes qui s'articulent autour d'une API Laravel centrale. Le site public est en ligne sur clartt.com.
La stack ​
| Service | RĂ´le | Techno | Port (local) |
|---|---|---|---|
| clartt-front | Interface d'administration | Next.js 16 · React 19 · TypeScript · MUI 7 · Tailwind 4 | 3000 |
| clartt-public | Site marketing | Next.js 16 · React 19 · TypeScript | 3001 |
| clartt-api | API centrale | Laravel 12 · PHP 8.3 · Sanctum · Horizon · Reverb (WS) | 8000 (WS 8080) |
| clartt-kent-ai | Service IA (OCR, classement, RAG) | FastAPI · Python 3.12 · Mistral AI | 5001 |
Couche données & infra partagée :
- PostgreSQL — base relationnelle principale (clés primaires UUID partout).
- Redis — files d'attente (Horizon) et broadcasting.
- Qdrant — base vectorielle pour la recherche documentaire (RAG). Port
6333. - MinIO — stockage S3-compatible des fichiers, partagé entre l'API et Kent.
Intégrations externes : Mistral AI (OCR / extraction / embeddings), DocuSign (signatures), Deezer · MusicBrainz · Genius · Soundcharts (métadonnées musicales), Stripe (abonnements).
Les environnements ​
Clartt vit sur trois environnements, chacun avec sa logique de déploiement.
🧑‍💻 Local ​
Ta machine de dev. Chaque service tourne sur son port (voir le tableau ci-dessus). PostgreSQL, Redis et MinIO sont généralement fournis par Herd, et Kent AI se lance via Docker Compose (Qdrant inclus). Le guide d'installation détaille tout, étape par étape.
🧪 Preprod — Dockploy ​
L'environnement de pré-production est orchestré par Dockploy (déploiements Docker Compose). Chaque service est un déploiement indépendant, relié au réseau partagé dokploy-network.
| Domaine | Service |
|---|---|
devapp.clartt.com | clartt-front |
devapi.clartt.com | clartt-api (web) |
devws.clartt.com | clartt-api (Reverb / WebSocket) |
devkent.clartt.com | clartt-kent-ai |
devdocs.clartt.com | clartt-doc (cette documentation) |
🚀 Production — Forge + VPS / Coolify ​
- Forge pilote le VPS principal (
54.36.98.104) qui sertclartt.com,app.clartt.cometapi.clartt.com. - Coolify pilote un VPS dédié (
146.59.234.119) pourkent.clartt.com(le service IA, plus gourmand). - Les deux serveurs communiquent via un tunnel WireGuard pour les appels internes sécurisés.
Et maintenant ? ​
Direction le guide d'installation pour monter ton environnement de dev. Bonne lecture, et bienvenue dans Clartt ! 🎶