chore: Normalize line endings and update project documentation
- Normalize CRLF to LF across all source files - Replace CLAUDE.md.old with updated CLAUDE.md - Standardize configuration file formatting - Update module source files with consistent line endings 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
parent
439b55b176
commit
0dfb5f1535
64
CLAUDE.md
Normal file
64
CLAUDE.md
Normal file
@ -0,0 +1,64 @@
|
||||
# AISSIA - Assistant Personnel Intelligent
|
||||
|
||||
Assistant pour gérer le temps, l'hyperfocus et l'apprentissage de langues. Basé sur **GroveEngine** (C++17 hot-reload module system).
|
||||
|
||||
## Statut
|
||||
|
||||
| Module | Status | Description |
|
||||
|--------|--------|-------------|
|
||||
| SchedulerModule | Fait | Détection hyperfocus, rappels pauses |
|
||||
| NotificationModule | Fait | Alertes système, TTS, priorités |
|
||||
| AIAssistantModule | TODO | Intégration LLM (Claude API) |
|
||||
| LanguageLearningModule | TODO | Pratique langue cible |
|
||||
| DataModule | TODO | SQLite persistence |
|
||||
|
||||
## Règles de Développement
|
||||
|
||||
### Contraintes Modules
|
||||
- **200-300 lignes max** par module
|
||||
- **Logique métier pure** (pas de threading/network dans les modules)
|
||||
- **Communication JSON** via IIO pub/sub
|
||||
- **Hot-reload ready** : sérialiser tout l'état dans `getState()`
|
||||
|
||||
### NEVER
|
||||
- `cmake ..` ou `#include "../"` (dépendances parent)
|
||||
- Modules > 300 lignes
|
||||
- Infrastructure dans les modules
|
||||
|
||||
### ALWAYS
|
||||
- Build autonome depuis le module
|
||||
- JSON pour toute communication inter-modules
|
||||
- Topics pub/sub : `module:event` (ex: `scheduler:hyperfocus_detected`)
|
||||
|
||||
## Structure
|
||||
|
||||
```
|
||||
Aissia/
|
||||
├── src/
|
||||
│ ├── main.cpp # Main loop 10Hz + hot-reload
|
||||
│ └── modules/ # Modules implémentés
|
||||
│ ├── SchedulerModule.*
|
||||
│ └── NotificationModule.*
|
||||
├── config/ # JSON config par module
|
||||
├── external/GroveEngine/ # Engine (symlink)
|
||||
└── docs/ # Documentation détaillée
|
||||
```
|
||||
|
||||
## Build
|
||||
|
||||
```bash
|
||||
cmake -B build && cmake --build build -j4
|
||||
./build/aissia
|
||||
|
||||
# Hot-reload: rebuild modules seulement
|
||||
cmake --build build --target modules
|
||||
```
|
||||
|
||||
## Documentation
|
||||
|
||||
| Doc | Contenu |
|
||||
|-----|---------|
|
||||
| `docs/GROVEENGINE_GUIDE.md` | API complète IModule, IIO, IDataNode, hot-reload |
|
||||
| `docs/project-overview.md` | Architecture AISSIA, phases dev |
|
||||
| `docs/architecture/intelligent-document-retrieval.md` | AIAssistantModule: retrieval agentique, multi-provider LLM |
|
||||
| `README.md` | Quick start, roadmap |
|
||||
112
CLAUDE.md.old
112
CLAUDE.md.old
@ -1,112 +0,0 @@
|
||||
# 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`)
|
||||
Loading…
Reference in New Issue
Block a user