AlphAstra

Guide pour l'équipe - Infrastructure & Développement

C'est quoi AlphAstra ?

AlphAstra est une plateforme qui analyse la crédibilité des sites web et leur attribue un score de A à F, comme un Nutri-Score mais pour internet.

🔍

Analyse automatique

On entre une URL, notre IA analyse le site en profondeur : contenu, sources, biais, sécurité...

📊

Score de crédibilité

Un score simple de A (très fiable) à F (peu fiable) avec des explications détaillées.

🎯

Mission

Lutter contre la désinformation et aider les gens à identifier les sources fiables.

Les scores expliqués

A
B
C
D
E
F
Score Signification Exemple
A Source très fiable, journalisme de qualité Le Monde, BBC, Reuters
B Source fiable avec quelques réserves Blogs spécialisés reconnus
C Source correcte, vérifier les infos Sites d'opinion
D Source peu fiable, biais importants Sites partisans
E Source douteuse, prudence requise Sites clickbait
F Source non fiable, désinformation probable Sites de fake news

Comment ça marche ?

L'utilisateur entre une URL

Via notre site web ou notre extension navigateur, l'utilisateur soumet l'adresse d'un site à analyser.

Notre robot visite le site

Un "crawler" automatique visite le site comme le ferait un humain, récupère le contenu, les images, la structure...

L'IA analyse le contenu

Notre intelligence artificielle (Llama + Claude) examine le texte pour détecter :

  • Le sentiment général (positif, négatif, neutre)
  • Les biais (politique, commercial, émotionnel)
  • Le style clickbait
  • La qualité des sources citées
  • Les signes de désinformation

Calcul du score

Tous les critères sont agrégés pour donner un score final de A à F, avec un rapport détaillé.

Affichage du résultat

L'utilisateur voit le score, les points forts/faibles, et des recommandations.

┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ Utilisateur │────▶│ Crawler │────▶│ IA Locale │────▶│ Score │ │ (URL) │ │ (Playwright)│ │ (Ollama) │ │ A-F │ └─────────────┘ └─────────────┘ └──────┬──────┘ └─────────────┘ │ ▼ Si complexe ┌─────────────┐ │ Claude API │ │ (Fallback) │ └─────────────┘

Notre Infrastructure

💡
En résumé : On utilise un serveur cloud (Hetzner) qui fait tourner la production (le site public) et le développement (nos outils de travail).

Architecture simplifiée

┌──────────────────────────────────────────────────────────────────────┐ │ SERVEUR HETZNER (Cloud) │ │ ~20€/mois - Allemagne │ │ │ │ ┌─────────────────────────────┐ ┌─────────────────────────────┐ │ │ │ PRODUCTION │ │ DÉVELOPPEMENT │ │ │ │ │ │ │ │ │ │ ┌─────────────────────┐ │ │ ┌─────────────────────┐ │ │ │ │ │ Site AlphAstra.org │ │ │ │ Claude Code │ │ │ │ │ │ (Angular) │ │ │ │ (Assistant IA) │ │ │ │ │ └─────────────────────┘ │ │ └─────────────────────┘ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────┐ │ │ ┌─────────────────────┐ │ │ │ │ │ API Backend │ │ │ │ Interface DX │ │ │ │ │ │ (Flask/Python) │ │ │ │ (Terminal + .md) │ │ │ │ │ └─────────────────────┘ │ │ └─────────────────────┘ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────┐ │ │ Protection: │ │ │ │ │ IA Locale (Ollama) │ │ │ • RAM max: 4GB │ │ │ │ │ Llama 3.1 │ │ │ • CPU max: 50% │ │ │ │ └─────────────────────┘ │ │ • Auto-restart │ │ │ │ │ │ │ │ │ └─────────────────────────────┘ └─────────────────────────────┘ │ └──────────────────────────────────────────────────────────────────────┘

Options serveur Hetzner

Hetzner propose différentes gammes de serveurs cloud. Voici les options pertinentes pour AlphAstra :

🔹 Série CX (vCPU partagé Intel)

Processeurs partagés, bon rapport qualité/prix pour le MVP

Modèle vCPU RAM SSD Prix/mois Usage
CX22 2 4 GB 40 GB 4,51€ Tests uniquement
CX32 4 8 GB 80 GB 7,59€ MVP minimal
CX42 8 16 GB 160 GB 14,64€ ✅ MVP recommandé
CX52 16 32 GB 320 GB 29,81€ Production confortable

🔸 Série CPX (vCPU dédié AMD)

Processeurs AMD dédiés, meilleures performances garanties

Modèle vCPU RAM SSD Prix/mois Usage
CPX21 3 4 GB 80 GB 8,21€ Dev isolé
CPX31 4 8 GB 160 GB 14,64€ MVP + Ollama light
CPX41 8 16 GB 240 GB 28,19€ ✅ Production recommandé
CPX51 16 32 GB 360 GB 56,39€ Production + LLM gros modèles

🔹 Série CAX (ARM Ampere)

Processeurs ARM, très économiques mais compatibilité à vérifier

Modèle vCPU RAM SSD Prix/mois Usage
CAX21 4 8 GB 80 GB 5,29€ Tests ARM
CAX31 8 16 GB 160 GB 9,69€ MVP économique
CAX41 16 32 GB 320 GB 18,49€ Production économique
💡
Notre recommandation MVP :
CX42 (14,64€/mois) - Bon équilibre entre coût et performances.
8 vCPU et 16 GB RAM permettent de faire tourner Ollama + la prod + le dev confortablement.
⚠️
Note ARM (CAX) : Moins cher mais certains outils (Docker images, npm packages) peuvent ne pas être compatibles ARM. Préférer Intel/AMD pour éviter les problèmes.

Coûts mensuels estimés

Service Usage Coût
Serveur Hetzner (CX42) Hébergement de tout ~15€
API Claude (Anthropic) Développement + analyses complexes ~30€
Domaine alphastra.org Nom de domaine ~1€
Total MVP ~46€/mois

Interface DX (Developer Experience)

🖥️
DX est notre interface de développement centralisée. Elle combine terminaux web, éditeur Markdown, et gestion des projets Claude dans une seule interface.

L'interface DX

🖥️

Terminaux web (tmux)

Sessions persistantes. Vous pouvez fermer le navigateur, vos sessions continuent en arrière-plan.

📁

Projets Claude

Liste de tous les projets avec leur fichier CLAUDE.md. Un clic pour ouvrir.

📝

Éditeur Markdown

Édition des fichiers .md avec coloration syntaxique et sauvegarde automatique.

🔧

Monitoring services

État des services systemd : API, base de données, Ollama...

Comment travailler avec Claude

Vous avez deux façons de communiquer avec Claude :

💬 Chat direct (terminal) 📝 Fichiers .md
  • Tapez directement dans le terminal
  • Conversation fluide en temps réel
  • Idéal pour les questions rapides
  • Claude répond immédiatement
  • Créez un fichier .md avec votre demande
  • Idéal pour demandes complexes
  • Permet de garder un historique
  • Claude peut créer des .md avec son analyse

Quand utiliser les fichiers .md ?

📋

TODOs et tâches

Créez un TODO.md avec la liste des tâches. Claude peut le mettre à jour au fur et à mesure.

🔍

Analyses de Claude

Demandez à Claude de créer un .md avec son analyse. Exemple : "crée un ANALYSE.md avec ton diagnostic".

📖

Documentation

Demandez à Claude de documenter ce qu'il fait dans un README.md ou NOTES.md.

🎯

Demandes complexes

Pour des demandes avec beaucoup de détails, écrivez-les dans un .md plutôt que dans le chat.

Bonnes pratiques avec Claude

💡
Demandez à Claude de documenter ! Exemple : "Avant de commencer, crée un PLAN.md avec les étapes que tu vas suivre" ou "Crée un ANALYSE.md avec ton diagnostic du problème".
✅ Bonne pratique Pourquoi ?
"Crée un TODO.md avec les tâches" Vous voyez la liste des tâches et leur avancement
"Documente ton analyse dans ANALYSE.md" Vous gardez une trace de son raisonnement
"Mets à jour le README.md" La documentation reste à jour automatiquement
"Avant de modifier, explique ce que tu vas faire" Vous pouvez valider avant qu'il agisse
"Fais des petits commits réguliers" Facile de revenir en arrière si besoin

Les Skills (commandes spéciales)

Claude a des skills : des commandes pré-configurées pour des tâches courantes. Tapez /menu pour voir la liste.

Skill Description Exemple
/menu Affiche toutes les commandes disponibles /menu
/pitch Génère un pitch de X minutes /pitch 3 min WebScore
/linkedin-post Crée un post LinkedIn professionnel /linkedin-post IA et journalisme
/server-status Vérifie l'état du serveur OVH /server-status
/references Gère la base de références bibliographiques /references cherche GIEC
/debug-deploy Debug un problème de déploiement /debug-deploy
⚡
Astuce : Les skills sont très puissants ! Commencez par /menu pour découvrir ce qui est disponible.

Utiliser Claude Code

🎉
Bonne nouvelle : Pas besoin de savoir coder ! Claude Code est une IA qui code pour vous. Vous lui décrivez ce que vous voulez en français, et il écrit le code.

Comment lancer Claude Code ?

Dans le terminal de l'interface DX, tapez :

claude /resume
💡
Pourquoi /resume ? Cette commande permet de reprendre la conversation là où Claude s'était arrêté. Il garde le contexte du projet et de vos demandes précédentes.

Commandes utiles

Commande Description
claude /resume Lancer Claude en reprenant le contexte précédent
claude Lancer Claude avec une nouvelle conversation
/help Afficher l'aide de Claude (une fois lancé)
/clear Effacer l'historique de conversation
/exit ou Ctrl+C Quitter Claude Code
git status Voir les fichiers modifiés
git diff Voir le détail des modifications
git checkout . Annuler TOUTES les modifications
git checkout fichier.ts Annuler les modifs d'UN fichier

Exemples de demandes à Claude

🎨 Design

"Change la couleur du bouton en bleu et ajoute une ombre"

🐛 Bug

"Le score ne s'affiche pas correctement, peux-tu corriger ?"

✨ Nouvelle fonction

"Ajoute un bouton pour partager le résultat sur Twitter"

❓ Comprendre

"Explique-moi comment fonctionne le fichier score.service.ts"

Bonnes pratiques

✅ Faire ❌ Éviter
Être précis dans vos demandes Demandes vagues ("améliore le site")
Tester après chaque modification Faire 10 changements d'un coup
Utiliser les fichiers .md pour les grosses demandes Tout taper dans le terminal
Demander des explications si vous ne comprenez pas Valider du code que vous ne comprenez pas

Problèmes courants & Solutions

⚠️
L'environnement de dev peut parfois planter. C'est normal ! Voici comment reconnaître les problèmes et les résoudre.

Messages d'erreur courants

Error: ENOSPC: no space left on device → Le disque est plein. Contacter Aurèle. Error: spawn ENOMEM → Plus de mémoire disponible. Relancer l'environnement. Error: connect ECONNREFUSED → Le serveur de dev est arrêté. Relancer l'environnement. npm ERR! code ELIFECYCLE → Une commande npm a échoué. Relancer l'environnement. Port 4200 is already in use → L'ancien serveur tourne encore. Relancer l'environnement. Cannot find module '...' → Dépendance manquante. Relancer l'environnement.

Comment relancer l'environnement ?

Via le bouton dans DX

Cliquez sur le bouton "Relancer Dev" dans l'interface DX. L'environnement va redémarrer automatiquement.

Attendre le redémarrage

Le redémarrage prend environ 30 secondes. Un message confirmera quand c'est prêt.

🔄
Auto-restart : Un système automatique surveille l'environnement et le relance en cas de problème. Dans la plupart des cas, vous n'aurez rien à faire !

Si le problème persiste

🔄

Relancer 2-3 fois

Parfois il faut relancer plusieurs fois pour que tout se stabilise.

⏳

Attendre 5 minutes

Le système auto-restart peut avoir besoin de temps pour tout remettre en ordre.

📱

Contacter l'équipe

Si ça ne marche toujours pas, envoyez un message sur le groupe WhatsApp.

Accès & Contacts

URLs importantes

Service URL Usage
Site public alphastra.org Le produit final
Site dev dev.alphastra.org Version de test (peut planter)
Interface DX dx.aemeth.eu Développement avec Claude

Identifiants

🔐
Les mots de passe sont fournis séparément par l'équipe technique. Ne les partagez pas !

Équipe technique

Nom Rôle Contact
Guillaume Dupont Fondateur & Produit WhatsApp
Aurèle Durand Tech Lead WhatsApp
Arthur Balty Business & Innovation WhatsApp
Virgile Leclerc Développement WhatsApp
📱
Communication : Toutes les discussions se font sur le groupe WhatsApp AlphAstra. En cas de problème urgent, envoyez un message là-bas !