# 2026-04-16 - Escopo da agenda por contrato e seed Alpha

Alinhamos a agenda operacional ao modelo atual por contratos, removendo a dependencia pratica das tabelas legadas de unidade e ajustando o seed de demonstracao para a hierarquia `corretora > empresa > unidade`.

## O que mudou

- corrigimos o seed operacional da Empresa Alpha / Unidade Centro para nao depender mais de `wpjy_parceiros_unidades`
- passamos a popular o agendamento seed com os identificadores reais usados hoje pela tabela `wpjy_parceiros_profissionais_agendamentos`, respeitando `empresa_id` e `unidade_id` com os IDs de contrato
- ajustamos a resolucao do contexto atual da unidade para que o fallback por contrato devolva o proprio contrato como identificador operacional da tela
- reforcamos a leitura da listagem de agendamentos para resolver unidade e nome da unidade mesmo em bases sem `parceiros_unidades`
- corrigimos o escopo operacional da agenda para usar o contrato ativo da area e sua hierarquia:
  - `UNIDADE` ve apenas os agendamentos da propria unidade
  - `EMPRESA` ve os agendamentos da empresa e de todas as unidades filhas
  - `CORRETORA` agrega empresas e unidades descendentes
- passamos a tratar o contrato ativo como fonte prioritaria do recorte operacional, usando os vinculos legados apenas como fallback quando nao houver contexto de contrato resolvido

## Impacto

- a tela `/unidade/agendamentos` deixa de abrir a agenda inteira quando as tabelas legadas nao existem
- a tela `/empresa/agendamentos` passa a respeitar a visao multiunidade pela arvore `contrato_pai`
- o seed Alpha fica compativel com a base atual e gera registros visiveis no escopo correto da unidade
- a agenda fica mais resiliente durante a transicao do legado de parceiros para o tenancy por contratos

## Arquivos alterados

- `includes/helpers/PermissoesHelper.php`
- `src/Modules/Scheduling/Repositories/SchedulingRepository.php`
- `src/Support/OperationalAccessScope.php`
- `sql/2026-04-16-05-seed-pacientes-e-agendamentos-alpha.sql`