@trismegisto/spine 2.0.0 → 2.1.0

package/fesm2022/trismegisto-spine-auto-service-apps.technical-ClMKB9cK.mjs

@@ -0,0 +1,48 @@
+// Especificação técnica da tela Aplicações do auto-serviço (`RouteDocument.loadTechnical`), em Markdown. Módulo próprio,
+// carregado só pelo `import()` de `AUTO_SERVICE_DOCUMENTS`: vira um chunk à parte no FESM e fica fora do
+// bundle inicial. Não importe estaticamente nem reexporte no `public-api.ts`.
+var apps_technical = `# Aplicações — especificação técnica
+
+Tela \`AutoServiceComponent\` (seletor de client + \`AutoServiceAppsComponent\`), ligada ao router de template
+\`AUTO_SERVICE_APPS_TEMPLATE_ROUTER_ID\` (\`ad100002-…\`). Fala com o argos-admin-server em \`{adminApi}/auto-service\`
+(\`AutoServiceService\`), com o token no cabeçalho \`x-access-token\`.
+
+## Endpoints
+
+| Ação | Endpoint |
+| --- | --- |
+| Clients que a pessoa administra | \`GET /auto-service\` |
+| Aplicações do projeto do client | \`GET /auto-service/:clientId/apps\` |
+| Cadastrar (devolve o \`secret\`) | \`POST /auto-service/:clientId/apps\` (\`{ name, allowed_grants }\`) |
+| Editar / ativar / desativar | \`PUT /auto-service/:clientId/apps/:appId\` (\`{ name, allowed_grants, enabled }\` ou só \`{ enabled }\`) |
+| Excluir | \`DELETE /auto-service/:clientId/apps/:appId\` |
+| Operações registradas | \`GET /auto-service/:clientId/apps/:appId/operations\` |
+| Grupos com acesso (consumers) | \`GET /auto-service/:clientId/apps/:appId/consumers\` |
+| Grupos oferecidos em "Novo acesso" | \`GET /auto-service/:clientId/groups\` |
+| Novo acesso | \`POST /auto-service/:clientId/apps/:appId/consumers\` (\`{ group_id }\`) |
+| Remover acesso | \`DELETE /auto-service/:clientId/apps/consumers/:consumerId\` |
+| Operações liberadas ao grupo | \`GET /auto-service/:clientId/apps/consumers/:consumerId/permissions\` |
+| Liberar / retirar operação | \`POST .../consumers/:consumerId/permissions\` (\`{ operation_id }\`) / \`DELETE .../permissions/:permissionId\` |
+
+## Regras
+
+- **Autorização** (\`clientAdminGuard\`): grupo que administra o projeto do client + crachá Administrador ativo.
+  App, consumer ou grupo de outro client responde 404, nunca 403 (\`assertAppBelongsToClient\`,
+  \`assertConsumerBelongsToClient\`, \`assertBodyGroupBelongsToClient\`).
+- O \`secret\` só vem na resposta do \`POST\`; a tela mostra num \`hm-alert\` até ser fechado e não o guarda.
+- Grants: texto separado por vírgula, enviado como lista (\`allowed_grants\`) sem itens vazios.
+- **Excluir** passa por \`HermesDialogService.confirm\` (perigo, com o nome da aplicação) e **Remover** (acesso) pelo
+  \`confirm\` da ação no \`hm-data-grid\`; só depois do sim sai o \`DELETE\`. Sucesso e falha viram toast
+  (\`AutoServiceDeleteFeedback\`: \`deleteDone\`, ou o \`detail\` do servidor / \`deleteError\`). **Ativar/Desativar** chama o
+  servidor direto (reversível).
+- O \`secret\` exibido some ao trocar de client e ao excluir a aplicação.
+- Ids nos caminhos vão codificados (\`urlPath\` de \`@trismegisto/primitives\`).
+- As abas são preguiçosas (\`*hmTabContent\`): cada uma só busca ao ser aberta. Consultar outra aplicação volta para
+  **Operações**.
+- **Gerenciar operações** cruza \`operations\` com \`permissions\` (por \`operation_id\`) e grava só a diferença, em
+  sequência: primeiro as liberações, depois as retiradas.
+- A auditoria das aplicações tem tela própria (Auditoria, \`ad100004-…\`).
+`;
+
+export { apps_technical as default };
+//# sourceMappingURL=trismegisto-spine-auto-service-apps.technical-ClMKB9cK.mjs.map

package/fesm2022/trismegisto-spine-auto-service-apps.technical-ClMKB9cK.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trismegisto-spine-auto-service-apps.technical-ClMKB9cK.mjs","sources":["../../../projects/ui/auto-service/src/docs/apps.technical.ts"],"sourcesContent":["// Especificação técnica da tela Aplicações do auto-serviço (`RouteDocument.loadTechnical`), em Markdown. Módulo próprio,\n// carregado só pelo `import()` de `AUTO_SERVICE_DOCUMENTS`: vira um chunk à parte no FESM e fica fora do\n// bundle inicial. Não importe estaticamente nem reexporte no `public-api.ts`.\nexport default `# Aplicações — especificação técnica\n\nTela \\`AutoServiceComponent\\` (seletor de client + \\`AutoServiceAppsComponent\\`), ligada ao router de template\n\\`AUTO_SERVICE_APPS_TEMPLATE_ROUTER_ID\\` (\\`ad100002-…\\`). Fala com o argos-admin-server em \\`{adminApi}/auto-service\\`\n(\\`AutoServiceService\\`), com o token no cabeçalho \\`x-access-token\\`.\n\n## Endpoints\n\n| Ação | Endpoint |\n| --- | --- |\n| Clients que a pessoa administra | \\`GET /auto-service\\` |\n| Aplicações do projeto do client | \\`GET /auto-service/:clientId/apps\\` |\n| Cadastrar (devolve o \\`secret\\`) | \\`POST /auto-service/:clientId/apps\\` (\\`{ name, allowed_grants }\\`) |\n| Editar / ativar / desativar | \\`PUT /auto-service/:clientId/apps/:appId\\` (\\`{ name, allowed_grants, enabled }\\` ou só \\`{ enabled }\\`) |\n| Excluir | \\`DELETE /auto-service/:clientId/apps/:appId\\` |\n| Operações registradas | \\`GET /auto-service/:clientId/apps/:appId/operations\\` |\n| Grupos com acesso (consumers) | \\`GET /auto-service/:clientId/apps/:appId/consumers\\` |\n| Grupos oferecidos em \"Novo acesso\" | \\`GET /auto-service/:clientId/groups\\` |\n| Novo acesso | \\`POST /auto-service/:clientId/apps/:appId/consumers\\` (\\`{ group_id }\\`) |\n| Remover acesso | \\`DELETE /auto-service/:clientId/apps/consumers/:consumerId\\` |\n| Operações liberadas ao grupo | \\`GET /auto-service/:clientId/apps/consumers/:consumerId/permissions\\` |\n| Liberar / retirar operação | \\`POST .../consumers/:consumerId/permissions\\` (\\`{ operation_id }\\`) / \\`DELETE .../permissions/:permissionId\\` |\n\n## Regras\n\n- **Autorização** (\\`clientAdminGuard\\`): grupo que administra o projeto do client + crachá Administrador ativo.\n  App, consumer ou grupo de outro client responde 404, nunca 403 (\\`assertAppBelongsToClient\\`,\n  \\`assertConsumerBelongsToClient\\`, \\`assertBodyGroupBelongsToClient\\`).\n- O \\`secret\\` só vem na resposta do \\`POST\\`; a tela mostra num \\`hm-alert\\` até ser fechado e não o guarda.\n- Grants: texto separado por vírgula, enviado como lista (\\`allowed_grants\\`) sem itens vazios.\n- **Excluir** passa por \\`HermesDialogService.confirm\\` (perigo, com o nome da aplicação) e **Remover** (acesso) pelo\n  \\`confirm\\` da ação no \\`hm-data-grid\\`; só depois do sim sai o \\`DELETE\\`. Sucesso e falha viram toast\n  (\\`AutoServiceDeleteFeedback\\`: \\`deleteDone\\`, ou o \\`detail\\` do servidor / \\`deleteError\\`). **Ativar/Desativar** chama o\n  servidor direto (reversível).\n- O \\`secret\\` exibido some ao trocar de client e ao excluir a aplicação.\n- Ids nos caminhos vão codificados (\\`urlPath\\` de \\`@trismegisto/primitives\\`).\n- As abas são preguiçosas (\\`*hmTabContent\\`): cada uma só busca ao ser aberta. Consultar outra aplicação volta para\n  **Operações**.\n- **Gerenciar operações** cruza \\`operations\\` com \\`permissions\\` (por \\`operation_id\\`) e grava só a diferença, em\n  sequência: primeiro as liberações, depois as retiradas.\n- A auditoria das aplicações tem tela própria (Auditoria, \\`ad100004-…\\`).\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,qBAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCd;;"}

package/fesm2022/trismegisto-spine-auto-service-apps.usage-Cf5SG-oQ.mjs

@@ -0,0 +1,55 @@
+// Manual de uso da tela Aplicações do auto-serviço (`RouteDocument.load`), em Markdown. Módulo próprio,
+// carregado só pelo `import()` de `AUTO_SERVICE_DOCUMENTS`: vira um chunk à parte no FESM e fica fora do
+// bundle inicial. Não importe estaticamente nem reexporte no `public-api.ts`.
+var apps_usage = `# Aplicações
+
+Gerencie as aplicações (credenciais \`client_credentials\`) do projeto do seu client, sem depender do painel
+central: cadastre, ative ou desative e exclua aplicações, veja as operações que cada uma registra e defina quais
+grupos podem chamar quais operações.
+
+## Antes de começar
+
+A escolha do client funciona como nas outras telas do auto-serviço: com um client só, ele já vem escolhido; com
+mais de um, escolha em **Selecione o client que deseja administrar**. É preciso estar com o crachá
+**Administrador** ativo.
+
+## Como usar
+
+1. Para criar uma aplicação, clique em **Cadastrar**. No modal **Nova aplicação**, preencha o **Nome**
+   (obrigatório) e os **Grants** (separados por vírgula; já vem \`client_credentials\`) e clique em **Salvar**.
+2. Ao criar, aparece no topo da tela o aviso **Aplicação criada** com o secret. **Copie e guarde o secret na hora:
+   ele não é exibido de novo.** O aviso some quando você o fecha, troca de client ou exclui a aplicação.
+3. Para trabalhar numa aplicação, escolha-a em **Selecione uma aplicação** e clique em **Consultar**.
+4. O cartão da aplicação mostra o nome, a situação (**Ativo** ou **Inativo**) e os grants. Ações:
+   - **Editar**: muda nome, grants e a caixa **Ativo**.
+   - **Desativar** / **Ativar**: liga ou desliga a aplicação sem apagar nada.
+   - **Excluir**: abre a confirmação **Excluir aplicação?** com o nome dela; só depois de **Excluir** no diálogo a
+     aplicação é apagada e a credencial dela para de funcionar. **Cancelar** (ou Esc) não muda nada.
+
+> **Desativar** age na hora e se desfaz com **Ativar**. **Excluir** não tem volta: na dúvida, desative. Depois de
+> excluir aparece a mensagem **Exclusão concluída.**; se o servidor recusar, a mensagem de erro diz o motivo e a
+> aplicação continua na tela.
+
+## Aba Operações
+
+Lista, só para consulta, as operações registradas pela aplicação: **Identificador**, **Método**, **Nível** (o selo
+fica verde para operação pública e amarelo para protegida), **Descrição** e **Grupos permitidos** (quantos grupos já
+podem chamar a operação). A tela não cria nem edita operações.
+
+## Aba Acessos
+
+Mostra os grupos que têm acesso à aplicação (**Grupo** e **Tipo**).
+
+- **Novo acesso**: escolha o **Grupo** e clique em **Criar**. Só aparecem os grupos do seu client.
+- No menu de cada linha:
+  - **Gerenciar operações** abre o painel **Operações de nome do grupo**, com uma caixa por operação
+    (identificador, método, nível e descrição). Marque o que o grupo pode chamar, desmarque o que não pode e clique
+    em **Confirmar alterações** (o botão só habilita quando algo mudou). **Cancelar** descarta.
+  - **Remover** pede confirmação (**Remover acesso à aplicação?**, com o nome do grupo) e só então tira o acesso do
+    grupo à aplicação e as permissões de operação dele.
+
+Depois de criar o acesso, use **Gerenciar operações** para escolher o que o grupo pode chamar.
+`;
+
+export { apps_usage as default };
+//# sourceMappingURL=trismegisto-spine-auto-service-apps.usage-Cf5SG-oQ.mjs.map

package/fesm2022/trismegisto-spine-auto-service-apps.usage-Cf5SG-oQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trismegisto-spine-auto-service-apps.usage-Cf5SG-oQ.mjs","sources":["../../../projects/ui/auto-service/src/docs/apps.usage.ts"],"sourcesContent":["// Manual de uso da tela Aplicações do auto-serviço (`RouteDocument.load`), em Markdown. Módulo próprio,\n// carregado só pelo `import()` de `AUTO_SERVICE_DOCUMENTS`: vira um chunk à parte no FESM e fica fora do\n// bundle inicial. Não importe estaticamente nem reexporte no `public-api.ts`.\nexport default `# Aplicações\n\nGerencie as aplicações (credenciais \\`client_credentials\\`) do projeto do seu client, sem depender do painel\ncentral: cadastre, ative ou desative e exclua aplicações, veja as operações que cada uma registra e defina quais\ngrupos podem chamar quais operações.\n\n## Antes de começar\n\nA escolha do client funciona como nas outras telas do auto-serviço: com um client só, ele já vem escolhido; com\nmais de um, escolha em **Selecione o client que deseja administrar**. É preciso estar com o crachá\n**Administrador** ativo.\n\n## Como usar\n\n1. Para criar uma aplicação, clique em **Cadastrar**. No modal **Nova aplicação**, preencha o **Nome**\n   (obrigatório) e os **Grants** (separados por vírgula; já vem \\`client_credentials\\`) e clique em **Salvar**.\n2. Ao criar, aparece no topo da tela o aviso **Aplicação criada** com o secret. **Copie e guarde o secret na hora:\n   ele não é exibido de novo.** O aviso some quando você o fecha, troca de client ou exclui a aplicação.\n3. Para trabalhar numa aplicação, escolha-a em **Selecione uma aplicação** e clique em **Consultar**.\n4. O cartão da aplicação mostra o nome, a situação (**Ativo** ou **Inativo**) e os grants. Ações:\n   - **Editar**: muda nome, grants e a caixa **Ativo**.\n   - **Desativar** / **Ativar**: liga ou desliga a aplicação sem apagar nada.\n   - **Excluir**: abre a confirmação **Excluir aplicação?** com o nome dela; só depois de **Excluir** no diálogo a\n     aplicação é apagada e a credencial dela para de funcionar. **Cancelar** (ou Esc) não muda nada.\n\n> **Desativar** age na hora e se desfaz com **Ativar**. **Excluir** não tem volta: na dúvida, desative. Depois de\n> excluir aparece a mensagem **Exclusão concluída.**; se o servidor recusar, a mensagem de erro diz o motivo e a\n> aplicação continua na tela.\n\n## Aba Operações\n\nLista, só para consulta, as operações registradas pela aplicação: **Identificador**, **Método**, **Nível** (o selo\nfica verde para operação pública e amarelo para protegida), **Descrição** e **Grupos permitidos** (quantos grupos já\npodem chamar a operação). A tela não cria nem edita operações.\n\n## Aba Acessos\n\nMostra os grupos que têm acesso à aplicação (**Grupo** e **Tipo**).\n\n- **Novo acesso**: escolha o **Grupo** e clique em **Criar**. Só aparecem os grupos do seu client.\n- No menu de cada linha:\n  - **Gerenciar operações** abre o painel **Operações de nome do grupo**, com uma caixa por operação\n    (identificador, método, nível e descrição). Marque o que o grupo pode chamar, desmarque o que não pode e clique\n    em **Confirmar alterações** (o botão só habilita quando algo mudou). **Cancelar** descarta.\n  - **Remover** pede confirmação (**Remover acesso à aplicação?**, com o nome do grupo) e só então tira o acesso do\n    grupo à aplicação e as permissões de operação dele.\n\nDepois de criar o acesso, use **Gerenciar operações** para escolher o que o grupo pode chamar.\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,iBAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDd;;"}

package/fesm2022/trismegisto-spine-auto-service-audit.technical-C901aIIQ.mjs

@@ -0,0 +1,42 @@
+// Especificação técnica da tela Auditoria do auto-serviço (`RouteDocument.loadTechnical`), em Markdown. Módulo próprio,
+// carregado só pelo `import()` de `AUTO_SERVICE_DOCUMENTS`: vira um chunk à parte no FESM e fica fora do
+// bundle inicial. Não importe estaticamente nem reexporte no `public-api.ts`.
+var audit_technical = `# Auditoria — especificação técnica
+
+Tela \`AutoServiceAuditComponent\`, ligada ao router de template \`AUTO_SERVICE_AUDIT_TEMPLATE_ROUTER_ID\`
+(\`ad100004-…\`): o seletor de client + \`SpineAuditComponent\` (\`@trismegisto/spine/audit\`) com \`scope="client"\`. É a
+mesma tela do painel central do Argos (\`scope="admin"\`); só muda a base dos endpoints.
+
+## Endpoints
+
+Base: \`{adminApi}/auto-service/:clientId/audit\` (\`SpineAuditService\`, token em \`x-access-token\`).
+
+| Ação | Endpoint |
+| --- | --- |
+| Clients que a pessoa administra | \`GET /auto-service\` |
+| Tabela por ações / por eventos | \`GET .../actions\` / \`GET .../events\` (cursor, \`limit\` = itens por página) |
+| Resumo e linha do tempo | \`GET .../stats?tops=false\` |
+| Rankings | \`GET .../tops/:kind\` (\`apps\`, \`operations\`, \`users\`; 5 por página) |
+| Detalhe do evento | \`GET .../events/:eventId?occurred_at=\` |
+| Cadeia (trace) | \`GET .../traces/:traceId?occurred_at=\` |
+| Aplicações do filtro | \`GET /auto-service/:clientId/apps\` |
+
+## Regras
+
+- **Autorização** (\`clientAdminGuard\`): grupo que administra o projeto do client + crachá Administrador ativo. O
+  recorte aos apps do projeto é do servidor (\`app_id IN\` apps do client); \`app_id\` de fora no filtro → 403, que a
+  tela mostra como "sem acesso à auditoria de uma das aplicações escolhidas".
+- Janela máxima de 31 dias, barrada antes de ir ao servidor (e \`range_too_large\` do servidor); filtro inválido
+  (\`invalid_filter\`) mostra o detalhe do servidor.
+- Período padrão 24 h; unidade padrão **Ações**. Datas da barra de filtros vencem o período rápido. Filtros salvos
+  ficam na chave \`spine-audit-client\`.
+- Atualização automática opcional a cada 30 s. Respostas fora de ordem (página, ranking, consulta ou detalhe já
+  trocados) são descartadas; trocar de página mantém as linhas à vista com indicador de progresso.
+- Coluna, filtro e ranking "por aplicação" só aparecem com mais de um app.
+- Eventos da cadeia de apps fora do projeto não vêm; o servidor informa a contagem (\`hidden_count\`).
+- A tela fica no ponto \`@trismegisto/spine/audit\`, importado só pelo chunk lazy desta página (o \`check-lazy\` do
+  build garante).
+`;
+
+export { audit_technical as default };
+//# sourceMappingURL=trismegisto-spine-auto-service-audit.technical-C901aIIQ.mjs.map

package/fesm2022/trismegisto-spine-auto-service-audit.technical-C901aIIQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trismegisto-spine-auto-service-audit.technical-C901aIIQ.mjs","sources":["../../../projects/ui/auto-service/src/docs/audit.technical.ts"],"sourcesContent":["// Especificação técnica da tela Auditoria do auto-serviço (`RouteDocument.loadTechnical`), em Markdown. Módulo próprio,\n// carregado só pelo `import()` de `AUTO_SERVICE_DOCUMENTS`: vira um chunk à parte no FESM e fica fora do\n// bundle inicial. Não importe estaticamente nem reexporte no `public-api.ts`.\nexport default `# Auditoria — especificação técnica\n\nTela \\`AutoServiceAuditComponent\\`, ligada ao router de template \\`AUTO_SERVICE_AUDIT_TEMPLATE_ROUTER_ID\\`\n(\\`ad100004-…\\`): o seletor de client + \\`SpineAuditComponent\\` (\\`@trismegisto/spine/audit\\`) com \\`scope=\"client\"\\`. É a\nmesma tela do painel central do Argos (\\`scope=\"admin\"\\`); só muda a base dos endpoints.\n\n## Endpoints\n\nBase: \\`{adminApi}/auto-service/:clientId/audit\\` (\\`SpineAuditService\\`, token em \\`x-access-token\\`).\n\n| Ação | Endpoint |\n| --- | --- |\n| Clients que a pessoa administra | \\`GET /auto-service\\` |\n| Tabela por ações / por eventos | \\`GET .../actions\\` / \\`GET .../events\\` (cursor, \\`limit\\` = itens por página) |\n| Resumo e linha do tempo | \\`GET .../stats?tops=false\\` |\n| Rankings | \\`GET .../tops/:kind\\` (\\`apps\\`, \\`operations\\`, \\`users\\`; 5 por página) |\n| Detalhe do evento | \\`GET .../events/:eventId?occurred_at=\\` |\n| Cadeia (trace) | \\`GET .../traces/:traceId?occurred_at=\\` |\n| Aplicações do filtro | \\`GET /auto-service/:clientId/apps\\` |\n\n## Regras\n\n- **Autorização** (\\`clientAdminGuard\\`): grupo que administra o projeto do client + crachá Administrador ativo. O\n  recorte aos apps do projeto é do servidor (\\`app_id IN\\` apps do client); \\`app_id\\` de fora no filtro → 403, que a\n  tela mostra como \"sem acesso à auditoria de uma das aplicações escolhidas\".\n- Janela máxima de 31 dias, barrada antes de ir ao servidor (e \\`range_too_large\\` do servidor); filtro inválido\n  (\\`invalid_filter\\`) mostra o detalhe do servidor.\n- Período padrão 24 h; unidade padrão **Ações**. Datas da barra de filtros vencem o período rápido. Filtros salvos\n  ficam na chave \\`spine-audit-client\\`.\n- Atualização automática opcional a cada 30 s. Respostas fora de ordem (página, ranking, consulta ou detalhe já\n  trocados) são descartadas; trocar de página mantém as linhas à vista com indicador de progresso.\n- Coluna, filtro e ranking \"por aplicação\" só aparecem com mais de um app.\n- Eventos da cadeia de apps fora do projeto não vêm; o servidor informa a contagem (\\`hidden_count\\`).\n- A tela fica no ponto \\`@trismegisto/spine/audit\\`, importado só pelo chunk lazy desta página (o \\`check-lazy\\` do\n  build garante).\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,sBAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCd;;"}

package/fesm2022/trismegisto-spine-auto-service-audit.usage-GIJ2RwuH.mjs

@@ -0,0 +1,63 @@
+// Manual de uso da tela Auditoria do auto-serviço (`RouteDocument.load`), em Markdown. Módulo próprio,
+// carregado só pelo `import()` de `AUTO_SERVICE_DOCUMENTS`: vira um chunk à parte no FESM e fica fora do
+// bundle inicial. Não importe estaticamente nem reexporte no `public-api.ts`.
+var audit_usage = `# Auditoria
+
+O que aconteceu nas aplicações do projeto do seu client: quem fez, o quê, quando e com que resultado. A tela é só
+de consulta: nada do que você faz aqui altera as aplicações.
+
+## Antes de começar
+
+A escolha do client funciona como nas outras telas do auto-serviço: com um client só, ele já vem escolhido; com
+mais de um, escolha em **Selecione o client que deseja administrar**. É preciso estar com o crachá
+**Administrador** ativo. Você só vê os registros das aplicações do projeto desse client.
+
+## Como usar
+
+1. **Ver por** escolhe a unidade da leitura:
+   - **Ações** (padrão): uma linha por ação da pessoa, juntando as chamadas que ela gerou entre aplicações. O
+     resultado da ação é o pior entre as etapas.
+   - **Eventos**: cada registro, um por linha.
+2. **Período**: **Última hora**, **Últimas 6 horas**, **Últimas 24 horas** (padrão), **Últimos 7 dias** ou **Últimos
+   30 dias**. Se você escolher datas no filtro **Datas**, elas valem no lugar do período (o período máximo é de 31
+   dias).
+3. **Atualizar** recarrega tudo; **Atualizar a cada 30 s** mantém a tela atualizando sozinha. O horário da última
+   atualização aparece ao lado.
+4. **Filtros**: Datas, Aplicação (quando há mais de uma), Usuário, Operação, Método, Resultado, Nível, Permissão,
+   Tipo de ator, Status HTTP, Trace e ID do usuário. **Só ações do usuário** aparece na leitura por **Eventos**. A
+   barra de filtros permite salvar combinações para usar de novo.
+5. **Resumo do período**: o total (de ações ou de eventos), **Falhas** e **Negados**. Clique em **Falhas** ou
+   **Negados** para filtrar a tabela por esse resultado; clique de novo para tirar o filtro.
+6. **Linha do tempo**: barras por intervalo, empilhando sucesso, falha e negado. Passe o mouse numa barra para ver
+   os números.
+7. **Operações mais chamadas**, **Usuários mais ativos** e, com mais de uma aplicação, **Por aplicação**: rankings de
+   5 em 5, com as setas para a página anterior e a próxima. Clique num item para filtrar por ele.
+8. A tabela lista o período, do mais recente para o mais antigo: **Quando**, **Aplicação** (com mais de uma),
+   **Usuário**, **Operação**, **Spans** (na leitura por ações), **Método**, **Resultado**, **HTTP** e **Duração**.
+   Escolha quantas linhas por página no rodapé.
+
+## Detalhe
+
+Clique numa linha para abrir o detalhe ao lado: quando, resultado, origem (**Ação do usuário** ou **Chamada entre
+aplicações**), aplicação, usuário, tipo de ator, IP de origem, operação, método, nível, permissão, status HTTP,
+duração, rota, alvo, mensagem e trace. Campos que não foram registrados não aparecem.
+
+- **Ver cadeia (trace)** mostra as etapas da ação numa linha do tempo, com a duração de cada uma. Clique numa etapa
+  para abrir o detalhe dela. Na leitura por ações, as etapas (spans) já aparecem no topo do detalhe.
+- **Filtrar a tabela por este trace** mostra na tabela só o que pertence a essa cadeia.
+- Etapas de aplicações fora do seu projeto não aparecem; um aviso diz quantas ficaram de fora.
+- O selo **sem entrada** marca uma ação cujo início não está no período (ou não foi registrado): ela aparece a
+  partir da primeira chamada entre aplicações.
+
+## Quando algo não carrega
+
+- **Nenhuma ação (ou evento) no período:** amplie o período ou use **Limpar filtros**.
+- **Não foi possível carregar a auditoria:** **Tentar de novo**.
+- **O período máximo é de 31 dias:** escolha datas mais próximas.
+- **Algum filtro tem um valor inválido:** a mensagem explica qual; corrija o filtro ou limpe os filtros.
+- **Você não tem acesso à auditoria de uma das aplicações escolhidas:** tire do filtro a aplicação que não é do
+  seu projeto.
+`;
+
+export { audit_usage as default };
+//# sourceMappingURL=trismegisto-spine-auto-service-audit.usage-GIJ2RwuH.mjs.map

package/fesm2022/trismegisto-spine-auto-service-audit.usage-GIJ2RwuH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trismegisto-spine-auto-service-audit.usage-GIJ2RwuH.mjs","sources":["../../../projects/ui/auto-service/src/docs/audit.usage.ts"],"sourcesContent":["// Manual de uso da tela Auditoria do auto-serviço (`RouteDocument.load`), em Markdown. Módulo próprio,\n// carregado só pelo `import()` de `AUTO_SERVICE_DOCUMENTS`: vira um chunk à parte no FESM e fica fora do\n// bundle inicial. Não importe estaticamente nem reexporte no `public-api.ts`.\nexport default `# Auditoria\n\nO que aconteceu nas aplicações do projeto do seu client: quem fez, o quê, quando e com que resultado. A tela é só\nde consulta: nada do que você faz aqui altera as aplicações.\n\n## Antes de começar\n\nA escolha do client funciona como nas outras telas do auto-serviço: com um client só, ele já vem escolhido; com\nmais de um, escolha em **Selecione o client que deseja administrar**. É preciso estar com o crachá\n**Administrador** ativo. Você só vê os registros das aplicações do projeto desse client.\n\n## Como usar\n\n1. **Ver por** escolhe a unidade da leitura:\n   - **Ações** (padrão): uma linha por ação da pessoa, juntando as chamadas que ela gerou entre aplicações. O\n     resultado da ação é o pior entre as etapas.\n   - **Eventos**: cada registro, um por linha.\n2. **Período**: **Última hora**, **Últimas 6 horas**, **Últimas 24 horas** (padrão), **Últimos 7 dias** ou **Últimos\n   30 dias**. Se você escolher datas no filtro **Datas**, elas valem no lugar do período (o período máximo é de 31\n   dias).\n3. **Atualizar** recarrega tudo; **Atualizar a cada 30 s** mantém a tela atualizando sozinha. O horário da última\n   atualização aparece ao lado.\n4. **Filtros**: Datas, Aplicação (quando há mais de uma), Usuário, Operação, Método, Resultado, Nível, Permissão,\n   Tipo de ator, Status HTTP, Trace e ID do usuário. **Só ações do usuário** aparece na leitura por **Eventos**. A\n   barra de filtros permite salvar combinações para usar de novo.\n5. **Resumo do período**: o total (de ações ou de eventos), **Falhas** e **Negados**. Clique em **Falhas** ou\n   **Negados** para filtrar a tabela por esse resultado; clique de novo para tirar o filtro.\n6. **Linha do tempo**: barras por intervalo, empilhando sucesso, falha e negado. Passe o mouse numa barra para ver\n   os números.\n7. **Operações mais chamadas**, **Usuários mais ativos** e, com mais de uma aplicação, **Por aplicação**: rankings de\n   5 em 5, com as setas para a página anterior e a próxima. Clique num item para filtrar por ele.\n8. A tabela lista o período, do mais recente para o mais antigo: **Quando**, **Aplicação** (com mais de uma),\n   **Usuário**, **Operação**, **Spans** (na leitura por ações), **Método**, **Resultado**, **HTTP** e **Duração**.\n   Escolha quantas linhas por página no rodapé.\n\n## Detalhe\n\nClique numa linha para abrir o detalhe ao lado: quando, resultado, origem (**Ação do usuário** ou **Chamada entre\naplicações**), aplicação, usuário, tipo de ator, IP de origem, operação, método, nível, permissão, status HTTP,\nduração, rota, alvo, mensagem e trace. Campos que não foram registrados não aparecem.\n\n- **Ver cadeia (trace)** mostra as etapas da ação numa linha do tempo, com a duração de cada uma. Clique numa etapa\n  para abrir o detalhe dela. Na leitura por ações, as etapas (spans) já aparecem no topo do detalhe.\n- **Filtrar a tabela por este trace** mostra na tabela só o que pertence a essa cadeia.\n- Etapas de aplicações fora do seu projeto não aparecem; um aviso diz quantas ficaram de fora.\n- O selo **sem entrada** marca uma ação cujo início não está no período (ou não foi registrado): ela aparece a\n  partir da primeira chamada entre aplicações.\n\n## Quando algo não carrega\n\n- **Nenhuma ação (ou evento) no período:** amplie o período ou use **Limpar filtros**.\n- **Não foi possível carregar a auditoria:** **Tentar de novo**.\n- **O período máximo é de 31 dias:** escolha datas mais próximas.\n- **Algum filtro tem um valor inválido:** a mensagem explica qual; corrija o filtro ou limpe os filtros.\n- **Você não tem acesso à auditoria de uma das aplicações escolhidas:** tire do filtro a aplicação que não é do\n  seu projeto.\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,kBAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDd;;"}