# leighahs/protype-capstone architecture

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

- Interactive diagram: https://gitdiagram.com/leighahs/protype-capstone
- Repository: https://github.com/leighahs/protype-capstone

## Overview

Almeda Optical is an optical-shop operations application: staff use a React interface to manage customers, inventory, sales, and reporting, with a Spring backend exposing API operations and persisting domain records. The clearest sampled workflow is the frontend invoking API helpers for customer, inventory, and transaction actions; backend excerpts show transaction validation and inventory workflows, plus forecast calculation. Several backend capabilities are visible in the tree but not sampled, so their internal links are omitted rather than inferred.

Main entry points: [`backend/src/main/java/com/almeda/optical/service/TransactionService.java`](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/TransactionService.java) (Sales transactions), [`src/App.jsx`](https://github.com/leighahs/protype-capstone/blob/main/src/App.jsx) (Shop workspace), [`backend/src/main/java/com/almeda/optical/repository/InventoryProductRepository.java`](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/repository/InventoryProductRepository.java) (Product repository), [`backend/src/main/java/com/almeda/optical/controller/ApiController.java`](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/controller/ApiController.java) (API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Shop Interface"]
  node_app["Shop workspace<br/>[App.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_forecast_view["Forecast view"]
  node_trend_view["Sales trends"]
end

subgraph group_api["Backend API"]
  node_api_controller["API routes<br/>[ApiController.java]"]
  node_auth_controller["Authentication routes"]
  node_user_controller["User administration"]
  node_audit_controller["Audit history routes"]
end

subgraph group_operations["Business Operations"]
  node_transaction_service["Sales transactions"]
  node_inventory_service["Stock management"]
  node_inventory_workflow["Stock workflows"]
  node_forecast_service["Sales forecasting"]
  node_user_service["User services<br/>[UserService.java]"]
  node_auth_context["Access control<br/>[AuthContext.java]"]
end

subgraph group_records["Domain Records"]
  node_transaction_data["Transaction records<br/>[Transaction.java]"]
  node_inventory_data["Inventory products"]
  node_customer_data["Customer records<br/>[Customer.java]"]
  node_user_data["User accounts<br/>[User.java]"]
  node_activity_data["Activity records"]
  node_inventory_repository["Product repository"]
  node_user_repository["User repository"]
  node_activity_repository["Activity repository"]
end

node_staff(("Shop staff"))

node_staff -->|"uses"| node_app
node_app -->|"invokes"| node_api_client
node_app -->|"renders"| node_forecast_view
node_app -.->|"renders"| node_trend_view
node_api_client -.->|"requests"| node_api_controller
node_api_controller -->|"queries"| node_inventory_repository
node_api_controller -->|"queries"| node_user_repository
node_transaction_service -->|"validates and records"| node_transaction_data
node_transaction_service -->|"uses"| node_customer_data
node_transaction_service -->|"uses"| node_inventory_data
node_transaction_service -->|"logs"| node_activity_data
node_inventory_service -->|"updates"| node_inventory_data
node_inventory_service -->|"reads and writes"| node_inventory_repository
node_inventory_workflow -->|"manages stock"| node_inventory_repository
node_forecast_service -->|"reads products"| node_inventory_repository
node_forecast_service -->|"analyzes sales"| node_transaction_data
node_user_controller -->|"delegates"| node_user_service
node_user_service -->|"manages accounts"| node_user_repository
node_user_service -->|"records activity"| node_activity_repository
node_auth_context -->|"loads account"| node_user_repository
node_audit_controller -->|"reads history"| node_activity_data

click node_app "https://github.com/leighahs/protype-capstone/blob/main/src/App.jsx"
click node_api_client "https://github.com/leighahs/protype-capstone/blob/main/src/api.js"
click node_forecast_view "https://github.com/leighahs/protype-capstone/blob/main/src/ClientSalesForecast.jsx"
click node_trend_view "https://github.com/leighahs/protype-capstone/blob/main/src/SalesTrendChart.jsx"
click node_api_controller "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/controller/ApiController.java"
click node_auth_controller "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/controller/AuthController.java"
click node_user_controller "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/controller/UserController.java"
click node_audit_controller "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/controller/AuditLogController.java"
click node_transaction_service "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/TransactionService.java"
click node_inventory_service "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/InventoryService.java"
click node_inventory_workflow "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/InventoryWorkflowService.java"
click node_forecast_service "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/ForecastService.java"
click node_user_service "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/UserService.java"
click node_auth_context "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/AuthContext.java"
click node_transaction_data "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/model/Transaction.java"
click node_inventory_data "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/model/InventoryProduct.java"
click node_customer_data "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/model/Customer.java"
click node_user_data "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/model/User.java"
click node_activity_data "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/model/UserActivityLog.java"
click node_inventory_repository "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/repository/InventoryProductRepository.java"
click node_user_repository "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/repository/UserRepository.java"
click node_activity_repository "https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/repository/UserActivityLogRepository.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,node_api_client,node_forecast_view,node_trend_view toneBlue
class node_api_controller,node_auth_controller,node_user_controller,node_audit_controller toneAmber
class node_transaction_service,node_inventory_service,node_inventory_workflow,node_forecast_service,node_user_service,node_auth_context toneMint
class node_transaction_data,node_inventory_data,node_customer_data,node_user_data,node_activity_data,node_inventory_repository,node_user_repository,node_activity_repository toneRose
class node_staff toneIndigo
```

## Components

### Shop Interface

- [Shop workspace](https://github.com/leighahs/protype-capstone/blob/main/src/App.jsx): `src/App.jsx`
- [API client](https://github.com/leighahs/protype-capstone/blob/main/src/api.js): `src/api.js`
- [Forecast view](https://github.com/leighahs/protype-capstone/blob/main/src/ClientSalesForecast.jsx): `src/ClientSalesForecast.jsx`
- [Sales trends](https://github.com/leighahs/protype-capstone/blob/main/src/SalesTrendChart.jsx): `src/SalesTrendChart.jsx`

### Backend API

- [API routes](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/controller/ApiController.java): `backend/src/main/java/com/almeda/optical/controller/ApiController.java`
- [Authentication routes](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/controller/AuthController.java): `backend/src/main/java/com/almeda/optical/controller/AuthController.java`
- [User administration](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/controller/UserController.java): `backend/src/main/java/com/almeda/optical/controller/UserController.java`
- [Audit history routes](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/controller/AuditLogController.java): `backend/src/main/java/com/almeda/optical/controller/AuditLogController.java`

### Business Operations

- [Sales transactions](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/TransactionService.java): `backend/src/main/java/com/almeda/optical/service/TransactionService.java`
- [Stock management](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/InventoryService.java): `backend/src/main/java/com/almeda/optical/service/InventoryService.java`
- [Stock workflows](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/InventoryWorkflowService.java): `backend/src/main/java/com/almeda/optical/service/InventoryWorkflowService.java`
- [Sales forecasting](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/ForecastService.java): `backend/src/main/java/com/almeda/optical/service/ForecastService.java`
- [User services](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/UserService.java): `backend/src/main/java/com/almeda/optical/service/UserService.java`
- [Access control](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/service/AuthContext.java): `backend/src/main/java/com/almeda/optical/service/AuthContext.java`

### Domain Records

- [Transaction records](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/model/Transaction.java): `backend/src/main/java/com/almeda/optical/model/Transaction.java`
- [Inventory products](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/model/InventoryProduct.java): `backend/src/main/java/com/almeda/optical/model/InventoryProduct.java`
- [Customer records](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/model/Customer.java): `backend/src/main/java/com/almeda/optical/model/Customer.java`
- [User accounts](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/model/User.java): `backend/src/main/java/com/almeda/optical/model/User.java`
- [Activity records](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/model/UserActivityLog.java): `backend/src/main/java/com/almeda/optical/model/UserActivityLog.java`
- [Product repository](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/repository/InventoryProductRepository.java): `backend/src/main/java/com/almeda/optical/repository/InventoryProductRepository.java`
- [User repository](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/repository/UserRepository.java): `backend/src/main/java/com/almeda/optical/repository/UserRepository.java`
- [Activity repository](https://github.com/leighahs/protype-capstone/blob/main/backend/src/main/java/com/almeda/optical/repository/UserActivityLogRepository.java): `backend/src/main/java/com/almeda/optical/repository/UserActivityLogRepository.java`

### Other components

- **Shop staff**

## Connections

- Shop staff → Shop workspace: uses
- Shop workspace → API client: invokes (evidence: `src/App.jsx`)
- Shop workspace → Forecast view: renders (evidence: `src/App.jsx`)
- Shop workspace → Sales trends: renders
- API client → API routes: requests
- API routes → Product repository: queries (evidence: `backend/src/main/java/com/almeda/optical/controller/ApiController.java`)
- API routes → User repository: queries (evidence: `backend/src/main/java/com/almeda/optical/controller/ApiController.java`)
- Sales transactions → Transaction records: validates and records (evidence: `backend/src/main/java/com/almeda/optical/service/TransactionService.java`)
- Sales transactions → Customer records: uses (evidence: `backend/src/main/java/com/almeda/optical/service/TransactionService.java`)
- Sales transactions → Inventory products: uses (evidence: `backend/src/main/java/com/almeda/optical/service/TransactionService.java`)
- Sales transactions → Activity records: logs (evidence: `backend/src/main/java/com/almeda/optical/service/TransactionService.java`)
- Stock management → Inventory products: updates (evidence: `backend/src/main/java/com/almeda/optical/service/InventoryService.java`)
- Stock management → Product repository: reads and writes (evidence: `backend/src/main/java/com/almeda/optical/service/InventoryService.java`)
- Stock workflows → Product repository: manages stock (evidence: `backend/src/main/java/com/almeda/optical/service/InventoryWorkflowService.java`)
- Sales forecasting → Product repository: reads products (evidence: `backend/src/main/java/com/almeda/optical/service/ForecastService.java`)
- Sales forecasting → Transaction records: analyzes sales (evidence: `backend/src/main/java/com/almeda/optical/service/ForecastService.java`)
- User administration → User services: delegates (evidence: `backend/src/main/java/com/almeda/optical/controller/UserController.java`)
- User services → User repository: manages accounts (evidence: `backend/src/main/java/com/almeda/optical/service/UserService.java`)
- User services → Activity repository: records activity (evidence: `backend/src/main/java/com/almeda/optical/service/UserService.java`)
- Access control → User repository: loads account (evidence: `backend/src/main/java/com/almeda/optical/service/AuthContext.java`)
- Audit history routes → Activity records: reads history (evidence: `backend/src/main/java/com/almeda/optical/controller/AuditLogController.java`)
