# virtual-vision-synergy/valimbavaka architecture

> Architecture diagram of the GitHub repository virtual-vision-synergy/valimbavaka, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/virtual-vision-synergy/valimbavaka
- Repository: https://github.com/virtual-vision-synergy/valimbavaka

## Overview

Valimbavaka is a business-management application with an Angular UI and Spring backend. Users enter through authenticated, permission-checked routes to operational modules such as sales, stock, deliveries, production, business-day management, commissions, and reporting. A demonstrated backend path handles paged sales reads: the controller builds a filter, the service scopes and pages the query, and the repository fetches matching sales. The README provides no product detail, so broader capabilities come from the module tree and route declarations; unverified backend wiring is omitted.

Main entry points: [`valimbavaka-ui/src/app/app.routes.ts`](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/app.routes.ts) (Application routes), [`valimbavaka-ui/src/app/features/articles/articles.routes.ts`](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/articles/articles.routes.ts) (Articles), [`valimbavaka-ui/src/app/features/commissions/commissions.routes.ts`](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/commissions/commissions.routes.ts) (Commission screens), [`valimbavaka-ui/src/app/features/services/services.routes.ts`](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/services/services.routes.ts) (Service screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web application"]
  node_app_routes["Application routes<br/>[app.routes.ts]"]
  node_article_ui["Articles<br/>[articles.routes.ts]"]
  node_commission_ui["Commission screens"]
  node_services_ui["Service screens<br/>[services.routes.ts]"]
  node_auth_ui["Authentication UI<br/>[auth-service.ts]"]
  node_sales_ui["Sales screens<br/>[sales.routes.ts]"]
  node_day_ui["Business day UI<br/>[day.routes.ts]"]
  node_stock_ui["Stock screens<br/>[stocks.routes.ts]"]
  node_delivery_ui["Delivery screens"]
end

subgraph group_operations["Operations"]
  node_article_core["Article catalog"]
  node_inventory["Inventory"]
  node_production["Production"]
  node_delivery["Delivery orders"]
  node_business_day["Business day"]
end

subgraph group_finance["Sales and finance"]
  node_sales_controller["Sales query API"]
  node_sales_service["Sales query service"]
  node_sales_repo[("Sales query store")]
  node_commissions["Commissions"]
end

subgraph group_platform["Identity and insights"]
  node_auth_backend["Authentication services<br/>[AuthService.java]"]
  node_dashboard["Dashboard and reports"]
  node_journal["Journal"]
end

node_staff(("Staff user"))

node_staff -.->|"opens"| node_app_routes
node_app_routes -->|"loads"| node_article_ui
node_app_routes -->|"loads"| node_commission_ui
node_app_routes -->|"loads"| node_services_ui
node_app_routes -->|"loads"| node_sales_ui
node_app_routes -->|"loads"| node_day_ui
node_app_routes -->|"loads"| node_stock_ui
node_app_routes -->|"loads"| node_delivery_ui
node_sales_controller -->|"queries"| node_sales_service
node_sales_service -->|"searches"| node_sales_repo
node_auth_ui -.->|"authenticates"| node_auth_backend
node_article_ui -.->|"uses API"| node_article_core
node_commission_ui -.->|"uses API"| node_commissions
node_services_ui -.->|"uses API"| node_article_core
node_sales_ui -.->|"requests sales"| node_sales_controller
node_stock_ui -.->|"uses API"| node_inventory
node_delivery_ui -.->|"uses API"| node_delivery
node_day_ui -.->|"uses API"| node_business_day

click node_app_routes "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/app.routes.ts"
click node_article_ui "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/articles/articles.routes.ts"
click node_commission_ui "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/commissions/commissions.routes.ts"
click node_services_ui "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/services/services.routes.ts"
click node_auth_ui "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/core/auth/auth-service.ts"
click node_sales_ui "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/sales/sales.routes.ts"
click node_day_ui "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/day/day.routes.ts"
click node_stock_ui "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/stocks/stocks.routes.ts"
click node_delivery_ui "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/deliveries/deliveries.routes.ts"
click node_article_core "https://github.com/virtual-vision-synergy/valimbavaka/tree/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/article"
click node_inventory "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/inventory/service/InventoryService.java"
click node_production "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/production/service/ProductionBatchService.java"
click node_delivery "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/delivery/service/DeliveryOrderService.java"
click node_business_day "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/day/service/impl/BusinessDayServiceImpl.java"
click node_sales_controller "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/sale/controller/SaleQueryController.java"
click node_sales_service "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/sale/service/impl/SaleQueryServiceImpl.java"
click node_sales_repo "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/sale/repository/SaleQueryRepository.java"
click node_commissions "https://github.com/virtual-vision-synergy/valimbavaka/tree/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/commission"
click node_auth_backend "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/security/service/AuthService.java"
click node_dashboard "https://github.com/virtual-vision-synergy/valimbavaka/tree/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/dashboard"
click node_journal "https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/journal/service/JournalService.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_app_routes,node_article_ui,node_commission_ui,node_services_ui,node_auth_ui,node_sales_ui,node_day_ui,node_stock_ui,node_delivery_ui,node_staff toneBlue
class node_article_core,node_inventory,node_production,node_delivery,node_business_day toneAmber
class node_sales_controller,node_sales_service,node_sales_repo,node_commissions toneMint
class node_auth_backend,node_dashboard,node_journal toneRose
```

## Components

### Web application

- [Application routes](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/app.routes.ts): `valimbavaka-ui/src/app/app.routes.ts`
- [Articles](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/articles/articles.routes.ts): `valimbavaka-ui/src/app/features/articles/articles.routes.ts`
- [Commission screens](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/commissions/commissions.routes.ts): `valimbavaka-ui/src/app/features/commissions/commissions.routes.ts`
- [Service screens](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/services/services.routes.ts): `valimbavaka-ui/src/app/features/services/services.routes.ts`
- [Authentication UI](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/core/auth/auth-service.ts): `valimbavaka-ui/src/app/core/auth/auth-service.ts`
- [Sales screens](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/sales/sales.routes.ts): `valimbavaka-ui/src/app/features/sales/sales.routes.ts`
- [Business day UI](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/day/day.routes.ts): `valimbavaka-ui/src/app/features/day/day.routes.ts`
- [Stock screens](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/stocks/stocks.routes.ts): `valimbavaka-ui/src/app/features/stocks/stocks.routes.ts`
- [Delivery screens](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-ui/src/app/features/deliveries/deliveries.routes.ts): `valimbavaka-ui/src/app/features/deliveries/deliveries.routes.ts`

### Operations

- [Article catalog](https://github.com/virtual-vision-synergy/valimbavaka/tree/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/article): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/article`
- [Inventory](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/inventory/service/InventoryService.java): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/inventory/service/InventoryService.java`
- [Production](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/production/service/ProductionBatchService.java): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/production/service/ProductionBatchService.java`
- [Delivery orders](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/delivery/service/DeliveryOrderService.java): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/delivery/service/DeliveryOrderService.java`
- [Business day](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/day/service/impl/BusinessDayServiceImpl.java): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/day/service/impl/BusinessDayServiceImpl.java`

### Sales and finance

- [Sales query API](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/sale/controller/SaleQueryController.java): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/sale/controller/SaleQueryController.java`
- [Sales query service](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/sale/service/impl/SaleQueryServiceImpl.java): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/sale/service/impl/SaleQueryServiceImpl.java`
- [Sales query store](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/sale/repository/SaleQueryRepository.java): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/sale/repository/SaleQueryRepository.java`
- [Commissions](https://github.com/virtual-vision-synergy/valimbavaka/tree/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/commission): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/commission`

### Identity and insights

- [Authentication services](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/security/service/AuthService.java): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/security/service/AuthService.java`
- [Dashboard and reports](https://github.com/virtual-vision-synergy/valimbavaka/tree/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/dashboard): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/dashboard`
- [Journal](https://github.com/virtual-vision-synergy/valimbavaka/blob/develop/valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/journal/service/JournalService.java): `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/journal/service/JournalService.java`

### Other components

- **Staff user**

## Connections

- Staff user → Application routes: opens
- Application routes → Articles: loads (evidence: `valimbavaka-ui/src/app/app.routes.ts`)
- Application routes → Commission screens: loads (evidence: `valimbavaka-ui/src/app/app.routes.ts`)
- Application routes → Service screens: loads (evidence: `valimbavaka-ui/src/app/app.routes.ts`)
- Application routes → Sales screens: loads (evidence: `valimbavaka-ui/src/app/app.routes.ts`)
- Application routes → Business day UI: loads (evidence: `valimbavaka-ui/src/app/app.routes.ts`)
- Application routes → Stock screens: loads (evidence: `valimbavaka-ui/src/app/app.routes.ts`)
- Application routes → Delivery screens: loads (evidence: `valimbavaka-ui/src/app/app.routes.ts`)
- Sales query API → Sales query service: queries (evidence: `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/sale/controller/SaleQueryController.java`)
- Sales query service → Sales query store: searches (evidence: `valimbavaka-core/src/main/java/org/vvs/valimbavaka/feature/sale/service/impl/SaleQueryServiceImpl.java`)
- Authentication UI → Authentication services: authenticates
- Articles → Article catalog: uses API
- Commission screens → Commissions: uses API
- Service screens → Article catalog: uses API
- Sales screens → Sales query API: requests sales
- Stock screens → Inventory: uses API
- Delivery screens → Delivery orders: uses API
- Business day UI → Business day: uses API
