aissia/CLAUDE.md
StillHammer f231188880 Refactor documentation structure and add language learning
- Reorganize docs/ (flatten to architecture/ and implementation/)
- Remove MonitoringModule from MVP (no app detection)
- Add LanguageLearningModule to MVP
- Create CLAUDE.md (concise project overview)
- Add language learning to README and architecture
- Update all examples to use SchedulerModule instead of MonitoringModule

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-29 07:28:34 +08:00

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`)