# randy3227-cmd/kolotv architecture

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

- Interactive diagram: https://gitdiagram.com/randy3227-cmd/kolotv
- Repository: https://github.com/randy3227-cmd/kolotv

## Overview

KoloTV appears to be a Java EE business application for station operations, with inventory, sales, manufacturing, reservations, finance, and supporting web endpoints. The tree and sampled files suggest a principal goods workflow of product/recipe definition, fabrication or customer delivery, and resulting stock movements; the excerpts do not establish a single end-to-end user entry point. The graph preserves major domain areas visible in the tree and core-module index. Several links rely on indexed references rather than inspected implementations, so uncertain runtime wiring is omitted.

Main entry points: [`kolotv-ejb/src/java/vente/VenteDetails.java`](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/vente/VenteDetails.java) (Sale details), [`kolotv-ejb/src/java/stock/MvtStockFille.java`](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/stock/MvtStockFille.java) (Stock movement lines), [`kolotv-ejb/src/java/fabrication/Fabrication.java`](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/fabrication/Fabrication.java) (Fabrication), [`kolotv-ejb/src/java/produits/Ingredients.java`](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/produits/Ingredients.java) (Ingredients)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web endpoints"]
  node_chat_query["Chat query"]
  node_chat_response["Chat response"]
  node_notifications["Notifications"]
  node_user_ejb["User services<br/>[UserEJB.java]"]
end

subgraph group_inventory["Products and stock"]
  node_product_catalog["Product catalog<br/>[Produit.java]"]
  node_ingredients["Ingredients<br/>[Ingredients.java]"]
  node_recipes["Recipes<br/>[Recette.java]"]
  node_stock_movement["Stock movement<br/>[MvtStock.java]"]
  node_stock_lines["Stock movement lines<br/>[MvtStockFille.java]"]
  node_stock_state["Stock state<br/>[EtatStock.java]"]
end

subgraph group_operations["Operations"]
  node_fabrication["Fabrication<br/>[Fabrication.java]"]
  node_fabrication_lines["Fabrication lines"]
  node_sales["Sales<br/>[Vente.java]"]
  node_sale_lines["Sale details<br/>[VenteDetails.java]"]
  node_delivery["Customer delivery"]
  node_reservation["Reservations<br/>[Reservation.java]"]
end

subgraph group_finance["Finance and records"]
  node_supplier_invoice["Supplier invoices"]
  node_accounting["Accounting entries"]
  node_third_parties["Third parties<br/>[Tiers.java]"]
end

node_operator(("Operator"))
node_ai_service{{"Generative AI"}}
node_database[("Relational database")]

node_operator -->|"submits query"| node_chat_query
node_chat_query -->|"calls"| node_ai_service
node_operator -->|"requests updates"| node_notifications
node_notifications -->|"gets session user"| node_user_ejb
node_fabrication -->|"uses lines"| node_fabrication_lines
node_fabrication_lines -->|"decomposes"| node_ingredients
node_ingredients -->|"reads recipes"| node_recipes
node_fabrication -->|"references movement"| node_stock_movement
node_fabrication -->|"references movement lines"| node_stock_lines
node_delivery -->|"generates movement"| node_stock_movement
node_delivery -->|"generates lines"| node_stock_lines
node_stock_lines -->|"belongs to"| node_stock_movement
node_stock_lines -->|"references state"| node_stock_state
node_sales -->|"has details"| node_sale_lines
node_sale_lines -->|"references product"| node_product_catalog
node_sale_lines -->|"references ingredients"| node_ingredients
node_sale_lines -->|"references recipes"| node_recipes
node_sale_lines -->|"references movement lines"| node_stock_lines
node_supplier_invoice -->|"references ingredient"| node_ingredients
node_operator -.->|"manages reservations"| node_reservation
node_chat_response -->|"handles fabrication data"| node_fabrication
node_chat_query -->|"describes query schema"| node_sale_lines
node_notifications -->|"reads and writes"| node_database

click node_chat_query "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-war/src/java/servlet/chatbot/QueryGeneratorServlet.java"
click node_chat_response "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-war/src/java/servlet/chatbot/ResponseHandlerServlet.java"
click node_notifications "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-war/src/java/servlet/notification/NotificationController.java"
click node_user_ejb "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/user/UserEJB.java"
click node_product_catalog "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/annexe/Produit.java"
click node_ingredients "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/produits/Ingredients.java"
click node_recipes "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/produits/Recette.java"
click node_fabrication "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/fabrication/Fabrication.java"
click node_fabrication_lines "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/fabrication/FabricationFille.java"
click node_stock_movement "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/stock/MvtStock.java"
click node_stock_lines "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/stock/MvtStockFille.java"
click node_stock_state "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/stock/EtatStock.java"
click node_sales "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/vente/Vente.java"
click node_sale_lines "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/vente/VenteDetails.java"
click node_delivery "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/vente/As_BondeLivraisonClient.java"
click node_reservation "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/reservation/Reservation.java"
click node_supplier_invoice "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/faturefournisseur/FactureFournisseurDetails.java"
click node_accounting "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/mg/cnaps/compta/ComptaSousEcriture.java"
click node_third_parties "https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/pertegain/Tiers.java"

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_chat_query,node_chat_response,node_notifications,node_user_ejb toneBlue
class node_product_catalog,node_ingredients,node_recipes,node_stock_movement,node_stock_lines,node_stock_state,node_database toneAmber
class node_fabrication,node_fabrication_lines,node_sales,node_sale_lines,node_delivery,node_reservation toneMint
class node_supplier_invoice,node_accounting,node_third_parties toneRose
class node_operator,node_ai_service toneIndigo
```

## Components

### Web endpoints

- [Chat query](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-war/src/java/servlet/chatbot/QueryGeneratorServlet.java): `kolotv-war/src/java/servlet/chatbot/QueryGeneratorServlet.java`
- [Chat response](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-war/src/java/servlet/chatbot/ResponseHandlerServlet.java): `kolotv-war/src/java/servlet/chatbot/ResponseHandlerServlet.java`
- [Notifications](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-war/src/java/servlet/notification/NotificationController.java): `kolotv-war/src/java/servlet/notification/NotificationController.java`
- [User services](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/user/UserEJB.java): `kolotv-ejb/src/java/user/UserEJB.java`

### Products and stock

- [Product catalog](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/annexe/Produit.java): `kolotv-ejb/src/java/annexe/Produit.java`
- [Ingredients](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/produits/Ingredients.java): `kolotv-ejb/src/java/produits/Ingredients.java`
- [Recipes](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/produits/Recette.java): `kolotv-ejb/src/java/produits/Recette.java`
- [Stock movement](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/stock/MvtStock.java): `kolotv-ejb/src/java/stock/MvtStock.java`
- [Stock movement lines](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/stock/MvtStockFille.java): `kolotv-ejb/src/java/stock/MvtStockFille.java`
- [Stock state](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/stock/EtatStock.java): `kolotv-ejb/src/java/stock/EtatStock.java`

### Operations

- [Fabrication](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/fabrication/Fabrication.java): `kolotv-ejb/src/java/fabrication/Fabrication.java`
- [Fabrication lines](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/fabrication/FabricationFille.java): `kolotv-ejb/src/java/fabrication/FabricationFille.java`
- [Sales](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/vente/Vente.java): `kolotv-ejb/src/java/vente/Vente.java`
- [Sale details](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/vente/VenteDetails.java): `kolotv-ejb/src/java/vente/VenteDetails.java`
- [Customer delivery](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/vente/As_BondeLivraisonClient.java): `kolotv-ejb/src/java/vente/As_BondeLivraisonClient.java`
- [Reservations](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/reservation/Reservation.java): `kolotv-ejb/src/java/reservation/Reservation.java`

### Finance and records

- [Supplier invoices](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/faturefournisseur/FactureFournisseurDetails.java): `kolotv-ejb/src/java/faturefournisseur/FactureFournisseurDetails.java`
- [Accounting entries](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/mg/cnaps/compta/ComptaSousEcriture.java): `kolotv-ejb/src/java/mg/cnaps/compta/ComptaSousEcriture.java`
- [Third parties](https://github.com/randy3227-cmd/kolotv/blob/main/kolotv-ejb/src/java/pertegain/Tiers.java): `kolotv-ejb/src/java/pertegain/Tiers.java`

### Other components

- **Operator**
- **Generative AI**
- **Relational database**

## Connections

- Operator → Chat query: submits query (evidence: `kolotv-war/src/java/servlet/chatbot/QueryGeneratorServlet.java`)
- Chat query → Generative AI: calls (evidence: `kolotv-war/src/java/servlet/chatbot/QueryGeneratorServlet.java`)
- Operator → Notifications: requests updates (evidence: `kolotv-war/src/java/servlet/notification/NotificationController.java`)
- Notifications → User services: gets session user (evidence: `kolotv-war/src/java/servlet/notification/NotificationController.java`)
- Fabrication → Fabrication lines: uses lines (evidence: `kolotv-ejb/src/java/fabrication/Fabrication.java`)
- Fabrication lines → Ingredients: decomposes (evidence: `kolotv-ejb/src/java/fabrication/FabricationFille.java`)
- Ingredients → Recipes: reads recipes (evidence: `kolotv-ejb/src/java/produits/Ingredients.java`)
- Fabrication → Stock movement: references movement (evidence: `kolotv-ejb/src/java/fabrication/Fabrication.java`)
- Fabrication → Stock movement lines: references movement lines (evidence: `kolotv-ejb/src/java/fabrication/Fabrication.java`)
- Customer delivery → Stock movement: generates movement (evidence: `kolotv-ejb/src/java/vente/As_BondeLivraisonClient.java`)
- Customer delivery → Stock movement lines: generates lines (evidence: `kolotv-ejb/src/java/vente/As_BondeLivraisonClient.java`)
- Stock movement lines → Stock movement: belongs to (evidence: `kolotv-ejb/src/java/stock/MvtStockFille.java`)
- Stock movement lines → Stock state: references state (evidence: `kolotv-ejb/src/java/stock/MvtStockFille.java`)
- Sales → Sale details: has details (evidence: `kolotv-ejb/src/java/vente/VenteDetails.java`)
- Sale details → Product catalog: references product (evidence: `kolotv-ejb/src/java/vente/VenteDetails.java`)
- Sale details → Ingredients: references ingredients (evidence: `kolotv-ejb/src/java/vente/VenteDetails.java`)
- Sale details → Recipes: references recipes (evidence: `kolotv-ejb/src/java/vente/VenteDetails.java`)
- Sale details → Stock movement lines: references movement lines (evidence: `kolotv-ejb/src/java/vente/VenteDetails.java`)
- Supplier invoices → Ingredients: references ingredient (evidence: `kolotv-ejb/src/java/faturefournisseur/FactureFournisseurDetails.java`)
- Operator → Reservations: manages reservations
- Chat response → Fabrication: handles fabrication data (evidence: `kolotv-war/src/java/servlet/chatbot/ResponseHandlerServlet.java`)
- Chat query → Sale details: describes query schema (evidence: `kolotv-war/src/java/servlet/chatbot/QueryGeneratorServlet.java`)
- Notifications → Relational database: reads and writes (evidence: `kolotv-war/src/java/servlet/notification/NotificationController.java`)
