up-cc 0.3.3 → 0.4.0

package/commands/ux-tester.md

@@ -0,0 +1,63 @@
+---
+name: up:ux-tester
+description: Navegar o sistema como usuario real, avaliar experiencia em 6 dimensoes e implementar melhorias automaticamente
+argument-hint: "[url ou porta] [--no-fix]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - AskUserQuestion
+  - mcp__plugin_playwright_playwright__*
+---
+<objective>
+UX Tester: abrir o sistema no browser, navegar como usuario real, avaliar a experiencia em 6 dimensoes (clareza, eficiencia, feedback, consistencia, acessibilidade, performance percebida) e implementar melhorias automaticamente.
+
+NAO e teste funcional. E um auditor de experiencia que USA o sistema e pensa como pessoa real:
+- "Esse botao ta no lugar errado"
+- "Pra fazer X preciso de 5 cliques, deveria ser 2"
+- "Cadê o feedback quando eu submeto?"
+- "Essa tela ta confusa, nao sei o que fazer"
+- "O loading ta lento aqui"
+
+**Standalone:** Funciona em qualquer projeto, qualquer momento. NAO requer /up:novo-projeto ou .plano/.
+**Builder:** Tambem integrado no modo builder (Estagio 4 — Polish).
+
+**Output:** `.plano/ux-review/UX-REPORT.md` com issues priorizadas + melhorias implementadas com commits atomicos + screenshots antes/depois.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/ux-tester.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+**Argumentos opcionais:**
+- URL ou porta: `http://localhost:3000` ou `3000` (default: detecta automaticamente)
+- `--no-fix`: Apenas gerar relatorio, NAO implementar melhorias
+
+**Se sem argumentos:** Detecta stack, sobe dev server automaticamente, usa porta padrao.
+
+**Se .plano/ existe:** Usa PROJECT.md e REQUIREMENTS.md para entender fluxos.
+**Se .plano/ NAO existe:** Descobre fluxos explorando codigo e navegando.
+
+**Cria .plano/ux-review/ automaticamente** (standalone, sem pre-requisitos).
+</context>
+
+<process>
+Execute the ux-tester workflow from @~/.claude/up/workflows/ux-tester.md end-to-end.
+
+Preserve all workflow gates:
+1. Setup (detectar stack, subir server, descobrir fluxos, definir personas)
+2. Navegacao como usuario (avaliar 6 dimensoes com screenshots)
+3. Gerar UX-REPORT.md com issues priorizadas
+4. Implementar melhorias (a menos que --no-fix)
+5. Cleanup (matar server, fechar browser)
+
+**Flag --no-fix:** Se presente, pular Passo 4 (implementacao). Apenas gerar relatorio.
+</process>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "up-cc",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Simplified spec-driven development for Claude Code, Gemini and OpenCode.",
   "bin": {
     "up-cc": "bin/install.js"

package/references/blueprints/audit.md

@@ -0,0 +1,29 @@
+# Blueprint: Audit & Activity Logs
+
+Aplicar quando: sistema tem roles/permissoes, dados sensiveis, ou necessidade de rastreabilidade.
+Recomendado para TODO sistema com multiplos usuarios.
+
+---
+
+## Logs de Atividade (LOG)
+
+- LOG-01: Registrar acoes importantes: criar, editar, deletar, alterar status, alterar permissao
+- LOG-02: Cada log contem: quem, o que, quando, detalhes da mudanca
+- LOG-03: Pagina de logs acessivel para admin
+- LOG-04: Filtro por usuario, tipo de acao, data
+- LOG-05: Busca por texto
+- LOG-06: Paginacao (server-side, logs podem ser muitos)
+- LOG-07: Retencao: definir periodo (ex: 90 dias)
+- LOG-08: Nao editavel/deletavel (append-only)
+
+## Auditoria de Dados (AUDIT)
+
+- AUDIT-01: Historico de alteracoes por registro (quem mudou o que, quando)
+- AUDIT-02: Diff visual (valor anterior → novo valor)
+- AUDIT-03: Acessivel na pagina de detalhes do registro
+
+## Sessoes (SESSION)
+
+- SESSION-01: Listar sessoes ativas do usuario (dispositivo, IP, ultimo acesso)
+- SESSION-02: Revogar sessao especifica
+- SESSION-03: Revogar todas as sessoes (exceto atual)

package/references/blueprints/booking.md

@@ -0,0 +1,49 @@
+# Blueprint: Booking & Scheduling
+
+Aplicar quando: "agendar", "reservar", "barbearia", "clinica", "salao", "consultorio", "horario", "calendario".
+
+---
+
+## Calendario (CAL)
+
+- CAL-01: Visualizacao de calendario (dia, semana, mes)
+- CAL-02: Slots de horario visiveis com disponibilidade
+- CAL-03: Cores por status (disponivel, ocupado, bloqueado)
+- CAL-04: Navegacao entre datas (setas, date picker)
+- CAL-05: Visualizacao por profissional/recurso
+- CAL-06: Drag & drop para remarcar (desktop)
+- CAL-07: Responsivo (lista no mobile, grid no desktop)
+
+## Agendamento (BOOKING)
+
+- BOOKING-01: Fluxo de criacao: servico → profissional → data/hora → confirmar
+- BOOKING-02: Mostrar apenas horarios disponiveis
+- BOOKING-03: Duracao automatica baseada no servico
+- BOOKING-04: Conflito detectado antes de confirmar
+- BOOKING-05: Confirmacao com resumo (servico, data, hora, profissional, preco)
+- BOOKING-06: Cancelamento com motivo (pelo cliente ou pelo negocio)
+- BOOKING-07: Remarcacao (mover para outro horario)
+- BOOKING-08: Status do agendamento: confirmado, em andamento, concluido, cancelado, no-show
+
+## Disponibilidade (AVAIL)
+
+- AVAIL-01: Horario de funcionamento configuravel por dia da semana
+- AVAIL-02: Bloqueio de horarios especificos (ferias, folga, almoco)
+- AVAIL-03: Disponibilidade por profissional individual
+- AVAIL-04: Tempo de intervalo entre agendamentos (buffer)
+- AVAIL-05: Feriados (bloquear dias)
+
+## Lembretes (REMIND)
+
+- REMIND-01: Lembrete 24h antes (email ou WhatsApp)
+- REMIND-02: Confirmacao automatica apos agendamento (email)
+- REMIND-03: Notificacao de cancelamento
+- REMIND-04: Preferencias de notificacao por cliente
+
+## Servicos (SERVICE)
+
+- SERVICE-01: CRUD de servicos (nome, descricao, duracao, preco)
+- SERVICE-02: Categorias de servicos
+- SERVICE-03: Ativar/desativar servico (sem deletar)
+- SERVICE-04: Imagem do servico (opcional)
+- SERVICE-05: Preco variavel por profissional (opcional)

package/references/blueprints/community.md

@@ -0,0 +1,48 @@
+# Blueprint: Community & Courses
+
+Aplicar quando: "comunidade", "membros", "curso", "aulas", "assinatura", "conteudo pago", "area de membros".
+
+---
+
+## Planos & Acesso (PLAN)
+
+- PLAN-01: Planos com niveis de acesso (gratis, basico, premium)
+- PLAN-02: Conteudo gated por plano (cadeado visual no bloqueado)
+- PLAN-03: Upgrade/downgrade de plano
+- PLAN-04: Trial period (opcional)
+- PLAN-05: Billing integration (Stripe, Asaas)
+- PLAN-06: Pagina de precos com comparacao de planos
+
+## Conteudo (CONTENT)
+
+- CONTENT-01: Modulos/secoes hierarquicas (curso → modulo → aula)
+- CONTENT-02: Tipos de conteudo: video, texto, quiz, arquivo
+- CONTENT-03: Progresso por usuario (% concluido, aula atual)
+- CONTENT-04: Marcar como concluido (checkbox ou auto-apos-video)
+- CONTENT-05: Barra de progresso visual
+- CONTENT-06: Sequencia (liberar aulas em ordem ou todas abertas)
+- CONTENT-07: Admin: CRUD de conteudo (criar, editar, reordenar)
+
+## Comunidade (COMM)
+
+- COMM-01: Feed de posts/discussoes
+- COMM-02: Comentarios em conteudo
+- COMM-03: Perfil de membro (foto, bio, plano)
+- COMM-04: Likes/reacoes
+- COMM-05: Mencoes (@usuario)
+- COMM-06: Moderacao (aprovar, remover, banir)
+- COMM-07: Topicos/categorias
+
+## Certificados (CERT)
+
+- CERT-01: Certificado de conclusao (PDF gerado)
+- CERT-02: Template customizavel (logo, nome do curso, data)
+- CERT-03: URL publica de verificacao
+- CERT-04: Gerado automaticamente ao completar 100%
+
+## Gamificacao (GAME)
+
+- GAME-01: Pontos/XP por atividade (assistir aula, completar quiz)
+- GAME-02: Badges/conquistas
+- GAME-03: Ranking/leaderboard (opcional)
+- GAME-04: Streak de dias consecutivos

package/references/blueprints/crm.md

@@ -0,0 +1,40 @@
+# Blueprint: CRM & Sales
+
+Aplicar quando: "CRM", "clientes", "pipeline", "vendas", "leads", "funil", "contatos".
+
+---
+
+## Contatos (CONTACT)
+
+- CONTACT-01: Cadastro de contato (nome, email, telefone, empresa)
+- CONTACT-02: Campos customizaveis (tags, segmento, origem)
+- CONTACT-03: Busca e filtro avancado
+- CONTACT-04: Import CSV de contatos
+- CONTACT-05: Export de contatos
+- CONTACT-06: Merge de contatos duplicados
+- CONTACT-07: Historico de interacoes por contato
+
+## Pipeline (PIPELINE)
+
+- PIPELINE-01: Kanban visual de pipeline (arrastar entre estagios)
+- PIPELINE-02: Estagios customizaveis (nome, cor, ordem)
+- PIPELINE-03: Card de deal (valor, contato, etapa, responsavel)
+- PIPELINE-04: Filtros por responsavel, valor, data
+- PIPELINE-05: Valor total por estagio
+- PIPELINE-06: Conversao entre estagios (metricas de funil)
+
+## Atividades (ACTIVITY)
+
+- ACTIVITY-01: Registrar atividades (ligacao, email, reuniao, nota)
+- ACTIVITY-02: Tarefas com data de vencimento e responsavel
+- ACTIVITY-03: Lembretes de follow-up
+- ACTIVITY-04: Timeline de atividades por contato/deal
+- ACTIVITY-05: Atividades pendentes na dashboard
+
+## Relatorios (REPORT)
+
+- REPORT-01: Receita por periodo
+- REPORT-02: Conversao por estagio do funil
+- REPORT-03: Performance por vendedor
+- REPORT-04: Tempo medio por estagio
+- REPORT-05: Previsao de receita (pipeline value × probabilidade)

package/references/blueprints/dashboard.md

@@ -0,0 +1,48 @@
+# Blueprint: Dashboard & Analytics
+
+Aplicar quando: "dashboard", "painel", "metricas", "KPIs", "relatorios", "analytics", "gestor".
+
+---
+
+## KPIs & Cards (KPI)
+
+- KPI-01: Cards de metricas principais no topo (3-6 KPIs)
+- KPI-02: Cada card mostra: valor atual, variacao vs periodo anterior (% e seta)
+- KPI-03: Cores semanticas: verde=crescimento, vermelho=queda, cinza=neutro
+- KPI-04: Skeleton loading individual por card
+- KPI-05: Tooltip com detalhes ao hover
+
+## Graficos (CHART)
+
+- CHART-01: Pelo menos 1 grafico de linha/area (tendencia temporal)
+- CHART-02: Pelo menos 1 grafico de barra ou pizza (distribuicao)
+- CHART-03: Graficos responsivos (redimensionam com o container)
+- CHART-04: Tooltip interativo ao hover nos pontos
+- CHART-05: Legenda clicavel (toggle series)
+- CHART-06: Empty state quando sem dados
+- CHART-07: Loading skeleton para graficos
+
+## Filtros (FILTER)
+
+- FILTER-01: Date range picker (hoje, 7d, 30d, 90d, custom)
+- FILTER-02: Filtros persistem na URL (compartilhavel)
+- FILTER-03: Filtros persistem entre sessoes (localStorage)
+- FILTER-04: Botao "limpar filtros"
+- FILTER-05: Filtros por categoria/segmento relevante ao dominio
+
+## Tabelas de Dados (TABLE)
+
+- TABLE-01: Tabela com sort por coluna (click no header)
+- TABLE-02: Busca/filtro inline
+- TABLE-03: Paginacao (server-side para datasets grandes)
+- TABLE-04: Export CSV/PDF
+- TABLE-05: Selecao multipla com bulk actions
+- TABLE-06: Responsiva (scroll horizontal ou card layout em mobile)
+- TABLE-07: Loading skeleton rows
+
+## Refresh & Realtime (REFRESH)
+
+- REFRESH-01: Botao de refresh manual
+- REFRESH-02: Indicador de "ultima atualizacao: X min atras"
+- REFRESH-03: Auto-refresh configuravel (a cada 5min, desligavel)
+- REFRESH-04: Realtime updates se stack suporta (Supabase Realtime, WebSocket)

package/references/blueprints/data-management.md

@@ -0,0 +1,42 @@
+# Blueprint: Data Management
+
+Aplicar quando: sistema tem listas de dados, tabelas, registros que o usuario precisa gerenciar.
+Praticamente TODO sistema com CRUD precisa deste blueprint.
+
+---
+
+## CRUD Avancado (CRUD)
+
+- CRUD-01: Listagem com busca por texto
+- CRUD-02: Filtros por campo (status, categoria, data, responsavel)
+- CRUD-03: Ordenacao por coluna (click no header)
+- CRUD-04: Paginacao (server-side para > 100 registros)
+- CRUD-05: Selecao multipla (checkboxes)
+- CRUD-06: Bulk actions (deletar selecionados, alterar status, exportar)
+- CRUD-07: Criar registro (modal ou pagina dedicada)
+- CRUD-08: Editar registro (inline ou modal ou pagina)
+- CRUD-09: Deletar com confirmacao
+- CRUD-10: Soft delete (desativar, nao deletar permanentemente)
+
+## Import/Export (IO)
+
+- IO-01: Export CSV (filtros aplicados)
+- IO-02: Export PDF (relatorio formatado)
+- IO-03: Import CSV (com preview e validacao antes de importar)
+- IO-04: Template de CSV para download (formato esperado)
+- IO-05: Feedback de progresso durante import
+
+## Busca Avancada (SEARCH)
+
+- SEARCH-01: Busca global (barra de busca no header, cmd+k)
+- SEARCH-02: Resultados agrupados por tipo (clientes, pedidos, etc.)
+- SEARCH-03: Busca com debounce (300ms)
+- SEARCH-04: Historico de buscas recentes
+- SEARCH-05: Atalho de teclado (Cmd+K / Ctrl+K)
+
+## Filtros Persistentes (FILT)
+
+- FILT-01: Filtros salvos na URL (compartilhavel)
+- FILT-02: Filtros salvos pelo usuario (favoritos)
+- FILT-03: Botao "limpar filtros"
+- FILT-04: Contador de resultados apos filtrar

package/references/blueprints/ecommerce.md

@@ -0,0 +1,51 @@
+# Blueprint: E-commerce
+
+Aplicar quando: "loja", "produtos", "carrinho", "checkout", "pedidos", "inventario", "vender online".
+
+---
+
+## Catalogo (CATALOG)
+
+- CATALOG-01: Listagem de produtos com grid/lista toggle
+- CATALOG-02: Busca por nome/descricao
+- CATALOG-03: Filtros por categoria, preco, disponibilidade
+- CATALOG-04: Ordenacao (preco, nome, mais vendidos, mais recentes)
+- CATALOG-05: Pagina de detalhes do produto (imagens, descricao, preco, variacoes)
+- CATALOG-06: Galeria de imagens com zoom/carousel
+- CATALOG-07: Produtos relacionados
+- CATALOG-08: Badge de estoque (em estoque, ultimas unidades, esgotado)
+
+## Carrinho (CART)
+
+- CART-01: Adicionar ao carrinho com feedback visual
+- CART-02: Mini-cart (dropdown ou sidebar)
+- CART-03: Pagina do carrinho (itens, quantidades, subtotais)
+- CART-04: Alterar quantidade e remover item
+- CART-05: Carrinho persistente (localStorage ou banco)
+- CART-06: Resumo com subtotal, frete, desconto, total
+- CART-07: Cupom de desconto
+
+## Checkout (CHECKOUT)
+
+- CHECKOUT-01: Checkout em steps (dados → endereco → pagamento → confirmacao)
+- CHECKOUT-02: Dados do cliente (nome, email, telefone)
+- CHECKOUT-03: Endereco de entrega (com CEP e auto-complete)
+- CHECKOUT-04: Metodos de pagamento (cartao, pix, boleto)
+- CHECKOUT-05: Resumo final antes de confirmar
+- CHECKOUT-06: Pagina de confirmacao com numero do pedido
+- CHECKOUT-07: Email de confirmacao automatico
+
+## Pedidos (ORDER)
+
+- ORDER-01: Meus pedidos (historico do cliente)
+- ORDER-02: Detalhes do pedido (itens, status, rastreamento)
+- ORDER-03: Status do pedido (pendente, pago, enviado, entregue, cancelado)
+- ORDER-04: Admin: gestao de pedidos (listar, filtrar por status, atualizar)
+- ORDER-05: Notificacao de mudanca de status
+
+## Inventario (STOCK)
+
+- STOCK-01: Controle de estoque por produto/variacao
+- STOCK-02: Alerta de estoque baixo
+- STOCK-03: Nao permitir venda de produto sem estoque
+- STOCK-04: Historico de movimentacao

package/references/blueprints/marketplace.md

@@ -0,0 +1,48 @@
+# Blueprint: Marketplace
+
+Aplicar quando: "marketplace", "plataforma", "dois lados", "compradores e vendedores", "freelancers", "servicos".
+
+---
+
+## Dois Lados (SIDES)
+
+- SIDES-01: Registro diferenciado (comprador vs vendedor/prestador)
+- SIDES-02: Dashboard diferente por tipo de usuario
+- SIDES-03: Perfil publico do vendedor (portfolio, avaliacoes, servicos)
+- SIDES-04: Perfil do comprador (historico, avaliacoes dadas)
+
+## Listagem & Busca (SEARCH)
+
+- SEARCH-01: Busca com autocomplete
+- SEARCH-02: Filtros avancados (categoria, preco, localizacao, avaliacao)
+- SEARCH-03: Ordenacao (relevancia, preco, avaliacao, distancia)
+- SEARCH-04: Mapa (se localizacao relevante)
+- SEARCH-05: Resultados paginados com skeleton loading
+- SEARCH-06: Busca salva / alertas
+
+## Avaliacoes (REVIEW)
+
+- REVIEW-01: Rating por estrelas (1-5)
+- REVIEW-02: Review em texto
+- REVIEW-03: Apenas quem comprou pode avaliar
+- REVIEW-04: Resposta do vendedor
+- REVIEW-05: Media de avaliacoes no perfil/listagem
+- REVIEW-06: Denunciar review falsa
+
+## Messaging (MSG)
+
+- MSG-01: Chat entre comprador e vendedor
+- MSG-02: Inbox com lista de conversas
+- MSG-03: Notificacao de nova mensagem
+- MSG-04: Historico de mensagens persistente
+- MSG-05: Anexos (imagens, documentos)
+
+## Transacoes (TX)
+
+- TX-01: Proposta/orcamento
+- TX-02: Aceitar/recusar proposta
+- TX-03: Pagamento via plataforma (escrow)
+- TX-04: Liberacao do pagamento apos conclusao
+- TX-05: Disputa/mediacao
+- TX-06: Historico de transacoes
+- TX-07: Comissao da plataforma (configuravel)

package/references/blueprints/notifications.md

@@ -0,0 +1,32 @@
+# Blueprint: Notifications
+
+Aplicar quando: sistema tem usuarios ativos que precisam ser informados de eventos.
+Praticamente TODO sistema com auth precisa deste blueprint.
+
+---
+
+## In-App (NOTIF)
+
+- NOTIF-01: Sino de notificacao com badge de contagem (nao lidas)
+- NOTIF-02: Dropdown/painel de notificacoes
+- NOTIF-03: Marcar como lida (individual e "marcar todas")
+- NOTIF-04: Tipos visiveis: info, sucesso, alerta, erro
+- NOTIF-05: Link para a acao/pagina relevante
+- NOTIF-06: Timestamp relativo ("5 min atras", "ontem")
+- NOTIF-07: Paginacao (carregar mais antigas)
+- NOTIF-08: Realtime (nova notificacao aparece sem refresh)
+
+## Email (EMAIL)
+
+- EMAIL-01: Template de email transacional (branding consistente)
+- EMAIL-02: Email de boas-vindas apos signup
+- EMAIL-03: Email de confirmacao para acoes criticas
+- EMAIL-04: Email de reset de senha
+- EMAIL-05: Opcao de unsubscribe em cada email
+
+## Preferencias (PREF)
+
+- PREF-01: Pagina de preferencias de notificacao
+- PREF-02: Toggle por tipo de notificacao (on/off)
+- PREF-03: Toggle por canal (in-app, email, push)
+- PREF-04: Defaults razoaveis (tudo ligado, ajusta se quiser)

package/references/blueprints/saas-users.md

@@ -0,0 +1,50 @@
+# Blueprint: SaaS Users & Permissions
+
+Aplicar quando: sistema tem login, multiplos usuarios, ou qualquer menção a "admin", "roles", "permissoes".
+Praticamente TODO sistema web com auth precisa deste blueprint.
+
+---
+
+## Autenticacao (AUTH)
+
+- AUTH-01: Login com email/senha
+- AUTH-02: Signup com verificacao de email
+- AUTH-03: Forgot password (enviar link de reset)
+- AUTH-04: Reset password (pagina com token)
+- AUTH-05: Alteracao de senha (logado, exige senha atual)
+- AUTH-06: Logout com limpeza de sessao
+- AUTH-07: Sessao persistente (refresh token / remember me)
+- AUTH-08: Redirect pos-login para pagina de origem
+- AUTH-09: Loading state durante verificacao de auth (nao piscar login)
+- AUTH-10: OAuth social (Google, GitHub) — se aplicavel ao dominio
+
+## Perfil de Usuario (PROFILE)
+
+- PROFILE-01: Pagina de perfil (nome, email, foto, contato)
+- PROFILE-02: Upload de foto de perfil (com crop/resize)
+- PROFILE-03: Edicao de dados pessoais
+- PROFILE-04: Visualizacao de plano/role atual
+- PROFILE-05: Historico de atividade do usuario
+
+## Roles e Permissoes (ROLE)
+
+- ROLE-01: Definir roles do sistema (ex: admin, gerente, atendente, cliente)
+- ROLE-02: Cada role tem permissoes especificas (CRUD por modulo)
+- ROLE-03: Tabela de permissoes: role × modulo × acao (ver, criar, editar, deletar)
+- ROLE-04: UI adapta baseado no role (menus, botoes, paginas visiveis)
+- ROLE-05: API valida permissoes (nao depender apenas do front)
+- ROLE-06: Role padrao para novos usuarios (configuravel)
+- ROLE-07: Super admin (acesso total, nao removivel)
+
+## Gestao de Usuarios (USRMGMT)
+
+- USRMGMT-01: Listar usuarios (com busca, filtro por role, paginacao)
+- USRMGMT-02: Criar usuario (nome, email, role, senha temporaria ou convite)
+- USRMGMT-03: Editar usuario (nome, email, role)
+- USRMGMT-04: Desativar/reativar usuario (soft delete, nao hard delete)
+- USRMGMT-05: Reset de senha por admin (gerar link de reset)
+- USRMGMT-06: Alterar role de usuario
+- USRMGMT-07: Convite por email (link de signup com role pre-definido)
+- USRMGMT-08: Indicador de status (ativo, inativo, pendente convite)
+- USRMGMT-09: Acessivel apenas para admin
+- USRMGMT-10: Log de alteracoes (quem mudou o que)

package/references/blueprints/settings.md

@@ -0,0 +1,31 @@
+# Blueprint: Settings & Configuration
+
+Aplicar quando: sistema tem configuracoes ajustaveis pelo usuario ou admin.
+Praticamente TODO sistema SaaS precisa deste blueprint.
+
+---
+
+## Perfil & Conta (ACCT)
+
+- ACCT-01: Pagina de configuracoes com sidebar/tabs por secao
+- ACCT-02: Secao "Perfil" (nome, foto, bio, contato)
+- ACCT-03: Secao "Seguranca" (alterar senha, sessoes ativas)
+- ACCT-04: Secao "Notificacoes" (preferencias de canal e tipo)
+- ACCT-05: Secao "Aparencia" (tema claro/escuro, idioma)
+- ACCT-06: Secao "Dados" (export dos meus dados, deletar conta)
+- ACCT-07: Save com feedback (toast de sucesso)
+
+## Configuracao do Negocio — Admin Only (BIZ)
+
+- BIZ-01: Dados do negocio (nome, logo, endereco, CNPJ, contato)
+- BIZ-02: Horario de funcionamento
+- BIZ-03: Configuracao de moeda e locale
+- BIZ-04: Configuracao de email (remetente, templates)
+- BIZ-05: Integrações ativas (toggle on/off, chaves de API)
+- BIZ-06: Plano atual e billing info (se SaaS multi-tenant)
+
+## Customizacao Visual — Admin Only (THEME)
+
+- THEME-01: Logo upload
+- THEME-02: Cores primarias (se white-label)
+- THEME-03: Favicon customizado

package/references/production-requirements.md

@@ -0,0 +1,106 @@
+# Production Requirements Reference
+
+Checklist de requisitos que TODO sistema pronto para producao deve ter.
+O up-system-designer e up-arquiteto usam esta referencia para injetar requisitos automaticamente.
+
+Cada item e um requisito com ID sugerido. O arquiteto ajusta IDs para nao colidir com requisitos explicitos do usuario.
+
+---
+
+## UI States (UIST)
+
+- UIST-01: Loading state (skeleton ou spinner) em TODA operacao assincrona
+- UIST-02: Error state com mensagem clara e botao de retry
+- UIST-03: Empty state com orientacao de acao ("Nenhum item ainda. Clique em + para criar.")
+- UIST-04: Success feedback (toast) para TODA acao mutativa (criar, editar, deletar)
+- UIST-05: Disabled state em botoes durante submissao (evitar double-click)
+- UIST-06: Skeleton loading em vez de spinner generico para conteudo principal
+- UIST-07: Optimistic updates onde aplicavel (UI responde antes da API)
+- UIST-08: Confirmacao antes de acoes destrutivas (deletar, cancelar)
+
+## Error Handling (ERR)
+
+- ERR-01: Error boundary no layout raiz com fallback UI amigavel
+- ERR-02: Error boundary por feature/rota (erro em uma secao nao derruba o app)
+- ERR-03: Try/catch em toda operacao de API com mensagem amigavel
+- ERR-04: Tratamento de sessao expirada (redirect para login com mensagem)
+- ERR-05: Pagina 404 customizada com navegacao de volta
+- ERR-06: Tratamento de erros de rede (offline, timeout) com retry
+- ERR-07: Validacao server-side alem de client-side (nunca confiar so no front)
+- ERR-08: Logging de erros no console (dev) sem expor em producao
+
+## Performance (PERF)
+
+- PERF-01: Lazy loading de imagens (loading="lazy" ou next/image)
+- PERF-02: Code splitting por rota (dynamic imports / React.lazy)
+- PERF-03: Debounce em inputs de busca/filtro (300ms)
+- PERF-04: Pagination ou infinite scroll para listas > 20 items
+- PERF-05: Caching de queries (React Query / SWR / tRPC cache / staleTime)
+- PERF-06: Memoizacao de componentes pesados (React.memo, useMemo)
+- PERF-07: Evitar re-renders desnecessarios (keys corretas, deps do useEffect)
+- PERF-08: Compressao de imagens e assets (WebP, SVG onde possivel)
+- PERF-09: Prefetch de rotas provaveis (next/link prefetch)
+
+## Forms (FORM)
+
+- FORM-01: Validacao inline (ao sair do campo ou ao digitar, nao so no submit)
+- FORM-02: Mensagens de erro especificas por campo ("Email invalido" nao "Erro")
+- FORM-03: Botao desabilitado durante submissao com loading indicator
+- FORM-04: Autofocus no primeiro campo ao abrir form
+- FORM-05: Tab order logica (sem pular campos)
+- FORM-06: Defaults inteligentes onde possivel (data=hoje, moeda=BRL)
+- FORM-07: Preservar dados do form se usuario navegar e voltar
+- FORM-08: Mascara de input onde aplicavel (telefone, CPF, CEP, moeda)
+
+## Responsividade (RESP)
+
+- RESP-01: Layout funcional em 375px (iPhone SE) — sem overflow horizontal
+- RESP-02: Touch targets minimo 44x44px em mobile
+- RESP-03: Navegacao adaptada (hamburger/drawer em mobile)
+- RESP-04: Tabelas com scroll horizontal ou layout de cards em mobile
+- RESP-05: Modais fullscreen em mobile, dialog em desktop
+- RESP-06: Fonte legivel (min 14px body, min 12px labels)
+- RESP-07: Imagens responsivas (max-w-full, h-auto)
+
+## Meta/SEO (META)
+
+- META-01: Title unico por pagina
+- META-02: Meta description por pagina
+- META-03: OG tags (image, title, description) para compartilhamento social
+- META-04: Favicon (multiplos tamanhos)
+- META-05: Web manifest (PWA-ready)
+- META-06: Canonical URL
+- META-07: Robots meta (noindex para paginas privadas)
+
+## Acessibilidade (A11Y)
+
+- A11Y-01: Alt text em todas as imagens
+- A11Y-02: Labels associados a todos os inputs (htmlFor/id)
+- A11Y-03: Focus visible em elementos interativos (outline, ring)
+- A11Y-04: Keyboard navigation funcional (tab, enter, escape)
+- A11Y-05: Aria labels em botoes de icone (sem texto visivel)
+- A11Y-06: Hierarquia de headings (h1 > h2 > h3, sem pular niveis)
+- A11Y-07: Contraste minimo 4.5:1 em texto
+- A11Y-08: Skip to content link
+- A11Y-09: Landmarks (header, main, nav, footer)
+
+## Seguranca (SEC)
+
+- SEC-01: Protecao de rotas autenticadas (redirect se nao logado)
+- SEC-02: CSRF protection em forms
+- SEC-03: Sanitizacao de inputs (evitar XSS)
+- SEC-04: Rate limiting em endpoints sensiveis (login, signup, reset)
+- SEC-05: Headers de seguranca (CSP, X-Frame-Options, etc.)
+- SEC-06: Nao expor IDs sequenciais (usar UUID)
+- SEC-07: Env vars nunca expostas no client-side
+- SEC-08: RLS (Row Level Security) se usando Supabase
+
+## Visual Polish (POLISH)
+
+- POLISH-01: Hover states em todos elementos clicaveis
+- POLISH-02: Transicoes suaves em mudancas de estado (150-300ms)
+- POLISH-03: Consistencia de espacamento (usar escala: 4, 8, 12, 16, 24, 32, 48)
+- POLISH-04: Consistencia de cores (usar design tokens, nao hex hardcoded)
+- POLISH-05: Consistencia de tipografia (max 2 fontes, escala definida)
+- POLISH-06: Dark mode (opcional mas cada vez mais esperado)
+- POLISH-07: Favicon que funciona em light e dark mode