====== RF-009 – Portal de Serviços ======

Disponibiliza, dentro do Portal Público do TCE-GO, o catálogo dos serviços do Tribunal e uma página padronizada para cada serviço, exibindo o que ele faz, quem pode acessar, como entrar e o botão de acesso ao serviço.

O catálogo reúne tanto os **serviços do próprio Portal** (Consulta de Processos, Emissão de Certidão, Pautas e Sessões, entre outros) quanto os **serviços fora do Portal** — os antigos sistemas satélites, hospedados em outros endereços do Tribunal.

**Local de acesso:** /servicos (catálogo) e /servicos/[slug-do-servico] (página do serviço)

> Prompt utilizado: documentar-funcionalidade-v1 · versão 1

> **Nota terminológica:** a documentação e a interface adotam **"serviço"** onde antes se lia "sistema". O termo "sistema satélite" permanece apenas como referência histórica ao levantamento de origem.

---

===== Atores =====

^ Nível ^ Perfil ^ Autenticação ^ Abrangência ^
| Público | Cidadão | Não requerida | Acesso a todos os serviços públicos (🟢) |
| Público | Licitantes | Não requerida | Acesso aos serviços públicos ligados às contratações do Tribunal (🟢) |
| Restrito | Órgãos Fiscalizados | Cadastro no serviço | Acesso a serviços com cadastro (🟡) |
| Restrito | Advogado | Cadastro no serviço | Acesso a serviços com cadastro (🟡) |
| Restrito | Servidor | Credenciais institucionais / VPN | Acesso a serviços restritos (🔴) |

> **Nota terminológica:** "Órgãos Fiscalizados" é o termo adotado no Portal para as entidades sujeitas à fiscalização do TCE-GO, antes designadas por "jurisdicionado". O perfil "Servidor" abrange os servidores do Tribunal e do Ministério Público de Contas (MPC-GO).

> **Nota terminológica:** "Listagem pública" designa a relação de serviços exibida ao cidadão no Portal — o conjunto de serviços publicados que o cidadão consegue alcançar, seja pelo catálogo, seja pelo carrossel de serviços relacionados. Serviços ainda não publicados não integram a listagem pública.

> **Nota terminológica:** "Serviço interno" é o que roda dentro do próprio Portal; "serviço externo" é o que roda fora dele, em outro endereço do Tribunal. A distinção determina o aviso exibido ao cidadão antes do acesso (RN08).

> **Escopo deste documento:** aqui está descrita apenas a visão do cidadão — o que ele vê e o que
> acontece quando navega pelo Portal. O formulário de cadastro do serviço, os campos, as condições de
> preenchimento e os papéis de publicação estão na história de administração.

---

===== Telas =====

==== Tela 01 – Página do Serviço ====

A página tem duas colunas: o conteúdo à esquerda e o cartão de acesso à direita, fixo na rolagem. Em telas pequenas o cartão de acesso é promovido para o topo.
{{:pres:gerti:gestao_de_ativos:portal:pasted:20260902-141340.png}}
^ Elemento ^ Tipo ^ Obrigatório ^ Condição de exibição ^
| Cabeçalho da página (ícone, nome do serviço, chamada e trilha de navegação) | Cabeçalho padrão do Portal | Sim | Sempre |
| Botão de favorito | Botão de alternância | Condicional | Serviço com endereço cadastrado e fora de descontinuação |
| Metadados editoriais (autoria, data de publicação e data de atualização) | Barra de metadados | Condicional | Somente quando o registro possui autoria e datas |
| Banner de descontinuação | Alerta com a data informada e o serviço substituto | Condicional | Somente serviços com data de descontinuação informada |
| Bloco "O que é este serviço" | Texto livre | Sim | Sempre |
| Requisitos para acessar | Lista com marcadores, em destaque na cor complementar | Condicional | Abaixo da descrição, sempre visível, somente se o serviço possui requisitos cadastrados |
| Bloco "Quem pode acessar" | Texto livre + etiquetas de perfil | Sim | Sempre |
| Observação editorial | Nota discreta | Condicional | Somente quando o registro possui observação |
| Título "Mais informações" | Título de seção pequeno | Sim | Sempre |
| Seção colapsável: Como acessar | Acordeão com ícone e resumo "N passos" | Sim | Sempre presente |
| → Instruções de acesso | Lista numerada de passos | Sim | Dentro da seção |
| Seção colapsável: Solicitar acesso | Acordeão com ícone e resumo do prazo de resposta | Condicional | Somente se o serviço requer cadastro e possui e-mail de cadastro |
| → E-mail de cadastro | Link clicável (mailto:) | Sim | Dentro da seção |
| → Prazo de resposta | Texto | Sim | Dentro da seção |
| → Informações a enviar na solicitação | Lista com marcadores | Condicional | Quando cadastradas |
| Seção colapsável: Tutoriais e materiais de ajuda | Acordeão com ícone e resumo "N materiais publicados pelo serviço" | Condicional | Somente se o serviço possui ao menos um material cadastrado |
| → Descrição dos materiais | Texto livre | Condicional | Dentro da seção, quando cadastrada |
| → Botão por material de ajuda | Link com rótulo | Sim | Dentro da seção, um por material, na ordem cadastrada |
| Seção colapsável: Suporte técnico | Acordeão com ícone e resumo "telefone · e-mail" | Sim | Sempre presente |
| → Descrição do atendimento e horário | Texto livre | Sim | Dentro da seção |
| → E-mail de atendimento | Link clicável (mailto:) | Sim | Dentro da seção |
| → Telefone de atendimento | Link clicável (tel:) | Sim | Dentro da seção |
| Cartão lateral "Acesso ao serviço" | Cartão fixo na rolagem | Sim | Sempre |
| → Botão "Acessar o Serviço" | Botão de ação | Condicional | Sempre, exceto serviços descontinuados ou sem endereço cadastrado |
| → Aviso de destino do clique | Texto de apoio | Condicional | Junto ao botão; o texto varia entre serviço interno e externo (RN08) |
| → Aviso de indisponibilidade | Nota em caixa neutra | Condicional | No lugar do botão, para serviço descontinuado ou sem endereço |
| → Ficha: tipo de acesso | Selo colorido + explicação | Sim | Sempre |
| → Ficha: módulo | Texto no formato "Módulo do [nome]" | Condicional | Somente serviços marcados como parte de um módulo (ex.: TCEHub) |
| → Ficha: endereço | Texto com ícone | Condicional | Domínio, para serviço externo; "Aqui mesmo, no Portal do TCE-GO", para serviço interno |
| → Bloco "Precisa de ajuda?" | Telefone, e-mail e horário de atendimento | Sim | Sempre |
| Carrossel "Outros serviços" | Carrossel horizontal | Condicional | Quando há outros serviços cadastrados |
| → Botões de navegação ← → | Botões de rolagem | Sim | No cabeçalho do carrossel |
| → Card: selo de acesso | Selo colorido | Sim | Por card |
| → Card: nome do serviço | Texto | Sim | Por card |
| → Card: botão "Mais informações" | Botão secundário (link interno) | Sim | Por card |
| → Card: botão "Acessar serviço" | Botão primário | Condicional | Por card, exceto serviços descontinuados ou sem endereço |
| Link "Ver todos os serviços" | Link interno | Sim | Ao final da seção do carrossel |

==== Tela 02 – Estado: Carregamento ====

^ Elemento ^ Tipo ^ Condição de exibição ^
| Esqueleto animado — faixa do cabeçalho | Esqueleto (animado) | Durante o carregamento |
| Esqueleto animado — coluna de conteúdo | Esqueleto (animado) | Durante o carregamento da página do serviço |
| Esqueleto animado — cartão de acesso | Esqueleto (animado) | Durante o carregamento da página do serviço |
| Esqueleto animado — busca, pills e grade | Esqueleto (animado) | Durante o carregamento do catálogo |

==== Tela 03 – Estado: Erro ====

^ Elemento ^ Tipo ^ Condição de exibição ^
| Página de erro 404 do Portal | Tela padrão do sistema | Endereço não corresponde a serviço publicado (RN01) |
| Tela padrão de erro | Tela padrão do sistema | Qualquer outra falha ao carregar os dados |
| Botão "Tentar novamente" | Botão de ação | Na tela padrão de erro |
| Link "Ver todos os serviços" | Botão secundário | Na tela padrão de erro |
| Contatos do suporte técnico | Links de e-mail e telefone | Na tela padrão de erro |

==== Tela 04 – Catálogo de Serviços ====
{{:pres:gerti:gestao_de_ativos:portal:pasted:20260902-141411.png}}
Índice da área, no padrão dos demais hubs do Portal: busca embutida no cabeçalho, faixa de pills logo abaixo e grade paginada de cards.

^ Elemento ^ Tipo ^ Obrigatório ^ Condição de exibição ^
| Cabeçalho "Portal de Serviços" com trilha de navegação | Cabeçalho padrão do Portal | Sim | Sempre |
| Chamada da área | Texto de destaque + parágrafo de apoio | Sim | Sempre |
| Campo de busca com botão "Pesquisar" | Campo de busca | Sim | Sempre, dentro do cabeçalho |
| Faixa de pills "Quem acessa:" | Pills com contador | Sim | Sempre, sobreposta ao cabeçalho |
| → Pill "Todos" | Pill com o total de serviços | Sim | Sempre |
| → Pill por perfil | Pill com o número de serviços do perfil | Sim | Um por perfil: Cidadão, Órgãos Fiscalizados, Advogado, Licitantes, Servidor |
| Título da seção e contador | Título de seção + descrição no formato "N serviços encontrados" ou "N serviços encontrados para o perfil [perfil]" | Sim | Sempre |
| Link "Limpar filtros" | Link | Condicional | Quando há busca submetida ou perfil selecionado |
| Grade de cards | Grade de 1 a 4 colunas, paginada em 12 itens | Condicional | Quando há resultados |
| → Card: ícone do serviço | Ícone | Sim | Por card |
| → Card: nome e chamada | Texto (chamada limitada a duas linhas; termo buscado destacado) | Sim | Por card |
| → Card: selo de acesso e módulo | Selo colorido + texto | Sim | Por card |
| → Card: aviso de descontinuação | Texto de alerta | Condicional | Por card, serviços com data de descontinuação |
| → Card: botão de favorito | Botão de alternância | Condicional | Serviço com endereço e fora de descontinuação |
| → Card: ação "Ver detalhes" | Link interno | Sim | Por card |
| → Card: ação "Acessar" | Link para o serviço | Condicional | Serviço com endereço e fora de descontinuação |
| Paginação e contador | Paginação padrão do Portal | Condicional | Quando há mais de uma página |
| Estado vazio | Mensagem "Nenhum serviço corresponde à sua busca." + link "Limpar filtros" | Condicional | Quando nenhum serviço corresponde à busca |
| Banner "Não encontrou o que procurava?" | Faixa com contatos do suporte | Sim | Ao final da página |

---

===== Fluxos =====

==== Fluxo 01 – Acesso à Página de um Serviço ====

^ Passo ^ Ação ^ Regra ^ Tela ^
| 01 | Usuário acessa a URL /servicos/[slug] | | |
| 02 | O sistema verifica se o endereço acessado corresponde a um serviço publicado | RN01 | |
| 02.1 | Se o serviço não for encontrado, o sistema exibe a página de erro 404 do Portal | RN01 | Tela 03 |
| 03 | Enquanto busca os dados, o sistema exibe o esqueleto animado de carregamento | | Tela 02 |
| 03.1 | Se a consulta falhar por outro motivo, o sistema exibe a tela padrão de erro, com o botão "Tentar novamente", o link "Ver todos os serviços" e os contatos do suporte | | Tela 03 |
| 04 | O sistema exibe o cabeçalho com ícone, nome e chamada, e o cartão de acesso na lateral | RN02, RN13 | Tela 01 |
| 04.1 | Se o registro possui autoria e datas, o sistema exibe a barra de metadados editoriais no topo do conteúdo | RN12 | Tela 01 |
| 05 | O sistema exibe a descrição do serviço e, em seguida, o bloco "Quem pode acessar" | RN02, RN03 | Tela 01 |
| 05.1 | Se o serviço possui requisitos de acesso, eles são exibidos entre a descrição e o bloco "Quem pode acessar", sempre visíveis | RN04, RN05 | Tela 01 |
| 05.2 | Se o registro possui observação editorial, ela é exibida ao final do bloco de conteúdo | | Tela 01 |
| 06 | Se o serviço está em descontinuação, o sistema exibe o banner de alerta no topo do conteúdo e não exibe o botão de acesso | RN09 | Tela 01 |
| 07 | O cartão de acesso informa, junto ao botão, o destino do clique | RN08 | Tela 01 |
| 08 | O sistema exibe as seções "Como acessar" e "Suporte técnico", recolhidas por padrão | RN06, RN10 | Tela 01 |
| 08.1 | Se o serviço requer cadastro e possui e-mail de cadastro, o sistema exibe também a seção "Solicitar acesso", recolhida por padrão | RN06 | Tela 01 |
| 08.2 | Se o serviço possui materiais de apoio, o sistema exibe também a seção "Tutoriais e materiais de ajuda", recolhida por padrão | RN06, RN11 | Tela 01 |
| 09 | Usuário expande uma das seções e o sistema exibe o conteúdo correspondente | RN06 | Tela 01 |
| 10 | O sistema exibe o carrossel de serviços relacionados ao final da página | RN14 | Tela 01 |

==== Fluxo 02 – Acesso ao Serviço ====

^ Passo ^ Ação ^ Regra ^ Tela ^
| 01 | Usuário lê, junto ao botão, o aviso de destino do clique | RN08 | Tela 01 |
| 02 | Usuário clica no botão "Acessar o Serviço" | RN07 | Tela 01 |
| 03 | O serviço é aberto na mesma aba do navegador | RN08 | |
| 03.1 | Serviço interno: a navegação segue dentro do Portal | RN08 | |
| 03.2 | Serviço externo: o navegador sai do Portal para o endereço do serviço | RN08 | |
| 04 | Se o serviço está em descontinuação ou não tem endereço divulgado, o botão não é exibido e o cartão orienta a procurar o suporte técnico | RN09 | Tela 01 |

==== Fluxo 03 – Navegação no Carrossel de Serviços Relacionados ====

^ Passo ^ Ação ^ Regra ^ Tela ^
| 01 | Usuário clica nos botões ← → do carrossel | | Tela 01 |
| 02 | O carrossel avança ou recua exibindo os próximos serviços | RN14 | Tela 01 |
| 03 | Usuário clica em "Mais informações" de um card | | Tela 01 |
| 04 | O sistema abre a página do serviço selecionado, mantendo a navegação no Portal | | Tela 01 |
| 05 | Usuário clica em "Acessar serviço" de um card | | Tela 01 |
| 06 | O serviço é aberto na mesma aba do navegador | RN08 | |
| 07 | Usuário clica em "Ver todos os serviços" e o sistema abre o catálogo | | Tela 04 |

==== Fluxo 04 – Busca e Filtro no Catálogo ====

^ Passo ^ Ação ^ Regra ^ Tela ^
| 01 | Usuário acessa a URL /servicos | | Tela 04 |
| 02 | Enquanto busca os dados, o sistema exibe o esqueleto animado de carregamento | | Tela 02 |
| 03 | O sistema exibe todos os serviços publicados, em grade paginada de 12 itens por página | RN15 | Tela 04 |
| 03.1 | O sistema exibe o total de resultados no formato "N serviços encontrados" | | Tela 04 |
| 04 | Usuário digita o termo e aciona "Pesquisar" ou a tecla Enter | RN16 | Tela 04 |
| 04.1 | Termo com menos de 3 caracteres não altera a listagem | RN16 | Tela 04 |
| 04.2 | Nos resultados, o termo buscado aparece destacado no nome e na chamada de cada card | | Tela 04 |
| 05 | Usuário seleciona um pill de perfil | RN17 | Tela 04 |
| 05.1 | Clicar no pill já selecionado remove o filtro | RN17 | Tela 04 |
| 05.2 | Com perfil selecionado, o total passa a ser exibido como "N serviços encontrados para o perfil [perfil]" | | Tela 04 |
| 06 | O sistema atualiza a listagem, o total e a paginação, e anuncia a mudança a leitores de tela | | Tela 04 |
| 06.1 | Se nenhum serviço corresponder, o sistema exibe o estado vazio com a mensagem "Nenhum serviço corresponde à sua busca." e o link "Limpar filtros" | | Tela 04 |
| 07 | Usuário aciona "Limpar filtros" e o sistema volta à listagem completa | RN17 | Tela 04 |
| 08 | Usuário clica em "Ver detalhes" de um card e o sistema abre a página do serviço | | Tela 01 |
| 09 | Usuário clica em "Acessar" de um card e o serviço é aberto na mesma aba | RN08 | |

==== Fluxo 05 – Favoritar um Serviço ====

^ Passo ^ Ação ^ Regra ^ Tela ^
| 01 | Usuário aciona o botão de favorito no card do catálogo ou no cabeçalho da página do serviço | RN18 | Telas 01 e 04 |
| 02 | O sistema registra o serviço na relação de favoritos do navegador e o botão passa ao estado ativo | RN18 | Telas 01 e 04 |
| 03 | Acionar novamente o botão remove o serviço dos favoritos | RN18 | Telas 01 e 04 |
| 04 | Serviço em descontinuação ou sem endereço divulgado não exibe o botão de favorito | RN09, RN18 | Telas 01 e 04 |

---

===== RN – Regras de Negócio =====

^ Regra ^ Descrição ^
| RN01 | O endereço acessado é validado contra a relação de serviços publicados. Endereço que não corresponda a um serviço publicado — inclusive o de serviço ainda não publicado ou já removido — resulta em erro 404. |
| RN02 | A estrutura da página é padronizada entre todos os serviços, variando apenas o conteúdo exibido conforme os dados disponíveis no registro. |
| RN03 | Descrições e textos visíveis ao usuário não contêm siglas sem explicação. A sigla é expandida no texto na primeira ocorrência (ex: TCE-GO — Tribunal de Contas do Estado de Goiás). |
| RN04 | Os requisitos de acesso não ficam em seção colapsável: são exibidos junto da descrição do serviço, antes do botão de acesso, porque o usuário precisa conhecê-los antes de tentar entrar. Aplicável a serviços com cadastro (🟡) e restritos (🔴). |
| RN05 | A exigência de credencial institucional ou de rede privada virtual (VPN) é informada ao usuário antes do acesso, entre os requisitos e na explicação do tipo de acesso: "Uso interno — exige credencial institucional e, em alguns casos, a rede privada virtual (VPN) do Tribunal." |
| RN06 | As informações secundárias do serviço são exibidas recolhidas por padrão e expandidas sob demanda, para que o caminho até o serviço permaneça curto. |
| RN07 | O acesso ao serviço é concluído em no máximo 2 interações: chegada na página e clique no botão de acesso. |
| RN08 | O serviço é aberto **na mesma aba** do navegador. Antes do clique, o Portal informa o destino: serviço interno exibe "Ao clicar, você será levado ao serviço aqui mesmo no Portal, na mesma aba."; serviço externo exibe "Ao clicar, você será redirecionado para um serviço disponibilizado pelo TCE-GO, fora do Portal." |
| RN09 | Serviço com data de descontinuação informada exibe banner de alerta com a data e, quando houver, o serviço substituto. Em nenhum ponto do Portal esse serviço oferece acesso direto nem pode ser favoritado. O mesmo vale para serviço cujo endereço ainda não foi divulgado. |
| RN10 | O canal de suporte do serviço é o padrão do Tribunal — e-mail informatica@tce.go.gov.br, telefone (62) 3228-2862 e atendimento de segunda a sexta, das 8h às 18h —, salvo quando o registro do serviço declara canal próprio, caso em que valem os dados do registro. |
| RN11 | Os materiais de apoio do serviço são exibidos na ordem em que foram cadastrados. Serviço sem material não exibe a seção de tutoriais. |
| RN12 | A página do serviço exibe, no topo do conteúdo, o responsável pela publicação, a data de criação e a data da última atualização, quando o registro possui esses dados. |
| RN13 | O tipo de acesso é comunicado por selo com rótulo textual e cor: 🟢 "Público" na cor de sucesso, 🟡 "Com cadastro" na cor complementar, 🔴 "Restrito" na cor primária e "A confirmar" na cor neutra. O rótulo acompanha sempre a cor — o tipo nunca é comunicado apenas por cor. |
| RN14 | O carrossel exibe até 8 serviços relacionados, excluído o serviço em exibição, ordenados pela seguinte precedência: \\ 1. serviços que atendem ao mesmo público-alvo do serviço exibido (ex: Cidadão, Órgãos Fiscalizados, Servidor); \\ 2. serviços do mesmo módulo (ex.: TCEHub); \\ 3. demais serviços por tipo de acesso, do mais aberto ao mais restrito (Público 🟢 → Com cadastro 🟡 → Restrito 🔴); \\ 4. serviços a confirmar ou sem classificação definida, por último. |
| RN15 | O catálogo reúne todos os serviços publicados, tanto os que rodam no próprio Portal quanto os que rodam fora dele. |
| RN16 | A busca do catálogo exige no mínimo 3 caracteres, ignora acentuação e diferença entre maiúsculas e minúsculas e considera nome, chamada, descrição, módulo e perfis do serviço. Todos os termos digitados precisam ser encontrados. |
| RN17 | O catálogo tem um único filtro: o perfil de quem acessa. Não há filtro por tipo de acesso — o nível é comunicado pelo selo de cada card e pela página do serviço. |
| RN18 | Serviços com endereço divulgado e fora de descontinuação podem ser favoritados. A relação de favoritos é gravada no navegador do usuário e não exige autenticação. |

---

===== Histórico =====

^ Data ^ Alteração ^ Motivo ^
| 2026-09-02 | Removida a seção "Atores da gestão de conteúdo (WordPress)" e incluída a nota de escopo do documento | O formulário de cadastro e os papéis de publicação são matéria da história de administração |
| 2026-09-02 | RN34 removida; número mantido vago | Descrevia o tipo do campo no formulário de cadastro, e não o que o cidadão vê |
| 2026-09-02 | RN14, RN22, RN29, RN33 e a nota de serviço interno reescritas sem referência ao formulário de cadastro, ao gestor de conteúdo e à ferramenta de publicação | Documento restrito à visão do cidadão |
| 2026-09-02 | Regras revisadas e renumeradas: as que descreviam comportamento de tela — esqueleto de carregamento, tela de erro, presença e conteúdo de cada seção, conteúdo do card, formato do contador, estado vazio, posição do cartão de acesso, navegação dos links internos e exibição do módulo — deixaram a tabela e passaram a constar como passos dos fluxos e como elementos das telas | A tabela de regras passou a conter apenas decisões de negócio, e não a descrição da interface |
| 2026-09-02 | Regras consolidadas: as três regras de erro 404 viraram uma; a exibição do botão de acesso e do favorito em serviço descontinuado passou para a regra de descontinuação; a definição de serviço interno e externo ficou apenas na nota terminológica | Regras que repetiam o mesmo comportamento em enunciados diferentes |
| 2026-09-02 | Numeração passou a ser RN01–RN18, abandonando a numeração anterior | Renumeração determinada por Requisitos na revisão das regras; os cenários de teste serão revistos em momento próprio |