How enterprise-system-sarana/360-backend works
Sarana Restaurant System is a Spring-based restaurant operations backend. Staff and administrators use its API to manage products and stock, record purchases and sales, handle customers and quotes, and review reports; authentication and file handling are additional capabilities. Controllers expose the API and delegate domain work to services, with persistence represented by JPA entities and repositories. The excerpts establish the authentication and invoice-number details, but most domain controller-to-service and service-to-repository calls were not sampled, so those links are shown as unverified rather than asserted.
Main entry points: repository JPA repositories · purchase Purchases and expenses · sales Sales and payments · InvoiceNumberService.java Invoice numbering
Components 20
Identity and access
- Authentication API
src/main/java/com/saranaresturantsystem/controllers/users/AuthController.java - Authentication service
src/main/java/com/saranaresturantsystem/services/impl/users/AuthServiceImpl.java - JWT service
src/main/java/com/saranaresturantsystem/config/security/JwtService.java - Users and permissions
src/main/java/com/saranaresturantsystem/controllers/users
Restaurant operations
- Product catalog
src/main/java/com/saranaresturantsystem/controllers/catalog - Customer management
src/main/java/com/saranaresturantsystem/controllers/customer/CustomerController.java - Inventory and stores
src/main/java/com/saranaresturantsystem/controllers/inventory - Purchases and expenses
src/main/java/com/saranaresturantsystem/controllers/purchase - Sales and payments
src/main/java/com/saranaresturantsystem/controllers/sales - Quotes
src/main/java/com/saranaresturantsystem/controllers/quote/QuoteController.java - Banks and currency
src/main/java/com/saranaresturantsystem/controllers/finances
Reports and insights
- Operational reports
src/main/java/com/saranaresturantsystem/reports/controller - Dashboard
src/main/java/com/saranaresturantsystem/controllers/dashboard/DashboardController.java
Shared platform
- File API
src/main/java/com/saranaresturantsystem/controllers/S3FileController.java - S3 file service
src/main/java/com/saranaresturantsystem/services/file/S3FileService.java - Invoice numbering
src/main/java/com/saranaresturantsystem/common/InvoiceNumberService.java - JPA repositories
src/main/java/com/saranaresturantsystem/repository - PostgreSQL database
- Amazon S3
Other components
- Staff and admins
Connections 27
- Staff and admins → Authentication API: uses auth
- Authentication API → Authentication service: delegates auth
src/main/java/com/saranaresturantsystem/controllers/users/AuthController.java - Authentication service → JWT service: creates tokens
src/main/java/com/saranaresturantsystem/services/impl/users/AuthServiceImpl.java - Staff and admins → Product catalog: manages products
- Staff and admins → Customer management: manages customers
- Staff and admins → Inventory and stores: manages stock
- Staff and admins → Purchases and expenses: records purchases
- Staff and admins → Sales and payments: records sales
- Staff and admins → Quotes: manages quotes
- Staff and admins → Banks and currency: manages finance
- Staff and admins → Operational reports: requests reports
- Staff and admins → Dashboard: views dashboard
- Staff and admins → Users and permissions: administers access
- Staff and admins → File API: manages files
- File API → S3 file service: delegates files
src/main/java/com/saranaresturantsystem/controllers/S3FileController.java - S3 file service → Amazon S3: stores files
- Purchases and expenses → Invoice numbering: numbers purchases
- Sales and payments → Invoice numbering: numbers sales
- Quotes → Invoice numbering: numbers quotes
- Product catalog → JPA repositories: persists catalog
- Customer management → JPA repositories: persists customers
- Inventory and stores → JPA repositories: persists stock
- Purchases and expenses → JPA repositories: persists purchases
- Sales and payments → JPA repositories: persists sales
- Operational reports → JPA repositories: queries records
- Dashboard → JPA repositories: queries metrics
- JPA repositories → PostgreSQL database: reads and writes