From 55d36c66afd00599e26285e760a092e9cf786ba4 Mon Sep 17 00:00:00 2001
From: CyberMind-FR <gandalf@Gk2.net>
Date: Mon, 27 Apr 2026 19:10:27 +0200
Subject: [PATCH] docs(wiki): Add Device Categories page for 6-icon system
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add Device-Categories.md documenting AUTH→MESH Hamiltonian path
- Document color palette, HID mapping, I²C registers
- Update _Sidebar.md with new WALL — Hardware section
- Link to Smart-Strip and Eye-Remote device pages

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 wiki/Device-Categories.md | 149 ++++++++++++++++++++++++++++++++++++++
 wiki/_Sidebar.md          |   1 +
 2 files changed, 150 insertions(+)
 create mode 100644 wiki/Device-Categories.md

diff --git a/wiki/Device-Categories.md b/wiki/Device-Categories.md
new file mode 100644
index 00000000..d2e6db9f
--- /dev/null
+++ b/wiki/Device-Categories.md
@@ -0,0 +1,149 @@
+# Device Categories — SecuBox 6-Icon System
+
+SecuBox uses a unified 6-category icon system across all devices and interfaces. This **Hamiltonian path** (AUTH → MESH) represents the security flow from authentication to network mesh.
+
+## The Six Categories
+
+| Index | Icon | Name | Role | Color | Hex |
+|-------|------|------|------|-------|-----|
+| 0 | 🔐 | **AUTH** | Authentication / VPN / Encryption | Rust | `#C04E24` |
+| 1 | 🛡️ | **WALL** | Firewall / nftables / CrowdSec | Amber | `#9A6010` |
+| 2 | ⚙️ | **BOOT** | System / OS / Services | Crimson | `#803018` |
+| 3 | 🧠 | **MIND** | AI / CPU / Processing | Indigo | `#3D35A0` |
+| 4 | 🌳 | **ROOT** | Privileges / Integrity / Trust | Teal | `#0A5840` |
+| 5 | 🌐 | **MESH** | Network / WireGuard / Tailscale | Navy | `#104A88` |
+
+## Hamiltonian Path
+
+The order AUTH → WALL → BOOT → MIND → ROOT → MESH follows the **Hamiltonian path** defined in the SecuBox security charter:
+
+```
+AUTH ─────► WALL ─────► BOOT
+  │                       │
+  │   ┌─────────────────┐ │
+  │   │   SecuBox Core  │ │
+  │   └─────────────────┘ │
+  │                       │
+MESH ◄───── ROOT ◄───── MIND
+```
+
+1. **AUTH** — Entry point: user authenticates
+2. **WALL** — Traffic filtered by firewall rules
+3. **BOOT** — System services respond
+4. **MIND** — AI/processing analyzes request
+5. **ROOT** — Privileges verified, integrity checked
+6. **MESH** — Connected to network mesh
+
+## Device Implementations
+
+### Smart-Strip (SBX-STR-01)
+
+Physical HMI module with 6 RGB LEDs and capacitive touch zones.
+
+| Feature | Description |
+|---------|-------------|
+| LEDs | 6× SK6812-MINI-E (RGB, 5V) |
+| Touch | 6× capacitive pads (AT42QT2120) |
+| Interface | USB-C / I²C |
+| Animations | Sweep, breathing, panic |
+
+**LED Behaviors:**
+- **Solid** — Status OK
+- **Flash** — Error or event
+- **Pulse** — Operation in progress
+- **Sweep** — Hamiltonian animation
+
+See: [Smart-Strip](Smart-Strip)
+
+### Eye Remote (Pi Zero W)
+
+Remote dashboard with HyperPixel 2.1 Round display.
+
+| Category | Display Element |
+|----------|-----------------|
+| AUTH | VPN status indicator |
+| WALL | Firewall activity graph |
+| BOOT | System health gauge |
+| MIND | CPU/AI load meter |
+| ROOT | Integrity status |
+| MESH | Network topology |
+
+See: [Eye-Remote](Eye-Remote)
+
+### C3BOX Dashboard
+
+Web-based dashboard using the 6-category layout.
+
+| Category | Panel Content |
+|----------|--------------|
+| AUTH | Active sessions, certificates |
+| WALL | Firewall rules, blocked IPs |
+| BOOT | Services status, uptime |
+| MIND | AI insights, CPU graphs |
+| ROOT | Audit log, integrity checks |
+| MESH | Peers, bandwidth, latency |
+
+### Console TUI
+
+Terminal-based interface with 6-panel layout.
+
+```
+┌─────────────────────────────────────────────────┐
+│ AUTH │ WALL │ BOOT │ MIND │ ROOT │ MESH │
+├──────┴──────┴──────┴──────┴──────┴──────┤
+│                                         │
+│           SecuBox Console               │
+│                                         │
+└─────────────────────────────────────────┘
+```
+
+## Color Palette CSS
+
+```css
+:root {
+  --auth: #C04E24;  /* Rust */
+  --wall: #9A6010;  /* Amber */
+  --boot: #803018;  /* Crimson */
+  --mind: #3D35A0;  /* Indigo */
+  --root: #0A5840;  /* Teal */
+  --mesh: #104A88;  /* Navy */
+}
+```
+
+## HID Mapping (Smart-Strip)
+
+| Pad | HID Usage | Linux Key |
+|-----|-----------|-----------|
+| AUTH | `0x0220` | KEY_F13 |
+| WALL | `0x021F` | KEY_F14 |
+| BOOT | `0x0192` | KEY_F15 |
+| MIND | `0x019C` | KEY_F16 |
+| ROOT | `0x0194` | KEY_F17 |
+| MESH | `0x023D` | KEY_F18 |
+
+## I²C Register Map
+
+| Register | Category | Description |
+|----------|----------|-------------|
+| `0x10` | AUTH | LED0 RGB (3 bytes) |
+| `0x13` | WALL | LED1 RGB (3 bytes) |
+| `0x16` | BOOT | LED2 RGB (3 bytes) |
+| `0x19` | MIND | LED3 RGB (3 bytes) |
+| `0x1C` | ROOT | LED4 RGB (3 bytes) |
+| `0x1F` | MESH | LED5 RGB (3 bytes) |
+
+## Animation Patterns
+
+| ID | Name | Pattern |
+|----|------|---------|
+| 0 | Manual | Direct control |
+| 1 | Sweep | Hamiltonian sweep AUTH→MESH |
+| 2 | Panic | ROOT flashes red, reverse sweep |
+| 3 | Breathing | All LEDs pulse in sync |
+| 4 | Boot | Sequential light-up |
+
+## See Also
+
+- [Smart-Strip](Smart-Strip) — HMI module
+- [Eye-Remote](Eye-Remote) — Remote dashboard
+- [UI Comparison](UI-COMPARISON) — Interface comparison
diff --git a/wiki/_Sidebar.md b/wiki/_Sidebar.md
index e1249130..5017b4f7 100644
--- a/wiki/_Sidebar.md
+++ b/wiki/_Sidebar.md
@@ -26,6 +26,7 @@
 * [UI Comparison](UI-COMPARISON)
 
 ### 🟠 WALL — Hardware
+* [Device Categories](Device-Categories) 6-Icon System
 * [Smart-Strip](Smart-Strip) 🆕 HMI Interface
 
 ### Links