01. Visão Geral
O Proj123zap-AWS consolida, em um único mono-repo, a infraestrutura e
os serviços que antes estavam distribuídos em múltiplos repositórios isolados por
stack. Esta página existe para dar contexto rápido do todo: por que a migração foi
feita, como os módulos se relacionam e onde localizar os templates SAM que refletem
o estado real das stacks em produção. O foco é reduzir perda de visibilidade operacional, evitar divergência entre código
e ambiente AWS e manter um padrão claro de manutenção por módulo. O recorte atual
considera as stacks produtivas em us-east-1, organizadas em
repos/, com documentação de suporte em docs/.
| Tópico | Descrição | Referência |
|---|---|---|
| Intenção | Dar visibilidade única do projeto, padronizar leitura e reduzir drift entre código e produção. | Repositório no GitHub |
| Resumo | Projeto Proj123zap-AWS, região principal us-east-1, com 6 módulos e 24 stacks mapeadas. |
docs/overview/repo-stack-mapping.md |
| Escopo | Cobertura atual de infraestrutura e serviços organizados em módulos dentro de repos/. |
docs/overview/README.md |
| Ambiente | Base de referência em produção: conta AWS com stacks em us-east-1. |
docs/overview/repo-stack-mapping.md |
| Especificações | Padrão por módulo com templates SAM em infra/sam/templates e código em app/lambdas. |
docs/guides/repo-template/README.md |
| Migração | Histórico incremental de validação e paridade funcional das stacks migradas. | docs/migrates/README.md |
02. Índice Rápido de Repos e Templates
Este índice é a visão operacional da migração: cada linha representa uma stack produtiva, associada ao seu módulo no mono-repo e ao template SAM correspondente. O objetivo é acelerar análise de impacto, auditoria de paridade e troubleshooting, com navegação direta para os arquivos reais no GitHub.
| Repo | Descrição | Templates |
|---|---|---|
| repos/core CORE |
Stack proj123zap-core-layers: publicação de layers compartilhadas para módulos dependentes. |
layers.yaml |
| repos/core CORE |
Stack proj123zap-core-policies: políticas IAM base reutilizadas no ecossistema. |
policies.yaml |
| repos/core CORE |
Stack proj123zap-core-s3: bucket e recursos de storage compartilhado. |
s3.yaml |
| repos/core CORE |
Stack proj123zap-core-secrets: segredos centrais consumidos pelos serviços. |
secrets.yaml |
| repos/core CORE |
Stack proj123zap-core-seed: inicialização/seed de dados e artefatos base. |
seed.yaml
|
| repos/interface INTERFACE |
Stack proj123zap-interface-apigateway: ponto de entrada HTTP e roteamento de API. |
apigateway.yaml |
| repos/interface INTERFACE |
Stack proj123zap-interface-cognito: autenticação, usuários e autorização base. |
cognito.yaml |
| repos/interface INTERFACE |
Stack proj123zap-interface-dynamodb: persistência de dados da camada de interface. |
dynamodb.yaml
|
| repos/channels-services CHANNELS |
Stack proj123zap-channels-services-dynamodb: tabelas de configuração e operação de canais. |
dynamodb.yaml |
| repos/channels-services CHANNELS |
Stack proj123zap-channels-services-kms: gerenciamento de chaves e criptografia de canais. |
kms.yaml |
| repos/channels-services CHANNELS |
Stack proj123zap-channels-services-layers: layers reutilizáveis do domínio de canais. |
layers.yaml |
| repos/channels-services CHANNELS |
Stack proj123zap-channels-services-routes: rotas e handlers de serviços de canais. |
routes.yaml
|
| repos/routes ROUTES |
Stack proj123zap-routes-01-login: autenticação e rotas de login. |
routes-01-login.yaml |
| repos/routes ROUTES |
Stack proj123zap-routes-02-profiles: operações e APIs de perfis. |
routes-02-profiles.yaml |
| repos/routes ROUTES |
Stack proj123zap-routes-03-dashboard: endpoints e processamento de dashboard. |
routes-03-dashboard.yaml |
| repos/routes ROUTES |
Stack proj123zap-routes-06-templates: gestão de templates e integrações relacionadas. |
routes-06-templates.yaml |
| repos/routes ROUTES |
Stack proj123zap-routes-07-campaigns: fluxos e APIs de campanhas. |
routes-07-campaigns.yaml |
| repos/routes ROUTES |
Stack proj123zap-routes-09-webhooks: recebimento e tratamento de webhooks. |
routes-09-webhooks.yaml |
| repos/routes ROUTES |
Stack proj123zap-routes-erp-atlas: integração específica do ERP Atlas. |
routes-erp-atlas.yaml
|
| repos/services SERVICES |
Stack proj123zap-services-dynamodb: armazenamento de apoio a serviços assíncronos. |
dynamodb.yaml |
| repos/services SERVICES |
Stack proj123zap-services-eventbridge: agendamentos e disparos por eventos. |
eventbridge.yaml |
| repos/services SERVICES |
Stack proj123zap-services-sqs: provisionamento de filas de processamento. |
sqs.yaml
|
| repos/listings-orchestrator LISTINGS |
Stack proj123zap-listings-integration: orquestração de integrações e listagens. |
orchestrator-routes.yaml |
| repos/listings-orchestrator LISTINGS |
Stack proj123zap-audit-trail: trilha de auditoria e consulta de execução. |
audit-trail.yaml
|