docs: reconciliar OpenSpec e escopo do MVP (MAN-124) (#50)

openspec/changes/archive/2026-08-11-recompose-public-editorial/.openspec.yaml

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

openspec/changes/archive/2026-08-11-recompose-public-editorial/design.md

@@ -0,0 +1,44 @@
+## Context
+
+O commit de base ja separa as imagens hero de Open Graph, oferece variantes responsivas, fallbacks tonais e preserva o formulario de briefing. As views publicas ainda usam algumas grades simetricas, especialmente nas colecoes de portfolio. A referencia aprovada define composicao e materialidade, nunca novo acervo ou copy.
+
+## Goals / Non-Goals
+
+**Goals:**
+
+- Aplicar uma cadencia de campos tonais, regras e proporcoes alternadas nas paginas narrativas.
+- Manter uma ordem DOM linear e completa em telas pequenas.
+- Reforcar os contratos existentes de acessibilidade, motion progressivo, performance de imagem e SEO.
+
+**Non-Goals:**
+
+- Alterar dados CMS, contratos de rota, controller, metadata, uploads, variantes ou o formulario.
+- Usar imagens externas, criar conteudo comercial, adicionar dependencias, atualizar snapshots ou reintroduzir regressao visual.
+
+## Decisions
+
+### Usar variacoes de `col-span` e `aspect-ratio` nas galerias existentes
+
+As imagens continuam no mesmo componente responsivo, mas a primeira imagem e os itens pares recebem encaixes editoriais no desktop. A alternativa seria uma galeria JavaScript ou masonry; foi descartada por prejudicar a ordem de leitura e adicionar comportamento sem necessidade.
+
+### Aplicar assimetria pela composicao, nao por posicionamento absoluto
+
+Grid responsivo, margens e campos tonais criam o deslocamento sem tirar conteudo do fluxo. Isso preserva foco, leitura mobile e fallback sem JavaScript. Posicionamento absoluto foi descartado por aumentar risco de sobreposicao e overflow.
+
+### Reutilizar motion de transformacao e clip ja existente
+
+As novas regioes conservam `data-reveal` e grupos existentes. Nenhum texto passa a depender de opacidade; `prefers-reduced-motion` continua exibindo o estado final imediatamente.
+
+## Risks / Trade-offs
+
+- [Ritmo visual pode parecer irregular com poucos cases] -> regras e metadados mantem uma leitura coerente mesmo com um unico item.
+- [Classes responsivas podem afetar o fluxo em mobile] -> DOM linear e classes de uma coluna continuam sendo a base abaixo de `md`.
+- [Mudar CSS pode gerar diferencas de ambiente] -> validar markup, acessibilidade funcional e build; snapshots permanecem fora do escopo.
+
+## Migration Plan
+
+Nao ha migracao de dados. A mudanca e retrocompativel: sem imagens, os fallbacks tonais existentes continuam ativos; com imagens, o mesmo `srcset` responsivo e usado. Reverter o commit restaura somente apresentacao.
+
+## Open Questions
+
+Nenhuma. Fotografia autorizada de producao permanece uma dependencia de conteudo futura.

openspec/changes/archive/2026-08-11-recompose-public-editorial/proposal.md

@@ -0,0 +1,30 @@
+## Why
+
+O site público já possui os conteúdos, fluxos e a base Heritage Editorial, mas algumas páginas ainda repetem grades regulares que enfraquecem a cadência da referência aprovada. A recomposição consolida uma leitura editorial contínua sem alterar dados CMS, SEO ou a jornada de briefing.
+
+## What Changes
+
+- Recompõe as superfícies públicas narrativas com campos tonais, regras finas, assimetria desktop e sequência vertical legível em mobile.
+- Organiza a home nos capítulos editoriais existentes, com portfólio em campo oliva e recortes de imagens em proporções alternadas.
+- Reestiliza listagens e detalhe de portfólio para que imagens e blocos de leitura não dependam de uma grade de cartões repetida.
+- Mantém contato, privacidade e erros em tratamento sóbrio; preserva menu móvel, foco, formulário, SEO, motion progressivo e conteúdo do CMS.
+- Documenta que heros fotográficos e sua administração já estão presentes na base atual, sem acoplar mídia editorial à imagem Open Graph.
+
+## Capabilities
+
+### New Capabilities
+
+- Nenhuma.
+
+### Modified Capabilities
+
+- `public-site-pages`: composição e cadência visual das rotas públicas passam a exigir ritmos editoriais assimétricos.
+- `content-media`: a apresentação de mídia de portfólio passa a suportar proporções editoriais alternadas sem mudar armazenamento ou variantes.
+
+## Impact
+
+Afeta Blade e estilos do site público, testes de estrutura/renderização e a documentação OpenSpec. Não altera rotas, controladores, dados de conteúdo, dependências ou contratos de SEO.
+
+## Non-goals
+
+Não introduz itens excluídos por SPEC.md §4.2, novos canais, prova comercial, conteúdo de produção, imagens externas, dependências de animação, snapshots visuais ou mudanças no Filament.

openspec/changes/archive/2026-08-11-recompose-public-editorial/specs/content-media/spec.md

@@ -0,0 +1,16 @@
+## MODIFIED Requirements
+
+### Requirement: Editorial image treatment remains self-hosted and deterministic
+Public photography SHALL continue to use validated self-hosted uploads and responsive variants. Editorial layouts MUST use CSS-only tonal treatment and alternating aspect ratios for portfolio media while retaining document order and the image component's `srcset`, `sizes`, dimensions and loading behavior. The system MUST NOT introduce external image CDN dependencies that compromise browser-test reliability.
+
+#### Scenario: Public pages do not depend on external stock hosts
+
+- **WHEN** the visual or browser suite loads covered public routes
+- **THEN** content images MUST resolve from the application media disk or static fixtures
+- **AND** MUST NOT require network access to third-party stock hosts
+
+#### Scenario: Editorial portfolio media retains responsive delivery
+
+- **WHEN** a portfolio listing or gallery applies an editorial image proportion
+- **THEN** the rendered image MUST still expose the responsive media component markup
+- **AND** image order and lazy-loading behavior MUST remain intact

openspec/changes/archive/2026-08-11-recompose-public-editorial/specs/public-site-pages/spec.md

@@ -0,0 +1,69 @@
+## MODIFIED Requirements
+
+### Requirement: Home renders the editorial structure from CMS content
+The home page SHALL render, in order: header/navigation, hero, manifesto, featured services summary, featured portfolio selection, working method (four steps), testimonials, Amare positioning/profile, final contact CTA, and footer with contact, social links and legal links (WEB-01). Hero copy, brand name, manifesto, method and principles MUST come from `site_settings` (with editorial defaults when optional fields are empty); services, cases and testimonials MUST come from published records. The home MUST follow the Heritage Editorial composition: asymmetric spreads and tonal fields on desktop, with portfolio images in alternating editorial proportions, and a linear complete sequence on mobile rather than rounded card grids.
+
+#### Scenario: Published content is displayed in configured order
+
+- **GIVEN** published services, cases and testimonials exist
+- **WHEN** a visitor loads the home
+- **THEN** the published content MUST be displayed following the `sort_order` and featured flags
+- **AND** the hero MUST show the values stored in `site_settings`
+- **AND** the manifesto, method and positioning sections MUST be present
+- **AND** the portfolio section MUST use an olive tonal field with editorial image proportions
+
+#### Scenario: CTA leads to the contact placeholder page
+
+- **WHEN** a visitor activates the primary or final CTA on the home
+- **THEN** the visitor MUST be taken to the `contact` route
+- **AND** no lead record MUST be created
+
+#### Scenario: Empty catalog sections are omitted
+
+- **GIVEN** no published services, cases or testimonials
+- **WHEN** a visitor loads the home
+- **THEN** the response MUST be 200
+- **AND** the services, portfolio and testimonials sections MUST be omitted instead of rendering empty containers
+- **AND** hero, manifesto, method, positioning and final CTA MUST still render
+
+#### Scenario: Home has no console errors
+
+- **WHEN** the home is loaded in a real browser at desktop and mobile viewports
+- **THEN** the browser console MUST contain no JavaScript errors
+
+### Requirement: Listing and detail pages exist for catalog content
+The system SHALL render a services listing (WEB-02) and a portfolio listing plus case detail (WEB-03) using the Heritage Editorial visual language. The case detail MUST present summary, event type, optional city/venue/date, challenge, solution, optional result, cover image and the ordered gallery. Portfolio listings and galleries MUST use alternating editorial image proportions on desktop while retaining DOM order and a single-column readable sequence on mobile.
+
+#### Scenario: Services listing shows published services
+
+- **WHEN** a visitor loads `/servicos`
+- **THEN** every published service MUST be listed with title and summary in `sort_order`
+- **AND** the listing MUST use the public editorial layout (not an unrelated visual system)
+
+#### Scenario: Gallery respects stored order
+
+- **GIVEN** a published case with multiple gallery images
+- **WHEN** a visitor loads the case detail
+- **THEN** the images MUST be rendered ordered by `sort_order`
+- **AND** desktop presentation MUST alternate editorial image proportions without changing that order
+
+#### Scenario: Listings paginate open-ended growth
+
+- **WHEN** the number of published cases exceeds the page size
+- **THEN** `/portfolio` MUST paginate instead of rendering all records
+
+### Requirement: Institutional and error pages have brand identity
+The system SHALL provide the Sobre and Política de privacidade pages and branded error pages (WEB-07) using the Heritage Editorial public layout, including the brand mark when available. Contact, privacy and error surfaces MUST remain sober tonal layouts without decorative photography. The 404 page MUST use the public layout, and the 500 page MUST NOT expose stack traces or internal details when `APP_DEBUG` is false.
+
+#### Scenario: Unknown URL renders branded 404
+
+- **WHEN** a visitor requests a non-existent public URL
+- **THEN** the response status MUST be 404
+- **AND** the page MUST use the public layout and offer navigation back to the home
+
+#### Scenario: Server error hides internals in production
+
+- **GIVEN** `APP_DEBUG` is false
+- **WHEN** an unhandled exception occurs on a public route
+- **THEN** the response MUST be a generic branded error page
+- **AND** MUST NOT contain a stack trace, file path, or environment variable

openspec/changes/archive/2026-08-11-recompose-public-editorial/tasks.md

@@ -0,0 +1,10 @@
+## 1. Editorial composition
+
+- [x] 1.1 Add regression coverage for alternating public portfolio composition and sober functional surfaces.
+- [x] 1.2 Recompose home portfolio, portfolio listing and case gallery with responsive editorial proportions while preserving order and responsive media delivery.
+- [x] 1.3 Refine public content-page rhythm with tonal fields and desktop offsets without changing routes, CMS content or briefing behavior.
+
+## 2. Verification
+
+- [x] 2.1 Run focused feature and browser checks for public routes, motion, accessibility and navigation.
+- [x] 2.2 Run formatting, static analysis, frontend build and strict OpenSpec validation without updating snapshots.