# COMPANY - Gestão Financeira
## Guia Completo de Instalação

### Visão Geral

O **COMPANY - Gestão Financeira** é um sistema completo de gerenciamento de receitas e despesas desenvolvido em PHP puro, compatível com qualquer servidor cPanel.

---

## Opção 1: Instalação Automática (Recomendado)

### Passo 1: Upload dos Arquivos

1. Extraia o arquivo `company-gestao-financeira.zip`
2. Via FTP ou Gerenciador de Arquivo do cPanel, faça upload de todos os arquivos para a pasta `public_html` ou um subdiretório (ex: `/sistema`)

### Passo 2: Executar Instalador

1. Acesse no navegador: `https://seusite.com/sistema/INSTALACAO_AUTOMATICA.php`
2. Preencha os dados:
   - **Usuário MySQL**: Geralmente `root` ou o usuário criado no cPanel
   - **Senha MySQL**: A senha do usuário MySQL
3. Clique em **"Instalar Sistema"**

### Passo 3: Acessar o Sistema

Após a instalação bem-sucedida:
- Acesse: `https://seusite.com/sistema/public/login.php`
- **Email**: admin@company.com
- **Senha**: admin123

---

## Opção 2: Instalação Manual

### Passo 1: Upload dos Arquivos

1. Extraia o arquivo ZIP
2. Faça upload de todos os arquivos para seu servidor via FTP

### Passo 2: Criar Banco de Dados

1. Acesse o **phpMyAdmin** no cPanel
2. Clique em "Novo" ou "Criar banco de dados"
3. Nome do banco: `company_financeiro`
4. Clique em "Criar"

### Passo 3: Importar Tabelas

1. No phpMyAdmin, selecione o banco `company_financeiro`
2. Clique na aba "Importar"
3. Selecione o arquivo `database/schema.sql`
4. Clique em "Executar"

### Passo 4: Configurar config.php

1. Abra o arquivo `config/config.php` com um editor de texto
2. Preencha as informações do banco de dados:
   ```php
   define('DB_HOST', 'localhost');
   define('DB_USER', 'seu_usuario_mysql');
   define('DB_PASS', 'sua_senha_mysql');
   define('DB_NAME', 'company_financeiro');
   ```
3. Salve o arquivo

### Passo 5: Acessar o Sistema

- Acesse: `https://seusite.com/sistema/public/login.php`
- **Email**: admin@company.com
- **Senha**: admin123

---

## Estrutura de Diretórios

```
company-gestao-financeira/
├── public/                    # Arquivos públicos (acesso web)
│   ├── index.php             # Dashboard
│   ├── login.php             # Página de login
│   ├── contas.php            # Gerenciar contas
│   ├── lancamentos.php       # Registrar receitas/despesas
│   ├── importar_ofx.php      # Importar OFX
│   ├── relatorios.php        # Relatórios e filtros
│   ├── exportar.php          # Exportar PDF/Excel
│   └── logout.php            # Fazer logout
├── config/                    # Configurações
│   └── config.php            # Banco de dados e configurações
├── includes/                  # Arquivos inclusos
│   ├── header.php            # Cabeçalho HTML
│   └── footer.php            # Rodapé HTML
├── database/                  # Banco de dados
│   └── schema.sql            # Script de criação de tabelas
├── INSTALACAO_AUTOMATICA.php # Instalador automático
├── GUIA_INSTALACAO.md        # Este arquivo
└── README.md                 # Documentação geral
```

---

## Credenciais Padrão

| Campo | Valor |
|-------|-------|
| **Email** | admin@company.com |
| **Senha** | admin123 |

⚠️ **IMPORTANTE**: Altere a senha imediatamente após o primeiro login!

---

## Funcionalidades Principais

### 1. Dashboard
- Visualização de saldos em tempo real
- Gráficos de receitas vs despesas
- Últimos lançamentos registrados

### 2. Gestão de Contas
- Criar múltiplas contas bancárias
- Separação entre Pessoa Física (PF) e Pessoa Jurídica (PJ)
- Definir saldo inicial

### 3. Lançamentos
- Registrar receitas (entradas)
- Registrar despesas (saídas)
- Categorizar transações
- Adicionar descrições

### 4. Importação OFX
- Importar extratos de bancos
- Compatível com: Itaú, Bradesco, NuBank, Inter, Cora, etc.
- Detecção automática de duplicatas

### 5. Filtros e Relatórios
- Filtrar por tipo de conta (PF/PJ)
- Filtrar por conta específica
- Filtrar por período
- Filtrar por tipo (receita/despesa)
- Filtrar por categoria
- Busca por palavra-chave

### 6. Exportação
- Exportar relatórios em PDF
- Exportar dados em Excel
- Formatação profissional

---

## Solução de Problemas

### Erro: "Conexão recusada"
- Verifique o usuário e senha do MySQL
- Confirme que o host é `localhost`
- Verifique se o MySQL está ativo no cPanel

### Erro: "Permissão negada"
- Verifique as permissões dos diretórios (755 para pastas, 644 para arquivos)
- Via FTP, clique direito > Permissões

### Erro: "Banco de dados não encontrado"
- Execute novamente o instalador automático
- Ou importe manualmente o arquivo `database/schema.sql`

### Erro ao fazer login
- Confirme que o banco de dados foi criado corretamente
- Verifique se a tabela `usuarios` existe no phpMyAdmin

---

## Segurança

### Recomendações

1. **Altere a senha padrão** imediatamente após o primeiro login
2. **Crie um novo usuário admin** com credenciais fortes
3. **Faça backups regulares** do banco de dados
4. **Use HTTPS** (SSL/TLS) para acessar o sistema
5. **Restrinja o acesso** via .htaccess se necessário

### Arquivo .htaccess

Um arquivo `.htaccess` está incluído para proteger diretórios sensíveis. Certifique-se de que:
- O módulo `mod_rewrite` está ativado no Apache
- O arquivo está na raiz do sistema

---

## Suporte e Documentação

Para mais informações ou suporte:
- Consulte o arquivo `README.md`
- Verifique o arquivo `PROJETO_RESUMO.txt` para detalhes técnicos

---

## Versão

**COMPANY - Gestão Financeira v1.0**
- Data: Junho 2026
- Desenvolvido para: Company Comunicação

---

## Licença

Este sistema é fornecido como está. Todos os direitos reservados.

---

**Última atualização**: Junho 2026