Ecossistema Salão

Requisitos Funcionais

• Validar credenciais (e-mail e senha) e identificar o nível de acesso.
• Redirecionar automaticamente ao painel do papel (Portal do Cliente, Dashboard da Empresa, etc.).
• Fluxo "Esqueci minha senha" com e-mail de link temporário de recuperação.
• Logs estruturados de acessos bem-sucedidos e tentativas falhas.

Critérios de Aceite

• Após 5 tentativas falhas consecutivas, bloqueio temporário (cooldown).
• Link de recuperação expira em 1 hora ou após o primeiro uso.
• Rotas internas não acessíveis sem token de sessão válido (JWT).

Requisitos Funcionais

• Isolar ambientes: Profissional/Empresa não acessam o Super Admin (Módulo 10); Cliente só vê seus dados (Módulo 9).
• Empresa envia convites por e-mail para cadastrar Profissionais em sua unidade.
• Empresa pode ativar, suspender ou revogar o acesso de um Profissional.

Critérios de Aceite

• Acesso a rotas não permitidas → erro 403 e redirecionamento amigável.
• Profissional revogado perde acesso imediato, com sessão encerrada.

Requisitos Funcionais

• Bloquear funcionalidades exclusivas para o plano Starter (Timeline completa, comparativo visual, NFe) com chamada de upgrade.
• Habilitar Estoque, Timeline Completa e IA (Módulos 2, 4 e 6) para Professional e Enterprise.
• Atribuir créditos de IA na renovação: 1.000 (Professional) / 10.000 (Enterprise).
• Sincronizar status de pagamento do plano ativo.

Critérios de Aceite

• Empresa Starter acessando o Estoque vê aviso de que o recurso é do plano Professional.
• Renovação mensal reseta/adiciona créditos de IA corretamente.
• Contas inadimplentes/canceladas têm acesso suspenso (dados preservados, operações bloqueadas).

Requisitos Funcionais

• Vincular múltiplas unidades sob um único login Empresa (Enterprise).
• Ao alternar unidade, atualizar token/contexto para todas as requisições (agenda, histórico, financeiro) retornarem dados da unidade selecionada.

Critérios de Aceite

• Botão de troca visível apenas com plano Enterprise e mais de uma unidade cadastrada.
• Alteração de filial recarrega a tela com apenas os dados da nova filial.

Requisitos Funcionais

• CRUD de clientes; dados pessoais (Nome, CPF, Data de Nascimento, Contatos e Endereço).
• Vincula cliente à unidade (Empresa) e ao Profissional que o cadastrou.
• Integra ao Módulo 1 para, opcionalmente, disparar convite ao Portal do Cliente (Módulo 9).
• Exclusão obedece arquivamento lógico (soft delete) preservando dados financeiros e de agenda.

Critérios de Aceite

• Impede cadastros duplicados pelo mesmo CPF na mesma unidade.
• Perfil do cliente é um hub com abas (Dados Pessoais, Anamnese, Timeline, Terapia Capilar e Galeria) e botões de ação rápida.

Requisitos Funcionais

• Bloqueia conclusão de serviços/procedimentos (Módulo 4) para clientes novos até a anamnese ser preenchida e assinada.
• Formulário estruturado (hábitos de vida, medicações, histórico de químicas).
• Assinatura digital em tela (mouse/touch) com registro de data, hora e IP.
• Histórico de versões; a versão assinada original não é editável (cria novo termo de atualização).

Critérios de Aceite

• Impossível salvar a anamnese sem a assinatura digital.
• Gera documento imutável, disponível para leitura no Portal do Cliente (Módulo 9).

Requisitos Funcionais

• Registra entradas automaticamente ao concluir atendimento (Agenda - Módulo 3) ou lançar procedimento no Estoque (Módulo 4).
• Profissional insere anotações textuais livres (notas clínicas).
• Exibe análise capilar e alertas de risco da IA (Módulo 6) atrelados à data do evento.

Critérios de Aceite

• Consolida eventos de múltiplos módulos sem latência excessiva.
• Registros automáticos não podem ser apagados; apenas anotações manuais podem ser editadas (com log "editado").

Requisitos Funcionais

• Upload de imagens (JPEG, PNG, WebP) vinculadas a um evento da timeline.
• Canvas nativo para desenhar sobre a imagem (traços livres para circular falhas, manchas, quebra).
• Salva imagem editada preservando a original intacta.
• Comparativo Antes × Depois (Professional e Enterprise), validado no Módulo 1.

Critérios de Aceite

• Desenho funciona via touch e via mouse.
• Comparativo Antes/Depois pode ser exportado (download de imagem consolidada).

Requisitos Funcionais

• Definir "Plano de Tratamento" macro (previsão de N sessões).
• Registrar medições, protocolos (com baixa de insumos no Módulo 4) e evoluções por sessão.
• Anotações vinculadas estritamente a "Profissional Individual × Cliente Individual" (privacidade clínica).

Critérios de Aceite

• Apenas profissionais com permissão específica (atribuída pelo dono) inserem/visualizam os detalhes da aba.
• O fechamento de uma sessão gera resumo na Timeline Geral, ocultando detalhes sensíveis.

Requisitos Funcionais

• Visão diária, semanal e mensal dos agendamentos.
• Empresa vê agenda de todos os profissionais (com filtro); Profissional vê e gerencia apenas a sua.
• Duração dos agendamentos consome o tempo de serviço do Módulo 4 (Estoque e Procedimentos).

Critérios de Aceite

• Troca de visão (dia/semana/mês) carrega dados sem quebrar a interface.
• Dono pode arrastar agendamentos (drag-and-drop), se houver disponibilidade.
• Clique no agendamento abre modal com detalhes (cliente, serviço, profissional).

Requisitos Funcionais

• Parametrização de horário de funcionamento da unidade.
• Cálculo de slots considerando: horário da unidade, jornada do profissional, bloqueios e duração do procedimento.
• Disponibilidade exposta para consumo no Portal do Cliente (Módulo 9).
• Links/QR Codes para agendamento direto via redes sociais.

Critérios de Aceite

• Não permite double-booking (agendamento duplo) a menos que seja "Encaixe".
• Serviços mais longos que o expediente restante não aparecem como disponíveis.

Requisitos Funcionais

• Profissional ou Empresa cria "Bloqueios" (Almoço, Treinamento, Folga).
• Empresa ou Recepção força "Encaixe" em horário parcialmente ocupado.
• Tempo do bloqueio desconta imediatamente a disponibilidade online.

Critérios de Aceite

• Bloqueios impedem agendamentos externos, mas podem ser sobrescritos internamente por Empresa.
• Encaixes são contabilizados normalmente nos relatórios e módulos financeiros.

Status de ciclo de vida

Pendente → Confirmado → Concluído · No-show · Cancelado

• Disparo automático de e-mail/notificação push (integrado ao Módulo 9) no agendamento e 24h antes do serviço.
• Transição manual de status pelo profissional/gestor.

Critérios de Aceite

• Status "Concluído" dispara o registro de histórico (Módulo 2) e o comissionamento (Módulo 5).
• Cancelamento libera o slot no motor online imediatamente.
• Mudanças de status ficam em logs estruturados para auditoria.

Requisitos Funcionais

• CRUD de procedimentos (Nome, Descrição, Tempo Estimado, Categoria).
• Custos: "Fixo/Médio" (valor pré-determinado) ou "Variável" (calculado pelo consumo real de insumos).
• Acesso restrito à Empresa (Dono), validado pelo Módulo 1.

Critérios de Aceite

• Não é possível excluir procedimento com histórico atrelado - apenas inativar (soft delete).
• Informações de custo ficam disponíveis para o Módulo 5 (Financeiro).

Requisitos Funcionais

• CRUD de produtos; campos: Nome, Marca, Unidade (ml, g, unidade), Qtd. Atual, Qtd. Mínima e Custo Unitário.
• Endpoint de leitura do estoque para a IA (Módulo 6) cruzar necessidades terapêuticas com o inventário.
• Movimentação manual (entrada/saída avulsa) com justificativa e log.

Critérios de Aceite

• "Quantidade Atual" atualiza a cada entrada/saída.
• Profissional não altera custos nem exclui produtos - apenas visualiza ou registra uso.

Requisitos Funcionais

• Na finalização do agendamento/procedimento (Módulos 3/2), o Profissional seleciona produtos e quantidades usadas.
• Ao confirmar, o sistema deduz do estoque e, se "Custo Variável", calcula o custo total (qtd × custo unitário).
• Registro vinculado à timeline do cliente (Módulo 2).

Critérios de Aceite

• Baixa no estoque só ocorre após a confirmação final.
• Não impede o atendimento se o estoque estiver zerado: registra quantidade negativa e gera alerta de divergência.
• Dados de custo consumido ficam disponíveis ao Módulo 5.

Requisitos Funcionais

• Quando a Qtd. Atual ≤ Qtd. Mínima, status vira "Estoque Baixo".
• Alertas no dashboard da Empresa; prepara dado para a IA (Módulo 6) recomendar compra via Marketplace (Módulo 8).

Critérios de Aceite

• Alerta aparece assim que a baixa ultrapassa a margem mínima.
• Ao repor acima do mínimo, o alerta desaparece automaticamente.

Requisitos Funcionais

• Campos para API Key e Wallet ID do Asaas; switch para habilitar/desabilitar pagamento online.
• Impacta o Módulo 9 (Portal do Cliente), liberando/ocultando o checkout online.
• Logs estruturados registram alterações nas credenciais.

Critérios de Aceite

• Mudança no switch reflete instantaneamente na disponibilidade de checkout.
• Apenas "Empresa (Dono)" pode visualizar/alterar esta tela.

Requisitos Funcionais

• Registro manual de despesas/receitas + automático de serviços concluídos (Módulo 3).
• Exibição de saldo consolidado; acesso restrito ao dono ou delegado.

Critérios de Aceite

• Soma de entradas/saídas reflete saldo exato.
• Transações automáticas contêm link para o agendamento de origem.
• Acessos de profissionais não autorizados são bloqueados.

Requisitos Funcionais

• Conexão com API fiscal padronizada; geração do payload a partir do cliente e serviço concluído.
• Acionamento manual no detalhe da transação ou no fechamento do caixa.

Status da nota

Processando → Autorizada · Rejeitada · Cancelada - com download de PDF/XML.

Requisitos Funcionais

• Monta prompt padronizado com histórico químico e características do fio; chamada assíncrona ao Gemini.
• Padroniza a resposta (alertas de risco x sugestões técnicas).
• Em falha/timeout, registra o erro e não debita o crédito.

Critérios de Aceite

• API retorna em até 15 segundos.
• Alertas de incompatibilidade (ex: luzes em cabelo com alisamento incompatível) destacados criticamente.
• Uso só permitido com saldo positivo de créditos.

Requisitos Funcionais

• IA retorna categorias de ativos/tratamentos necessários.
• Busca no estoque (Módulo 4): se há saldo, lista para uso; se não, gera redirecionamento de compra no Marketplace (Módulo 8).

Critérios de Aceite

• Validação no estoque em tempo real com base no retorno da IA.
• Link do marketplace direciona exatamente ao item/categoria sugerida.

Requisitos Funcionais

• 1 chamada bem-sucedida = 1 crédito. Saldo lido pelo plano (Professional = 1.000; Enterprise = 10.000).
• Saldo renovado no ciclo de faturamento. Chamadas com erro não debitam.

Critérios de Aceite

• Dedução atômica, vinculada ao retorno de sucesso (HTTP 200).
• Botão "Analisar com IA" desabilitado se saldo zero; banner de alerta abaixo de 10%.

Requisitos Funcionais

• Pacotes: 500, 1.000, 2.500, 5.000, 10.000 e 25.000 créditos.
• Cobrança gerada pelo gateway (Módulo 5); liberação automática via webhook de pagamento.

Critérios de Aceite

• Saldo atualizado instantaneamente após status "Pago" via webhook.
• Histórico de compras em tabela (data, pacote, valor).

Requisitos Funcionais

• CRUD de Cursos (título, descrição, imagem de capa, carga horária, instrutor).
• Estrutura em Módulos e Aulas (vídeos); links de plataformas externas (YouTube não listado, Vimeo).
• Upload de materiais de apoio (PDF) por aula.
• Acesso vinculado a planos (Módulo 1) ou venda avulsa.

Critérios de Aceite

• Curso só aparece aos alunos se marcado como "Publicado".
• Validação de campos obrigatórios (título, link do vídeo, carga horária).

Requisitos Funcionais

• Vitrine filtra o que o usuário tem permissão de acessar (Autenticação/Planos - Módulo 1).
• Página de detalhes com ementa; player de vídeo (iframe seguro).
• Marcação manual/semi-automática de "Aula Concluída"; download de PDFs de apoio.

Critérios de Aceite

• Player carrega sem sair do ecossistema.
• Status "Aula Concluída" salvo vinculado ao perfil do usuário.
• Design totalmente responsivo (mobile e web).

Requisitos Funcionais

• Cálculo percentual automático (aulas concluídas / total).
• Botão "Emitir Certificado" liberado só em 100%.
• PDF com Nome do Aluno, Curso, Carga Horária, Data de Conclusão e assinatura digitalizada.

Critérios de Aceite

• Progresso atualizado em tempo real ao concluir uma aula.
• Certificado gerado com dados precisos do usuário logado.

Requisitos Funcionais

• Super Admin vincula tags/IDs de produtos a uma aula ou curso.
• Vitrine de produtos recomendados para a técnica ensinada.
• Clique redireciona para a compra no Módulo 8 (Marketplace).

Critérios de Aceite

• Sem produtos vinculados, a área fica oculta sem quebrar o layout.
• Clique abre o contexto de compra mantendo a sessão do usuário.

Requisitos Funcionais

• Listagem ativa com paginação; filtros por categoria e busca por nome/palavra-chave.
• Página de detalhes (título, descrição, preço, imagens, regras e selo de cashback).
• Vitrine como aba nativa na Plataforma de Cursos (Módulo 7) e no Portal do Cliente (Módulo 9).

Critérios de Aceite

• Busca textual retorna resultados em até 2 segundos.
• Produtos inativados/sem estoque não aparecem na listagem principal.

Requisitos Funcionais

• Estado do carrinho durante a sessão; cálculo de subtotal, descontos, frete (API de correios/transportadora) e total.
• Pagamento via PIX (QR Code/Copia e Cola) e Cartão de Crédito.
• Logs estruturados em falhas (observabilidade do Módulo 10).
• Pedido com status Pendente → Aprovado → Enviado → Entregue.

Critérios de Aceite

• PIX atualiza o status via webhook automaticamente.
• Carrinho não permite comprar quantidade superior ao estoque.

Requisitos Funcionais

• Lê configurações de cashback (habilitado e percentuais) do Super Admin (Módulo 10).
• Provisiona saldo ao cliente/empresa após o pedido virar "Entregue".
• Aplicação parcial/total do saldo no checkout de novas compras.
• Sem saque: saldo virtual exclusivo para abater valores no marketplace.

Critérios de Aceite

• Desconto por cashback não ultrapassa o total do carrinho.
• Compras canceladas/reembolsadas estornam o cashback da transação.

Requisitos Funcionais

• Lê o histórico clínico do cliente (Módulo 2) para identificar últimos procedimentos.
• Exibe produtos mapeados como "Pós-procedimento" (ex: shampoo após descoloração).
• Cruza sugestões da IA (Módulo 6) com os IDs dos produtos do catálogo global.

Critérios de Aceite

• Se a IA recomendar um componente (ex: Queratina), exibe cosméticos com essa tag.
• Sem histórico/recomendações recentes, a seção é ocultada ou mostra "Mais Vendidos".

Requisitos Funcionais

• Exibe o próximo agendamento confirmado (Módulo 3).
• Acessos rápidos: "Novo Agendamento", "Meu Histórico" e "Marketplace" (Módulo 8).
• Alertas básicos de manutenção (ex: "Está na hora de retocar sua raiz").

Critérios de Aceite

• Tela carrega em menos de 3 segundos com dados atualizados.
• Sem agendamentos futuros, exibe Call to Action para novo agendamento.

Requisitos Funcionais

• Lista procedimentos passados em ordem cronológica reversa.
• Galerias "Antes e Depois" (sem edição/desenho para o cliente).
• Visualização/download (PDF) de termos de consentimento e anamneses assinados.
• Aba "Terapia Capilar" detalhando os tratamentos por sessão.

Critérios de Aceite

• Cliente não pode alterar nenhuma informação do histórico.
• PDFs das anamneses refletem exatamente as respostas dadas no Módulo 2.

Requisitos Funcionais

• Fluxo em etapas: Serviço → Profissional → Data e Horário.
• Disponibilidades consultadas em tempo real no Módulo 3.
• Se o pagamento online está habilitado, aciona o checkout transparente (Asaas; regras/NFe do Módulo 5).
• Pagamento via PIX (QR Code/Copia e Cola) ou Cartão de Crédito.

Critérios de Aceite

• Reserva o horário temporariamente durante o pagamento (evita double-booking).
• Após confirmação do Asaas, o status muda para "Confirmado" automaticamente.

Requisitos Funcionais

• Instruções cadastradas pelo profissional ou sugeridas pela IA (Módulo 6), atreladas ao histórico.
• Lista produtos recomendados especificamente para o cliente.
• Botão de redirecionamento à compra no Módulo 8 (Marketplace e Cashback).

Critérios de Aceite

• Clique em "Comprar agora" leva à página do produto, mantendo a sessão ativa.
• Recomendações condizem com o último procedimento realizado.

Requisitos Funcionais

• Listagem de todas as empresas; plano atual (Starter, Professional, Enterprise) e status (Ativa, Inadimplente, Cancelada).
• Bloqueio (suspensão) ou desbloqueio manual, refletindo nas permissões (Módulo 1).
• Alteração manual de plano (upgrade/downgrade) para suporte.

Critérios de Aceite

• Ao bloquear uma empresa, todos os seus usuários perdem o acesso no próximo login/interação.
• Alterações de plano recalculam os limites de IA (Módulo 6).

Requisitos Funcionais

• Habilitar/desabilitar o cashback globalmente.
• Definir a porcentagem padrão de cashback e as categorias elegíveis (Módulo 8).
• Configurar valores/quantidades dos pacotes avulsos de IA (500, 1.000, 2.500, etc.).

Critérios de Aceite

• Alterações de cashback refletem imediatamente no cálculo de futuras transações (Módulo 8).
• Alteração de pacotes de IA atualiza a vitrine de compra (Módulo 6).

Requisitos Funcionais

• Assinaturas: empresas ativas por plano e taxa de churn (cancelamentos) básica.
• Adoção de IA: volume de créditos consumidos no mês e pacotes avulsos vendidos.
• Marketplace: volume financeiro de vendas e total de cashback gerado/utilizado.
• Exportação dos dados tabulares em CSV.

Critérios de Aceite

• Relatórios consolidam com precisão os dados transacionados, respeitando o filtro de data.
• CSV gerado corretamente e pronto para leitura em planilhas.

Requisitos Funcionais

• Logs estruturados por nível (Error, Warning) em tempo de execução.
• Rastreabilidade de integrações externas (Asaas, API de IA, NFe).
• Metadados: Data/Hora, Módulo Origem, ID da Empresa afetada e código/mensagem do erro.

Critérios de Aceite

• Captura e exibe falhas críticas em até 1 minuto após a ocorrência.
• Filtros por período, ID da empresa e módulo gerador do erro.