How olimpiu-galea/ethos works
EthOS is a Next.js shift-supervisor application for ethanol plants, with configurable support for other domains. Its principal workflow is to combine plant signals, evaluate playbooks, present alerts in an operational agenda, and guide operator action. The README documents that overall flow; sampled sources confirm agenda synchronization and persistent playbook and alert state. Other product areas are included from the repository tree, but their internal wiring is not assumed where source was not sampled.
Main entry points: playbook-store.ts Playbook State · page.tsx Alert Agenda · use-all-signal-tags.ts Signal Sources · auth-store.ts Authentication
Components 24
Identity & Setup
- Login & Signup
src/app/login/page.tsx - Authentication
src/stores/auth-store.ts - Roles & Access
src/lib/role-access.ts - Company Setup
src/app/onboarding/page.tsx - Workspace Settings
src/stores/settings-store.ts
Signals & Evaluation
- Signal Sources
src/hooks/use-all-signal-tags.ts - DCS Timeline
src/lib/dcs-timeline.ts - Playbook Management
src/app/playbooks/page.tsx - Playbook State
src/stores/playbook-store.ts - Playbook Logic
src/lib/playbook-utils.ts - Alert Generation
src/lib/mock-playbook-alerts.ts - Integrations
src/app/integrations/page.tsx
Operator Workflow
- Alert Agenda
src/app/agenda/page.tsx - Alert History
src/stores/alert-history-store.ts - Batch Intelligence
src/components/batches/batches-hub-2030.tsx - Reports
src/app/reports/page.tsx - Plant Copilot
src/components/copilot/plant-copilot-demo.tsx
Plant Capabilities
- Compliance
src/components/compliance/plant-compliance-demo.tsx - Maintenance
src/components/maintenance/maintenance-hub.tsx - Procurement
src/components/procurement/procurement-hub.tsx - Financial Margin
src/components/margin/margin-desk.tsx
Shared State
- Team Routing
src/lib/teams.ts - Brand & UI
src/lib/brand.ts
Other components
- Plant operator
Connections 28
- Plant operator → Login & Signup: signs in
src/app/login/page.tsx - Login & Signup → Authentication: authenticates
src/app/login/page.tsx - Authentication → Workspace Settings: syncs company
src/stores/auth-store.ts - Plant operator → Company Setup: configures workspace
- Company Setup → Workspace Settings: updates settings
src/app/onboarding/page.tsx - Plant operator → Signal Sources: connects signals
README.md - Signal Sources → Playbook State: evaluates signals
README.md - Plant operator → Playbook Management: configures playbooks
src/app/playbooks/page.tsx - Playbook Management → Playbook State: updates state
src/app/playbooks/page.tsx - Playbook State → Playbook Logic: uses playbook logic
src/stores/playbook-store.ts - Playbook State → Alert Generation: uses alert records
src/stores/playbook-store.ts - Alert Generation → Alert History: syncs alerts
src/lib/mock-playbook-alerts.ts - Plant operator → Alert Agenda: reviews alerts
README.md - Alert Agenda → Playbook State: reads playbooks
src/app/agenda/page.tsx - Alert Agenda → Signal Sources: shows sync status
src/app/agenda/page.tsx - Alert Agenda → Alert History: reviews alert history
src/app/agenda/page.tsx - Alert Agenda → Plant operator: guides action
README.md - Signal Sources → DCS Timeline: includes timeline
- Plant operator → Integrations: manages feeds
- Plant operator → Reports: creates reports
- Plant operator → Batch Intelligence: reviews batches
- Plant operator → Plant Copilot: consults copilot
- Plant operator → Compliance: reviews compliance
- Plant operator → Maintenance: manages maintenance
- Plant operator → Procurement: manages procurement
- Plant operator → Financial Margin: reviews margin
- Authentication → Roles & Access: checks roles
src/lib/role-access.ts - Playbook State → Team Routing: uses team routing
src/stores/playbook-store.ts