mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-17 12:43:05 +00:00
93 lines
6.6 KiB
Markdown
93 lines
6.6 KiB
Markdown
# Vertical Comunicação: papel communicator + Acervo pesquisável
|
||
|
||
Status: rascunho
|
||
Atualizado em: 2026-09-12
|
||
Issue: #956
|
||
Priority: P1
|
||
Impeccable: C — fluxo novo na vertical `/campanha/comunicacao`
|
||
Rascunho UI: docs/plans/acervo-videos-comunicacao-ui-draft.html
|
||
Appetite: ~2–3 dias; um outcome verificável — o assessor de comunicação entra com acesso próprio, busca uma fala por tema/município e assiste/baixa o trecho
|
||
Responsável: —
|
||
|
||
## Intenção
|
||
|
||
A comunicação da campanha depende de garimpar falas do Solla em YouTube e no portal da Câmara — sem busca, sem minutagem e sem saber o contexto. Este item abre a vertical de comunicação para quem produz conteúdo: um acesso próprio (`communicator`) que mostra só essa área, e o Acervo de falas — busca textual com destaque, filtros por tema/alcance/ano/fase/município e player que já abre no trecho, com transcrição clicável e download.
|
||
|
||
## Persona e fluxo
|
||
|
||
- **Persona / contexto:** assessoria de comunicação (jornalista/videomaker), no escritório ou em campo, produzindo card, áudio e vídeo com prazo curto; o Sollinha e o resto da campanha não são o trabalho dela.
|
||
- **Job principal:** achar a fala/trecho sobre um assunto, tema ou município e levar para a peça — assistindo no ponto exato e baixando o arquivo.
|
||
- **Fluxo desejado:** login → nav "Comunicação" → busca (ex.: "Farmácia Popular") → resultados com trecho destacado e chips de tema → abrir o detalhe → player já no timestamp do trecho → ler a transcrição clicável → baixar/abrir a fonte.
|
||
- **Anti-goals de produto:** editor de vídeo/corte no browser; segundo cadastro de pessoas; exposição pública do acervo; permissão por município (comunicação é global, não é carteira).
|
||
|
||
### Esboço de fluxo (B/C/D)
|
||
|
||
```text
|
||
[login] → nav Comunicação → busca/filtros → resultado com trecho destacado
|
||
→ detalhe: player no timestamp + transcrição clicável + baixar → [outcome: matéria-prima na mão]
|
||
```
|
||
|
||
### Rascunho UI (B/C/D)
|
||
|
||
- Rascunho UI (gate): `docs/plans/acervo-videos-comunicacao-ui-draft.html` — cenas desktop (resultados e detalhe), mobile (~390px) e vazio.
|
||
|
||
## Objetivo e aceite
|
||
|
||
- Papel `communicator` ("Assessor de Comunicação"): vê e navega **só** a vertical (nav própria, sem as demais áreas da campanha); `coordinator`/`candidate` também veem; `advisor`/`leader` não têm acesso.
|
||
- `/campanha/comunicacao/acervo` com busca textual sobre os segmentos, destaque do termo e filtros: ano, tema, alcance, fase do discurso, município citado, duração.
|
||
- Keywords oficiais aparecem como chips e também são pesquisáveis (termo exato).
|
||
- Detalhe com player iniciando no trecho, transcrição clicável por segmento, sumário, contexto da sessão (fase, quem presidia) e ações: baixar (VOD) e abrir fonte.
|
||
- Estados críticos: vazio (sem resultado), carregando e sem permissão.
|
||
- Mobile utilizável (a assessoria trabalha em campo).
|
||
- **Guardrails:** vídeo servido do VOD da Câmara nesta fase (sem espelho); crédito à Câmara (CC BY 4.0); nenhum dashboard de vaidade.
|
||
|
||
## Dados (intenção)
|
||
|
||
- **Vou apresentar dados?** Sim, superfície — resultados com trecho e contagem por faceta.
|
||
- **Decisões desbloqueadas:** a assessoria escolhe qual fala cortar para um tema e qual material cobre um município.
|
||
- **Forma:** _adiada ao plano de implementação_ — aqui só a restrição: nada de % estadual absoluto nem KPI de vaidade.
|
||
|
||
## Dados da decisão (literais)
|
||
|
||
- **Papel:** `communicator` — rótulo "Assessor de Comunicação".
|
||
- **Rotas:** home da vertical `/campanha/comunicacao`; acervo `/campanha/comunicacao/acervo`; detalhe `/campanha/comunicacao/acervo/[id]`.
|
||
- **Filtros:** ano · tema · alcance · fase do discurso · município citado · duração.
|
||
- **Facetas (rótulos):** os 18 temas e os 3 alcances definidos no C153.
|
||
- **Comportamento do player:** abrir no início do segmento selecionado; transcrição clicável posiciona o vídeo.
|
||
|
||
## Direção no codebase (hipótese)
|
||
|
||
- **Áreas prováveis:** `src/app/(campaign)/campanha/(app)/comunicacao/…` (páginas + server actions), `src/components/campaign/comunicacao/`, `src/lib/campaignRoles.ts` (predicado do papel), `src/components/campaign/shell/nav.ts` (nav do communicator), `src/lib/campaignPageChrome.ts` (título/aba), `src/utilities/campaignPageActor.ts` (gate novo), módulo de access reexportado por `campaignAccess.ts`, e busca em endpoint `POST` no wrapper `campaignJsonMutationRoute`.
|
||
- **Precedente a olhar:** `src/components/campaign/supporter/` (lista + filtros), `home-search` (busca com `contains`), `src/app/(campaign)/campanha/(app)/assessores/` (página gated).
|
||
- **Risco de acoplamento:** não abrir as demais áreas para o `communicator` (ele não é staff); leader lockdown intocado; nada de permissão por município.
|
||
|
||
## Dependências
|
||
|
||
- **C153** (acervo no banco) — sem dados não há busca; o rascunho UI pode ser validado antes.
|
||
|
||
## Fora de escopo
|
||
|
||
- Clipes/editor e espelhamento em S3.
|
||
- Busca semântica/IA (item futuro próprio).
|
||
- Exposição pública e compartilhamento externo.
|
||
- Comissões/audiências (Plenário apenas).
|
||
- Notificações, favoritos e listas editoriais (avaliar depois de uso real).
|
||
|
||
## Rabbit holes de produto
|
||
|
||
- **"Cortar o trecho no browser."** Se alguém "só completar": editor de vídeo, fila de render, storage. **Corte neste item:** player + download; corte é ferramenta externa.
|
||
- **"Permissão por município para a comunicação."** Se alguém "só completar": a vertical inteira vira carteira. **Corte neste item:** acesso global à vertical.
|
||
- **"Baixar em lote / coleções."** Se alguém "só completar": gerenciador de projetos. **Corte neste item:** busca e download por trecho.
|
||
|
||
## Questões em aberto (produto)
|
||
|
||
- **Home do communicator?** **Opções:** A) a própria vertical `/campanha/comunicacao` (recomendado) | B) Início genérico da campanha. **Recomendação:** A — ele não pertence ao fluxo de municípios.
|
||
- **Buscar também nas keywords cruas?** **Opções:** A) sim, como termo exato (recomendado) | B) só no texto. **Recomendação:** A — captura termos que a taxonomia não tem (ex.: "Banco Master").
|
||
- **Transcrição exibida: oficial ou ASR?** **Opções:** A) oficial para leitura + ASR para posicionar (recomendado) | B) só ASR. **Recomendação:** A — taquigrafia é limpa para citar.
|
||
|
||
## Referências
|
||
|
||
- GitHub Issue: — (após `pnpm agent:register`)
|
||
- Rascunho UI (gate): `docs/plans/acervo-videos-comunicacao-ui-draft.html`
|
||
- `AGENTS-campaign.md` (auth e roles) · `src/lib/campaignRoles.ts` · `src/components/campaign/shell/nav.ts` · `docs/research/persona-emendas-coordenador-comunicacao.md`
|
||
- C153 (catálogo e facetas) · C155 (backfill/produção)
|