How cacetius/hub8 works
HUB 8 is an operations-app portal and API for factory catalogs, users, shifts, dashboards, and audit. The intended user flow is to authenticate, load the app catalog and dashboard, filter or search apps, and open a selected app; administrators also manage users and operational records. The tree contains both a documented Node.js API and a substantial Java backend implementation, so both are represented. The README describes capabilities beyond the excerpts; uncertain links are omitted rather than inferred.
Main entry points: routes API routes · repositories Repositories · app.js Express API · adapters DB adapters
Components 21
Portal clients
- Hub portal
frontend/hub-react/src/main.jsx - API client
frontend/hub-react/src/api.js - Internal apps
frontend/services/hub-client.js
Node API
- Express API
backend/src/app.js - API routes
backend/src/routes - Authentication and RBAC
backend/src/middleware - App management
backend/src/services/AppService.js - Factory catalogs
backend/src/services/FactoryCatalogService.js - User administration
backend/src/services/AdminUserService.js - Audit queries
backend/src/services/AuditService.js - Dashboard
backend/src/routes/dashboard.routes.js
Node data layer
- DB adapters
backend/src/adapters - DB2 / SQL Server
- Repositories
backend/src/repositories
Java backend
- Java API controller
backend-java/src/main/java/com/hub8/backend/api/HubApiController.java - Hub service
backend-java/src/main/java/com/hub8/backend/service/HubService.java - JDBC repositories
backend-java/src/main/java/com/hub8/backend/persistence - File and backup store
backend-java/src/main/java/com/hub8/backend/persistence/SharePointFileStore.java
Data migration
- Legacy data import
database/seeds/migrate-legacy.js
Other components
- Hub user
- SharePoint storage
Connections 24
- Hub user → Hub portal: uses
- Hub portal → API client: requests data
frontend/hub-react/src/main.jsx - Hub portal → API client: loads catalog
frontend/hub-react/src/main.jsx - API client → Express API: calls API
- Internal apps → Express API: uses API
- Express API → API routes: mounts routes
backend/src/app.js - Express API → DB adapters: checks readiness
backend/src/app.js - API routes → Authentication and RBAC: guards requests
backend/src/routes/app.routes.js - API routes → App management: dispatches app actions
backend/src/routes/app.routes.js - API routes → Factory catalogs: dispatches catalog actions
backend/src/routes/catalog.routes.js - API routes → User administration: dispatches user actions
- API routes → Audit queries: dispatches audit queries
- API routes → Dashboard: routes dashboard
- App management → Repositories: uses repositories
- Factory catalogs → Repositories: uses repositories
backend/src/services/FactoryCatalogService.js - User administration → Repositories: uses repositories
- Audit queries → Repositories: uses repository
- Repositories → DB adapters: queries through
- DB adapters → DB2 / SQL Server: connects to
- Legacy data import → DB adapters: imports legacy data
database/seeds/migrate-legacy.js - Java API controller → Hub service: delegates requests
backend-java/src/main/java/com/hub8/backend/api/HubApiController.java - Hub service → JDBC repositories: uses repositories
backend-java/src/main/java/com/hub8/backend/service/HubService.java - Java API controller → File and backup store: uploads and retrieves files
backend-java/src/main/java/com/hub8/backend/api/HubApiController.java - File and backup store → SharePoint storage: stores files