# finops-architect-toolkit

Calculadoras de FinOps na AWS: RI vs On-Demand, classes do S3, Lambda e tagging

- URL: https://fernando.moretes.com/open-source/finops-architect-toolkit

- Markdown: https://fernando.moretes.com/open-source/finops-architect-toolkit/guide.md?lang=pt

- GitHub: https://github.com/fernando-moretes/ref-finops-architect-toolkit

- Language: TypeScript

- Topics: 

- Stars: 0

- Forks: 0

- Updated: 2026-09-29T16:21:02Z

---

O FinOps Architect Toolkit é uma aplicação Next.js com as quatro contas que mais aparecem em revisão de custo na AWS: Reserved Instance contra On-Demand, classe de armazenamento do S3, custo de Lambda e estratégia de tags para alocação.

## Por que este repositório existe

Em toda revisão de custo de que participei, a conversa travava no mesmo ponto: alguém de compras pergunta "vale a pena reservar?", alguém de engenharia responde "depende", e a reunião acaba sem número. O README resume a premissa: decisões de arquitetura definem cerca de 80% da conta, então a pergunta de FinOps cai no colo do arquiteto, quer ele queira ou não.

A pergunta que importa não é "quanto custa?", é "o que otimizar primeiro, e com que compromisso?". Para responder isso na própria reunião, preciso de contas rápidas, reproduzíveis e que falem a língua de compras (compromisso, break-even, período) e a de engenharia (invocações, duração, memória, padrão de acesso).

Este toolkit é isso: um conjunto pequeno de calculadoras e modelos que levo para essa conversa. Não substitui o Cost Explorer nem o Compute Optimizer. Ele serve para o momento anterior, quando você ainda está decidindo o desenho e quer saber a ordem de grandeza antes de abrir o console.

## O que vem no toolkit

- **EC2 RI vs On-Demand:** calculadora com análise de break-even, o mês em que o compromisso passa a compensar.
- **Otimizador de classe do S3:** compara Standard, IA, Glacier e Deep Archive para o mesmo volume.
- **Estimador de custo de Lambda:** por número de invocações, duração e memória configurada.
- **Gerador de estratégia de tags:** alinhado aos casos de uso de alocação de FinOps.
- **Modelos de relatório de alocação e padrões de showback/chargeback:** para levar o número da engenharia até o centro de custo.

## Como o toolkit entra numa revisão de custo

O fluxo é de decisão, não de infraestrutura: entradas da carga de trabalho viram números comparáveis, e as tags garantem que o resultado chegue a quem paga.

### ▲ Vercel: Next.js 16 app

- RI vs On-Demand break-even (compute)
- S3 class optimizer Standard/IA/Glacier/Deep Archive (storage)
- Lambda estimator invocations × duration × memory (compute)
- Tagging strategy generator (security)

### 📤 Saída: decisão / Output: decision

- Cost allocation report showback / chargeback (data)
- Compras e financeiro Procurement & finance (external)

### Fluxos

- arch -> ri: horas de uso e prazo
- arch -> s3: volume e padrão de acesso
- arch -> lambda: invocações, duração, memória
- arch -> tags: dimensões de alocação
- tags -> report: chaves de alocação
- ri -> report: custo projetado
- s3 -> report: custo projetado
- lambda -> report: custo projetado
- report -> fin: showback ou chargeback

## Instalar e rodar localmente

1. **Clone o repositório**: `git clone https://github.com/fernando-moretes/ref-finops-architect-toolkit.git` e entre na pasta. A aplicação mora em `frontend/`, não na raiz.

2. **Instale as dependências**: `cd frontend && npm install`. A stack é Next.js 16, React 19, TypeScript 5 e Tailwind CSS 4, então use um Node recente.

3. **Suba o servidor de desenvolvimento**: `npm run dev` e abra o endereço que o Next imprimir no terminal. Não há credencial AWS envolvida: as calculadoras rodam com os números que você digita.

4. **Leia a operação antes de publicar**: `OPERATIONS.md` e `SETUP.md` descrevem deploy e CI; `docs/architecture.md` descreve o desenho. A versão publicada roda na Vercel com DNS na Cloudflare.

_Quickstart_

```bash
git clone https://github.com/fernando-moretes/ref-finops-architect-toolkit.git
cd ref-finops-architect-toolkit/frontend
npm install
npm run dev
```

## Como usar cada calculadora sem se enganar

**RI vs On-Demand:** o break-even é a parte que vale a reunião. Reserva só compensa se a instância roda horas suficientes por mês durante o prazo inteiro; uma carga que vai ser migrada para container em seis meses não deveria entrar num compromisso de um ou três anos, por melhor que seja o desconto.

**Classe do S3:** a comparação por GB armazenado engana quando você esquece o resto da fatura. Standard-IA tem duração mínima de 30 dias e cobra objeto pequeno como se tivesse 128 KB; Glacier Flexible Retrieval tem mínimo de 90 dias e Deep Archive de 180, além do custo de recuperação. Use a calculadora para a ordem de grandeza e confira esses limites antes de escrever a lifecycle policy.

**Lambda:** o custo é invocações mais GB-segundo, ou seja, `memória × duração × invocações`. Subir a memória às vezes reduz o custo, porque a duração cai junto. Rode o cenário com duas ou três configurações em vez de assumir.

**Tagging:** sem tag consistente, nenhum dos números acima chega ao centro de custo certo. Defina as chaves antes de otimizar; senão você otimiza uma conta que ninguém consegue atribuir.

> **Estimativa não é fatura:** O toolkit não lê sua conta AWS: os resultados valem o que valem as entradas. Preço muda por região, arquitetura de CPU e acordo comercial. Antes de assinar um compromisso de RI ou Savings Plan, confirme o número no Cost Explorer com o histórico real da carga.

## Como o repositório é construído

É uma aplicação de frontend só: Next.js 16 com React 19, TypeScript 5 e Tailwind CSS 4, em `frontend/`. As contas acontecem no próprio app, sem backend e sem chamada a API da AWS, o que mantém o custo de rodar perto de zero e elimina a pergunta sobre onde guardar credencial.

O README lista quatro pipelines de GitHub Actions: CI, Frontend, Vercel e Security. O deploy vai para a Vercel, com DNS na Cloudflare, e a versão publicada fica em `finops.moretes.com`. A licença é MIT.

Essa escolha tem um trade-off claro. Sem integração com o Cost and Usage Report, o toolkit não descobre desperdício sozinho; ele responde perguntas que você já sabe formular. Para uma ferramenta de conversa de arquitetura, prefiro assim: o custo de manter uma integração com CUR, permissões IAM e atualização de tabela de preço é maior que o valor que ela traria para esse uso.

## Perguntas frequentes

### Preciso de credencial AWS para usar?

Não. As calculadoras trabalham com os valores que você informa; nada é lido da sua conta.

### Ele cobre Savings Plans?

O README fala em RI vs On-Demand para EC2. Savings Plans não aparece na lista, então não assuma que está coberto.

### Posso adaptar para o meu time?

Sim, a licença é MIT. O ponto mais útil para adaptar é o gerador de tags, que precisa refletir os centros de custo da sua empresa.

## Referências

- [GitHub: fernando-moretes/ref-finops-architect-toolkit](https://github.com/fernando-moretes/ref-finops-architect-toolkit)
- [FinOps Architect Toolkit (produção)](https://finops.moretes.com)
- [AWS Lambda pricing](https://aws.amazon.com/lambda/pricing/)
- [Amazon S3 pricing](https://aws.amazon.com/s3/pricing/)
- [Amazon EC2 Reserved Instances](https://aws.amazon.com/ec2/pricing/reserved-instances/)

## Para quem serve

Use quando você é o arquiteto na sala em que alguém pergunta "quanto vamos economizar?" e você precisa responder com break-even, classe de armazenamento e custo por invocação, não com "depende". Não use como ferramenta de descoberta de desperdício numa conta existente: para isso, Cost Explorer, Compute Optimizer e o CUR com histórico real são o caminho. O toolkit acerta a ordem de grandeza e organiza a conversa; a decisão final de compromisso continua dependendo dos dados da sua fatura.

## Links

- [GitHub repository](https://github.com/fernando-moretes/ref-finops-architect-toolkit)
