How crisflorez06/papeleria works
Papelería is a retail-management application: users manage products and stock, record sales and expenses, and review date-range reports. Angular routes expose product, sales, and report screens; the frontend consumes a Spring Boot REST API backed by relational persistence. Backend services implement business rules and delegate persistence to repositories. The README documents the overall frontend-to-API-to-MySQL architecture; sampled source supports several service and repository relationships, but not endpoint-by-endpoint wiring from Angular services.
Main entry points: repositories JPA repositories · app.routes.ts Application routes · services API client services · ProductoService.java Product and stock rules
Components 21
Angular frontend
- Application routes
frontend/src/app/app.routes.ts - Product screen
frontend/src/app/pages/productos/productos.component.ts - Sales screen
frontend/src/app/pages/ventas/ventas.component.ts - Reports screen
frontend/src/app/pages/reportes/reportes.component.ts - API client services
frontend/src/app/services
REST API
- Product endpoints
src/main/java/com/papeleria/controllers/producto/ProductoController.java - Sales endpoints
src/main/java/com/papeleria/controllers/venta/VentaController.java - Expense endpoints
src/main/java/com/papeleria/controllers/gasto/GastoController.java - Stock movement endpoints
src/main/java/com/papeleria/controllers/movimiento/MovimientoController.java - Report endpoints
src/main/java/com/papeleria/controllers/reporte/ReporteController.java - Filter endpoint
src/main/java/com/papeleria/controllers/FiltroController.java - Spring Boot REST API
src/main/java/com/papeleria/controllers
Retail operations
- Product and stock rules
src/main/java/com/papeleria/services/producto/ProductoService.java - Sales and inventory rules
src/main/java/com/papeleria/services/venta/VentaService.java - Movement records
src/main/java/com/papeleria/services/movimiento/MovimientoService.java - Expense management
src/main/java/com/papeleria/services/gasto/GastoService.java
Reports and filters
- Report calculations
src/main/java/com/papeleria/services/reporte/ReporteService.java - Product filters
src/main/java/com/papeleria/services/FiltroService.java
Persistence
- JPA repositories
src/main/java/com/papeleria/repositories - MySQL database
Other components
- Store user
Connections 23
- Store user → Application routes: uses
- Application routes → Product screen: routes to
frontend/src/app/app.routes.ts - Application routes → Sales screen: routes to
frontend/src/app/app.routes.ts - Application routes → Reports screen: routes to
frontend/src/app/app.routes.ts - Product screen → API client services: requests data
- Sales screen → API client services: requests data
- Reports screen → API client services: requests data
- API client services → Spring Boot REST API: consumes REST API
- Product endpoints → Product and stock rules: delegates to
src/main/java/com/papeleria/controllers/producto/ProductoController.java - Sales endpoints → Sales and inventory rules: delegates to
src/main/java/com/papeleria/controllers/venta/VentaController.java - Expense endpoints → Expense management: delegates to
src/main/java/com/papeleria/controllers/gasto/GastoController.java - Stock movement endpoints → Movement records: delegates to
src/main/java/com/papeleria/controllers/movimiento/MovimientoController.java - Report endpoints → Report calculations: delegates to
src/main/java/com/papeleria/controllers/reporte/ReporteController.java - Filter endpoint → Product filters: delegates to
src/main/java/com/papeleria/controllers/FiltroController.java - Product and stock rules → Movement records: records stock entry
src/main/java/com/papeleria/services/producto/ProductoService.java - Product and stock rules → JPA repositories: reads and saves
src/main/java/com/papeleria/services/producto/ProductoService.java - Sales and inventory rules → JPA repositories: reads and writes
src/main/java/com/papeleria/services/venta/VentaService.java - Movement records → JPA repositories: reads and saves
src/main/java/com/papeleria/services/movimiento/MovimientoService.java - Expense management → JPA repositories: reads and writes
src/main/java/com/papeleria/services/gasto/GastoService.java - Report calculations → JPA repositories: queries totals
src/main/java/com/papeleria/services/reporte/ReporteService.java - Product filters → JPA repositories: queries products
src/main/java/com/papeleria/services/FiltroService.java - JPA repositories → MySQL database: persists via JPA
- Spring Boot REST API → MySQL database: persists through JPA