How leighahs/protype-capstone works
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: TransactionService.java Sales transactions · App.jsx Shop workspace · InventoryProductRepository.java Product repository · ApiController.java API routes
Components 23
Shop Interface
- Shop workspace
src/App.jsx - API client
src/api.js - Forecast view
src/ClientSalesForecast.jsx - Sales trends
src/SalesTrendChart.jsx
Backend API
- API routes
backend/src/main/java/com/almeda/optical/controller/ApiController.java - Authentication routes
backend/src/main/java/com/almeda/optical/controller/AuthController.java - User administration
backend/src/main/java/com/almeda/optical/controller/UserController.java - Audit history routes
backend/src/main/java/com/almeda/optical/controller/AuditLogController.java
Business Operations
- Sales transactions
backend/src/main/java/com/almeda/optical/service/TransactionService.java - Stock management
backend/src/main/java/com/almeda/optical/service/InventoryService.java - Stock workflows
backend/src/main/java/com/almeda/optical/service/InventoryWorkflowService.java - Sales forecasting
backend/src/main/java/com/almeda/optical/service/ForecastService.java - User services
backend/src/main/java/com/almeda/optical/service/UserService.java - Access control
backend/src/main/java/com/almeda/optical/service/AuthContext.java
Domain Records
- Transaction records
backend/src/main/java/com/almeda/optical/model/Transaction.java - Inventory products
backend/src/main/java/com/almeda/optical/model/InventoryProduct.java - Customer records
backend/src/main/java/com/almeda/optical/model/Customer.java - User accounts
backend/src/main/java/com/almeda/optical/model/User.java - Activity records
backend/src/main/java/com/almeda/optical/model/UserActivityLog.java - Product repository
backend/src/main/java/com/almeda/optical/repository/InventoryProductRepository.java - User repository
backend/src/main/java/com/almeda/optical/repository/UserRepository.java - Activity repository
backend/src/main/java/com/almeda/optical/repository/UserActivityLogRepository.java
Other components
- Shop staff
Connections 21
- Shop staff → Shop workspace: uses
- Shop workspace → API client: invokes
src/App.jsx - Shop workspace → Forecast view: renders
src/App.jsx - Shop workspace → Sales trends: renders
- API client → API routes: requests
- API routes → Product repository: queries
backend/src/main/java/com/almeda/optical/controller/ApiController.java - API routes → User repository: queries
backend/src/main/java/com/almeda/optical/controller/ApiController.java - Sales transactions → Transaction records: validates and records
backend/src/main/java/com/almeda/optical/service/TransactionService.java - Sales transactions → Customer records: uses
backend/src/main/java/com/almeda/optical/service/TransactionService.java - Sales transactions → Inventory products: uses
backend/src/main/java/com/almeda/optical/service/TransactionService.java - Sales transactions → Activity records: logs
backend/src/main/java/com/almeda/optical/service/TransactionService.java - Stock management → Inventory products: updates
backend/src/main/java/com/almeda/optical/service/InventoryService.java - Stock management → Product repository: reads and writes
backend/src/main/java/com/almeda/optical/service/InventoryService.java - Stock workflows → Product repository: manages stock
backend/src/main/java/com/almeda/optical/service/InventoryWorkflowService.java - Sales forecasting → Product repository: reads products
backend/src/main/java/com/almeda/optical/service/ForecastService.java - Sales forecasting → Transaction records: analyzes sales
backend/src/main/java/com/almeda/optical/service/ForecastService.java - User administration → User services: delegates
backend/src/main/java/com/almeda/optical/controller/UserController.java - User services → User repository: manages accounts
backend/src/main/java/com/almeda/optical/service/UserService.java - User services → Activity repository: records activity
backend/src/main/java/com/almeda/optical/service/UserService.java - Access control → User repository: loads account
backend/src/main/java/com/almeda/optical/service/AuthContext.java - Audit history routes → Activity records: reads history
backend/src/main/java/com/almeda/optical/controller/AuditLogController.java