2025-10-30 21:08:07 +01:00
|
|
|
# ================================================================
|
|
|
|
|
# services/orchestrator/app/main.py
|
|
|
|
|
# ================================================================
|
|
|
|
|
"""
|
|
|
|
|
Orchestrator Service - FastAPI Application
|
|
|
|
|
Automated orchestration of forecasting, production, and procurement workflows
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
from fastapi import FastAPI, Request
|
|
|
|
|
from sqlalchemy import text
|
|
|
|
|
from app.core.config import settings
|
|
|
|
|
from app.core.database import database_manager
|
|
|
|
|
from shared.service_base import StandardFastAPIService
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class OrchestratorService(StandardFastAPIService):
|
|
|
|
|
"""Orchestrator Service with standardized setup"""
|
|
|
|
|
|
|
|
|
|
expected_migration_version = "00001"
|
|
|
|
|
|
|
|
|
|
async def verify_migrations(self):
|
|
|
|
|
"""Verify database schema matches the latest migrations"""
|
|
|
|
|
try:
|
|
|
|
|
async with self.database_manager.get_session() as session:
|
|
|
|
|
result = await session.execute(text("SELECT version_num FROM alembic_version"))
|
|
|
|
|
version = result.scalar()
|
|
|
|
|
if version != self.expected_migration_version:
|
|
|
|
|
self.logger.error(f"Migration version mismatch: expected {self.expected_migration_version}, got {version}")
|
|
|
|
|
raise RuntimeError(f"Migration version mismatch: expected {self.expected_migration_version}, got {version}")
|
|
|
|
|
self.logger.info(f"Migration verification successful: {version}")
|
|
|
|
|
except Exception as e:
|
|
|
|
|
self.logger.error(f"Migration verification failed: {e}")
|
|
|
|
|
raise
|
|
|
|
|
|
|
|
|
|
def __init__(self):
|
|
|
|
|
# Define expected database tables for health checks
|
|
|
|
|
orchestrator_expected_tables = [
|
|
|
|
|
'orchestration_runs'
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
super().__init__(
|
|
|
|
|
service_name="orchestrator-service",
|
|
|
|
|
app_name=settings.APP_NAME,
|
|
|
|
|
description=settings.DESCRIPTION,
|
|
|
|
|
version=settings.VERSION,
|
|
|
|
|
api_prefix="", # Empty because RouteBuilder already includes /api/v1
|
|
|
|
|
database_manager=database_manager,
|
|
|
|
|
expected_tables=orchestrator_expected_tables
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
async def on_startup(self, app: FastAPI):
|
|
|
|
|
"""Custom startup logic for orchestrator service"""
|
|
|
|
|
self.logger.info("Orchestrator Service starting up...")
|
|
|
|
|
|
|
|
|
|
# Initialize orchestrator scheduler service
|
|
|
|
|
from app.services.orchestrator_service import OrchestratorSchedulerService
|
|
|
|
|
scheduler_service = OrchestratorSchedulerService(settings)
|
|
|
|
|
await scheduler_service.start()
|
|
|
|
|
app.state.scheduler_service = scheduler_service
|
|
|
|
|
self.logger.info("Orchestrator scheduler service started")
|
|
|
|
|
|
|
|
|
|
async def on_shutdown(self, app: FastAPI):
|
|
|
|
|
"""Custom shutdown logic for orchestrator service"""
|
|
|
|
|
self.logger.info("Orchestrator Service shutting down...")
|
|
|
|
|
|
|
|
|
|
# Stop scheduler service
|
|
|
|
|
if hasattr(app.state, 'scheduler_service'):
|
|
|
|
|
await app.state.scheduler_service.stop()
|
|
|
|
|
self.logger.info("Orchestrator scheduler service stopped")
|
|
|
|
|
|
|
|
|
|
def get_service_features(self):
|
|
|
|
|
"""Return orchestrator-specific features"""
|
|
|
|
|
return [
|
|
|
|
|
"automated_orchestration",
|
|
|
|
|
"forecasting_integration",
|
|
|
|
|
"production_scheduling",
|
|
|
|
|
"procurement_planning",
|
|
|
|
|
"notification_dispatch",
|
|
|
|
|
"leader_election",
|
|
|
|
|
"retry_mechanism",
|
|
|
|
|
"circuit_breaker"
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Create service instance
|
|
|
|
|
service = OrchestratorService()
|
|
|
|
|
|
|
|
|
|
# Create FastAPI app with standardized setup
|
|
|
|
|
app = service.create_app()
|
|
|
|
|
|
|
|
|
|
# Setup standard endpoints (health, readiness, metrics)
|
|
|
|
|
service.setup_standard_endpoints()
|
|
|
|
|
|
|
|
|
|
# Include routers
|
|
|
|
|
# BUSINESS: Orchestration operations
|
|
|
|
|
from app.api.orchestration import router as orchestration_router
|
feat: Complete JTBD-aligned bakery dashboard redesign
Implements comprehensive dashboard redesign based on Jobs To Be Done methodology
focused on answering: "What requires my attention right now?"
## Backend Implementation
### Dashboard Service (NEW)
- Health status calculation (green/yellow/red traffic light)
- Action queue prioritization (critical/important/normal)
- Orchestration summary with narrative format
- Production timeline transformation
- Insights calculation and consequence prediction
### API Endpoints (NEW)
- GET /dashboard/health-status - Overall bakery health indicator
- GET /dashboard/orchestration-summary - What system did automatically
- GET /dashboard/action-queue - Prioritized tasks requiring attention
- GET /dashboard/production-timeline - Today's production schedule
- GET /dashboard/insights - Key metrics (savings, inventory, waste, deliveries)
### Enhanced Models
- PurchaseOrder: Added reasoning, consequence, reasoning_data fields
- ProductionBatch: Added reasoning, reasoning_data fields
- Enables transparency into automation decisions
## Frontend Implementation
### API Hooks (NEW)
- useBakeryHealthStatus() - Real-time health monitoring
- useOrchestrationSummary() - System transparency
- useActionQueue() - Prioritized action management
- useProductionTimeline() - Production tracking
- useInsights() - Glanceable metrics
### Dashboard Components (NEW)
- HealthStatusCard: Traffic light indicator with checklist
- ActionQueueCard: Prioritized actions with reasoning/consequences
- OrchestrationSummaryCard: Narrative of what system did
- ProductionTimelineCard: Chronological production view
- InsightsGrid: 2x2 grid of key metrics
### Main Dashboard Page (REPLACED)
- Complete rewrite with mobile-first design
- All sections integrated with error handling
- Real-time refresh and quick action links
- Old dashboard backed up as DashboardPage.legacy.tsx
## Key Features
### Automation-First
- Shows what orchestrator did overnight
- Builds trust through transparency
- Explains reasoning for all automated decisions
### Action-Oriented
- Prioritizes tasks over information display
- Clear consequences for each action
- Large touch-friendly buttons
### Progressive Disclosure
- Shows 20% of info that matters 80% of time
- Expandable details when needed
- No overwhelming metrics
### Mobile-First
- One-handed operation
- Large touch targets (min 44px)
- Responsive grid layouts
### Trust-Building
- Narrative format ("I planned your day")
- Reasoning inputs transparency
- Clear status indicators
## User Segments Supported
1. Solo Bakery Owner (Primary)
- Simple health indicator
- Action checklist (max 3-5 items)
- Mobile-optimized
2. Multi-Location Owner
- Multi-tenant support (existing)
- Comparison capabilities
- Delegation ready
3. Enterprise/Central Bakery (Future)
- Network topology support
- Advanced analytics ready
## JTBD Analysis Delivered
Main Job: "Help me quickly understand bakery status and know what needs my intervention"
Emotional Jobs Addressed:
- Feel in control despite automation
- Reduce daily anxiety
- Feel competent with technology
- Trust system as safety net
Social Jobs Addressed:
- Demonstrate professional management
- Avoid being bottleneck
- Show sustainability
## Technical Stack
Backend: Python, FastAPI, SQLAlchemy, PostgreSQL
Frontend: React, TypeScript, TanStack Query, Tailwind CSS
Architecture: Microservices with circuit breakers
## Breaking Changes
- Complete dashboard page rewrite (old version backed up)
- New API endpoints require orchestrator service deployment
- Database migrations needed for reasoning fields
## Migration Required
Run migrations to add new model fields:
- purchase_orders: reasoning, consequence, reasoning_data
- production_batches: reasoning, reasoning_data
## Documentation
See DASHBOARD_REDESIGN_SUMMARY.md for complete implementation details,
JTBD analysis, success metrics, and deployment guide.
BREAKING CHANGE: Dashboard page completely redesigned with new data structures
2025-11-07 17:10:17 +00:00
|
|
|
from app.api.dashboard import router as dashboard_router
|
2025-11-30 09:12:40 +01:00
|
|
|
from app.api.enterprise_dashboard import router as enterprise_dashboard_router
|
2025-11-27 15:52:40 +01:00
|
|
|
from app.api.internal import router as internal_router
|
2025-10-30 21:08:07 +01:00
|
|
|
service.add_router(orchestration_router)
|
feat: Complete JTBD-aligned bakery dashboard redesign
Implements comprehensive dashboard redesign based on Jobs To Be Done methodology
focused on answering: "What requires my attention right now?"
## Backend Implementation
### Dashboard Service (NEW)
- Health status calculation (green/yellow/red traffic light)
- Action queue prioritization (critical/important/normal)
- Orchestration summary with narrative format
- Production timeline transformation
- Insights calculation and consequence prediction
### API Endpoints (NEW)
- GET /dashboard/health-status - Overall bakery health indicator
- GET /dashboard/orchestration-summary - What system did automatically
- GET /dashboard/action-queue - Prioritized tasks requiring attention
- GET /dashboard/production-timeline - Today's production schedule
- GET /dashboard/insights - Key metrics (savings, inventory, waste, deliveries)
### Enhanced Models
- PurchaseOrder: Added reasoning, consequence, reasoning_data fields
- ProductionBatch: Added reasoning, reasoning_data fields
- Enables transparency into automation decisions
## Frontend Implementation
### API Hooks (NEW)
- useBakeryHealthStatus() - Real-time health monitoring
- useOrchestrationSummary() - System transparency
- useActionQueue() - Prioritized action management
- useProductionTimeline() - Production tracking
- useInsights() - Glanceable metrics
### Dashboard Components (NEW)
- HealthStatusCard: Traffic light indicator with checklist
- ActionQueueCard: Prioritized actions with reasoning/consequences
- OrchestrationSummaryCard: Narrative of what system did
- ProductionTimelineCard: Chronological production view
- InsightsGrid: 2x2 grid of key metrics
### Main Dashboard Page (REPLACED)
- Complete rewrite with mobile-first design
- All sections integrated with error handling
- Real-time refresh and quick action links
- Old dashboard backed up as DashboardPage.legacy.tsx
## Key Features
### Automation-First
- Shows what orchestrator did overnight
- Builds trust through transparency
- Explains reasoning for all automated decisions
### Action-Oriented
- Prioritizes tasks over information display
- Clear consequences for each action
- Large touch-friendly buttons
### Progressive Disclosure
- Shows 20% of info that matters 80% of time
- Expandable details when needed
- No overwhelming metrics
### Mobile-First
- One-handed operation
- Large touch targets (min 44px)
- Responsive grid layouts
### Trust-Building
- Narrative format ("I planned your day")
- Reasoning inputs transparency
- Clear status indicators
## User Segments Supported
1. Solo Bakery Owner (Primary)
- Simple health indicator
- Action checklist (max 3-5 items)
- Mobile-optimized
2. Multi-Location Owner
- Multi-tenant support (existing)
- Comparison capabilities
- Delegation ready
3. Enterprise/Central Bakery (Future)
- Network topology support
- Advanced analytics ready
## JTBD Analysis Delivered
Main Job: "Help me quickly understand bakery status and know what needs my intervention"
Emotional Jobs Addressed:
- Feel in control despite automation
- Reduce daily anxiety
- Feel competent with technology
- Trust system as safety net
Social Jobs Addressed:
- Demonstrate professional management
- Avoid being bottleneck
- Show sustainability
## Technical Stack
Backend: Python, FastAPI, SQLAlchemy, PostgreSQL
Frontend: React, TypeScript, TanStack Query, Tailwind CSS
Architecture: Microservices with circuit breakers
## Breaking Changes
- Complete dashboard page rewrite (old version backed up)
- New API endpoints require orchestrator service deployment
- Database migrations needed for reasoning fields
## Migration Required
Run migrations to add new model fields:
- purchase_orders: reasoning, consequence, reasoning_data
- production_batches: reasoning, reasoning_data
## Documentation
See DASHBOARD_REDESIGN_SUMMARY.md for complete implementation details,
JTBD analysis, success metrics, and deployment guide.
BREAKING CHANGE: Dashboard page completely redesigned with new data structures
2025-11-07 17:10:17 +00:00
|
|
|
service.add_router(dashboard_router)
|
2025-11-30 09:12:40 +01:00
|
|
|
service.add_router(enterprise_dashboard_router)
|
2025-11-27 15:52:40 +01:00
|
|
|
service.add_router(internal_router)
|
2025-10-30 21:08:07 +01:00
|
|
|
|
2025-11-30 09:12:40 +01:00
|
|
|
# Add enterprise dashboard service to dependencies
|
|
|
|
|
from app.services.enterprise_dashboard_service import EnterpriseDashboardService
|
|
|
|
|
from shared.clients import (
|
|
|
|
|
get_tenant_client,
|
|
|
|
|
get_forecast_client,
|
|
|
|
|
get_production_client,
|
|
|
|
|
get_sales_client,
|
|
|
|
|
get_inventory_client,
|
2025-11-30 16:29:38 +01:00
|
|
|
get_procurement_client,
|
|
|
|
|
get_distribution_client
|
2025-11-30 09:12:40 +01:00
|
|
|
)
|
|
|
|
|
|
|
|
|
|
def get_enterprise_dashboard_service() -> EnterpriseDashboardService:
|
|
|
|
|
tenant_client = get_tenant_client(settings)
|
|
|
|
|
forecast_client = get_forecast_client(settings)
|
|
|
|
|
production_client = get_production_client(settings)
|
|
|
|
|
sales_client = get_sales_client(settings)
|
|
|
|
|
inventory_client = get_inventory_client(settings)
|
2025-11-30 16:29:38 +01:00
|
|
|
distribution_client = get_distribution_client(settings)
|
2025-11-30 09:12:40 +01:00
|
|
|
procurement_client = get_procurement_client(settings)
|
|
|
|
|
|
|
|
|
|
return EnterpriseDashboardService(
|
|
|
|
|
tenant_client=tenant_client,
|
|
|
|
|
forecast_client=forecast_client,
|
|
|
|
|
production_client=production_client,
|
|
|
|
|
sales_client=sales_client,
|
|
|
|
|
inventory_client=inventory_client,
|
|
|
|
|
distribution_client=distribution_client,
|
|
|
|
|
procurement_client=procurement_client
|
|
|
|
|
)
|
|
|
|
|
|
2025-10-30 21:08:07 +01:00
|
|
|
# INTERNAL: Service-to-service endpoints
|
2025-11-21 16:15:09 +01:00
|
|
|
from app.api import internal_demo
|
|
|
|
|
service.add_router(internal_demo.router)
|
2025-10-30 21:08:07 +01:00
|
|
|
|
|
|
|
|
|
|
|
|
|
@app.middleware("http")
|
|
|
|
|
async def logging_middleware(request: Request, call_next):
|
|
|
|
|
"""Add request logging middleware"""
|
|
|
|
|
import time
|
|
|
|
|
|
|
|
|
|
start_time = time.time()
|
|
|
|
|
response = await call_next(request)
|
|
|
|
|
process_time = time.time() - start_time
|
|
|
|
|
|
|
|
|
|
service.logger.info("HTTP request processed",
|
|
|
|
|
method=request.method,
|
|
|
|
|
url=str(request.url),
|
|
|
|
|
status_code=response.status_code,
|
|
|
|
|
process_time=round(process_time, 4))
|
|
|
|
|
|
|
|
|
|
return response
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
if __name__ == "__main__":
|
|
|
|
|
import uvicorn
|
|
|
|
|
uvicorn.run(
|
|
|
|
|
"main:app",
|
|
|
|
|
host="0.0.0.0",
|
|
|
|
|
port=8000,
|
|
|
|
|
reload=settings.DEBUG
|
|
|
|
|
)
|