Skip to content

feat(registro): o Registro de dados na tela, só para Dono e Administrador (G4) - #1209

Merged
leandrotcawork merged 5 commits into
mainfrom
feat/conexus-registro-g4
Nov 21, 2026
Merged

leandrotcawork merged 5 commits into
mainfrom
feat/conexus-registro-g4

Conversation

@leandrotcawork

@leandrotcawork leandrotcawork commented Nov 21, 2026 •

Copy link
Copy Markdown
Collaborator

Why

G4 do cartão Registro e conformidade, depois da emenda de 2026-11-21 (PR 1208, "Aprovo"): o Dono e o Administrador veem cada leitura que um agente ou um app fez do dado da empresa, em Configurações, ao lado de Papéis (D1 (a), D2 (a)).

What changed

  • U8: listDataReads e exportDataReads (packages/hub-api/src/data-reads.ts) admitem pela ação nova readDataReads da tabela de admissão, como Papéis; quem não a tem recebe 404 NOT_FOUND (S10). CompanyMay.readDataReads vai para a tela.
  • U8: a página vai por chave (hora, id), da mais nova; a exportação leva no máximo 31 dias e para em 5.000. Os nomes de pessoas e Projetos vêm num lote por página. A migração troca o índice (empresa, hora) por (empresa, hora, id) e (empresa, pessoa, hora, id) (R.11).
  • U9: Configurações, Registro de dados: 50 por página, quatro filtros no endereço, a linha aberta num painel e Exportar em CSV montado na tela.

Scope

Decisões do firstmate durante a construção (delivery L6), com a evidência nos relatórios de needs-decision:

  • E1 (a): from/to da exportação são instantes (code C40): a meia-noite local do "De" e a do dia seguinte ao "Até", no máximo 31 dias.
  • E2 (a): uma leitura de Projeto apagado volta project.name: null, e a tela diz "num Projeto apagado".
  • E3 (a): o filtro Resultado tem os quatro valores do P3; um dono só (OUTCOMES_OF, resultOf) serve o Hub e a tela.
  • E4 (a): Abrir a conversa só aparece na leitura de quem olha, porque a conversa só abre para a pessoa dela (builder/conversation/guard.ts:263-283). No passo 3 do roteiro, o fundador abre uma leitura dele mesmo. Se o dono deve ler a conversa de outra pessoa é pergunta separada para ele.
  • E5 (a): as consultas de leitura ficam em record.ts, o único arquivo que importa a tabela (critério 9).
  • Arquivos declarados fora da lista do cartão (delivery L7): hub/data/record.ts, packages/hub-api/src/pages.ts, builder/agents/public.ts (exporta agentsQuery), hub/copies/public.ts e copy-proposal.tsx (exportam QueryBlock), biome.json (o ajudante hub/data/test-hub.tsx na lista dos que usam MSW), apps/web/sweep-role-list.ts e sweep-states.ts (a resposta que o cartão dava em sweep-replies.ts e as telas novas da varredura), e, na rodada da revisão, apps/server/src/platform/pages.ts, apps/web/src/platform/download.ts, builder/conversation/shown-file.tsx e ui/input.tsx. O critério 80 cita csv.test.ts; o arquivo é csv.test.tsx, porque só os testes .test.tsx rodam no Vitest e usam ele (decisão 0034).

Textos de tela, aprovados pelo fundador como estão (2026-11-21, "1. A 2. A 3. A 4. A 5. A"). A tabela inteira, com a origem de cada texto, está no comentário abaixo. Os textos novos, que o cartão não dava:

  • Filtros: a opção "Agentes" (todos os agentes salvos), as quatro opções de Resultado e o título "Filtros" da folha do celular.
  • Lista: "hoje, 10:02" / "ontem, 18:40", "num Projeto apagado", "Conexão apagada · {operação}" e "Consulta" (a consulta sem tabela).
  • Linha aberta: os campos Quem, Agente, Conversa, Tabelas ou Operação, Consulta, Resultado, Linhas e Tempo ("40 ms"); "Projeto: no Projeto {nome}" para o app.
  • Exportar: o período padrão (os últimos 31 dias), o arquivo registro-de-dados-{de}-{até}.csv, as colunas, a hora em UTC, vírgula e BOM.
  • Resultado da consulta de um app que o banco recusa (o código do PostgreSQL, como 42501): Recusada (fundador, 2026-11-21, "3. A"; o critério 78 foi emendado). A classe 08, a conexão que não chegou, continua Não lida.

Tradeoffs

  • A U9 passou da medida do cartão: cerca de 756 linhas de código (sem testes, comentários nem linhas em branco) contra ~300. Pesam a folha de filtros do celular, o diálogo de Exportar e os cinco endereços de conversa. A U8 tem ~270 contra ~250 (as rotas, o contrato e as consultas de record.ts).
  • next é o Next (END/MORE) de todas as listas, que o Pager lê, no lugar do PageToken.nullable() do esboço.
  • A W32 do guia web ainda diz "each person's own readings". A troca fica para o PR de método (delivery L20).

Blast Radius

packages/hub-api ganha duas operações e CompanyMay.readDataReads (L27: a trilha Agentes e Apps não tem etapa nesses arquivos). Os papéis Dono e Administrador ganham o recurso dataRead. A migração só troca índices de data.data_read.

Verification

  • npm run check: tudo verde, salvo check:workflows, que precisa de um daemon Docker que esta máquina não tem.
  • Servidor no PostgreSQL 18 local: reads.test.ts, reads-export.test.ts, record.test.ts e os testes de identidade e de status que comparam may (51/51). Web: vitest 1632/1632 e hub.test.ts.
  • Varredura das 6 telas do Registro a 1366, 390 e 320 px nos dois temas: 42/42. As capturas a 1280, 1366 e 390 px estão com o firstmate.
  • Mutações à mão: 20 de 20 mortas, as da revisão incluídas (o desempate por id, agora provado sem os índices; o período meio aberto; a volta à primeira página). A lista está nos comentários.
  • Rodada da revisão (B1 e os Fechamentos 1 a 9): um dono só dos agentes e verbos no contrato; drizzle-kit generate diz que o esquema não muda.
  • Não provado: o Hub no ar com uma leitura de verdade (a QA, T25) e impeccable detect, que não está instalado nesta máquina.

Generated by Claude Code

Copy link
Copy Markdown
Collaborator Author

G4 do Registro: os textos de tela para aprovar

Os textos que o cartão já deu (P3 (a), P7 (a), P8 e a matriz de estados) e os que a tela precisou e o
cartão não dava (marcados novo). O firstmate decidiu E1 a E4 (2026-11-21); "num Projeto apagado" e as
quatro opções do filtro vêm de E2 (a) e E3 (a).

Configurações

Onde Texto De onde
O item no índice, no grupo da empresa, depois de Papéis Registro de dados cartão, D2 (a)
A frase sob o título Cada leitura que um agente ou um app fez, sem o resultado. desenho de caixas do cartão
As palavras da busca do índice registro, leitura, auditoria, agente, consulta, exportar novo

A lista (p4-04)

Onde Texto De onde
As colunas Quando, Quem, Agente, O que foi lido, Resultado, Linhas spec parte 4, 9.3
Quando "hoje, 10:02", "ontem, 18:40" ou "17/10/2026, 09:00" novo (o desenho mostra "hoje 10:02")
Agente Assistente, Builder, Construtor, App, o nome do agente salvo cartão
Agente salvo que a empresa não tem mais Agente apagado spec parte 4, 9.3
Sob o agente no Projeto {nome} P7 (a)
Sob o agente, Projeto apagado num Projeto apagado novo, E2 (a)
O que foi lido, leitura ao vivo {conexão} · {operação} spec parte 4, 9.3
O que foi lido, conexão apagada Conexão apagada · {operação} novo
O que foi lido, consulta sem tabela (a do app, a recusada) Consulta novo
Resultado (o código no title) Lida, Não encontrada, Recusada, Não lida P3 (a)
Linhas, sem contagem – desenho de caixas
Ver mais Primeira página, Ver mais o Pager de hoje

Os filtros

Onde Texto De onde
Os rótulos Pessoa, Agente, Tabela, Resultado desenho de caixas
Sem filtro Todas (Pessoa, Tabela), Todos (Agente, Resultado) P8
As opções de Agente Assistente, Builder, Construtor, Agentes, App novo: "Agentes" para todos os agentes salvos
As opções de Resultado Lida, Não encontrada, Recusada, Não lida novo, E3 (a)
No celular, o botão Filtros, ou Filtros (2) com dois ligados desenho de caixas
No celular, a folha o título "Filtros", Limpar os filtros, Ver as leituras P8 (o título é novo)

A linha aberta (p4-05)

Onde Texto De onde
O título Leitura de hoje, 10:02 P8
Os campos Quem, Agente, Conversa, Tabelas (ou Operação), Consulta, Resultado, Linhas, Tempo critério 79 (os nomes são novos)
Conversa no Início, no Projeto {nome}, num Projeto apagado P7 (a), E2 (a)
A leitura do app, sem conversa Projeto: no Projeto {nome} novo
O botão, só na leitura de quem olha Abrir a conversa critério 79, E4 (a)
A consulta Copiar a consulta, Consulta copiada, "Não deu para copiar. Selecione a consulta e copie." os de hoje, da conversa
Tempo 40 ms novo
Fechar Fechar o de hoje
Uma leitura fora da página, pelo endereço Leitura não encontrada. matriz de estados

Os estados (p4-06)

Estado Texto De onde
Vazio Nenhuma leitura ainda. / Cada leitura que um agente ou um app fizer do dado da empresa aparece aqui, sem o resultado. matriz de estados
Filtrado sem nada Nenhuma leitura com esses filtros. / Limpar os filtros matriz de estados
Erro Não deu para ler o registro agora. / Tentar de novo critério 81
Sem permissão a página de não encontrado de hoje matriz de estados

Exportar

Onde Texto De onde
O botão e o título do diálogo Exportar P8
A frase As leituras dos filtros de agora, num arquivo CSV. No máximo 31 dias por vez. P8
Os campos De, Até (o padrão: os últimos 31 dias, até hoje) P8 (o padrão é novo)
Pendente Exportando… matriz de estados
Mais de 5.000 As 5.000 leituras mais novas. P8
O Hub calado a frase do Hub, ao lado do botão matriz de estados
O arquivo registro-de-dados-{de}-{até}.csv novo (a spec dizia registro-de-dados.csv)
As colunas do arquivo Quando, Quem, Agente, Onde, O que foi lido, Resultado, Código, Linhas, Tempo (ms), Consulta novo
A hora no arquivo como o Hub a grava, em UTC (2026-11-21T13:02:00.000Z) novo
O separador vírgula (RFC 4180), com a marca BOM para a planilha ler os acentos novo

As mutações à mão (testing T27)

# Linha Mudança Teste dono Resultado
M1 hub/data/reads.ts, admitted admitir por seeData reads.test.ts, "só Dono e Administrador leem o Registro" morta
M2 hub/data/record.ts, NEWEST_FIRST ordenar só por hora reads.test.ts, "o dono lê todas, por página, sem repetir" sobrevive, equivalente: o índice (company_id, at desc, id desc) já devolve os empates por id; o id desc explícito mantém a ordem num plano sem o índice
M3 hub-api/data-reads.ts, withinExport aceitar 32 dias reads-export.test.ts, "a exportação leva no máximo 31 dias" morta
M4 hub/data/record.ts, kept tirar o filtro table reads.test.ts, "os filtros recortam" morta
M5 hub/data/record.ts, outcomeIs NOT_READ exclui só os lidos reads.test.ts, "os filtros recortam" morta
M6 hub/data/reads.ts, complete < no lugar de <= reads-export.test.ts, "a exportação para em 5.000" morta
M7 hub/data/reads.ts, entriesOf o nome do Projeto sempre nulo reads.test.ts, "os nomes vêm num lote" morta
W1 rota settings/data-reads.tsx tirar needs: 'readDataReads' data-reads.test.tsx, "o item só para quem administra" morta
W2 rota settings/data-reads.tsx tirar o notFound() do loader o mesmo morta
W3 hub/data/csv.ts, cellOf tirar o apóstrofo csv.test.tsx, "o CSV desarma fórmula" morta
W4 hub/data/read-detail.tsx Abrir a conversa para qualquer leitura data-reads.test.tsx, "a linha aberta" morta
W5 hub-api/data-reads.ts, OUTCOMES_OF QUERY_REFUSED fora de Recusada data-reads.test.tsx, "a lista e o filtro no endereço" morta
W6 hub/data/export-reads.tsx to sem o dia seguinte ao "Até" export-reads.test.tsx, "Exportar: o período…" morta
W7 hub/data/export-reads.tsx não limitar a 31 dias o mesmo morta

As capturas

44 capturas (a lista, a linha aberta, vazio, filtrado sem nada, o Hub calado, Exportar, os filtros no celular e o membro pelo endereço, a 1280, 1366 e 390 px, nos dois temas), tiradas pela varredura do repositório (apps/web/layout-harness.ts) com as respostas de apps/web/sweep-data-reads-states.ts. Ficam com o firstmate, fora do repositório (delivery L21). O campo de data segue a língua do navegador; nas capturas, o navegador sem cabeça está em inglês e mostra 10/22/2026.

Na varredura, o campo de data mostrou que o botão de calendário do Chromium é uma parada do Tab dentro do campo, onde o campo deixa de casar com :focus-visible e com :focus. Os dois campos de data desenham o halo em :focus-within (design V28).


Generated by Claude Code

@chatgpt-codex-connector

Copy link
Copy Markdown
Codex Review Summary: ❌ Failed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ❌ Failed 2026-11-21T18:11:57.633899Z
We couldn’t complete this review. Comment @codex review to try again.
d006c5c PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

Copy link
Copy Markdown
Collaborator Author

A rodada da revisão (dd0a1d30)

B1. DATA_READ_AGENTS e DATA_READ_VERBS moram em packages/hub-api/src/data-reads.ts, e DataReadAgent e verb derivam delas. apps/server/src/hub/data/tables.ts as importa, como connectors/tables.ts faz com CONNECTION_STATES, e record.ts tira o tipo do agente do contrato. tsc está limpo, e drizzle-kit generate diz "No schema changes, nothing to migrate".

Fechamento O que mudou Prova
1 reads.test.ts, "sem os índices, a mesma hora segue pelo id, de uma página à outra": o teste apaga os dois índices novos no banco descartável do próprio teste e passa de uma página à outra, com 52 leituras na mesma hora M2 (ordenar só por hora) agora morre
2 reads-export.test.ts, "o período é meio aberto": uma leitura no instante de to fica de fora; a mesma, em from, entra M8 (at <= to) morre
3 data-reads.test.tsx, "a lista e o filtro no endereço", agora aberto em ?page=abc W8 (o filtro guarda page) morre
4 data-reads.test.tsx, "carregando", e export-reads.test.tsx, "Exportar pendente" (o botão desligado e um pedido só) W9 (sem pendingComponent) e W10 (sem "Exportando…") morrem
5 apps/web/src/platform/download.ts, saveBlob(blob, name), que shown-file.tsx e csv.ts usam os testes de shown-file (file.test.tsx, file-failures.test.tsx) passam
6 a tela lê verb === 'LIVE' (text.ts, read-detail.tsx) W11 morre
7 after() de apps/server/src/platform/pages.ts ganha direction (ASC por padrão, e os seis chamadores ficam como estão); pageOfReads usa 'DESC' M9 (sem 'DESC') morre; projects.test.ts, companies.test.ts e memberships.test.ts passam, 21/21
8 o foco do campo de data mora em ui/input.tsx, para type="date"; saem os 4 avisos do oxlint a varredura do Registro, 42/42
9 o corpo do PR nomeia sweep-role-list.ts, sweep-states.ts e os arquivos desta rodada, e diz o nome csv.test.tsx —

O Fechamento 10 entrou na lista de textos do corpo como pergunta ao fundador. O 11 e o 12 ficam para o fechamento do cartão e para o PR de método.

Rodado: os testes do Registro no servidor, 19/19; o Vitest de src/hub/data, do arquivo da conversa e de src/ui, 62/62; a varredura do Registro, 42/42; npm run check, verde salvo check:workflows (sem Docker nesta máquina).


Generated by Claude Code

reviewer added 4 commits November 21, 2026 18:52
listDataReads e exportDataReads admitem pela ação readDataReads da tabela de
admissão, como Papéis (D1 (a)); quem não a tem recebe 404 NOT_FOUND (S10).
A página vai por chave (hora, id), da mais nova; a exportação leva um período
de até 31 dias, em instantes (E1 (a), code C40), e para em 5.000. O filtro
Resultado tem as quatro palavras do P3 (E3 (a)); um Projeto apagado volta sem
nome (E2 (a)). As consultas de leitura ficam em record.ts, o único arquivo que
importa a tabela (E5 (a), critério 9). Os índices (empresa, hora, id) e
(empresa, pessoa, hora, id) substituem o de (empresa, hora) (R.11).
Só Dono e Administrador têm o item, no grupo da empresa depois de Papéis, e o
endereço dá a página de não encontrado aos outros (D1 (a), D2 (a)). A lista de
50 por página tem os filtros no endereço, as palavras do Resultado do P3 (a) e
"no Projeto {nome}" sob o agente (P7 (a)); a linha aberta num painel traz a
consulta com Copiar a consulta, e Abrir a conversa só na leitura de quem olha
(E4 (a)). Exportar monta um CSV de até 31 dias na tela, com a fórmula
desarmada e "As 5.000 leituras mais novas." quando a resposta para no teto (P8).
…amentos da revisão

B1: DATA_READ_AGENTS e DATA_READ_VERBS moram no contrato; a tabela do Hub e
o esquema da resposta leem as mesmas (code C26). Fechamentos da revisão:
- o desempate por id provado sem os índices, e o período meio aberto;
- mudar um filtro volta à primeira página, carregando e Exportando… com teste;
- um saveBlob só, para o arquivo da conversa e o CSV;
- a tela lê verb para a leitura ao vivo;
- after() de platform/pages.ts ganha a direção, e a página do Registro a usa;
- o foco do campo de data mora em ui/input.tsx.
Resposta do fundador à pergunta do fechamento 10 da revisão do G4 ("3. A"): o
código do PostgreSQL que a borda grava quando o banco recusa a consulta de um
app é Recusada, na lista e no filtro; a classe 08, a conexão que não chegou
(08000 da borda), continua Não lida. Um dono só da regra, REFUSED_BY_DATABASE
no contrato, lido pela tela e pelo PostgreSQL. O critério 78 do cartão passa a
dizer isso.
@leandrotcawork
leandrotcawork force-pushed the feat/conexus-registro-g4 branch from dd0a1d3 to ac5937a Compare November 21, 2026 18:59
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012gWBFUCp42GkXrzUfg8PLE
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant