# Project Index — single runtime discovery entry point for TorbatYar AI Framework.
# Normative rules: docs/ai-framework/master-prompt.md, runtime-read-policy.md
# NEVER scan repository folders to discover services, handovers, roadmaps, snapshots, ADRs, or architecture docs.
# Resolve all paths through this index. Update automatically on service registration and phase completion.

schema_version: 1
updated: "2026-07-26"

execution_order:
  - docs/ai-framework/project-index.yaml
  - docs/ai-framework/runtime-read-policy.md
  - docs/ai-framework/context-cache-policy.md
  - service_snapshot_file
  - docs/ai-framework/phase-manifest.yaml
  - docs/ai-framework/service-manifest.yaml
  - latest_handover
  - additional_documents_per_runtime_read_policy

shared_references:
  phase_manifest: docs/ai-framework/phase-manifest.yaml
  service_manifest: docs/ai-framework/service-manifest.yaml
  module_registry: docs/module-registry.md
  platform_roadmap: docs/roadmap.md

services:
  - service_name: Core Platform
    commercial_product: TorbatYar Platform
    service_identifier: core-platform
    current_status: active
    current_version: "0.4.x"
    current_phase: onboarding-4
    next_phase: null
    snapshot_file: docs/service-snapshots/core-platform.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: core.*
    database_name: core_platform_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: tenant.*
    capability_prefix: core.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Identity & Access
    commercial_product: Torbat Identity
    service_identifier: identity-access
    current_status: active
    current_version: "0.2.x"
    current_phase: identity-2
    next_phase: null
    snapshot_file: docs/service-snapshots/identity-access.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: identity.*
    database_name: identity_access_db
    api_port: 8001
    public_api_prefix: /api/v1
    event_prefix: user.registered
    capability_prefix: identity.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Accounting
    commercial_product: Torbat Accounting
    service_identifier: accounting
    current_status: active
    current_version: "0.5.11.0"
    current_phase: accounting-5.11
    next_phase: null
    snapshot_file: docs/service-snapshots/accounting.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: accounting.*
    database_name: accounting_db
    api_port: 8002
    public_api_prefix: /api/v1
    event_prefix: voucher.posted
    capability_prefix: accounting.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: CRM
    commercial_product: Torbat CRM
    service_identifier: crm
    current_status: active
    current_version: "0.6.3.0"
    current_phase: crm-6.3
    next_phase: null
    snapshot_file: docs/service-snapshots/crm.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: crm.*
    database_name: crm_db
    api_port: 8003
    public_api_prefix: /api/v1
    event_prefix: crm.lead.*
    capability_prefix: crm.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Enterprise Loyalty Platform
    commercial_product: Torbat Loyalty
    service_identifier: loyalty
    current_status: active
    current_version: "0.7.6.0"
    current_phase: loyalty-7.6
    next_phase: loyalty-7.7
    snapshot_file: docs/service-snapshots/loyalty.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: docs/phase-handover/phase-7-6.md
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: loyalty.*
    database_name: loyalty_db
    api_port: 8004
    public_api_prefix: /api/v1
    event_prefix: loyalty.program.*
    capability_prefix: loyalty.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Enterprise Communication Platform
    commercial_product: Torbat Communication
    service_identifier: communication
    current_status: active
    current_version: "0.8.10.1"
    current_phase: communication-8
    next_phase: null
    snapshot_file: docs/service-snapshots/communication.yaml
    roadmap_file: docs/communication-roadmap.md
    latest_handover: docs/phase-handover/phase-8.md
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: communication.*
    database_name: communication_db
    api_port: 8005
    public_api_prefix: /api/v1
    event_prefix: communication.message.*
    capability_prefix: communication.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Sports Center Platform
    commercial_product: Sports Center
    service_identifier: sports_center
    current_status: active
    current_version: "0.9.7.0"
    current_phase: sports-center-9.7
    next_phase: sports-center-9.8
    snapshot_file: docs/service-snapshots/sports-center.yaml
    roadmap_file: docs/sports-center-roadmap.md
    latest_handover: docs/phase-handover/phase-9-7.md
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: sports_center.*
    database_name: sports_center_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: sports_center.member.*
    capability_prefix: sports_center.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Delivery & Fleet Platform
    commercial_product: Torbat Driver
    service_identifier: delivery
    current_status: active
    current_version: "0.10.1.0"
    current_phase: delivery-10.1
    next_phase: delivery-10.2
    snapshot_file: docs/service-snapshots/delivery.yaml
    roadmap_file: docs/delivery-roadmap.md
    latest_handover: docs/phase-handover/phase-10-1.md
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: delivery.*
    database_name: delivery_db
    api_port: 8007
    public_api_prefix: /api/v1
    event_prefix: delivery.driver.*
    capability_prefix: delivery.*
    health_endpoint: /health
    metrics_endpoint: /metrics

  - service_name: Enterprise Experience Platform
    commercial_product: Torbat Pages
    service_identifier: experience
    current_status: active
    current_version: "0.11.3.0"
    current_phase: experience-11.3
    next_phase: experience-11.4
    snapshot_file: docs/service-snapshots/experience.yaml
    roadmap_file: docs/experience-roadmap.md
    latest_handover: docs/phase-handover/phase-11-3.md
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: experience.*
    database_name: experience_db
    api_port: 8008
    public_api_prefix: /api/v1
    event_prefix: experience.site.*
    capability_prefix: experience.*
    health_endpoint: /health
    metrics_endpoint: /metrics

  - service_name: Hospitality Platform
    commercial_product: Torbat Food
    service_identifier: hospitality
    current_status: active
    current_version: "0.12.8.0"
    current_phase: hospitality-12.8
    next_phase: hospitality-12.9
    snapshot_file: docs/service-snapshots/hospitality.yaml
    roadmap_file: docs/hospitality-roadmap.md
    latest_handover: docs/phase-handover/phase-12-8.md
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: hospitality.*
    database_name: hospitality_db
    api_port: 8009
    public_api_prefix: /api/v1
    event_prefix: hospitality.venue.*
    capability_prefix: hospitality.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Restaurant / Cafe (historical scaffold)
    commercial_product: Torbat Food
    service_identifier: restaurant
    current_status: superseded
    current_version: "0.12.1.0"
    current_phase: hospitality-12.1
    next_phase: null
    snapshot_file: null
    roadmap_file: docs/hospitality-roadmap.md
    latest_handover: docs/phase-handover/phase-12-1.md
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: hospitality.*
    database_name: hospitality_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: hospitality.*
    capability_prefix: hospitality.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Ecommerce
    commercial_product: Torbat Commerce
    service_identifier: ecommerce
    current_status: scaffolded
    current_version: "0.0.0"
    current_phase: ecommerce-foundation
    next_phase: null
    snapshot_file: docs/service-snapshots/ecommerce.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: ecommerce.*
    database_name: ecommerce_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: order.*
    capability_prefix: ecommerce.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Marketplace
    commercial_product: Torbat Marketplace
    service_identifier: marketplace
    current_status: planned
    current_version: "0.0.0"
    current_phase: marketplace-foundation
    next_phase: null
    snapshot_file: docs/service-snapshots/marketplace.yaml
    roadmap_file: docs/phases/Marketplace/README.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: marketplace.*
    database_name: TBD
    api_port: null
    public_api_prefix: TBD
    event_prefix: null
    capability_prefix: marketplace.*
    health_endpoint: TBD
    metrics_endpoint: null

  - service_name: Automation
    commercial_product: Torbat Automation
    service_identifier: automation
    current_status: planned
    current_version: "0.0.0"
    current_phase: automation-foundation
    next_phase: null
    snapshot_file: docs/service-snapshots/automation.yaml
    roadmap_file: docs/phases/Automation/README.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: automation.*
    database_name: TBD
    api_port: null
    public_api_prefix: TBD
    event_prefix: null
    capability_prefix: automation.*
    health_endpoint: TBD
    metrics_endpoint: null

  - service_name: Academy
    commercial_product: Torbat Academy
    service_identifier: academy
    current_status: planned
    current_version: "0.0.0"
    current_phase: academy-foundation
    next_phase: null
    snapshot_file: docs/service-snapshots/academy.yaml
    roadmap_file: docs/phases/Future/README.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: academy.*
    database_name: academy_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: null
    capability_prefix: academy.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Clinic
    commercial_product: Torbat Clinic
    service_identifier: clinic
    current_status: planned
    current_version: "0.0.0"
    current_phase: clinic-foundation
    next_phase: null
    snapshot_file: docs/service-snapshots/clinic.yaml
    roadmap_file: docs/phases/Future/README.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: clinic.*
    database_name: clinic_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: null
    capability_prefix: clinic.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Hotel
    commercial_product: Torbat Hotel
    service_identifier: hotel
    current_status: planned
    current_version: "0.0.0"
    current_phase: hotel-foundation
    next_phase: null
    snapshot_file: docs/service-snapshots/hotel.yaml
    roadmap_file: docs/phases/Future/README.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: hotel.*
    database_name: hotel_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: null
    capability_prefix: hotel.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Tourism
    commercial_product: Torbat Tourism
    service_identifier: tourism
    current_status: planned
    current_version: "0.0.0"
    current_phase: tourism-foundation
    next_phase: null
    snapshot_file: docs/service-snapshots/tourism.yaml
    roadmap_file: docs/phases/Future/README.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: tourism.*
    database_name: tourism_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: null
    capability_prefix: tourism.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: AI Assistant
    commercial_product: Torbat AI
    service_identifier: ai_assistant
    current_status: scaffolded
    current_version: "0.0.0"
    current_phase: ai-assistant-foundation
    next_phase: null
    snapshot_file: docs/service-snapshots/ai-assistant.yaml
    roadmap_file: docs/phases/AI/README.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: ai_assistant.*
    database_name: ai_assistant_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: assistant.*
    capability_prefix: ai_assistant.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Website Builder
    commercial_product: Torbat Pages
    service_identifier: website_builder
    current_status: scaffolded
    current_version: "0.0.0"
    current_phase: future-services
    next_phase: null
    snapshot_file: null
    roadmap_file: docs/experience-roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: website_builder.*
    database_name: website_builder_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: null
    capability_prefix: website_builder.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Live Chat
    commercial_product: Torbat Live Chat
    service_identifier: live_chat
    current_status: scaffolded
    current_version: "0.0.0"
    current_phase: future-services
    next_phase: null
    snapshot_file: docs/service-snapshots/live-chat.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: live_chat.*
    database_name: live_chat_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: conversation.*
    capability_prefix: live_chat.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Smart Messenger
    commercial_product: Torbat Messenger
    service_identifier: smart_messenger
    current_status: scaffolded
    current_version: "0.0.0"
    current_phase: future-services
    next_phase: null
    snapshot_file: docs/service-snapshots/smart-messenger.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: smart_messenger.*
    database_name: smart_messenger_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: null
    capability_prefix: smart_messenger.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: SMS Panel
    commercial_product: Torbat SMS
    service_identifier: sms_panel
    current_status: scaffolded
    current_version: "0.0.0"
    current_phase: sms-panel-future
    next_phase: null
    snapshot_file: docs/service-snapshots/sms-panel.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: sms_panel.*
    database_name: sms_panel_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: null
    capability_prefix: sms_panel.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Notification
    commercial_product: Torbat Notification
    service_identifier: notification
    current_status: scaffolded
    current_version: "0.0.0"
    current_phase: future-services
    next_phase: null
    snapshot_file: docs/service-snapshots/notification.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: notification.*
    database_name: notification_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: null
    capability_prefix: notification.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: File Storage
    commercial_product: Torbat Storage
    service_identifier: file_storage
    current_status: scaffolded
    current_version: "0.0.0"
    current_phase: future-services
    next_phase: null
    snapshot_file: docs/service-snapshots/file-storage.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: file_storage.*
    database_name: file_storage_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: null
    capability_prefix: file_storage.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Link Shortener
    commercial_product: Torbat Links
    service_identifier: link_shortener
    current_status: scaffolded
    current_version: "0.0.0"
    current_phase: future-services
    next_phase: null
    snapshot_file: docs/service-snapshots/link-shortener.yaml
    roadmap_file: docs/roadmap.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: link_shortener.*
    database_name: link_shortener_db
    api_port: null
    public_api_prefix: /api/v1
    event_prefix: null
    capability_prefix: link_shortener.*
    health_endpoint: /health
    metrics_endpoint: null

  - service_name: Frontend
    commercial_product: TorbatYar UI
    service_identifier: frontend
    current_status: active
    current_version: "Next-15.5.x"
    current_phase: onboarding-4
    next_phase: null
    snapshot_file: null
    roadmap_file: docs/frontend/README.md
    latest_handover: null
    phase_manifest_reference: docs/ai-framework/phase-manifest.yaml
    service_manifest_reference: docs/ai-framework/service-manifest.yaml
    module_registry_reference: docs/module-registry.md
    permission_prefix: UI gated by /me roles
    database_name: null
    api_port: null
    public_api_prefix: consumes /api/v1
    event_prefix: null
    capability_prefix: null
    health_endpoint: null
    metrics_endpoint: null

framework_workstreams:
  - workstream_id: ai-framework
    description: AI Development Framework (docs-only)
    project_index_handover: docs/phase-handover/phase-af-project-index.md
    snapshot_file: null
