ai_orchestrator/docs/architecture/06_internal_interfaces.md

Internal Interfaces

Orchestrator Application Ports

TaskRepository

• create task
• update task
• get task by id
• list active tasks

GraphRepository

• save graph
• get graph
• update node state
• list ready nodes

ConfirmationRepository

• create confirmation
• get confirmation
• resolve confirmation

WorkerRepository

• register session
• update heartbeat
• assign command
• complete command

EventStore

• append event
• list events by task

PolicyEvaluator

• evaluate action descriptor against project policy

ModelRouter

• execute model request and return structured invocation result

ToolGateway

• call MCP tool and return normalized result

WorkerGateway

• dispatch command to worker and receive normalized result

Design Rule

Application services зависят только от этих портов. Ни один use case не должен напрямую импортировать HTTP handlers, DB session objects или конкретный MCP/WebSocket client.