add ent schemas and project docs

doc_dev/05_analyse_detaillee.md

@@ -0,0 +1,80 @@
+# Analyse detaillee des consignes
+
+## Objectif du projet
+MatosBox est une application self-hosted d'inventaire de materiel (electronique, informatique, outillage, cuisine). L'app vise ~5000 objets, avec un focus sur simplicite, portabilite et extensibilite.
+
+## Langue et conventions
+- UI, messages et commentaires de code en francais.
+- Noms de tables et base en francais.
+- Timezone cible : Europe/Paris.
+
+## Structure projet (mono-repo)
+- `backend/` : application Go (Gin + Ent)
+- `frontend/` : Nuxt 3 / Vue 3
+- `data/` : DB + pieces jointes + backups
+- `docs/` : documentation Vitepress
+- `migrations/` : scripts Goose/Atlas
+- fichiers racine : `.gitlab-ci.yml`, `Taskfile.yml`, `docker-compose.yml`, `README.md`, `LICENSE`
+
+## Outils de developpement
+Backend
+- Go 1.23+
+- Gin (router HTTP)
+- Ent (ORM + schema)
+- Migrations : Goose ou Atlas
+
+Frontend
+- Vue 3 + Nuxt.js (SSR/PWA)
+- Tailwind CSS + shadcn-vue
+- pnpm
+
+Infra / DevOps
+- Docker + Docker Compose
+- GitLab CI
+- Vitepress (docs)
+- Weblate (i18n)
+- Swaggo (Swagger)
+
+## Backend - attentes clefs
+- API REST versionnee `/v1`.
+- CRUD Objets/Categories/Emplacements.
+- Upload multiple : `POST /v1/objets/{id}/pieces_jointes`.
+- Gestion pieces jointes (images, PDF, Markdown).
+- Services annexes : QR, scan hardware (lsusb/lspci) dans une sandbox.
+- Auth JWT (securite).
+
+## Frontend - attentes clefs
+- Pages principales : `/objets`, `/objets/[id]`, `/emplacements`.
+- Composants : `ObjetCard`, `FileUploader`, `MarkdownEditor`, `ThemeToggle`.
+- Modals pour ajout rapide, upload, analyse commande.
+- Themes : light, dark, monokai, gruvbox-dark (default style seventies).
+- Footer : version backend + frontend.
+- Onglets : settings (config.json), debug (logs).
+
+## Pieces jointes
+- Multi-upload d'images/PDF/MD.
+- Thumbnails + image principale.
+- Stockage disque (ex: `data/pieces_jointes/`).
+- Association via table `PieceJointe`.
+
+## Exigences BDD
+- SQLite par defaut, Postgres optionnel.
+- Tables en francais.
+- Arbres recursifs pour `Categorie` et `Emplacement`.
+- Champs customs via `ChampPersonnalise`.
+
+## Tests
+- Go test (unitaires backend).
+- Vitest (frontend).
+- Cypress (E2E).
+- Tests specifiques sur parsing lspci/lsusb et imports CSV.
+
+## Contraintes Git
+- Commit et push apres chaque etape clef.
+- Token Gitea dans `doc_dev/.env`.
+
+## Risques / points sensibles
+- Conception Ent en francais + relations.
+- Migration SQLite -> Postgres.
+- Upload multi-fichiers et securite MIME.
+- Limites d'upload (50MB/fichier).

doc_dev/06_etape2_schemas.md

@@ -0,0 +1,19 @@
+# Etape 2 - Schemas Ent (realise)
+
+## Objectif
+Mettre en place les schemas Ent en francais pour : Objet, Categorie, Emplacement.
+
+## Fichiers ajoutes
+- `backend/internal/data/ent/schema/objet.go`
+- `backend/internal/data/ent/schema/categorie.go`
+- `backend/internal/data/ent/schema/emplacement.go`
+
+## Points cles
+- Identifiants UUID par defaut.
+- Champs principaux conformes aux consignes.
+- Arbres recursifs pour Categorie et Emplacement via `parent_id`.
+- Timestamps `created_at` et `updated_at`.
+
+## A faire ensuite
+- Generer le code Ent + migrations.
+- Ajouter les schemas manquants (PieceJointe, LienObjetEmplacement, etc.).

doc_dev/structure_bdd.md

@@ -0,0 +1,124 @@
+# Structure BDD - MatosBox (reference)
+
+## Base
+- SQLite par defaut : `matosbox.db`
+- Postgres optionnel : base `matosbox`
+
+## Tables principales
+
+### Objet
+Champs :
+- id
+- nom
+- description
+- quantite
+- prix_achat
+- date_achat
+- boutique
+- numero_serie
+- numero_modele
+- fabricant
+- statut (enum: en_stock, pret, hors_service, archive)
+- caracteristiques (JSONB)
+
+Relations :
+- 1..n `PieceJointe`
+- 1..n `ChampPersonnalise`
+- n..n `Emplacement` via `LienObjetEmplacement`
+
+### Categorie
+Champs :
+- id
+- nom
+- parent_id
+- slug
+- icone
+
+Relations :
+- auto-reference (parent/enfant)
+
+### Emplacement
+Champs :
+- id
+- nom
+- parent_id
+- slug
+- piece
+- meuble
+- numero_boite
+- icone
+
+Relations :
+- auto-reference (parent/enfant)
+
+### LienObjetEmplacement
+Champs :
+- id
+- objet_id
+- emplacement_id
+- type (enum: stocke, utilise_dans)
+
+### ChampPersonnalise
+Champs :
+- id
+- objet_id
+- nom_champ
+- type_champ (string/int/bool/date)
+- valeur
+- unite
+
+### PieceJointe
+Champs :
+- id
+- objet_id
+- nom_fichier
+- chemin
+- type_mime
+- est_principale
+- categorie (image/pdf_notice/markdown_tuto)
+
+### HistoriqueAchat
+Champs :
+- id
+- objet_id
+- boutique
+- numero_commande
+- prix
+- date
+- quantite
+
+### Pret
+Champs :
+- id
+- objet_id
+- a_utilisateur
+- date_debut
+- date_fin
+- notes
+
+### MouvementStock
+Champs :
+- id
+- objet_id
+- delta_quantite
+- raison
+- date
+
+### Garantie
+Champs :
+- id
+- objet_id
+- fournisseur
+- duree_mois
+- date_debut
+- preuve (piece_jointe_id)
+
+## Relations notables
+- Arbres recursifs pour `Categorie` et `Emplacement`.
+- Historique achats, prets et mouvements relies a `Objet`.
+- Pieces jointes liees a `Objet`.
+
+## Notes migration
+- Migrations via Goose/Atlas.
+- SQLite WAL a activer.
+- Export/Import via CSV/JSON ou pgloader pour Postgres.