@trismegisto/spine 3.3.3 → 3.3.5

package/fesm2022/trismegisto-spine-auto-service-groups.technical-_jQrg1Qh.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"trismegisto-spine-auto-service-groups.technical-_jQrg1Qh.mjs","sources":["../../../projects/ui/auto-service/src/docs/groups.technical.ts"],"sourcesContent":["// Especificação técnica da tela Grupos 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 `# Grupos — especificação técnica\n\nTela \\`AutoServiceGroupsComponent\\`, ligada ao router de template \\`AUTO_SERVICE_GROUPS_TEMPLATE_ROUTER_ID\\`\n(\\`ad100001-…\\`). Fala com o argos-admin-server em \\`{adminApi}/auto-service\\` (\\`AutoServiceService\\`), com o token no\ncabeçalho \\`x-access-token\\`. Peças: dois \\`hm-combobox\\` (nível de acesso e grupo) + Consultar, \\`AutoServiceGroupModalComponent\\` (criar/editar),\n\\`AutoServiceGroupMembersComponent\\` (membros do grupo aberto) e \\`AutoServiceGroupMembersModalComponent\\`.\n\n## Endpoints\n\n| Ação | Endpoint |\n| --- | --- |\n| Client administrado (só o do token) | \\`GET /auto-service\\` |\n| Grupos do projeto do client | \\`GET /auto-service/:clientId/groups\\` (\\`{ id, name, description, enabled, type }\\`, sem o grupo de administração) |\n| Tipos de grupo do realm | \\`GET /auto-service/:clientId/group-types\\` (\\`{ id, name, level, assignable }\\`) |\n| Criar grupo | \\`POST /auto-service/:clientId/groups\\` (\\`{ name, type_id, description? }\\`) |\n| Editar grupo | \\`PUT /auto-service/:clientId/groups/:groupId\\` (\\`{ name, type_id, description, enabled }\\`) |\n| Excluir grupo | \\`DELETE /auto-service/:clientId/groups/:groupId\\` |\n| Membros do grupo | \\`GET /auto-service/:clientId/groups/:groupId/members\\` |\n| Busca de usuários | \\`GET /auto-service/:clientId/users?search=&limit=\\` |\n| Sugestões de membro | \\`GET /auto-service/:clientId/groups/:groupId/member-suggestions?limit=8\\` (quem está em outros grupos do projeto e não neste, com foto e os grupos) |\n| Adicionar membro | \\`POST /auto-service/:clientId/groups/:groupId/members\\` (\\`{ user_id, role }\\`) |\n| Trocar a função | \\`PUT /auto-service/:clientId/groups/:groupId/members/:userId\\` (\\`{ role }\\`) |\n| Remover membro | \\`DELETE /auto-service/:clientId/groups/:groupId/members/:userId\\` |\n\n## Regras\n\n- **Autorização** (\\`clientAdminGuard\\` no servidor): o \\`sub\\` é membro do grupo de administração (\\`is_admin\\`,\n  habilitado) do projeto do client **e** está com o crachá Administrador ativo. Todo token só administra o client em\n  que foi emitido: \\`GET /auto-service\\` devolve só ele. O seletor de client\n  (\\`AutoServiceClientPickerComponent\\`) mostra \\`loading\\` enquanto busca; com um client, escolhe sozinho e não desenha\n  mais nada; com nenhum, mostra\n  \\`autoService.noClients\\`; a combobox só aparece se a API devolver mais de um.\n- Grupo de outro projeto responde \\`404\\` (\\`assertGroupBelongsToClient\\`).\n- Seletores: grupos e tipos carregados juntos ao escolher o client. **Nível de acesso** (\\`levelOptions\\`): os tipos\n  de \\`group-types\\` com \\`assignable !== false\\` ou com algum grupo na lista (o Administrador fica de fora), mais os tipos\n  que só aparecem nos grupos (sem a rota de tipos) e \"Sem nível\" (\\`NO_LEVEL\\`) se algum grupo não tiver tipo; do\n  \\`level\\` maior para o menor. **Grupo** (\\`groupOptions\\`): só os do nível escolhido, em ordem alfabética; trocar o\n  nível limpa o grupo. **Consultar** abre o grupo (resumo com Editar/Excluir + membros); abrir um grupo aponta os dois\n  seletores para ele. Depois de criar/editar/excluir a lista recarrega; o grupo aberto é trocado pela versão nova (ou\n  fecha, se sumiu); o grupo recém-criado já abre. (Na 3.0.0 a lista era um \\`hm-data-grid\\`; voltou ao seletor a\n  pedido do usuário.)\n- Modal: nome obrigatório (1–100, aparado), tipo obrigatório, descrição opcional; na criação a descrição vazia não\n  vai no corpo; na edição vai como \\`null\\` (apaga). Tipos oferecidos: só \\`assignable !== false\\`. A falha aparece no\n  modal (\\`hm-alert\\`) e o modal continua aberto.\n- **Grupo de administração** (\\`is_admin\\`): gerido só no painel central (Argos), não aparece no auto-serviço. O\n  servidor não o devolve em \\`GET /groups\\` e responde \\`404\\` a editar, excluir e mexer nos membros dele (como grupo\n  de outro projeto). Servidor antigo que ainda o devolva (\\`is_admin: true\\`): a tela descarta na carga da lista\n  (\\`load\\`) e na lista de grupos do novo acesso (**Cliente › Acesso**). O Administrador (\\`assignable: false\\`)\n  nunca entra nos tipos do modal. Os textos \\`adminGroupTag\\`, \\`adminGroupNote\\`, \\`adminGroupEditNote\\` e\n  \\`adminGroupLastMemberWarning\\` saíram do catálogo na 3.3.1.\n- **Erros** (\\`autoServiceErrorText\\`, em \\`auto-service-errors.ts\\`): o código \\`error\\` da resposta vira o texto de\n  \\`autoService.groupErrors\\` no idioma ativo — \\`invalid_type\\`, \\`admin_type_reserved\\`, \\`empty_update\\`,\n  \\`group_project_immutable\\` (400); \\`group_name_taken\\`, \\`admin_group_immutable\\`, \\`admin_group_protected\\`,\n  \\`admin_group_last_member\\`, \\`admin_group_access_protected\\` (409; de servidor antigo — o atual responde 404 ao\n  grupo de administração); \\`404\\` de grupo → \\`groupNotFound\\`. Código\n  desconhecido usa o \\`detail\\` do servidor e, por último, o texto genérico (\\`groupSaveError\\`, \\`membersSaveError\\` ou\n  \\`deleteError\\`). O \\`AutoServiceDeleteFeedback\\` usa a mesma função em todas as exclusões do auto-serviço.\n- Sugestões: até 8, da rota própria (ordem do servidor: mais grupos do projeto primeiro), em chips; sem \"ver mais\".\n  Falha na rota deixa sem sugestões. Busca: a partir de 2 caracteres, depois de 300 ms sem digitar, \\`limit=10\\`.\n  Membros atuais são retirados dos dois.\n- Funções oferecidas pela tela: Administrador e Editor; vazio grava \\`role: null\\` (membro sem função, que só vê os outros\\n  membros nas configurações do app). Outro valor o servidor recusa (\\`400 invalid_role\\`).\n- **Salvar alterações** grava só a diferença, em sequência: adições, depois remoções, depois trocas de função (dos\n  membros que ficaram). Ao terminar, emite \\`saved\\` e a tabela de membros recarrega. Se uma chamada falhar, o modal mostra o\n  erro, emite \\`saved\\` (parte pode ter sido gravada) e recarrega os membros.\n`;\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA,uBAAe,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEd;;"}

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

@@ -1 +0,0 @@
-{"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;;"}