Fluxos Principais

Esta seção documenta os principais fluxos operacionais do VF Web.

Fluxo de Login

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  index.php  │────▶│ login.html   │────▶│conecta_login │
│  (entrada)  │     │  (form)      │     │   (valida)   │
└──────────────┘     └──────────────┘     └──────────────┘
       │                                           │
       │ não logado                                │ válido
       ▼                                           ▼
┌──────────────┐                           ┌──────────────┐
│  login.html  │                           │_Inicio/      │
│  (exibe)    │                           │ inicio.php   │
└──────────────┘                           └──────────────┘

Referências:

• Entrada: index.php
• Form: login.html
• Validação: _BD/conecta_login.php

Primeiro Acesso

Se o arquivo de constantes não existir, o sistema redireciona para:

// index.php:14-17
if(!realpath("privado/constantes/constantes.vf")){
    header("Location: privado/_Constante/criaConstante_login.html");
    exit;
}

Fluxo de Cadastro de Cliente

┌─────────────────┐
│ _Cadastros/     │
│ pessoas_edita   │ (formulário)
└────────┬────────┘
         │ submit
         ▼
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│ pessoas_grava   │────▶│ validação       │────▶│   DB.gravar    │
│ (lógica)        │     │                 │     │ (pessoas)      │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Referências:

• Form: _Cadastros/pessoas_edita.php
• Lógica: _Cadastros/pessoas_grava.php
• Classe: usuarios.class.php

Fluxo de Venda (Pedido)

1. Novo Pedido (_Lancamentos/pedidos_edita.php)
   └── Seleção do cliente (pessoas)
   └── Adição de produtos (produtos)
   └── Cálculo de valores
   └── Seleção de pagamento (forma_pagto)

2. Fechamento
   └── Atualização de situação
   └── Baixa de estoque (estoque.class.php)
   └── Geração de conta a receber (contarec.class.php)

Referências:

• Arquivo: _Lancamentos/pedidos_edita.php
• Classe: Class/pedidos.class.php
• Estoque: Class/estoque.class.php
• Financeiro: Class/contarec.class.php

Fluxo de Recebimento

1. Baixa de Conta (_Lancamentos/contarec_edita.php)
   └── Seleção da conta
   └── Informar valor, multa, desconto
   └── Selecionar meio de pagamento
   └── Selecionar conta corrente

2. Processamento
   └── contarec.class.php:baixaConta()
   └── Validação (valor ≤ devedor)
   └── Atualização de situação
   └── Geração de histórico (contarec_hist)
   └── Lançamento em CC (se configurado)

Referências:

• Arquivo: _Lancamentos/contarec_edita.php
• Classe: Class/contarec.class.php:42

Fluxo de PDV

1. Abertura (_Lancamentos/pdv_edita.php)
   └── Identificação do operador

2. Venda
   └── Scan código de barras
   └── Inclusão manual de produto
   └── Ajuste de quantidade
   └── Desconto (se permitido)

3. Fechamento
   └── Seleção forma pagamento
   └── Finalização da venda
   └── Impressão (se thermal)
   └── Baixa automática de estoque
   └── Geração de conta a receber

Referências:

• Arquivo: _Lancamentos/pdv_edita.php
• Template: _Lancamentos/_HTML/pdv_edita.html
• Impressão: _Lancamentos/pdv_termica_imprime.php
• Classe: Class/pdv.class.php

Fluxo de Orçamento → OS → Pedido

Orçamento (_Lancamentos/orcamentos_edita.php)
    │
    ▼ (aprovação)
Ordem de Serviço (_Lancamentos/os_edita.php)
    │
    ▼ (execução)
Produção (_Lancamentos/producao_edita.php)
    │
    ▼ (conclusão)
Pedido/Venda (_Lancamentos/pedidos_edita.php)
    │
    ▼
Conta a Receber

Fluxo de API

1. Requisição externa
   └── Header: X-API-Key: <chave>

2. Validação (Class/api.class.php)
   └── Verificação da chave
   └── Identificação do cliente

3. Processamento
   └── Execução da operação
   └── Retorno JSON

Referências:

• Classe: Class/api.class.php
• Geração de chave: api.class.php:16-61