matosbox/doc_dev/01_analyse.md

Analyse - MatosBox

Contexte

MatosBox est une application open-source self-hosted pour inventorier du materiel (electronique, informatique, outillage, cuisine). L'app vise ~5000 objets, avec simplicite, portabilite et extensibilite.

Contraintes et consignes

• Langue : interface, messages et commentaires de code en francais. Noms des tables en francais.
• Backend : Go 1.23+, Gin, Ent, SQLite par defaut, Postgres optionnel.
• API : REST, endpoint upload multiple /v1/objets/{id}/pieces_jointes.
• Pieces jointes : images, PDF, Markdown.
• Schema : tables Objet, Categorie, Emplacement (noms FR), relations hierarchiques.
• Depot : gitea.maison43.duckdns.org/gilles/matosbox.git. Commit/push apres etapes clefs (token non fourni).
• Dossiers : backend/, frontend/, data/, docs/, migrations/.

Fonctions coeur (MVP)

• CRUD Objets, Categories, Emplacements.
• Pieces jointes multiples par objet.
• Recherche et filtres de base.

Risques / points d'attention

• Definition precise des schemas Ent en francais (noms et relations).
• Gestion multi-fichiers (taille, types MIME, stockage disque).
• Migration SQLite <-> Postgres.

Livrables demandes

• Brainstorming et plan de dev.
• Fichiers intermediaires par etapes dans doc_dev/.
• Debut du developpement (progressif, par etapes).