# Épico 5 — Menu Lateral — Mapeamento de Banco de Dados (v1.4)

**Documentos deste épico:** [01 - Definição](./01%20-%20Defini%C3%A7%C3%A3o%20v1.7.md) (v1.7) · [02 - Especificação](./02%20-%20Especifica%C3%A7%C3%A3o%20v1.4.md) (v1.4) · [03 - Protótipo](./03%20-%20Prot%C3%B3tipo%20v1.4.md) (v1.4, código executável em `03 - Protótipo v1.4.html`) · [04 - Mapeamento de Banco de Dados](./04%20-%20Mapeamento%20de%20Banco%20de%20Dados%20v1.4.md) (v1.4). Este épico faz parte do documento guarda-chuva [Check-in de Usuários](../00%20-%20Guarda-chuva%20v2.20.md).

---

## SEÇÃO 4 — MAPEAMENTO DE BANCO DE DADOS

### Tabelas existentes utilizadas

|Tabela|Banco|Campos utilizados neste épico|
|---|---|---|
|Processo|IpSeguranca|Id, Processo (código único), Nome, Icone, Contexto, ProcessoGrupoId, Rota, RemovidoEm — cada linha é um item de menu/funcionalidade do sistema; `Icone` referencia um nome de ícone de lucide.dev/icons ou react-icons.github.io, nunca um arquivo próprio|
|ProcessoGrupo|IpSeguranca|Id, Nome — agrupamento sem hierarquia (sem campo de grupo pai); confirma a estrutura de camada única descrita em RN-CIU-026|
|ClienteProcesso|IpSeguranca|Id, ProcessoId, ClienteBDId, RemovidoEm — liga um Processo ao banco do cliente (tenant), isto é, marca quais Processo estão habilitados/licenciados para aquele cliente, independentemente de qualquer perfil de acesso|
|ClientePerfilAcesso|IpSeguranca|Id, Nome, ClienteBDId — perfil de acesso (papel) do cliente; já mapeado em CIU-E1/E3/E6|
|ClientePerfilAcessoUsuario|IpSeguranca|Id, ClientePerfilAcessoId, UsuarioClienteId, ClienteEmpresaId — vínculo entre um usuário, seu perfil de acesso e a clínica específica em que esse perfil vale; já mapeado em CIU-E1/E3/E6 — é a partir daqui que o perfil de acesso vigente na clínica atual é resolvido para montar o menu; mais `CodProfissional` (`char(3)`, nullable — campo novo confirmado pelo solicitante, estrutura e domínio de valores definidos, migração real pendente, ver "Campo novo proposto" abaixo)|
|ClientePerfilAcessoProcesso|IpSeguranca|Id, ClientePerfilAcessoId, ClienteProcessoId, ExibeMenu (default 'S'), Ordem, RemovidoEm — liga um ClientePerfilAcesso a um ClienteProcesso; um item só aparece no menu (RN-CIU-027) quando existe aqui uma linha com `ExibeMenu = 'S'` para o perfil de acesso vigente; `Ordem` define a posição do item dentro do grupo (ou da lista sem grupo) para aquele perfil especificamente|
|ClienteUsuarioMenuFavorito|IpSeguranca|ClientePerfilAcessoUsuarioId, ClientePerfilAcessoProcessoId (PK composta), ProcessoAbertura (default 'N'), RemovidoEm — a existência de uma linha ativa para o par (usuário/perfil/clínica × item) é o próprio favorito (RN-CIU-028); como `ClientePerfilAcessoUsuarioId` já é específico por clínica, o favorito é, por construção, específico por clínica também — é essa a origem do comportamento descrito em RN-CIU-028 (favorito não se repete automaticamente ao trocar de clínica); `ProcessoAbertura = 'S'` marca a escolha do usuário de tela inicial do sistema (RN-CIU-028) — sobrepõe o cockpit padrão quando presente|
|ClienteEmpresa|IpSeguranca|Id, Nome, CaminhoLogo — a partir desta versão, consultada também para montar o menu: `Nome`/`CaminhoLogo` alimentam o campo `clinicaAtual` da resposta de `GET /api/v1/menu` (**[PROPOSTA]**, cabeçalho do menu, Seção 2), mesmos campos já usados por E3/E6 para identificação de clínica; `ClientePerfilAcessoUsuario.ClienteEmpresaId` segue sendo o campo que amarra perfil de acesso à clínica específica (já mapeado em CIU-E1/E3/E6)|

Nenhuma tabela nova. Toda a estrutura necessária — itens de menu, agrupamento, habilitação por cliente, liberação e ordem por perfil de acesso, favoritos, e agora também a identificação da clínica no cabeçalho do menu — já existe em produção no banco IpSeguranca.

### Schema legado identificado e descartado

O banco de template `GescomZeradoPadronizacao` (mesmo arquivo de origem da Biblioteca de Schema) tem uma estrutura equivalente e mais antiga para menu: `SegMenu`, `SegPastaMenu`, `SegMenuGrupo` e `SegMenuDetalhe` — esta última com um campo `PaginaInicial` que corresponde, na estrutura legada, ao mesmo papel do campo `ProcessoAbertura` de `ClienteUsuarioMenuFavorito` na estrutura atual — correspondência que ajudou a localizar o campo, com o significado hoje confirmado na Seção 1 (RN-CIU-028).

Essa estrutura legada foi identificada e descartada em favor do schema moderno acima: pertence ao banco de template pré-Clean-Architecture, chaveado por identificadores numéricos locais (`smallint`) em vez de `uniqueidentifier`, e não tem nenhum dos conceitos centrais da arquitetura atual — não existe `Cliente`, `ClienteBD` (banco por tenant) nem `ClienteEmpresa` (clínica) na cadeia de chaves de `SegMenuDetalhe`, apenas um `IdUsuario` local. Não é uma base compatível com o modelo multi-tenant deste projeto.

### Campo novo proposto: `ClientePerfilAcessoUsuario.CodProfissional`

A Seção 1 (RN-CIU-028) documenta que, na ausência de uma escolha manual de tela inicial, a tela inicial padrão do usuário é seu próprio cockpit, quando seu perfil de acesso tiver um indicado. Esse indicador não existe hoje em nenhuma base consultada (Biblioteca de Schema (DDL) nem `EsquemaGemed21.csv` — checado em 15/09/2026) — confirmado pelo solicitante como campo novo a criar:

|Campo|Tabela|Tipo|Obrigatoriedade|Valor padrão|Descrição|
|---|---|---|---|---|---|
|`CodProfissional`|`ClientePerfilAcessoUsuario` (IpSeguranca)|`char(3)`|Nullable — confirmado pelo solicitante; ausência de código é o que produz "sem tela inicial" (RN-CIU-028) quando também não há escolha manual|Sem valor padrão (NULL)|Código do tipo de cockpit/central padrão do usuário nessa combinação perfil × clínica — determina qual cockpit abre como tela inicial na ausência de uma escolha manual de tela inicial (RN-CIU-028). Nome, tabela, tipo, nullability e domínio de valores confirmados pelo solicitante. Domínio: `MED`, `ENF`, `FAR`, `REC`, `ADM`, `BKO` — cada valor aponta para a central (cockpit) correspondente; `MED`/`ENF`/`FAR`/`BKO` correspondem aos fluxos por profissional já documentados no projeto (médico, enfermagem, farmácia, backoffice), `REC`/`ADM` apontam para centrais ainda não especificadas em nenhum épico consultado até aqui.|

Migração (estrutura confirmada pelo solicitante; execução real no banco ainda pendente): `ALTER TABLE IPSeguranca.dbo.ClientePerfilAcessoUsuario ADD CodProfissional char(3) NULL` — pendente de execução real no banco e de registro na Biblioteca de Schema (DDL) depois de aplicada. Ver `Log de Mudanças Estruturais do Banco de Dados`, entrada de 15/09/2026 (atualizada nesta versão).

### Seeds da Funcionalidade

|Seed|Tabela(s)|Por cliente ou global?|Status|Detalhe completo|
|---|---|---|---|---|
|Item de menu "Suporte Gemed" (link externo à aplicação de suporte técnico da Interprocess TI)|Processo (mais ClienteProcesso e ClientePerfilAcessoProcesso, por cliente/perfil, para habilitá-lo)|Global o cadastro do Processo; a habilitação por cliente e perfil de acesso é individual|**[PROPOSTA]** — item de exemplo, existência e nome exatos a confirmar contra o mockup original do menu, hoje indisponível|01 - Definição, "Lista consolidada de itens [PROPOSTA]", item 2|
|Árvore completa de grupos e itens do menu (quais Processo existem, em quais ProcessoGrupo, com quais ícones e rotas)|Processo, ProcessoGrupo, ClienteProcesso, ClientePerfilAcessoProcesso|Processo/ProcessoGrupo globais; ClienteProcesso e ClientePerfilAcessoProcesso por cliente/perfil|**[PROPOSTA]** — pendente de um levantamento de produto que substitua o mockup perdido; sem essa árvore, nenhum cliente novo tem menu funcional além dos módulos já especificados individualmente (Central do Médico/Cockpit, Agenda do Médico)|01 - Definição, "Lista consolidada de itens [PROPOSTA]", item 1|

Nenhum parâmetro de configuração (`IpParametro`/`IpParametroChave` ou equivalente) é necessário para esta funcionalidade — o comportamento do menu (filtragem, favoritos, busca, responsividade) não depende de nenhum valor configurável por cliente além da própria estrutura de `Processo`/`ClientePerfilAcessoProcesso` já listada acima.

---

## Histórico de Versões

- **v1.4** (15/09/2026) — pedido do solicitante ao revisar o protótipo: `ClienteEmpresa` passa de "não consultada para montar o menu" para efetivamente consultada — `Nome` e `CaminhoLogo` alimentam o novo campo `clinicaAtual` (**[PROPOSTA]**) da resposta de `GET /api/v1/menu`, para o cabeçalho do menu exibir o nome da clínica atual (Seção 2, "Cabeçalho do Menu"). Mesmos campos de `ClienteEmpresa` já usados por E3/E6 para nome/logo de clínica — nenhuma estrutura nova, nenhuma tabela nova.
- **v1.3** (15/09/2026) — confirmados pelo solicitante os dois atributos de `CodProfissional` que seguiam [PROPOSTA]: nullable; domínio `MED`, `ENF`, `FAR`, `REC`, `ADM`, `BKO` (cada código aponta para a central/cockpit correspondente). Tabela de especificação do campo e migração sugerida atualizadas para refletir a estrutura confirmada — só a execução real da migração no banco segue pendente. `Log de Mudanças Estruturais do Banco de Dados` atualizado.
- **v1.2** (15/09/2026) — confirmada pelo solicitante a criação de `ClientePerfilAcessoUsuario.CodProfissional`, `char(3)` — a pendência técnica anterior (campo não localizado) vira proposta de estrutura: nova subseção "Campo novo proposto" substitui "Pendência técnica: campo do cockpit padrão", com a migração sugerida. Nullability e domínio de valores do campo seguem [PROPOSTA], não confirmados pelo solicitante. `Log de Mudanças Estruturais do Banco de Dados` atualizado.
- **v1.1** (15/09/2026) — `ClienteUsuarioMenuFavorito.ProcessoAbertura` deixa de ser [PROPOSTA]: confirmado como o indicador da escolha do usuário de tela inicial do sistema (RN-CIU-028), sobrepondo o cockpit padrão quando presente. Novo achado: o campo que identifica o cockpit padrão do usuário em `ClientePerfilAcessoUsuario`, citado pelo solicitante, não foi localizado na Biblioteca de Schema (DDL) nem no `EsquemaGemed21.csv` — registrado como pendência técnica nesta seção e no `Log de Mudanças Estruturais do Banco de Dados`.
- **v1.0** (15/09/2026) — versão inicial do épico. Estrutura de dados localizada por completo na Biblioteca de Schema (DDL), banco IpSeguranca — nenhuma tabela nova. Schema legado equivalente (`GescomZeradoPadronizacao.dbo.SegMenu`/`SegPastaMenu`/`SegMenuGrupo`/`SegMenuDetalhe`) identificado e descartado, com a correspondência de `SegMenuDetalhe.PaginaInicial` registrada como base da interpretação [PROPOSTA] de `ClienteUsuarioMenuFavorito.ProcessoAbertura`. Dois seeds registrados como [PROPOSTA] — item "Suporte Gemed" e a árvore completa de grupos/itens do menu, ambos pendentes do mockup original perdido.