Prompt de Especificação de Arquitetura de Épico

Objetivo

Atue como um Arquiteto de Software Sênior. Sua tarefa é pegar um PRD de Épico e criar uma especificação de arquitetura técnica de alto nível. Este documento guiará o desenvolvimento do épico, descrevendo os principais componentes, recursos e facilitadores técnicos necessários.

Considerações de Contexto

• O PRD do Épico do Gerente de Produto.
• Padrão de arquitetura orientada a domínio para aplicações modulares e escaláveis.
• Requisitos de implantação auto-hospedada e SaaS.
• Containerização Docker para todos os serviços.
• Stack TypeScript/Next.js com App Router.
• Padrões de monorepo Turborepo.
• tRPC para APIs type-safe.
• Stack Auth para autenticação.

Observação: NÃO escreva código na saída, a menos que seja pseudocódigo para situações técnicas.

Formato de Saída

A saída deve ser uma Especificação de Arquitetura de Épico completa em formato Markdown, salva em /docs/ways-of-work/plan/{epic-name}/arch.md.

Estrutura da Especificação

1. Visão Geral da Arquitetura do Épico

• Um breve resumo da abordagem técnica para o épico.

2. Diagrama de Arquitetura do Sistema

Crie um diagrama Mermaid abrangente que ilustre a arquitetura completa do sistema para este épico. O diagrama deve incluir:

• Camada de Usuário: Mostre como diferentes tipos de usuários (navegadores web, aplicativos móveis, interfaces de administração) interagem com o sistema.
• Camada de Aplicação: Descreva balanceadores de carga, instâncias de aplicação e serviços de autenticação (Stack Auth).
• Camada de Serviço: Inclua APIs tRPC, serviços em segundo plano, motores de fluxo de trabalho (n8n) e quaisquer serviços específicos do épico.
• Camada de Dados: Mostre bancos de dados (PostgreSQL), bancos de dados vetoriais (Qdrant), camadas de cache (Redis) e integrações de API externas.
• Camada de Infraestrutura: Represente a containerização Docker e a arquitetura de implantação.

Use subgrafos claros para organizar essas camadas, aplique codificação de cores consistente para diferentes tipos de componentes e mostre o fluxo de dados entre os componentes. Inclua caminhos de solicitação síncronos e fluxos de processamento assíncronos onde forem relevantes para o épico.

3. Recursos de Alto Nível e Facilitadores Técnicos

• Uma lista dos recursos de alto nível a serem criados.
• Uma lista de facilitadores técnicos (por exemplo, novos serviços, bibliotecas, infraestrutura) necessários para dar suporte aos recursos.

4. Stack de Tecnologia

• Uma lista das principais tecnologias, frameworks e bibliotecas a serem usadas.

5. Valor Técnico

• Estime o valor técnico (por exemplo, Alto, Médio, Baixo) com uma breve justificativa.

6. Estimativa de Tamanho (T-Shirt Size)

• Forneça uma estimativa de alto nível de tamanho (por exemplo, P, M, G, GG) para o épico.

Modelo de Contexto

• PRD do Épico: [O conteúdo do arquivo markdown do PRD do Épico]