[app] API de Foruns (institucionais + forum livre) #15

New issue

Open

opened 2026-07-25 22:30:21 -03:00 by navigator · 0 comments

navigator commented

2026-07-25 22:30:21 -03:00

Owner

Contexto

O app precisa dos Foruns (feature nova, pedida por ultimo). Hoje /api/v1/foruns e /forums = 404 e nao ha referencias no backend.

Pedido (organizacao discutida)

Institucionais: Senado por comissoes; estados e municipios organizados por SAUDE, EDUCACAO, SEGURANCA, INFRAESTRUTURA, LAZER + Assembleia/Camara e Governo.
Um forum livre (fora dos institucionais) para pautas gerais.

Superficie sugerida (a validar)

GET /api/v1/foruns?org_id=&scope= (lista de foruns por esfera/tema).
GET /api/v1/foruns/{id} (detalhe) + GET /foruns/{id}/topicos + POST /foruns/{id}/topicos.
GET /topicos/{id}/mensagens + POST /topicos/{id}/mensagens.
Ler sem login; escrever com login. Reaproveitar padroes de Debates/Consultas.

App

Card 'em breve' ja no hub Civico; telas entram assim que a API existir.

Aberta pelo agente do app nativo (Flutter, brasil/democracia-app). Bloqueia/limita funcionalidade no mobile. Contrato validado ao vivo em 2026-07-26.

## Contexto O app precisa dos **Foruns** (feature nova, pedida por ultimo). Hoje `/api/v1/foruns` e `/forums` = **404** e nao ha referencias no backend. ## Pedido (organizacao discutida) - **Institucionais**: Senado por **comissoes**; **estados e municipios** organizados por **SAUDE, EDUCACAO, SEGURANCA, INFRAESTRUTURA, LAZER** + **Assembleia/Camara** e **Governo**. - **Um forum livre** (fora dos institucionais) para pautas gerais. ## Superficie sugerida (a validar) - `GET /api/v1/foruns?org_id=&scope=` (lista de foruns por esfera/tema). - `GET /api/v1/foruns/{id}` (detalhe) + `GET /foruns/{id}/topicos` + `POST /foruns/{id}/topicos`. - `GET /topicos/{id}/mensagens` + `POST /topicos/{id}/mensagens`. Ler sem login; escrever com login. Reaproveitar padroes de Debates/Consultas. ## App Card 'em breve' ja no hub **Civico**; telas entram assim que a API existir. --- _Aberta pelo agente do **app nativo** (Flutter, `brasil/democracia-app`). Bloqueia/limita funcionalidade no mobile. Contrato validado ao vivo em 2026-07-26._