Lucas/mkdocs-smarteye/docs/deploiement/installation-client.md

# Installation chez le client

<div style="background: linear-gradient(135deg, #1a1a2e 0%, #16213e 50%, #0f3460 100%); color: white; padding: 32px; border-radius: 12px; margin-bottom: 24px; border: 1px solid rgba(0, 188, 212, 0.3); box-shadow: 0 0 30px rgba(0, 188, 212, 0.1);">
<div style="display: flex; align-items: center; gap: 12px; margin-bottom: 8px;">
<span style="font-size: 1.8em;">:material-shield-home:</span>
<h2 style="margin:0; color: #00e5ff; font-weight: 300; letter-spacing: 2px;">GUIDE TECHNICIEN TERRAIN</h2>
</div>
<p style="margin: 4px 0 0 0; opacity: 0.85; font-size: 0.95em;">Deploiement du systeme de surveillance intelligent Lucas. Duree estimee sur site : ~30 minutes.</p>
<div style="margin-top: 16px; padding-top: 12px; border-top: 1px solid rgba(255,255,255,0.15); display: flex; gap: 24px; font-size: 0.85em; opacity: 0.7;">
<span>:material-cctv: Surveillance</span>
<span>:material-brain: IA embarquee</span>
<span>:material-shield-check: Protection 24/7</span>
<span>:material-phone-alert: Alerte instantanee</span>
</div>
</div>

---

## Pre-requis

!!! info "Le compte client est deja cree"
    Le compte est cree automatiquement lors de la souscription. Le technicien recoit par email :

    - **Identifiant client** (`client_id`)
    - **Mot de passe** (token d'authentification)
    - **Numero de site** attribue

**Chez le client :**

- [ ] Acces Internet (fibre ou ADSL stable)
- [ ] Reseau WiFi pour les cameras (SSID + mot de passe)
- [ ] Prise Ethernet pour le Jetson (cable recommande)
- [ ] Prises electriques a proximite des emplacements cameras

---

## Le kit materiel

Voici ce que le technicien deballera chez le client :

### Jetson Orin Nano — Le cerveau SmartEye

![Jetson Orin Nano Developer Kit](../assets/images/jetson-orin-nano.jpg){ width="500" }

*NVIDIA Jetson Orin Nano — Le boitier d'intelligence artificielle embarquee.*

| Caracteristique | Valeur |
|----------------|--------|
| **Processeur** | 6-core Arm Cortex-A78AE |
| **GPU** | 1024-core NVIDIA Ampere |
| **Performance IA** | Jusqu'a 67 TOPS |
| **RAM** | 8 Go LPDDR5 |
| **Stockage** | Carte SD pre-flashee (image Gold) |
| **Alimentation** | USB-C (adaptateur fourni) |

### Cameras Ctronics PTZ — Les yeux du systeme

<!-- Ajouter les images dans docs/assets/images/ :
     ctronics-camera-1.jpg  (vue de face)
     ctronics-camera-2.jpg  (vue d'angle / exterieur)
     Source : https://ctronics.com/collections/all ou Amazon -->

*Cameras Ctronics PTZ avec vision nocturne et audio bidirectionnel.*

| Caracteristique | Valeur |
|----------------|--------|
| **Resolution** | 2K / 4MP minimum |
| **PTZ** | 355 pan, 90 tilt |
| **Vision nocturne** | 30m couleur |
| **Audio** | Bidirectionnel (micro + haut-parleur) |
| **Protocole** | ONVIF, RTSP |
| **Connexion** | WiFi 2.4/5GHz ou Ethernet |
| **Flux RTSP** | HD = `/11`, SD = `/12` |

### Checklist depart

- [ ] Boitier Jetson SmartEye (carte SD deja inseree, clonee depuis la Gold)
- [ ] Alimentation USB-C
- [ ] Cable Ethernet (RJ45) — 2 metres minimum
- [ ] Cameras IP (Ctronics) — autant que prevu pour ce client
- [ ] Alimentations cameras (12V)
- [ ] **Fiche credentials** (ID + Token + N site — recus par email)
- [ ] Smartphone avec **LucasApp** installe

!!! tip "Carte SD"
    La carte SD doit etre flashee depuis l'image Gold **avant** le deplacement.
    Voir [Clonage des cartes SD](clonage.md) pour la procedure.

---

## Sur site (chez le client)

### Etape 1 — Installer les cameras

**Avant de toucher au Jetson**, positionner et brancher toutes les cameras.

**Regles de positionnement** :

| Regle | Detail |
|-------|--------|
| Hauteur | 2 a 2,5 metres du sol (au-dessus des portes) |
| Angle | Plongee a ~30, couvrir le maximum de sol |
| Zones cibles | Salon, chambre, couloir — la ou le senior passe le plus de temps |
| Eviter | Contre-jour (fenetre dans le champ), reflets de miroirs |
| Branchement | Chaque camera a son alimentation + connectee au **reseau du client** (WiFi ou Ethernet) |

!!! info "Combien de cameras ?"
    Le systeme supporte jusqu'a **6 cameras par site**. Minimum recommande : 2 (salon + chambre).

**Verifier** que chaque camera est allumee et connectee au reseau du client avant de continuer.

---

### Etape 2 — Brancher et configurer le Jetson

#### Branchement physique

```
         Box Internet du client
              [  :::  ]
                 |
            Cable Ethernet
                 |
          [ Jetson SmartEye ] ← USB-C (alimentation)
```

1. Brancher le **cable Ethernet** entre le Jetson et la box internet
2. Brancher le **cable USB-C** (alimentation)
3. Attendre **1 minute** — la LED passe au vert fixe

#### Configuration depuis le smartphone

Se connecter au **meme WiFi** que le boitier, puis ouvrir dans le navigateur :

<div style="background: #263238; color: #80cbc4; padding: 16px; border-radius: 8px; font-size: 1.3em; text-align: center; font-family: monospace;">
http://smarteye.local:8080
</div>

<br/>

!!! tip "Ca ne marche pas ?"
    **Solution 1** — Ouvrir LucasApp > Parametres > **Installer un SmartEye**

    **Solution 2** — Scanner le **QR code** colle sous le boitier

#### Ecran 1/4 : Identification

Saisir les informations recues par email :

| Champ | Quoi mettre |
|-------|-------------|
| **ID Client** | L'identifiant recu par email |
| **Token** | Le mot de passe recu par email |
| **Nom du site** | Nom libre (ex: `Mme Dupont - Aleria`) |

#### Ecran 2/4 : Cameras

Le Jetson detecte les cameras automatiquement sur le reseau.

Pour chaque camera trouvee :

1. **Nommer la piece** (Salon, Chambre, Cuisine...)
2. Saisir les **identifiants** si demande (login/mot de passe de la camera)
3. Appuyer sur **Tester** — verifier que l'image s'affiche

!!! warning "Aucune camera detectee ?"
    - Les cameras sont-elles allumees ?
    - Sont-elles sur le **meme reseau** que le Jetson ?
    - Essayer de redemarrer la camera

#### Ecran 3/4 : Connexion serveur

Les valeurs sont **pre-remplies**. Ne rien modifier sauf indication contraire.

| Parametre | Valeur par defaut |
|-----------|-------------------|
| Serveur | `57.128.74.87` |
| Utilisateur | `debian` |
| N de site | Automatique |

Appuyer sur **Tester la connexion** — doit afficher un resultat vert.

#### Ecran 4/4 : Test final

Le systeme verifie toute la chaine automatiquement :

| Etape | Verification | Resultat |
|:-----:|-------------|:--------:|
| 1 | Connexion aux cameras | :material-check: |
| 2 | Detection IA (YOLO) | :material-check: |
| 3 | Tunnel vers le serveur | :material-check: |
| 4 | Envoi d'une image test | :material-check: |
| 5 | Notification recue sur le telephone | :material-check: |

Si tout est vert : appuyer sur **Terminer**.

Le Jetson passe en mode surveillance active.

---

## Avant de partir

### Etape 3 — Test de bout en bout

**Test obligatoire** — ne pas quitter le domicile sans l'avoir fait.

1. **Simuler une chute** : se coucher au sol devant une camera, rester immobile 30 secondes
2. **Verifier** la notification sur le telephone du technicien (LucasApp)
3. **Verifier** que l'image recue est nette et bien cadree
4. **Verifier** le flux video en direct dans LucasApp (toutes les cameras)
5. **Tester l'interphone** : parler dans l'app, verifier que le son sort de la camera

---

### Etape 4 — Configurer les telephones des aidants

Sur le telephone de **chaque aidant** (fils, fille, aide-soignant...) :

1. **Installer LucasApp** (Play Store / APK)
2. **Ouvrir l'app** — elle s'enregistre automatiquement aupres du serveur
3. **Verifier les notifications** : elles doivent etre autorisees dans les reglages du telephone
4. **Montrer le fonctionnement** :
    - Comment repondre a une alerte
    - Comment voir les cameras en direct
    - Comment utiliser l'interphone
    - Expliquer que le numero d'urgence (15 par defaut) est accessible depuis l'alerte

!!! success "Installation terminee"
    Le systeme est operationnel. Le Jetson fonctionne 24h/24, redemarre seul en cas de coupure de courant.
    Aucune intervention de l'aidant n'est necessaire au quotidien.

---

## Checklist de depart

Avant de quitter le domicile, cocher chaque point :

- [ ] Toutes les cameras sont fixees et alimentees
- [ ] Le Jetson est branche (Ethernet + USB-C)
- [ ] La LED du Jetson clignote rapidement (surveillance active)
- [ ] Le test de chute simulee a fonctionne
- [ ] Le flux video est visible dans LucasApp
- [ ] L'interphone fonctionne dans les deux sens
- [ ] **Chaque aidant** a LucasApp installe et les notifications activees
- [ ] Le boitier est place dans un endroit discret et ventile

---

## Depannage rapide

| Symptome | Cause probable | Solution |
|----------|---------------|----------|
| LED eteinte | Pas d'alimentation | Verifier le cable USB-C et l'adaptateur |
| `smarteye.local` ne repond pas | mDNS non supporte | Utiliser le scan LucasApp ou le QR code |
| Camera non detectee | Reseau different | Verifier que la camera est sur le meme reseau |
| Test serveur echoue | Pas d'internet | Verifier la connexion internet de la box client |
| Pas de notification | Notifications desactivees | Verifier les reglages du telephone de l'aidant |
| Image floue ou sombre | Mauvais positionnement | Repositionner la camera (hauteur, angle, eclairage) |
| Intercom muet | Camera sans audio | Verifier que la camera supporte l'audio bidirectionnel |

!!! info "Probleme non resolu ?"
    Consulter le [Guide expert](jetson-expert.md) pour un diagnostic technique approfondi.