Handbook da Engenharia

O sistema operacional da engenharia da AEX Hub Capital. Este handbook explica como pensamos, construímos, documentamos e escalamos software. É a leitura inicial de todo desenvolvedor e a base do onboarding.

Aqui está a narrativa e o contexto. As regras detalhadas vivem em standards/. Quando um assunto tiver padrão formal, este handbook aponta para ele em vez de repetir.

---

Como usar este handbook

---

Quem somos

Somos a área responsável por toda a engenharia de software do grupo. Transformamos estratégia em produto e produto em escala.

Centralizamos competências que, em muitas empresas, vivem dispersas. Aqui elas operam como um único organismo — com padrões compartilhados, ferramentas comuns e uma cultura de qualidade que não negocia.

A AEX Hub Capital é uma Venture Builder e Holding de Tecnologia: criamos, validamos, operamos e escalamos produtos próprios. Nosso modelo é o de uma fábrica de MVPs — lançar rápido, validar hipóteses e investir em infraestrutura complexa apenas quando o mercado valida.

---

Nossa filosofia

Princípios não são pôsteres na parede. São decisões que tomamos todos os dias, no código e fora dele.

• Simplicidade acima de complexidade — a solução mais simples que resolve vence.
• Padronização acima de improvisação — quando o padrão é claro, ninguém perde tempo decidindo o óbvio.
• Documentação faz parte do desenvolvimento — não documentado é não entregue.
• Automação sempre que possível — se você fez duas vezes na mão, a terceira é da máquina.
• Infraestrutura escalável apenas quando necessária — começamos simples e migramos quando a demanda justificar.
• Fácil de entender por qualquer desenvolvedor — legível para humanos primeiro, eficiente para máquinas depois.

---

Estrutura organizacional

Uma hierarquia enxuta, desenhada para decisão rápida hoje e crescimento orgânico amanhã.

• CTO / Líder de Tecnologia — define a estratégia técnica e a arquitetura do grupo. Enquanto a estrutura amadurece, também exerce o papel de Tech Lead, conduzindo o time de perto.
• Tech Leads — lideram squads e garantem o padrão.
• Desenvolvedores — constroem o produto no dia a dia.
• Camada transversal (Plataforma) — acelera todos os squads com base comum.

Conforme a empresa cresce, desenvolvedores evoluem para Tech Leads, liderando equipes e novos projetos.

---

Fluxo oficial de desenvolvimento

Da ideia à produção, todo trabalho percorre o mesmo caminho. Previsível por design.

1. Oportunidade — um problema ou oportunidade é identificado.
2. Roadmap — priorizada e posicionada no plano de produto.
3. Milestone — agrupada num marco com objetivo claro.
4. Tarefa — a funcionalidade vira uma tarefa rastreável.
5. Subtarefas — quebrada em passos pequenos e entregáveis.
6. Código — escrito seguindo o padrão.
7. Pull Request — submetido com descrição e documentação.
8. Code Review — outro engenheiro revisa e aprova.
9. Deploy — publicado via pipeline automatizado.
10. Produção — no ar, gerando valor para o usuário.

O detalhamento de cada etapa está nos padrões: gestão em CLICKUP_STANDARD, código e PRs em GITHUB_STANDARD, publicação em DEPLOY_STANDARD.

---

Padrões oficiais

As regras que valem para todos os projetos. Leia-as em standards/:

• CLICKUP_STANDARD — gestão, hierarquia e status de tarefas.
• GITHUB_STANDARD — estrutura de repositório e documentação técnica.
• DOCUMENTATION_STANDARD — documentos obrigatórios de todo projeto.
• BRANCH_STANDARD — modelo de branches.
• COMMIT_STANDARD — padrão de commits.
• DEPLOY_STANDARD — pipeline e publicação.

---

Plano de carreira

Um caminho claro de evolução. Cada degrau traz mais autonomia, mais impacto e crescimento financeiro proporcional.

Na AEX, liderança é construída internamente sempre que possível. Crescer aqui é o caminho padrão — não a exceção.

---

Onboarding

O primeiro dia de um novo desenvolvedor é planejado: do acesso à primeira entrega, sem fricção. Siga o roteiro em ONBOARDING.md.

---

Regras oficiais

As leis da AEX Engineering. Curtas, inegociáveis, válidas para todos os projetos.

1. Código vive no GitHub. Gestão vive no ClickUp.
2. Se não está no ClickUp, não existe.
3. Toda feature pertence a uma Milestone → tarefa principal → subtarefas.
4. Nenhum Pull Request sem documentação.
5. Documentação faz parte da entrega.
6. Automatize antes de repetir.
7. Arquitetura antes de implementação.
8. Sempre pensar em escalabilidade.