================================================================================
COMPANY - Gestão Financeira
Sistema de Gerenciamento Financeiro
Versão 1.0.0
================================================================================

GUIA DE INSTALAÇÃO COMPLETO

================================================================================
1. REQUISITOS DO SERVIDOR
================================================================================

- Servidor Web: Apache 2.4+ ou Nginx
- PHP: 8.0 ou superior
- Banco de Dados: MySQL 5.7+ ou MariaDB 10.3+
- Extensões PHP obrigatórias:
  * mysqli
  * session
  * mbstring
  * gd (opcional, para gráficos)

Verificar versão do PHP:
- Acesse o cPanel → PHP Configuration
- Verifique se a versão é 8.0 ou superior

================================================================================
2. PASSO A PASSO DE INSTALAÇÃO
================================================================================

PASSO 1: Preparar o Banco de Dados
----------------------------------
1. Acesse o cPanel do seu servidor
2. Clique em "MySQL Databases"
3. Crie um novo banco de dados (ex: company_financeiro)
4. Crie um novo usuário MySQL (ex: company_user)
5. Atribua o usuário ao banco de dados com TODOS os privilégios

PASSO 2: Upload dos Arquivos
-----------------------------
1. Extraia o arquivo company-gestao-financeira.zip
2. Acesse o cPanel → File Manager
3. Navegue até a pasta public_html
4. Crie uma pasta chamada "sistema"
5. Faça upload de TODOS os arquivos para dentro da pasta "sistema"

Estrutura esperada:
public_html/
└── sistema/
    ├── public/
    ├── config/
    ├── database/
    ├── includes/
    ├── uploads/
    ├── reports/
    └── LEIA-ME.md

PASSO 3: Importar Banco de Dados
--------------------------------
1. Acesse o cPanel → phpMyAdmin
2. Selecione o banco de dados criado no PASSO 1
3. Clique na aba "Import"
4. Selecione o arquivo "database/schema.sql"
5. Clique em "Go" para importar

PASSO 4: Configurar o Sistema
------------------------------
1. Acesse o cPanel → File Manager
2. Navegue até: sistema/config/config.php
3. Clique com botão direito → Edit
4. Localize as seguintes linhas e altere com suas informações:

   define('DB_HOST', 'localhost');
   define('DB_USER', 'company_user');      // Usuário criado no PASSO 1
   define('DB_PASS', 'sua_senha');         // Senha do usuário
   define('DB_NAME', 'company_financeiro'); // Banco criado no PASSO 1
   define('APP_URL', 'https://seusite.com.br/sistema/public/');

5. Salve o arquivo

PASSO 5: Verificar Permissões
-----------------------------
1. Acesse o cPanel → File Manager
2. Selecione a pasta "sistema"
3. Clique em "Change Permissions"
4. Defina como 755 para pastas e 644 para arquivos
5. Marque "Apply to all files, directories, and subdirectories"

PASSO 6: Acessar o Sistema
--------------------------
1. Abra seu navegador
2. Acesse: https://seusite.com.br/sistema/public/login.php
3. Credenciais padrão:
   - Email: admin@company.com
   - Senha: admin123

IMPORTANTE: Altere a senha do administrador imediatamente após o primeiro login!

================================================================================
3. SOLUÇÃO DE PROBLEMAS
================================================================================

ERRO: "Erro ao conectar ao banco de dados"
------------------------------------------
- Verifique se o banco de dados foi criado corretamente
- Confirme o nome de usuário e senha no config.php
- Certifique-se de que o usuário tem permissão de acesso ao banco

ERRO: "Página em branco ou erro 500"
------------------------------------
- Verifique se o PHP 8.0+ está ativado no cPanel
- Verifique as extensões PHP necessárias (mysqli, session, mbstring)
- Ative o modo de depuração em config.php: define('DEBUG_MODE', true);
- Verifique o arquivo de log de erros do servidor

ERRO: "Permissão negada ao fazer upload"
----------------------------------------
- Verifique as permissões da pasta "uploads"
- Altere para 755 via File Manager do cPanel

ERRO: "Importação OFX não funciona"
-----------------------------------
- Certifique-se de que o arquivo OFX está no formato correto
- Tente um arquivo OFX de outro banco
- Verifique se o tamanho do arquivo é menor que 10MB

================================================================================
4. FUNCIONALIDADES PRINCIPAIS
================================================================================

DASHBOARD
- Visão geral das finanças
- Gráficos de receitas vs despesas
- Últimos lançamentos registrados
- Saldos por tipo de conta (PF/PJ)

CONTAS BANCÁRIAS
- Cadastro de múltiplas contas
- Separação por Pessoa Física (PF) e Pessoa Jurídica (PJ)
- Informações de banco, agência e conta
- Saldo inicial configurável

LANÇAMENTOS
- Registro rápido de Entradas (Receitas)
- Registro rápido de Saídas (Despesas)
- Categorização automática
- Descrição detalhada

IMPORTAÇÃO OFX
- Importação de extratos bancários
- Compatível com: Itaú, Bradesco, NuBank, Inter, Cora e outros
- Detecção automática de duplicatas
- Atribuição automática de categorias

RELATÓRIOS
- Filtros avançados por:
  * Tipo de conta (PF/PJ)
  * Conta específica
  * Período (hoje, este mês, mês passado, customizado)
  * Tipo de lançamento (entrada/saída)
  * Categoria
  * Palavra-chave
- Exportação em PDF
- Exportação em Excel

================================================================================
5. SEGURANÇA
================================================================================

RECOMENDAÇÕES IMPORTANTES:

1. Altere a senha padrão imediatamente
2. Use HTTPS em produção (ative em config.php)
3. Faça backup regular do banco de dados
4. Mantenha o PHP atualizado
5. Use senhas fortes (mínimo 12 caracteres)
6. Não compartilhe credenciais de acesso
7. Monitore logs de acesso regularmente

================================================================================
6. SUPORTE E CONTATO
================================================================================

Desenvolvido por: Company Comunicação
Versão: 1.0.0
Ano: 2026

Para suporte técnico, entre em contato com a Company Comunicação.

================================================================================