K3 PROMOTOR — INSTALAÇÃO NO VPS OVH 51.91.156.22
=================================================

ESTRUTURA ESPERADA NO SERVIDOR
/var/www/html/k3promotor/
  api/
  config/
  lib/
  portal/
  sql/
  uploads/

1) ENVIE O CONTEÚDO DA PASTA "servidor" PARA:
   /var/www/html/k3promotor/

2) CRIE/IMPORTE O BANCO PELO PHPMYADMIN
   Arquivo: sql/schema.sql
   Banco criado: k3promotor

3) CRIE UM USUÁRIO MYSQL PARA O SISTEMA
   Exemplo no MySQL:

   CREATE USER 'k3promotor'@'localhost' IDENTIFIED BY 'COLOQUE_UMA_SENHA_FORTE';
   GRANT ALL PRIVILEGES ON k3promotor.* TO 'k3promotor'@'localhost';
   FLUSH PRIVILEGES;

4) EDITE:
   /var/www/html/k3promotor/config/config.php

   Troque:
   'pass' => 'TROQUE_A_SENHA_MYSQL'

   pela senha real do usuário MySQL k3promotor.

5) PERMISSÃO DA PASTA DE FOTOS
   sudo chown -R www-data:www-data /var/www/html/k3promotor/uploads
   sudo chmod -R 775 /var/www/html/k3promotor/uploads

6) PHP NECESSÁRIO
   PHP 8.1 ou superior, extensões:
   pdo_mysql, mbstring, fileinfo

   Exemplo Debian/Ubuntu:
   sudo apt update
   sudo apt install apache2 php php-mysql php-mbstring php-xml php-curl libapache2-mod-php
   sudo a2enmod rewrite
   sudo systemctl restart apache2

7) PORTAL
   http://51.91.156.22/k3promotor/portal/

   Usuário inicial:
   admin@k3.local
   Admin@123

8) APP
   Android Studio -> Open -> android/K3Promotor

   Usuário de teste:
   promotor@k3.local
   Promotor@123

9) ENDEREÇO DA API JÁ CONFIGURADO NO APP
   http://51.91.156.22/k3promotor/api/

10) PRODUÇÃO
   Recomendado apontar um domínio para o VPS, instalar certificado HTTPS (Let's Encrypt)
   e depois alterar ApiClient.kt + config.php para https://.

FOTOS
Cada imagem é salva no servidor e também recebe um carimbo visual com:
- tipo da foto (CHECKIN / ANTES / DEPOIS)
- data e hora
- rua/número
- bairro
- cidade/estado
- nome da loja
- latitude/longitude

FOTOS ANTES/DEPOIS
Não existe quantidade fixa. Cada clique em + FOTO ANTES / + FOTO DEPOIS
faz uma nova captura e cria um novo registro independente no MySQL.