# 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 `` do `next/image` configurando dimensões e `sizes` para prevenção de Cumulative Layout Shift (CLS). - Utilize `` do `next/link` para rotas internas. 2. **Estilização com Tailwind CSS v4**: - Respeite o padrão do Tailwind v4 (`@import "tailwindcss";` no `globals.css`). - Mantenha a identidade visual: azul escuro `navy-800`, destaques em dourado/amarelo `#e8a820` e fundos escuros de alto contraste. 3. **TypeScript Estrito**: - Defina tipos/interfaces claras para props de componentes. - Evite o uso de `any`, `unknown` não tipado ou casting forçado (`as any`). 4. **Acessibilidade & SEO**: - Garanta apenas um `

` por página. - Forneça textos alternativos (`alt`) explicativos em imagens. - Otimize LCP (Largest Contentful Paint) utilizando `priority` e `fetchPriority="high"` em elementos acima da dobra no `Hero.tsx`. --- ## 🔗 Links Oficiais - [Landing Page Aki Tem Obra](https://akitemobra.com.br) - [Inventors Company](https://inventorscompany.com.br) - [Especificação llms.txt Standard](https://llmstxt.org) --- *Documento de arquitetura e contexto otimizado para Large Language Models (LLMs).*