Procedimento — Regras de colunas dos Painéis TV do K|Painel
Complementos: kpainel-admin-CentroCirurgicoEdit.md, guias kpainel-painel-*.md
1. O que é
No Editar Centro Cirúrgico (Admin), a sustentação define quais colunas cada painel TV exibe, além de tempo de paginação, quantidade de linhas, paleta de cores, ordenação (Agendamentos) e limites de horas (Conforto Médico, Acompanhantes, RPA).
Essas regras da tela Admin controlam os painéis em Pages/Paineis. Este guia resume o mapeamento; o detalhe de cada TV está no MD do painel correspondente.
2. Pré-requisitos
- Acesso Admin à listagem Centro Cirúrgicos.
- Centro cirúrgico existente (Ações → Editar).
- Links dos painéis TV já publicados (ou a publicar) em Links de Acesso.
3. Variantes / catálogo — campos da edição do CC → painéis TV
3.1 Seletores de colunas (labels da tela)
| Label na edição do CC | Parâmetro do centro | Painéis TV afetados |
|---|---|---|
| Permite personalizar as colunas que serão exibidas no painel Agendamentos | AGENDAMENTOS_COLUNAS |
Agendamentos / Paginação / Manual |
| … painel Mapa Cirúrgico | MAPA_CIRURGICO_COLUNAS |
Mapa Cirúrgico / Paginação |
| … painel Conforto Médico | CONFORTO_MEDICO_COLUNAS |
Conforto Médico / Paginação |
| … painel Acompanhantes | ACOMPANHANTES_COLUNAS |
Acompanhantes / Paginação |
| … painel RPA | RPA_COLUNAS |
RPA / Paginação; também influem Pré-Cirúrgico e Processos Avulsos (TV) quando preenchido |
Globals de fallback (quando o CC não sobrescreve): PAINEL_AGENDAMENTOS_COLUNAS, PAINEL_MAPA_CIRURGICO_COLUNAS, PAINEL_CONFORTO_MEDICO_COLUNAS, PAINEL_ACOMPANHANTES_COLUNAS, PAINEL_RPA_COLUNAS, PAINEL_PRE_CIRURGICO_COLUNAS.
3.2 Tempos, linhas, paleta e limites
| Label na edição do CC | Parâmetro | Efeito |
|---|---|---|
| Tempo / qtd. linhas Mapa Cirúrgico | MAPA_CIRURGICO_TEMPO_ATU, MAPA_CIRURGICO_QTD_LINHAS |
Paginação do mapa |
| Tempo / qtd. linhas Agendamentos | AGENDAMENTOS_TEMPO_ATU, AGENDAMENTOS_QTD_LINHAS |
Paginação de agendamentos |
| Tempo / qtd. linhas Conforto Médico | CONFORTO_MEDICO_TEMPO_ATU, CONFORTO_MEDICO_QTD_LINHAS |
Paginação conforto |
| Tempo / qtd. linhas RPA | RPA_TEMPO_ATU, RPA_QTD_LINHAS |
Paginação RPA (+ Pré-Cirúrgico / Processos Avulsos TV) |
| Tempo / qtd. linhas Acompanhantes | ACOMPANHANTES_TEMPO_ATU, ACOMPANHANTES_QTD_LINHAS |
Paginação acompanhantes |
| Permite personalizar o tom da cor dos processos nos painéis | PAINEIS_NR_PALETA_COR |
Escala de cores |
| … ordenação dos avisos no painel Agendamentos | AGENDAMENTOS_TP_ORDENACAO |
Ordenação (Cirurgião / Horário) |
| Tempo máx. horas Conforto Médico | CONFORTO_MEDICO_NR_HORAS |
Permanência no painel |
| Tempo máx. horas Acompanhantes | ACOMPANHANTES_NR_HORAS |
Permanência no painel |
| Tempo máx. horas RPA | RPA_NR_HORAS |
Permanência no painel |
3.3 Opções literais dos seletores (exemplos)
- Agendamentos:
SALA,HR/AVISO,OCORRENCIAS,NOME CIVIL,NOME CIVIL ABREVIADO,IDADE,NOME SOCIAL,NOME SOCIAL ABREVIADO,PROCEDIMENTO,PROCEDIMENTO_ABREVIADO,LATERALIDADE,CIRURGIÃO,CIRURGIÃO ABREVIADO,ANESTESISTA,ANESTESISTA ABREVIADO,CONVÊNIO,LEITO,SANGUE,UTI,ISOLAMENTO,PRE-ANE.,PRE-CIRURGICO,CIRCULANTE,OBSERVAÇÃO,OBSERVAÇÃO_DESCRIÇÃO,STATUS,TRANSPORTE - Mapa Cirúrgico: semelhante (sem
OBSERVAÇÃO/TRANSPORTEno seletor) - Conforto Médico / RPA / Acompanhantes: listas menores — ver
CentroCirurgicoEditou o MD do painel
Grafia literal obrigatória: PRE-ANE., PROCEDIMENTO_ABREVIADO, NOME CIVIL ABREVIADO, etc.
4. Onde configurar / Telas do fluxo
Caminho: Admin → Configurações → Centro Cirúrgicos → Ações → Editar → bloco de colunas/paginação dos painéis → Salvar.
4.1 Seletores de colunas
- Abra o seletor do painel desejado.
- Marque/desmarque as colunas (chips).
- Salvar.
- Atualize a TV (ou aguarde o ciclo de refresh) e valide.
4.2 Tempos, linhas e limites
Ajuste segundos/linhas e limites de horas; valide na variante com paginação do painel.
5. Procedimentos relacionados
| Painel TV | Documento |
|---|---|
| Agendamentos | kpainel-painel-Agendamentos.md (+ Paginacao / Manual) |
| Mapa Cirúrgico | kpainel-painel-MapaCirurgico.md (+ Paginacao) |
| Conforto Médico | kpainel-painel-ConfortoMedico.md (+ Paginacao) |
| Acompanhantes | kpainel-painel-Acompanhantes.md (+ Paginacao) |
| RPA | kpainel-painel-RPA.md (+ Paginacao) |
| Pré-Cirúrgico | kpainel-painel-PreCirurgico.md |
| Processos Avulsos (TV) | kpainel-painel-ProcessosAvulsos.md |
| Sala Cirúrgica (TV) | kpainel-painel-SalaCirurgica.md |
6. Publicação / validação
- Salvar no Admin.
- Abrir o link TV em homologação.
- Conferir colunas, ordem visual, paginação e ocultação por horas.
- Em área pública (Acompanhantes), preferir colunas ABREVIADO.
7. Checklist de sustentação
| Sintoma | Verificar |
|---|---|
| Coluna não aparece | Nome literal no seletor; Salvar; refresh da TV |
| CC não sobrescreve | Campo do CC vazio → cai no global PAINEL_*_COLUNAS |
| Paginação errada | *_TEMPO_ATU e *_QTD_LINHAS do painel certo |
| Pré-Cirúrgico / Avulsos TV | Podem reutilizar parâmetros de RPA do CC |
8. Fluxo resumido
Centro Cirúrgicos → Editar → colunas/tempos dos painéis → Salvar → validar na TV.
9. Pontos de atenção
- Painéis TV ≠ Painéis de Bordo.
- Não alterar grafia dos tokens (
PRE-ANE., underscores). - Sala Cirúrgica (TV) não usa seletor de colunas de grade — é layout fixo da sala.
Telas complementares
Demais prints desta funcionalidade, na ordem das capturas.
