feat: Replace warehouse product groups with hierarchical categories and update related UI and API.

This commit is contained in:
2025-12-12 13:34:52 +01:00
parent 54cf1ff276
commit 08256f0019
18 changed files with 10153 additions and 2 deletions

View File

@@ -0,0 +1,39 @@
# Implementazione Gruppi Merceologici Magazzino
## Richiesta
Implementare la gestione dei gruppi merceologici per la categorizzazione degli articoli nel modulo magazzino, sia backend che frontend.
## Stato Attuale
- Esiste già una gestione di "Categorie Articoli" (`WarehouseArticleCategory`) che è gerarchica.
- "Gruppi Merceologici" (`WarehouseProductGroup`) sarà una nuova entità, probabilmente una classificazione parallela non gerarchica (o piatta) spesso usata per fini statistici o contabili, o semplicemente come raggruppamento alternativo.
## Piano di Lavoro
### Backend
1. **Domain Layer**
- Creare entità `WarehouseProductGroup` in `Zentral.Domain.Entities.Warehouse`.
- Campi: Code, Name, Description, IsActive.
- Aggiornare `WarehouseArticle` aggiungendo FK `ProductGroupId` e navigation property.
2. **Infrastructure Layer**
- Aggiungere `DbSet<WarehouseProductGroup>` in `ApplicationDbContext`.
- Configurare le relazioni entity framework se necessario.
- Creare Migrazione `AddWarehouseProductGroups`.
3. **Service Layer**
- Aggiornare `IWarehouseService` e `WarehouseService` con i metodi CRUD per i gruppi merceologici.
4. **API Layer**
- Creare `WarehouseProductGroupsController`.
- Aggiornare DTOs degli articoli per includere `ProductGroupId`.
### Frontend
1. **Services**
- Creare `productGroupService.ts` per chiamare le API.
2. **Pages**
- Creare `ProductGroupsPage` per elenco e gestione (CRUD).
3. **Components**
- Aggiornare il form di creazione/modifica articolo per permettere la selezione del gruppo merceologico.
4. **Routing & Navigation**
- Aggiungere rotta per `ProductGroupsPage`.
- Aggiungere voce di menu nella sidebar del magazzino.
## Note
- L'implementazione seguirà lo stile esistente del modulo Warehouse, usando Services e Controllers.

View File

@@ -0,0 +1,34 @@
# Sostituzione Gruppi Merceologici con Categorie Gerarchiche
## Stato Corrente
IMPLEMENTATO
## Descrizione
Sostituita la gestione separata dei "Gruppi Merceologici" con l'utilizzo potenziato delle Categorie Articoli (`WarehouseArticleCategory`) già esistenti e gerarchiche.
## Modifiche Apportate
### Backend
- **Revert**: Rimossa entity `WarehouseProductGroup` e relativi controller e service.
- **Migration**: Creata e applicata migrazione `RemoveWarehouseProductGroups` per rimuovere la tabella dal database.
- **Services**: `WarehouseService` ripulito da logica `ProductGroups`.
### Frontend
- **Revert**: Rimossa pagina `ProductGroupsPage` e riferimenti nel codice.
- **New Feature**: Creata pagina `CategoriesPage` (`/warehouse/categories`) per gestire le categorie in modalità albero.
- Create
- Update
- Delete
- Struttura gerarchica visualizzata (Tree View).
- **Article Form**: Rimossa selezione "Gruppo Merceologico". La selezione della categoria utilizza `CategoryTree` appiattito per la selezione.
- **Navigation**: Aggiunto link "Categorie" nella sidebar del Magazzino.
## Note Tecniche
- La gestione delle categorie sfrutta la ricorsività supportata dall'entity `WarehouseArticleCategory`.
- L'interfaccia utente permette di gestire la gerarchia creando categorie "root" o sottocategorie.
## Verifica
- **Backend API**:
- `GET /api/warehouse/categories` -> Disponibile.
- `GET /api/warehouse/categories/tree` -> Disponibile (ritorna JSON corretto).
- `GET /api/warehouse/product-groups` -> **404 Not Found** (Correttamente rimosso).