Repository navigation
feat(registro): o Registro de dados na tela, só para Dono e Administrador (G4) - #1209
Conversation
G4 do Registro: os textos de tela para aprovarOs 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 Configurações
A lista (
|
| 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
Codex Review Summary: ❌ FailedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
A rodada da revisão (
|
| 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
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.
dd0a1d3 to
ac5937a
Compare
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012gWBFUCp42GkXrzUfg8PLE
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
listDataReadseexportDataReads(packages/hub-api/src/data-reads.ts) admitem pela ação novareadDataReadsda tabela de admissão, como Papéis; quem não a tem recebe 404NOT_FOUND(S10).CompanyMay.readDataReadsvai para a tela.Scope
Decisões do firstmate durante a construção (delivery L6), com a evidência nos relatórios de
needs-decision:from/toda 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.project.name: null, e a tela diz "num Projeto apagado".OUTCOMES_OF,resultOf) serve o Hub e a tela.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.record.ts, o único arquivo que importa a tabela (critério 9).hub/data/record.ts,packages/hub-api/src/pages.ts,builder/agents/public.ts(exportaagentsQuery),hub/copies/public.tsecopy-proposal.tsx(exportamQueryBlock),biome.json(o ajudantehub/data/test-hub.tsxna lista dos que usam MSW),apps/web/sweep-role-list.tsesweep-states.ts(a resposta que o cartão dava emsweep-replies.tse 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.tsxeui/input.tsx. O critério 80 citacsv.test.ts; o arquivo écsv.test.tsx, porque só os testes.test.tsxrodam 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:
registro-de-dados-{de}-{até}.csv, as colunas, a hora em UTC, vírgula e BOM.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
record.ts).nexté oNext(END/MORE) de todas as listas, que oPagerlê, no lugar doPageToken.nullable()do esboço.Blast Radius
packages/hub-apiganha duas operações eCompanyMay.readDataReads(L27: a trilha Agentes e Apps não tem etapa nesses arquivos). Os papéis Dono e Administrador ganham o recursodataRead. A migração só troca índices dedata.data_read.Verification
npm run check: tudo verde, salvocheck:workflows, que precisa de um daemon Docker que esta máquina não tem.reads.test.ts,reads-export.test.ts,record.test.tse os testes de identidade e de status que comparammay(51/51). Web:vitest1632/1632 ehub.test.ts.drizzle-kit generatediz que o esquema não muda.impeccable detect, que não está instalado nesta máquina.Generated by Claude Code