# fifalianacake/aquanova architecture

> Architecture diagram of the GitHub repository fifalianacake/aquanova, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fifalianacake/aquanova
- Repository: https://github.com/fifalianacake/aquanova

## Overview

Aquanova is an aquaculture farm-management application. The main operational workflow is managing fish lots in ponds, tracking growth and farm events, then forecasting harvest and recording sales; feeding, water-quality, stock, and profitability checks also support alerts. The tree shows Spring-style controller, service, and repository layers across production, purchasing, inventory, sales, finance, and reference data. The README is empty, so broader capabilities come from the source tree. Arrows without excerpted call evidence are omitted; dashed links mark likely entry or integration relationships not verified in the sampled source.

Main entry points: [`src/main/java/mg/itu/aquanova/production/services/LotService.java`](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/production/services/LotService.java) (Lot lifecycle), [`src/main/java/mg/itu/aquanova/alerte/services/AnalyseVerificationService.java`](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/alerte/services/AnalyseVerificationService.java) (Alert analysis), [`src/main/java/mg/itu/aquanova/production/repositories/LotRepository.java`](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/production/repositories/LotRepository.java) (Lot records), [`src/main/java/mg/itu/aquanova/alimentation/services/DistributionService.java`](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/alimentation/services/DistributionService.java) (Feed distribution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_production["Production"]
  node_lot_ui["Lot management<br/>[LotController.java]"]
  node_lot_service["Lot lifecycle<br/>[LotService.java]"]
  node_lot_store[("Lot records<br/>[LotRepository.java]")]
  node_production_events["Growth and harvest"]
end

subgraph group_farm_ops["Farm operations"]
  node_feeding["Feed distribution"]
  node_feed_inventory["Feed inventory<br/>[StockService.java]"]
  node_feed_store[("Feed records")]
  node_water_equipment["Water and equipment"]
  node_alerts["Alert analysis"]
  node_alert_service["Alert management<br/>[AlerteService.java]"]
end

subgraph group_commerce["Commerce and finance"]
  node_purchasing["Purchases and expenses"]
  node_sales["Sales and clients<br/>[VenteService.java]"]
  node_sales_store[("Sales records")]
  node_profitability["Lot profitability"]
  node_finance_forecast["Harvest finance"]
end

subgraph group_shared["Shared services"]
  node_reference["Farm references"]
  node_reference_store[("Reference records")]
  node_settings["System settings"]
end

subgraph group_insights["Insights and exchange"]
  node_dashboard["Farm dashboard"]
  node_data_exchange["Import and export"]
end

node_operator(("Farm operator"))

node_operator -.->|"manages lots"| node_lot_ui
node_lot_ui -.->|"submits requests"| node_lot_service
node_lot_service -->|"reads and saves"| node_lot_store
node_lot_service -->|"checks pond status"| node_reference_store
node_lot_service -->|"uses pond data"| node_reference
node_production_events -.->|"updates lot state"| node_lot_service
node_feeding -->|"reads lot data"| node_lot_store
node_feeding -->|"records distribution"| node_feed_store
node_feeding -->|"updates movement"| node_feed_inventory
node_alerts -->|"reads thresholds"| node_settings
node_alerts -->|"creates alerts"| node_alert_service
node_alerts -->|"estimates consumption"| node_feed_inventory
node_alerts -->|"checks margins"| node_profitability
node_water_equipment -.->|"checks water readings"| node_alerts
node_purchasing -->|"creates stocked lots"| node_lot_service
node_sales -->|"reads and saves"| node_sales_store
node_sales -->|"uses harvest records"| node_production_events
node_finance_forecast -->|"uses lot margins"| node_profitability
node_dashboard -->|"loads alerts"| node_alert_service
node_dashboard -->|"loads lot data"| node_lot_store
node_data_exchange -.->|"resolves lots"| node_lot_store

click node_lot_ui "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/production/controllers/LotController.java"
click node_lot_service "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/production/services/LotService.java"
click node_lot_store "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/production/repositories/LotRepository.java"
click node_production_events "https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/production/services"
click node_reference "https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/referentiel"
click node_reference_store "https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/referentiel/repositories"
click node_purchasing "https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/achat/services"
click node_feeding "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/alimentation/services/DistributionService.java"
click node_feed_inventory "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/alimentation/services/StockService.java"
click node_feed_store "https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/alimentation/repositories"
click node_water_equipment "https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/sanitaire_equipement/services"
click node_alerts "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/alerte/services/AnalyseVerificationService.java"
click node_alert_service "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/alerte/services/AlerteService.java"
click node_sales "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/vente/services/VenteService.java"
click node_sales_store "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/vente/repositories/VenteRepository.java"
click node_profitability "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/finance/services/RentabiliteLotService.java"
click node_finance_forecast "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/finance/services/SimulationRecolteService.java"
click node_settings "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/admin/service/ParametreSystemeService.java"
click node_dashboard "https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/dashboard/services/AccueilDashboardService.java"
click node_data_exchange "https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/import_excel/services"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_lot_ui,node_lot_service,node_lot_store,node_production_events toneBlue
class node_feeding,node_feed_inventory,node_feed_store,node_water_equipment,node_alerts,node_alert_service toneAmber
class node_purchasing,node_sales,node_sales_store,node_profitability,node_finance_forecast toneMint
class node_reference,node_reference_store,node_settings toneRose
class node_dashboard,node_data_exchange,node_operator toneIndigo
```

## Components

### Production

- [Lot management](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/production/controllers/LotController.java): `src/main/java/mg/itu/aquanova/production/controllers/LotController.java`
- [Lot lifecycle](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/production/services/LotService.java): `src/main/java/mg/itu/aquanova/production/services/LotService.java`
- [Lot records](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/production/repositories/LotRepository.java): `src/main/java/mg/itu/aquanova/production/repositories/LotRepository.java`
- [Growth and harvest](https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/production/services): `src/main/java/mg/itu/aquanova/production/services`

### Farm operations

- [Feed distribution](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/alimentation/services/DistributionService.java): `src/main/java/mg/itu/aquanova/alimentation/services/DistributionService.java`
- [Feed inventory](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/alimentation/services/StockService.java): `src/main/java/mg/itu/aquanova/alimentation/services/StockService.java`
- [Feed records](https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/alimentation/repositories): `src/main/java/mg/itu/aquanova/alimentation/repositories`
- [Water and equipment](https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/sanitaire_equipement/services): `src/main/java/mg/itu/aquanova/sanitaire_equipement/services`
- [Alert analysis](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/alerte/services/AnalyseVerificationService.java): `src/main/java/mg/itu/aquanova/alerte/services/AnalyseVerificationService.java`
- [Alert management](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/alerte/services/AlerteService.java): `src/main/java/mg/itu/aquanova/alerte/services/AlerteService.java`

### Commerce and finance

- [Purchases and expenses](https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/achat/services): `src/main/java/mg/itu/aquanova/achat/services`
- [Sales and clients](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/vente/services/VenteService.java): `src/main/java/mg/itu/aquanova/vente/services/VenteService.java`
- [Sales records](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/vente/repositories/VenteRepository.java): `src/main/java/mg/itu/aquanova/vente/repositories/VenteRepository.java`
- [Lot profitability](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/finance/services/RentabiliteLotService.java): `src/main/java/mg/itu/aquanova/finance/services/RentabiliteLotService.java`
- [Harvest finance](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/finance/services/SimulationRecolteService.java): `src/main/java/mg/itu/aquanova/finance/services/SimulationRecolteService.java`

### Shared services

- [Farm references](https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/referentiel): `src/main/java/mg/itu/aquanova/referentiel`
- [Reference records](https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/referentiel/repositories): `src/main/java/mg/itu/aquanova/referentiel/repositories`
- [System settings](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/admin/service/ParametreSystemeService.java): `src/main/java/mg/itu/aquanova/admin/service/ParametreSystemeService.java`

### Insights and exchange

- [Farm dashboard](https://github.com/fifalianacake/aquanova/blob/main/src/main/java/mg/itu/aquanova/dashboard/services/AccueilDashboardService.java): `src/main/java/mg/itu/aquanova/dashboard/services/AccueilDashboardService.java`
- [Import and export](https://github.com/fifalianacake/aquanova/tree/main/src/main/java/mg/itu/aquanova/import_excel/services): `src/main/java/mg/itu/aquanova/import_excel/services`

### Other components

- **Farm operator**

## Connections

- Farm operator → Lot management: manages lots
- Lot management → Lot lifecycle: submits requests
- Lot lifecycle → Lot records: reads and saves (evidence: `src/main/java/mg/itu/aquanova/production/services/LotService.java`)
- Lot lifecycle → Reference records: checks pond status (evidence: `src/main/java/mg/itu/aquanova/production/services/LotService.java`)
- Lot lifecycle → Farm references: uses pond data (evidence: `src/main/java/mg/itu/aquanova/production/services/LotService.java`)
- Growth and harvest → Lot lifecycle: updates lot state (evidence: `src/main/java/mg/itu/aquanova/production/services/TransfertService.java`)
- Feed distribution → Lot records: reads lot data (evidence: `src/main/java/mg/itu/aquanova/alimentation/services/DistributionService.java`)
- Feed distribution → Feed records: records distribution (evidence: `src/main/java/mg/itu/aquanova/alimentation/services/DistributionService.java`)
- Feed distribution → Feed inventory: updates movement (evidence: `src/main/java/mg/itu/aquanova/alimentation/services/DistributionService.java`)
- Alert analysis → System settings: reads thresholds (evidence: `src/main/java/mg/itu/aquanova/alerte/services/AnalyseVerificationService.java`)
- Alert analysis → Alert management: creates alerts (evidence: `src/main/java/mg/itu/aquanova/alerte/services/AnalyseVerificationService.java`)
- Alert analysis → Feed inventory: estimates consumption (evidence: `src/main/java/mg/itu/aquanova/alerte/services/AnalyseVerificationService.java`)
- Alert analysis → Lot profitability: checks margins (evidence: `src/main/java/mg/itu/aquanova/alerte/services/AnalyseVerificationService.java`)
- Water and equipment → Alert analysis: checks water readings (evidence: `src/main/java/mg/itu/aquanova/sanitaire_equipement/services/ReleveEauService.java`)
- Purchases and expenses → Lot lifecycle: creates stocked lots (evidence: `src/main/java/mg/itu/aquanova/achat/services/AchatAlevinService.java`)
- Sales and clients → Sales records: reads and saves (evidence: `src/main/java/mg/itu/aquanova/vente/services/VenteService.java`)
- Sales and clients → Growth and harvest: uses harvest records (evidence: `src/main/java/mg/itu/aquanova/vente/services/VenteService.java`)
- Harvest finance → Lot profitability: uses lot margins (evidence: `src/main/java/mg/itu/aquanova/finance/services/SimulationRecolteService.java`)
- Farm dashboard → Alert management: loads alerts (evidence: `src/main/java/mg/itu/aquanova/dashboard/services/AccueilDashboardService.java`)
- Farm dashboard → Lot records: loads lot data (evidence: `src/main/java/mg/itu/aquanova/dashboard/services/AccueilDashboardService.java`)
- Import and export → Lot records: resolves lots (evidence: `src/main/java/mg/itu/aquanova/import_excel/services/ImportDonneesService.java`)
