# Ramais

> Ver `docs/ramais/ramais.md` para o detalhamento técnico. Ver `CLAUDE.md` na raiz para arquitetura geral/transversal do Portal.

Diretório de ramais internos (`ramais.html`). A listagem é **automática**: todo colaborador ativo já aparece sozinho (montado a partir do cadastro de Usuários), com o ramal pendente até ser preenchido; linhas avulsas (telefone de sala, recepção etc.) são cadastradas à parte. Mostra também colaborador ausente e aniversariante do dia.

A tela é uma seção com 5 subtelas por abas: **Ramais** (diretório), **Responsável no Tareffa** (placeholder), **Telefones Externos**, **Férias** (placeholder) e **Funções de Telefonia** — cada aba com sua própria permissão de visualização, e as 3 administráveis (Ramais, Telefones Externos, Funções de Telefonia) com permissão de edição própria.

Um modal de consulta rápida (botão "Ramais" no topbar de `portal.html`/`links-ferramentas.html`/`calendario-individual.html`) mostra o mesmo diretório sem precisar navegar até a tela completa.

## Onde mexer

- `Ramal`, `RamalAusencia`, `TelefoneExterno`, `FuncaoTelefonia` (`portal_api/models.py`).
- `ramais.html`/`static/js/ramais.js`/`static/css/ramais.css`.
- `static/js/ramais-lookup.js`/`static/css/ramais-lookup.css` — modal de consulta rápida.