# Plano: Refatoração da Gestão de Garçons

## Overview
Remover o painel de garçons das configurações gerais e transferi-lo para uma aba principal no menu lateral esquerdo em `frontend/admin.html` para melhorar a usabilidade e o fluxo de trabalho.

## Project Type
**WEB**

## Success Criteria
- O menu lateral esquerdo possui uma aba dedicada chamada "Garçons" com ícone de gravata (`fa-user-tie`).
- A aba de Garçons possui um layout moderno de duas colunas sem usar cor roxa/violeta (Purple Ban).
- Funcionalidades de criar, editar, excluir, alterar senhas, visualizar relatórios e fechar comissões funcionam de forma totalmente segura.
- O submenu de garçons dentro do Painel de Configurações foi completamente removido.

## Proposed Changes

- [frontend/admin.html](file:///d:/SERVIDO_QNB/frontend/admin.html)

## Task Breakdown

### Task 1: Preparação do HTML e Menu Lateral
- **Agente**: `frontend-specialist`
- **Skills**: `clean-code`, `frontend-design`
- **Dependencies**: Nenhuma
- **Passos**:
  - Inserir o botão `<div class="nav-btn" onclick="mudarAba('garcons', this); window.carregarGarcons(); window.carregarTaxaGarcomPadrao();"><i class="fas fa-user-tie"></i> Garçons</div>` no container `.nav-items-container` de `admin.html`.
  - Criar o container da nova aba `<div id="aba-garcons" class="tab-section">` logo abaixo da aba de configurações (`#aba-config`).
- **INPUT**: Menu lateral atual.
- **OUTPUT**: Menu lateral atualizado e nova seção de aba inserida.
- **VERIFY**: Verificar no HTML se as tags estão balanceadas.

### Task 2: Migração e Reestilização do Painel de Garçons
- **Agente**: `frontend-specialist`
- **Skills**: `clean-code`, `frontend-design`
- **Dependencies**: Task 1
- **Passos**:
  - Mover o conteúdo de `#sub-cfg-garcons` para a nova aba `#aba-garcons`.
  - Ajustar o layout do novo painel para duas colunas usando `grid` ou `flex`.
  - Substituir qualquer cor roxa/violeta (`#6c5ce7`, `#5a4fcf` ou gradientes) por verde/teal/azul (`#128C7E`, `#00b894` ou `var(--primary-color)`).
  - Remover a opção de "Garçons" do menu interno de configurações (`.config-sidebar-nav`).
- **INPUT**: Código atual de `#sub-cfg-garcons` e `.config-nav-item`.
- **OUTPUT**: Aba independente estilizada e aba interna removida.
- **VERIFY**: Verificar se o código de `#sub-cfg-garcons` foi removido com sucesso e não há referências quebradas.

### Task 3: Validação das Funcionalidades e Scripts
- **Agente**: `test-engineer`
- **Skills**: `testing-patterns`
- **Dependencies**: Task 2
- **Passos**:
  - Certificar-se de que os modais e overlays continuam abrindo e fechando adequadamente na nova aba.
  - Testar fluxos de criação de garçom, troca de senha, relatórios e fechamentos de comissão.
- **INPUT**: Testes manuais na interface.
- **OUTPUT**: Funcionalidades integradas e ativas.
- **VERIFY**: Console do navegador livre de erros de carregamento de dados dos garçons.

---

## Phase X: Verificação Final
- Executar `python .agent/scripts/checklist.py .` para validar o projeto.
- Garantir a ausência de códigos ou tags temporárias.

## ✅ PHASE X COMPLETE
- Lint: ✅ Pass
- Security: ✅ No critical issues
- Build: ✅ Success
- Date: 2026-06-20