Diagrama C4 — Contexto¶

O diagrama de contexto mostra o AMia e seus relacionamentos com atores externos e sistemas de integração.

C4Context
    title AMia — Diagrama de Contexto

    Person(dev, "Desenvolvedor", "Usa MCP Server e CLI para gerar código e testes localmente")
    Person(po, "Product Owner", "Cria projetos, refina backlog e acompanha iterações via Portal")
    Person(arch, "Arquiteto", "Gera e valida specs de arquitetura via Portal")
    Person(admin, "Administrador", "Gerencia usuários, prompts e monitoramento via Portal")

    System(amia, "AMia Platform", "Workspace GenAI para desenvolvimento de software — Portal, Core, Agents, MCP Server, CLI")

    System_Ext(azure_ad, "Azure AD / Entra ID", "SSO corporativo, OAuth2/OIDC, RBAC")
    System_Ext(anthropic, "Anthropic Claude", "LLM primário para geração de conteúdo")
    System_Ext(gemini, "Google Gemini", "LLM de contingência (fallback automático)")
    System_Ext(git, "Repositórios Git", "Repositórios dos projetos dos clientes")
    System_Ext(elastic, "Elasticsearch / Grafana", "Observabilidade, métricas de LLM e auditoria")

    Rel(dev, amia, "Usa via MCP Server / CLI / Portal")
    Rel(po, amia, "Usa via Portal Web")
    Rel(arch, amia, "Usa via Portal Web")
    Rel(admin, amia, "Administra via Portal Web")
    Rel(amia, azure_ad, "Autentica usuários — OAuth2/OIDC")
    Rel(amia, anthropic, "Gera specs, código e testes — HTTPS")
    Rel(amia, gemini, "Fallback automático de LLM — HTTPS")
    Rel(amia, git, "Lê e escreve código via MCP Server")
    Rel(amia, elastic, "Envia spans, logs e métricas de LLM")