# Aki Tem Obra - Contexto & Documentação para LLMs
> **Aki Tem Obra** é uma landing page e plataforma web moderna desenvolvida para a gestão inteligente de construções e reformas. O aplicativo centraliza orçamento, diário de obra, controle financeiro, gestão de fornecedores e relatórios executivos em PDF na palma da mão.
Este arquivo (`llm.txt` / `llms.txt`) fornece contexto estruturado, arquitetura do sistema, convenções de código e orientações operacionais para modelos de linguagem (LLMs) e agentes de IA que interagem com o repositório ou consomem a documentação deste projeto.
---
## 📌 Visão Geral do Produto
- **Nome do Projeto**: Aki Tem Obra (Landing Page)
- **Desenvolvido Por**: Inventors Company ([https://inventorscompany.com.br/](https://inventorscompany.com.br/))
- **Objetivo**: Apresentar os recursos do app móvel Aki Tem Obra e converter visitantes em downloads nas lojas oficiais de aplicativos (App Store e Google Play).
- **Público-Alvo**:
- **Proprietários & Donos de Obra**: Pessoas construindo ou reformando que buscam transparência financeira e controle de prazos.
- **Engenheiros & Arquitetos**: Profissionais que gerenciam múltiplas obras e precisam emitir relatórios diários em PDF com fotos organizadas.
- **Empreiteiros & Mestres de Obra**: Profissionais de execução que precisam atualizar o progresso em tempo real para os clientes.
### Recursos Principais Destacados
1. **Acompanhamento em Tempo Real**: Progresso percentual por etapa e estimativa de entrega.
2. **Controle Financeiro Completo**: Registro de entradas/saídas, categorização e teto orçamentário.
3. **Diário de Fotos**: Histórico visual da obra organizado por data e etapa.
4. **Gestão de Fornecedores**: Cadastro, cotação e avaliação de prestadores de serviço.
5. **Relatórios Automáticos**: Emissão de relatórios executivos em PDF para clientes, sócios ou bancos.
6. **Multi-Obras**: Visão consolidada para gerenciar múltiplos canteiros de obra simultaneamente.
---
## 🛠️ Arquitetura Tecnológica (Tech Stack)
| Tecnologia | Versão | Função / Aplicação |
| :--- | :--- | :--- |
| **Next.js** | `16.2.6` | Framework React Full-Stack com App Router |
| **React** | `19.2.6` | Biblioteca para construção de interfaces de usuário |
| **TypeScript** | `6.0.3` | Tipagem estática para maior segurança e produtividade |
| **Tailwind CSS** | `4.3.0` | Estilização utilitária via PostCSS |
| **@next/third-parties** | `16.2.6` | Integrações otimizadas de scripts e analytics de terceiros |
| **Docker / Docker Compose** | Latest | Containerização do ambiente de desenvolvimento e produção |
| **GitHub Actions** | CI/CD | Workflows automatizados de build e deploy (`develop` e `main`) |
---
## 📂 Mapa da Estrutura de Arquivos
```
lp.nextjs.aki-tem-obra/
├── app/ # Next.js App Router (Rotas e Páginas)
│ ├── layout.tsx # Layout raiz (Fontes Google, Metadados SEO)
│ ├── page.tsx # Página principal (Hero, Features, Audience, CTA, Footer)
│ ├── globals.css # Estilos globais e integração Tailwind CSS v4
│ ├── manifest.ts # Configurações Web App Manifest (PWA)
│ ├── robots.ts # Configurações de indexação para buscadores (SEO)
│ ├── sitemap.ts # Gerador de sitemap XML para SEO
│ ├── not-found.tsx # Página de erro 404 estilizada
│ ├── politica-de-privacidade/ # Rota legal: /politica-de-privacidade
│ └── termos-de-uso/ # Rota legal: /termos-de-uso
├── components/ # Componentes React Reutilizáveis
│ ├── Hero.tsx # Cabeçalho de conversão, badges App Store/Google Play e mockup
│ ├── Features.tsx # Grade de 6 funcionalidades chave do aplicativo
│ ├── Audience.tsx # Perfil de público e propostas de valor específicas
│ └── CTA.tsx # Seção final de chamada para ação e downloads
├── public/ # Ativos estáticos e documentação para LLMs
│ ├── logo-aki-tem-obra.svg # Logotipo vetorizado oficial
│ ├── celular.svg # Ilustração do aplicativo em tela móvel
│ ├── app-store.png # Ícone oficial de download na App Store
│ ├── google-play.png # Ícone oficial de download no Google Play
│ ├── llm.txt # Documentação para LLMs (servida via /llm.txt)
│ └── llms.txt # Documentação no padrão aberto (servida via /llms.txt)
├── .github/workflows/ # Workflows de deploy automático CI/CD
├── Dockerfile # Definição da imagem de produção Docker
├── docker-compose.yml # Orquestração do ambiente containerizado
├── package.json # Scripts do projeto e declaração de dependências
├── tsconfig.json # Configuração do compilador TypeScript
├── AGENTS.md # Regras de agentes e alertas de versão do Next.js
└── README.md # Guia do desenvolvedor para execução do projeto
```
---
## 🌐 Rotas e Links Principais
- `GET /` — Landing Page principal com todas as seções de produto e links para app stores.
- `GET /politica-de-privacidade` — Documento de Política de Privacidade e Proteção de Dados (LGPD).
- `GET /termos-de-uso` — Documento de Termos e Condições de Uso da plataforma.
- `GET /sitemap.xml` — Mapa de URLs para indexação de motores de busca.
- `GET /robots.txt` — Regras de rastreamento de crawlers e bots.
- `GET /llm.txt` — Arquivo de contexto e documentação para LLMs.
- `GET /llms.txt` — Padrão aberto `llms.txt` para LLMs (este arquivo).
---
## 🛠️ Guia de Comandos do Desenvolvedor
### Execução Local (npm)
- `npm install` — Instala todas as dependências do projeto.
- `npm run dev` — Inicia o servidor de desenvolvimento em `http://localhost:3000`.
- `npm run lint` — Valida o código utilizando ESLint 9 com regras do Next.js.
- `npm run build` — Compila a aplicação otimizada para produção.
- `npm run start` — Executa o servidor Node de produção após o build.
### Execução com Docker
- `docker-compose up -d` — Sobe os serviços containerizados na porta `3000`.
- `docker-compose down` — Encerra e remove os containers em execução.
---
## 🤖 Diretrizes e Regras de Engenharia para Agentes de IA
Ao realizar manutenções ou adicionar novas funcionalidades neste código, siga rigorosamente as instruções abaixo:
1. **Convenções do Next.js App Router (v16)**:
- Mantenha componentes como **Server Components** por padrão. Adicione `'use client'` somente se utilizar hooks React (`useState`, `useEffect`, `useCallback`) ou escutadores de eventos no DOM.
- Utilize sempre `