Documentação — marketing
Índice completo da documentação do monorepo marketing. Toda doc do projeto vive em .project/docs/, cujo primeiro nível é um conjunto fechado de pastas.
O repositório é um monorepo: o código das aplicações fica em modules/ (hoje só automation — n8n + Aurora), mas a documentação é sempre desta raiz, nunca dentro de um módulo.
Specs
Mudanças planejadas ou já executadas, em ordem cronológica.
| Doc | Descrição | Status | Certainty |
|---|---|---|---|
| 20260327123719_update_infra_terraform_skills | Reescrita das skills infra e terraform do commons para os padrões atuais |
done | high |
| 20260327123720_leads_standalone_migrations | Setup mínimo de Ruby/ActiveRecord para rodar migrations no banco de leads | done | high |
| 20260327131905_migrations_from_pg_dump | Gerar migrations organizadas a partir de um dump do PostgreSQL | done | high |
| 20260327135450_refactor_migrations_to_rails_dsl | Migrar as 23 migrations de SQL cru para a DSL do ActiveRecord | done | high |
| 20260331150908_per_schema_schema_files | Um arquivo de schema por schema do PostgreSQL, em db/schemas/ |
done | high |
| 20260331180000_load_data_from_dump | Task Rake e target de make para restaurar um dump SQL só-de-dados | done | high |
| 20260401000001_standardize_project_structure | Adotar o padrão de compose/.env/Dockerfile do commons |
done | high |
| 20260402115412_n8n_workflow_versioning | Versionar os workflows do n8n como JSONs no Git, com export e deploy | done | high |
| 20260419000000_add_deploy_ci_workflows | Pipelines de deploy de staging e produção no padrão ibft-corp/pipelines |
done | high |
| 20260420171944_marketing_monorepo_restructure | Transformar o repo em monorepo marketing com namespace marketing-automation |
done | high |
| 20260626091613_db_ip_allowlist_make_rule | Regra make db.ip.allow para liberar IP no security group do banco |
done | high |
| 20260630144309_migrate_n8n_staging_to_eks_aurora | Mover o n8n de staging do DOKS para EKS + Aurora na VPC compartilhada, com ward | done | high |
| 20260706231555_cutover_messagebroker_amazon_mq | Apontar o n8n do RabbitMQ na DO para o Amazon MQ (AMQPS 5671) | done | high |
| 20260707102522_dedicated_leads_aurora_cluster | Cluster Aurora dedicado ao leads, com writer e reader, por ambiente | done | high |
| 20260707114603_clone_n8n_staging_db_to_production | Clone único do banco do n8n de staging para produção | done | high |
| 20260708083226_upgrade_n8n_to_2x | Atualizar o n8n de 1.63.4 para 2.28.5 (staging feito, produção pendente) | in_progress | high |
| 20260710000000_leads_db_public_access | VPC pública mkt com peering, para acesso externo ao Aurora de leads |
done | high |
| 20260731210414_remove_db_ip_allow_improve_help | Remover o db.ip.allow e agrupar o make help por projeto/commons |
proposed | high |
Learnings
Aprendizados retrospectivos.
| Doc | Descrição | Certainty |
|---|---|---|
| database_aurora_password_authentication | Aurora com conectividade gerenciada (rdsrelay) só aceita autenticação IAM; senha exige VPC própria |
high |
| database_cluster_vpc_is_fixed_at_creation | A VPC de um cluster RDS/Aurora é fixada na criação; mudar exige snapshot/restore | high |
Categorias sem conteúdo
plans/, features/, architecture/, guides/ e reference/<scope>/ fazem parte do conjunto fechado, mas ainda não têm documentos neste projeto. Não há regras de negócio registradas, portanto não existe RULES.md.