StillHammer
66e5c677ea
Features: - Direct conversations (1-to-1) auto-created and permanent - Group conversations with leave/archive support - Real-time messaging via long-polling - Offline notifications via CLAUDE.md - Auto-registration on MCP startup Architecture: - Broker: Express HTTP server + SQLite - MCP Partner: Modular tools (one file per tool) - Full documentation and API reference
111 lines
4.9 KiB
Markdown
111 lines
4.9 KiB
Markdown
# Structure de la Base de Données v3
|
|
|
|
La base SQLite est créée automatiquement dans `data/duo.db`.
|
|
|
|
## Tables
|
|
|
|
### partners
|
|
|
|
Stocke les informations sur les partenaires (instances Claude Code).
|
|
|
|
| Colonne | Type | Description |
|
|
|---------|------|-------------|
|
|
| `id` | TEXT (PK) | Identifiant unique (basé sur le nom du dossier projet) |
|
|
| `name` | TEXT | Nom d'affichage du partenaire |
|
|
| `project_path` | TEXT | Chemin absolu du projet (pour les notifications CLAUDE.md) |
|
|
| `created_at` | DATETIME | Date de première inscription |
|
|
| `last_seen` | DATETIME | Dernière activité |
|
|
| `status` | TEXT | `online` ou `offline` |
|
|
| `status_message` | TEXT | Message de status personnalisé |
|
|
| `notifications_enabled` | INTEGER | 1 = activées, 0 = désactivées |
|
|
|
|
### conversations
|
|
|
|
Stocke les conversations (directes ou de groupe).
|
|
|
|
| Colonne | Type | Description |
|
|
|---------|------|-------------|
|
|
| `id` | TEXT (PK) | `direct_<a>_<b>` pour direct, `group_<ts>_<rand>` pour groupe |
|
|
| `name` | TEXT | Nom de la conversation (null pour direct) |
|
|
| `type` | TEXT | `direct` ou `group` |
|
|
| `created_at` | DATETIME | Date de création |
|
|
| `created_by` | TEXT (FK) | Créateur de la conversation |
|
|
| `is_archived` | INTEGER | 1 = archivée (plus de participants) |
|
|
|
|
### conversation_participants
|
|
|
|
Lie les partenaires aux conversations.
|
|
|
|
| Colonne | Type | Description |
|
|
|---------|------|-------------|
|
|
| `conversation_id` | TEXT (PK) | Référence conversation |
|
|
| `partner_id` | TEXT (PK) | Référence partenaire |
|
|
| `joined_at` | DATETIME | Date d'arrivée |
|
|
| `last_read_at` | DATETIME | Dernier message lu (pour calculer les non lus) |
|
|
|
|
### messages
|
|
|
|
Stocke tous les messages.
|
|
|
|
| Colonne | Type | Description |
|
|
|---------|------|-------------|
|
|
| `id` | INTEGER (PK) | Auto-increment |
|
|
| `conversation_id` | TEXT (FK) | Conversation du message |
|
|
| `from_id` | TEXT (FK) | Expéditeur |
|
|
| `content` | TEXT | Contenu du message |
|
|
| `created_at` | DATETIME | Date de création |
|
|
|
|
## Diagramme ER
|
|
|
|
```
|
|
┌─────────────────────┐
|
|
│ partners │
|
|
├─────────────────────┤
|
|
│ id (PK) │◄────────────────────────────┐
|
|
│ name │ │
|
|
│ project_path │ │
|
|
│ status │ │
|
|
│ status_message │ │
|
|
│ notifications_enabled│ │
|
|
│ created_at │ │
|
|
│ last_seen │ │
|
|
└─────────────────────┘ │
|
|
│ │
|
|
│ │
|
|
▼ │
|
|
┌─────────────────────────────┐ │
|
|
│ conversation_participants │ │
|
|
├─────────────────────────────┤ │
|
|
│ conversation_id (PK, FK) │─────┐ │
|
|
│ partner_id (PK, FK) │─────│───────────────┘
|
|
│ joined_at │ │
|
|
│ last_read_at │ │
|
|
└─────────────────────────────┘ │
|
|
│
|
|
▼
|
|
┌─────────────────────┐ ┌─────────────────────┐
|
|
│ conversations │ │ messages │
|
|
├─────────────────────┤ ├─────────────────────┤
|
|
│ id (PK) │◄───│ conversation_id (FK)│
|
|
│ name │ │ id (PK) │
|
|
│ type │ │ from_id (FK) │───► partners.id
|
|
│ created_at │ │ content │
|
|
│ created_by (FK) │ │ created_at │
|
|
│ is_archived │ └─────────────────────┘
|
|
└─────────────────────┘
|
|
```
|
|
|
|
## Conversations directes vs groupe
|
|
|
|
### Direct (1-to-1)
|
|
- ID déterministe: `direct_alice_bob` (trié alphabétiquement)
|
|
- Créée automatiquement au premier message
|
|
- Impossible à quitter
|
|
- Toujours 2 participants
|
|
|
|
### Groupe
|
|
- ID aléatoire: `group_1706123456789_abc123def`
|
|
- Créée explicitement via `create_conversation`
|
|
- Possibilité de quitter
|
|
- Auto-archivée quand plus de participants
|