How jay623949-dotcom/hack-celestial works
RESORT 360 coordinates resort operations through a command center and AI-assisted workflow: operational state is assembled into context, analyzed by departmental agents, reconciled into recommendations, reviewed by a manager, and dispatched for execution. The repository also contains a Smart Resort Express implementation and a HackCel FastAPI/demo implementation with specialized department services and live events. Several connections in those parallel implementations are documented by imports or excerpts; unsampled behavior is not inferred.
Main entry points: orchestrator.service.js AI Orchestrator · app.js Express API · routes.js Smart Resort Routes · main.py FastAPI Application
Components 28
Command Center
- Operations Dashboard
frontend/app/dashboard/page.js - REST API Client
frontend/lib/api.js - Express API
backend/src/app.js - Action Plan Review
backend/src/controllers/actionPlans.controller.js - Live Updates
backend/src/services/socket.service.js
AI Decisioning
- AI Controller
backend/src/controllers/ai.controller.js - Context Builder
backend/src/services/context-builder.service.js - AI Orchestrator
backend/src/services/orchestrator.service.js - Department Agents
backend/src/services/agent.service.js - AI Provider
backend/src/services/openai.service.js - Consensus Engine
backend/src/services/consensus.service.js - AI Persistence
backend/src/services/ai-persistence.service.js
Operational Services
- Task Execution
backend/src/services/execution.service.js - Operational Services
backend/src/services - Operational Data Store
backend/src/data/dataStore.js
Smart Resort
- Smart Resort Routes
backend/src/smart-resort/routes.js - Intelligence Engine
backend/src/smart-resort/engine.service.js - Department Services
backend/src/smart-resort - Resort State
backend/src/smart-resort/smartResortStore.js
HackCel Demo
- FastAPI Application
HackCel/app/main.py - SQLite Data Layer
HackCel/app/db.py - Maintenance Agent
HackCel/app/services/maintenance_service.py - Department Agents
HackCel/app/services - Mock AI Client
HackCel/app/ai/mock_ai_client.py - Cross-Agent Events
HackCel/app/event_bus.py - Operations Demo UI
HackCel/frontend/src/App.tsx - Operational Models
HackCel/app/models/room.py
Other components
- Duty Manager
Connections 27
- Duty Manager → Operations Dashboard: reviews operations
README.md - Operations Dashboard → REST API Client: requests data
- REST API Client → Express API: calls API
- Express API → AI Controller: mounts routes
backend/src/app.js - AI Controller → AI Orchestrator: invokes analysis
backend/src/controllers/ai.controller.js - AI Orchestrator → Context Builder: builds context
backend/src/services/orchestrator.service.js - Context Builder → Operational Data Store: reads state
backend/src/services/context-builder.service.js - AI Orchestrator → AI Provider: analyzes context
backend/src/services/orchestrator.service.js - AI Orchestrator → Department Agents: runs agents
backend/src/services/orchestrator.service.js - Department Agents → AI Provider: requests inference
backend/src/services/agent.service.js - AI Orchestrator → Consensus Engine: synthesizes results
backend/src/services/orchestrator.service.js - AI Orchestrator → AI Persistence: persists results
backend/src/services/orchestrator.service.js - Duty Manager → Action Plan Review: approves or edits
README.md - Action Plan Review → Task Execution: dispatches approved plan
- Task Execution → Live Updates: emits telemetry
- Operational Services → Operational Data Store: uses operational state
backend/src/services/context-builder.service.js - Express API → Smart Resort Routes: mounts router
backend/src/app.js - Smart Resort Routes → Intelligence Engine: routes engine requests
backend/src/smart-resort/routes.js - Smart Resort Routes → Department Services: routes department actions
backend/src/smart-resort/routes.js - Intelligence Engine → Resort State: reads state
backend/src/smart-resort/engine.service.js - Operations Demo UI → FastAPI Application: posts operations
HackCel/frontend/src/App.tsx - FastAPI Application → SQLite Data Layer: initializes database
HackCel/app/main.py - FastAPI Application → Department Agents: registers subscribers
HackCel/app/main.py - Department Agents → Mock AI Client: requests AI results
HackCel/app/services/frontdesk_service.py - Maintenance Agent → SQLite Data Layer: reads and writes
HackCel/app/services/maintenance_service.py - Department Agents → Cross-Agent Events: publishes events
HackCel/app/services/frontdesk_service.py - SQLite Data Layer → Operational Models: registers models
HackCel/app/db.py