Pedidos
Gerencie todos os pedidos recebidos
Clientes
Todos os clientes cadastrados
Estat�sticas
Vis�o geral do sistema
Total de Pedidos
�
Recebidos
�
Em Processamento
�
Conclu�dos
�
Hoje
�
Este M�s
�
Clientes
�
Novos Hoje
�
Conversas Chat
�
Perguntas FAQ
�
Produtos mais populares
Rob� Marina
Configure a IA e treine a assistente virtual
Gr�tis em aistudio.google.com
Em platform.openai.com (gpt-4o-mini)
Fallback autom�tico: Se o Gemini falhar (cota esgotada), o sistema tenta automaticamente o ChatGPT, e vice-versa. Configure ambas para m�xima disponibilidade.
Escreva aqui tudo que a Marina deve saber: produtos, pre�os, regras, fluxo de atendimento, respostas padr�o. Ela seguir� estas instru��es em todos os atendimentos.
Perguntas Frequentes
Perguntas registradas pelos clientes no chat
Documenta��o do Sistema
Guia completo de funcionamento do BH Na Foto v3.0
? Arquitetura do Sistema
O BH Na Foto � composto por 6 arquivos PHP com separa��o clara entre frontend, backend e configura��o:
| Arquivo | Fun��o |
|---|---|
index.php | P�gina inicial � cat�logo de tamanhos e identifica��o do cliente |
upload.php | P�gina de upload de fotos por tamanho, com cropper e sele��o de modo |
admin.php | Painel administrativo completo (este arquivo) |
api.php | Backend PHP � todas as a��es via JSON (uploads, auth, chat, stats) |
chatbot.php | Widget da Marina � inclu�do em todas as p�ginas via PHP include |
session_config.php | Configura��o centralizada de sess�es PHP |
? Banco de Dados (SQLite)
Localiza��o: data/bhnafoto.db
| Tabela | Descri��o | Colunas principais |
|---|---|---|
uploads | Pedidos de impress�o | id, nome_cliente, telefone_cliente, tipo_foto, total_fotos, status, folder_name, data_upload |
arquivos | Fotos de cada pedido | id, upload_id, nome_original, nome_arquivo_cortado, caminho_cortado, nome_arquivo_original, caminho_original, nome_arte_final, caminho_arte_final, tipo_mime |
admin_config | Configura��es gerais | setting_key, setting_value |
clientes | Cadastro de clientes | id, nome, telefone, primeiro_contato, ultimo_contato, total_pedidos |
chat_historico | Hist�rico de conversas | id, session_id, cliente_nome, cliente_telefone, role, message, media_type, created_at |
chat_faq | Perguntas frequentes detectadas | id, pergunta, categoria, contagem, primeira_vez, ultima_vez |
Propor��es de Corte por Produto
| Produto | Ratio | Dimens�o |
|---|---|---|
| Polaroid 7.5x10 | 1.0 | Quadrado (1:1) |
| Polaroid 7.5x10 c/ Legenda | 1.0 | Quadrado (1:1) |
| Mini Polaroid 5x7 | 0.9 | 4.5:5 |
| Mini Foto 5x5 | 1.0 | Quadrado (1:1) |
| Foto 7x7 | 1.0 | Quadrado (1:1) |
| Foto 3x4 | 0.75 | 3:4 |
| Foto Retr� 7.5x10 | 1.0 | Quadrado (1:1) |
| Foto 10x15 | 0.6667 | 2:3 |
| Foto 15x21 | 0.714 | 15:21 |
| Foto 20x30 | 0.6667 | 2:3 |
| Bola de Natal | 1.0 | Circular (1:1) |
| Tira 5x10 | 0.5 | 1:2 |
| Tira 7.5x21 | 0.357 | 7.5:21 |
Assistente Marina (IA)
A Marina � alimentada pela API Gemini 2.0 Flash do Google. Funciona diretamente no browser do cliente (sem proxy). Funcionalidades:
- Atende em portugu�s, ingl�s e espanhol
- Nunca se identifica como rob�/IA
- Detecta envio de v�deo e orienta o cliente
- Pergunta sobre borda/corte quando foto n�o � quadrada
- Envia links de upload por produto
- Orienta envio pela Shopee quando necess�rio
- Salva hist�rico completo de conversas no banco
- Registra perguntas frequentes automaticamente
Autentica��o e Sess�o
Sess�es PHP armazenadas em data/sessions/. Timeout do admin: 8 horas. A sess�o do cliente dura 24 horas. Configura��o centralizada em session_config.php.
Senha padr�o do admin: admin123 � alterar ap�s instala��o.
Estrutura de Arquivos de Upload
Cada pedido cria uma pasta em uploads/:
uploads/
+-- NomeCliente_TamanhoProduto_IDXXXXXX/
+-- fotos_cortadas/ ? fotos com recorte do cliente
+-- fotos_originais/ ? fotos originais sem corte
+-- arte_final/ ? ? foto encaixada no molde do Canva
+-- legendas.txt ? legendas (se produto com legenda)
Fluxo Completo do Pedido
- Cliente acessa o site e escolhe o tamanho
- Informa nome e WhatsApp (salvo em
clientes) - Sistema verifica propor��o da foto ? abre modal de fit (cortar/borda/blur) se necess�rio
- Cliente ajusta o enquadramento no cropper
- Fotos s�o enviadas em lotes de 5 via
api.php?action=upload - Sistema gera protocolo (ID000001) e pasta do pedido
- Admin recebe o pedido e altera status conforme progresso
- Sistema gera arte final encaixando a foto no molde do Canva automaticamente
- Admin pode baixar ZIP com todas as fotos (originais, cortadas e arte final)
Endpoints da API
| Action | M�todo | Auth | Descri��o |
|---|---|---|---|
login | POST | � | Login do admin |
logout | GET | � | Logout do admin |
check_auth | GET | � | Verifica se est� logado |
set_user | POST | � | Registra cliente na sess�o |
upload | POST | Sess�o | Upload de fotos |
uploads | GET | Admin | Lista pedidos |
upload_details | GET | Admin | Detalhes de um pedido |
update_status | POST | Admin | Altera status do pedido |
delete_upload | GET | Admin | Remove pedido e arquivos |
download | GET | Admin | Download ZIP do pedido |
stats | GET | Admin | Estat�sticas gerais |
clientes | GET | Admin | Lista clientes |
cliente_detalhes | GET | Admin | Detalhes + hist�rico do cliente |
chat_save | POST | � | Salva mensagem do chat |
chat_faq | POST | � | Registra pergunta frequente |
faq_list | GET | Admin | Lista FAQs |
chatbot_config | GET | Admin | Configura��es da Marina |
save_chatbot_config | POST | Admin | Salva configura��es da Marina |