[ADD] claude: add /mobile slash command for mobile dev guidance

Provides Claude Code with structured context about the ERPLibre Home Mobile project (OWL 2, Capacitor 8, Vite, Vitest, SQLite) including stack, conventions, commands, and migration patterns. Generated by Claude Code 2.1.108 model claude-sonnet-4-6 Co-Authored-By: Mathieu Benoit <mathben@technolibre.ca>
2026-04-14 23:24:41 -04:00 · 2026-04-14 23:24:41 -04:00 · 0c3fedeb79
commit 0c3fedeb79
parent 15a8229a01
1 changed files with 112 additions and 0 deletions
--- a/.claude/commands/mobile.md
+++ b/.claude/commands/mobile.md
@ -0,0 +1,112 @@
+# /mobile — Guide de développement mobile ERPLibre
+
+Tu travailles sur l'application mobile ERPLibre Home.
+
+**Répertoire de travail :** `mobile/erplibre_home_mobile/`
+
+---
+
+## Stack technique
+
+| Couche | Technologie |
+|--------|-------------|
+| UI | OWL 2.x (`@odoo/owl`) |
+| Natif | Capacitor 8 |
+| Build | Vite 6 |
+| Tests | Vitest 3 |
+| Lang | TypeScript |
+| DB | SQLite (`@capacitor-community/sqlite`) |
+| i18n | `src/i18n/fr.ts` + `src/i18n/en.ts` |
+
+---
+
+## Structure `src/`
+
+```
+src/
+├── components/       # Composants OWL (1 dossier par composant)
+│   ├── <nom>/        # <nom>_component.ts + <nom>_component.scss
+│   └── ...
+├── services/         # Logique métier + accès DB
+├── models/           # Interfaces TypeScript (Note, Tag, Server…)
+├── plugins/          # Wrappers Capacitor natifs
+├── i18n/             # Traductions fr.ts / en.ts / index.ts
+├── constants/        # Constantes partagées
+├── utils/            # Utilitaires purs
+├── __tests__/        # Tests Vitest (un fichier par service)
+└── __mocks__/        # Mocks Capacitor pour les tests
+```
+
+---
+
+## Conventions
+
+### Composants OWL
+- Nom de fichier : `snake_case_component.ts` + `.scss`
+- Classe : `PascalCaseComponent extends Component`
+- Template inline via `xml\`...\`` (pas de fichiers XML séparés)
+- Générer un nouveau composant :
+  ```bash
+  cd mobile/erplibre_home_mobile
+  npm run gencomp -- <NomComposant> [chemin/relatif]
+  # Exemple : npm run gencomp -- NoteEditor note/editor
+  ```
+
+### Services
+- Une classe par service, instanciée en singleton dans `appService.ts`
+- Méthodes `async`/`await`, pas de callbacks
+- Accès DB uniquement via `DatabaseService`
+
+### Migrations DB
+- Format version : `YYYYMMDDNN` (ex: `2026041401`)
+- Fichiers dans `src/services/migrations/`
+- Chaque migration : classe avec `version`, `up()`, et description
+- `MigrationService` gère l'ordre et l'historique
+
+### i18n
+- Clés dans `src/i18n/fr.ts` et `src/i18n/en.ts`
+- Utiliser `t("clé")` via l'import de `src/i18n/index.ts`
+- Langue par défaut : français
+
+### Tests
+- Un fichier `<service>.test.ts` par service dans `src/__tests__/`
+- Mocks Capacitor dans `src/__mocks__/`
+- Lancer : `npm test` (dans `mobile/erplibre_home_mobile/`)
+
+---
+
+## Commandes essentielles
+
+```bash
+# Depuis mobile/erplibre_home_mobile/
+npm install              # Installer dépendances
+npm run build            # Build production
+npm run build:dev        # Build développement
+npm run start            # Dev server web
+npm test                 # Vitest (tests unitaires)
+
+# BSR = Build + Sync + Run (Android)
+npm run bsr              # node scripts/bsr.js
+
+# Capacitor
+npx cap sync             # Sync web → natif
+npx cap run android      # Lancer sur Android
+npx cap open android     # Ouvrir Android Studio
+```
+
+---
+
+## Points d'attention
+
+- **Pas d'Ionic** — UI 100% OWL + CSS/SCSS custom
+- **Plugins natifs** dans `src/plugins/` : wrapper TS autour des plugins Capacitor
+- **Biométrie** : `@aparajita/capacitor-biometric-auth` (auth locale sans serveur)
+- **Stockage sécurisé** : `capacitor-secure-storage-plugin` (tokens, clés)
+- **SQLite** : toujours passer par `DatabaseService`, jamais directement
+- **Offline-first** : sync avec ERPLibre via `syncService.ts`
+
+---
+
+## Tâche demandée
+
+$ARGUMENTS