Muyue de97c33cea Clean up README and remove dev documentation files

- Remove progress tracking sections (implemented/upcoming features)
- Add comprehensive features section describing system capabilities
- Remove TESTING.md and DEVELOPMENT.md (not needed)
- Simplify README structure for end users

2025-10-17 12:19:35 +02:00

4.8 KiB

Raw Blame History

Project Agora

Description

Project Agora est une plateforme web open-source permettant à plusieurs intelligences artificielles de collaborer entre elles pour concevoir la structure complète d'un projet logiciel à partir d'un prompt utilisateur ou d'un document explicatif.

L'objectif est de produire :

Une architecture logicielle complète, incluant :
- Une hiérarchie de fichiers structurée pour le projet
- Une spécification détaillée du contenu attendu pour chaque fichier (sans implémentation de code, uniquement une description fonctionnelle et technique)
Un raisonnement justifié pour chaque choix technique.
Des diagrammes explicatifs (Mermaid).
Une synthèse finale cohérente prête à être utilisée comme base de développement.

Aucune génération de code direct n'est effectuée : seules des explications, réflexions et structures sont produites.

Objectif

Reproduire une table ronde d'IA spécialistes, chaque agent IA représentant un rôle spécifique :

Architecte logiciel
Développeur backend
Développeur frontend
Designer UI/UX
Data engineer
Chef de projet
Éventuellement d'autres rôles selon la complexité du prompt.

Cependant, l'aspect le plus crucial de ces IA réside dans leur capacité à échanger, négocier, voire s'opposer pour déterminer collectivement la meilleure approche à adopter.

Exemple d'utilisation

L'utilisateur entre ceci dans l'interface :

« Je souhaite faire une application de calculatrice scientifique responsive web. »

Le système demande alors à plusieurs IA leur point de vue sur :

Le langage ou framework le plus adapté
L'organisation du projet (folders, modules)
Les fichiers essentiels
Les interactions front/back éventuelles
Le design minimal (UI/UX conceptuel)

Elles discutent pour converger vers un consensus, puis produisent une fiche conceptuelle du projet au format structuré (JSON + affichage visuel + diagrammes Mermaid).

Architecture technique

Stack principal

Frontend: Vue.js 3 + Vite
Backend: Node.js + Express
AI Layer: Multi-agent système avec Mistral API
Storage: SQLite + JSON backup
Diagrammes: Mermaid.js

Architecture globale

graph TD
    A[Frontend: Vue.js 3] -->|User Prompt| B[Backend: Node.js]
    B -->|Orchestration| C[AI Layer: Mistral Agents]
    C -->|Debate Data| D[Storage: SQLite/JSON]
    C -->|Diagram Specs| E[Mermaid Engine]
    E -->|SVG/Render| A
    D -->|History| A

Fonctionnalités

Système multi-agents IA

4 agents spécialisés : Architecte logiciel, Ingénieur backend, Ingénieur frontend, Designer UI/UX
Sélection automatique des agents pertinents selon le contexte du projet
Débat collaboratif : Les agents échangent et négocient pour converger vers la meilleure solution
Système de consensus avec vote pondéré (l'architecte a une voix prépondérante)
Intégration Mistral AI pour génération de réponses intelligentes et contextuelles

Interface et visualisation

Saisie de prompt décrivant le projet souhaité
Visualisation en temps réel des échanges entre agents via WebSocket
Affichage structuré des propositions avec justifications et niveaux de confiance
Rendu automatique de diagrammes Mermaid intégrés dans les réponses
Indicateurs de progression et statuts du débat

Architecture et stockage

API REST pour gestion des débats et récupération des résultats
WebSocket pour streaming temps réel des réponses des agents
Base SQLite pour persistance des débats et historique
Gestion d'erreurs avec fallbacks et réponses de secours

Démarrage rapide

Prérequis

Node.js 18+
Clé API Mistral AI (obtenir ici)

Installation

1. Backend

cd backend
npm install
cp .env.example .env
# Éditer .env et ajouter votre MISTRAL_API_KEY
npm start

2. Frontend

cd frontend
npm install
npm run dev

3. Accéder à l'application

Frontend: http://localhost:5173
Backend API: http://localhost:3000
WebSocket: ws://localhost:3000

Flux utilisateur

sequenceDiagram
  participant User
  participant Orchestrator
  participant AI_Architect
  participant AI_Designer
  participant AI_Engineer
  User->>Orchestrator: Prompt project
  Orchestrator->>AI_Architect: Generate approach
  Orchestrator->>AI_Designer: Discuss UI/UX
  Orchestrator->>AI_Engineer: Suggest modules
  AI_Architect-->>Orchestrator: Architecture proposal
  AI_Designer-->>Orchestrator: Interface ideas
  AI_Engineer-->>Orchestrator: Technical design
  Orchestrator-->>User: Final structured response + diagram

Licence

MIT License — Open-source

4.8 KiB Raw Blame History