StillHammer
439b55b176
- Add comprehensive README.md explaining Aissia is built on GroveEngine - Add GROVEENGINE_GUIDE.md with complete user guide - Add docs/project-overview.md - Archive old CLAUDE.md to CLAUDE.md.old 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
113 lines
3.1 KiB
Markdown
113 lines
3.1 KiB
Markdown
# AISSIA - Assistant Personnel Intelligent
|
|
|
|
## Description
|
|
|
|
Assistant personnel qui aide à gérer le temps, l'hyperfocus et l'apprentissage de langues. Interventions proactives avec l'IA pour forcer les transitions et planifier intelligemment.
|
|
|
|
## Fonctionnalités MVP
|
|
|
|
1. **SchedulerModule** : Planning de tâches, détection hyperfocus (max 2h), rappels de pauses
|
|
2. **AIAssistantModule** : Interventions contextuelles via Claude, dialogue naturel
|
|
3. **LanguageLearningModule** : Conversation dans langue cible, corrections intelligentes
|
|
4. **NotificationModule** : Alertes système Windows, TTS, support multilingue
|
|
5. **DataModule** : SQLite local, historique, métriques
|
|
|
|
## Architecture Technique
|
|
|
|
### Principe : Architecture Modulaire WarFactory
|
|
|
|
Hot-reload 0.4ms, modules 200-300 lignes, build autonome par module.
|
|
|
|
```
|
|
MainServer Process
|
|
├── CoordinationModule → Charge appconfig.json
|
|
├── DebugEngine → SequentialModuleSystem
|
|
└── Modules (.dll)
|
|
├── scheduler.dll
|
|
├── ai-assistant.dll
|
|
├── language.dll
|
|
├── notification.dll
|
|
└── data.dll
|
|
```
|
|
|
|
### 5 Interfaces Fondamentales
|
|
|
|
```cpp
|
|
ICoordinationModule → Orchestrateur global
|
|
IEngine → DebugEngine → HighPerfEngine
|
|
IModuleSystem → Sequential → Threaded → Cluster
|
|
IModule → Logique métier pure (200 lignes max)
|
|
IIO → IntraIO → LocalIO → NetworkIO
|
|
```
|
|
|
|
### Contraintes Critiques
|
|
|
|
**Modules** :
|
|
- 200-300 lignes maximum
|
|
- Logique métier pure (pas de threading, network)
|
|
- Communication JSON uniquement
|
|
- Build autonome : `cmake .` depuis module
|
|
|
|
**NEVER** :
|
|
- ❌ `cmake ..` ou `#include "../"`
|
|
- ❌ Modules > 300 lignes
|
|
- ❌ Dépendances entre modules
|
|
|
|
**ALWAYS** :
|
|
- ✅ Build autonome
|
|
- ✅ JSON communication
|
|
- ✅ Hot-reload ready
|
|
- ✅ Task-centric design
|
|
|
|
### Workflow Développement
|
|
|
|
```bash
|
|
cd modules/scheduler/
|
|
cmake . # NEVER cmake ..
|
|
make
|
|
./scheduler-test
|
|
|
|
# Edit SchedulerModule.cpp → Save → Hot-reload 0.4ms
|
|
```
|
|
|
|
### Communication Inter-Modules (JSON)
|
|
|
|
```json
|
|
{"event": "hyperfocus", "duration_minutes": 120}
|
|
→ AIAssistantModule
|
|
{"type": "break_suggestion", "message": "Pause ?"}
|
|
→ NotificationModule
|
|
{"notification": "system_toast", "tts": true}
|
|
```
|
|
|
|
## Structure Projet
|
|
|
|
```
|
|
Aissia/
|
|
├── CLAUDE.md
|
|
├── docs/ # Documentation détaillée
|
|
├── modules/ # À créer
|
|
│ ├── scheduler/
|
|
│ ├── ai-assistant/
|
|
│ ├── language-learning/
|
|
│ ├── notification/
|
|
│ └── data/
|
|
└── src/ # Infrastructure
|
|
```
|
|
|
|
## Priorités
|
|
|
|
1. Infrastructure (IModule, IEngine, hot-reload)
|
|
2. SchedulerModule
|
|
3. NotificationModule
|
|
4. AIAssistantModule
|
|
5. LanguageLearningModule
|
|
6. DataModule
|
|
|
|
## Références
|
|
|
|
- `docs/README.md` : Vue d'ensemble
|
|
- `docs/architecture/architecture-technique.md` : Architecture complète
|
|
- `CDCDraft.md` : Cahier des charges
|
|
- GroveEngine : Architecture source WarFactory (accès via `.claude/settings.json`)
|