# Modèle 3D — Companion Cube

## Architecture : Pièces Modulaires Séparées

```
ASSEMBLAGE
==========

1. Frame (squelette)
   ↓ vissé dessus
2. Battery Cradle + PCB Central Mount
   ↓ électronique montée
3. PCB Carriers (x6) vissés sur plots du Frame
   ↓ PCBs montés + câblés
4. Face Covers (x6) vissées sur Carriers
   └─ Joint O-ring entre Carrier et Cover
```

## Fichiers

| Fichier | Description |
|---------|-------------|
| `cube-config.scad` | **Paramètres** — modifier ici pour ajuster dimensions |
| `cube-parts.scad` | **Pièces** — définition des 10 pièces à imprimer |
| `cube-assembly.scad` | **Assemblage** — vue complète, ouvrir dans OpenSCAD |

## 10 Pièces à Imprimer

| # | Pièce | Qté | Matériau | Rôle |
|---|-------|-----|----------|------|
| 1 | `frame` | 1 | PLA/PETG opaque gris | Squelette principal |
| 2 | `battery_cradle` | 1 | PLA/PETG | Support batterie LiPo |
| 3 | `pcb_central_mount` | 1 | PLA/PETG | Support PCB ESP32-S3 |
| 4 | `pcb_carrier_standard` | 4 | PLA/PETG | Supports PCB faces latérales |
| 5 | `pcb_carrier_nfc` | 1 | PLA/PETG | Support PCB face dessus (NFC) |
| 6 | `pcb_carrier_qi` | 1 | PLA/PETG | Support PCB face dessous (Qi) |
| 7 | `face_cover_standard` | 4 | PETG translucide | Coques extérieures latérales |
| 8 | `face_cover_nfc` | 1 | PETG translucide | Coque extérieure dessus |
| 9 | `face_cover_qi` | 1 | PETG translucide | Coque extérieure dessous |

**Total : 15 pièces** (1+1+1 + 4+1+1 + 4+1+1)

## Utilisation

1. **Installer OpenSCAD** : https://openscad.org/
2. **Ouvrir** `cube-assembly.scad`
3. **Prévisualiser** : F5 (rapide) ou F6 (complet)

### Contrôles de visualisation

Dans `cube-assembly.scad`, modifier les variables :

```openscad
SHOW_FRAME          = true;    // Squelette
SHOW_INTERNALS      = true;    // Battery Cradle + PCB Mount
SHOW_PCB_CARRIERS   = true;    // 6 supports PCB
SHOW_FACE_COVERS    = true;    // 6 coques extérieures
SHOW_ELECTRONICS    = true;    // Batterie + PCB (visuel)
SHOW_SECTION        = false;   // Vue en coupe

EXPLODE             = 0;       // 0 à 1 (vue éclatée)
```

### Export STL pour impression

1. Éditer `cube-assembly.scad`
2. **Décommenter** le module souhaité (fin du fichier)
3. **Commenter** `assembly()`
4. F6 → File → Export as STL

Exemple :
```openscad
// assembly();  // ← commenter
frame();        // ← décommenter
```

## Séquence d'Assemblage

### Étape 1 : Frame + Internals
1. Imprimer `frame`, `battery_cradle`, `pcb_central_mount`
2. Visser les supports au frame (vis M2.5 ou M3)
3. Monter batterie + PCB central + câblage

### Étape 2 : PCB Carriers
1. Imprimer les 6 carriers (4 standard + 1 NFC + 1 Qi)
2. Monter les PCBs Anneau + Bouchon sur chaque carrier
3. Visser chaque carrier sur les 4 plots du frame (M3)
4. Câbler JST depuis le PCB central vers chaque carrier

### Étape 3 : Face Covers
1. Imprimer les 6 covers (PETG translucide)
2. Insérer joint O-ring (Ø cordon 2mm) dans la gorge
3. Visser chaque cover sur son carrier (M3)
4. Serrer uniformément les 4 vis

## Paramètres Clés

| Paramètre | Valeur | Impact |
|-----------|--------|--------|
| `CUBE_SIZE` | 120 mm | Taille globale du cube |
| `CORNER_RADIUS` | 6 mm | Arrondi des coins (Portal style) |
| `FACE_MEMBRANE_T` | 1.0 mm | Membrane tactile (sensibilité) |
| `SEAL_CORD_DIAM` | 2.0 mm | Diamètre cordon O-ring |
| `PRINT_TOLERANCE` | 0.2 mm | Ajuster selon votre imprimante |

## Matériel nécessaire

- **Vis M3 x 8mm** : 24 (fixation carriers sur frame)
- **Vis M3 x 6mm** : 24 (fixation covers sur carriers)
- **Vis M2.5 x 6mm** : 8 (battery cradle + pcb mount)
- **Joint O-ring Ø2mm** : 6m (1m par face, gorge continue)
- **Inserts filetés M3** (optionnel) : 48