🛵 Publish Go

Plataforma whitelabel de gestão de delivery e logística inteligente — para estabelecimentos e motoboys. Pedidos, despacho, mapa operacional em tempo real, roteirização e financeiro num só lugar.

Online agora: https://publishdev.com.br/publishgo/

Publish Go (Central / Super-Admin)  →  cadastra e gerencia as EMPRESAS
        └── Empresa (Estabelecimento) →  cadastra seus MOTOBOYS, despacha pedidos
                  └── Motoboy          →  app próprio: aceita corridas e entrega

O login em /publishgo/ direciona automaticamente para a Central ou o painel do estabelecimento conforme o papel. Motoboys novos se cadastram em app/courier-register.html?empresa=<slug> (link gerado na tela Motoboys).

Backend (PHP 8.3, MVC, API REST)

• Arquitetura MVC própria (sem framework pesado), PSR-4 via Composer.
• Autenticação JWT (HS256, access + refresh) sem dependências externas.
• Multi-tenant (whitelabel) por company_id em todas as queries.
• Middlewares: CORS, rate limiting, autenticação, CSRF (para fluxos de sessão).
• Validação + sanitização server-side; PDO com prepared statements (anti SQL-Injection).
• Respostas JSON padronizadas { ok, data, error }.

Tempo real

• Servidor WebSocket em PHP puro (Workerman), canais por empresa.
• A API publica eventos (order.created, order.status, courier.location, delivery.dispatched).
• Fallback automático de polling quando o WebSocket não está disponível (ex.: HTTPS sem proxy wss).

Painel do Estabelecimento (frontend)

• TailwindCSS + AlpineJS, dark mode, design premium (glassmorphism, skeletons, animações).
• Dashboard com KPIs, gráfico ao vivo (Chart.js) e operação em tempo real.
• Pedidos: criar/editar/cancelar, fila com prioridade, múltiplos itens, busca e filtros.
• Entregas/Mapa: Leaflet + tiles de satélite, motoboys ao vivo, clustering, rota, distância (Haversine) e ETA, despacho manual e automático (motoboy mais próximo), roteirização multi-ponto.
• PWA instalável: manifest.json + Service Worker (cache offline, push, background sync).

Banco de dados (MySQL)

• Schema normalizado com FKs e índices: companies, users, couriers, orders, order_items, deliveries, transactions, audit_logs.
• Migrations versionadas + seed com dados de demonstração realistas.

cd /www/wwwroot/publishdev.com.br/publishgo

# 1) Dependências
composer install

# 2) Configuração
cp .env.example .env        # ajuste DB, JWT_SECRET, WS_*, APP_BASE

# 3) Banco (cria as tabelas no schema 'publishgo')
php bin/migrate.php

# 4) Dados de demonstração (opcional)
php database/seed.php

# 5) Ícones do PWA (já gerados; regenere se trocar a marca)
php bin/make-icons.php

O app é servido em subpasta sob o docroot compartilhado /www/wwwroot/publishdev.com.br. O arquivo .htaccess na raiz de publishgo/:

• mapeia /publishgo/... para o webroot real (public/);
• roteia a API para o front controller;
• executa o PHP no PHP-FPM 8.3 apenas neste diretório (sem afetar os demais apps do domínio, que usam 7.4);
• protege .env, src/, vendor/.

Acesse: https://publishdev.com.br/publishgo/

php bin/ws-server.php start -d     # daemon
php bin/ws-server.php status
php bin/ws-server.php stop

Em produção, use o systemd incluído:

cp deploy/publishgo-ws.service /etc/systemd/system/
systemctl enable --now publishgo-ws

HTTPS + WebSocket: navegadores em páginas https:// exigem wss://. A porta 8181 é ws:// puro, então sobre HTTPS o painel usa automaticamente o polling (atualiza a cada 5s). Para tempo real via WebSocket sobre HTTPS, exponha a porta 8181 atrás de um proxy wss (Apache/Nginx) e ajuste WS_PUBLIC_URL.

Move os motoboys online e publica posições no WebSocket — o mapa "ganha vida":

php bin/simulate.php           # loop contínuo (~2s)
php bin/simulate.php once      # uma iteração

php -S 0.0.0.0:8080 -t public public/router.php
# Painel: http://localhost:8080/  •  API: http://localhost:8080/api/health

docker compose up --build
# Painel: http://localhost:8080  •  WS: ws://localhost:8181

Base: /publishgo/api · Autenticação: Authorization: Bearer <access_token>

Exemplo:

TOKEN=$(curl -s https://publishdev.com.br/publishgo/api/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"demo@publishgo.com.br","password":"publishgo"}' | jq -r .data.access_token)

curl https://publishdev.com.br/publishgo/api/dashboard/summary -H "Authorization: Bearer $TOKEN"

publishgo/
├── public/            # webroot (front controller + painel + PWA)
│   ├── index.php      # bootstrap da API
│   ├── app/           # login, dashboard, orders, deliveries
│   ├── assets/        # css, js (app/realtime/map), icons
│   ├── manifest.json  sw.js  offline.html
├── src/
│   ├── Core/          # App, Router, Request, Response, Database, Jwt, Validator, Migration, Env
│   ├── Middleware/    # Auth, RateLimit, Cors, Csrf
│   ├── Models/        # Company, User, Courier, Order, Delivery, ...
│   ├── Controllers/   # Auth, Dashboard, Order, Courier, Delivery, Company
│   └── Services/      # Dispatch, Geo, Realtime
├── routes/api.php
├── database/migrations/  database/seed.php
├── bin/               # migrate, ws-server, simulate, make-icons
├── deploy/            # systemd units
└── docker-compose.yml docker/nginx.conf

App do motoboy (cadastro/selfie, aceitar corrida, GPS contínuo, ganhos, saque, ranking, chat, assinatura) · Painel admin global · Financeiro completo (extrato, repasses, export PDF/Excel) · Integração iFood/WhatsApp · Push real (VAPID) · Impressão térmica / QRCode · Mapa de calor e relatórios avançados.

A base desta fase já deixa modelos, tabelas e hooks prontos para esses módulos.

Projetado e desenvolvido 100% por Alex Junior (alequizao) — da ideia ao deploy: levantamento, modelagem do banco, backend, interface e publicação em produção. Analista e Desenvolvedor de Sistemas em Maceió, Alagoas, Brasil. Programador na Publish Digital.

• E-mail: alequizao.dev@gmail.com
• WhatsApp: (82) 98871-7072
• Instagram: @alequizao
• GitHub: @alequizao · perfil completo
• Site: alequizao.com

© Código proprietário, desenvolvido sob encomenda.