# K3 PROMOTOR — App Android + Portal Web

Projeto completo inicial do **K3 Promo & Trade** para execução de promotores no PDV.

## O que já funciona

### Aplicativo Android nativo (Kotlin)
- Login por usuário/senha.
- Roteiro do dia recebido do portal.
- Tela inicial no visual preto/laranja da K3.
- Check-in obrigatório com **selfie**, GPS, endereço e horário.
- A selfie de check-in é feita pela câmera no momento; não usa galeria.
- Fotos **ANTES** e **DEPOIS** sem limite fixo.
- Cada toque em `+ FOTO ANTES` ou `+ FOTO DEPOIS` cria uma nova captura.
- Observação individual para cada foto.
- Carimbo gravado dentro da própria imagem com tipo, data/hora, endereço, loja e coordenadas GPS.
- Upload da foto original já carimbada para o servidor.
- Status por foto: `PENDENTE`, `APROVADO`, `AJUSTAR`.
- Conversa/interação vinculada a cada foto entre promotor e portal.
- Check-out com GPS, endereço e horário.

### Portal Web PHP/MySQL
- Identidade visual K3 preta/laranja com a logo fornecida.
- Dashboard com visitas, lojas atendidas, promotores ativos e taxa de execução.
- Lista e filtros de visitas.
- Tela detalhada da visita com check-in, fotos antes/depois, GPS, observações e interações.
- Aprovação das fotos ou marcação `AJUSTAR`.
- Cadastro e ativação/desativação de promotores.
- Cadastro de lojas/PDVs e coordenadas GPS.
- Montagem de roteiro por data/promotor.
- Galeria de fotos.
- Mapa de check-ins usando OpenStreetMap/Leaflet.
- Relatório de produtividade por período.

## Servidor configurado

URL base prevista:

`http://51.91.156.22/k3promotor/`

Portal:

`http://51.91.156.22/k3promotor/portal/`

API Android:

`http://51.91.156.22/k3promotor/api/`

## Banco

Importe `servidor/sql/schema.sql` no phpMyAdmin. O banco criado é `k3promotor`.

Usuários de demonstração:

- Portal: `admin@k3.local` / `Admin@123`
- App: `promotor@k3.local` / `Promotor@123`

**Troque essas senhas antes de colocar em produção.**

## Configuração

Edite:

`servidor/config/config.php`

Coloque o usuário e a senha reais do MySQL no VPS.

## Android Studio

Abra a pasta:

`android/K3Promotor`

A URL da API está em:

`app/src/main/java/com/k3/promotor/data/ApiClient.kt`

Quando instalar HTTPS no domínio, troque a URL de `http://` para `https://` e depois desative cleartext traffic.

## Logo

A logo K3 já está colocada em:

- `servidor/portal/assets/logo_k3.png`
- `android/K3Promotor/app/src/main/res/drawable-nodpi/logo_k3.png`