# Feature Specification: Configuração de Background da Home por Tema

**Feature Branch**: `031-home-hero-light-dark`
**Created**: 2026-04-22
**Status**: Draft

## Objetivo

Permitir que administradores configurem separadamente a imagem de fundo da seção hero da página inicial para tema claro (light) e tema escuro (dark), com fallback seguro para a imagem atual.

## User Scenarios & Testing

### User Story 1 — Admin edita imagens light/dark (P1)

Como admin, quero informar URLs diferentes para o background da home em light e dark para manter legibilidade e identidade visual em cada tema.

**Independent Test**: Admin consegue abrir tela de configuração da home, editar os campos de imagem light/dark e salvar com sucesso.

**Acceptance Scenarios**:
1. Dado um admin autenticado, quando acessa a configuração da home, então visualiza os campos de imagem light e dark.
2. Dado um admin, quando salva URLs válidas, então as mudanças persistem no backend.
3. Dado falha de API, quando tenta salvar, então recebe feedback de erro sem perder o formulário.

### User Story 2 — Home usa imagem correta por tema (P1)

Como visitante/cliente, quero ver uma imagem de fundo adequada ao tema atual para manter contraste e experiência visual.

**Independent Test**: Alterar tema entre light e dark muda a imagem de fundo da home sem quebrar fallback.

**Acceptance Scenarios**:
1. Dado tema light, quando carrega a home, então usa `hero_image_light_url`.
2. Dado tema dark, quando carrega a home, então usa `hero_image_dark_url`.
3. Dado campo de tema ausente, quando renderiza a home, então usa fallback (`hero_image_url` e depois gradiente padrão).

## Edge Cases

- Apenas uma das imagens (light ou dark) cadastrada: sistema deve usar fallback sem erro.
- Registro de `homepage_config` inexistente: endpoint admin deve criar registro base no primeiro save.
- URL vazia: deve ser tratada como `null`.

## Requirements

- **FR-001**: Backend deve armazenar `hero_image_light_url` e `hero_image_dark_url` em `homepage_config`.
- **FR-002**: Endpoint público `/api/v1/homepage-config` deve retornar os novos campos.
- **FR-003**: Backend deve expor endpoint admin autenticado para atualizar configuração da home.
- **FR-004**: Frontend admin deve ter tela para editar e salvar imagens light/dark.
- **FR-005**: Navbar/menu admin deve permitir acesso à nova tela de configuração da home.
- **FR-006**: Home pública deve escolher imagem com base no tema resolvido (`resolvedTheme`).
- **FR-007**: Seed deve popular valores iniciais de imagem light/dark.

## Success Criteria

- **SC-001**: Admin salva configuração com HTTP 200 e dados persistidos.
- **SC-002**: Troca de tema na home altera o background sem erro de renderização.
- **SC-003**: Build frontend e backend sem erros após mudança.
- **SC-004**: Seed padrão cria `HomepageConfig` com URLs light/dark preenchidas.