How j3ffreyjr/goatilicious-first-step works
Goatilicious combines a customer-facing 3D storefront with staff operations for customers, orders, production/stock, dashboards, and invoicing. The principal operational flow is customer registration and order submission, followed by staff order review, invoice finalization, and optional PDF/email delivery. The graph preserves the separately documented 3D landing experience and admin capabilities. Several backend services and frontend-to-API links are unsampled; those links are marked dashed where the README establishes integration, and otherwise omitted.
Main entry points: repositories JPA repositories · FacturaController.java Invoice API · EnvioFacturaService.java Email delivery · main.js 3D landing
Components 24
Customer storefront
- 3D landing
frontend/src/main.js - Scene and flavors
frontend/src/modules/scene.js - Bubble effects
frontend/src/modules/bubbles.js - Scene config
frontend/src/config/scene.js - UI state
frontend/src/state.js - Registration and orders
frontend/cliente/cadastro.js - Client authentication
frontend/shared/auth.js
Staff operations
- Staff dashboard
frontend/admin/dashboard.js - Order management
frontend/admin/gerir-pedidos.js - Invoice management
frontend/admin/facturas.js - Dashboard metrics
backend/src/main/java/com/goatilicious/services/DashboardService.java
Backend API
- Customer API
backend/src/main/java/com/goatilicious/controllers/ClienteController.java - Order API
backend/src/main/java/com/goatilicious/controllers/PedidoController.java - Invoice API
backend/src/main/java/com/goatilicious/controllers/FacturaController.java - Order processing
backend/src/main/java/com/goatilicious/services/PedidoService.java
Invoice delivery
- Invoice lifecycle
backend/src/main/java/com/goatilicious/services/FacturaService.java - PDF generation
backend/src/main/java/com/goatilicious/services/FacturaPdfService.java - Email delivery
backend/src/main/java/com/goatilicious/services/EnvioFacturaService.java - SMTP sender
backend/src/main/java/com/goatilicious/mail/SmtpEmailSender.java
Persistence and identity
- JPA repositories
backend/src/main/java/com/goatilicious/repositories - User authentication
backend/src/main/java/com/goatilicious/security/UtilizadorUserDetailsService.java - Access rules
backend/src/main/java/com/goatilicious/config/SecurityConfig.java
Other components
- Customer
- Staff user
Connections 28
- 3D landing → Scene and flavors: initializes
frontend/src/main.js - 3D landing → Bubble effects: initializes
frontend/src/main.js - 3D landing → Scene config: loads config
frontend/src/main.js - Bubble effects → Scene config: reads settings
frontend/src/modules/bubbles.js - Bubble effects → UI state: checks motion
frontend/src/modules/bubbles.js - Customer → Registration and orders: registers or orders
- Registration and orders → Client authentication: uses session
frontend/cliente/cadastro.js - Registration and orders → Customer API: submits registration
- Client authentication → Customer API: validates session
- Staff user → Staff dashboard: views metrics
- Staff user → Order management: manages orders
- Staff user → Invoice management: manages invoices
- Order management → Order API: calls API
- Invoice management → Invoice API: calls API
- Staff dashboard → Dashboard metrics: requests metrics
- Customer API → JPA repositories: accesses data
- Order API → Order processing: delegates
backend/src/main/java/com/goatilicious/controllers/PedidoController.java - Order processing → JPA repositories: accesses data
- Invoice API → Invoice lifecycle: delegates
backend/src/main/java/com/goatilicious/controllers/FacturaController.java - Invoice API → PDF generation: generates PDF
backend/src/main/java/com/goatilicious/controllers/FacturaController.java - Invoice API → Email delivery: requests delivery
backend/src/main/java/com/goatilicious/controllers/FacturaController.java - Invoice lifecycle → JPA repositories: reads and saves
backend/src/main/java/com/goatilicious/services/FacturaService.java - Email delivery → PDF generation: creates attachment
backend/src/main/java/com/goatilicious/services/EnvioFacturaService.java - Email delivery → SMTP sender: sends message
backend/src/main/java/com/goatilicious/services/EnvioFacturaService.java - Email delivery → JPA repositories: records attempts
backend/src/main/java/com/goatilicious/services/EnvioFacturaService.java - Dashboard metrics → JPA repositories: reads orders and invoices
backend/src/main/java/com/goatilicious/services/DashboardService.java - User authentication → JPA repositories: loads user
backend/src/main/java/com/goatilicious/security/UtilizadorUserDetailsService.java - Access rules → User authentication: configures identity