chore: setup agent skills config (#25)

* feat: adicionar cadência editorial à home

* fix: reconcile pr23 ci with current main

* test: atualizar baselines visuais da home para cadência editorial

.env.example

@@ -2,6 +2,7 @@ APP_NAME=Amare
 APP_ENV=local
 APP_KEY=
 APP_DEBUG=true
+# Staging/production: set APP_URL to the public HTTPS origin (e.g. https://staging.example.com).
 APP_URL=http://localhost
 
 APP_LOCALE=pt_BR
@@ -38,6 +39,10 @@ SESSION_LIFETIME=120
 SESSION_ENCRYPT=false
 SESSION_PATH=/
 SESSION_DOMAIN=null
+# Staging/production behind HTTPS (Dokploy Traefik): SESSION_SECURE_COOKIE=true
+SESSION_SECURE_COOKIE=false
+SESSION_HTTP_ONLY=true
+SESSION_SAME_SITE=lax
 
 BROADCAST_CONNECTION=log
 FILESYSTEM_DISK=local

.github/workflows/ci.yml

@@ -31,7 +31,8 @@ jobs:
     name: static
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
+      - run: cp .env.example .env
 
       - uses: shivammathur/setup-php@v2
         with:
@@ -39,7 +40,7 @@ jobs:
           extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, pdo_pgsql, bcmath, intl, sodium, gd
           coverage: none
 
-      - uses: actions/cache@v4
+      - uses: actions/cache@v5
         with:
           path: ~/.composer/cache/files
           key: composer-${{ runner.os }}-${{ hashFiles('**/composer.lock') }}
@@ -55,7 +56,8 @@ jobs:
     name: unit
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
+      - run: cp .env.example .env
 
       - uses: shivammathur/setup-php@v2
         with:
@@ -63,7 +65,7 @@ jobs:
           extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, pdo_pgsql, bcmath, intl, sodium, gd
           coverage: none
 
-      - uses: actions/cache@v4
+      - uses: actions/cache@v5
         with:
           path: ~/.composer/cache/files
           key: composer-${{ runner.os }}-${{ hashFiles('**/composer.lock') }}
@@ -92,7 +94,8 @@ jobs:
           --health-timeout 5s
           --health-retries 10
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
+      - run: cp .env.example .env
 
       - uses: shivammathur/setup-php@v2
         with:
@@ -100,13 +103,13 @@ jobs:
           extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, pdo_pgsql, bcmath, intl, sodium, gd
           coverage: none
 
-      - uses: actions/cache@v4
+      - uses: actions/cache@v5
         with:
           path: ~/.composer/cache/files
           key: composer-${{ runner.os }}-${{ hashFiles('**/composer.lock') }}
           restore-keys: composer-${{ runner.os }}-
 
-      - uses: actions/cache@v4
+      - uses: actions/cache@v5
         with:
           path: ~/.npm
           key: npm-${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
@@ -136,7 +139,8 @@ jobs:
           --health-timeout 5s
           --health-retries 10
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
+      - run: cp .env.example .env
 
       - uses: shivammathur/setup-php@v2
         with:
@@ -144,13 +148,13 @@ jobs:
           extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, pdo_pgsql, bcmath, intl, sodium, gd
           coverage: none
 
-      - uses: actions/cache@v4
+      - uses: actions/cache@v5
         with:
           path: ~/.composer/cache/files
           key: composer-${{ runner.os }}-${{ hashFiles('**/composer.lock') }}
           restore-keys: composer-${{ runner.os }}-
 
-      - uses: actions/cache@v4
+      - uses: actions/cache@v5
         with:
           path: ~/.npm
           key: npm-${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
@@ -224,7 +228,7 @@ jobs:
     name: container
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Build production image
         run: docker build -t amare-app:ci .

.github/workflows/deploy-staging.yml

@@ -0,0 +1,82 @@
+name: Deploy staging
+
+on:
+  workflow_run:
+    workflows: [CI]
+    types: [completed]
+    branches: [main]
+
+permissions:
+  contents: read
+  packages: write
+
+concurrency:
+  group: deploy-staging
+  cancel-in-progress: false
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  deploy:
+    name: publish-and-deploy-staging
+    if: >-
+      github.event.workflow_run.conclusion == 'success' &&
+      github.event.workflow_run.event == 'push' &&
+      github.event.workflow_run.head_branch == 'main'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout deployed SHA
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.workflow_run.head_sha }}
+
+      - name: Set image metadata
+        id: meta
+        run: |
+          SHA="${{ github.event.workflow_run.head_sha }}"
+          SHORT_SHA="${SHA:0:7}"
+          IMAGE="${REGISTRY}/${IMAGE_NAME}"
+          IMAGE="$(echo "$IMAGE" | tr '[:upper:]' '[:lower:]')"
+          echo "sha=${SHA}" >> "$GITHUB_OUTPUT"
+          echo "short_sha=${SHORT_SHA}" >> "$GITHUB_OUTPUT"
+          echo "image=${IMAGE}" >> "$GITHUB_OUTPUT"
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Build and push SHA + staging tags
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: |
+            ${{ steps.meta.outputs.image }}:${{ steps.meta.outputs.sha }}
+            ${{ steps.meta.outputs.image }}:staging
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Deploy staging on Dokploy
+        env:
+          DOKPLOY_URL: ${{ secrets.DOKPLOY_URL }}
+          DOKPLOY_API_KEY: ${{ secrets.DOKPLOY_API_KEY }}
+          DOKPLOY_COMPOSE_ID: ${{ secrets.DOKPLOY_STAGING_COMPOSE_ID }}
+          DEPLOY_TITLE: "staging ${{ steps.meta.outputs.short_sha }}"
+        run: |
+          chmod +x scripts/deploy/dokploy-deploy.sh
+          ./scripts/deploy/dokploy-deploy.sh
+
+      - name: Smoke staging
+        env:
+          SMOKE_BASE_URL: ${{ secrets.STAGING_URL }}
+        run: |
+          chmod +x scripts/deploy/smoke.sh
+          ./scripts/deploy/smoke.sh

.github/workflows/promote-production.yml

@@ -0,0 +1,84 @@
+name: Promote production
+
+on:
+  workflow_dispatch:
+    inputs:
+      sha:
+        description: Full git SHA already published to GHCR (same digest used by staging)
+        required: true
+        type: string
+      confirm:
+        description: Type PRODUCTION to confirm promotion of the given SHA
+        required: true
+        type: string
+
+permissions:
+  contents: read
+  packages: write
+
+concurrency:
+  group: deploy-production
+  cancel-in-progress: false
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  promote:
+    name: promote-production
+    runs-on: ubuntu-latest
+    steps:
+      - name: Guard confirmation
+        run: |
+          if [ "${{ inputs.confirm }}" != "PRODUCTION" ]; then
+            echo "Confirmation must be exactly PRODUCTION" >&2
+            exit 1
+          fi
+
+      - name: Checkout repository scripts
+        uses: actions/checkout@v4
+
+      - name: Set image metadata
+        id: meta
+        run: |
+          SHA="${{ inputs.sha }}"
+          SHORT_SHA="${SHA:0:7}"
+          IMAGE="${REGISTRY}/${IMAGE_NAME}"
+          IMAGE="$(echo "$IMAGE" | tr '[:upper:]' '[:lower:]')"
+          echo "sha=${SHA}" >> "$GITHUB_OUTPUT"
+          echo "short_sha=${SHORT_SHA}" >> "$GITHUB_OUTPUT"
+          echo "image=${IMAGE}" >> "$GITHUB_OUTPUT"
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Point :production at existing SHA digest (no rebuild)
+        run: |
+          docker buildx imagetools create \
+            --tag "${{ steps.meta.outputs.image }}:production" \
+            "${{ steps.meta.outputs.image }}:${{ steps.meta.outputs.sha }}"
+
+      - name: Deploy production on Dokploy
+        env:
+          DOKPLOY_URL: ${{ secrets.DOKPLOY_URL }}
+          DOKPLOY_API_KEY: ${{ secrets.DOKPLOY_API_KEY }}
+          DOKPLOY_COMPOSE_ID: ${{ secrets.DOKPLOY_PRODUCTION_COMPOSE_ID }}
+          DEPLOY_TITLE: "production ${{ steps.meta.outputs.short_sha }}"
+        run: |
+          chmod +x scripts/deploy/dokploy-deploy.sh
+          ./scripts/deploy/dokploy-deploy.sh
+
+      - name: Smoke production
+        env:
+          SMOKE_BASE_URL: ${{ secrets.PRODUCTION_URL }}
+        run: |
+          chmod +x scripts/deploy/smoke.sh
+          ./scripts/deploy/smoke.sh

.gitignore

@@ -18,6 +18,7 @@
 /public/fonts-manifest.dev.json
 /public/hot
 /public/storage
+/tests/Browser/Screenshots
 /storage/*.key
 /storage/pail
 /vendor

.husky/pre-commit

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+
+composer pint:check && composer phpstan

.husky/pre-push

@@ -0,0 +1,33 @@
+#!/usr/bin/env sh
+
+# Abort push when the test database is unreachable, so broken code never
+# reaches CI. Test DB settings come from phpunit.xml.
+php -r '
+$xml = @simplexml_load_file("phpunit.xml");
+if ($xml === false) {
+    fwrite(STDERR, "phpunit.xml not found — aborting pre-push.\n");
+    exit(1);
+}
+
+$defaults = ["DB_HOST" => "127.0.0.1", "DB_PORT" => "5432", "DB_DATABASE" => "amare_test", "DB_USERNAME" => "amare", "DB_PASSWORD" => "secret"];
+$env = [];
+foreach ($xml->php->env as $node) {
+    $name = (string) $node["name"];
+    if (isset($defaults[$name])) {
+        $env[$name] = (string) $node["value"];
+    }
+}
+$config = array_merge($defaults, $env);
+
+$dsn = sprintf("pgsql:host=%s;port=%s;dbname=%s", $config["DB_HOST"], $config["DB_PORT"], $config["DB_DATABASE"]);
+try {
+    new PDO($dsn, $config["DB_USERNAME"], $config["DB_PASSWORD"], [PDO::ATTR_TIMEOUT => 3]);
+} catch (PDOException $e) {
+    fwrite(STDERR, "\033[31mPostgreSQL is unreachable on {$config["DB_HOST"]}:{$config["DB_PORT"]} (db: {$config["DB_DATABASE"]}).\033[0m\n");
+    fwrite(STDERR, "Start it with: docker compose up -d\n");
+    fwrite(STDERR, "Then retry the push.\n");
+    exit(1);
+}
+' || exit 1
+
+composer test:unit && composer test:feature

.impeccable/surfaces/resources-views-pages-home-blade-php.md

@@ -12,5 +12,6 @@ related_targets: ["resources/views/pages/services/index.blade.php","resources/vi
 - **Action, proof, and constraints:** ação principal é enviar briefing inicial. Prova disponível: cinco depoimentos reais de casamentos, com nomes e datas; publicação depende de autorização final. Não inventar cases corporativos, credenciais ou resultados. Fotografias permanecem ilustrativas e marcadas até chegada de acervo autorizado.
 - **Chosen direction:** “Dossiê Editorial do Evento”. Home funciona como capa e índice; serviços viram capítulos, portfólio vira cadernos de caso, sobre vira perfil editorial e contato vira ficha de briefing. Sistema visual global segue Heritage Editorial em DESIGN.md.
 - **Memorable moment:** coração facetado atua como selo editorial enquanto índice discreto acompanha capítulos e deixa serviço, método e próximo passo visíveis sem transformar página em dashboard.
+- **Motion thesis (Dossiê vivo):** Home recebe abertura autoral (selo → título → recorte de imagem → CTAs, ≤800ms). Índice lateral no desktop e linha de progresso no mobile acompanham capítulos. Serviços, portfólio e sobre usam abertura curta e revelações discretas; contato, privacidade e erros permanecem quase estáticos. Sem parallax, loops, bounce ou scroll-jacking. `prefers-reduced-motion` entrega estado final imediato.
 - **Responsive and interaction:** spreads assimétricos no desktop; sequência linear no mobile. CTAs recorrentes, navegação clara, formulário com loading, erro e sucesso, foco visível e suporte a movimento reduzido.
 - **Unresolved:** logo transparente ou vetorial; fotografias autorizadas; WhatsApp, e-mail e Instagram oficiais; textos jurídicos; autorização dos depoimentos; provas reais de eventos corporativos.

AGENTS.md

@@ -15,6 +15,17 @@ This is a Laravel 13 application for an event-planning consultancy. Application
 
 Feature and browser tests require the `amare_test` PostgreSQL database configured in `phpunit.xml`.
 
+## Worktrees
+
+Always work in a git worktree created from the `main` ref — never modify `main` directly and never commit from the primary working tree. Create a dedicated worktree per feature/branch with `git worktree add -b <branch> <path> main`. On finishing work, create a PR, watch CI until green, then merge it. Clean up the worktree with `git worktree remove` after merge.
+
+## Git Hooks (husky)
+
+Hooks live in `.husky/` and auto-install on any plain `npm install` via the `prepare` script. Note `composer setup` runs `npm install --ignore-scripts`, which skips hook installation — after setup, run `npm install` once (or `npx husky`) to activate hooks.
+
+- `pre-commit`: runs `composer pint:check` and `composer phpstan`.
+- `pre-push`: gates on the `amare_test` database (settings parsed from `phpunit.xml`), blocks the push with a `docker compose up -d` hint when Postgres is unreachable, then runs `composer test:unit` and `composer test:feature`. Browser tests are CI-only (FrankenPHP container).
+
 ## Coding Style & Naming Conventions
 
 Follow PSR-4 and Laravel conventions: PascalCase classes, camelCase methods, and snake_case database columns. Use four spaces (two in YAML, except four in Compose files), LF endings, and UTF-8 as defined by `.editorconfig`. Every project-owned PHP file must place `declare(strict_types=1);` immediately after `<?php`. Keep domain code independent of Filament and Livewire. Run `composer pint` to format and `composer phpstan` before review.
@@ -30,3 +41,17 @@ History follows Conventional Commit-style subjects, for example `feat: Fase 0
 ## Security & Configuration
 
 Copy `.env.example`; never commit secrets or production credentials. Development seed credentials are local-only. Validate uploads and authorization through Laravel policies, and run `composer security-audit` after dependency changes.
+
+## Agent skills
+
+### Issue tracker
+
+Issues live in Linear, driven through the Linear MCP tools. See `docs/agents/issue-tracker.md`.
+
+### Triage labels
+
+Default vocabulary: `needs-triage`, `needs-info`, `ready-for-agent`, `ready-for-human`, `wontfix`. See `docs/agents/triage-labels.md`.
+
+### Domain docs
+
+Single-context: `CONTEXT.md` at root + `docs/adr/`. See `docs/agents/domain.md`.

README.md

@@ -125,3 +125,10 @@ Após `php artisan db:seed`:
 - [SPEC.md](SPEC.md) — especificação do produto
 - [docs/adr/](docs/adr/) — ADRs aceitas
 - [docs/conventions/php-strict-types.md](docs/conventions/php-strict-types.md) — convenção de strict types
+- [docs/deployment/dokploy.md](docs/deployment/dokploy.md) — deploy staging/produção no Dokploy + GHCR
+
+## Deploy (Dokploy)
+
+Staging publica automaticamente após CI verde em `main` (imagem GHCR por SHA + alias `:staging`). Produção promove a **mesma digest** com workflow manual `Promote production` (sem rebuild).
+
+Ver runbook completo: [docs/deployment/dokploy.md](docs/deployment/dokploy.md).

SPEC.md

@@ -14,7 +14,8 @@
 | Estágio | MVP |
 | Status da especificação | Aprovada para implementação |
 | Idioma da interface | Português do Brasil (`pt-BR`) |
-| Timezone padrão | `America/Fortaleza` |
+| Timezone padrão | `America/Sao_Paulo` |
+| Cidade de atuação | São Paulo (capital) |
 | Moeda | BRL, sem conversão entre moedas |
 | Princípio principal | YAGNI — implementar somente o necessário para validar o produto |
 | Arquitetura | Monólito modular Laravel |
@@ -44,6 +45,8 @@ Em caso de conflito, seguir esta ordem:
 
 O agente **NÃO DEVE** alterar silenciosamente uma decisão deste documento. Uma alteração de escopo ou arquitetura deve atualizar esta especificação ou criar uma ADR.
 
+Mudanças incrementais são planejadas em `openspec/changes/` e, após arquivadas, este documento DEVE ser revalidado para incorporar decisões ratificadas (back-sync). Este arquivo permanece a fonte de verdade do produto.
+
 ---
 
 ## 1. Contrato de operação para agentes
@@ -349,13 +352,14 @@ A home DEVE conter, nesta ordem aproximada:
 
 1. header e navegação;
 2. hero com proposta de valor e CTA;
-3. prova visual por eventos em destaque;
+3. manifesto da marca;
-4. resumo dos serviços;
+4. resumo dos serviços em destaque;
-5. método de trabalho;
+5. casos selecionados do portfólio;
-6. casos selecionados;
+6. método de trabalho (4 passos);
 7. depoimentos;
-8. CTA final para briefing;
+8. posicionamento/perfil;
-9. footer com contato, redes e links legais.
+9. CTA final para briefing;
+10. footer com contato, redes e links legais.
 
 A ordem pode variar apenas se a revisão de UX justificar a mudança.
 
@@ -374,6 +378,15 @@ Centralizar tokens de:
 
 Não espalhar valores visuais arbitrários por componentes.
 
+O MVP adota o sistema de design **Heritage Editorial** (ver DESIGN.md e ADR-013):
+
+- tipografia serifada auto-hospedada (EB Garamond) com escala de display a label;
+- paleta papel/oliva/sálvia/tinta com superfícies tonais; hierarquia sem sombras de card;
+- raio de borda zero para superfícies interativas e de conteúdo;
+- largura de container 1120px e ritmo de espaçamento de 8px;
+- `prefers-reduced-motion` respeitado;
+- contraste WCAG AA (tinta sobre papel e oliva sobre papel).
+
 ### 6.4 Requisitos de mídia
 
 - Imagens públicas DEVERÃO possuir texto alternativo.
@@ -383,6 +396,7 @@ Não espalhar valores visuais arbitrários por componentes.
 - Dimensões DEVERÃO ser reservadas para evitar layout shift.
 - Não armazenar blobs de imagem no PostgreSQL.
 - Não depender do disco efêmero do contêiner em produção.
+- O logotipo da marca DEVE possuir texto alternativo e variantes claro/escuro; `site_settings.logo_path` sobrescreve o asset padrão quando preenchido.
 
 ### 6.5 Acessibilidade
 
@@ -534,12 +548,10 @@ Campos públicos:
 - validar no servidor;
 - usar honeypot e rate limiting;
 - impedir duplo envio acidental;
-- criar Lead com status `new`;
-- registrar origem `website`;
-- notificar administradores;
-- exibir sucesso sem revelar dados internos;
 - enviar e-mail de confirmação quando o serviço de e-mail estiver configurado;
-- falha no e-mail não pode apagar o lead já criado.
+- exibir sucesso sem revelar dados internos.
+
+> **Estado atual (Fases 0–1):** o formulário usa Blade + Controller e envia apenas e-mails informativos (para a assessoria e confirmação ao visitante), sem criar Lead. A criação de Lead (status `new`, origem `website`), a notificação aos administradores e o registro de aceite de privacidade entram na **Fase 2**, quando o formulário passa a criar o Lead via `CaptureWebsiteLead`. A falha de e-mail não pode apagar dados já criados.
 
 **Aceite:**
 
@@ -1253,10 +1265,19 @@ Singleton:
 
 - `id` bigint PK;
 - `brand_name`;
+- `logo_path` nullable;
+- `logo_alt` nullable;
 - `hero_eyebrow` nullable;
 - `hero_title`;
 - `hero_subtitle`;
 - `hero_cta_label`;
+- `hero_cta_secondary_label` nullable;
+- `hero_note` nullable;
+- `manifesto_title`;
+- `manifesto_lead`;
+- `manifesto_body`;
+- `method_steps` jsonb (4 passos tipados);
+- `principles` jsonb (lista tipada);
 - `about_summary` nullable;
 - `email`;
 - `phone`;
@@ -1265,7 +1286,8 @@ Singleton:
 - `default_meta_title`;
 - `default_meta_description`;
 - `default_og_image_path` nullable;
-- analytics fields nullable;
+- `default_og_image_alt` nullable;
+- `analytics_enabled` boolean default false;
 - timestamps.
 
 #### `services`
@@ -1536,7 +1558,7 @@ Constraints de banco devem proteger:
 | Servidor | FrankenPHP + Caddy |
 | Assets | Vite |
 | Testes | Pest 4 + Pest Browser/Playwright |
-| Arquivos | Laravel Filesystem + storage S3-compatible em produção |
+| Arquivos | Laravel Filesystem + Cloudflare R2 (S3-compatible) em produção |
 | Fila | Database queue |
 | Scheduler | Laravel Scheduler em processo separado |
 
@@ -1764,6 +1786,8 @@ Não transformar todas as seções estáticas em componentes Livewire. Usar Blad
 
 ### 11.2 Formulário de briefing
 
+> **Estado atual (Fases 0–1):** o formulário é implementado em Blade + Controller (`POST /contato`, `ContactBriefingRequest`), conforme WEB-05. Se a Fase 2 mantiver Blade + Controller, os requisitos abaixo valem para o formulário e seus testes independentemente da tecnologia; a criação de Lead segue para a Fase 2.
+
 O componente deve:
 
 - ter estado tipado ou Form Object quando útil;
@@ -1970,7 +1994,7 @@ Determinismo obrigatório:
 
 - Chromium e imagem Linux fixos;
 - viewport fixo;
-- timezone `America/Fortaleza`;
+- timezone `America/Sao_Paulo`;
 - locale `pt-BR`;
 - fontes instaladas na imagem;
 - relógio congelado;
@@ -2052,7 +2076,7 @@ quality        → Pint check + PHPStan/Larastan + audits + testes
 
 | Job | Responsabilidade | Bloqueia merge |
 |---|---|---:|
-| `static` | Pint, PHPStan/Larastan, Composer validate e audits | Sim |
+| `static` | Pint, PHPStan/Larastan, Composer validate, Composer e npm audit | Sim |
 | `unit` | Unitários, arquitetura e cobertura | Sim |
 | `feature` | PostgreSQL, migrations, Livewire, Filament e integração | Sim |
 | `browser` | Vite, FrankenPHP, E2E, smoke, acessibilidade e visual | Sim |
@@ -2073,11 +2097,11 @@ quality        → Pint check + PHPStan/Larastan + audits + testes
 ### 14.3 Branches e ambientes
 
 - PR: testes e preview opcional;
-- `main`: build imutável por SHA e deploy automático em staging;
+- `main`: build imutável por SHA publicado no GHCR e deploy automático em staging via Dokploy;
-- staging: migration, cache warmup e smoke pós-deploy;
+- staging: Dokploy Compose executa migração, healthcheck `/up` e smoke pós-deploy (`/up`, `/`, `/admin/login`);
-- produção: promoção da mesma imagem aprovada, sem rebuild;
+- produção: promoção da mesma imagem aprovada, sem rebuild (retag do digest em `:production`);
-- produção requer aprovação humana explícita no MVP;
+- produção requer aprovação humana explícita no MVP (`workflow_dispatch` com confirmação);
-- rollback usa imagem anterior;
+- rollback usa imagem anterior (SHA anterior, sem rebuild);
 - migrations devem ser backward-compatible quando possível.
 
 ### 14.4 Definition of Done
@@ -2159,7 +2183,7 @@ APP_DEBUG=false
 APP_URL
 APP_LOCALE=pt_BR
 APP_FALLBACK_LOCALE=pt_BR
-APP_TIMEZONE=America/Fortaleza
+APP_TIMEZONE=America/Sao_Paulo
 
 DB_CONNECTION=pgsql
 DB_HOST
@@ -2172,19 +2196,16 @@ CACHE_STORE=database ou file conforme ambiente
 QUEUE_CONNECTION=database
 SESSION_DRIVER=database ou cookie conforme decisão
 
-FILESYSTEM_DISK=s3 em produção
+FILESYSTEM_DISK=r2 em produção
-AWS_ACCESS_KEY_ID
+R2_ACCESS_KEY_ID
-AWS_SECRET_ACCESS_KEY
+R2_SECRET_ACCESS_KEY
-AWS_DEFAULT_REGION
+R2_BUCKET
-AWS_BUCKET
+R2_ENDPOINT
-AWS_ENDPOINT opcional
+R2_URL (domínio próprio opcional)
-AWS_USE_PATH_STYLE_ENDPOINT opcional
+AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION, AWS_BUCKET, AWS_ENDPOINT, AWS_USE_PATH_STYLE_ENDPOINT — opcionais, apenas se o disk s3 for usado
 
-MAIL_MAILER
+MAIL_MAILER=resend em produção (mailer nativo Laravel)
-MAIL_HOST
+RESEND_API_KEY
-MAIL_PORT
-MAIL_USERNAME
-MAIL_PASSWORD
 MAIL_FROM_ADDRESS
 MAIL_FROM_NAME
 ```
@@ -2279,7 +2300,7 @@ O seed deve criar:
 - configurações do site;
 - 3 serviços;
 - 3 casos de portfólio;
-- 3 depoimentos;
+- depoimentos reais: os 5 casais de `depoimentos.md` (Jeniffer e Maick, Quesia e Jhonata, Milena e Weslley, Raquel e Pedro, Victoria e Pedro), preservando texto e datas; autores fictícios de demonstração removidos; em produção permanecem não publicados até autorização explícita de publicação;
 - leads em estados variados;
 - 2 eventos futuros e 1 concluído;
 - tarefas vencidas e futuras;
@@ -2314,7 +2335,7 @@ O agente deve implementar na sequência, salvo instrução explícita.
 - [x] Filament instalado e autenticado;
 - [x] Livewire configurado;
 - [x] Tailwind/Vite;
-- [x] FrankenPHP e Docker Compose local;
+- [~] FrankenPHP e Docker Compose local (imagem pronta; serviço de aplicação local pendente);
 - [x] papéis admin/assistant;
 - [x] Pint;
 - [x] PHPStan/Larastan;
@@ -2325,6 +2346,13 @@ O agente deve implementar na sequência, salvo instrução explícita.
 - [x] design tokens mínimos;
 - [x] healthcheck;
 - [x] seed de admin local.
+- [ ] verificação de e-mail e reset seguro (MustVerifyEmail);
+- [ ] npm audit no `composer quality` e no job `static`;
+- [ ] gate de cobertura `Domain`/`Application` ≥ 80%;
+- [ ] serviço de aplicação FrankenPHP no Compose local;
+- [ ] hello-world implantado em staging (critério de saída).
+
+> Os itens pendentes acima são tratados pela mudança OpenSpec `complete-foundation-parity`; o critério de saída da fase só é atingido com staging implantado.
 
 **Critério de saída:** pipeline verde e hello-world implantado em staging.
 
@@ -2481,6 +2509,10 @@ Toda operação financeira deve:
 | ADR-008 | Database queue; Redis adiado | Aceita |
 | ADR-009 | Dinheiro em BRL armazenado como centavos inteiros | Aceita |
 | ADR-010 | Home com estrutura fixa e CMS tipado, sem page builder | Aceita |
+| ADR-011 | Cloudflare R2 (S3-compatible) como storage de objetos em produção | Aceita |
+| ADR-012 | E-mail transacional via Resend (mailer nativo Laravel) | Aceita |
+| ADR-013 | Design system Heritage Editorial para o site público | Aceita |
+| ADR-014 | Deploy via Dokploy Compose com imagem imutável por SHA no GHCR | Aceita |
 
 ---
 

app/Application/Data/PageMeta.php

@@ -21,6 +21,8 @@ final readonly class PageMeta
         public ?string $ogImageUrl = null,
         public ?string $ogImageAlt = null,
         public ?array $jsonLd = null,
+        public string $siteName = '',
+        public string $robots = 'index, follow',
     ) {}
 
     /**
@@ -44,6 +46,7 @@ final readonly class PageMeta
             ogImageUrl: $ogImageUrl ?? self::defaultOgImageUrl($settings),
             ogImageAlt: $ogImageAlt ?? $settings->default_og_image_alt,
             jsonLd: $jsonLd,
+            siteName: (string) $settings->brand_name,
         );
     }
 
@@ -77,9 +80,53 @@ final readonly class PageMeta
             ogImageUrl: $ogImageUrl,
             ogImageAlt: $ogImageAlt,
             jsonLd: $jsonLd,
+            siteName: (string) $settings->brand_name,
         );
     }
 
+    /**
+     * Build the metadata for branded error pages.
+     *
+     * Error pages carry no canonical, are excluded from search indexes and use
+     * the page name suffixed with the brand name as their title.
+     */
+    public static function forErrorPage(
+        SiteSetting $settings,
+        int $status = 404,
+    ): self {
+        [$title, $description] = match ($status) {
+            500 => ['Algo deu errado', 'Não foi possível concluir o pedido. Tente novamente em instantes.'],
+            419 => ['Sessão expirada', 'Sua sessão expirou. Volte e tente enviar novamente.'],
+            429 => ['Muitas solicitações', 'Você enviou muitas solicitações em pouco tempo. Aguarde um instante e tente novamente.'],
+            503 => ['Em manutenção', 'Estamos realizando uma breve manutenção. Tente novamente em instantes.'],
+            default => ['Página não encontrada', 'A página que você procura não existe ou foi movida.'],
+        };
+
+        return new self(
+            title: trim($title).' - '.$settings->brand_name,
+            description: $description,
+            canonical: '',
+            robots: 'noindex, nofollow',
+            siteName: (string) $settings->brand_name,
+        );
+    }
+
+    /**
+     * Append the brand name to a page title when it is not already present.
+     */
+    public static function withBrandSuffix(string $title, SiteSetting $settings): string
+    {
+        $brand = filled($settings->default_meta_title)
+            ? (string) $settings->default_meta_title
+            : (string) $settings->brand_name;
+
+        if (str_contains($title, $brand)) {
+            return $title;
+        }
+
+        return trim($title).' - '.$brand;
+    }
+
     private static function defaultTitle(SiteSetting $settings): string
     {
         return filled($settings->default_meta_title)

app/Console/Commands/MediaGenerateVariantsCommand.php

@@ -56,6 +56,9 @@ final class MediaGenerateVariantsCommand extends Command
         if ($settings && filled($settings->default_og_image_path)) {
             $paths[] = (string) $settings->default_og_image_path;
         }
+        if ($settings && filled($settings->about_image_path)) {
+            $paths[] = (string) $settings->about_image_path;
+        }
 
         foreach (Service::query()->whereNotNull('cover_image_path')->pluck('cover_image_path') as $path) {
             $paths[] = (string) $path;

app/Filament/Pages/ManageSiteSettings.php

@@ -228,6 +228,12 @@ class ManageSiteSettings extends Page
                             ->addActionLabel('Adicionar rede'),
                     ])
                     ->columns(2),
+                Section::make('Página Sobre')
+                    ->schema([
+                        PublicImageUploadRules::fileUpload('about_image_path', 'Imagem da página Sobre', 'content/about'),
+                        PublicImageUploadRules::altTextField('about_image_alt', 'about_image_path'),
+                    ])
+                    ->columns(2),
                 Section::make('SEO padrão')
                     ->schema([
                         TextInput::make('default_meta_title')

app/Http/Controllers/PublicSite/ContactController.php

@@ -0,0 +1,116 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\PublicSite;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\PublicSite\ContactBriefingRequest;
+use App\Mail\ContactBriefing;
+use App\Mail\ContactBriefingConfirmation;
+use App\Models\SiteSetting;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Facades\Mail;
+use Throwable;
+
+final class ContactController extends Controller
+{
+    private const string DUPLICATE_SESSION_KEY = 'contact_briefing_hash';
+
+    public function store(ContactBriefingRequest $request): RedirectResponse
+    {
+        if (filled($request->input('empresa'))) {
+            return $this->success();
+        }
+
+        $validated = $request->validated();
+        unset($validated['privacidade']);
+
+        if ($this->isDuplicate($validated)) {
+            return $this->success();
+        }
+
+        $this->rememberSubmission($validated);
+
+        $settings = SiteSetting::instance();
+        $fields = $this->buildFields($validated);
+
+        $this->dispatchEmails($settings, $validated['nome'], $validated['email'], $fields);
+
+        return $this->success();
+    }
+
+    /**
+     * @param  array<string, mixed>  $validated
+     */
+    private function buildFields(array $validated): array
+    {
+        return [
+            'Nome' => (string) $validated['nome'],
+            'E-mail' => (string) $validated['email'],
+            'Telefone/WhatsApp' => (string) $validated['telefone'],
+            'Tipo de evento' => (string) $validated['tipo_evento'],
+            'Data ou período desejado' => isset($validated['data_periodo']) ? (string) $validated['data_periodo'] : null,
+            'Cidade' => (string) $validated['cidade'],
+            'Número estimado de convidados' => isset($validated['convidados']) ? (string) $validated['convidados'] : null,
+            'Serviço de interesse' => isset($validated['servico_interesse']) ? (string) $validated['servico_interesse'] : null,
+            'Mensagem' => (string) $validated['mensagem'],
+        ];
+    }
+
+    /**
+     * @param  array<string, mixed>  $validated
+     */
+    private function isDuplicate(array $validated): bool
+    {
+        $hash = $this->hash($validated);
+
+        return session()->get(self::DUPLICATE_SESSION_KEY) === $hash;
+    }
+
+    /**
+     * @param  array<string, mixed>  $validated
+     */
+    private function rememberSubmission(array $validated): void
+    {
+        session()->put(self::DUPLICATE_SESSION_KEY, $this->hash($validated));
+    }
+
+    /**
+     * @param  array<string, mixed>  $validated
+     */
+    private function hash(array $validated): string
+    {
+        return hash('sha256', serialize($validated));
+    }
+
+    /**
+     * @param  array<string, mixed>  $fields
+     */
+    private function dispatchEmails(SiteSetting $settings, string $name, string $email, array $fields): void
+    {
+        $attempt = function () use ($settings, $name, $email, $fields): void {
+            if (filled($settings->email)) {
+                Mail::to($settings->email)->send(new ContactBriefing($fields));
+            }
+
+            if (filled(config('mail.default'))) {
+                Mail::to($email)->send(new ContactBriefingConfirmation($name, (string) $settings->brand_name));
+            }
+        };
+
+        try {
+            $attempt();
+        } catch (Throwable $exception) {
+            Log::error('Falha ao enviar briefing de contato', [
+                'exception' => $exception,
+            ]);
+        }
+    }
+
+    private function success(): RedirectResponse
+    {
+        return redirect()->route('contact')->with('status', 'briefing-sent');
+    }
+}

app/Http/Controllers/PublicSite/PageController.php

@@ -20,7 +20,7 @@ final class PageController extends Controller
             'pageMeta' => PageMeta::forPage(
                 canonical: route('about'),
                 settings: $settings,
-                title: 'Sobre',
+                title: PageMeta::withBrandSuffix('Sobre', $settings),
                 description: $settings->about_summary ?: ('Conheça a '.$settings->brand_name.'.'),
             ),
         ]);
@@ -35,7 +35,7 @@ final class PageController extends Controller
             'pageMeta' => PageMeta::forPage(
                 canonical: route('privacy'),
                 settings: $settings,
-                title: 'Política de privacidade',
+                title: PageMeta::withBrandSuffix('Política de privacidade', $settings),
                 description: 'Política de privacidade da '.$settings->brand_name.'.',
             ),
         ]);
@@ -50,7 +50,7 @@ final class PageController extends Controller
             'pageMeta' => PageMeta::forPage(
                 canonical: route('contact'),
                 settings: $settings,
-                title: 'Contato',
+                title: PageMeta::withBrandSuffix('Contato', $settings),
                 description: 'Fale com a '.$settings->brand_name.'.',
             ),
         ]);

app/Http/Controllers/PublicSite/PortfolioController.php

@@ -32,7 +32,7 @@ final class PortfolioController extends Controller
             'pageMeta' => PageMeta::forPage(
                 canonical: route('portfolio.index'),
                 settings: $settings,
-                title: 'Portfólio',
+                title: PageMeta::withBrandSuffix('Portfólio', $settings),
                 description: 'Casos reais de eventos conduzidos pela '.$settings->brand_name.'.',
             ),
         ]);

app/Http/Controllers/PublicSite/ServiceController.php

@@ -23,7 +23,7 @@ final class ServiceController extends Controller
             'pageMeta' => PageMeta::forPage(
                 canonical: route('services.index'),
                 settings: $settings,
-                title: 'Serviços',
+                title: PageMeta::withBrandSuffix('Serviços', $settings),
                 description: 'Conheça os serviços de assessoria de eventos da '.$settings->brand_name.'.',
             ),
         ]);

app/Http/Requests/PublicSite/ContactBriefingRequest.php

@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\PublicSite;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+final class ContactBriefingRequest extends FormRequest
+{
+    /**
+     * @return array<string, array<int, string>>
+     */
+    public function rules(): array
+    {
+        return [
+            'nome' => ['required', 'string', 'max:120'],
+            'email' => ['required', 'email', 'max:254'],
+            'telefone' => ['required', 'string', 'max:40'],
+            'tipo_evento' => ['required', 'string', 'max:80'],
+            'data_periodo' => ['nullable', 'string', 'max:80'],
+            'cidade' => ['required', 'string', 'max:80'],
+            'convidados' => ['nullable', 'integer', 'min:1', 'max:100000'],
+            'servico_interesse' => ['nullable', 'string', 'max:120'],
+            'mensagem' => ['required', 'string', 'max:3000'],
+            'privacidade' => ['accepted'],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'nome.required' => 'Informe seu nome completo.',
+            'nome.max' => 'O nome deve ter no máximo :max caracteres.',
+            'email.required' => 'Informe seu e-mail.',
+            'email.email' => 'Informe um e-mail válido.',
+            'email.max' => 'O e-mail deve ter no máximo :max caracteres.',
+            'telefone.required' => 'Informe um telefone ou WhatsApp.',
+            'telefone.max' => 'O telefone deve ter no máximo :max caracteres.',
+            'tipo_evento.required' => 'Selecione o tipo de evento.',
+            'tipo_evento.max' => 'O tipo de evento deve ter no máximo :max caracteres.',
+            'data_periodo.max' => 'A data ou período deve ter no máximo :max caracteres.',
+            'cidade.required' => 'Informe a cidade do evento.',
+            'cidade.max' => 'A cidade deve ter no máximo :max caracteres.',
+            'convidados.integer' => 'Informe um número de convidados válido.',
+            'convidados.min' => 'O número de convidados deve ser maior que zero.',
+            'convidados.max' => 'O número de convidados informado é inválido.',
+            'servico_interesse.max' => 'O serviço deve ter no máximo :max caracteres.',
+            'mensagem.required' => 'Conte brevemente o que você precisa.',
+            'mensagem.max' => 'A mensagem deve ter no máximo :max caracteres.',
+            'privacidade.accepted' => 'Você precisa aceitar a política de privacidade.',
+        ];
+    }
+}

app/Mail/ContactBriefing.php

@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mail;
+
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Mail\Mailable;
+use Illuminate\Mail\Mailables\Content;
+use Illuminate\Mail\Mailables\Envelope;
+use Illuminate\Queue\SerializesModels;
+
+final class ContactBriefing extends Mailable implements ShouldQueue
+{
+    use Queueable;
+    use SerializesModels;
+
+    /**
+     * @param  array<string, mixed>  $fields
+     */
+    public function __construct(
+        public readonly array $fields,
+    ) {}
+
+    public function envelope(): Envelope
+    {
+        return new Envelope(
+            subject: 'Novo briefing de contato — Amare Assessoria',
+        );
+    }
+
+    public function content(): Content
+    {
+        return new Content(
+            html: 'emails.contact-briefing',
+            text: 'emails.contact-briefing-text',
+        );
+    }
+}

app/Mail/ContactBriefingConfirmation.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mail;
+
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Mail\Mailable;
+use Illuminate\Mail\Mailables\Content;
+use Illuminate\Mail\Mailables\Envelope;
+use Illuminate\Queue\SerializesModels;
+
+final class ContactBriefingConfirmation extends Mailable implements ShouldQueue
+{
+    use Queueable;
+    use SerializesModels;
+
+    public function __construct(
+        public readonly string $name,
+        public readonly string $brandName,
+    ) {}
+
+    public function envelope(): Envelope
+    {
+        return new Envelope(
+            subject: 'Recebemos sua mensagem — '.$this->brandName,
+        );
+    }
+
+    public function content(): Content
+    {
+        return new Content(
+            html: 'emails.contact-briefing-confirmation',
+            text: 'emails.contact-briefing-confirmation-text',
+        );
+    }
+}

app/Models/SiteSetting.php

@@ -16,6 +16,8 @@ use Illuminate\Database\Eloquent\Model;
  * @property bool $analytics_enabled
  * @property string|null $default_og_image_path
  * @property string|null $default_og_image_alt
+ * @property string|null $about_image_path
+ * @property string|null $about_image_alt
  * @property string|null $logo_path
  * @property string|null $logo_alt
  */
@@ -30,6 +32,8 @@ use Illuminate\Database\Eloquent\Model;
     'hero_secondary_cta_label',
     'hero_note',
     'about_summary',
+    'about_image_path',
+    'about_image_alt',
     'manifesto_title',
     'manifesto_lead',
     'manifesto_body',

app/Providers/AppServiceProvider.php

@@ -7,6 +7,9 @@ namespace App\Providers;
 use App\Application\Data\PageMeta;
 use App\Models\SiteSetting;
 use Carbon\CarbonImmutable;
+use Illuminate\Cache\RateLimiting\Limit;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\RateLimiter;
 use Illuminate\Support\Facades\View;
 use Illuminate\Support\ServiceProvider;
 use Illuminate\View\View as ViewInstance;
@@ -26,7 +29,9 @@ class AppServiceProvider extends ServiceProvider
      */
     public function boot(): void
     {
+        $this->configureLivewireTemporaryUploads();
         $this->freezeClockWhenConfigured();
+        $this->configureRateLimiters();
 
         View::composer('layouts.public', function (ViewInstance $view): void {
             $settings = $view->offsetExists('siteSettings')
@@ -46,6 +51,29 @@ class AppServiceProvider extends ServiceProvider
         });
     }
 
+    /**
+     * Keep Livewire/Filament temp uploads on the local disk.
+     *
+     * When FILESYSTEM_DISK=r2, Livewire would otherwise use the S3 driver and
+     * browser-PUT straight to R2 (CORS). Final media still uses the r2 disk via
+     * PublicImageUploadRules. Explicit LIVEWIRE_TEMPORARY_FILE_UPLOAD_DISK wins.
+     */
+    private function configureLivewireTemporaryUploads(): void
+    {
+        if (filled(config('livewire.temporary_file_upload.disk'))) {
+            return;
+        }
+
+        config(['livewire.temporary_file_upload.disk' => 'local']);
+    }
+
+    private function configureRateLimiters(): void
+    {
+        RateLimiter::for('contact-briefing', function (Request $request): Limit {
+            return Limit::perMinute(5)->by($request->ip().'|contact-briefing');
+        });
+    }
+
     private function freezeClockWhenConfigured(): void
     {
         if ($this->app->environment('production')) {

bootstrap/app.php

@@ -12,7 +12,8 @@ return Application::configure(basePath: dirname(__DIR__))
         health: '/up',
     )
     ->withMiddleware(function (Middleware $middleware): void {
-        //
+        // Trust Traefik/Dokploy (and local reverse proxies) for X-Forwarded-* headers.
+        $middleware->trustProxies(at: '*');
     })
     ->withExceptions(function (Exceptions $exceptions): void {
         $exceptions->shouldRenderJsonWhen(

composer.lock

@@ -2802,16 +2802,16 @@
         },
         {
             "name": "league/commonmark",
-            "version": "2.8.3",
+            "version": "2.9.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/commonmark.git",
-                "reference": "1902f60f984235023acbe03db6ad614a37b3c3e7"
+                "reference": "5703d83ba3da3b2e356a5fedc848ed6d8ffb6529"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/commonmark/zipball/1902f60f984235023acbe03db6ad614a37b3c3e7",
+                "url": "https://api.github.com/repos/thephpleague/commonmark/zipball/5703d83ba3da3b2e356a5fedc848ed6d8ffb6529",
-                "reference": "1902f60f984235023acbe03db6ad614a37b3c3e7",
+                "reference": "5703d83ba3da3b2e356a5fedc848ed6d8ffb6529",
                 "shasum": ""
             },
             "require": {
@@ -2848,7 +2848,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "2.9-dev"
+                    "dev-main": "2.10-dev"
                 }
             },
             "autoload": {
@@ -2905,7 +2905,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2026-07-12T15:29:16+00:00"
+            "time": "2026-08-03T13:42:31+00:00"
         },
         {
             "name": "league/config",

database/migrations/2026_08_06_000000_add_about_image_to_site_settings_table.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('site_settings', function (Blueprint $table): void {
+            $table->string('about_image_path')->nullable()->after('about_summary');
+            $table->string('about_image_alt')->nullable()->after('about_image_path');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('site_settings', function (Blueprint $table): void {
+            $table->dropColumn(['about_image_path', 'about_image_alt']);
+        });
+    }
+};

database/seeders/ContentSeeder.php

@@ -8,7 +8,7 @@ use App\Models\PortfolioCase;
 use App\Models\PortfolioImage;
 use App\Models\Service;
 use App\Models\SiteSetting;
-use App\Models\Testimonial;
+use App\Support\PublicImageUploadRules;
 use Illuminate\Database\Seeder;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Facades\File;
@@ -23,7 +23,7 @@ class ContentSeeder extends Seeder
         $this->seedSiteSettings();
         $this->seedServices();
         $this->seedPortfolioCases();
-        $this->seedTestimonials();
+        $this->call(TestimonialsSeeder::class);
     }
 
     private function seedSiteSettings(): void
@@ -37,6 +37,8 @@ class ContentSeeder extends Seeder
             'hero_secondary_cta_label' => 'Conheça nosso olhar',
             'hero_note' => 'Planejamento cuidadoso, comunicação clara e execução segura — do primeiro encontro ao último detalhe.',
             'about_summary' => 'Assessoria boutique especializada em experiências memoráveis em São Paulo.',
+            'about_image_path' => $this->copyFixture('about-image.jpg', 'content/about/about-image.jpg'),
+            'about_image_alt' => 'Mesa de planejamento com caderno, café e guardanapos de pano',
             'manifesto_title' => 'Sofisticação que também se traduz em organização.',
             'manifesto_lead' => 'Um evento memorável não nasce apenas de uma boa estética. Ele depende de decisões bem conduzidas, fornecedores alinhados e atenção constante ao que realmente importa.',
             'manifesto_body' => 'A Amare combina sensibilidade e precisão para criar encontros coerentes com cada cliente, marca e ocasião — sem fórmulas prontas, excessos ou ruído.',
@@ -92,7 +94,7 @@ class ContentSeeder extends Seeder
                 ['slug' => $service['slug']],
                 [
                     ...$service,
-                    'cover_image_path' => $this->copyFixture('service-cover.jpg', 'content/services/'.$service['slug'].'.jpg'),
+                    'cover_image_path' => $this->copyFixture('service-'.$service['slug'].'.jpg', 'content/services/'.$service['slug'].'.jpg'),
                     'cover_image_alt' => 'Capa do serviço '.$service['title'],
                     'published_at' => Carbon::parse(self::SEED_TIMESTAMP),
                 ],
@@ -149,7 +151,7 @@ class ContentSeeder extends Seeder
                 ['slug' => $caseData['slug']],
                 [
                     ...$caseData,
-                    'cover_image_path' => $this->copyFixture('portfolio-cover.jpg', 'content/portfolio/'.$caseData['slug'].'-cover.jpg'),
+                    'cover_image_path' => $this->copyFixture('case-'.$caseData['slug'].'.jpg', 'content/portfolio/'.$caseData['slug'].'-cover.jpg'),
                     'cover_image_alt' => 'Capa do caso '.$caseData['title'],
                     'is_featured' => true,
                     'published_at' => Carbon::parse(self::SEED_TIMESTAMP),
@@ -161,7 +163,7 @@ class ContentSeeder extends Seeder
             foreach ([1, 2] as $index) {
                 PortfolioImage::query()->create([
                     'portfolio_case_id' => $case->id,
-                    'path' => $this->copyFixture('gallery.jpg', 'content/portfolio/'.$caseData['slug'].'-gallery-'.$index.'.jpg'),
+                    'path' => $this->copyFixture('gallery-'.$caseData['slug'].'-'.$index.'.jpg', 'content/portfolio/'.$caseData['slug'].'-gallery-'.$index.'.jpg'),
                     'alt_text' => 'Galeria '.$caseData['title'].' '.$index,
                     'caption' => $index === 1 ? 'Detalhe da decoração' : null,
                     'sort_order' => $index,
@@ -170,71 +172,12 @@ class ContentSeeder extends Seeder
         }
     }
 
-    private function seedTestimonials(): void
-    {
-        // Real couples from depoimentos.md. Production publication still requires
-        // explicit couple authorization before setting published_at outside local/demo seeds.
-        $testimonials = [
-            [
-                'quote' => "Mi, quero agradecer você e a sua equipe por todo empenho, atenção, vocês são abençoadas.\n\nEra nítida sua preocupação em garantir que todos os detalhes planejados desta comemoração, fossem atendidos.\n\nQue você possa transformar o grande dia das noivinhas sempre com essa sua leveza!!!\n\nMuito obrigada!",
-                'author_name' => 'Jeniffer e Maick',
-                'context' => 'Casamento · 06/12/2025',
-                'sort_order' => 1,
-                'is_featured' => true,
-            ],
-            [
-                'quote' => "Mi, eu não tenho palavras pra agradecer você e tudo que você fez por mim e por nós na realização desse sonho. Eu tô ainda extasiada com tudo que aconteceu hoje; mas tenho certeza que sem a sua ajuda, muita coisa não aconteceria.\n\nObrigada por tudo !",
-                'author_name' => 'Quesia e Jhonata',
-                'context' => 'Casamento · 21/12/2025',
-                'sort_order' => 2,
-                'is_featured' => true,
-            ],
-            [
-                'quote' => 'Que equipe!! Que equipe maravilhosa!! Obrigado pelo empenho de fazer tudo como eu queria!! Obrigado por se esforçar tanto e vir de tão longe pra realizar meu sonho!! Incríveis!!',
-                'author_name' => 'Milena e Weslley',
-                'context' => 'Casamento · 13/02/2026',
-                'sort_order' => 3,
-                'is_featured' => false,
-            ],
-            [
-                'quote' => "Gostaríamos de agradecer por todo o acompanhamento e dedicação durante a realização do nosso casamento. Foi um dia muito especial e inesquecível para nós.\n\nDesde o início, conseguimos conduzir tudo aquilo que estávamos planejando, dentro dos horários que estipulamos, o que foi ótimo, e no grande dia sua equipe nos recebeu e tratou com muito carinho, atenção e cuidado, o que fez toda a diferença para vivermos esse momento com mais tranquilidade.\n\nTambém adoramos as sugestões e ideias para as fotos, que deixaram os registros ainda mais bonitos e espontâneos, porque não iríamos lembrar de quais poses fazer na hora.\n\nObrigada por fazer parte de um momento tão importante das nossas vidas. Desejamos muito sucesso e que muitos outros casais possam viver dias especiais através do trabalho da AMARE.",
-                'author_name' => 'Raquel e Pedro',
-                'context' => 'Casamento · 09/05/2026',
-                'sort_order' => 4,
-                'is_featured' => false,
-            ],
-            [
-                'quote' => "Miiii, meu amor… você e sua equipe foram impecáveis.\n\nSuperou todas as nossas expectativas. Somos eternamente gratos por fazer nosso dia acontecer muito melhor do que imaginávamos.\n\nSempre muito atenciosa e paciente.\n\nAdoramos te conhecer e estamos muito felizes em termos escolhido você para assessorar nosso dia.",
-                'author_name' => 'Victoria e Pedro',
-                'context' => 'Casamento · 24/06/2026',
-                'sort_order' => 5,
-                'is_featured' => false,
-            ],
-        ];
-
-        $keepAuthors = array_column($testimonials, 'author_name');
-
-        Testimonial::query()
-            ->whereNotIn('author_name', $keepAuthors)
-            ->delete();
-
-        foreach ($testimonials as $testimonial) {
-            Testimonial::query()->updateOrCreate(
-                ['author_name' => $testimonial['author_name']],
-                [
-                    ...$testimonial,
-                    'photo_path' => null,
-                    'photo_alt' => null,
-                    'published_at' => Carbon::parse(self::SEED_TIMESTAMP),
-                ],
-            );
-        }
-    }
-
     private function copyFixture(string $fixtureName, string $destination): string
     {
-        $source = base_path('tests/fixtures/images/'.$fixtureName);
+        $source = base_path('database/fixtures/images/'.$fixtureName);
-        Storage::disk('public')->put($destination, File::get($source));
+        $disk = PublicImageUploadRules::disk();
+
+        Storage::disk($disk)->put($destination, File::get($source), 'public');
 
         return $destination;
     }

database/seeders/TestimonialsSeeder.php

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Database\Seeders;
+
+use App\Models\Testimonial;
+use Illuminate\Database\Seeder;
+use Illuminate\Support\Facades\DB;
+
+class TestimonialsSeeder extends Seeder
+{
+    private const PUBLISHED_AT = '2026-08-05 00:00:00';
+
+    public function run(): void
+    {
+        $testimonials = [
+            [
+                'quote' => "Mi, quero agradecer você e a sua equipe por todo empenho, atenção, vocês são abençoadas.\n\nEra nítida sua preocupação em garantir que todos os detalhes planejados desta comemoração, fossem atendidos.\n\nQue você possa transformar o grande dia das noivinhas sempre com essa sua leveza!!!\n\nMuito obrigada!",
+                'author_name' => 'Jeniffer e Maick',
+                'context' => 'Casamento · 06/12/2025',
+                'sort_order' => 1,
+                'is_featured' => true,
+            ],
+            [
+                'quote' => "Mi, eu não tenho palavras pra agradecer você e tudo que você fez por mim e por nós na realização desse sonho. Eu tô ainda extasiada com tudo que aconteceu hoje; mas tenho certeza que sem a sua ajuda, muita coisa não aconteceria.\n\nObrigada por tudo !",
+                'author_name' => 'Quesia e Jhonata',
+                'context' => 'Casamento · 21/12/2025',
+                'sort_order' => 2,
+                'is_featured' => true,
+            ],
+            [
+                'quote' => 'Que equipe!! Que equipe maravilhosa!! Obrigado pelo empenho de fazer tudo como eu queria!! Obrigado por se esforçar tanto e vir de tão longe pra realizar meu sonho!! Incríveis!!',
+                'author_name' => 'Milena e Weslley',
+                'context' => 'Casamento · 13/02/2026',
+                'sort_order' => 3,
+                'is_featured' => false,
+            ],
+            [
+                'quote' => "Gostaríamos de agradecer por todo o acompanhamento e dedicação durante a realização do nosso casamento. Foi um dia muito especial e inesquecível para nós.\n\nDesde o início, conseguimos conduzir tudo aquilo que estávamos planejando, dentro dos horários que estipulamos, o que foi ótimo, e no grande dia sua equipe nos recebeu e tratou com muito carinho, atenção e cuidado, o que fez toda a diferença para vivermos esse momento com mais tranquilidade.\n\nTambém adoramos as sugestões e ideias para as fotos, que deixaram os registros ainda mais bonitos e espontâneos, porque não iríamos lembrar de quais poses fazer na hora.\n\nObrigada por fazer parte de um momento tão importante das nossas vidas. Desejamos muito sucesso e que muitos outros casais possam viver dias especiais através do trabalho da AMARE.",
+                'author_name' => 'Raquel e Pedro',
+                'context' => 'Casamento · 09/05/2026',
+                'sort_order' => 4,
+                'is_featured' => false,
+            ],
+            [
+                'quote' => "Miiii, meu amor… você e sua equipe foram impecáveis.\n\nSuperou todas as nossas expectativas. Somos eternamente gratos por fazer nosso dia acontecer muito melhor do que imaginávamos.\n\nSempre muito atenciosa e paciente.\n\nAdoramos te conhecer e estamos muito felizes em termos escolhido você para assessorar nosso dia.",
+                'author_name' => 'Victoria e Pedro',
+                'context' => 'Casamento · 24/06/2026',
+                'sort_order' => 5,
+                'is_featured' => false,
+            ],
+        ];
+
+        DB::transaction(function () use ($testimonials): void {
+            foreach ($testimonials as $testimonial) {
+                Testimonial::query()->updateOrCreate(
+                    ['author_name' => $testimonial['author_name']],
+                    [
+                        'quote' => $testimonial['quote'],
+                        'context' => $testimonial['context'],
+                        'sort_order' => $testimonial['sort_order'],
+                        'is_featured' => $testimonial['is_featured'],
+                        'published_at' => self::PUBLISHED_AT,
+                    ],
+                );
+            }
+        });
+    }
+}

database/seeders/VisualContentSeeder.php

@@ -11,7 +11,6 @@ use App\Models\SiteSetting;
 use App\Models\Testimonial;
 use Illuminate\Database\Seeder;
 use Illuminate\Support\Carbon;
-use Illuminate\Support\Facades\File;
 use Illuminate\Support\Facades\Storage;
 
 /**
@@ -44,6 +43,8 @@ class VisualContentSeeder extends Seeder
             'hero_secondary_cta_label' => 'Conheça nosso olhar',
             'hero_note' => 'Planejamento cuidadoso, comunicação clara e execução segura — do primeiro encontro ao último detalhe.',
             'about_summary' => 'Assessoria boutique especializada em experiências memoráveis em São Paulo.',
+            'about_image_path' => $this->writeSolidJpeg('visual/about/about-image.jpg', 1200, 900, [232, 228, 218]),
+            'about_image_alt' => 'Imagem editorial da página Sobre',
             'manifesto_title' => 'Sofisticação que também se traduz em organização.',
             'manifesto_lead' => 'Um evento memorável não nasce apenas de uma boa estética. Ele depende de decisões bem conduzidas, fornecedores alinhados e atenção constante ao que realmente importa.',
             'manifesto_body' => 'A Amare combina sensibilidade e precisão para criar encontros coerentes com cada cliente, marca e ocasião — sem fórmulas prontas, excessos ou ruído.',
@@ -58,7 +59,7 @@ class VisualContentSeeder extends Seeder
             ],
             'default_meta_title' => 'Amare Assessoria de Eventos',
             'default_meta_description' => 'Assessoria premium para casamentos e eventos corporativos em São Paulo.',
-            'default_og_image_path' => $this->copyFixture('og-default.jpg', 'visual/og/og-default.jpg'),
+            'default_og_image_path' => $this->writeSolidJpeg('visual/og/og-default.jpg', 1600, 1067, [85, 107, 47]),
             'default_og_image_alt' => 'Identidade visual da Amare Assessoria de Eventos',
             'analytics_enabled' => false,
             'analytics_script' => null,
@@ -89,7 +90,7 @@ class VisualContentSeeder extends Seeder
                 ['slug' => $service['slug']],
                 [
                     ...$service,
-                    'cover_image_path' => $this->copyFixture('service-cover.jpg', 'visual/services/'.$service['slug'].'.jpg'),
+                    'cover_image_path' => $this->writeSolidJpeg('visual/services/'.$service['slug'].'.jpg', 1600, 1000, [196, 200, 184]),
                     'cover_image_alt' => 'Capa do serviço '.$service['title'],
                     'published_at' => Carbon::parse(self::SEED_TIMESTAMP),
                 ],
@@ -133,7 +134,7 @@ class VisualContentSeeder extends Seeder
                 ['slug' => $caseData['slug']],
                 [
                     ...$caseData,
-                    'cover_image_path' => $this->copyFixture('portfolio-cover.jpg', 'visual/portfolio/'.$caseData['slug'].'-cover.jpg'),
+                    'cover_image_path' => $this->writeSolidJpeg('visual/portfolio/'.$caseData['slug'].'-cover.jpg', 1600, 1200, [240, 238, 233]),
                     'cover_image_alt' => 'Capa do caso '.$caseData['title'],
                     'is_featured' => true,
                     'published_at' => Carbon::parse(self::SEED_TIMESTAMP),
@@ -144,7 +145,7 @@ class VisualContentSeeder extends Seeder
 
             PortfolioImage::query()->create([
                 'portfolio_case_id' => $case->id,
-                'path' => $this->copyFixture('gallery.jpg', 'visual/portfolio/'.$caseData['slug'].'-gallery-1.jpg'),
+                'path' => $this->writeSolidJpeg('visual/portfolio/'.$caseData['slug'].'-gallery-1.jpg', 1600, 1200, [228, 226, 221]),
                 'alt_text' => 'Galeria '.$caseData['title'].' 1',
                 'caption' => 'Detalhe da decoração',
                 'sort_order' => 1,
@@ -186,10 +187,21 @@ class VisualContentSeeder extends Seeder
         }
     }
 
-    private function copyFixture(string $fixtureName, string $destination): string
+    /**
+     * @param  array{0: int, 1: int, 2: int}  $rgb
+     */
+    private function writeSolidJpeg(string $destination, int $width, int $height, array $rgb): string
     {
-        $source = base_path('tests/fixtures/images/'.$fixtureName);
+        $image = imagecreatetruecolor($width, $height);
-        Storage::disk('public')->put($destination, File::get($source));
+        $color = imagecolorallocate($image, $rgb[0], $rgb[1], $rgb[2]);
+        imagefilledrectangle($image, 0, 0, $width, $height, $color);
+
+        ob_start();
+        imagejpeg($image, null, 90);
+        $binary = (string) ob_get_clean();
+        imagedestroy($image);
+
+        Storage::disk('public')->put($destination, $binary);
 
         return $destination;
     }

docker-compose.deploy.yml

@@ -0,0 +1,73 @@
+# Shared Compose for Dokploy staging and production.
+# Both stacks use the same file with different env:
+#   APP_IMAGE=ghcr.io/<owner>/<repo>
+#   IMAGE_TAG=staging|production|<git-sha>
+# PostgreSQL is a separate Dokploy database service (not defined here).
+# Traefik/Dokploy domains should target service `web` port 8000.
+# App services join dokploy-network so they can resolve Dokploy-managed
+# Postgres internal hosts (e.g. amare-stg-pez43e).
+
+services:
+  migrate:
+    image: ${APP_IMAGE}:${IMAGE_TAG}
+    pull_policy: always
+    restart: "no"
+    env_file:
+      - .env
+    command: ["sh", "-c", "php artisan migrate --force --no-interaction && php artisan db:seed --class=ContentSeeder --force; php artisan media:generate-variants --force; true"]
+    networks:
+      - dokploy-network
+
+  web:
+    image: ${APP_IMAGE}:${IMAGE_TAG}
+    pull_policy: always
+    restart: unless-stopped
+    env_file:
+      - .env
+    depends_on:
+      migrate:
+        condition: service_completed_successfully
+    expose:
+      - "8000"
+    healthcheck:
+      test: ["CMD", "curl", "-fsS", "http://127.0.0.1:8000/up"]
+      interval: 30s
+      timeout: 5s
+      start_period: 40s
+      retries: 3
+    networks:
+      - dokploy-network
+
+  queue:
+    image: ${APP_IMAGE}:${IMAGE_TAG}
+    pull_policy: always
+    restart: unless-stopped
+    env_file:
+      - .env
+    depends_on:
+      migrate:
+        condition: service_completed_successfully
+    command: ["php", "artisan", "queue:work", "--sleep=2", "--tries=3", "--max-time=3600"]
+    stop_grace_period: 60s
+    stop_signal: SIGTERM
+    networks:
+      - dokploy-network
+
+  scheduler:
+    image: ${APP_IMAGE}:${IMAGE_TAG}
+    pull_policy: always
+    restart: unless-stopped
+    env_file:
+      - .env
+    depends_on:
+      migrate:
+        condition: service_completed_successfully
+    command: ["php", "artisan", "schedule:work"]
+    stop_grace_period: 30s
+    stop_signal: SIGTERM
+    networks:
+      - dokploy-network
+
+networks:
+  dokploy-network:
+    external: true

docker/README.md

@@ -7,5 +7,8 @@ Mesma imagem, comandos distintos:
 | web | `frankenphp run --config /etc/caddy/Caddyfile` |
 | queue | `php artisan queue:work --sleep=2 --tries=3` |
 | scheduler | `php artisan schedule:work` |
+| migrate | `php artisan migrate --force` (one-shot no Compose de deploy) |
 
 FrankenPHP em **modo regular** (ADR-006). Worker mode proibido no MVP.
+
+Deploy Dokploy (staging/produção): ver [`docker-compose.deploy.yml`](../docker-compose.deploy.yml) e [docs/deployment/dokploy.md](../docs/deployment/dokploy.md).

docs/agents/domain.md

@@ -0,0 +1,51 @@
+# Domain Docs
+
+How the engineering skills should consume this repo's domain documentation when exploring the codebase.
+
+## Before exploring, read these
+
+- **`CONTEXT.md`** at the repo root, or
+- **`CONTEXT-MAP.md`** at the repo root if it exists — it points at one `CONTEXT.md` per context. Read each one relevant to the topic.
+- **`docs/adr/`** — read ADRs that touch the area you're about to work in. In multi-context repos, also check `src/<context>/docs/adr/` for context-scoped decisions.
+
+If any of these files don't exist, **proceed silently**. Don't flag their absence; don't suggest creating them upfront. The `/domain-modeling` skill (reached via `/grill-with-docs` and `/improve-codebase-architecture`) creates them lazily when terms or decisions actually get resolved.
+
+## File structure
+
+Single-context repo (most repos):
+
+```
+/
+├── CONTEXT.md
+├── docs/adr/
+│   ├── 0001-event-sourced-orders.md
+│   └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+Multi-context repo (presence of `CONTEXT-MAP.md` at the root):
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/adr/                          ← system-wide decisions
+└── src/
+    ├── ordering/
+    │   ├── CONTEXT.md
+    │   └── docs/adr/                  ← context-specific decisions
+    └── billing/
+        ├── CONTEXT.md
+        └── docs/adr/
+```
+
+## Use the glossary's vocabulary
+
+When your output names a domain concept (in an issue title, a refactor proposal, a hypothesis, a test name), use the term as defined in `CONTEXT.md`. Don't drift to synonyms the glossary explicitly avoids.
+
+If the concept you need isn't in the glossary yet, that's a signal — either you're inventing language the project doesn't use (reconsider) or there's a real gap (note it for `/domain-modeling`).
+
+## Flag ADR conflicts
+
+If your output contradicts an existing ADR, surface it explicitly rather than silently overriding:
+
+> _Contradicts ADR-0007 (event-sourced orders) — but worth reopening because…_

docs/agents/issue-tracker.md

@@ -0,0 +1,26 @@
+# Issue tracker: Linear
+
+Issues and specs for this repo live in Linear. Use the Linear MCP tools for all operations.
+
+- **Workspace**: maneco-workspace (https://linear.app/maneco-workspace)
+- **Team**: Maneco-workspace
+- **Issue statuses**: Backlog, Todo, In Progress, Done, Canceled, Duplicate
+
+## Conventions
+
+- **Create an issue**: `save_issue` with `title`, `team` (`Maneco-workspace`), and markdown `description`. Assign via `assignee` ("me" for the current user).
+- **Read an issue**: `get_issue` by identifier (e.g. `LIN-123`).
+- **List issues**: `list_issues` filtered by `team`, `assignee`, `state`, or `project`.
+- **Comment on an issue**: `save_comment` with `issueId` and markdown `body`.
+- **Apply / remove labels**: `save_issue` with `labels` (replaces the full set).
+- **Move workflow state**: `save_issue` with `state` (e.g. `Todo`, `In Progress`, `Done`, `Canceled`).
+- **Link work**: `save_issue` with `project`, `cycle`, `parentId`, `blocks` / `blockedBy` (relations are append-only).
+- **Cross-link to a PR**: attach the PR URL via `save_issue` `links`.
+
+## When a skill says "publish to the issue tracker"
+
+Create a Linear issue with `save_issue` on team `Maneco-workspace`.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `get_issue` on the identifier and read the description, state, labels, and assignee.

docs/agents/triage-labels.md

@@ -0,0 +1,15 @@
+# Triage Labels
+
+The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.
+
+| Label in mattpocock/skills | Label in our tracker | Meaning                                  |
+| -------------------------- | -------------------- | ---------------------------------------- |
+| `needs-triage`             | `needs-triage`       | Maintainer needs to evaluate this issue  |
+| `needs-info`               | `needs-info`         | Waiting on reporter for more information |
+| `ready-for-agent`          | `ready-for-agent`    | Fully specified, ready for an AFK agent  |
+| `ready-for-human`          | `ready-for-human`    | Requires human implementation            |
+| `wontfix`                  | `wontfix`            | Will not be actioned                     |
+
+When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.
+
+Edit the right-hand column to match whatever vocabulary you actually use.

docs/deployment/dokploy.md

@@ -0,0 +1,300 @@
+# Deploy Dokploy (staging → production)
+
+Runbook for operating Amare on a VPS with Dokploy connected to GitHub, publishing immutable images to GHCR.
+
+## Architecture
+
+```
+CI (main) → build FrankenPHP image → GHCR :<sha> + :staging
+         → Dokploy staging compose.deploy
+         → smoke /up / /admin/login
+
+Promote (manual) → retag same digest as :production (no rebuild)
+                 → Dokploy production compose.deploy
+                 → smoke
+```
+
+| Piece | Detail |
+|---|---|
+| Compose file | [`docker-compose.deploy.yml`](../../docker-compose.deploy.yml) |
+| Processes | `migrate` (one-shot) → `web` / `queue` / `scheduler` |
+| Image | `ghcr.io/<owner>/<repo>:<sha>` (+ aliases `:staging`, `:production`) |
+| Database | Dokploy PostgreSQL **per environment** (not in the app image) |
+| Media | Cloudflare R2 (`FILESYSTEM_DISK=r2`), separate buckets per environment |
+| Mail | Resend (`MAIL_MAILER=resend`) |
+| Proxy | Dokploy Traefik → service `web` port `8000` |
+
+## Prerequisites (manual)
+
+1. Dokploy installed on the VPS; GitHub provider connected.
+2. GHCR registry in Dokploy (`ghcr.io`) with a PAT that can **read** packages (`read:packages`). Prefer a dedicated bot/token; do not store write tokens on the VPS.
+3. Two PostgreSQL services in Dokploy (staging + production), private (no public port).
+4. Two R2 buckets (or prefixes) and Resend credentials for each environment as needed.
+5. Domains (or temporary Dokploy/traefik.me hosts) pointing at the VPS with TLS.
+
+## Create Compose stacks
+
+Create **two** Dokploy Compose services (same repo, same compose path):
+
+| Stack | Compose path | `IMAGE_TAG` | Notes |
+|---|---|---|---|
+| staging | `docker-compose.deploy.yml` | `staging` | Auto-deployed after CI on `main` |
+| production | `docker-compose.deploy.yml` | `production` | Manual promotion only |
+
+Dokploy Environment for each stack must set:
+
+```bash
+APP_IMAGE=ghcr.io/<owner>/<repo>
+IMAGE_TAG=staging   # or production
+```
+
+Point Dokploy domain(s) at service **`web`**, port **`8000`**. Do not publish PostgreSQL or host ports for app processes.
+
+Compose services must join the external Docker network `dokploy-network` (declared in `docker-compose.deploy.yml`) so they can resolve the Dokploy-managed Postgres internal host (e.g. `amare-stg-pez43e`). Set `DB_HOST` to that **Internal Host** from the Dokploy database UI — not a public hostname.
+
+Source can be GitHub (so Dokploy clones the compose file) or Raw paste of `docker-compose.deploy.yml`. Prefer GitHub + fixed compose path so updates stay in sync with `main`.
+
+## Required Laravel env (Dokploy only)
+
+Set these in Dokploy Environment UI (written to `.env` next to the compose file). **Never** put them in GitHub Actions secrets or image layers.
+
+```env
+APP_NAME=Amare
+APP_ENV=staging          # or production
+APP_KEY=base64:...       # unique per environment — generate with php artisan key:generate --show
+APP_DEBUG=false
+APP_URL=https://staging.example.com
+
+APP_LOCALE=pt_BR
+APP_FALLBACK_LOCALE=pt_BR
+APP_TIMEZONE=America/Fortaleza
+
+DB_CONNECTION=pgsql
+DB_HOST=<dokploy-postgres-internal-host>  # Internal Host from Dokploy UI (requires dokploy-network)
+DB_PORT=5432
+DB_DATABASE=amare_staging
+DB_USERNAME=...
+DB_PASSWORD=...
+
+SESSION_DRIVER=database
+SESSION_SECURE_COOKIE=true
+SESSION_HTTP_ONLY=true
+SESSION_SAME_SITE=lax
+CACHE_STORE=database
+QUEUE_CONNECTION=database
+
+FILESYSTEM_DISK=r2
+R2_ACCESS_KEY_ID=...
+R2_SECRET_ACCESS_KEY=...
+R2_BUCKET=...
+R2_ENDPOINT=https://<account_id>.r2.cloudflarestorage.com
+R2_URL=https://media-staging.example.com
+
+MAIL_MAILER=resend
+RESEND_API_KEY=...
+MAIL_FROM_ADDRESS=noreply@example.com
+MAIL_FROM_NAME=Amare
+
+LOG_LEVEL=warning
+```
+
+Trusted proxies are configured in `bootstrap/app.php` so Traefik `X-Forwarded-*` headers work for HTTPS cookies and URLs.
+
+Livewire temporary uploads default to the **local** disk in `AppServiceProvider` (even when `FILESYSTEM_DISK=r2`), so Filament does not browser-PUT to R2. Final media still lands on R2 via `PublicImageUploadRules`. Optional override: `LIVEWIRE_TEMPORARY_FILE_UPLOAD_DISK` in Dokploy `.env` (`env_file` accepts any key — does not need a compose `environment:` entry).
+
+### R2 CORS (public/media reads from JS)
+
+Upload path does not need R2 CORS with the local temp-disk default. Still useful if the browser fetches R2 URLs cross-origin from JS. Origin must match `APP_URL` exactly; include `AllowedHeaders`:
+
+```json
+[
+  {
+    "AllowedOrigins": ["https://hellomanoel.com"],
+    "AllowedMethods": ["GET", "PUT", "POST", "HEAD"],
+    "AllowedHeaders": ["*"],
+    "ExposeHeaders": ["ETag", "Content-Type"],
+    "MaxAgeSeconds": 3600
+  }
+]
+```
+
+Also enable public access / custom domain for `R2_URL` so `<img>` URLs work after save.
+
+## GitHub Actions secrets
+
+Repository secrets used by workflows:
+
+| Secret | Purpose |
+|---|---|
+| `DOKPLOY_URL` | Panel origin **without** `/api` (e.g. `https://panel.example.com`). Do not use the OpenAPI base URL that ends in `/api` — that yields `/api/api/...` and 404s. |
+| `DOKPLOY_API_KEY` | API key from Dokploy profile → API/CLI |
+| `DOKPLOY_STAGING_COMPOSE_ID` | Staging **Compose** service id (not an Application id) |
+| `DOKPLOY_PRODUCTION_COMPOSE_ID` | Production **Compose** service id (not an Application id) |
+| `STAGING_URL` | Public origin for staging smoke (e.g. `https://staging.example.com`) |
+| `PRODUCTION_URL` | Public origin for production smoke |
+
+HTTP 404 from `compose.deploy` usually means the compose id is wrong (Application id instead of Compose) or `DOKPLOY_URL` still includes `/api`.
+
+`GITHUB_TOKEN` (automatic) publishes to GHCR with `packages:write`. No Laravel/`APP_KEY`/DB/R2/Resend secrets belong in GitHub for this pipeline.
+
+## Workflows
+
+### Staging (automatic)
+
+[`.github/workflows/deploy-staging.yml`](../../.github/workflows/deploy-staging.yml)
+
+1. Waits for workflow `CI` success on push to `main`.
+2. Builds once; pushes `:<full-sha>` and `:staging`.
+3. Calls Dokploy `compose.deploy` and polls until done.
+4. Runs [`scripts/deploy/smoke.sh`](../../scripts/deploy/smoke.sh) against `STAGING_URL`.
+
+### Production (manual)
+
+[`.github/workflows/promote-production.yml`](../../.github/workflows/promote-production.yml)
+
+1. Operator runs **Actions → Promote production**.
+2. Inputs: full `sha` already on GHCR; `confirm` must be exactly `PRODUCTION`.
+3. Retags the **same digest** as `:production` (no rebuild).
+4. Deploys production compose + smoke.
+
+Private repos on GitHub Free do not get Environment required reviewers; human approval is the explicit `workflow_dispatch` + confirmation string. GitHub Pro Environment reviewers are optional later.
+
+## First admin and authorized production seeding
+
+Seed credentials are local-only. For staging/production:
+
+FrankenPHP sets `XDG_CONFIG_HOME=/config` (Caddy). PsySH/tinker then tries `/config/psysh`, which `appuser` cannot write — you get `Writing to directory /config/psysh is not allowed.` Override that env for the one-shot command:
+
+```bash
+# From Dokploy → staging/production → Open terminal on `web` (or one-off run)
+XDG_CONFIG_HOME=/tmp php artisan tinker --execute="
+\$user = \\App\\Models\\User::query()->updateOrCreate(
+  ['email' => 'admin@example.com'],
+  [
+    'name' => 'Admin',
+    'password' => 'use-a-strong-password',
+    'role' => 'admin',
+    'is_active' => true,
+  ]
+);
+\$user->forceFill(['email_verified_at' => now()])->save();
+echo \$user->email.PHP_EOL;
+"
+```
+
+Plain password is enough: `User` casts `password` to `hashed` (and skips re-hash when value already hashed). `email_verified_at` is not mass-assignable — use `forceFill` as above.
+
+Confirm:
+
+```bash
+XDG_CONFIG_HOME=/tmp php artisan tinker --execute="echo \\App\\Models\\User::query()->where('email', 'admin@example.com')->exists() ? 'ok' : 'missing';"
+```
+
+Never reuse `admin@amare.local` / `password`.
+
+### Load authorized testimonials after migrations
+
+After migrations, manually load the five authorized testimonials in **staging**, then repeat in **production**. From Dokploy, open a terminal on the environment's `web` service (or run an equivalent one-off process):
+
+```bash
+php artisan db:seed --class='Database\Seeders\TestimonialsSeeder' --force --no-interaction
+```
+
+This seeder is safe to rerun: it overwrites canonical source-owned fields, preserves curated photo fields, and leaves unrelated testimonials unchanged. The five records are published with the approved deterministic timestamp. Upsert keys on `author_name` (no unique DB constraint); keep one row per couple before/after running.
+
+Optional verification:
+
+```bash
+XDG_CONFIG_HOME=/tmp php artisan tinker --execute="
+\$expected = collect(['Jeniffer e Maick', 'Quesia e Jhonata', 'Milena e Weslley', 'Raquel e Pedro', 'Victoria e Pedro']);
+\$rows = \\App\\Models\\Testimonial::query()->whereIn('author_name', \$expected)->get(['author_name', 'published_at'])->groupBy('author_name');
+\$valid = \$expected->every(function (string \$author) use (\$rows): bool {
+  \$matches = \$rows->get(\$author, collect());
+  return \$matches->count() === 1
+    && \$matches->first()->published_at?->format('Y-m-d H:i:s') === '2026-08-05 00:00:00';
+});
+echo (\$valid ? 'ok' : 'invalid').PHP_EOL;
+"
+```
+
+Expected output: `ok`.
+
+Do not run `DatabaseSeeder` or `ContentSeeder` in staging or production: they include local credentials and/or broad demo-content effects. Deployment workflows intentionally remain migrate-only; loading these testimonials is a deliberate manual operation in each environment.
+
+## Backup and restore
+
+Policy (SPEC §16.3): daily PostgreSQL backup, retention ≥ 14 days, RPO ≤ 24h, RTO ≤ 4h.
+
+### Configure (Dokploy)
+
+1. Settings → Destinations: add S3-compatible destination (AWS S3, R2, etc.).
+2. Open each PostgreSQL service → Backup:
+   - Destination: the S3 destination
+   - Schedule: cron e.g. `0 3 * * *`
+   - Prefix: `amare/staging` or `amare/production`
+   - Enabled: on
+3. Click **Test** and verify the object appears in the bucket.
+4. Prefer Dokploy alerts/webhooks for backup failure if configured.
+
+### Restore (staging rehearsal before first production promote)
+
+1. Create a scratch database or restore into a disposable Postgres service.
+2. Database → Backup → **Restore**: pick destination + backup file + target database name.
+3. Point a temporary compose env at the restored DB and confirm `/up` + `/admin/login`.
+4. Document the timestamp of the successful rehearsal.
+
+Do **not** promote to production until staging restore has been proven once.
+
+## Rollback
+
+No rebuild. Move the environment alias to a previous SHA digest and redeploy.
+
+### Staging
+
+```bash
+# Locally or in a one-off Actions shell with GHCR login
+docker buildx imagetools create \
+  --tag ghcr.io/<owner>/<repo>:staging \
+  ghcr.io/<owner>/<repo>:<previous-sha>
+
+# Then trigger Dokploy deploy (UI Deploy, or):
+DOKPLOY_URL=... DOKPLOY_API_KEY=... DOKPLOY_COMPOSE_ID=... \
+  ./scripts/deploy/dokploy-deploy.sh
+
+SMOKE_BASE_URL=https://staging.example.com ./scripts/deploy/smoke.sh
+```
+
+### Production
+
+Same pattern with `:production` tag and production compose id / URL. Prefer re-running **Promote production** with the previous SHA and confirmation `PRODUCTION`.
+
+If a migration is not backward-compatible, fix forward with a new SHA; keep migrations reversible when possible.
+
+## Smoke checks
+
+```bash
+SMOKE_BASE_URL=https://staging.example.com ./scripts/deploy/smoke.sh
+```
+
+Expects HTTP 200 for `/up`, `/`, and `/admin/login`.
+
+## Domain checklist before production promote
+
+- [ ] Final hostname DNS → VPS
+- [ ] Dokploy TLS certificate issued
+- [ ] `APP_URL` matches public HTTPS origin
+- [ ] `SESSION_SECURE_COOKIE=true`
+- [ ] Staging smoke green on the SHA to promote
+- [ ] Staging backup + restore rehearsed
+- [ ] Production Postgres backup schedule enabled
+- [ ] Production R2 bucket + Resend domain ready
+- [ ] First admin created without seed
+
+## Local validation of Compose
+
+```bash
+APP_IMAGE=ghcr.io/<owner>/<repo> IMAGE_TAG=staging \
+  docker compose -f docker-compose.deploy.yml config
+```
+
+Requires a `.env` file present (Dokploy creates it from Environment UI). For local config checks, an empty `.env` is enough.

frontend-audit.md

@@ -0,0 +1,262 @@
+Audite e melhore integralmente este projeto do site da **Amare**, incluindo todas as rotas públicas, componentes compartilhados, formulários, navegação, conteúdo, metadados e comportamento responsivo.
+
+Você está autorizado a executar o projeto, inspecionar o repositório e modificar diretamente o código. Não entregue somente recomendações: implemente as correções necessárias e valide o resultado.
+
+## Objetivo
+
+Deixar o site tecnicamente sólido, visualmente refinado e pronto para apresentação à cliente e posterior lançamento, corrigindo problemas de:
+
+* UI e UX;
+* responsividade;
+* posicionamento e conteúdo;
+* acessibilidade;
+* conversão;
+* SEO;
+* performance;
+* robustez;
+* qualidade e manutenção do código.
+
+## Contexto do produto
+
+A Amare é uma empresa de assessoria, produção e organização de eventos em São Paulo.
+
+Ela atende:
+
+* casamentos;
+* eventos sociais e celebrações particulares;
+* eventos corporativos.
+
+O site não deve transmitir que a empresa trabalha exclusivamente com casamentos.
+
+A experiência precisa equilibrar:
+
+* emoção, proximidade, sensibilidade e sofisticação para eventos sociais;
+* organização, segurança, método, clareza e credibilidade para eventos corporativos.
+
+O resultado deve ser editorial, contemporâneo, humano, elegante e profissional, sem parecer excessivamente romântico nem corporativo demais.
+
+Preview de referência:
+
+`https://amare.preview.hellomanoel.com/`
+
+Considere os documentos existentes no repositório, especialmente `AGENTS.md`, `README.md`, `SPEC.md`, `DESIGN.md` e equivalentes, como contexto autoritativo do projeto.
+
+## Direção visual
+
+Preserve a identidade visual existente quando ela funcionar corretamente:
+
+* fundos off-white ou bege claro;
+* verde oliva;
+* composição editorial;
+* fotografias em destaque;
+* espaços em branco generosos;
+* EB Garamond em títulos e destaques;
+* elementos minimalistas;
+* animações discretas;
+* aparência refinada e atemporal.
+
+Não preserve decisões que prejudiquem usabilidade, contraste, legibilidade, acessibilidade, responsividade ou performance.
+
+Avalie especialmente:
+
+* uso excessivo de Garamond em textos pequenos, menus, botões e formulários;
+* verdes claros com contraste insuficiente;
+* CTAs discretos demais;
+* espaços vazios excessivos no celular;
+* imagens que reforcem somente o posicionamento de casamento;
+* falta de equilíbrio entre conteúdo social e corporativo;
+* inconsistência tipográfica ou de espaçamento;
+* aparência de template genérico de casamento.
+
+## Escopo da auditoria
+
+Analise todas as rotas encontradas no código e corrija problemas relacionados a:
+
+### Produto e conteúdo
+
+* clareza da proposta de valor;
+* equilíbrio entre eventos sociais e corporativos;
+* hierarquia das informações;
+* conteúdo genérico, redundante ou sem função;
+* coerência entre títulos, textos, imagens e CTAs;
+* clareza dos serviços;
+* confiança e credibilidade;
+* caminho até contato ou solicitação de proposta.
+
+Não invente história, números, clientes, prêmios, depoimentos, equipe, serviços, telefone, e-mail ou qualquer informação não confirmada.
+
+### UI e experiência
+
+* navegação;
+* header e footer;
+* menu mobile;
+* hierarquia visual;
+* tipografia;
+* espaçamento;
+* grids;
+* CTAs;
+* formulários;
+* estados interativos;
+* consistência entre páginas;
+* experiência mobile-first;
+* ausência de overflow, cortes, sobreposições ou distorções;
+* adaptação real do layout ao celular, e não apenas redução da versão desktop.
+
+### Acessibilidade
+
+Use WCAG 2.2 AA como referência prática.
+
+Corrija problemas de:
+
+* HTML semântico;
+* hierarquia de headings;
+* navegação por teclado;
+* foco visível;
+* contraste;
+* nomes acessíveis;
+* labels;
+* mensagens de erro;
+* áreas de toque;
+* textos alternativos;
+* menu mobile;
+* overlays;
+* preferência por redução de movimento;
+* uso correto de links e botões.
+
+Prefira HTML semântico a ARIA desnecessária.
+
+### Formulários e conversão
+
+Garanta, quando aplicável:
+
+* campos e obrigatoriedade claros;
+* validação adequada;
+* mensagens de erro específicas;
+* estado de envio;
+* prevenção de envio duplicado;
+* estados de sucesso e falha;
+* tratamento de erro de rede;
+* preservação dos dados após erros recuperáveis;
+* proteção antispam simples;
+* privacidade e LGPD;
+* links e mensagens de WhatsApp corretos;
+* ausência de segredos expostos no cliente.
+
+Quando algum dado real não estiver disponível, use configuração ou variável de ambiente e documente a pendência.
+
+### SEO
+
+Corrija, quando aplicável:
+
+* títulos exclusivos por rota;
+* meta descriptions;
+* canonical;
+* Open Graph;
+* Twitter cards;
+* sitemap;
+* robots;
+* favicon;
+* idioma;
+* headings;
+* URLs;
+* links internos;
+* página 404;
+* metadados sociais;
+* indexação distinta entre preview e produção.
+
+Não crie dados estruturados com informações não confirmadas.
+
+### Performance
+
+Corrija problemas relevantes relacionados a:
+
+* imagens;
+* tamanhos responsivos;
+* formatos modernos;
+* lazy loading;
+* LCP;
+* CLS;
+* INP;
+* fontes;
+* scripts desnecessários;
+* hidratação excessiva;
+* JavaScript evitável;
+* componentes client-side sem necessidade;
+* animações custosas;
+* dependências pesadas;
+* carregamento de conteúdo abaixo da dobra.
+
+Preserve a qualidade visual das fotografias.
+
+### Qualidade técnica
+
+Corrija:
+
+* erros de TypeScript;
+* erros de lint;
+* erros de build;
+* warnings de hidratação;
+* erros de console;
+* requisições quebradas;
+* links inválidos;
+* rotas órfãs;
+* componentes duplicados quando a consolidação simplificar o projeto;
+* tratamento de erros ausente;
+* tipagem insegura;
+* complexidade desnecessária diretamente relacionada ao escopo.
+
+## Prioridades
+
+Considere:
+
+* **P0:** bloqueia funcionamento, segurança, uso ou lançamento;
+* **P1:** prejudica significativamente experiência, conversão, acessibilidade, SEO, performance ou credibilidade;
+* **P2:** refinamento não essencial para o lançamento.
+
+Implemente todos os itens P0 e P1 que possam ser resolvidos com as informações existentes.
+
+Itens dependentes de dados reais da cliente devem permanecer como pendências explícitas, sem conteúdo fictício.
+
+## Restrições
+
+* Preserve a stack e a arquitetura existentes quando forem adequadas.
+* Prefira mudanças simples, localizadas e fáceis de manter.
+* Não reescreva o projeto sem necessidade concreta.
+* Não adicione bibliotecas quando a solução atual for suficiente.
+* Não implemente pagamentos, CRM, área do cliente, chat, contratos avançados ou funcionalidades fora do MVP.
+* Não altere arquivos não relacionados sem justificativa.
+* Preserve alterações locais preexistentes.
+* Não silencie problemas com `any`, `eslint-disable`, casts inseguros ou desativação de validações.
+* Não reduza acessibilidade para preservar estética.
+* Não deixe mocks ou soluções temporárias como implementação final.
+
+## Critérios de conclusão
+
+A tarefa estará concluída quando:
+
+* todas as rotas públicas existentes tiverem sido auditadas;
+* todos os problemas P0 e P1 solucionáveis tiverem sido corrigidos;
+* o site funcionar corretamente em mobile e desktop;
+* não houver overflow horizontal, sobreposição ou componentes quebrados;
+* menu, navegação, links, CTAs e formulários funcionarem;
+* o posicionamento social e corporativo estiver claro;
+* a acessibilidade essencial estiver atendida;
+* os metadados e fundamentos de SEO estiverem corretos;
+* os principais problemas de performance tiverem sido tratados;
+* erros causados ou revelados pelas alterações tiverem sido resolvidos;
+* lint, TypeScript, testes e build disponíveis tiverem sido executados com sucesso.
+
+Não declare uma validação como aprovada sem executá-la.
+
+## Entrega final
+
+Ao concluir, apresente:
+
+1. rotas auditadas;
+2. problemas principais encontrados;
+3. alterações implementadas;
+4. arquivos modificados;
+5. comandos executados e seus resultados;
+6. decisões e trade-offs relevantes;
+7. informações que dependem da cliente;
+8. itens P2 mantidos fora do escopo.

openspec/changes/complete-foundation-parity/design.md

@@ -15,15 +15,17 @@ Fases 0–1 e provedores de produção (Resend + R2) estão em `main` com CI ver
 
 - Staging em Dokploy com a mesma imagem FrankenPHP por SHA para web, queue e scheduler.
 - Deploy automático em `main` após CI: build → GHCR → Dokploy API → migrate → health → smoke.
-- Compose local com app FrankenPHP + Postgres.
+- Produção via promoção manual da mesma digest SHA (alias `:production`), sem rebuild.
-- PHP 8.4 canônico em docs/Docker/CI.
+- Backup PostgreSQL diário (retenção ≥14 dias), restore documentado e rollback por SHA.
-- Gates com `npm audit` e cobertura Domain/Application ≥ 80%.
+- Compose local com app FrankenPHP + Postgres (pendente fora da fatia deploy).
-- E-mail verificado + reset de senha seguros no painel (ADM-01 / SPEC §12.1).
+- PHP 8.4 canônico em docs/Docker/CI (pendente).
-- Strict types em PHP próprio faltante.
+- Gates com `npm audit` e cobertura Domain/Application ≥ 80% (pendente).
+- E-mail verificado + reset de senha seguros no painel (ADM-01 / SPEC §12.1) (pendente).
+- Strict types em PHP próprio faltante (pendente).
 
 **Non-Goals:**
 
-- Produção, promoção humana, provisionamento de VPS para clientes.
+- Deploy automático em produção; provisionamento de VPS para clientes.
 - Fase 2 (briefing/CRM/E2E-01/02).
 - Redis, worker mode, CDN automation, signed private media.
 
@@ -31,11 +33,13 @@ Fases 0–1 e provedores de produção (Resend + R2) estão em `main` com CI ver
 
 ### D1 — Dokploy Compose na VPS, imagem imutável no GHCR
 
-GitHub Actions (após CI verde em `main`) constrói **uma** imagem `ghcr.io/<owner>/<repo>:<git-sha>` (+ alias `:staging`), faz push privado e chama `POST /api/compose.deploy` (ou `compose.update` + `compose.deploy`) no Dokploy com `x-api-key`.
+GitHub Actions (após CI verde em `main`) constrói **uma** imagem `ghcr.io/<owner>/<repo>:<git-sha>` (+ alias `:staging`), faz push privado e chama `POST /api/compose.deploy` no Dokploy com `x-api-key`.
 
-Compose de staging referencia `${APP_IMAGE}` / `IMAGE_TAG` para `web`, `queue`, `scheduler` e job `migrate` one-shot (`php artisan migrate --force`). PostgreSQL é serviço Dokploy separado (não na imagem da app).
+Compose compartilhado (`docker-compose.deploy.yml`) referencia `${APP_IMAGE}` / `IMAGE_TAG` para `web`, `queue`, `scheduler` e job `migrate` one-shot (`php artisan migrate --force`). Dokploy mantém **duas** stacks Compose (staging e production) com `IMAGE_TAG` distinto. PostgreSQL é serviço Dokploy separado por ambiente (não na imagem da app).
 
-*Alternativas rejeitadas:* Railway (Pro para GHCR privado + desvio de plataforma); rebuild por serviço no Dokploy (quebra “mesma imagem” SPEC §14.3/§15.2); tag só `:latest` (rollback frágil).
+Produção: `workflow_dispatch` com SHA + confirmação `PRODUCTION` move alias `:production` para o **mesmo digest** já publicado e dispara `compose.deploy` na stack de produção. Repo privado no GitHub Free não tem required reviewers de Environment; aprovação humana = disparo manual explícito (GitHub Pro opcional depois).
+
+*Alternativas rejeitadas:* Railway (Pro para GHCR privado + desvio de plataforma); rebuild por serviço no Dokploy (quebra “mesma imagem” SPEC §14.3/§15.2); tag só `:latest` (rollback frágil); deploy automático direto em produção.
 
 ### D2 — Processos e health
 
@@ -50,7 +54,11 @@ Healthcheck Docker/Dokploy e smoke pós-deploy usam `GET /up` (sem auth, sem sec
 
 ### D3 — Secrets e providers
 
-Secrets em GitHub Actions + env Dokploy: `APP_KEY`, DB, `MAIL_MAILER=resend` / `RESEND_API_KEY`, `FILESYSTEM_DISK=r2` / `R2_*`, tokens Dokploy/GHCR. Nunca embeds em layer. Local continua `MAIL_MAILER=log` e disco `public`.
+GitHub Actions guarda só orquestração: `DOKPLOY_URL`, API key, compose IDs, URLs públicas de smoke. Env Laravel (`APP_KEY`, DB, Resend, R2) vive **somente** no Dokploy, isolado por ambiente. Nunca embeds em layer. Local continua `MAIL_MAILER=log` e disco `public`.
+
+### D3b — Backup e restore
+
+PostgreSQL staging/produção: backup diário via Dokploy → destino S3-compatible, retenção mínima 14 dias (SPEC §16.3). Restore documentado e testado em staging antes da primeira promoção a produção.
 
 ### D4 — Compose local com app
 
@@ -74,26 +82,32 @@ Alinhar README, CI (`setup-php` 8.4) e `Dockerfile` `ARG PHP_VERSION=8.4`. Mante
 
 ### D8 — Rollback
 
-Rollback = apontar Compose staging para tag SHA anterior no GHCR e `compose.deploy`/`redeploy`. Falha de healthcheck impede promoção. Sem rebuild.
+Rollback = mover alias do ambiente (`:staging` ou `:production`) para tag SHA anterior no GHCR e `compose.deploy`. Falha de healthcheck/smoke impede promoção. Sem rebuild.
+
+### D9 — Trusted proxies atrás do Traefik
+
+`bootstrap/app.php` confia em proxies (`trustProxies(at: '*')`) para honrar `X-Forwarded-*` do Traefik/Dokploy. Staging/produção usam `SESSION_SECURE_COOKIE=true` com HTTPS.
 
 ## Risks / Trade-offs
 
 - **[GHCR privado + pull na VPS]** → configurar registry no Dokploy com PAT `read:packages`; documentar checklist.
-- **[Migrate one-shot falha]** → deploy não promove web; manter migrations backward-compatible.
+- **[Migrate one-shot falha]** → web/queue/scheduler dependem de migrate exit 0; manter migrations backward-compatible.
-- **[Cobertura 80% com Domain quase vazio]** → medir só namespaces existentes; baseline sobe conforme Fase 2 adiciona Domain.
+- **[GitHub Free sem required reviewers]** → promoção humana via `workflow_dispatch` + input `PRODUCTION`; Pro opcional.
-- **[npm audit ruido]** → `--omit=dev` + allowlist documentada se necessário; sem silenciar sem justificativa.
+- **[Cobertura 80% com Domain quase vazio]** → medir só namespaces existentes; baseline sobe conforme Fase 2 adiciona Domain (pendente).
-- **[E-mail verification em staging]** → seed/users de staging com `email_verified_at`; Resend para reset real quando configurado.
+- **[npm audit ruido]** → `--omit=dev` + allowlist documentada se necessário (pendente).
-- **[Compose local rebuild lento]** → documentar serve opcional; CI permanece fonte FrankenPHP.
+- **[E-mail verification em staging]** → seed/users de staging com `email_verified_at`; Resend para reset real quando configurado (pendente).
+- **[Compose local rebuild lento]** → documentar serve opcional; CI permanece fonte FrankenPHP (pendente).
 
 ## Migration Plan
 
-1. Implementar auth/coverage/npm/strict_types/docs/Compose local; CI verde.
+1. Fatia deploy: Compose deploy, workflows, smoke, trusted proxies, docs Dokploy/backup/rollback; CI verde.
-2. Criar projeto Dokploy + Postgres + Compose app; registrar GHCR.
+2. Criar projeto Dokploy + Postgres (staging + produção) + Compose apps; registrar GHCR.
-3. Adicionar workflow deploy; primeiro push de imagem SHA; smoke `/up` + home + login.
+3. Primeiro push de imagem SHA → staging; smoke `/up` + home + login; testar rollback e backup/restore.
-4. Atualizar SPEC §18 Fase 0 apenas com itens comprovados; evidência no PR.
+4. Promoção manual para produção após domínio/TLS/`APP_URL` confirmados.
-5. Rollback: redeploy tag SHA anterior.
+5. Fatias restantes da change (auth/coverage/npm/Compose local/PHP docs) em PRs seguintes.
+6. Atualizar SPEC §18 Fase 0 apenas com itens comprovados; evidência no PR.
 
 ## Open Questions
 
-- Domínio público exato do staging (DNS) — preencher na implementação com valor do operador.
+- Domínio público exato do staging/produção (DNS) — preencher na implementação com valor do operador.
-- Se Dokploy Compose API exigir `compose.saveEnvironment` para `IMAGE_TAG` a cada deploy: confirmar payload na primeira fatia de integração.
+- Se Dokploy Compose API exigir `compose.update` env para `IMAGE_TAG` a cada deploy: preferir aliases `:staging`/`:production` estáveis no Compose Dokploy para evitar rewrite de env.

openspec/changes/complete-foundation-parity/proposal.md

@@ -6,17 +6,20 @@ Fases 0 e 1 estão implementadas e mescladas, mas o critério de saída da Fase
 
 - Implantar staging na VPS própria via Dokploy (Docker Compose): imagem única por SHA no GHCR, serviços `web`/`queue`/`scheduler`/migrate, PostgreSQL gerenciado, healthcheck `/up`, smoke pós-deploy e rollback por tag SHA anterior.
 - Adicionar workflow GitHub Actions de deploy em `main` após CI verde (build → push GHCR → acionar API Dokploy).
-- Estender `docker-compose.yml` local com serviço de aplicação FrankenPHP (além do PostgreSQL).
+- Adicionar promoção manual de produção: mesma digest SHA já publicada, alias `:production`, sem rebuild (`workflow_dispatch` + confirmação explícita).
-- Fixar PHP **8.4** como versão canônica em Docker, CI e documentação.
+- Documentar backup PostgreSQL diário (retenção ≥14d), restore e runbook operacional Dokploy/GHCR.
-- Incluir `npm audit` e cobertura mínima de 80% para `Domain` e `Application` nos gates de qualidade (SPEC §12.6, §13.7, §13.9).
+- Estender `docker-compose.yml` local com serviço de aplicação FrankenPHP (além do PostgreSQL) — **ainda pendente** nesta fatia de deploy.
-- Exigir e-mail verificado no painel Filament e entregar reset de senha seguro (SPEC §12.1; ADM-01).
+- Fixar PHP **8.4** como versão canônica em Docker, CI e documentação — **ainda pendente**.
-- Corrigir `declare(strict_types=1);` em PHP próprio que ainda falte e cobrir regressões.
+- Incluir `npm audit` e cobertura mínima de 80% para `Domain` e `Application` nos gates de qualidade (SPEC §12.6, §13.7, §13.9) — **ainda pendente**.
+- Exigir e-mail verificado no painel Filament e entregar reset de senha seguro (SPEC §12.1; ADM-01) — **ainda pendente**.
+- Corrigir `declare(strict_types=1);` em PHP próprio que ainda falte e cobrir regressões — **ainda pendente**.
 
 ## Non-Goals
 
 Conforme [SPEC.md §4.2](../../SPEC.md):
 
-- Produção com promoção humana, portal do cliente, multi-tenancy, Redis, FrankenPHP worker mode.
+- Deploy automático direto em produção (produção exige promoção humana da mesma imagem).
+- Portal do cliente, multi-tenancy, Redis, FrankenPHP worker mode.
 - Fase 2 (WEB-05 briefing, CRM, E2E-01/E2E-02) — change futura `build-leads-crm` após esta fechar.
 - Provisionamento genérico de VPS/Dokploy para clientes finais.
 - Templates de e-mail de lead, auditoria completa (ADM-02), documentos privados.
@@ -25,19 +28,20 @@ Conforme [SPEC.md §4.2](../../SPEC.md):
 
 ### New Capabilities
 
-- `staging-deployment`: deploy automático de staging na VPS via Dokploy com imagem imutável por SHA, processos web/queue/scheduler, migração, healthcheck, smoke e rollback (SPEC §14.3, §15.2, §18 Fase 0).
+- `staging-deployment`: deploy automático de staging na VPS via Dokploy com imagem imutável por SHA, processos web/queue/scheduler, migração, healthcheck, smoke e rollback; promoção manual da mesma digest para produção (SPEC §14.3, §15.2, §16.3, §18 Fase 0).
 
 ### Modified Capabilities
 
-- `container-runtime`: Compose local com app FrankenPHP; PHP 8.4 canônico; alinhamento da mesma imagem a processos de staging.
+- `container-runtime`: Compose local com app FrankenPHP; PHP 8.4 canônico; alinhamento da mesma imagem a processos de staging/produção.
 - `quality-gates`: `npm audit` no gate; cobertura mínima 80% para Domain/Application; job de deploy staging após CI.
 - `health-check`: healthcheck e smoke pós-deploy de staging usam `/up` sem autenticação.
 - `internal-authentication`: e-mail verificado obrigatório para acesso ao painel; reset de senha seguro disponível (SPEC §12.1, ADM-01).
 
 ## Impact
 
-- **Cria**: `docker-compose` de staging (ou extensão), workflow `.github/workflows/deploy-staging.yml`, docs operacionais de Dokploy/GHCR, testes de auth verification/reset e cobertura.
+- **Cria (fatia deploy)**: `docker-compose.deploy.yml`, workflows `deploy-staging.yml` / `promote-production.yml`, scripts smoke/Dokploy, docs operacionais Dokploy/GHCR/backup/rollback.
-- **Altera**: `docker-compose.yml`, `Dockerfile`/docs PHP, `composer.json`/`package.json` scripts, `.github/workflows/ci.yml`, `User`/`AdminPanelProvider`, README, `.env.example`.
+- **Altera (fatia deploy)**: `bootstrap/app.php` (trusted proxies), `.env.example`, README.
-- **Infra (manual)**: projeto Dokploy na VPS, registry GHCR, secrets (`DOKPLOY_*`, `GHCR_*`, DB, `APP_KEY`, Resend/R2).
+- **Ainda pendente nesta change**: Compose local FrankenPHP, PHP 8.4 docs, npm audit/coverage, auth verification/reset, strict_types.
+- **Infra (manual)**: projeto Dokploy na VPS (duas stacks), registry GHCR, secrets (`DOKPLOY_*`, DB, `APP_KEY`, Resend/R2), backup S3.
 - **Depende de**: specs já arquivadas (`container-runtime`, `quality-gates`, `health-check`, `internal-authentication`, `transactional-email`, `object-storage`).
 - **Risco**: secrets e registry privados; mitigações: tokens com escopo mínimo, imagem por SHA, healthcheck antes de promover, rollback por tag anterior.

openspec/changes/complete-foundation-parity/specs/staging-deployment/spec.md

@@ -55,3 +55,23 @@ Rollback SHALL redeploy a previously published SHA-tagged image without rebuildi
 - **WHEN** the operator points staging Compose at a previous SHA tag and redeploys
 - **THEN** web, queue, and scheduler MUST run that previous image
 - **AND** no source rebuild MUST be required
+
+### Requirement: Production promotion reuses the same immutable digest
+
+Production SHALL be promoted from an already-published SHA-tagged image without rebuilding from source. Promotion MUST require explicit human action (SPEC §14.3).
+
+#### Scenario: Operator promotes a staging-approved SHA to production
+
+- **WHEN** the operator confirms promotion of commit SHA `abc123`
+- **THEN** production web, queue, and scheduler MUST run the same digest previously published as `ghcr.io/<owner>/<repo>:abc123`
+- **AND** MUST NOT rebuild from source for that promotion
+
+### Requirement: Database backups exist before production cutover
+
+Staging and production PostgreSQL services SHALL have automated daily backups with retention of at least 14 days, and a documented restore procedure MUST be verified on staging before the first production promotion (SPEC §16.3).
+
+#### Scenario: Staging restore is proven before production promotion
+
+- **WHEN** the operator prepares the first production promotion
+- **THEN** a restore from a staging backup MUST have been documented and successfully tested
+- **AND** production MUST have daily backup configured with retention of at least 14 days

openspec/changes/complete-foundation-parity/tasks.md

@@ -19,23 +19,25 @@
 - [ ] 3.3 Add/adjust unit tests if current Domain/Application coverage is below threshold
 - [ ] 3.4 Verify CI `static` and `unit` fail appropriately on intentional audit/coverage breakage in a branch experiment or equivalent proof
 
-## 4. Staging Compose and Dokploy prep
+## 4. Staging/production Compose and Dokploy prep
 
-- [ ] 4.1 Add versioned staging Compose template (web, queue, scheduler, migrate one-shot) parameterized by `APP_IMAGE`/`IMAGE_TAG`
+- [x] 4.1 Add versioned Compose template (`docker-compose.deploy.yml`: web, queue, scheduler, migrate one-shot) parameterized by `APP_IMAGE`/`IMAGE_TAG` for staging and production stacks
-- [ ] 4.2 Document Dokploy project setup: GHCR registry credentials, Postgres service, Compose import, required env vars (APP_KEY, DB, Resend, R2)
+- [x] 4.2 Document Dokploy project setup: GHCR registry credentials, Postgres per environment, Compose import, required env vars (APP_KEY, DB, Resend, R2), trusted proxies/session cookies
-- [ ] 4.3 Document rollback procedure: redeploy previous SHA tag without rebuild
+- [x] 4.3 Document rollback procedure: move environment alias to previous SHA and redeploy without rebuild
+- [x] 4.4 Document PostgreSQL daily backup (≥14d retention), restore procedure, and test restore on staging before first production promotion
 
 ## 5. Deploy workflow and smoke
 
-- [ ] 5.1 Create `.github/workflows/deploy-staging.yml` gated on successful CI on `main`: build image, push `ghcr.io/...:<sha>` + `:staging`, trigger Dokploy `compose.deploy`
+- [x] 5.1 Create `.github/workflows/deploy-staging.yml` gated on successful CI on `main`: build image, push `ghcr.io/...:<sha>` + `:staging`, trigger Dokploy `compose.deploy`
-- [ ] 5.2 Wire migrate-before-serve (Compose migrate service or Dokploy deploy command) and healthcheck on `/up`
+- [x] 5.2 Create `.github/workflows/promote-production.yml` (`workflow_dispatch` + confirmation): retag same digest as `:production`, deploy production stack, smoke
-- [ ] 5.3 Add post-deploy smoke script/job for `/up`, `/`, `/admin/login` returning 200
+- [x] 5.3 Wire migrate-before-serve (Compose migrate service) and healthcheck on `/up`
-- [ ] 5.4 Store secrets only in GitHub/Dokploy; ensure no secrets in image layers (reuse container CI check)
+- [x] 5.4 Add post-deploy smoke script/job for `/up`, `/`, `/admin/login` returning 200
+- [x] 5.5 Store orchestration secrets only in GitHub; Laravel/DB/R2/Resend only in Dokploy; ensure no secrets in image layers
 
 ## 6. Phase 0 exit evidence
 
 - [ ] 6.1 Perform first successful staging deploy of a `main` SHA and capture evidence (workflow URL, smoke output)
-- [ ] 6.2 Verify rollback to previous SHA works once
+- [ ] 6.2 Verify rollback to previous SHA works once on staging
 - [ ] 6.3 Update `SPEC.md` §18 Fase 0 checkboxes only for items with evidence; note remaining deferred items if any
 - [ ] 6.4 Run full `composer quality` and confirm all five CI jobs + staging deploy path green
-- [ ] 6.5 Report in SPEC §24 format and mark this change ready to archive after merge
+- [ ] 6.5 Report in SPEC §24 format; archive this change only after remaining parity tasks (1–3) also complete

openspec/changes/enhance-public-motion/.openspec.yaml

@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-08-06

openspec/changes/enhance-public-motion/design.md

@@ -0,0 +1,51 @@
+## Context
+
+O site público usa Blade/Tailwind e já contém um runtime pequeno em `resources/js/motion.js`: abertura focal da home, `page-open`, reveals com `IntersectionObserver` e progresso do índice. A cobertura e a marcação são parciais, os reveals não têm grupos/direções explícitas e a matriz browser se concentra nas quatro páginas visuais originais. A mudança cruza templates, CSS, JavaScript e testes, mas não envolve estado de aplicação, dados ou dependências.
+
+## Goals / Non-Goals
+
+**Goals:**
+
+- Tornar a coreografia Heritage Editorial consistente em toda página pública visual.
+- Manter texto legível durante toda entrada, animando somente `transform` e recorte de mídia.
+- Garantir enhancement progressivo: estado final imediato sem JavaScript, observer ou com movimento reduzido.
+- Preservar interação, foco, validação e ausência de overflow em desktop/mobile.
+- Cobrir marcação, comportamento real, acessibilidade, console e capturas determinísticas.
+
+**Non-Goals:**
+
+- Não criar transições de rota, parallax, animação contínua ou repetição ao voltar no scroll.
+- Não mudar copy, dados de clientes, estrutura de layout, CMS, controllers, banco, APIs ou Filament.
+- Não adicionar biblioteca de animação nem itens de SPEC.md §4.2.
+
+## Decisions
+
+1. **Contrato declarativo em atributos `data-*`.** Templates usarão `data-motion="page-open"`, `data-motion-beat`, `data-reveal-group`, `data-reveal` e `data-reveal-from="up|left|right"`. CSS define o estado visual e JS apenas ativa classes. Alternativa rejeitada: acoplar seletores a classes de layout, por tornar a coreografia frágil a ajustes visuais.
+
+2. **Enhancement opt-in pelo elemento raiz.** O HTML inicial permanece no estado final; o runtime adiciona `html[data-motion="enhance"]` somente quando movimento é permitido e os recursos necessários existem. Sem JS, sem `IntersectionObserver`, ou em `reduce`, o atributo não é aplicado/removido e todo conteúdo fica final. Alternativa rejeitada: estado inicial oculto no HTML/CSS, pois pode prender conteúdo fora da tela.
+
+3. **Transformação sem fade de texto.** Entradas duram cerca de 500 ms com `cubic-bezier(0.16, 1, 0.3, 1)`, deslocamento vertical de 12 px e lateral de 24 px no desktop/16 px no mobile. Grupos recebem stagger de 90 ms limitado a 270 ms. Mídia pode combinar transform com `clip-path`; texto não usa opacidade. Alternativa rejeitada: fade geral, que reduz contraste durante axe e legibilidade percebida.
+
+4. **Observer de execução única.** Cada reveal intersectado recebe o estado final e é removido do observer. Grupos calculam índice limitado para o delay; depoimentos definem explicitamente `left`/`right` pela coluna, preservando alternância no mobile. Alternativa rejeitada: reanimar em toda rolagem, por criar fadiga e instabilidade.
+
+5. **Feedback separado das entradas.** CTAs, links, navegação e controles recebem transições curtas (100–200 ms) em cor/transform/borda. `:focus-visible` continua prioritário; alertas e mensagens de erro não entram no contrato de motion. Alternativa rejeitada: feedback via JS, desnecessário para estados CSS.
+
+6. **Progresso com coalescência por frame.** Eventos de scroll apenas agendam uma atualização por `requestAnimationFrame`; o cálculo existente é preservado. Alternativa rejeitada: calcular em todo evento, que multiplica leituras/escritas durante scroll.
+
+7. **Testes em camadas.** Feature tests comprovam contratos Blade/CSS/JS e renderização de erros; browser tests comprovam entrada, stagger, direções, reduced motion, fallback, interação, overflow e console. Axe/snapshots passam a incluir sobre, contato, privacidade e 404; demais erros ficam em renderização feature.
+
+## Risks / Trade-offs
+
+- [Conteúdo pisca entre estado final e início do enhancement] → inicializar no primeiro módulo Vite, limitar transformações a distâncias pequenas e nunca ocultar texto.
+- [Transforms laterais causam overflow horizontal] → limitar distância por breakpoint, manter recorte no contêiner público e testar `scrollWidth` em ambos viewports.
+- [Snapshots ficam instáveis] → continuar capturando com `reducedMotion: reduce` e transições desabilitadas.
+- [Muitos observers/estilos inline] → usar um único observer, custom property de índice limitada e `unobserve` imediato.
+- [Páginas de erro não carregam o runtime em todos os contextos] → o estado final é o baseline seguro; feature tests cobrem os cinco templates.
+
+## Migration Plan
+
+Publicar CSS, JS e templates no mesmo bundle/commit; não há migração de dados. Rollback consiste em reverter esses assets e atributos, sem compatibilidade de schema ou limpeza operacional.
+
+## Open Questions
+
+Nenhuma; direção, alternância mobile, execução única e limites de escopo foram aprovados no plano.

openspec/changes/enhance-public-motion/proposal.md

@@ -0,0 +1,31 @@
+## Why
+
+O site público já possui uma abertura focal na home, mas o restante da experiência ainda muda de estado de forma desigual entre páginas e seções. WEB-01, WEB-07 e os requisitos transversais de acessibilidade pedem uma coreografia editorial consistente, progressiva e dispensável, sem ocultar conteúdo nem comprometer interação, performance ou movimento reduzido.
+
+## What Changes
+
+- Evoluir o contrato de motion do site público com abertura de página, sequência editorial inicial e reveals direcionais executados uma única vez.
+- Aplicar a coreografia à home, serviços, portfólio, detalhe, sobre, contato, privacidade e páginas de erro 404/419/429/500/503.
+- Alternar depoimentos entre esquerda e direita, filtrando citações vazias antes de renderizar a sequência.
+- Adicionar feedback curto e não bloqueante a links, CTAs, navegação e controles de formulário, preservando foco e mensagens de validação.
+- Garantir estado final imediato sem JavaScript, sem `IntersectionObserver` e com `prefers-reduced-motion: reduce`.
+- Limitar o progresso/índice da home a uma atualização por frame e ampliar testes de marcação, browser, acessibilidade, console e regressão visual.
+- Não objetivos: não criar transições entre rotas, alterar conteúdo ou layout estrutural, adicionar biblioteca de animação, modificar CMS/API/banco/Filament, nem introduzir itens fora do MVP listados em SPEC.md §4.2.
+
+## Capabilities
+
+### New Capabilities
+
+- `public-site-motion`: Coreografia progressiva, direções, timings, execução única, microfeedback, performance e fallbacks do motion público.
+
+### Modified Capabilities
+
+- `design-tokens`: Especificar tokens compartilhados de duração, stagger, distância e easing para motion editorial.
+- `public-site-pages`: Cobrir todas as páginas públicas visuais e templates de erro com o contrato compartilhado de abertura e reveal.
+- `testimonials`: Filtrar citações vazias e alternar explicitamente a direção de entrada dos depoimentos renderizados.
+- `visual-regression`: Ampliar a matriz visual para sobre, contato, privacidade e 404, mantendo capturas determinísticas sem animação.
+- `web-accessibility`: Ampliar axe/console e validar conteúdo imediatamente utilizável com movimento reduzido ou enhancement indisponível.
+
+## Impact
+
+Afeta somente templates Blade públicos, `resources/js/motion.js`, tokens/regras CSS e testes Pest/Pest Browser. Não altera APIs, banco, controllers, CMS, dependências, endpoints técnicos (`sitemap.xml`, `robots.txt`) ou Filament.

openspec/changes/enhance-public-motion/specs/design-tokens/spec.md

@@ -0,0 +1,9 @@
+## ADDED Requirements
+
+### Requirement: Editorial motion tokens are centralized
+
+The system SHALL define shared public motion tokens for an approximately 500 ms entrance, short interaction feedback, exponential ease-out, 90 ms stagger capped at 270 ms, 12 px vertical distance, and 24 px desktop / 16 px mobile lateral distance. Public motion CSS MUST consume these tokens instead of duplicating arbitrary values.
+
+#### Scenario: Motion runtime uses shared values
+- **WHEN** page openings, reveals, or interaction feedback are styled
+- **THEN** duration, easing, stagger, and distance MUST be derived from centralized tokens

openspec/changes/enhance-public-motion/specs/public-site-motion/spec.md

@@ -0,0 +1,74 @@
+## ADDED Requirements
+
+### Requirement: Public pages use shared progressive motion choreography
+
+The public site SHALL expose a declarative motion contract using `data-motion="page-open"`, `data-motion-beat`, `data-reveal-group`, `data-reveal`, and `data-reveal-from="up|left|right"`. Home, services, portfolio index/detail, about, contact, privacy, and branded 404/419/429/500/503 pages MUST use the contract without introducing route transitions.
+
+#### Scenario: Visual public route exposes motion hooks
+- **WHEN** a visitor loads any visual public route or branded error page
+- **THEN** the rendered page MUST expose a page opening hook and appropriate reveal hooks
+
+#### Scenario: Technical endpoints remain outside motion
+- **WHEN** a visitor requests `sitemap.xml` or `robots.txt`
+- **THEN** the response MUST NOT depend on the public motion runtime
+
+### Requirement: Editorial entrance timing and direction are consistent
+
+Entrances SHALL use shared tokens for an approximately 500 ms duration, 90 ms stagger capped at 270 ms, 12 px vertical distance, and 24 px desktop / 16 px mobile lateral distance. Text MUST remain fully visible; motion MUST use transforms and MAY use media clipping without opacity fades for text.
+
+#### Scenario: Reveal group computes capped stagger
+- **WHEN** more than four reveal items are rendered in one group
+- **THEN** the applied delay MUST NOT exceed 270 ms
+
+#### Scenario: Text enters without opacity fade
+- **WHEN** page opening or scroll reveal motion runs
+- **THEN** text MUST remain visible throughout the transition
+
+### Requirement: Reveals execute once without blocking interaction
+
+Each scroll reveal SHALL activate once, reach its final state, and be removed from observation. Visitors MUST be able to activate links and form controls while entrance motion is running.
+
+#### Scenario: Revealed content leaves observer
+- **WHEN** a reveal target intersects the configured viewport threshold
+- **THEN** it MUST receive the final state and be unobserved
+- **AND** scrolling away and back MUST NOT replay the reveal
+
+#### Scenario: CTA remains interactive during entrance
+- **WHEN** a visitor activates a CTA while its entrance is in progress
+- **THEN** navigation MUST proceed without waiting for animation completion
+
+### Requirement: Motion enhancement has immediate safe fallbacks
+
+Without JavaScript, without `IntersectionObserver`, or when `prefers-reduced-motion: reduce` is active, the site SHALL render every motion target immediately in its final usable state. Non-essential animation and transition MUST NOT run under reduced motion.
+
+#### Scenario: JavaScript is unavailable
+- **WHEN** a public page renders without executing JavaScript
+- **THEN** all content MUST be visible and usable in its final state
+
+#### Scenario: IntersectionObserver is unavailable
+- **WHEN** JavaScript runs but `IntersectionObserver` is not supported
+- **THEN** all reveal targets MUST remain in their final state
+
+#### Scenario: Reduced motion is preferred
+- **WHEN** the browser reports `prefers-reduced-motion: reduce`
+- **THEN** page openings, reveals, media clips, and non-essential feedback transitions MUST NOT run
+
+### Requirement: Public interaction feedback is short and accessible
+
+CTAs, links, navigation, and form controls SHALL provide short feedback using shared tokens while preserving visible `:focus-visible` indication. Alerts and validation messages MUST NOT be animated by this contract.
+
+#### Scenario: Keyboard focus remains visible
+- **WHEN** a visitor focuses an interactive element with the keyboard
+- **THEN** its focus indicator MUST remain visible and MUST NOT be displaced by motion feedback
+
+#### Scenario: Validation message appears without motion
+- **WHEN** server validation renders an error message
+- **THEN** the message MUST appear in its final position without entrance animation
+
+### Requirement: Home progress updates at most once per animation frame
+
+Scroll-driven chapter index and progress updates on the home SHALL be coalesced through `requestAnimationFrame`, with at most one pending update per frame.
+
+#### Scenario: Multiple scroll events occur in one frame
+- **WHEN** multiple scroll events fire before the next animation frame
+- **THEN** the home progress calculation MUST execute only once for that frame

openspec/changes/enhance-public-motion/specs/public-site-pages/spec.md

@@ -0,0 +1,14 @@
+## ADDED Requirements
+
+### Requirement: Visual public and error pages expose the shared motion contract
+
+The system SHALL apply the shared progressive opening and reveal contract to home, services, portfolio index/detail, about, contact, privacy, and branded 404/419/429/500/503 pages. The contract MUST NOT change page copy, content ordering, route behavior, or structural layout.
+
+#### Scenario: Institutional page uses shared opening
+- **WHEN** a visitor loads `/sobre`, `/contato`, or `/privacidade`
+- **THEN** the page MUST expose the shared page opening hook and section reveal hooks
+
+#### Scenario: Error page remains branded and progressively enhanced
+- **WHEN** Laravel renders a branded 404, 419, 429, 500, or 503 response
+- **THEN** the page MUST expose the shared opening hook
+- **AND** all error guidance and navigation MUST remain immediately usable without enhancement

openspec/changes/enhance-public-motion/specs/testimonials/spec.md

@@ -0,0 +1,43 @@
+## MODIFIED Requirements
+
+### Requirement: Testimonials are managed with publication control
+
+The system SHALL allow admins to manage testimonials (SPEC WEB-04) with quote text (including multi-paragraph content), author name, optional context (event type and/or date), optional photo with alt text, sort order, featured flag, and `published_at`. Public rendering MUST preserve paragraph breaks from the stored quote, MUST omit blank/whitespace-only quotes before creating the rendered sequence, and MUST assign alternating `left`/`right` reveal directions according to the remaining rendered column order at desktop and mobile viewports. Testimonials sourced from real clients MUST NOT be published to production without authorization; development seeds MAY include the authorized-pending real quotes marked for review.
+
+#### Scenario: Unpublished testimonial is excluded
+
+- **WHEN** a testimonial has `published_at` null
+- **THEN** the `published()` scope MUST exclude it
+
+#### Scenario: Published testimonial is queryable
+
+- **WHEN** an admin sets `published_at` with required quote and author name
+- **THEN** the testimonial MUST be included in the `published()` scope
+
+#### Scenario: Assistant cannot manage testimonials
+
+- **WHEN** an assistant attempts to access the testimonials Resource
+- **THEN** access MUST be denied with HTTP 403
+
+#### Scenario: Featured testimonials are filterable
+
+- **WHEN** content is queried with featured filter
+- **THEN** records with `is_featured` true MUST be retrievable independently of sort order
+
+#### Scenario: Multi-paragraph quotes render as paragraphs
+
+- **GIVEN** a published testimonial whose quote contains blank-line separated paragraphs
+- **WHEN** the home testimonials section is rendered
+- **THEN** each paragraph MUST appear as distinct block text rather than a single collapsed line
+
+#### Scenario: Blank quotes do not affect alternation
+
+- **GIVEN** the published testimonial collection contains a blank quote between two non-blank quotes
+- **WHEN** the home testimonials section is rendered
+- **THEN** the blank testimonial MUST be omitted
+- **AND** the two rendered testimonials MUST receive alternating `left` and `right` directions based on their rendered order
+
+#### Scenario: Direction alternation remains on mobile
+
+- **WHEN** testimonials are viewed at a mobile viewport
+- **THEN** their explicit `left` and `right` directions MUST be preserved with the reduced mobile distance

openspec/changes/enhance-public-motion/specs/visual-regression/spec.md

@@ -0,0 +1,26 @@
+## MODIFIED Requirements
+
+### Requirement: Public screens have desktop and mobile visual baselines
+
+The system SHALL keep versioned screenshot baselines for the public screens available in this phase (SPEC §13.5): Home, Serviços, Portfólio, Detalhe do portfólio, Sobre, Contato, Privacidade and branded 404, at 1440×1000 desktop and 390×844 mobile, under the Heritage Editorial identity. A rendering change that alters those screens MUST fail the browser suite until the diff is reviewed and baselines are explicitly updated.
+
+#### Scenario: Unintended visual change fails the suite
+
+- **GIVEN** approved baselines exist
+- **WHEN** a code change alters the rendering of a covered screen
+- **THEN** the visual assertion MUST fail and report the diff
+
+#### Scenario: Both viewports are covered
+
+- **WHEN** the visual suite runs
+- **THEN** each covered screen MUST be asserted at 1440×1000 and 390×844
+
+#### Scenario: Heritage Editorial identity is captured
+
+- **WHEN** approved baselines for the home are reviewed after this change
+- **THEN** they MUST reflect EB Garamond typography, olive/paper palette and sharp-edged editorial layout rather than the previous gold/rounded placeholder look
+
+#### Scenario: Motion does not destabilize new baselines
+
+- **WHEN** Sobre, Contato, Privacidade, or 404 is captured
+- **THEN** the browser MUST use the final reduced-motion state before asserting the screenshot

openspec/changes/enhance-public-motion/specs/web-accessibility/spec.md

@@ -0,0 +1,51 @@
+## MODIFIED Requirements
+
+### Requirement: Public routes have no critical or serious accessibility issues
+
+The system SHALL run automated accessibility checks on the public routes covered by the browser suite (SPEC §6.5, §13.8) after the Heritage Editorial motion enhancement. A critical or serious issue MUST fail the suite.
+
+#### Scenario: Critical issue blocks the suite
+
+- **WHEN** the automated accessibility check reports a critical or serious issue on a covered route
+- **THEN** the browser suite MUST fail and report the offending rule and selector
+
+#### Scenario: Covered routes are checked
+
+- **WHEN** the accessibility suite runs
+- **THEN** home, services listing, portfolio listing, case detail, about, contact, privacy and branded 404 MUST each be checked
+
+### Requirement: Reduced motion preference is honored
+
+The system SHALL suppress non-essential animation and transition when the user agent reports `prefers-reduced-motion: reduce`, including page openings, editorial reveals, image hover scales, interaction feedback and menu transitions. All affected content MUST render in its final visible and interactive state.
+
+#### Scenario: Reduced motion disables transitions
+
+- **GIVEN** the browser reports `prefers-reduced-motion: reduce`
+- **WHEN** a public page is loaded
+- **THEN** decorative transitions and animations MUST NOT run
+- **AND** every motion target MUST be in its final visible and interactive state
+
+### Requirement: Public pages emit no console errors
+
+Covered public routes SHALL load without JavaScript console errors in a real browser (SPEC §13.8, §19), including home, services listing, portfolio listing, case detail, about, contact, privacy, branded 404, and pages that load the mobile navigation or motion runtime.
+
+#### Scenario: Console stays clean on covered routes
+
+- **WHEN** a covered public route is loaded in the browser suite
+- **THEN** the console MUST contain no error-level messages
+
+## ADDED Requirements
+
+### Requirement: Motion enhancement failure does not hide or disable content
+
+The public site SHALL remain readable, keyboard-operable, and interactive when JavaScript is disabled or `IntersectionObserver` is unavailable. Motion targets MUST default to their final state without relying on timeout recovery.
+
+#### Scenario: JavaScript disabled keeps public page usable
+
+- **WHEN** a visitor loads a public page with JavaScript disabled
+- **THEN** headings, copy, navigation, CTAs, and form controls MUST be visible and operable
+
+#### Scenario: Observer unavailable keeps reveals final
+
+- **WHEN** the motion runtime executes without `IntersectionObserver`
+- **THEN** reveal targets MUST remain in the final state

openspec/changes/enhance-public-motion/tasks.md

@@ -0,0 +1,24 @@
+## 1. Motion contract and runtime
+
+- [x] 1.1 Extend feature tests first for motion tokens, declarative hooks, no-opacity text, safe fallbacks, one-shot observer, capped stagger and requestAnimationFrame coalescing
+- [x] 1.2 Add centralized motion tokens and CSS states for page openings, grouped directional reveals, media clips and accessible interaction feedback
+- [x] 1.3 Refactor `resources/js/motion.js` to enhance only when supported, initialize page beats/groups, unobserve revealed targets and coalesce progress updates per frame
+
+## 2. Public template coverage
+
+- [x] 2.1 Add failing markup coverage for home, services, portfolio index/detail, about, contact, privacy and branded 404/419/429/500/503 pages
+- [x] 2.2 Apply page-open, beat, reveal-group and directional reveal hooks across all visual public templates without changing content or layout structure
+- [x] 2.3 Add failing testimonial coverage, filter blank quotes before the rendered sequence and alternate explicit left/right directions on desktop and mobile
+
+## 3. Browser and accessibility coverage
+
+- [x] 3.1 Add browser tests for real opening/reveal state, 90 ms capped stagger, one-shot observation and interaction during motion
+- [x] 3.2 Add desktop/mobile tests for directional distance, reduced motion final state, no-JS/observer fallback, horizontal overflow and clean console
+- [x] 3.3 Extend axe and console route matrices to about, contact, privacy and branded 404
+- [x] 3.4 Extend deterministic desktop/mobile visual snapshots to about, contact, privacy and branded 404 and review the generated diffs
+
+## 4. Verification and delivery
+
+- [x] 4.1 Run focused feature/browser tests, build, Pint, isolated-cache PHPStan and strict OpenSpec validation
+- [x] 4.2 Run `composer quality` and visually review desktop/mobile with normal and reduced motion
+- [ ] 4.3 Stage only scoped files, commit conventionally, open a PR with screenshots and verification evidence, watch CI to green, merge and remove the worktree

openspec/config.yaml

@@ -2,7 +2,7 @@ schema: spec-driven
 
 context: |
   Fonte de verdade: SPEC.md na raiz. Precedência: instrução do dono do produto > SPEC.md > ADRs > testes > convenções.
-  Produto: plataforma de assessoria de eventos, single-tenant, MVP. UI em pt-BR, timezone America/Fortaleza, BRL.
+  Produto: plataforma de assessoria de eventos, single-tenant, MVP. UI em pt-BR, timezone America/Sao_Paulo, atuação em São Paulo (capital), BRL.
   Stack: Laravel 13, Filament 5 (/admin), Livewire 4 + Blade + Alpine + Tailwind (site público),
   PostgreSQL, FrankenPHP regular mode (sem worker mode), Vite, Pest 4 + Pest Browser, database queue.
   Arquitetura: monólito modular. Interface -> Application (Actions/Queries) -> Domain (Enums/VOs) -> Infrastructure.

openspec/specs/container-runtime/spec.md

@@ -1,7 +1,7 @@
 # container-runtime Specification
 
 ## Purpose
-TBD - created by archiving change setup-foundation. Update Purpose after archive.
+Define the production container image for the application: a reproducible multi-stage FrankenPHP build serving the public directory, run in regular mode as a non-root user, shared by web/queue/scheduler processes, with no secrets in layers and a healthcheck on `/up`.
 ## Requirements
 ### Requirement: Production image uses multi-stage FrankenPHP build
 

openspec/specs/design-tokens/spec.md

@@ -1,7 +1,7 @@
 # design-tokens Specification
 
 ## Purpose
-TBD - created by archiving change setup-foundation. Update Purpose after archive.
+Centralize the public site's design tokens so the interface implements the Heritage Editorial system from DESIGN.md (EB Garamond, 8px rhythm, zero radius, 1120px container, paper/olive/sage/ink palette), honoring reduced motion and WCAG AA contrast without card-shadow hierarchy.
 ## Requirements
 ### Requirement: Design tokens are centralized for the public site
 

openspec/specs/health-check/spec.md

@@ -1,7 +1,7 @@
 # health-check Specification
 
 ## Purpose
-TBD - created by archiving change setup-foundation. Update Purpose after archive.
+Expose a public `GET /up` healthcheck that responds quickly and without authentication, exposes no secrets, and fails when the application cannot boot, so orchestrators and CI can verify availability.
 ## Requirements
 ### Requirement: Public health endpoint responds without authentication
 

openspec/specs/internal-authentication/spec.md

@@ -1,7 +1,7 @@
 # internal-authentication Specification
 
 ## Purpose
-TBD - created by archiving change setup-foundation. Update Purpose after archive.
+Provide session-based authentication for the internal Filament panel at `/admin`, limited to two roles (admin and assistant), with unique emails, password reset without enumeration, inactive users denied, and user management restricted to admins.
 ## Requirements
 ### Requirement: Internal users authenticate via Filament panel
 

package-lock.json

@@ -7,6 +7,7 @@
             "devDependencies": {
                 "@tailwindcss/vite": "^4.0.0",
                 "concurrently": "^9.0.1",
+                "husky": "^9.1.7",
                 "laravel-vite-plugin": "^3.1",
                 "playwright": "^1.62.0",
                 "tailwindcss": "^4.0.0",
@@ -890,6 +891,22 @@
                 "node": ">=8"
             }
         },
+        "node_modules/husky": {
+            "version": "9.1.7",
+            "resolved": "https://registry.npmjs.org/husky/-/husky-9.1.7.tgz",
+            "integrity": "sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA==",
+            "dev": true,
+            "license": "MIT",
+            "bin": {
+                "husky": "bin.js"
+            },
+            "engines": {
+                "node": ">=18"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/typicode"
+            }
+        },
         "node_modules/is-fullwidth-code-point": {
             "version": "3.0.0",
             "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",

package.json

@@ -4,11 +4,13 @@
     "type": "module",
     "scripts": {
         "build": "vite build",
-        "dev": "vite"
+        "dev": "vite",
+        "prepare": "husky"
     },
     "devDependencies": {
         "@tailwindcss/vite": "^4.0.0",
         "concurrently": "^9.0.1",
+        "husky": "^9.1.7",
         "laravel-vite-plugin": "^3.1",
         "playwright": "^1.62.0",
         "tailwindcss": "^4.0.0",

public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect width="64" height="64" fill="#556B2F"/>
+  <text x="32" y="45" font-family="Georgia, 'Times New Roman', serif" font-size="38" font-weight="600" fill="#FBF9F4" text-anchor="middle">A</text>
+</svg>

resources/css/app.css

@@ -18,6 +18,13 @@
     --text-3xl: var(--amare-text-3xl);
     --text-4xl: var(--amare-text-4xl);
 
+    --text-display: clamp(3rem, 7.7vw, 5.875rem);
+    --text-display--line-height: 0.94;
+    --text-display--letter-spacing: -0.01em;
+
+    --text-headline: clamp(2.375rem, 5.2vw, 4rem);
+    --text-headline--line-height: 1.02;
+
     --spacing-1: var(--amare-space-1);
     --spacing-2: var(--amare-space-2);
     --spacing-3: var(--amare-space-3);
@@ -59,6 +66,11 @@
         background-color: var(--amare-color-bg);
         color: var(--amare-color-text);
         font-family: var(--amare-font-serif);
+        overflow-wrap: break-word;
+    }
+
+    [id$='-heading'] {
+        scroll-margin-top: 5.5rem;
     }
 
     a:focus-visible,
@@ -84,11 +96,56 @@
     filter: saturate(0.88) contrast(0.96);
 }
 
+@utility honeypot {
+    position: absolute;
+    left: -9999px;
+    width: 1px;
+    height: 1px;
+    overflow: hidden;
+}
+
 @layer components {
     .main-nav.is-open {
         display: flex;
     }
 
+    .home-chapters {
+        counter-reset: home-chapter -1;
+    }
+
+    .home-chapter {
+        counter-increment: home-chapter;
+    }
+
+    .home-folio {
+        display: flex;
+        align-items: center;
+        gap: 0.5rem;
+        color: var(--amare-color-accent);
+        font-size: var(--amare-text-xs);
+        font-weight: 600;
+        letter-spacing: 0.14em;
+        line-height: 1;
+        text-transform: uppercase;
+    }
+
+    .home-folio--inverse {
+        color: color-mix(in srgb, var(--amare-color-accent-text) 82%, transparent);
+    }
+
+    .home-folio__separator {
+        color: var(--amare-color-sage);
+    }
+
+    .home-folio--inverse .home-folio__separator {
+        color: color-mix(in srgb, var(--amare-color-accent-text) 55%, transparent);
+    }
+
+    .home-folio__number::before {
+        content: counter(home-chapter, decimal-leading-zero);
+        font-variant-numeric: tabular-nums;
+    }
+
     @media (prefers-reduced-motion: no-preference) {
         .main-nav {
             transition: opacity var(--amare-duration-normal) var(--amare-ease-standard);
@@ -98,4 +155,166 @@
     body.menu-open {
         overflow: hidden;
     }
+
+    main {
+        overflow-x: clip;
+    }
+
+    /* Dossiê vivo — content visible by default; enhance only when opted in */
+    [data-chapter-index] {
+        display: none;
+    }
+
+    [data-chapter-progress] {
+        display: none;
+        pointer-events: none;
+    }
+
+    [data-chapter-index] a[aria-current="true"] {
+        color: var(--amare-color-accent-deep);
+    }
+
+    [data-chapter-index] a[aria-current="true"]::before {
+        content: '';
+        position: absolute;
+        left: 0;
+        top: 0.35em;
+        bottom: 0.35em;
+        width: 1px;
+        background: var(--amare-color-accent);
+    }
+
+    [data-chapter-progress] > span {
+        display: block;
+        height: 100%;
+        width: var(--chapter-progress, 0%);
+        background: var(--amare-color-accent);
+        transform-origin: left center;
+    }
+
+    @media (min-width: 1280px) {
+        [data-chapter-index] {
+            display: flex;
+            position: fixed;
+            top: 50%;
+            right: max(1rem, calc((100vw - var(--amare-container-max)) / 2 - 7.5rem));
+            z-index: 30;
+            max-width: 6.5rem;
+            translate: 0 -50%;
+            flex-direction: column;
+            gap: 0.75rem;
+        }
+
+        [data-chapter-index] a {
+            position: relative;
+            display: inline-flex;
+            align-items: center;
+            min-height: 2.75rem;
+            padding-left: 0.75rem;
+            font-size: var(--amare-text-xs);
+            font-weight: 600;
+            letter-spacing: 0.12em;
+            text-transform: uppercase;
+            color: var(--amare-color-muted);
+            text-decoration: none;
+            overflow-wrap: break-word;
+            transition: color var(--amare-duration-fast) var(--amare-ease-standard);
+        }
+
+        [data-chapter-index] a:hover {
+            color: var(--amare-color-accent);
+        }
+    }
+
+    @media (max-width: 1279px) {
+        [data-chapter-progress] {
+            display: block;
+            position: fixed;
+            top: 0;
+            left: 0;
+            z-index: 45;
+            width: 100%;
+            height: 2px;
+            background: transparent;
+        }
+    }
+
+    @media (prefers-reduced-motion: no-preference) {
+        :where(a, button, input, textarea, select) {
+            transition-duration: var(--amare-motion-feedback);
+            transition-property: color, background-color, border-color, transform;
+            transition-timing-function: var(--amare-ease-arrival);
+        }
+
+        :where(a, button:not(:disabled)):active {
+            transform: translateY(1px);
+        }
+
+        /* Transform/clip only — never fade text opacity (axe + WCAG mid-transition). */
+        html[data-motion="enhance"] [data-motion="page-open"]:not(.is-active) [data-motion-beat] {
+            transform: translateY(var(--amare-motion-distance-y));
+        }
+
+        html[data-motion="enhance"] [data-motion="page-open"]:not(.is-active) [data-motion-beat="media"] {
+            clip-path: inset(4% 0 0 0);
+        }
+
+        html[data-motion="enhance"] [data-motion="page-open"].is-active [data-motion-beat] {
+            transform: none;
+            clip-path: inset(0 0 0 0);
+            transition:
+                transform var(--amare-motion-enter) var(--amare-ease-arrival),
+                clip-path var(--amare-motion-enter) var(--amare-ease-arrival);
+            transition-delay: min(
+                calc(var(--motion-index, 0) * var(--amare-motion-stagger)),
+                var(--amare-motion-stagger-cap)
+            );
+        }
+
+        html[data-motion="enhance"] [data-reveal] {
+            --motion-translate-x: 0;
+            --motion-translate-y: var(--amare-motion-distance-y);
+        }
+
+        html[data-motion="enhance"] [data-reveal-from="left"] {
+            --motion-translate-x: calc(-1 * var(--amare-motion-distance-x-mobile));
+            --motion-translate-y: 0;
+        }
+
+        html[data-motion="enhance"] [data-reveal-from="right"] {
+            --motion-translate-x: var(--amare-motion-distance-x-mobile);
+            --motion-translate-y: 0;
+        }
+
+        @media (min-width: 768px) {
+            html[data-motion="enhance"] [data-reveal-from="left"] {
+                --motion-translate-x: calc(-1 * var(--amare-motion-distance-x));
+            }
+
+            html[data-motion="enhance"] [data-reveal-from="right"] {
+                --motion-translate-x: var(--amare-motion-distance-x);
+            }
+        }
+
+        html[data-motion="enhance"] [data-reveal]:not(.is-revealed) {
+            transform: translate3d(var(--motion-translate-x), var(--motion-translate-y), 0);
+        }
+
+        html[data-motion="enhance"] [data-reveal][data-reveal-media]:not(.is-revealed) {
+            clip-path: inset(3% 0 0 0);
+        }
+
+        html[data-motion="enhance"] [data-reveal-group] [data-reveal].is-revealed,
+        html[data-motion="enhance"] [data-reveal].is-revealed {
+            transform: none;
+            clip-path: inset(0 0 0 0);
+            transition:
+                transform var(--amare-motion-enter) var(--amare-ease-arrival),
+                clip-path var(--amare-motion-enter) var(--amare-ease-arrival);
+            transition-delay: min(
+                calc(var(--motion-index, 0) * var(--amare-motion-stagger)),
+                var(--amare-motion-stagger-cap)
+            );
+        }
+    }
 }

resources/css/tokens.css

@@ -56,7 +56,18 @@
     --amare-duration-fast: 150ms;
     --amare-duration-normal: 250ms;
     --amare-duration-slow: 400ms;
+    --amare-duration-focal: 720ms;
     --amare-ease-standard: cubic-bezier(0.4, 0, 0.2, 1);
+    --amare-ease-arrival: cubic-bezier(0.16, 1, 0.3, 1);
+
+    /* Editorial motion */
+    --amare-motion-enter: 500ms;
+    --amare-motion-feedback: 150ms;
+    --amare-motion-stagger: 90ms;
+    --amare-motion-stagger-cap: 270ms;
+    --amare-motion-distance-y: 12px;
+    --amare-motion-distance-x: 24px;
+    --amare-motion-distance-x-mobile: 16px;
 }
 
 @media (prefers-reduced-motion: reduce) {
@@ -64,6 +75,14 @@
         --amare-duration-fast: 0.01ms;
         --amare-duration-normal: 0.01ms;
         --amare-duration-slow: 0.01ms;
+        --amare-duration-focal: 0.01ms;
+        --amare-motion-enter: 0.01ms;
+        --amare-motion-feedback: 0.01ms;
+        --amare-motion-stagger: 0ms;
+        --amare-motion-stagger-cap: 0ms;
+        --amare-motion-distance-y: 0px;
+        --amare-motion-distance-x: 0px;
+        --amare-motion-distance-x-mobile: 0px;
     }
 
     *,

resources/js/app.js

@@ -1,40 +1,108 @@
+import './motion.js';
+
 document.addEventListener('DOMContentLoaded', () => {
     const menuButton = document.querySelector('[data-menu-button]');
     const navigation = document.querySelector('[data-main-nav]');
 
-    if (!menuButton || !navigation) {
+    if (menuButton && navigation) {
-        return;
+        const isDesktop = () => window.matchMedia('(min-width: 768px)').matches;
-    }
+        const isMenuOpen = () => navigation.classList.contains('is-open');
 
-    const setOpen = (isOpen) => {
+        const setOpen = (isOpen, { returnFocus = false } = {}) => {
             navigation.classList.toggle('is-open', isOpen);
-        navigation.classList.toggle('hidden', !isOpen && !window.matchMedia('(min-width: 768px)').matches);
+            navigation.classList.toggle('hidden', !isOpen && !isDesktop());
-        navigation.classList.toggle('flex', isOpen || window.matchMedia('(min-width: 768px)').matches);
+            navigation.classList.toggle('flex', isOpen || isDesktop());
             document.body.classList.toggle('menu-open', isOpen);
             menuButton.setAttribute('aria-expanded', String(isOpen));
             menuButton.setAttribute('aria-label', isOpen ? 'Fechar menu' : 'Abrir menu');
+
+            if (!isOpen && returnFocus) {
+                menuButton.focus();
+            }
         };
 
         menuButton.addEventListener('click', () => {
             const isOpen = menuButton.getAttribute('aria-expanded') !== 'true';
             setOpen(isOpen);
+
+            if (isOpen) {
+                const firstLink = navigation.querySelector('a');
+                if (firstLink) {
+                    firstLink.focus();
+                }
+            }
         });
 
         navigation.querySelectorAll('a').forEach((link) => {
             link.addEventListener('click', () => setOpen(false));
         });
 
+        navigation.addEventListener('keydown', (event) => {
+            if (event.key === 'Escape') {
+                setOpen(false, { returnFocus: true });
+
+                return;
+            }
+
+            if (event.key === 'Tab' && !isDesktop() && isMenuOpen()) {
+                const focusables = navigation.querySelectorAll('a[href], button:not([disabled])');
+
+                if (focusables.length === 0) {
+                    return;
+                }
+
+                const first = focusables[0];
+                const last = focusables[focusables.length - 1];
+
+                if (event.shiftKey && document.activeElement === first) {
+                    event.preventDefault();
+                    last.focus();
+                } else if (!event.shiftKey && document.activeElement === last) {
+                    event.preventDefault();
+                    first.focus();
+                }
+            }
+        });
+
         window.matchMedia('(min-width: 768px)').addEventListener('change', (event) => {
-        if (event.matches) {
             setOpen(false);
+
+            if (event.matches) {
                 navigation.classList.remove('hidden');
                 navigation.classList.add('flex');
-        } else {
+            }
-            navigation.classList.remove('is-open', 'flex');
+        });
-            navigation.classList.add('hidden');
+    }
-            document.body.classList.remove('menu-open');
+
-            menuButton.setAttribute('aria-expanded', 'false');
+    document.querySelectorAll('form[data-contact-form]').forEach((form) => {
-            menuButton.setAttribute('aria-label', 'Abrir menu');
+        const submitButton = form.querySelector('[data-submit-button]');
+
+        const resetSubmitState = () => {
+            form.removeAttribute('aria-busy');
+            form.removeAttribute('aria-disabled');
+
+            if (submitButton) {
+                submitButton.disabled = false;
+                submitButton.textContent = submitButton.dataset.defaultLabel ?? 'Enviar briefing';
+                submitButton.removeAttribute('aria-busy');
+            }
+        };
+
+        form.addEventListener('submit', () => {
+            if (submitButton) {
+                submitButton.dataset.defaultLabel ??= submitButton.textContent.trim();
+                submitButton.textContent = 'Enviando…';
+                submitButton.disabled = true;
+                submitButton.setAttribute('aria-busy', 'true');
+            }
+
+            form.setAttribute('aria-busy', 'true');
+        });
+
+        window.addEventListener('pageshow', (event) => {
+            if (event.persisted) {
+                resetSubmitState();
             }
         });
     });
+});

resources/js/motion.js

@@ -0,0 +1,187 @@
+const MOTION_QUERY = '(prefers-reduced-motion: reduce)';
+
+function prefersReducedMotion() {
+    return window.matchMedia(MOTION_QUERY).matches;
+}
+
+function enableEnhancement() {
+    if (prefersReducedMotion() || typeof IntersectionObserver !== 'function') {
+        document.documentElement.removeAttribute('data-motion');
+        return false;
+    }
+
+    document.documentElement.dataset.motion = 'enhance';
+    return true;
+}
+
+function activatePageOpen(enhance) {
+    document.querySelectorAll('[data-motion="page-open"]').forEach((node) => {
+        if (!enhance) {
+            node.classList.add('is-active');
+            return;
+        }
+
+        requestAnimationFrame(() => {
+            requestAnimationFrame(() => node.classList.add('is-active'));
+        });
+    });
+}
+
+function initializeMotionDelays() {
+    const beatOrder = new Map([
+        ['seal', 0],
+        ['heading', 0],
+        ['title', 1],
+        ['media', 2],
+        ['cta', 3],
+    ]);
+
+    document.querySelectorAll('[data-motion="page-open"]').forEach((page) => {
+        page.querySelectorAll('[data-motion-beat]').forEach((beat, index) => {
+            const namedIndex = beatOrder.get(beat.dataset.motionBeat);
+            beat.style.setProperty('--motion-index', String(Math.min(namedIndex ?? index, 3)));
+        });
+    });
+
+    document.querySelectorAll('[data-reveal-group]').forEach((group) => {
+        const nodes = Array.from(group.querySelectorAll('[data-reveal]'))
+            .filter((node) => node.closest('[data-reveal-group]') === group);
+
+        nodes.forEach((node, index) => {
+            node.style.setProperty('--motion-index', String(Math.min(index, 3)));
+        });
+    });
+}
+
+function observeReveals(enhance) {
+    const nodes = Array.from(document.querySelectorAll('[data-reveal]'));
+    if (nodes.length === 0) {
+        return;
+    }
+
+    if (!enhance || typeof IntersectionObserver !== 'function') {
+        nodes.forEach((node) => node.classList.add('is-revealed'));
+        return;
+    }
+
+    const observer = new IntersectionObserver(
+        (entries) => {
+            entries.forEach((entry) => {
+                if (!entry.isIntersecting) {
+                    return;
+                }
+
+                entry.target.classList.add('is-revealed');
+                observer.unobserve(entry.target);
+            });
+        },
+        {
+            rootMargin: '0px 0px -12% 0px',
+            threshold: 0.2,
+        },
+    );
+
+    nodes.forEach((node) => observer.observe(node));
+}
+
+function setupChapterIndex() {
+    const index = document.querySelector('[data-chapter-index]');
+    const progress = document.querySelector('[data-chapter-progress] span');
+    const chapters = Array.from(document.querySelectorAll('[data-chapter]'));
+
+    if (!index || chapters.length === 0) {
+        return;
+    }
+
+    const links = Array.from(index.querySelectorAll('a[href^="#"]'));
+    let framePending = false;
+
+    const setActive = (id) => {
+        links.forEach((link) => {
+            const isCurrent = link.getAttribute('href') === `#${id}`;
+            if (isCurrent) {
+                link.setAttribute('aria-current', 'true');
+            } else {
+                link.removeAttribute('aria-current');
+            }
+        });
+    };
+
+    const updateProgress = (ratio) => {
+        if (!progress) {
+            return;
+        }
+
+        const clamped = Math.min(1, Math.max(0, ratio));
+        progress.style.setProperty('--chapter-progress', `${(clamped * 100).toFixed(2)}%`);
+    };
+
+    const sync = () => {
+        const marker = window.scrollY + Math.min(window.innerHeight * 0.35, 280);
+        let current = chapters[0];
+
+        chapters.forEach((chapter) => {
+            if (chapter.offsetTop <= marker) {
+                current = chapter;
+            }
+        });
+
+        const heading = current.querySelector('[id$="-heading"]') || document.getElementById(`${current.dataset.chapter}-heading`);
+        const headingId = heading?.id
+            || current.getAttribute('aria-labelledby')
+            || `${current.dataset.chapter}-heading`;
+
+        setActive(headingId);
+
+        const doc = document.documentElement;
+        const max = Math.max(1, doc.scrollHeight - window.innerHeight);
+        updateProgress(window.scrollY / max);
+    };
+
+    const scheduleSync = () => {
+        if (framePending) {
+            return;
+        }
+
+        framePending = true;
+        requestAnimationFrame(() => {
+            framePending = false;
+            sync();
+        });
+    };
+
+    setActive(chapters[0].getAttribute('aria-labelledby') || 'hero-heading');
+    sync();
+
+    window.addEventListener('scroll', scheduleSync, { passive: true });
+    window.addEventListener('resize', scheduleSync);
+}
+
+function bootMotion() {
+    initializeMotionDelays();
+    const enhance = enableEnhancement();
+    activatePageOpen(enhance);
+    observeReveals(enhance);
+    setupChapterIndex();
+
+    window.matchMedia(MOTION_QUERY).addEventListener('change', (event) => {
+        if (event.matches) {
+            document.documentElement.removeAttribute('data-motion');
+            document.querySelectorAll('[data-motion="page-open"]').forEach((node) => {
+                node.classList.add('is-active');
+            });
+            document.querySelectorAll('[data-reveal]').forEach((node) => {
+                node.classList.add('is-revealed');
+            });
+            return;
+        }
+
+        document.documentElement.dataset.motion = 'enhance';
+    });
+}
+
+if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', bootMotion, { once: true });
+} else {
+    bootMotion();
+}

resources/views/components/brand/logo.blade.php

@@ -19,7 +19,6 @@
     $variant = $variant === 'on-dark' ? 'on-dark' : 'on-light';
     $kind = $mark ? 'mark' : 'lockup';
     $staticSrc = asset("brand/{$kind}-{$variant}.webp");
-    $staticFallback = asset("brand/{$kind}-{$variant}.png");
 
     $src = filled($uploadedPath)
         ? \Illuminate\Support\Facades\Storage::disk('public')->url($uploadedPath)
@@ -34,8 +33,4 @@
         'decoding' => 'async',
         'loading' => 'eager',
     ]) }}
-    @if (! filled($uploadedPath))
-        data-brand-fallback="{{ $staticFallback }}"
-    @endif
-    data-brand-variant="{{ $variant }}"
 />

resources/views/components/fonts.blade.php

@@ -6,7 +6,11 @@
 
     $manifestFile = is_file($manifestPath) ? $manifestPath : $hotManifestPath;
     $manifest = is_string($manifestFile) && is_file($manifestFile)
-        ? json_decode((string) file_get_contents($manifestFile), true)
+        ? \Illuminate\Support\Facades\Cache::remember(
+            'fonts-manifest:'.md5($manifestFile.':'.(string) filemtime($manifestFile)),
+            3600,
+            static fn () => json_decode((string) file_get_contents($manifestFile), true) ?: null,
+        )
         : null;
 
     $cssFile = is_array($manifest) ? ($manifest['style']['file'] ?? null) : null;

resources/views/components/home/cases.blade.php

@@ -1,37 +0,0 @@
-@props([
-    'cases',
-])
-
-@if ($cases->isNotEmpty())
-    <section aria-labelledby="cases-heading" class="border-b border-amare-border py-16">
-        <div class="container-amare space-y-8">
-            <div class="max-w-2xl space-y-3">
-                <h2 id="cases-heading" class="text-3xl font-semibold text-amare-text">Casos selecionados</h2>
-                <p class="text-amare-text-muted">Histórias recentes de celebrações conduzidas pela Amare.</p>
-            </div>
-
-            <div class="grid gap-8">
-                @foreach ($cases as $case)
-                    <article class="grid gap-4 border-t border-amare-border pt-6 md:grid-cols-[200px_minmax(0,1fr)]">
-                        @if (filled($case->cover_image_path))
-                            <x-media.image
-                                :path="$case->cover_image_path"
-                                :alt="$case->cover_image_alt ?: $case->title"
-                                sizes="200px"
-                                class="aspect-square w-full object-cover"
-                            />
-                        @endif
-                        <div class="space-y-2">
-                            <h3 class="text-2xl font-semibold text-amare-text">{{ $case->title }}</h3>
-                            <p class="text-sm text-amare-text-muted">{{ $case->event_type }}@if($case->city) · {{ $case->city }}@endif</p>
-                            <p class="text-amare-text-muted">{{ $case->summary }}</p>
-                            <a href="{{ url('/portfolio/'.$case->slug) }}" class="inline-flex text-sm font-semibold text-amare-accent hover:text-amare-accent-hover">
-                                Ver caso
-                            </a>
-                        </div>
-                    </article>
-                @endforeach
-            </div>
-        </div>
-    </section>
-@endif

resources/views/components/home/chapter-index.blade.php

@@ -0,0 +1,15 @@
+@props([
+    'chapters' => [],
+])
+
+@if (count($chapters) > 0)
+    <nav data-chapter-index aria-label="Índice de capítulos">
+        @foreach ($chapters as $chapter)
+            <a href="#{{ $chapter['id'] }}">{{ $chapter['label'] }}</a>
+        @endforeach
+    </nav>
+
+    <div data-chapter-progress aria-hidden="true">
+        <span></span>
+    </div>
+@endif

resources/views/components/home/final-cta.blade.php

@@ -1,20 +1,28 @@
 @props([
     'settings',
+    'editorial' => false,
 ])
 
-<section aria-labelledby="final-cta-heading" class="border-t border-amare-border bg-amare-bg-deep py-20">
+<section aria-labelledby="final-cta-heading" @class([
-    <div class="container-amare space-y-6 text-center">
+    'border-t border-amare-border bg-amare-bg-deep py-20',
+    'home-chapter' => $editorial,
+]) data-chapter="final-cta" data-reveal-group>
+    <div class="container-amare space-y-6 text-center" data-reveal data-reveal-from="up">
+        @if ($editorial)
+            <x-home.folio label="Próximo passo" class="justify-center" />
+        @else
             <p class="text-xs font-semibold uppercase tracking-[0.14em] text-amare-accent">Próximo passo</p>
-        <h2 id="final-cta-heading" class="text-3xl font-medium text-amare-text md:text-4xl">Todo grande encontro começa com uma boa conversa.</h2>
+        @endif
+        <h2 id="final-cta-heading" class="text-headline font-medium text-amare-text">Do casamento ao evento corporativo, tudo começa com uma boa conversa.</h2>
         <p class="mx-auto max-w-2xl text-amare-muted">
             Compartilhe as primeiras informações do seu evento. A Amare retorna para entender o contexto e orientar os próximos passos.
         </p>
         <div>
             <a
                 href="{{ route('contact') }}"
-                class="inline-flex items-center bg-amare-accent px-5 py-3 text-sm font-semibold uppercase tracking-[0.12em] text-amare-accent-text transition-colors duration-(--amare-duration-normal) ease-(--amare-ease-standard) hover:bg-amare-accent-deep"
+                class="inline-flex min-h-11 items-center bg-amare-accent px-5 py-3 text-sm font-semibold uppercase tracking-[0.12em] text-amare-accent-text transition-colors duration-(--amare-duration-normal) ease-(--amare-ease-standard) hover:bg-amare-accent-deep"
             >
-                {{ $settings->hero_cta_label }}
+                {{ $settings->hero_cta_label ?: 'Solicitar proposta' }}
             </a>
         </div>
     </div>

resources/views/components/home/folio.blade.php

@@ -0,0 +1,20 @@
+@props([
+    'label',
+    'tone' => 'default',
+])
+
+@php
+    $tone = $tone === 'inverse' ? 'inverse' : 'default';
+@endphp
+
+<p
+    {{ $attributes->class([
+        'home-folio',
+        'home-folio--inverse' => $tone === 'inverse',
+    ]) }}
+    data-home-folio
+>
+    <span data-home-folio-label>{{ $label }}</span>
+    <span class="home-folio__separator" aria-hidden="true">·</span>
+    <span class="home-folio__number" data-home-folio-number aria-hidden="true"></span>
+</p>

resources/views/components/home/hero.blade.php

@@ -2,36 +2,48 @@
     'settings',
 ])
 
-<section aria-labelledby="hero-heading" class="border-b border-amare-border bg-amare-bg">
+<section
-    <div class="container-amare grid gap-12 py-20 md:grid-cols-[minmax(0,1.1fr)_minmax(0,0.9fr)] md:items-center md:py-28">
+    aria-labelledby="hero-heading"
+    class="home-chapter border-b border-amare-border bg-amare-bg"
+    data-chapter="hero"
+    data-motion="page-open"
+>
+    <div class="container-amare pt-8 md:pt-10">
+        <x-home.folio label="Capa" data-motion-beat="folio" />
+    </div>
+
+    <div class="container-amare grid gap-12 pb-20 pt-10 md:grid-cols-[minmax(0,1.1fr)_minmax(0,0.9fr)] md:items-center md:pb-28 md:pt-14" data-reveal-group>
         <div class="space-y-8">
+            <div data-motion-beat="seal" class="flex items-center gap-4">
+                <x-brand.logo mark variant="on-light" class="h-8 w-auto" alt="" />
                 @if (filled($settings->hero_eyebrow))
                     <p class="text-sm font-medium uppercase tracking-[0.18em] text-amare-accent">{{ $settings->hero_eyebrow }}</p>
                 @endif
+            </div>
 
-            <h1 id="hero-heading" class="max-w-3xl text-4xl font-medium leading-none text-amare-text md:text-5xl">
+            <h1 id="hero-heading" data-motion-beat="title" class="max-w-3xl text-display font-medium text-amare-text">
-                {{ $settings->hero_title }}
+                {{ $settings->hero_title ?: 'Celebrações com propósito' }}
             </h1>
 
             @if (filled($settings->hero_subtitle))
                 <p class="max-w-2xl text-lg text-amare-text-muted">{{ $settings->hero_subtitle }}</p>
             @endif
 
-            <div class="flex flex-wrap items-center gap-4">
+            <div data-motion-beat="cta" class="flex flex-wrap items-center gap-4">
                 <a
                     href="{{ route('contact') }}"
                     data-testid="home-primary-cta"
-                    class="inline-flex items-center bg-amare-accent px-5 py-3 text-sm font-semibold text-amare-accent-text transition-colors duration-(--amare-duration-normal) ease-(--amare-ease-standard) hover:bg-amare-accent-hover"
+                    class="inline-flex min-h-11 items-center bg-amare-accent px-5 py-3 text-sm font-semibold text-amare-accent-text transition-colors duration-(--amare-duration-normal) ease-(--amare-ease-standard) hover:bg-amare-accent-hover"
                 >
-                    {{ $settings->hero_cta_label }}
+                    {{ $settings->hero_cta_label ?: 'Solicitar proposta' }}
                 </a>
 
                 @if (filled($settings->hero_secondary_cta_label))
                     <a
                         href="{{ route('portfolio.index') }}"
-                        class="inline-flex items-center border-b border-amare-accent pb-1 text-sm font-semibold text-amare-accent transition-colors hover:text-amare-accent-deep"
+                        class="inline-flex min-h-11 items-center text-sm font-semibold text-amare-accent transition-colors hover:text-amare-accent-deep"
                     >
-                        {{ $settings->hero_secondary_cta_label }}
+                        <span class="border-b border-amare-accent pb-1">{{ $settings->hero_secondary_cta_label }}</span>
                     </a>
                 @endif
             </div>
@@ -42,11 +54,12 @@
         </div>
 
         @if (filled($settings->default_og_image_path))
-            <div class="min-h-72 bg-amare-bg-deep">
+            <div data-motion-beat="media" class="min-h-72 overflow-hidden bg-amare-bg-deep">
                 <x-media.image
                     :path="$settings->default_og_image_path"
                     :alt="$settings->default_og_image_alt ?: $settings->brand_name"
                     loading="eager"
+                    fetchpriority="high"
                     sizes="(max-width: 768px) 100vw, 40vw"
                     class="img-editorial h-full w-full object-cover"
                 />

resources/views/components/home/manifesto.blade.php

@@ -8,11 +8,15 @@
     $body = $settings->manifesto_body ?: 'A Amare combina sensibilidade e precisão para criar encontros coerentes com cada cliente, marca e ocasião — sem fórmulas prontas, excessos ou ruído.';
 @endphp
 
-<section aria-labelledby="manifesto-heading" class="border-b border-amare-border bg-amare-bg-deep py-20">
+<section aria-labelledby="manifesto-heading" class="home-chapter border-b border-amare-border bg-amare-bg-deep py-20" data-chapter="manifesto">
-    <div class="container-amare grid gap-8 md:grid-cols-[minmax(0,0.8fr)_minmax(0,1.2fr)]">
+    <div class="container-amare grid gap-8 md:grid-cols-[minmax(0,0.8fr)_minmax(0,1.2fr)]" data-reveal-group>
-        <p class="text-sm font-medium uppercase tracking-[0.18em] text-amare-accent">Manifesto</p>
+        <div class="space-y-5 md:pr-8" data-reveal data-reveal-from="up">
-        <div class="space-y-6">
+            <x-home.folio label="Manifesto" />
-            <h2 id="manifesto-heading" class="max-w-3xl text-3xl font-medium leading-tight text-amare-text md:text-4xl">{{ $title }}</h2>
+            <span class="block h-px w-16 bg-amare-border" aria-hidden="true"></span>
+            <p class="max-w-52 text-lg leading-snug text-amare-text">Humana no cuidado. Precisa na entrega.</p>
+        </div>
+        <div class="space-y-6" data-reveal data-reveal-from="up">
+            <h2 id="manifesto-heading" class="max-w-3xl text-headline font-medium text-amare-text">{{ $title }}</h2>
             <p class="max-w-2xl text-xl leading-relaxed text-amare-text">{{ $lead }}</p>
             <p class="max-w-2xl text-amare-text-muted">{{ $body }}</p>
         </div>

resources/views/components/home/method.blade.php

@@ -7,17 +7,24 @@
     $intro = $settings->method_intro ?: 'Clareza em cada etapa. Tranquilidade durante todo o processo.';
 @endphp
 
-<section aria-labelledby="method-heading" class="border-b border-amare-border bg-amare-bg-archive py-20">
+<section aria-labelledby="method-heading" class="home-chapter border-b border-amare-border bg-amare-bg-archive py-20" data-chapter="method">
-    <div class="container-amare grid gap-10 md:grid-cols-[minmax(0,0.8fr)_minmax(0,1.2fr)] md:items-start">
+    <div class="container-amare grid gap-10 md:grid-cols-[minmax(0,0.8fr)_minmax(0,1.2fr)] md:items-start" data-reveal-group>
-        <div class="space-y-3">
+        <div class="space-y-4" data-reveal data-reveal-from="up">
-            <p class="text-sm font-medium uppercase tracking-[0.18em] text-amare-accent">Método</p>
+            <x-home.folio label="Método" />
-            <h2 id="method-heading" class="text-3xl font-medium text-amare-text">Cuidado orientado por processo.</h2>
+            <h2 id="method-heading" class="text-headline font-medium text-amare-text">Cuidado orientado por processo.</h2>
             <p class="text-amare-text-muted">{{ $intro }}</p>
+            <x-brand.logo
+                mark
+                variant="on-light"
+                class="mt-8 h-8 w-auto opacity-60"
+                alt=""
+                aria-hidden="true"
+            />
         </div>
 
         <ol class="grid gap-5 border-t border-amare-border">
             @foreach ($steps as $index => $step)
-                <li class="grid gap-2 border-b border-amare-border py-5 md:grid-cols-[4rem_minmax(0,1fr)]">
+                <li class="grid gap-2 border-b border-amare-border py-5 md:grid-cols-[4rem_minmax(0,1fr)]" data-reveal data-reveal-from="up">
                     <span class="text-sm text-amare-accent">{{ str_pad((string) ($index + 1), 2, '0', STR_PAD_LEFT) }}</span>
                     <div class="space-y-2">
                         <h3 class="text-2xl font-medium text-amare-text">{{ $step['title'] ?? '' }}</h3>

resources/views/components/home/portfolio.blade.php

@@ -3,19 +3,19 @@
 ])
 
 @if ($cases->isNotEmpty())
-    <section aria-labelledby="portfolio-heading" class="border-b border-amare-accent-deep bg-amare-accent-deep py-20 text-amare-accent-text">
+    <section aria-labelledby="portfolio-heading" class="home-chapter border-b border-amare-accent-deep bg-amare-accent-deep py-20 text-amare-accent-text" data-chapter="portfolio">
-        <div class="container-amare space-y-10">
+        <div class="container-amare space-y-10" data-reveal-group>
-            <div class="grid gap-4 md:grid-cols-[minmax(0,0.8fr)_minmax(0,1.2fr)]">
+            <div class="grid gap-4 md:grid-cols-[minmax(0,0.8fr)_minmax(0,1.2fr)]" data-reveal data-reveal-from="up">
-                <p class="text-sm font-medium uppercase tracking-[0.18em] text-amare-accent-text/80">Portfólio</p>
+                <x-home.folio label="Portfólio" tone="inverse" />
                 <div class="space-y-3">
-                    <h2 id="portfolio-heading" class="text-3xl font-medium md:text-4xl">Celebrações que ganham forma com intenção.</h2>
+                    <h2 id="portfolio-heading" class="text-headline font-medium">Celebrações que ganham forma com intenção.</h2>
                     <p class="max-w-2xl text-amare-accent-text/80">Recortes de eventos conduzidos com escuta, direção e presença em cada etapa.</p>
                 </div>
             </div>
 
             <div class="grid gap-10 md:grid-cols-2">
                 @foreach ($cases as $case)
-                    <article class="space-y-4 border-t border-amare-accent-text/30 pt-4">
+                    <article class="space-y-4 border-t border-amare-accent-text/30 pt-4" data-reveal data-reveal-from="up">
                         @if (filled($case->cover_image_path))
                             <x-media.image
                                 :path="$case->cover_image_path"
@@ -27,8 +27,8 @@
                         <div class="space-y-2">
                             <h3 class="text-2xl font-medium">{{ $case->title }}</h3>
                             <p class="text-amare-accent-text/80">{{ $case->summary }}</p>
-                            <a href="{{ route('portfolio.show', $case->slug) }}" class="inline-flex border-b border-amare-accent-text pb-1 text-sm font-semibold transition-colors hover:text-amare-accent-text">
+                            <a href="{{ route('portfolio.show', $case->slug) }}" class="inline-flex min-h-11 items-center text-sm font-semibold transition-colors hover:text-amare-accent-text">
-                                Ver caso
+                                <span class="border-b border-amare-accent-text pb-1">Ver caso</span>
                             </a>
                         </div>
                     </article>
@@ -39,8 +39,8 @@
                 <p class="max-w-2xl text-sm text-amare-accent-text/75">
                     Imagens demonstrativas enquanto o acervo autorizado da Amare está em organização.
                 </p>
-                <a href="{{ route('portfolio.index') }}" class="border-b border-amare-accent-text pb-1 text-sm font-semibold transition-colors hover:text-amare-accent-text">
+                <a href="{{ route('portfolio.index') }}" class="inline-flex min-h-11 items-center text-sm font-semibold transition-colors hover:text-amare-accent-text">
-                    Conhecer o portfólio
+                    <span class="border-b border-amare-accent-text pb-1">Conhecer o portfólio</span>
                 </a>
             </div>
         </div>

resources/views/components/home/positioning.blade.php

@@ -7,13 +7,17 @@
     $principles = filled($settings->principles) ? $settings->principles : \App\Models\SiteSetting::defaultPrinciples();
 @endphp
 
-<section aria-labelledby="positioning-heading" class="border-b border-amare-border py-20">
+<section aria-labelledby="positioning-heading" class="home-chapter border-b border-amare-border py-20" data-chapter="positioning">
-    <div class="container-amare grid gap-10 md:grid-cols-[minmax(0,0.8fr)_minmax(0,1.2fr)]">
+    <div class="container-amare grid gap-10 md:grid-cols-[minmax(0,0.8fr)_minmax(0,1.2fr)]" data-reveal-group>
-        <div class="space-y-3">
+        <div class="space-y-4" data-reveal data-reveal-from="up">
-            <p class="text-sm font-medium uppercase tracking-[0.18em] text-amare-accent">A Amare</p>
+            <x-home.folio label="A Amare" />
-            <h2 id="positioning-heading" class="text-3xl font-medium text-amare-text">Presença que organiza o essencial.</h2>
+            <div class="flex items-center gap-4">
+                <span class="h-px w-10 bg-amare-border" aria-hidden="true"></span>
+                <p class="text-sm uppercase tracking-[0.12em] text-amare-text-muted">Assessoria boutique · São Paulo</p>
         </div>
-        <div class="space-y-8">
+            <h2 id="positioning-heading" class="text-headline font-medium text-amare-text">Presença que organiza o essencial.</h2>
+        </div>
+        <div class="space-y-8" data-reveal data-reveal-from="up">
             <p class="max-w-2xl text-xl leading-relaxed text-amare-text">{{ $summary }}</p>
             <ul class="grid gap-3 border-t border-amare-border">
                 @foreach ($principles as $principle)
@@ -21,8 +25,8 @@
                 @endforeach
             </ul>
             <p>
-                <a href="{{ route('about') }}" class="border-b border-amare-accent pb-1 text-sm font-semibold text-amare-accent transition-colors hover:text-amare-accent-deep">
+                <a href="{{ route('about') }}" class="inline-flex min-h-11 items-center text-sm font-semibold text-amare-accent transition-colors hover:text-amare-accent-deep">
-                    Conhecer a Amare
+                    <span class="border-b border-amare-accent pb-1">Conhecer a Amare</span>
                 </a>
             </p>
         </div>

resources/views/components/home/proof.blade.php

@@ -1,31 +0,0 @@
-@props([
-    'cases',
-])
-
-@if ($cases->isNotEmpty())
-    <section aria-labelledby="proof-heading" class="border-b border-amare-border bg-amare-bg-muted py-16">
-        <div class="container-amare space-y-8">
-            <div class="max-w-2xl space-y-3">
-                <h2 id="proof-heading" class="text-3xl font-semibold text-amare-text">Prova visual</h2>
-                <p class="text-amare-text-muted">Eventos em destaque que mostram o cuidado com cada celebração.</p>
-            </div>
-
-            <div class="grid gap-6 md:grid-cols-2 lg:grid-cols-3">
-                @foreach ($cases as $case)
-                    <article class="space-y-3">
-                        @if (filled($case->cover_image_path))
-                            <x-media.image
-                                :path="$case->cover_image_path"
-                                :alt="$case->cover_image_alt ?: $case->title"
-                                sizes="(max-width: 768px) 100vw, 33vw"
-                                class="aspect-[4/3] w-full object-cover"
-                            />
-                        @endif
-                        <h3 class="text-xl font-semibold text-amare-text">{{ $case->title }}</h3>
-                        <p class="text-sm text-amare-text-muted">{{ $case->summary }}</p>
-                    </article>
-                @endforeach
-            </div>
-        </div>
-    </section>
-@endif

resources/views/components/home/services.blade.php

@@ -3,17 +3,22 @@
 ])
 
 @if ($services->isNotEmpty())
-    <section aria-labelledby="services-heading" class="border-b border-amare-border py-20">
+    <section aria-labelledby="services-heading" class="home-chapter border-b border-amare-border py-20" data-chapter="services">
-        <div class="container-amare space-y-10">
+        <div class="container-amare space-y-10" data-reveal-group>
-            <div class="max-w-2xl space-y-3">
+            <div class="grid gap-6 md:grid-cols-12 md:items-end" data-reveal data-reveal-from="up">
-                <p class="text-sm font-medium uppercase tracking-[0.18em] text-amare-accent">Atuação</p>
+                <div class="space-y-3 md:col-span-4">
+                    <x-home.folio label="Serviços" />
                     <h2 id="services-heading" class="text-3xl font-medium text-amare-text">Serviços</h2>
-                <p class="text-amare-text-muted">Assessoria sob medida para decisões importantes e celebrações bem conduzidas.</p>
+                </div>
+                <div class="space-y-4 md:col-span-6 md:col-start-7">
+                    <p class="max-w-xl text-amare-text-muted">Assessoria sob medida para decisões importantes e celebrações bem conduzidas.</p>
+                    <p class="border-l border-amare-border pl-4 text-sm uppercase tracking-[0.12em] text-amare-accent">Do íntimo ao corporativo</p>
+            </div>
             </div>
 
             <ol class="border-t border-amare-border">
                 @foreach ($services as $index => $service)
-                    <li class="grid gap-3 border-b border-amare-border py-5 md:grid-cols-[4rem_minmax(0,0.8fr)_minmax(0,1.2fr)] md:gap-6">
+                    <li class="grid gap-3 border-b border-amare-border py-5 md:grid-cols-[4rem_minmax(0,0.8fr)_minmax(0,1.2fr)] md:gap-6" data-reveal data-reveal-from="up">
                         <span class="text-sm text-amare-accent">{{ str_pad((string) ($index + 1), 2, '0', STR_PAD_LEFT) }}</span>
                         <h3 class="text-2xl font-medium text-amare-text">{{ $service->title }}</h3>
                         <p class="text-amare-text-muted">{{ $service->summary }}</p>
@@ -22,8 +27,8 @@
             </ol>
 
             <p>
-                <a href="{{ route('services.index') }}" class="border-b border-amare-accent pb-1 text-sm font-semibold text-amare-accent transition-colors hover:text-amare-accent-deep">
+                <a href="{{ route('services.index') }}" class="inline-flex min-h-11 items-center text-sm font-semibold text-amare-accent transition-colors hover:text-amare-accent-deep">
-                    Ver todos os serviços
+                    <span class="border-b border-amare-accent pb-1">Ver todos os serviços</span>
                 </a>
             </p>
         </div>

resources/views/components/home/testimonials.blade.php

@@ -2,11 +2,18 @@
     'testimonials',
 ])
 
+@php
+    $testimonials = $testimonials
+        ->filter(fn ($testimonial): bool => filled(trim((string) $testimonial->quote)))
+        ->values();
+@endphp
+
 @if ($testimonials->isNotEmpty())
-    <section aria-labelledby="testimonials-heading" class="border-b border-amare-border bg-amare-bg-muted py-16">
+    <section aria-labelledby="testimonials-heading" class="home-chapter border-b border-amare-border bg-amare-bg py-16" data-chapter="testimonials">
-        <div class="container-amare space-y-8">
+        <div class="container-amare space-y-8" data-reveal-group>
-            <div class="max-w-2xl space-y-3">
+            <div class="max-w-2xl space-y-3" data-reveal data-reveal-from="up">
-                <h2 id="testimonials-heading" class="text-3xl font-semibold text-amare-text">Depoimentos</h2>
+                <x-home.folio label="Depoimentos" />
+                <h2 id="testimonials-heading" class="text-3xl font-medium text-amare-text">Depoimentos</h2>
                 <p class="text-amare-text-muted">Quem celebrou com a Amare conta como foi a experiência.</p>
             </div>
 
@@ -16,13 +23,16 @@
                         $paragraphs = preg_split('/\n\s*\n/', trim((string) $testimonial->quote)) ?: [];
                         $paragraphs = array_values(array_filter(array_map('trim', $paragraphs), fn (string $p): bool => $p !== ''));
                     @endphp
-                    <blockquote class="space-y-4 border-t border-amare-border pt-4">
+                    <blockquote class="space-y-4 border-t border-amare-border pt-4" data-reveal data-reveal-from="{{ $loop->odd ? 'left' : 'right' }}">
+                        <div class="grid grid-cols-[1.5rem_minmax(0,1fr)] gap-2">
+                            <span class="text-3xl leading-none text-amare-sage" aria-hidden="true">“</span>
                             <div class="space-y-3 text-lg text-amare-text">
-                            @foreach ($paragraphs as $index => $paragraph)
+                                @foreach ($paragraphs as $paragraph)
-                                <p>@if ($index === 0)“@endif{{ $paragraph }}@if ($index === count($paragraphs) - 1)”@endif</p>
+                                    <p>{{ $paragraph }}</p>
                                 @endforeach
                             </div>
-                        <footer class="text-sm text-amare-text-muted">
+                        </div>
+                        <footer class="pl-8 text-sm text-amare-text-muted">
                             <cite class="not-italic font-semibold text-amare-text">{{ $testimonial->author_name }}</cite>
                             @if (filled($testimonial->context))
                                 <span> — {{ $testimonial->context }}</span>

resources/views/components/media/image.blade.php

@@ -3,6 +3,7 @@
     'alt',
     'sizes' => '(max-width: 768px) 100vw, 960px',
     'loading' => 'lazy',
+    'fetchpriority' => null,
     'width' => null,
     'height' => null,
     'disk' => null,
@@ -32,7 +33,7 @@
 
     $resolvedWidth = $width ?? $dimensions['width'] ?? null;
     $resolvedHeight = $height ?? $dimensions['height'] ?? null;
-    $loadingValue = $loading === 'eager' ? 'eager' : 'lazy';
+    $loadingValue = $loading;
 @endphp
 
 <img
@@ -42,6 +43,7 @@
     @if ($resolvedWidth) width="{{ $resolvedWidth }}" @endif
     @if ($resolvedHeight) height="{{ $resolvedHeight }}" @endif
     loading="{{ $loadingValue }}"
+    @if ($fetchpriority) fetchpriority="{{ $fetchpriority }}" @endif
     @if ($class) class="{{ $class }}" @endif
     {{ $attributes->except(['path', 'alt', 'sizes', 'loading', 'width', 'height', 'disk', 'class']) }}
 >

resources/views/components/seo/meta.blade.php

@@ -3,12 +3,18 @@
 ])
 
 <meta name="description" content="{{ $pageMeta->description }}">
+@if (filled($pageMeta->canonical))
     <link rel="canonical" href="{{ $pageMeta->canonical }}">
+@endif
 
+<meta property="og:locale" content="pt_BR">
+<meta property="og:site_name" content="{{ $pageMeta->siteName }}">
 <meta property="og:title" content="{{ $pageMeta->title }}">
 <meta property="og:description" content="{{ $pageMeta->description }}">
 <meta property="og:type" content="{{ $pageMeta->ogType }}">
+@if (filled($pageMeta->canonical))
     <meta property="og:url" content="{{ $pageMeta->canonical }}">
+@endif
 @if ($pageMeta->ogImageUrl)
     <meta property="og:image" content="{{ $pageMeta->ogImageUrl }}">
     @if ($pageMeta->ogImageAlt)
@@ -16,6 +22,19 @@
     @endif
 @endif
 
-@if ($pageMeta->jsonLd)
+<meta name="twitter:card" content="summary_large_image">
-    <script type="application/ld+json">{!! json_encode($pageMeta->jsonLd, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE) !!}</script>
+<meta name="twitter:title" content="{{ $pageMeta->title }}">
+<meta name="twitter:description" content="{{ $pageMeta->description }}">
+@if ($pageMeta->ogImageUrl)
+    <meta name="twitter:image" content="{{ $pageMeta->ogImageUrl }}">
+@endif
+
+@if (app()->environment('production'))
+    <meta name="robots" content="{{ $pageMeta->robots }}">
+@else
+    <meta name="robots" content="noindex, nofollow">
+@endif
+
+@if ($pageMeta->jsonLd)
+    <script type="application/ld+json">{!! json_encode($pageMeta->jsonLd, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT) !!}</script>
 @endif

resources/views/emails/contact-briefing-confirmation-text.blade.php

@@ -0,0 +1,5 @@
+Olá, {{ $name }}.
+
+Recebemos sua mensagem e retornaremos em breve pelo canal informado.
+
+{{ $brandName }}

resources/views/emails/contact-briefing-confirmation.blade.php

@@ -0,0 +1,25 @@
+<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>Recebemos sua mensagem</title>
+    <style>
+        body { margin: 0; padding: 24px; background: #FBF9F4; font-family: Georgia, 'Times New Roman', serif; color: #1B1C19; }
+        .wrap { max-width: 600px; margin: 0 auto; }
+        p { font-size: 15px; line-height: 1.6; }
+        .signature { margin-top: 24px; color: #5D6155; }
+    </style>
+</head>
+<body>
+    <div class="wrap">
+        <p>Olá, {{ $name }}.</p>
+        <p>
+            Recebemos sua mensagem e retornaremos em breve pelo canal informado.
+        </p>
+        <p class="signature">
+            {{ $brandName }}
+        </p>
+    </div>
+</body>
+</html>

resources/views/emails/contact-briefing-text.blade.php

@@ -0,0 +1,7 @@
+Novo briefing de contato
+
+@foreach ($fields as $label => $value)
+{{ $label }}: {{ $value ?: '—' }}
+@endforeach
+
+Enviado pelo site {{ config('app.name') }}.