VIRTUAL FINANCEIRO v0.1.0
INFRAREDE Soluções Tecnológicas
=============================================

OBJETIVO
Sistema SaaS multi-escritório para gestão administrativa e operacional de escritórios contábeis.
Não substitui o sistema de escrituração/apuração contábil-fiscal. Ele controla clientes, rotinas,
prazos, checklists, certificados, folha, parcelamentos e mensalidade de uso da plataforma.

PRINCIPAIS RECURSOS DESTA VERSÃO
- Super Administrador INFRAREDE.
- Escritórios assinantes isolados por tenant (multiempresa).
- Cadastro de usuários por escritório: Administrador, Supervisor e Usuário.
- Cadastro dos clientes do escritório.
- Regimes: Simples Nacional, Simples Nacional Híbrido e Lucro Presumido.
- Rotinas mensais, trimestrais e anuais geradas automaticamente sem duplicação.
- Status: Pendente, Em andamento, Guia providenciada, Guia enviada, Recebido,
  Sem movimento, Concluído e Não aplicável.
- Certificado digital com semáforo: verde >30 dias; amarelo <=30; vermelho <=7/vencido.
- Checklists de abertura e encerramento da empresa.
- Folha de pagamento com checklist e alertas de férias, dissídio e consignado.
- Parcelamentos de DCTFWeb, ISS, DAS ou personalizados, com guia mensal.
- Cobrança mensal do escritório assinante.
- Bloqueio automático após vencimento + tolerância.
- Mensagem de bloqueio: "Favor entrar em contato com a INFRAREDE para regularizar sua entrada."
- Integração Pix via Mercado Pago (QR Code, webhook e liberação automática após pagamento aprovado).
- Solicitação de extrato bancário por e-mail, manual ou automática no dia 01.
- Dashboard responsivo para desktop, notebook, tablet e celular.
- Histórico/auditoria das principais alterações.

REQUISITOS
- PHP 8.1 ou superior.
- MariaDB/MySQL.
- Extensões PDO MySQL e cURL.
- HTTPS recomendado/obrigatório em produção.
- Para envio de e-mail na v0.1: função PHP mail() habilitada no servidor/cPanel.

INSTALAÇÃO NO CPANEL
1. Crie um subdomínio/pasta para o sistema, por exemplo:
   https://financeiro.seudominio.com.br
2. Envie e extraia todo o conteúdo deste pacote na raiz do subdomínio.
3. No cPanel > MySQL Databases, crie:
   - banco de dados;
   - usuário;
   - senha forte;
   - associe o usuário ao banco com TODOS OS PRIVILÉGIOS.
4. Confira se as pastas config/ e storage/ estão graváveis durante a instalação.
5. Acesse no navegador:
   https://financeiro.seudominio.com.br/install/
6. O instalador fará teste de requisitos, conexão do banco, criação das tabelas e criação do
   Super Administrador INFRAREDE.
7. Após concluir, o arquivo storage/installed.lock bloqueia a reinstalação.

DEMONSTRAÇÃO OPCIONAL
No instalador existe a opção de criar dados demonstrativos:
- AUDIFIS
- TERNI
- Usuária Monique (monique@example.com)
- senha temporária da demonstração: TrocarSenha123!
Troque a senha antes de qualquer uso fora de testes.

CONFIGURAÇÃO PIX - MERCADO PAGO
A integração foi preparada para a API oficial de pagamentos Pix do Mercado Pago.

Opção mais simples no cPanel:
1. Copie config/secrets.example.php para config/secrets.php
2. Edite config/secrets.php:
   'base_url' => 'https://financeiro.seudominio.com.br',
   'mercadopago_access_token' => 'APP_USR-...',
   'support_phone' => '19 99431-1166'
3. Cadastre o aplicativo/credenciais de produção no Mercado Pago.
4. O Virtual Financeiro envia X-Idempotency-Key (UUID V4) ao criar o Pix.
5. URL do webhook:
   https://financeiro.seudominio.com.br/webhook/mercadopago.php
6. O webhook consulta o pagamento novamente na API do Mercado Pago, confere referência,
   valor e status aprovado antes de liberar a mensalidade.

ATENÇÃO: o Access Token é segredo de servidor. Nunca coloque essa credencial em JavaScript,
HTML ou aplicativo cliente.

CONFIGURAÇÃO DE E-MAIL PARA SOLICITAÇÃO DE EXTRATO
Em config/secrets.php:
   'mail_from' => 'financeiro@seudominio.com.br',
   'mail_from_name' => 'Nome do Escritório',
   'auto_send_bank_statement_email' => true,

A v0.1 usa a função mail() do servidor. O envio automático só acontece no dia 01,
após as tarefas mensais serem geradas, e o log impede duplicação da mesma solicitação.
Se o cliente não tiver e-mail cadastrado, a atividade permanece PENDENTE para tratamento manual.

CRON AUTOMÁTICO
Configure no cPanel > Cron Jobs para executar diariamente, por exemplo 00:05:
   php -q /CAMINHO/DO/SISTEMA/cron/daily.php

O Cron:
- cria a mensalidade do mês se ainda não existir;
- marca mensalidades vencidas;
- bloqueia/libera assinantes conforme pagamento;
- gera as rotinas mensais/trimestrais/anuais aplicáveis;
- no dia 01, se habilitado, envia a solicitação de extrato bancário por e-mail.

A geração é idempotente: executar novamente não duplica as mesmas tarefas.

REFORMA TRIBUTÁRIA 2026/2027
A biblioteca inicial usa modelos versionados por competência. Pontos considerados no desenho:
- 2026 é fase de teste/adaptação de CBS/IBS e há obrigações de documentos fiscais conforme as
  regras/Notas Técnicas vigentes.
- As regras de IBS/CBS no Simples Nacional produzem efeitos, em regra, a partir de 01/01/2027.
- O chamado "Simples Nacional Híbrido" é a opção em que a empresa permanece no Simples e escolhe
  recolher CBS/IBS pelo regime regular, fora do DAS.
- PIS/Cofins possuem modelos limitados até a competência 12/2026 no Lucro Presumido, com modelos
  CBS/IBS iniciando na transição de 2027.
- EFD-Reinf foi cadastrada com prazo-base dia 15, antecipando fim de semana no motor atual.
- ECD: modelo anual em junho; ECF: modelo anual em julho; DEFIS: março.
- EFD-Contribuições: modelo no 10º dia útil do segundo mês subsequente.
- DCTFWeb: modelo no último dia útil do mês seguinte.

IMPORTANTE: regras fiscais mudam e há diferenças por município, UF, atividade, evento e situação
especial. Os modelos são editáveis justamente para que Monique/contador responsável valide a
obrigatoriedade e o prazo antes do uso em produção.

LIMITAÇÃO DE CALENDÁRIO DA v0.1
O motor de dia útil considera sábado e domingo. Ainda não há base automática de feriados nacionais,
estaduais, municipais ou dias sem expediente bancário. O prazo exibido deve ser conferido pelo
escritório quando a norma exigir antecipação/prorrogação por calendário oficial.

FONTES OFICIAIS UTILIZADAS PARA A MODELAGEM INICIAL (consultadas em agosto/2026)
- Receita Federal: Orientações da Reforma Tributária para 2026.
- Receita Federal/CGSN: atualização das regras do Simples Nacional para IBS/CBS (agosto/2026).
- Receita Federal: FAQ EFD-Reinf.
- Receita Federal: FAQ ECD e ECF.
- Receita Federal: FAQ EFD-Contribuições e Manual DCTFWeb.
- Mercado Pago Developers: pagamentos Pix / API de Payments e idempotência.

PRÓXIMAS EVOLUÇÕES RECOMENDADAS
- Calendário de feriados por cidade/UF.
- SMTP/API de e-mail transacional com melhor rastreabilidade de entrega.
- Anexos/documentos por tarefa e cliente.
- Portal do cliente do escritório contábil.
- Notificações por WhatsApp/e-mail.
- Relatórios de produtividade por usuário e cliente.
- Timesheet/rentabilidade.
- Importação em lote de clientes e colaboradores.
- MFA/2FA.

VERSÃO
Virtual Financeiro 0.1.0 - protótipo funcional / base para homologação com Monique.
