@trismegisto/spine 3.3.0 → 3.3.2

package/fesm2022/trismegisto-spine-auto-service-home.usage-D9R_ZMuU.mjs

@@ -0,0 +1,48 @@
+// Manual de uso da tela Início 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 home_usage = `# Início
+
+Ponto de partida do sistema: uma saudação, atalhos para as telas que você pode abrir, as que você abriu por último,
+os módulos do sistema, as novidades, os seus favoritos e a ajuda (documentação, atalhos do teclado, o essencial e
+configurações).
+
+## Como usar
+
+1. Os blocos grandes levam às telas. O título do bloco é **Acesso rápido** quando os atalhos são os módulos do menu e
+   **Suas telas** quando o Início já desceu para as telas de dentro deles (isso acontece quando há só um ou dois
+   módulos: em vez de um bloco que só abre outro menu, você vê direto as telas). Abaixo do nome, o atalho mostra
+   quantas telas reúne (por exemplo, "3 telas") ou o caminho no menu onde a tela fica.
+2. **Acesso privilegiado** reúne, à parte, os atalhos das telas de administração do auto-serviço (**Grupos**,
+   **Aplicações**, **Cliente** e **Auditoria**), para não se misturarem às telas de trabalho do dia a dia.
+3. **Continuar de onde parou** lista as últimas telas abertas (4; **Ver tudo** mostra as 10 guardadas), da mais
+   recente para a mais antiga, com o caminho no menu e há quanto tempo você a abriu. Clique na linha para abrir; o
+   coração adiciona ou remove a tela dos favoritos; o menu ⋮ tira a tela do histórico.
+4. **Explorar sistemas** mostra cada módulo do menu que reúne mais de um item: a descrição (ou quantas telas tem), os
+   primeiros itens de dentro dele e **Ver módulos**, que abre a primeira tela.
+5. **Novidades** (só quando o sistema tem novidades para você) lista as últimas, com um ponto nas que você ainda não
+   abriu; clicar numa abre o texto dela, e **Ver todas** abre o painel de novidades.
+6. **Favoritos** lista as telas favoritadas, com o caminho no menu. Sem favoritos, o card explica como favoritar.
+7. **Ajuda e recursos** traz as áreas de topo do sistema (como o próprio Início), **Documentação do sistema** (o
+   manual de cada tela que você pode abrir), **Atalhos do teclado**, **Rever o essencial** e **Configurações** (tema,
+   densidade, atalhos e o resto das preferências).
+
+Recentes e favoritos ficam guardados neste navegador, separados por pessoa: quem entrar depois no mesmo computador
+não vê os seus. Ao sair do sistema, o histórico é apagado; os favoritos ficam para a próxima vez. As duas listas mostram
+só as telas que o seu acesso atual alcança: ao trocar de crachá, o que ele não abre sai da lista (sem ser esquecido) e
+volta quando o acesso volta. Pelo mesmo motivo, as abas abertas de telas que o crachá novo não alcança são fechadas.
+
+## Situações especiais
+
+- **Uma tela só:** se você tem acesso a uma única tela de trabalho, o Início abre essa tela direto. Isso acontece uma
+  vez por carregamento do sistema; se você voltar ao Início depois, ele aparece normalmente.
+- **Sem acesso:** se a sua conta ainda não tem nenhuma tela liberada, aparece o aviso "Você ainda não tem acesso a
+  nenhuma tela". O acesso é liberado pelo administrador da aplicação ou pelo administrador de um grupo com acesso a
+  ela; se ele já liberou, saia e entre de novo.
+
+> O que aparece no Início vem da sua árvore de navegação (as telas que os seus grupos e o seu crachá ativo
+> liberam). Trocar de crachá no menu do perfil pode mudar os atalhos.
+`;
+
+export { home_usage as default };
+//# sourceMappingURL=trismegisto-spine-auto-service-home.usage-D9R_ZMuU.mjs.map

package/fesm2022/trismegisto-spine-auto-service-home.usage-D9R_ZMuU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trismegisto-spine-auto-service-home.usage-D9R_ZMuU.mjs","sources":["../../../projects/ui/auto-service/src/docs/home.usage.ts"],"sourcesContent":["// Manual de uso da tela Início 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 `# Início\n\nPonto de partida do sistema: uma saudação, atalhos para as telas que você pode abrir, as que você abriu por último,\nos módulos do sistema, as novidades, os seus favoritos e a ajuda (documentação, atalhos do teclado, o essencial e\nconfigurações).\n\n## Como usar\n\n1. Os blocos grandes levam às telas. O título do bloco é **Acesso rápido** quando os atalhos são os módulos do menu e\n   **Suas telas** quando o Início já desceu para as telas de dentro deles (isso acontece quando há só um ou dois\n   módulos: em vez de um bloco que só abre outro menu, você vê direto as telas). Abaixo do nome, o atalho mostra\n   quantas telas reúne (por exemplo, \"3 telas\") ou o caminho no menu onde a tela fica.\n2. **Acesso privilegiado** reúne, à parte, os atalhos das telas de administração do auto-serviço (**Grupos**,\n   **Aplicações**, **Cliente** e **Auditoria**), para não se misturarem às telas de trabalho do dia a dia.\n3. **Continuar de onde parou** lista as últimas telas abertas (4; **Ver tudo** mostra as 10 guardadas), da mais\n   recente para a mais antiga, com o caminho no menu e há quanto tempo você a abriu. Clique na linha para abrir; o\n   coração adiciona ou remove a tela dos favoritos; o menu ⋮ tira a tela do histórico.\n4. **Explorar sistemas** mostra cada módulo do menu que reúne mais de um item: a descrição (ou quantas telas tem), os\n   primeiros itens de dentro dele e **Ver módulos**, que abre a primeira tela.\n5. **Novidades** (só quando o sistema tem novidades para você) lista as últimas, com um ponto nas que você ainda não\n   abriu; clicar numa abre o texto dela, e **Ver todas** abre o painel de novidades.\n6. **Favoritos** lista as telas favoritadas, com o caminho no menu. Sem favoritos, o card explica como favoritar.\n7. **Ajuda e recursos** traz as áreas de topo do sistema (como o próprio Início), **Documentação do sistema** (o\n   manual de cada tela que você pode abrir), **Atalhos do teclado**, **Rever o essencial** e **Configurações** (tema,\n   densidade, atalhos e o resto das preferências).\n\nRecentes e favoritos ficam guardados neste navegador, separados por pessoa: quem entrar depois no mesmo computador\nnão vê os seus. Ao sair do sistema, o histórico é apagado; os favoritos ficam para a próxima vez. As duas listas mostram\nsó as telas que o seu acesso atual alcança: ao trocar de crachá, o que ele não abre sai da lista (sem ser esquecido) e\nvolta quando o acesso volta. Pelo mesmo motivo, as abas abertas de telas que o crachá novo não alcança são fechadas.\n\n## Situações especiais\n\n- **Uma tela só:** se você tem acesso a uma única tela de trabalho, o Início abre essa tela direto. Isso acontece uma\n  vez por carregamento do sistema; se você voltar ao Início depois, ele aparece normalmente.\n- **Sem acesso:** se a sua conta ainda não tem nenhuma tela liberada, aparece o aviso \"Você ainda não tem acesso a\n  nenhuma tela\". O acesso é liberado pelo administrador da aplicação ou pelo administrador de um grupo com acesso a\n  ela; se ele já liberou, saia e entre de novo.\n\n> O que aparece no Início vem da sua árvore de navegação (as telas que os seus grupos e o seu crachá ativo\n> liberam). Trocar de crachá no menu do perfil pode mudar os atalhos.\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,iBAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCd;;"}

package/fesm2022/trismegisto-spine-auto-service-news.technical-DV9UpobG.mjs

@@ -0,0 +1,38 @@
+// Especificação técnica da tela Novidades 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 news_technical = `# Novidades — especificação técnica
+
+Tela \`AutoServiceNewsPageComponent\`, ligada ao router de template \`AUTO_SERVICE_NEWS_TEMPLATE_ROUTER_ID\`
+(\`ad100006-…\`, página \`app-news\` na raiz do menu, migration 0036 do argos): o seletor de client
+(\`AutoServiceClientPickerComponent\`) e, embaixo, o painel da tela. Fala com o argos-admin-server em
+\`{adminApi}/auto-service\`, com o token no cabeçalho \`x-access-token\`.
+
+## Endpoints
+
+| Ação | Endpoint |
+| --- | --- |
+| Clients que a pessoa administra | \`GET /auto-service\` |
+| Novidades (\`web.app_news\`) | \`GET / POST /auto-service/:clientId/news\` (\`page\`, \`limit\` até 100; agendadas e vencidas também, com \`status\`, \`groups\` e \`author\` com foto), \`GET / PUT / DELETE .../news/:newsId\` (o GET com \`body_html\`) |
+| Público oferecido numa novidade | \`GET /auto-service/:clientId/news/audience\` (grupos com acesso ao client, sem o de administração) |
+
+## Regras
+
+- **Autorização** (\`clientAdminGuard\`): grupo de administração do projeto do client + crachá Administrador ativo. O
+  \`client_id\` vem sempre da URL; 403 vira a mensagem de falta de acesso.
+- **Menu**: página privada, com os tipos permitidos e os guards que a tela Cliente tinha em cada client (a migration
+  copia); o painel só é montado depois que o client é escolhido.
+- **Tela** (\`AutoServiceNewsComponent\`, serviço próprio \`AutoServiceNewsService\`): grade paginada no servidor
+  (20 por página, sem filtro local), mais recentes primeiro; \`status\` (\`scheduled\`, \`published\`, \`expired\`) vem
+  calculado pelo banco. O corpo não vem na lista: **Editar** busca o detalhe e só libera o editor (\`hm-rich-text\`)
+  quando ele chega. Publicação = data + hora locais do navegador, gravada em ISO UTC (\`newsPublishedAt\`; sem data =
+  \`null\`, o servidor usa agora); \`until\` é o último dia (AAAA-MM-DD, exibido em UTC para não mudar de dia) e não pode
+  ficar antes do dia da publicação (aviso local, sem salvar). Público vazio = todos que entram no app; os grupos
+  oferecidos são os de \`.../news/audience\`, e grupo fora dele é 400 \`invalid_group_ids\`. O argos-admin saneia o
+  \`body_html\` (lista branca do \`hm-rich-text\`) antes de gravar; os códigos \`invalid_title\`, \`invalid_summary\`,
+  \`body_too_large\`, \`invalid_published_at\`, \`invalid_until\` e \`invalid_group_ids\` viram \`autoServiceNews.errors\`.
+  O que a pessoa vê é o \`/me/news\` (\`SpineNewsService\`): publicadas, na validade e do público dela.
+`;
+
+export { news_technical as default };
+//# sourceMappingURL=trismegisto-spine-auto-service-news.technical-DV9UpobG.mjs.map

package/fesm2022/trismegisto-spine-auto-service-news.technical-DV9UpobG.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trismegisto-spine-auto-service-news.technical-DV9UpobG.mjs","sources":["../../../projects/ui/auto-service/src/docs/news.technical.ts"],"sourcesContent":["// Especificação técnica da tela Novidades 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 bundle\n// inicial. Não importe estaticamente nem reexporte no `public-api.ts`.\nexport default `# Novidades — especificação técnica\n\nTela \\`AutoServiceNewsPageComponent\\`, ligada ao router de template \\`AUTO_SERVICE_NEWS_TEMPLATE_ROUTER_ID\\`\n(\\`ad100006-…\\`, página \\`app-news\\` na raiz do menu, migration 0036 do argos): o seletor de client\n(\\`AutoServiceClientPickerComponent\\`) e, embaixo, o painel da tela. Fala com o argos-admin-server em\n\\`{adminApi}/auto-service\\`, 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| Novidades (\\`web.app_news\\`) | \\`GET / POST /auto-service/:clientId/news\\` (\\`page\\`, \\`limit\\` até 100; agendadas e vencidas também, com \\`status\\`, \\`groups\\` e \\`author\\` com foto), \\`GET / PUT / DELETE .../news/:newsId\\` (o GET com \\`body_html\\`) |\n| Público oferecido numa novidade | \\`GET /auto-service/:clientId/news/audience\\` (grupos com acesso ao client, sem o de administração) |\n\n## Regras\n\n- **Autorização** (\\`clientAdminGuard\\`): grupo de administração do projeto do client + crachá Administrador ativo. O\n  \\`client_id\\` vem sempre da URL; 403 vira a mensagem de falta de acesso.\n- **Menu**: página privada, com os tipos permitidos e os guards que a tela Cliente tinha em cada client (a migration\n  copia); o painel só é montado depois que o client é escolhido.\n- **Tela** (\\`AutoServiceNewsComponent\\`, serviço próprio \\`AutoServiceNewsService\\`): grade paginada no servidor\n  (20 por página, sem filtro local), mais recentes primeiro; \\`status\\` (\\`scheduled\\`, \\`published\\`, \\`expired\\`) vem\n  calculado pelo banco. O corpo não vem na lista: **Editar** busca o detalhe e só libera o editor (\\`hm-rich-text\\`)\n  quando ele chega. Publicação = data + hora locais do navegador, gravada em ISO UTC (\\`newsPublishedAt\\`; sem data =\n  \\`null\\`, o servidor usa agora); \\`until\\` é o último dia (AAAA-MM-DD, exibido em UTC para não mudar de dia) e não pode\n  ficar antes do dia da publicação (aviso local, sem salvar). Público vazio = todos que entram no app; os grupos\n  oferecidos são os de \\`.../news/audience\\`, e grupo fora dele é 400 \\`invalid_group_ids\\`. O argos-admin saneia o\n  \\`body_html\\` (lista branca do \\`hm-rich-text\\`) antes de gravar; os códigos \\`invalid_title\\`, \\`invalid_summary\\`,\n  \\`body_too_large\\`, \\`invalid_published_at\\`, \\`invalid_until\\` e \\`invalid_group_ids\\` viram \\`autoServiceNews.errors\\`.\n  O que a pessoa vê é o \\`/me/news\\` (\\`SpineNewsService\\`): publicadas, na validade e do público dela.\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,qBAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Bd;;"}

package/fesm2022/trismegisto-spine-auto-service-news.usage-CeuZnG0V.mjs

@@ -0,0 +1,48 @@
+// Manual de uso da tela Novidades 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 news_usage = `# Novidades
+
+Escreva as novidades da aplicação e acompanhe a situação de cada uma: agendada, publicada ou vencida.
+
+## Antes de começar
+
+Fica na raiz do menu, fora de **Administração** (antes era uma aba da tela **Cliente**). Como nas outras
+telas do auto-serviço, o client é o do app em que você está logado; com mais de um, escolha no seletor do topo. É
+preciso estar no grupo de administração do projeto desse app e com o crachá **Administrador** ativo.
+
+## Como usar
+
+O que você escreve aqui aparece para quem entra no app: um aviso discreto no canto na entrada (uma vez por novidade),
+**Novidades** no menu do perfil (com quantas faltam abrir), o card **Novidades** do Início e o painel de novidades, que
+lista tudo por página e abre o texto inteiro ao clicar.
+
+A tabela mostra **Título** (com o resumo embaixo), **Situação** (**Agendada**, **Publicada** ou **Vencida**),
+**Publicação**, **Validade**, **Público** e **Autor** (com a foto). **Nova novidade** abre o editor. No topo, escolha
+o **tipo de publicação**:
+
+- **Informativo**: só o texto.
+- **Implementação**: "o que há de novo" — uma introdução opcional e a lista de mudanças (de 1 a 30, até 300
+  caracteres cada). Quem lê vê cada mudança com um check, sob "O que mudou".
+- **Alteração**: "como era antes e como ficou agora" — uma introdução opcional e os dois lados, **Antes** e
+  **Agora** (os dois obrigatórios), lado a lado na leitura.
+
+O editor é dividido em seções numeradas e não rola: quem rola é o texto (ou a lista). Na **Pré-visualização**, à
+direita, você vê, enquanto digita, como a novidade aparece no card do Início:
+
+1. **Informações principais**: **Título** (até 140 caracteres) e **Resumo** (até 300, o texto curto da lista e do
+   card do Início).
+2. **Conteúdo da novidade**, conforme o tipo: o texto completo, com formatação (títulos, listas, negrito, links...);
+   a introdução e a lista de mudanças; ou a introdução, o antes e o agora. Abre quando a pessoa clica na novidade.
+3. **Publicação**: data e hora. No futuro, a novidade fica **Agendada** e só aparece a partir daí. Sem data, ela é
+   publicada ao salvar.
+4. **Validade (opcional)**: o último dia em que a novidade aparece. Sem data, não vence. Não pode terminar antes da
+   publicação.
+5. **Público**: grupos com acesso ao app. Sem grupo, todo mundo que entra no app vê; com grupos, só os membros deles.
+
+**Editar** (no menu da linha) abre o mesmo editor, com **Excluir** no rodapé; tanto ali quanto no menu da linha,
+excluir pede confirmação e tira a novidade de todo mundo, inclusive de quem ainda não viu.
+`;
+
+export { news_usage as default };
+//# sourceMappingURL=trismegisto-spine-auto-service-news.usage-CeuZnG0V.mjs.map

package/fesm2022/trismegisto-spine-auto-service-news.usage-CeuZnG0V.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trismegisto-spine-auto-service-news.usage-CeuZnG0V.mjs","sources":["../../../projects/ui/auto-service/src/docs/news.usage.ts"],"sourcesContent":["// Manual de uso da tela Novidades do auto-serviço (`RouteDocument.load`), em Markdown. Módulo próprio, carregado só\n// pelo `import()` de `AUTO_SERVICE_DOCUMENTS`: vira um chunk à parte no FESM e fica fora do bundle inicial. Não importe\n// estaticamente nem reexporte no `public-api.ts`.\nexport default `# Novidades\n\nEscreva as novidades da aplicação e acompanhe a situação de cada uma: agendada, publicada ou vencida.\n\n## Antes de começar\n\nFica na raiz do menu, fora de **Administração** (antes era uma aba da tela **Cliente**). Como nas outras\ntelas do auto-serviço, o client é o do app em que você está logado; com mais de um, escolha no seletor do topo. É\npreciso estar no grupo de administração do projeto desse app e com o crachá **Administrador** ativo.\n\n## Como usar\n\nO que você escreve aqui aparece para quem entra no app: um aviso discreto no canto na entrada (uma vez por novidade),\n**Novidades** no menu do perfil (com quantas faltam abrir), o card **Novidades** do Início e o painel de novidades, que\nlista tudo por página e abre o texto inteiro ao clicar.\n\nA tabela mostra **Título** (com o resumo embaixo), **Situação** (**Agendada**, **Publicada** ou **Vencida**),\n**Publicação**, **Validade**, **Público** e **Autor** (com a foto). **Nova novidade** abre o editor. No topo, escolha\no **tipo de publicação**:\n\n- **Informativo**: só o texto.\n- **Implementação**: \"o que há de novo\" — uma introdução opcional e a lista de mudanças (de 1 a 30, até 300\n  caracteres cada). Quem lê vê cada mudança com um check, sob \"O que mudou\".\n- **Alteração**: \"como era antes e como ficou agora\" — uma introdução opcional e os dois lados, **Antes** e\n  **Agora** (os dois obrigatórios), lado a lado na leitura.\n\nO editor é dividido em seções numeradas e não rola: quem rola é o texto (ou a lista). Na **Pré-visualização**, à\ndireita, você vê, enquanto digita, como a novidade aparece no card do Início:\n\n1. **Informações principais**: **Título** (até 140 caracteres) e **Resumo** (até 300, o texto curto da lista e do\n   card do Início).\n2. **Conteúdo da novidade**, conforme o tipo: o texto completo, com formatação (títulos, listas, negrito, links...);\n   a introdução e a lista de mudanças; ou a introdução, o antes e o agora. Abre quando a pessoa clica na novidade.\n3. **Publicação**: data e hora. No futuro, a novidade fica **Agendada** e só aparece a partir daí. Sem data, ela é\n   publicada ao salvar.\n4. **Validade (opcional)**: o último dia em que a novidade aparece. Sem data, não vence. Não pode terminar antes da\n   publicação.\n5. **Público**: grupos com acesso ao app. Sem grupo, todo mundo que entra no app vê; com grupos, só os membros deles.\n\n**Editar** (no menu da linha) abre o mesmo editor, com **Excluir** no rodapé; tanto ali quanto no menu da linha,\nexcluir pede confirmação e tira a novidade de todo mundo, inclusive de quem ainda não viu.\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,iBAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCd;;"}

package/fesm2022/trismegisto-spine-auto-service-ratings.technical-QIVj6HBU.mjs

@@ -0,0 +1,52 @@
+// Especificação técnica da tela Avaliaçõ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 ratings_technical = `# Avaliações — especificação técnica
+
+Tela \`AutoServiceRatingsPageComponent\`, ligada ao router de template \`AUTO_SERVICE_RATINGS_TEMPLATE_ROUTER_ID\`
+(\`ad100008-…\`, página \`app-ratings\` na raiz do menu, migration 0036 do argos): o seletor de client
+(\`AutoServiceClientPickerComponent\`) e, embaixo, o painel da tela. Fala com o argos-admin-server em
+\`{adminApi}/auto-service\`, com o token no cabeçalho \`x-access-token\`.
+
+## Endpoints
+
+| Ação | Endpoint |
+| --- | --- |
+| Clients que a pessoa administra | \`GET /auto-service\` |
+| Resumo das avaliações (\`web.app_ratings\`) | \`GET /auto-service/:clientId/ratings/summary\` (\`from\`/\`to\` opcionais): \`{ app, screens, by_screen, trend }\` |
+| Avaliações (recentes e todas) | \`GET /auto-service/:clientId/ratings\` (\`scope\`, \`screen\`, \`score\` (0 a 10), \`comment=true\`, \`from\`/\`to\`, \`page\`, \`limit\` até 100) |
+
+## Regras
+
+- **Autorização** (\`clientAdminGuard\`): grupo de administração do projeto do client + crachá Administrador ativo. O
+  \`client_id\` vem sempre da URL; 403 vira a mensagem de falta de acesso.
+- **Menu**: página privada, com os tipos permitidos e os guards que a tela Cliente tinha em cada client (a migration
+  copia); o painel só é montado depois que o client é escolhido.
+- **Resumo**: cada agregado é \`{ average, total, comments, distribution }\` (nota de 0 a 10, migration 0034 do argos: 5
+  estrelas com meia; \`distribution[0]\` = nota 0 … \`[10]\` = 10; \`average\` com uma casa, \`null\` sem avaliação).
+  \`screens\` soma todas as telas e \`by_screen\` traz cada uma: \`screen_path\`, o \`screen_label\` mais recente,
+  \`screen_icon\`, \`screen_area\` e \`screen_area_icon\` (o ícone da página, os níveis de cima com nome de exibição e o
+  ícone deles, no menu do client, achados pelo mesmo caminho que o auth-server monta; \`null\` fora do menu, e a tela
+  usa o ícone genérico e a área da trilha guardada) e \`trend\`. \`trend\` (geral \`{ app, screens }\`; por tela
+  \`by_screen[].trend\`) é a média por semana (\`{ week, average, total }\`, semana de segunda-feira em UTC), nas últimas
+  12 semanas até o fim do período, sem passar do \`from\`. Os campos novos são opcionais no cliente (servidor antigo:
+  sem área, ícone genérico, sem sparkline, e a aba Tendências avisa).
+- **Período** (\`from\` = agora menos 7/30/90 dias; "Tudo" sem \`from\`): conta pela data da nota atual (\`updated_at\`:
+  avaliar de novo é avaliação de agora) e vale para o resumo, as recentes e a lista completa. Fica na barra da página
+  (\`<ng-template spinePageActions>\`), com "Atualizado em…".
+- **Tela** (\`AutoServiceRatingsComponent\`, serviço próprio \`AutoServiceRatingsService\`): só leitura. Dois KPIs (média,
+  estrelas, totais e o histograma das 11 notas, com a dica "N avaliações" e o rótulo "Nota 9: 1 avaliação (25%)" para o
+  leitor; "Ver detalhes"). Embaixo, 2/3 e 1/3 (empilham por container query): as abas **Telas** e **Áreas**
+  (\`spine-ratings-table\`: busca, área, faixa da nota, ordem por \`sortRows\` e paginação no navegador; a área soma as
+  telas com \`combineAggregates\` e \`combineTrends\`; sparkline em SVG na cor da faixa, \`ratingTone\`) e **Tendências**
+  (\`spine-ratings-trend\`, SVG próprio: grade em 0, 5 e 10, uma linha por série, a segunda tracejada, legenda e uma
+  coluna focável por semana com a dica); à direita, as 6 avaliações mais recentes (\`limit=6\`) e "Ver todas as
+  avaliações", o \`hm-drawer\` com a lista completa, os filtros, o menu ⋮ (só ações locais: copiar o comentário, filtrar
+  pelo alvo) e a paginação no servidor (10 por página). Clicar numa tela abre esse drawer filtrado por ela
+  (\`scope=screen&screen=…\`, página 1). Cada item traz \`user_picture\` (a regra dos membros). 403 =
+  \`ratings.forbidden\`; outra falha = \`ratings.loadError\`. As notas vêm de \`/me/ratings\` (\`SpineFeatures.ratings\` no
+  app): uma por pessoa em cada (app, escopo, tela), pelo índice único da tabela.
+`;
+
+export { ratings_technical as default };
+//# sourceMappingURL=trismegisto-spine-auto-service-ratings.technical-QIVj6HBU.mjs.map

package/fesm2022/trismegisto-spine-auto-service-ratings.technical-QIVj6HBU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trismegisto-spine-auto-service-ratings.technical-QIVj6HBU.mjs","sources":["../../../projects/ui/auto-service/src/docs/ratings.technical.ts"],"sourcesContent":["// Especificação técnica da tela Avaliaçõ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 bundle\n// inicial. Não importe estaticamente nem reexporte no `public-api.ts`.\nexport default `# Avaliações — especificação técnica\n\nTela \\`AutoServiceRatingsPageComponent\\`, ligada ao router de template \\`AUTO_SERVICE_RATINGS_TEMPLATE_ROUTER_ID\\`\n(\\`ad100008-…\\`, página \\`app-ratings\\` na raiz do menu, migration 0036 do argos): o seletor de client\n(\\`AutoServiceClientPickerComponent\\`) e, embaixo, o painel da tela. Fala com o argos-admin-server em\n\\`{adminApi}/auto-service\\`, 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| Resumo das avaliações (\\`web.app_ratings\\`) | \\`GET /auto-service/:clientId/ratings/summary\\` (\\`from\\`/\\`to\\` opcionais): \\`{ app, screens, by_screen, trend }\\` |\n| Avaliações (recentes e todas) | \\`GET /auto-service/:clientId/ratings\\` (\\`scope\\`, \\`screen\\`, \\`score\\` (0 a 10), \\`comment=true\\`, \\`from\\`/\\`to\\`, \\`page\\`, \\`limit\\` até 100) |\n\n## Regras\n\n- **Autorização** (\\`clientAdminGuard\\`): grupo de administração do projeto do client + crachá Administrador ativo. O\n  \\`client_id\\` vem sempre da URL; 403 vira a mensagem de falta de acesso.\n- **Menu**: página privada, com os tipos permitidos e os guards que a tela Cliente tinha em cada client (a migration\n  copia); o painel só é montado depois que o client é escolhido.\n- **Resumo**: cada agregado é \\`{ average, total, comments, distribution }\\` (nota de 0 a 10, migration 0034 do argos: 5\n  estrelas com meia; \\`distribution[0]\\` = nota 0 … \\`[10]\\` = 10; \\`average\\` com uma casa, \\`null\\` sem avaliação).\n  \\`screens\\` soma todas as telas e \\`by_screen\\` traz cada uma: \\`screen_path\\`, o \\`screen_label\\` mais recente,\n  \\`screen_icon\\`, \\`screen_area\\` e \\`screen_area_icon\\` (o ícone da página, os níveis de cima com nome de exibição e o\n  ícone deles, no menu do client, achados pelo mesmo caminho que o auth-server monta; \\`null\\` fora do menu, e a tela\n  usa o ícone genérico e a área da trilha guardada) e \\`trend\\`. \\`trend\\` (geral \\`{ app, screens }\\`; por tela\n  \\`by_screen[].trend\\`) é a média por semana (\\`{ week, average, total }\\`, semana de segunda-feira em UTC), nas últimas\n  12 semanas até o fim do período, sem passar do \\`from\\`. Os campos novos são opcionais no cliente (servidor antigo:\n  sem área, ícone genérico, sem sparkline, e a aba Tendências avisa).\n- **Período** (\\`from\\` = agora menos 7/30/90 dias; \"Tudo\" sem \\`from\\`): conta pela data da nota atual (\\`updated_at\\`:\n  avaliar de novo é avaliação de agora) e vale para o resumo, as recentes e a lista completa. Fica na barra da página\n  (\\`<ng-template spinePageActions>\\`), com \"Atualizado em…\".\n- **Tela** (\\`AutoServiceRatingsComponent\\`, serviço próprio \\`AutoServiceRatingsService\\`): só leitura. Dois KPIs (média,\n  estrelas, totais e o histograma das 11 notas, com a dica \"N avaliações\" e o rótulo \"Nota 9: 1 avaliação (25%)\" para o\n  leitor; \"Ver detalhes\"). Embaixo, 2/3 e 1/3 (empilham por container query): as abas **Telas** e **Áreas**\n  (\\`spine-ratings-table\\`: busca, área, faixa da nota, ordem por \\`sortRows\\` e paginação no navegador; a área soma as\n  telas com \\`combineAggregates\\` e \\`combineTrends\\`; sparkline em SVG na cor da faixa, \\`ratingTone\\`) e **Tendências**\n  (\\`spine-ratings-trend\\`, SVG próprio: grade em 0, 5 e 10, uma linha por série, a segunda tracejada, legenda e uma\n  coluna focável por semana com a dica); à direita, as 6 avaliações mais recentes (\\`limit=6\\`) e \"Ver todas as\n  avaliações\", o \\`hm-drawer\\` com a lista completa, os filtros, o menu ⋮ (só ações locais: copiar o comentário, filtrar\n  pelo alvo) e a paginação no servidor (10 por página). Clicar numa tela abre esse drawer filtrado por ela\n  (\\`scope=screen&screen=…\\`, página 1). Cada item traz \\`user_picture\\` (a regra dos membros). 403 =\n  \\`ratings.forbidden\\`; outra falha = \\`ratings.loadError\\`. As notas vêm de \\`/me/ratings\\` (\\`SpineFeatures.ratings\\` no\n  app): uma por pessoa em cada (app, escopo, tela), pelo índice único da tabela.\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,wBAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Cd;;"}

package/fesm2022/trismegisto-spine-auto-service-ratings.usage-BkteY8lz.mjs

@@ -0,0 +1,45 @@
+// Manual de uso da tela Avaliaçõ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 ratings_usage = `# Avaliações
+
+Veja o que as pessoas acharam desta aplicação e de cada tela: as notas, os comentários e as telas que pedem
+atenção. A tela é só de consulta.
+
+## Antes de começar
+
+Fica na raiz do menu, fora de **Administração** (antes era uma aba da tela **Cliente**). Como nas outras
+telas do auto-serviço, o client é o do app em que você está logado; com mais de um, escolha no seletor do topo. É
+preciso estar no grupo de administração do projeto desse app e com o crachá **Administrador** ativo.
+
+## Como usar
+
+As pessoas dão de 0 a 5 estrelas, com meia estrela (nota de 0 a 10), e um comentário opcional, a cada tela (a estrela **Avaliar esta
+tela** da barra da página) e à ferramenta inteira (**Avaliar o** nome do app, a estrela do cabeçalho). Cada pessoa tem
+uma avaliação por tela e uma da ferramenta: se avaliar de novo, a nova substitui a anterior. A tela só tem dados quando
+o app liga as avaliações.
+
+- Na barra da página, ao lado do título: quando os números foram lidos (**Atualizado em…**), o **Período** (Tudo, 7, 30
+  ou 90 dias, pela data da avaliação; vale para a tela inteira) e **Atualizar**, que relê tudo.
+- **A ferramenta** e **As telas** (todas juntas), lado a lado (um embaixo do outro no celular): a **média** em destaque
+  (de 0 a 10) com as estrelas, quantas avaliações e quantos comentários e, ao lado, a **distribuição das notas**: uma
+  coluna por nota, de 0 a 10 (verde de 7 para cima, âmbar de 5 a 6,9, vermelho abaixo de 5; cinza quando nenhuma).
+  Passe o mouse numa coluna para ver quantas avaliações ela tem. **Ver detalhes** abre as avaliações da ferramenta, ou
+  leva à aba **Telas**.
+- Embaixo, à esquerda, três abas:
+  - **Telas**: uma tabela com o ícone e a rota de cada tela, a **área** do menu, a nota com as estrelas, quantas
+    avaliações e comentários e uma linha pequena com a média semana a semana (na cor da faixa). Busque por nome ou
+    caminho, filtre por área e por faixa da nota e ordene por **Piores** (o padrão: é onde agir), **Melhores** ou **Mais
+    avaliadas**; a paginação fica embaixo. **Clique numa tela** para ver as avaliações dela.
+  - **Áreas**: o mesmo, com as telas de cada área somadas. Clicar numa área mostra as telas dela.
+  - **Tendências**: a média por semana da ferramenta e das telas, nas últimas semanas do período. Passe o mouse (ou
+    navegue com Tab) em cada semana para ver os valores.
+- À direita, **Avaliações recentes**: as últimas, com quem avaliou (e a foto), as estrelas e a nota, o que foi avaliado
+  (**A ferramenta** ou o nome da tela), quando ("há 1 hora", "Ontem às 14:21") e o comentário. **Ver todas as
+  avaliações** abre a lista completa ao lado, com os filtros (**O que foi avaliado**, **Tela**, **Nota** e **Mostrar
+  apenas com comentário**; **Limpar filtros** volta tudo), a paginação e o menu **⋮** de cada avaliação, que copia o
+  comentário e mostra só as avaliações do mesmo alvo.
+`;
+
+export { ratings_usage as default };
+//# sourceMappingURL=trismegisto-spine-auto-service-ratings.usage-BkteY8lz.mjs.map

package/fesm2022/trismegisto-spine-auto-service-ratings.usage-BkteY8lz.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trismegisto-spine-auto-service-ratings.usage-BkteY8lz.mjs","sources":["../../../projects/ui/auto-service/src/docs/ratings.usage.ts"],"sourcesContent":["// Manual de uso da tela Avaliações do auto-serviço (`RouteDocument.load`), em Markdown. Módulo próprio, carregado só\n// pelo `import()` de `AUTO_SERVICE_DOCUMENTS`: vira um chunk à parte no FESM e fica fora do bundle inicial. Não importe\n// estaticamente nem reexporte no `public-api.ts`.\nexport default `# Avaliações\n\nVeja o que as pessoas acharam desta aplicação e de cada tela: as notas, os comentários e as telas que pedem\natenção. A tela é só de consulta.\n\n## Antes de começar\n\nFica na raiz do menu, fora de **Administração** (antes era uma aba da tela **Cliente**). Como nas outras\ntelas do auto-serviço, o client é o do app em que você está logado; com mais de um, escolha no seletor do topo. É\npreciso estar no grupo de administração do projeto desse app e com o crachá **Administrador** ativo.\n\n## Como usar\n\nAs pessoas dão de 0 a 5 estrelas, com meia estrela (nota de 0 a 10), e um comentário opcional, a cada tela (a estrela **Avaliar esta\ntela** da barra da página) e à ferramenta inteira (**Avaliar o** nome do app, a estrela do cabeçalho). Cada pessoa tem\numa avaliação por tela e uma da ferramenta: se avaliar de novo, a nova substitui a anterior. A tela só tem dados quando\no app liga as avaliações.\n\n- Na barra da página, ao lado do título: quando os números foram lidos (**Atualizado em…**), o **Período** (Tudo, 7, 30\n  ou 90 dias, pela data da avaliação; vale para a tela inteira) e **Atualizar**, que relê tudo.\n- **A ferramenta** e **As telas** (todas juntas), lado a lado (um embaixo do outro no celular): a **média** em destaque\n  (de 0 a 10) com as estrelas, quantas avaliações e quantos comentários e, ao lado, a **distribuição das notas**: uma\n  coluna por nota, de 0 a 10 (verde de 7 para cima, âmbar de 5 a 6,9, vermelho abaixo de 5; cinza quando nenhuma).\n  Passe o mouse numa coluna para ver quantas avaliações ela tem. **Ver detalhes** abre as avaliações da ferramenta, ou\n  leva à aba **Telas**.\n- Embaixo, à esquerda, três abas:\n  - **Telas**: uma tabela com o ícone e a rota de cada tela, a **área** do menu, a nota com as estrelas, quantas\n    avaliações e comentários e uma linha pequena com a média semana a semana (na cor da faixa). Busque por nome ou\n    caminho, filtre por área e por faixa da nota e ordene por **Piores** (o padrão: é onde agir), **Melhores** ou **Mais\n    avaliadas**; a paginação fica embaixo. **Clique numa tela** para ver as avaliações dela.\n  - **Áreas**: o mesmo, com as telas de cada área somadas. Clicar numa área mostra as telas dela.\n  - **Tendências**: a média por semana da ferramenta e das telas, nas últimas semanas do período. Passe o mouse (ou\n    navegue com Tab) em cada semana para ver os valores.\n- À direita, **Avaliações recentes**: as últimas, com quem avaliou (e a foto), as estrelas e a nota, o que foi avaliado\n  (**A ferramenta** ou o nome da tela), quando (\"há 1 hora\", \"Ontem às 14:21\") e o comentário. **Ver todas as\n  avaliações** abre a lista completa ao lado, com os filtros (**O que foi avaliado**, **Tela**, **Nota** e **Mostrar\n  apenas com comentário**; **Limpar filtros** volta tudo), a paginação e o menu **⋮** de cada avaliação, que copia o\n  comentário e mostra só as avaliações do mesmo alvo.\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,oBAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCd;;"}

package/fesm2022/trismegisto-spine-auto-service-suggestions.technical-BtUK6sKD.mjs

@@ -0,0 +1,69 @@
+// Especificação técnica da tela Sugestõ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 suggestions_technical = `# Sugestões — especificação técnica
+
+Tela \`AutoServiceSuggestionsPageComponent\`, ligada ao router de template \`AUTO_SERVICE_SUGGESTIONS_TEMPLATE_ROUTER_ID\`
+(\`ad100007-…\`, página \`app-suggestions\` na raiz do menu, migration 0036 do argos): o seletor de client
+(\`AutoServiceClientPickerComponent\`) e, embaixo, o painel da tela. Fala com o argos-admin-server em
+\`{adminApi}/auto-service\`, com o token no cabeçalho \`x-access-token\`.
+
+## Endpoints
+
+| Ação | Endpoint |
+| --- | --- |
+| Clients que a pessoa administra | \`GET /auto-service\` |
+| Quadro (\`web.app_suggestions\`) | \`GET /auto-service/:clientId/suggestions?board=true\`: sem arquivadas, recusadas e concluídas fora da janela (\`done_days\`, 7; \`due_soon_days\`, 1), com autor, responsáveis e envolvidos (com foto), rótulos, checklist e a última atividade |
+| Arquivo | \`GET …/suggestions?archive=true\` (\`search\`, \`kind\`, \`status\`, \`limit\`, \`offset\`): arquivadas, recusadas e concluídas antigas, com \`total\` |
+| Filtros do servidor | \`kind\`, \`status\`, \`screen\`, \`search\` (inclui a chave \`SUG-12\`), \`priority\`, \`label\`, \`assignee\` (\`me\`, \`none\` ou um id), \`due\` (\`overdue\` ou \`soon\`) |
+| Criar (equipe) | \`POST …/suggestions\` (\`{ title, status?, kind?, priority?, start_date?, due_date?, cover?, description_html?, people?, label_ids? }\`; \`origin: equipe\`) |
+| Tarefa | \`GET …/suggestions/:id\` (com o checklist completo); \`GET …/suggestions/lookup?key=SUG-12\` (o link copiado) |
+| Editar, mover, mudar status | \`PATCH …/suggestions/:id\` (campos da tarefa e/ou \`{ status?, position?, comment?, internal? }\`) |
+| Arquivar, restaurar, excluir | \`POST …/:id/archive\`, \`POST …/:id/restore\`, \`DELETE …/:id\` |
+| Atividades e comentários | \`GET …/:id/events?type=comments\` ou \`type=activity\` (do mais novo, paginado); \`POST …/:id/comments\` (\`{ comment, internal? }\`) |
+| Pessoas | \`POST …/:id/people\` (\`{ user_id, role }\`; \`user_id: "me"\` = atribuir a mim; \`role\` responsavel ou envolvido), \`DELETE …/:id/people/:userId?role=\`; busca em \`GET /auto-service/:clientId/users\` |
+| Checklist | \`POST …/:id/checklist\`, \`PATCH …/:id/checklist/:itemId\` (\`{ text?, done?, position? }\`), \`DELETE …/:id/checklist/:itemId\` |
+| Rótulos | catálogo \`GET\`/\`POST …/suggestions/labels\`, \`PATCH\`/\`DELETE …/labels/:labelId\`; na tarefa \`PUT\`/\`DELETE …/:id/labels/:labelId\` |
+
+## Regras
+
+- **Autorização** (\`clientAdminGuard\`): grupo de administração do projeto do client + crachá Administrador ativo. O
+  \`client_id\` vem sempre da URL; 403 vira a mensagem de falta de acesso.
+- **Menu**: página privada, com os tipos permitidos e os guards que a tela Cliente tinha em cada client (a migration
+  copia); o painel só é montado depois que o client é escolhido.
+- **Status**: toda sugestão nasce \`em_analise\` (não existe mais \`nova\`; a migration 0035 do argos move as antigas).
+  O quadro tem 4 colunas (\`em_analise\`, \`planejada\`, \`em_desenvolvimento\`, \`concluida\`); \`recusada\` só aparece no
+  arquivo. O corte da janela das concluídas é do servidor.
+- **Tela** (\`AutoServiceSuggestionsComponent\`, serviço próprio \`AutoServiceSuggestionsService\`): \`hm-kanban\` com os
+  cartões por \`position\`. Os 8 indicadores (abertas, em análise, planejadas, em desenvolvimento, atribuídas a mim,
+  vencidas, concluídas na janela e a mais votada) são do quadro inteiro, sem filtro; "atribuídas a mim" e "vencidas"
+  também ligam o filtro. Os filtros (texto sem acento ou a chave, responsável — minhas, sem responsável ou uma pessoa
+  —, rótulo, prioridade, prazo, tipo, tela, quem pediu) e a ordenação (\`position\`, \`votes\`, \`recent\`, prioridade,
+  prazo) são da tela, com a mesma regra dos filtros do servidor. "Eu" é o \`sub\` da sessão (\`SpineUserStorage\`).
+- **Cartão**: capa (token da paleta do tema: \`cat-1\`..\`cat-8\`, \`grad-1\`..\`grad-6\`), chave, tipo, rótulos, título,
+  trecho, tela, checklist (feitos/total; os itens marcáveis no cartão com \`checklist_on_card\`), prioridade, prazo
+  (vencida, hoje, amanhã), comentários, apoios e até 3 responsáveis com "+N". O "⋯" (\`hm-menu-button\`): status e
+  prioridade em submenu, atribuir a mim, rótulos, capa (\`hm-popover\` ancorado no cartão), copiar link
+  (\`?sugestao=SUG-12\`, que abre a tarefa ao carregar o quadro) e chave, arquivar e excluir (\`HermesDialogService.confirm\`).
+- **Criar**: o "+" no cabeçalho de cada coluna abre a criação rápida (título e Enter, no fim da coluna); "Nova tarefa"
+  abre a tarefa em branco (\`SuggestionTaskDetailComponent\` em rascunho) e, criada, vira a tarefa completa. Na ordem do quadro, o \`moved\` dá o índice na coluna
+  FILTRADA, e a tela converte para o índice na coluna inteira pelo vizinho visível de cima (ou o de baixo; sozinho =
+  fim) antes do \`PATCH\` -- o servidor renumera a coluna de destino 0..n; com outra ordenação, só a troca de coluna
+  grava (\`{ status }\`, no fim da coluna) e o arrasto dentro dela volta. O movimento é aplicado na hora; falha = toast
+  \`suggestions.moveError\` e releitura. Selo "Mais votada" nas 3 com mais apoios.
+- **Arquivo**: paginado no servidor (20 por página), com busca e filtros de status e tipo; **Reabrir** nas recusadas
+  (\`PATCH\` com \`status: em_analise\`) e **Restaurar** nas arquivadas (\`POST …/restore\`).
+- **Tarefa** (\`SuggestionTaskDetailComponent\`, \`hm-modal\` xlarge em duas colunas): à esquerda título editável no
+  lugar, descrição em \`hm-rich-text\` (o servidor saneia com a lista branca das novidades), checklist (marcar,
+  renomear, subir/descer, remover, "Mostrar no cartão") e as abas Comentários e Atividades (\`events\`, do mais novo,
+  "Carregar mais"); à direita status, responsáveis (com "Atribuir a mim") e envolvidos (busca de pessoas do realm do
+  app, com foto; o servidor recusa quem é de fora, \`person_not_in_realm\`), relator e origem, prioridade, tipo, início e
+  conclusão, rótulos (catálogo do app; cria na hora), capa, tela com "Abrir a tela" (só quando o client administrado
+  é o do app logado), apoios, criada/atualizada, "Última alteração há X por Fulano", chave com copiar, arquivar e
+  excluir. Cada mudança grava na hora e o servidor devolve a tarefa inteira, que atualiza o cartão.
+- **Comentários**: texto simples. Interno (\`internal: true\`) só a equipe vê: não conta nem aparece como a última
+  resposta em "Minhas sugestões" (\`/me/suggestions\`). Sugestão de outro client: 404 \`suggestion_not_found\`.
+`;
+
+export { suggestions_technical as default };
+//# sourceMappingURL=trismegisto-spine-auto-service-suggestions.technical-BtUK6sKD.mjs.map

package/fesm2022/trismegisto-spine-auto-service-suggestions.technical-BtUK6sKD.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trismegisto-spine-auto-service-suggestions.technical-BtUK6sKD.mjs","sources":["../../../projects/ui/auto-service/src/docs/suggestions.technical.ts"],"sourcesContent":["// Especificação técnica da tela Sugestõ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 bundle\n// inicial. Não importe estaticamente nem reexporte no `public-api.ts`.\nexport default `# Sugestões — especificação técnica\n\nTela \\`AutoServiceSuggestionsPageComponent\\`, ligada ao router de template \\`AUTO_SERVICE_SUGGESTIONS_TEMPLATE_ROUTER_ID\\`\n(\\`ad100007-…\\`, página \\`app-suggestions\\` na raiz do menu, migration 0036 do argos): o seletor de client\n(\\`AutoServiceClientPickerComponent\\`) e, embaixo, o painel da tela. Fala com o argos-admin-server em\n\\`{adminApi}/auto-service\\`, 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| Quadro (\\`web.app_suggestions\\`) | \\`GET /auto-service/:clientId/suggestions?board=true\\`: sem arquivadas, recusadas e concluídas fora da janela (\\`done_days\\`, 7; \\`due_soon_days\\`, 1), com autor, responsáveis e envolvidos (com foto), rótulos, checklist e a última atividade |\n| Arquivo | \\`GET …/suggestions?archive=true\\` (\\`search\\`, \\`kind\\`, \\`status\\`, \\`limit\\`, \\`offset\\`): arquivadas, recusadas e concluídas antigas, com \\`total\\` |\n| Filtros do servidor | \\`kind\\`, \\`status\\`, \\`screen\\`, \\`search\\` (inclui a chave \\`SUG-12\\`), \\`priority\\`, \\`label\\`, \\`assignee\\` (\\`me\\`, \\`none\\` ou um id), \\`due\\` (\\`overdue\\` ou \\`soon\\`) |\n| Criar (equipe) | \\`POST …/suggestions\\` (\\`{ title, status?, kind?, priority?, start_date?, due_date?, cover?, description_html?, people?, label_ids? }\\`; \\`origin: equipe\\`) |\n| Tarefa | \\`GET …/suggestions/:id\\` (com o checklist completo); \\`GET …/suggestions/lookup?key=SUG-12\\` (o link copiado) |\n| Editar, mover, mudar status | \\`PATCH …/suggestions/:id\\` (campos da tarefa e/ou \\`{ status?, position?, comment?, internal? }\\`) |\n| Arquivar, restaurar, excluir | \\`POST …/:id/archive\\`, \\`POST …/:id/restore\\`, \\`DELETE …/:id\\` |\n| Atividades e comentários | \\`GET …/:id/events?type=comments\\` ou \\`type=activity\\` (do mais novo, paginado); \\`POST …/:id/comments\\` (\\`{ comment, internal? }\\`) |\n| Pessoas | \\`POST …/:id/people\\` (\\`{ user_id, role }\\`; \\`user_id: \"me\"\\` = atribuir a mim; \\`role\\` responsavel ou envolvido), \\`DELETE …/:id/people/:userId?role=\\`; busca em \\`GET /auto-service/:clientId/users\\` |\n| Checklist | \\`POST …/:id/checklist\\`, \\`PATCH …/:id/checklist/:itemId\\` (\\`{ text?, done?, position? }\\`), \\`DELETE …/:id/checklist/:itemId\\` |\n| Rótulos | catálogo \\`GET\\`/\\`POST …/suggestions/labels\\`, \\`PATCH\\`/\\`DELETE …/labels/:labelId\\`; na tarefa \\`PUT\\`/\\`DELETE …/:id/labels/:labelId\\` |\n\n## Regras\n\n- **Autorização** (\\`clientAdminGuard\\`): grupo de administração do projeto do client + crachá Administrador ativo. O\n  \\`client_id\\` vem sempre da URL; 403 vira a mensagem de falta de acesso.\n- **Menu**: página privada, com os tipos permitidos e os guards que a tela Cliente tinha em cada client (a migration\n  copia); o painel só é montado depois que o client é escolhido.\n- **Status**: toda sugestão nasce \\`em_analise\\` (não existe mais \\`nova\\`; a migration 0035 do argos move as antigas).\n  O quadro tem 4 colunas (\\`em_analise\\`, \\`planejada\\`, \\`em_desenvolvimento\\`, \\`concluida\\`); \\`recusada\\` só aparece no\n  arquivo. O corte da janela das concluídas é do servidor.\n- **Tela** (\\`AutoServiceSuggestionsComponent\\`, serviço próprio \\`AutoServiceSuggestionsService\\`): \\`hm-kanban\\` com os\n  cartões por \\`position\\`. Os 8 indicadores (abertas, em análise, planejadas, em desenvolvimento, atribuídas a mim,\n  vencidas, concluídas na janela e a mais votada) são do quadro inteiro, sem filtro; \"atribuídas a mim\" e \"vencidas\"\n  também ligam o filtro. Os filtros (texto sem acento ou a chave, responsável — minhas, sem responsável ou uma pessoa\n  —, rótulo, prioridade, prazo, tipo, tela, quem pediu) e a ordenação (\\`position\\`, \\`votes\\`, \\`recent\\`, prioridade,\n  prazo) são da tela, com a mesma regra dos filtros do servidor. \"Eu\" é o \\`sub\\` da sessão (\\`SpineUserStorage\\`).\n- **Cartão**: capa (token da paleta do tema: \\`cat-1\\`..\\`cat-8\\`, \\`grad-1\\`..\\`grad-6\\`), chave, tipo, rótulos, título,\n  trecho, tela, checklist (feitos/total; os itens marcáveis no cartão com \\`checklist_on_card\\`), prioridade, prazo\n  (vencida, hoje, amanhã), comentários, apoios e até 3 responsáveis com \"+N\". O \"⋯\" (\\`hm-menu-button\\`): status e\n  prioridade em submenu, atribuir a mim, rótulos, capa (\\`hm-popover\\` ancorado no cartão), copiar link\n  (\\`?sugestao=SUG-12\\`, que abre a tarefa ao carregar o quadro) e chave, arquivar e excluir (\\`HermesDialogService.confirm\\`).\n- **Criar**: o \"+\" no cabeçalho de cada coluna abre a criação rápida (título e Enter, no fim da coluna); \"Nova tarefa\"\n  abre a tarefa em branco (\\`SuggestionTaskDetailComponent\\` em rascunho) e, criada, vira a tarefa completa. Na ordem do quadro, o \\`moved\\` dá o índice na coluna\n  FILTRADA, e a tela converte para o índice na coluna inteira pelo vizinho visível de cima (ou o de baixo; sozinho =\n  fim) antes do \\`PATCH\\` -- o servidor renumera a coluna de destino 0..n; com outra ordenação, só a troca de coluna\n  grava (\\`{ status }\\`, no fim da coluna) e o arrasto dentro dela volta. O movimento é aplicado na hora; falha = toast\n  \\`suggestions.moveError\\` e releitura. Selo \"Mais votada\" nas 3 com mais apoios.\n- **Arquivo**: paginado no servidor (20 por página), com busca e filtros de status e tipo; **Reabrir** nas recusadas\n  (\\`PATCH\\` com \\`status: em_analise\\`) e **Restaurar** nas arquivadas (\\`POST …/restore\\`).\n- **Tarefa** (\\`SuggestionTaskDetailComponent\\`, \\`hm-modal\\` xlarge em duas colunas): à esquerda título editável no\n  lugar, descrição em \\`hm-rich-text\\` (o servidor saneia com a lista branca das novidades), checklist (marcar,\n  renomear, subir/descer, remover, \"Mostrar no cartão\") e as abas Comentários e Atividades (\\`events\\`, do mais novo,\n  \"Carregar mais\"); à direita status, responsáveis (com \"Atribuir a mim\") e envolvidos (busca de pessoas do realm do\n  app, com foto; o servidor recusa quem é de fora, \\`person_not_in_realm\\`), relator e origem, prioridade, tipo, início e\n  conclusão, rótulos (catálogo do app; cria na hora), capa, tela com \"Abrir a tela\" (só quando o client administrado\n  é o do app logado), apoios, criada/atualizada, \"Última alteração há X por Fulano\", chave com copiar, arquivar e\n  excluir. Cada mudança grava na hora e o servidor devolve a tarefa inteira, que atualiza o cartão.\n- **Comentários**: texto simples. Interno (\\`internal: true\\`) só a equipe vê: não conta nem aparece como a última\n  resposta em \"Minhas sugestões\" (\\`/me/suggestions\\`). Sugestão de outro client: 404 \\`suggestion_not_found\\`.\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,4BAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Dd;;"}

package/fesm2022/trismegisto-spine-auto-service-suggestions.usage-BwO9Hjsx.mjs

@@ -0,0 +1,72 @@
+// Manual de uso da tela Sugestõ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 suggestions_usage = `# Sugestões
+
+Acompanhe as melhorias que as pessoas pediram nesta aplicação, num quadro por status, e responda a quem pediu.
+
+## Antes de começar
+
+Fica na raiz do menu, fora de **Administração** (antes era uma aba da tela **Cliente**). Como nas outras
+telas do auto-serviço, o client é o do app em que você está logado; com mais de um, escolha no seletor do topo. É
+preciso estar no grupo de administração do projeto desse app e com o crachá **Administrador** ativo.
+
+## Como usar
+
+As pessoas pedem melhorias pelo botão **Sugerir melhoria** da barra de cada tela (tipo, título, descrição e a tela de
+onde vieram). Toda sugestão chega **Em análise**. No topo, escolha **Quadro** (o que está andando) ou **Arquivo** (o
+que já saiu do quadro).
+
+## Quadro
+
+- **Indicadores**: **Abertas** (em análise, planejadas e em desenvolvimento), quantas há em cada coluna, as
+  **Atribuídas a mim**, as **Vencidas**, as **Concluídas em 7 dias** e a **Mais votada**. Contam o quadro inteiro, sem
+  os filtros; clicar em **Atribuídas a mim** ou **Vencidas** filtra o quadro por elas.
+- **Criar**: **Nova tarefa** (no topo) abre a tarefa em branco: título, coluna, tipo, prioridade, datas, descrição,
+  rótulos e **Atribuir a mim**. O **+** no cabeçalho de cada coluna cria rápido: escreva o título e tecle **Enter**
+  (o campo fica aberto para a próxima; **Esc** fecha). Tarefas criadas pela equipe aparecem como **Criada pela equipe**.
+- **Filtros**: **Buscar sugestões** (título, descrição, tela ou a chave, como **SUG-12**, sem diferenciar acentos),
+  **Responsável** (**Minhas**, **Sem responsável** ou uma pessoa), **Rótulo**, **Prioridade**, **Prazo** (**Vencidas**
+  ou **Vencem hoje ou amanhã**), **Tipo**, **Tela** e **Quem pediu**; **Ordenar** pela ordem do quadro, mais votadas,
+  mais recentes, prioridade ou prazo.
+- Uma coluna por status: **Em análise**, **Planejada**, **Em desenvolvimento** e **Concluída**. Concluídas saem do
+  quadro 7 dias depois; recusadas e arquivadas saem na hora: todas ficam no **Arquivo**.
+- Cada cartão mostra a **capa** (se tiver), a **chave** (SUG-12), o **tipo**, os **rótulos**, o **título**, um trecho
+  da descrição, a **tela**, a **prioridade**, o **prazo** (vencida em vermelho; hoje e amanhã em destaque), o
+  **checklist** (feitos/total, e os itens no próprio cartão quando **Mostrar no cartão** está ligado — dá para marcar
+  ali), os comentários, os **apoios** e os rostos dos responsáveis (com **+N**). As 3 com mais apoios têm o selo
+  **Mais votada**.
+- O **⋯** do cartão: **Alterar status**, **Prioridade**, **Atribuir a mim**, **Rótulos**, **Selecionar capa** (cores e
+  gradientes do tema, ou **Remover capa**), **Copiar link** (o link abre a tarefa), **Copiar chave**, **Arquivar** e
+  **Excluir** (pede confirmação; não dá para desfazer).
+- **Arraste** o cartão para outra coluna para mudar o status, ou dentro da coluna para mudar a ordem (a de cima é a
+  primeira da fila; a ordem só muda em **Ordem do quadro**). Pelo teclado: foque o cartão, **Espaço** pega, as setas
+  escolhem o lugar e a coluna, **Espaço** solta e **Esc** cancela. Se a gravação falhar, aparece o aviso e o quadro é
+  recarregado.
+
+## Arquivo
+
+As arquivadas, as recusadas e as concluídas antigas, por página, com **Buscar no arquivo** e os filtros de status e
+tipo. Numa recusada, **Reabrir** a devolve ao quadro, em **Em análise**; numa arquivada, **Restaurar no quadro** a
+devolve com o status que tinha.
+
+## Tarefa
+
+Clique no **título** do cartão para abrir a tarefa:
+
+- **À esquerda**: o título (clique para editar; **Enter** salva, **Esc** desiste), a **Descrição** (**Editar
+  descrição** abre o editor com negrito, listas e links; **Salvar** grava), o **Checklist** (adicione itens com
+  **Enter**, marque, renomeie, suba/desça, remova; **Mostrar no cartão** põe os itens no cartão) e as abas
+  **Comentários** e **Atividades** (tudo o que mudou, com quem fez e quando).
+- **Comentários**: o que você escreve aparece para quem pediu em **Minhas sugestões**, a não ser que marque **Só para a
+  equipe** (interno: aparece aqui com a etiqueta **Interno** e quem pediu não vê).
+- **À direita**: **Status**, **Responsáveis** (**Atribuir a mim** ou **Adicionar responsável**, buscando pessoas do
+  realm desta aplicação, com foto) e **Envolvidos**, o **Relator** (quem pediu, ou quem criou), **Prioridade**, **Tipo**,
+  **Início** e **Conclusão**, **Rótulos** (escolha do catálogo do app ou crie um novo com a cor), **Capa**, a **Tela de
+  origem** (com **Abrir a tela**, quando o client administrado é o deste app), os **Apoios**, quando foi criada e
+  atualizada e a **última alteração**, com quem fez. A **chave** tem **Copiar**. **Arquivar** e **Excluir** ficam no
+  fim. Cada mudança é gravada na hora.
+`;
+
+export { suggestions_usage as default };
+//# sourceMappingURL=trismegisto-spine-auto-service-suggestions.usage-BwO9Hjsx.mjs.map

package/fesm2022/trismegisto-spine-auto-service-suggestions.usage-BwO9Hjsx.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trismegisto-spine-auto-service-suggestions.usage-BwO9Hjsx.mjs","sources":["../../../projects/ui/auto-service/src/docs/suggestions.usage.ts"],"sourcesContent":["// Manual de uso da tela Sugestões do auto-serviço (`RouteDocument.load`), em Markdown. Módulo próprio, carregado só\n// pelo `import()` de `AUTO_SERVICE_DOCUMENTS`: vira um chunk à parte no FESM e fica fora do bundle inicial. Não importe\n// estaticamente nem reexporte no `public-api.ts`.\nexport default `# Sugestões\n\nAcompanhe as melhorias que as pessoas pediram nesta aplicação, num quadro por status, e responda a quem pediu.\n\n## Antes de começar\n\nFica na raiz do menu, fora de **Administração** (antes era uma aba da tela **Cliente**). Como nas outras\ntelas do auto-serviço, o client é o do app em que você está logado; com mais de um, escolha no seletor do topo. É\npreciso estar no grupo de administração do projeto desse app e com o crachá **Administrador** ativo.\n\n## Como usar\n\nAs pessoas pedem melhorias pelo botão **Sugerir melhoria** da barra de cada tela (tipo, título, descrição e a tela de\nonde vieram). Toda sugestão chega **Em análise**. No topo, escolha **Quadro** (o que está andando) ou **Arquivo** (o\nque já saiu do quadro).\n\n## Quadro\n\n- **Indicadores**: **Abertas** (em análise, planejadas e em desenvolvimento), quantas há em cada coluna, as\n  **Atribuídas a mim**, as **Vencidas**, as **Concluídas em 7 dias** e a **Mais votada**. Contam o quadro inteiro, sem\n  os filtros; clicar em **Atribuídas a mim** ou **Vencidas** filtra o quadro por elas.\n- **Criar**: **Nova tarefa** (no topo) abre a tarefa em branco: título, coluna, tipo, prioridade, datas, descrição,\n  rótulos e **Atribuir a mim**. O **+** no cabeçalho de cada coluna cria rápido: escreva o título e tecle **Enter**\n  (o campo fica aberto para a próxima; **Esc** fecha). Tarefas criadas pela equipe aparecem como **Criada pela equipe**.\n- **Filtros**: **Buscar sugestões** (título, descrição, tela ou a chave, como **SUG-12**, sem diferenciar acentos),\n  **Responsável** (**Minhas**, **Sem responsável** ou uma pessoa), **Rótulo**, **Prioridade**, **Prazo** (**Vencidas**\n  ou **Vencem hoje ou amanhã**), **Tipo**, **Tela** e **Quem pediu**; **Ordenar** pela ordem do quadro, mais votadas,\n  mais recentes, prioridade ou prazo.\n- Uma coluna por status: **Em análise**, **Planejada**, **Em desenvolvimento** e **Concluída**. Concluídas saem do\n  quadro 7 dias depois; recusadas e arquivadas saem na hora: todas ficam no **Arquivo**.\n- Cada cartão mostra a **capa** (se tiver), a **chave** (SUG-12), o **tipo**, os **rótulos**, o **título**, um trecho\n  da descrição, a **tela**, a **prioridade**, o **prazo** (vencida em vermelho; hoje e amanhã em destaque), o\n  **checklist** (feitos/total, e os itens no próprio cartão quando **Mostrar no cartão** está ligado — dá para marcar\n  ali), os comentários, os **apoios** e os rostos dos responsáveis (com **+N**). As 3 com mais apoios têm o selo\n  **Mais votada**.\n- O **⋯** do cartão: **Alterar status**, **Prioridade**, **Atribuir a mim**, **Rótulos**, **Selecionar capa** (cores e\n  gradientes do tema, ou **Remover capa**), **Copiar link** (o link abre a tarefa), **Copiar chave**, **Arquivar** e\n  **Excluir** (pede confirmação; não dá para desfazer).\n- **Arraste** o cartão para outra coluna para mudar o status, ou dentro da coluna para mudar a ordem (a de cima é a\n  primeira da fila; a ordem só muda em **Ordem do quadro**). Pelo teclado: foque o cartão, **Espaço** pega, as setas\n  escolhem o lugar e a coluna, **Espaço** solta e **Esc** cancela. Se a gravação falhar, aparece o aviso e o quadro é\n  recarregado.\n\n## Arquivo\n\nAs arquivadas, as recusadas e as concluídas antigas, por página, com **Buscar no arquivo** e os filtros de status e\ntipo. Numa recusada, **Reabrir** a devolve ao quadro, em **Em análise**; numa arquivada, **Restaurar no quadro** a\ndevolve com o status que tinha.\n\n## Tarefa\n\nClique no **título** do cartão para abrir a tarefa:\n\n- **À esquerda**: o título (clique para editar; **Enter** salva, **Esc** desiste), a **Descrição** (**Editar\n  descrição** abre o editor com negrito, listas e links; **Salvar** grava), o **Checklist** (adicione itens com\n  **Enter**, marque, renomeie, suba/desça, remova; **Mostrar no cartão** põe os itens no cartão) e as abas\n  **Comentários** e **Atividades** (tudo o que mudou, com quem fez e quando).\n- **Comentários**: o que você escreve aparece para quem pediu em **Minhas sugestões**, a não ser que marque **Só para a\n  equipe** (interno: aparece aqui com a etiqueta **Interno** e quem pediu não vê).\n- **À direita**: **Status**, **Responsáveis** (**Atribuir a mim** ou **Adicionar responsável**, buscando pessoas do\n  realm desta aplicação, com foto) e **Envolvidos**, o **Relator** (quem pediu, ou quem criou), **Prioridade**, **Tipo**,\n  **Início** e **Conclusão**, **Rótulos** (escolha do catálogo do app ou crie um novo com a cor), **Capa**, a **Tela de\n  origem** (com **Abrir a tela**, quando o client administrado é o deste app), os **Apoios**, quando foi criada e\n  atualizada e a **última alteração**, com quem fez. A **chave** tem **Copiar**. **Arquivar** e **Excluir** ficam no\n  fim. Cada mudança é gravada na hora.\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,wBAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiEd;;"}