Improve the frontend 5

services/external/app/models/__init__.py

@@ -25,6 +25,7 @@ from .weather import (
 
 from .city_weather import CityWeatherData
 from .city_traffic import CityTrafficData
+from .calendar import SchoolCalendar, TenantLocationContext
 
 # List all models for easier access
 __all__ = [
@@ -38,5 +39,8 @@ __all__ = [
     # City-based models (new)
     "CityWeatherData",
     "CityTrafficData",
+    # Calendar models (hyperlocal)
+    "SchoolCalendar",
+    "TenantLocationContext",
     "AuditLog",
 ]

services/external/app/models/calendar.py

@@ -0,0 +1,86 @@
+# services/external/app/models/calendar.py
+"""
+School Calendar and Tenant Location Context Models
+Hyperlocal data for demand forecasting
+"""
+
+from sqlalchemy import Column, String, DateTime, Index, Boolean
+from sqlalchemy.dialects.postgresql import UUID, JSONB
+from datetime import datetime
+import uuid
+
+from app.core.database import Base
+
+
+class SchoolCalendar(Base):
+    """City-based school calendar data for forecasting"""
+
+    __tablename__ = "school_calendars"
+
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    city_id = Column(String(50), nullable=False, index=True)
+    calendar_name = Column(String(100), nullable=False)
+    school_type = Column(String(20), nullable=False)  # primary, secondary, university
+    academic_year = Column(String(10), nullable=False)  # e.g., "2024-2025"
+
+    # Holiday periods as array of date ranges
+    # Example: [
+    #   {"name": "Christmas", "start": "2024-12-20", "end": "2025-01-08"},
+    #   {"name": "Easter", "start": "2025-04-10", "end": "2025-04-21"},
+    #   {"name": "Summer", "start": "2025-06-23", "end": "2025-09-09"}
+    # ]
+    holiday_periods = Column(JSONB, nullable=False, default=list)
+
+    # School hours configuration
+    # Example: {
+    #   "morning_start": "09:00",
+    #   "morning_end": "14:00",
+    #   "afternoon_start": "15:00",  # if applicable
+    #   "afternoon_end": "17:00",
+    #   "has_afternoon_session": false
+    # }
+    school_hours = Column(JSONB, nullable=False, default=dict)
+
+    # Metadata
+    source = Column(String(100), nullable=True)  # e.g., "madrid_education_dept"
+    enabled = Column(Boolean, default=True, nullable=False)
+
+    created_at = Column(DateTime(timezone=True), default=datetime.utcnow)
+    updated_at = Column(DateTime(timezone=True), default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    __table_args__ = (
+        Index('idx_school_calendar_city_year', 'city_id', 'academic_year'),
+        Index('idx_school_calendar_city_type', 'city_id', 'school_type'),
+    )
+
+
+class TenantLocationContext(Base):
+    """Tenant-specific location context for hyperlocal forecasting"""
+
+    __tablename__ = "tenant_location_contexts"
+
+    tenant_id = Column(UUID(as_uuid=True), primary_key=True)
+    city_id = Column(String(50), nullable=False, index=True)
+
+    # School calendar assignment
+    school_calendar_id = Column(UUID(as_uuid=True), nullable=True, index=True)
+
+    # Hyperlocal context
+    neighborhood = Column(String(100), nullable=True)
+
+    # Custom local events specific to this tenant's location
+    # Example: [
+    #   {"name": "Neighborhood Festival", "date": "2025-06-15", "impact": "high"},
+    #   {"name": "Local Market Day", "date": "2025-05-20", "impact": "medium"}
+    # ]
+    local_events = Column(JSONB, nullable=True, default=list)
+
+    # Additional metadata
+    notes = Column(String(500), nullable=True)
+
+    created_at = Column(DateTime(timezone=True), default=datetime.utcnow)
+    updated_at = Column(DateTime(timezone=True), default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    __table_args__ = (
+        Index('idx_tenant_location_calendar', 'school_calendar_id'),
+    )