How margomez05/sistema_erp works
Tamachihua-ERP is an Angular web client backed by a Spring Boot REST API for ferretería/agroservicio operations. The user workflow is authenticated access to the web panel, followed by inventory/customer management and sales; a confirmed sale can be invoiced, paid, or credited. The README documents additional dashboard, lot, catalog, and product capabilities. Several frontend-to-API and backend persistence connections are documented at capability level but their implementation was not sampled, so those links are marked dashed.
Main entry points: ApiApplication.java REST API · app.ts Web application · AuthServiceImpl.java Authentication · InvoiceService.java Billing operations
Components 23
Angular web panel
- Web application
Web/src/app/app.ts - Login
Web/src/app/features/auth/login/login.component.ts - Catalog manager
Web/src/app/features/catalogs/catalog-manager/catalog-manager.component.ts - Customer workspace
Web/src/app/features/customers/customers.component.ts - Product workspace
Web/src/app/features/products/products.component.ts - Sales workspace
Web/src/app/features/sales/sales.routes.ts - Dashboard
Web/src/app/features/dashboard/dashboard.service.ts
Identity and access
- Auth endpoints
Api/api/src/main/java/com/tamachihua_erp/api/controller/AuthController.java - Authentication
Api/api/src/main/java/com/tamachihua_erp/api/service/impl/AuthServiceImpl.java - User lookup
Api/api/src/main/java/com/tamachihua_erp/api/security/CustomUserDetailsService.java - JWT tokens
Api/api/src/main/java/com/tamachihua_erp/api/security/JwtService.java
Inventory and customers
- Inventory endpoints
Api/api/src/main/java/com/tamachihua_erp/api/controller/ProductLotController.java - Customer endpoints
Api/api/src/main/java/com/tamachihua_erp/api/controller/CustomerController.java - Product endpoints
Api/api/src/main/java/com/tamachihua_erp/api/controller/ProductController.java - Dashboard data
Api/api/src/main/java/com/tamachihua_erp/api/service/impl/DashboardServiceImpl.java
Sales and billing
- Sales endpoints
Api/api/src/main/java/com/tamachihua_erp/api/controller/SaleController.java - Sales operations
Api/api/src/main/java/com/tamachihua_erp/api/service/impl/SaleServiceImpl.java - Invoice endpoints
Api/api/src/main/java/com/tamachihua_erp/api/controller/InvoiceController.java - Billing operations
Api/api/src/main/java/com/tamachihua_erp/api/service/InvoiceService.java
Persistence
- User repository
Api/api/src/main/java/com/tamachihua_erp/api/repository/UserRepository.java - PostgreSQL
Other components
- Staff user
- REST API
Api/api/src/main/java/com/tamachihua_erp/api/ApiApplication.java
Connections 23
- Staff user → Web application: uses
README.md - Web application → Login: offers login
README.md - Login → Auth endpoints: authenticates
README.md - Auth endpoints → Authentication: delegates to
README.md - Authentication → JWT tokens: issues token
Api/api/src/main/java/com/tamachihua_erp/api/service/impl/AuthServiceImpl.java - Authentication → User repository: looks up user
Api/api/src/main/java/com/tamachihua_erp/api/service/impl/AuthServiceImpl.java - User lookup → User repository: loads user
Api/api/src/main/java/com/tamachihua_erp/api/security/CustomUserDetailsService.java - Catalog manager → REST API: manages catalogs
README.md - Customer workspace → Customer endpoints: manages customers
README.md - Product workspace → Product endpoints: manages products
README.md - Web application → Dashboard: shows dashboard
README.md - Dashboard → REST API: fetches data
README.md - Sales workspace → REST API: uses REST API
README.md - Sales endpoints → Sales operations: delegates to
Api/api/src/main/java/com/tamachihua_erp/api/controller/SaleController.java - Sales endpoints → Billing operations: creates invoice
Api/api/src/main/java/com/tamachihua_erp/api/controller/SaleController.java - Invoice endpoints → Billing operations: delegates to
Api/api/src/main/java/com/tamachihua_erp/api/controller/InvoiceController.java - Inventory endpoints → REST API: serves inventory
README.md - Customer endpoints → REST API: serves customer CRUD
README.md - Product endpoints → REST API: serves catalog
README.md - Dashboard data → REST API: provides summaries
README.md - Sales operations → PostgreSQL: persists sales
README.md - Billing operations → PostgreSQL: persists billing
README.md - User repository → PostgreSQL: queries users
README.md