================================================================================
  REGISTRO PRO — O QUE MUDAR QUANDO O APP ESTIVER HOSPEDADO (PRODUÇÃO)
================================================================================

Use HTTPS em produção (certificado válido no domínio). Evite IP 192.168.x.x
para usuários finais — isso é só desenvolvimento na mesma rede Wi‑Fi.

--------------------------------------------------------------------------------
0) CAMINHOS NO SEU COMPUTADOR (Windows) — ONDE ESTÁ CADA COISA
--------------------------------------------------------------------------------

  Ajuste o disco/pasta se o seu clone do projeto não estiver em XAMPP.

  Raiz do repositório Ponto SaaS:
    c:\xampp\htdocs\projetos\apps\ponto-saas\

  --- OBRIGATÓRIO ALTERAR EM PRODUÇÃO (URLs da API no app) ---

  • api-config.js — UM arquivo para todas as páginas que incluem js/api-config.js:
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\js\api-config.js

      Produção (recomendado): preencha UMA constante — todas as telas passam a usar a mesma base:
        - REGISTRO_PRO_DEPLOY_API_BASE  (URL completa da API até .../api, sem barra no final)
          Deixe '' em desenvolvimento.

      Desenvolvimento / legado (números de linha podem mudar; procure pelos nomes):
        - REGISTRO_PRO_LAN_IP             (IP do PC na Wi‑Fi — app nativo em dev)
        - REGISTRO_PRO_API_PATH           (caminho após o host até /api no XAMPP)
        - REGISTRO_PRO_API_BASE           (https + IP + path — derivado)
        - REGISTRO_PRO_API_BASE_LOCALHOST (http://localhost + path — navegador no PC)
        - REGISTRO_PRO_ROUTES             (só se renomear arquivos PHP da API)

  • Este guia (referência, não precisa alterar no servidor):
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\HOSTING-CONFIGURACAO.txt

  --- BACKEND QUE VOCÊ SOBE NO SERVIDOR (PHP / API) ---

  • Pasta da API (upload/configure no hosting para a mesma URL de REGISTRO_PRO_DEPLOY_API_BASE / API_BASE_URL):
      c:\xampp\htdocs\projetos\apps\ponto-saas\desktop\public\api\

  --- APP CORDOVA / APK (só se publicar build nativo) ---

  • config.xml do projeto Cordova (allow-navigation, Android cleartext, etc.):
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\config.xml

  • Política de rede Android (HTTP em dev; em produção HTTPS costuma bastar):
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\resources\android\xml\network_security_config.xml

  --- FRONT WEB (HTML) — em geral NÃO precisa mudar URL da API em cada arquivo ---

  Todas as telas abaixo já carregam js/api-config.js (relative: js/api-config.js).
  Ou seja: alterar SÓ o api-config.js (REGISTRO_PRO_DEPLOY_API_BASE ou API_BASE_URL no navegador) costuma resolver.

  Caminho da pasta do www no disco:
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\

  Exemplos de páginas que usam a API via api-config.js (lista não exaustiva):
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\login.html
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\New_palnel.html
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\ponto_botao.html
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\ponto_facial.html
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\ponto_qr_code.html
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\beneficios.html
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\painel_seguranca.html
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\espelho_ponto.html
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\meus_holerites.html
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\ronda_scanner.html
      c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\js\api-config.js

  Observação: js\routes.js (Framework7) não é o arquivo central de URL da API;
  para hospedagem da API use api-config.js.


--------------------------------------------------------------------------------
1) ENTENDA COMO O APP ESCOLHE A URL DA API
--------------------------------------------------------------------------------

  Arquivo que implementa a lógica:
    c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\js\api-config.js
    (função registroProGetApiBase)

  Ordem de prioridade (registroProGetApiBase):

  (1) localStorage "API_BASE_URL"
      → Se existir e for http:// ou https://, essa base vence tudo.
        Exemplo (SEM barra no final):
        https://seu-dominio.com.br/caminho/desktop/public/api

  (2) localStorage "LOGIN_API_URL" (legado)
      → URL completa do login, terminando em /auth/login.php
      → A base da API é deduzida removendo /auth/login.php
      → No app nativo (Cordova), se essa URL apontar para localhost/127.0.0.1,
        o código volta para a base montada com o IP da LAN (desenvolvimento).

  (3) Constante REGISTRO_PRO_DEPLOY_API_BASE no api-config.js (não vazia)
      → Uma única URL de produção para navegador e Cordova; não precisa mudar HTML página a página.

  (4) App nativo (Cordova / file://), se (3) estiver vazio
      → REGISTRO_PRO_API_BASE = https:// + REGISTRO_PRO_LAN_IP + REGISTRO_PRO_API_PATH

  (5) Navegador no PC, se (3) estiver vazio
      → REGISTRO_PRO_API_BASE_LOCALHOST = http://localhost + REGISTRO_PRO_API_PATH
      → Para site publicado na internet com (3) vazio, visitantes apontariam para localhost deles
        (errado). Por isso em produção use (1) ou (3).


--------------------------------------------------------------------------------
2) FORMA RECOMENDADA EM PRODUÇÃO (escolha uma)
--------------------------------------------------------------------------------

  (A) Um único valor no código: REGISTRO_PRO_DEPLOY_API_BASE em api-config.js (veja seção 3).
  (B) Sem recompilar o JS: localStorage API_BASE_URL (teste abaixo).

  O valor deve apontar para a pasta dos PHP da API, até .../api, SEM barra final.

  Exemplo:
    https://app.seudominio.com.br/ponto-saas/desktop/public/api

  Teste no console do navegador (F12):
    localStorage.setItem('API_BASE_URL', 'https://SEU_DOMINIO/.../desktop/public/api');

  Voltar ao padrão do arquivo:
    localStorage.removeItem('API_BASE_URL');


--------------------------------------------------------------------------------
3) O QUE EDITAR DIRETO NO api-config.js (build / padrão fixo)
--------------------------------------------------------------------------------

  Caminho completo:
    c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\js\api-config.js

  (0) REGISTRO_PRO_DEPLOY_API_BASE — produção: URL HTTPS (ou http) da API até .../api, sem barra final.
      Deixe '' no XAMPP; preencha ao subir o site/APK para o servidor.
  (A) REGISTRO_PRO_LAN_IP — só dev (celular na mesma Wi‑Fi do PC).
  (B) REGISTRO_PRO_API_PATH — caminho após o host até /api (principalmente XAMPP / dev).
  (C) REGISTRO_PRO_API_BASE — derivado (LAN); em produção prefira (0).
  (D) REGISTRO_PRO_API_BASE_LOCALHOST — só navegador no PC (XAMPP).
  (E) REGISTRO_PRO_ROUTES — só se renomear arquivos/pastas da API PHP.


--------------------------------------------------------------------------------
4) CHECKLIST RÁPIDO ANTES DE SUBIR PARA O SERVIDOR
--------------------------------------------------------------------------------

  [ ] API publicada a partir de:
        c:\xampp\htdocs\projetos\apps\ponto-saas\desktop\public\api\
      Ajuste no servidor até bater com REGISTRO_PRO_DEPLOY_API_BASE, API_BASE_URL ou path de dev.

  [ ] Front publicado a partir de:
        c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\
      (ou só os arquivos que você usa em produção)

  [ ] URL base da API definida: REGISTRO_PRO_DEPLOY_API_BASE no api-config.js e/ou localStorage API_BASE_URL.

  [ ] Front e API em domínios diferentes: CORS no PHP.

  [ ] Site em HTTPS para geolocalização/câmera (ou localhost).

  [ ] Login: URL final .../auth/login.php coerente com a base escolhida.


--------------------------------------------------------------------------------
5) LOGIN LEGADO (localStorage)
--------------------------------------------------------------------------------

  Se usar:
    localStorage.setItem('LOGIN_API_URL', 'https://.../auth/login.php');

  A base da API é o prefixo antes de /auth/login.php (ver regras no api-config.js).


--------------------------------------------------------------------------------
6) RESUMO
--------------------------------------------------------------------------------

  Em hospedagem: não dependa de REGISTRO_PRO_LAN_IP nem de localhost para usuários
  reais. Preencha REGISTRO_PRO_DEPLOY_API_BASE em:
    c:\xampp\htdocs\projetos\apps\ponto-saas\aplicativo\registropro\www\js\api-config.js
  e/ou defina localStorage API_BASE_URL; publique a API a partir de:
    c:\xampp\htdocs\projetos\apps\ponto-saas\desktop\public\api\

================================================================================
  Fim do guia — Registro Pro
================================================================================
