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