======================================== 03 - FLUXO GERAL DO SAAS NEXUFLOW ======================================== Este arquivo define o CAMINHO COMPLETO que o usuário faz dentro do sistema. Nada de detalhes técnicos aqui — apenas as etapas principais. O fluxo precisa caber em 5 a 8 passos. Quanto mais simples, melhor. ======================================== 1) FLUXO DE LOGIN ======================================== → Como o usuário entra no sistema? O usuário acessa a tela de login e informa e-mail + senha. O sistema valida as credenciais no banco e identifica o nível de acesso (Super Admin, Administrador ou Funcionário). Se o login for válido, o sistema cria a sessão do usuário (session PHP) e registra log de acesso. O usuário é redirecionado automaticamente para a tela inicial (dashboard ou lista de pedidos). Se as credenciais forem inválidas, exibe mensagem de erro sem recarregar a página. Se o usuário marcar “Lembrar”, o sistema cria token de login persistente (cookie seguro). ======================================== 2) TELA INICIAL (PRIMEIRA INTERAÇÃO) ======================================== Após o login, o usuário é redirecionado para a página inicial do sistema (Home). A tela inicial apresenta um painel limpo, com a barra lateral já aberta mostrando os módulos principais: Clientes, Produtos, Pedidos, Serviços, Orçamentos, Financeiro, Usuários e Configurações. No espaço central, inicialmente é exibida uma área neutra (“quadro em branco”), reservada para o futuro dashboard, onde ficarão indicadores principais do negócio (ex.: total de pedidos, pedidos em aberto, faturamento, últimos lançamentos). Caso o usuário seja Administrador, ele terá acesso a todos os módulos; Funcionários verão apenas os módulos liberados conforme suas permissões. A tela inicial serve como ponto de acesso rápido para navegar entre os módulos do sistema. ======================================== 3) FLUXO DE ORÇAMENTO / PEDIDO ======================================== O usuário acessa o menu lateral "Pedidos" e escolhe a opção "Inserir". Na tela de novo pedido, o usuário seleciona o cliente (já cadastrado) através de um campo de busca/lista. Em seguida, adiciona itens ao pedido usando o botão "Adicionar Produto". Para cada item, o usuário seleciona um produto/serviço, informa quantidade, unidade, desconto (quando houver) e o valor unitário. O sistema calcula automaticamente o total de cada linha e o total geral do pedido. Existe a opção de cadastrar um novo produto de forma simples diretamente pela tela do pedido (função que poderá ser refinada na versão final, integrando com estoque/XML de entrada). O usuário pode preencher observações/comentários gerais do pedido (campo de texto livre). Após conferir os dados, o usuário clica em "Salvar". O sistema grava o pedido com um status inicial (ex.: "Em aberto" ou "Orçamento") e registra data, usuário responsável e valores. A partir do pedido salvo, será possível na sequência gerar PDF, enviar por e-mail para o cliente, imprimir e atualizar o status do pedido (aprovado, faturado, cancelado, etc.) através da área de gerenciamento de pedidos. ======================================== 4) FLUXO DE CLIENTES ======================================== → O usuário acessa o menu “Clientes” e escolhe entre “Inserir” ou “Gerenciar”. → Na opção “Inserir”, o sistema apresenta um formulário completo para cadastro de Pessoa Física ou Pessoa Jurídica. → O usuário seleciona o tipo de cliente e preenche os dados básicos: razão social/nome, CNPJ/CPF, inscrição estadual, endereço, cidade, estado, CEP, telefones e e-mail. → O sistema possui preenchimento automático via CNPJ ou CEP, agilizando o cadastro. → O usuário também informa o canal de captação (WhatsApp, e-mail, rede social, loja física, indicação etc.) e o segmento do cliente, ambos gerenciáveis pelo Administrador. → Há um campo de “Observações Gerais” com editor de texto para registrar informações adicionais importantes. → Após salvar, o cliente passa a aparecer na lista de “Gerenciar”, onde o usuário pode editar, visualizar detalhes ou excluir (dependendo das permissões). → Dentro do módulo de gerenciamento, será possível futuramente ver o histórico de pedidos vinculados ao cliente e anexar documentos específicos. ======================================== 5) FLUXO DE PRODUTOS / SERVIÇOS ======================================== O usuário acessa o menu “Produtos” e escolhe a opção “Inserir” para cadastrar um novo item. A tela apresenta um formulário simples contendo: nome do produto/serviço, unidade de medida e valor unitário. Após preencher os campos, o usuário salva o registro, que passa a aparecer na listagem de produtos. Este cadastro rápido permite que o produto seja imediatamente utilizado na criação de pedidos e orçamentos. Atualmente, o módulo é básico e não possui controle de estoque, variações ou entradas de nota fiscal. Em versões futuras, o módulo será expandido para incluir: - controle de estoque mínimo e estoque atual, - importação automática via XML (NF-e), - categorias e variações, - histórico de movimentações e entradas. No MVP, o foco é permitir cadastrar produtos e usá-los rapidamente nos pedidos, sem complexidade adicional. ======================================== 6) FLUXO DO FINANCEIRO (MVP) ======================================== → O usuário acessa o menu “Financeiro” para visualizar os títulos a receber gerados a partir dos pedidos/orçamentos aprovados. → A tela apresenta uma listagem com vencimento, cliente, referência (ex.: parcela X do orçamento Y), valor, situação e forma de pagamento. → O usuário pode aplicar filtros por cliente, data inicial/final, forma de pagamento e situação (pendente, pago, cancelado), além de gerar relatórios em PDF. → Ao clicar em “Ações”, o usuário pode visualizar, editar, baixar (dar baixa no título) ou cancelar o lançamento financeiro. → Na tela de edição do título, o usuário vê as informações principais: cliente, referência, vencimento, valor, forma de pagamento e campo para observações. → Para dar baixa, basta clicar em “Baixar”, registrar a data do pagamento e confirmar. A situação do título muda automaticamente para “Pago”. → Títulos cancelados ficam registrados para histórico, mas não impactam relatórios futuros. → O módulo financeiro do MVP não possui ainda: - integração bancária, - conciliação automática, - envio automático de cobrança, - recebíveis por boleto ou cartão. → No MVP, o objetivo é permitir acompanhar vencimentos, registrar pagamentos manualmente e manter um controle simples de contas a receber. ======================================== 7) FLUXO DA BIBLIOTECA DE ARQUIVOS ======================================== O usuário acessa o módulo de arquivos (ou a área de anexos dentro de Clientes/Pedidos) para gerenciar documentos do sistema. Ao clicar em “Enviar arquivo”, o sistema abre um formulário simples onde o usuário seleciona o arquivo no computador. O usuário informa uma descrição/título para o arquivo e, opcionalmente, vincula o documento a um cliente específico e/ou a um pedido/orçamento. Ao confirmar o envio, o sistema faz o upload do arquivo para o servidor, grava os metadados no banco (nome original, caminho, tamanho, tipo, usuário que enviou e data/hora). Os arquivos aparecem em uma listagem, que pode ser filtrada por cliente, tipo de documento, data de envio ou usuário responsável. A partir da listagem, o usuário pode: - baixar o arquivo, - visualizar detalhes (descrição, data, vínculo), - excluir o arquivo (apenas se tiver permissão, ex.: Administrador). No MVP não há controle de versão de arquivos, pré-visualização avançada nem assinatura eletrônica; o objetivo é oferecer um repositório simples para armazenar e recuperar documentos importantes ligados aos clientes e pedidos. ======================================== 8) CICLO COMPLETO DO SISTEMA (RESUMO) ======================================== Cliente é cadastrado → pedido é criado → itens e valores são definidos → PDF é gerado/enviado → pedido é aprovado → título financeiro é criado → pagamento é registrado → documentos são arquivados. ======================================== OBSERVAÇÕES ==========