🌊 Vento-Sul.tech × 🏛️ empresadobem.online ⚙️ MaKiNaDoBeM

📖 Manual do Sistema

O guia completo da plataforma de impacto que está construindo a MaKiNaDoBeM — a rede de impacto digital do Sul do Brasil.

🌊 O que é o Vento-Sul.tech

Vento-Sul.tech é a plataforma digital criada pela empresadobem.online — uma startup de impacto socioeconômico focada no Sul do Brasil.

A plataforma conecta turistas, comerciantes de bairro, divulgadores e gestores públicos numa rede que retorna 95-99% de toda a receita pra quem usa.

MaKiNaDoBeM é o nome da rede federal que emerge quando a plataforma escala. Começa em Floripa (piloto), expande pro Sul, depois pro Brasil. Cada cidade vira um hub autônomo mantendo o mesmo protocolo de impacto.

🏛️ empresadobem.online — a estrutura por trás

⚖️
Startup Mista
Marco Legal Startups + Sociedade de Benefício. Não é startup de impacto pura, não é empresa extrativa. Startup com missão de impacto.
💰
95% / 99% de volta
Fase 2: 95% de toda a receita volta pro usuário em descontos, promoções, eventos, vantagens. Fase 3: 99%.
🗺️
Hubs regionais
Cada hub serve até 5.000 pessoas com VPS dedicada. A partir de 500 pagantes o hub se paga. O excedente vira promoção.
🤖
IA de fundo gratuita
Toda IA usada pelos usuários é gratuita. LLMs open-source em servidores próprios. Nenhum R$ de IA sai do bolso de quem usa.

🎯 4 Perguntas que toda decisão passa

1. Isso alavanca o usuário ou extrai dele?

2. Aproxima a galera (lúdico/Aurora/bairro) ou empurra contra (paywall, dark pattern)?

3. É possível com R$ 0 marginal usando os anões existentes?

4. Fortalece bairro sustentável ou é só vitrine?

Se a resposta a qualquer uma for "não" ou "duvidoso", reformulamos ou descartamos. Sem exceção.

🔗 Links principais

🌊
App principal. Home do hub Floripa.
🏛️
Manifesto e apresentação da startup de impacto.
📜
O porquê de tudo. Leitura recomendada.
📊
Fase atual, receita, quanto voltou pros usuários.
⚖️
Termos de uso, direitos e deveres.
🔒
LGPD, dados coletados, seus direitos.

👥 5 papéis — você pode ser vários ao mesmo tempo

🏖️
Turista
Visita o Sul, descobre comércio local, praias, festas.
  • Barracas e ofertas pelo GPS
  • Compra com Pix ou SulCoin
  • Conversa com Litorânea (IA)
  • Ouve a Rádio regional
🏪
Comerciante
Padaria, pousada, salão, restaurante, barraca de praia.
  • Cadastra negócio em 5min
  • Promoção por voz
  • Aceita reservas
  • Pix direto, sem intermediário
📣
Divulgador
Chama amigos e ganha SulCoin por cada novo participante.
  • Link de afiliado próprio
  • 5 tiers de badge
  • Pool Embaixador
  • Stats em tempo real
🪄
Mago Aurora
Dev-jogador que mantém Vitrines e ganha SulCoin + DOOH.
  • 50% da renda DOOH
  • Painel Magos
  • Acesso admin parcial
🏛️
Gestor Público
Prefeitura, SEBRAE, CADIPACTO, parceiro B2G.
  • Painel Municipal
  • Quests cívicas
  • Convênios R$5–30k

🏖️ Turista — o que você pode fazer

📍
Perto de mim
Barracas, ofertas e trilhas no raio do GPS.
🌊
Fala com Litorânea
IA que conhece o Sul — recomenda comida, praia, passeio, festa.
Bolha azul na home
🪙
Carteira SulCoin
Saldo, transferência, pagamento por QR.
📡
Rádio Vento Sul
6 estações, locutores IA com personalidade (Faber, Cosmos, Renzo, Kraken, Edresson), notícias regionais + dashboard financeiro.
Aurora RPG
Quests cívicas reais (limpar riacho, fotografar) que dão SulCoin.
📸
Photobooth
Foto sua na vibe Sul com filtro Aurora.
🎟️
Reservar
Pousada, restaurante, passeio — confirmação automática no Telegram.
🧩
Quiz
Mini-games sobre o Sul. Acerta = SulCoin.

🏪 Comerciante — ferramentas profissionais

novo
🎩
Butler (onboarding IA)
6 etapas adaptadas por tipo (pousada, restaurante, padaria…). IA te guia. Progresso salvo em butler_progresso.
📋
Comerciante PRO
Painel principal: pedidos, métricas, estoque, chat IA proativo. Abas: Pedidos · Métricas · Estoque · Chat · Perfil.
novo
👤
Perfil do negócio
Aba Perfil no PRO: nome fantasia, tipo, bio, endereço, horário, WhatsApp, PIX, e-mail. Link público da loja.
novo
💳
Planos & Trial
6 planos (Free → Enterprise). Botão "Experimentar grátis" libera 14 dias de trial. Sem cartão de crédito.
🏷️
Promoção por voz
"Manga 5 reais o quilo até quinta" → IA gera card pronto.
📅
Reservas
Disponibilidade, confirmação, aviso Telegram em <60s.
novo
📷
Scanner de produto (Butler Vision)
Foto de produto no estoque → IA reconhece nome/categoria automaticamente. Custo R$ 0 (Llama Vision grátis).
novo
🔍
Importar cardápio por OCR
Foto do cardápio → OCR local via Tesseract.js → IA extrai produtos. Zero servidor, zero custo.
📺
DOOH — TV Vitrine
TV na loja exibe propaganda personalizada por quem passa. Opt-in obrigatório.
Plano VIP
novo
📲
WhatsApp & PIX na loja
Página da loja mostra botão WhatsApp direto + copiar chave PIX. Cliente fala e paga sem intermediário.

📣 Divulgador — ganhe chamando amigos

🔗
Link de afiliado
Cada novo user que entrar pelo seu link te dá SulCoin.
🏅
5 tiers de badge
Grilo → Gaivota → Baleia → Tubarão → Arraia Elétrica.
Ver em /divulgar
🌟
Desbravador Vitalício
5.000 primeiros do hub: badge permanente + vantagens exclusivas.

📻 Rádio Vento Sul — arquitetura e uso

Streaming ao vivo 24/7. Liquidsoap alimenta o Icecast no servidor. Caddy proxia o stream. Qualquer celular ouve via browser, sem app.

6 Estações e seus personagens

🌅
Vida Boa · Faber
Bem-estar, natureza, mar, vento, lifestyle do Sul. Tom calmo e inspirador. Locutor: Faber.
🎭
Cultura · Cosmos
Culinária açoriana, artesanato, festas populares, identidade da ilha. Bilíngue PT/EN. Locutor: Cosmos.
🏪
Comércio · Renzo
Promoções, ofertas, novidades e spots dos comerciantes parceiros. Locutor: Renzo.
📈
Economia · Kraken
Dashboard financeiro ao vivo: USD, EUR, BTC, ETH via AwesomeAPI. Análises, tendências, SulCoin. Locutor: Kraken.
🏝️
Ilha Hoje · Edresson
Notícias do dia, eventos, agenda cultural e turística de Floripa. Locutor: Edresson.
🚨
Plantão · Edresson
Segurança pública, ocorrências, trânsito. Tom informativo e sério. Locutor: Edresson.

Spots de Rádio novo

Comerciantes com plano Pro ou Premium podem criar spots de rádio direto pelo painel. O pipeline na VPS gera o áudio via Piper TTS e insere automaticamente na fila da estação Comércio. Tabela: radio_spots.

Comerciante cria spot (texto/título) → radio_spots INSERT → pipeline Feiosão detecta spot pendente → Piper TTS gera MP3 → enfileirado no Liquidsoap (estação Comércio) → ouvido na próxima rotação

Dashboard Financeiro (Rádio Economia)

A estação Economia exibe em tempo real: USD/BRL · EUR/BRL · BTC/BRL · ETH/BRL via AwesomeAPI (grátis). Kraken comenta variações de mercado e conecta ao SulCoin.

Como ouvir

📣 FAB megafone na home → 1º clique: toca o stream ao vivo direto na página → 2º clique: vai pra /radio.html (player completo) 📱 /radio.html → Escolhe a estação → Toca segmento gravado da hora (se existir) → Ou cai no stream ao vivo Icecast como fallback 🔗 Stream direto: https://webui.vento-sul.tech/stream

Arquitetura técnica

Piper TTS (PT + EN) → MP3 → /opt/ventosul/radio-queue/ Liquidsoap (playlist loop) → Icecast :8000/radio Caddy proxy → /stream → browser Headers: Accept-Ranges: none · X-Content-Duration: 0

Tabelas de suporte à Rádio novo

radio_estacao_config → configurações por estação (slug, ativa, persona, idioma, limites) radio_acontecimentos → eventos/notícias capturados pra serem narrados radio_spots → spots de comerciantes (Pro/Premium): texto, status, mp3_url kb_radio → banco de conhecimento: notícias, feeds regionais + alertas Floripa

Auto-post Bluesky novo

Cada notícia gerada pelo pipeline da rádio é postada automaticamente em @ventosultech.bsky.social. O anão Noturno (GitHub Actions) executa o script de publicação.

Admin da rádio

Gerar novo conteúdo: SSH na VPS → Piper TTS → MP3 na queue → Liquidsoap pega em 60s.

Painel de rádio: /radio-admin.html (gate admin)

🔧 Arquitetura do sistema

FRONTEND vento-sul.tech → Cloudflare Pages (deploy automático do GitHub 4ut0m474) webui.vento-sul.tech → Hetzner VPS CPX42 (157.180.76.21) via Caddy BACKEND Supabase (PostgreSQL + Auth + Edge Functions + Storage) ~210 tabelas · ~607 RPCs · 40 Edge Functions IA / LLMs (gratuitos, zero custo pro user) Ollama (qwen2.5) local na VPS → /ollama/* Cerebras / SambaNova / Groq / OpenRouter → fallback Piper TTS → voz PT-BR (faber) + EN (amy) Icecast + Liquidsoap → rádio streaming STORAGE Cloudflare R2 → hot/CDN (só arquivos quentes) Google Drive → backup cifrado diário (95M+) Supabase Storage → mídia do app MONITORAMENTO Backup 04h: Drive multi + R2 + IA semanal Auto-deploy */15min: SHA diff → wrangler pages Anões: 17+ scripts cron no Feiosão

🧟 Os Anões — automações 24/7

🛡️
Sentinela
Vigia de segurança. Detecta invasão, verifica integridade.
💰
Tesoureiro
Controla SulCoin: emissão, reservas, auditoria HMAC.
🔒
Cofreiro
Backup cifrado 7z AES-256, múltiplos destinos.
🌊
Curador da Rádio
Gera playlist horária, enfileira segmentos, controla rotação.
🚀
Auto-Deploy
SHA diff a cada 15min → deploy CF Pages se mudou.
📚
Arquivista
Internet Archive backup diário (eternidade garantida).

📄 Todas as páginas

🏠
/ Home
Central do hub. Carrossel, IAs, FAB rádio, notificações.
🗺️
OpenStreetMap com 764+ lugares, rotas, Waze/Google.
🪙
Carteira SulCoin, histórico, transferência, QR pagamento.
RPG cívico: quests reais, avatares, mapa do Sul.
📻
6 estações ao vivo: Vida Boa, Cultura, Comércio, Economia, Ilha Hoje, Plantão. TTS bilíngue PT/EN.
🏪
Painel PRO: pedidos, métricas, IA, estoque.
📣
Painel do divulgador, link afiliado, badges.
🎩
Onboarding inteligente para novos comerciantes.
📊
Fase atual, receita, distribuição de incentivo.
📜
O porquê do Vento Sul. Leitura recomendada.
📖
Esta página. Manual completo do sistema.
💳
Planos e trial 14 dias grátis para comerciantes.

📚 Dicionário do sistema

🌊 Vento Sul
Plataforma digital de impacto criada pela empresadobem.online. Une turistas, comerciantes, divulgadores e gestores públicos do Sul do Brasil numa rede de impacto digital.
⚙️ MaKiNaDoBeM
A rede federal que emerge quando o Vento Sul escala. Cada cidade vira um hub autônomo (a "Máquina") que gera bem para a comunidade local. Começa em Floripa, expande pro Sul, depois pro Brasil.
empresadobem.online está construindo a MaKiNaDoBeM usando Vento-Sul.tech como plataforma.
🪙 SulCoin · Suli · §
Token comunitário do sistema. 1 real = 100 sulis. Não é cripto — é um cupom de fidelidade regulado, sem volatilidade, sem Cayman. Pode ser transferido entre users e convertido em Pix (taxa 5%).
§500 = R$5,00. Ganho em quests, compras, divulgação.
🌅 Fase 1 — Semente
Hub novo, até 5.000 participantes. Fundador é voluntário (0% de remuneração). A partir de 500 pagantes, tudo que entrar acima do custo vira promoção pra comunidade do hub.
🚀 Fase 2 — Crescimento
Hub maduro em escala. 5% pro fundador (paga o desenvolvimento contínuo). ~95% de toda a receita volta pros usuários em descontos, promoções, eventos e vantagens.
🌳 Fase 3 — Consolidação
Rede grande, autossustentável. 1% pro fundador. 99% de toda a receita de comércio, usuários e rede social volta pra benefício da comunidade do app.
🌊 Litorânea
IA guia do Sul. Conhece praias, comida, festas, transporte. Fala com o usuário via chat ou voz na home. Personalidade descontraída, fala de turista/residente.
🤖 Automata
IA de matemática, finanças e automações do app. Explica contas, calcula quotas, interpreta transparência de receita. Antiga "Quotamestre".
✨ Aurora
Sistema de RPG cívico. Problemas reais do bairro viram "missões/quests". Usuários resolvem e ganham SulCoin + títulos. 7 classes, avatares, mapa do Sul.
Quest: "Fotografe o buraco na Rua X antes e depois do conserto" → 200 sulis.
📣 FAB Megafone
Botão flutuante fixo no canto da tela. 1º clique toca o stream da rádio ao vivo. 2º clique navega pro player completo /radio.html.
📺 DOOH
Digital Out of Home. TV na vitrine do comerciante exibe propaganda personalizada por categoria pra quem passa. Ativada sob demanda (opt-in), nunca 24/7 passivo.
🪄 Mago Aurora
Dev-jogador que faz manutenção nas Vitrines DOOH em troca de 50% da renda + SulCoin. Substitui o CLT por sistema de missões remuneradas.
⚔️ Desbravador
Os 5.000 primeiros participantes do hub. Ganham badge vitalício de Desbravador e vantagens permanentes. Irreversível — quem chegou, chegou.
🧟 Anão
Script de automação que roda 24/7 no servidor (VPS Hetzner). Cada anão tem uma função: Sentinela (segurança), Cofreiro (backup), Curador (rádio), etc. São os "funcionários invisíveis" do sistema.
🤖 Feiosão
Nome carinhoso do servidor VPS Hetzner CPX42 em Helsinki (157.180.76.21). É o cérebro operacional 24/7 — roda os anões, o assistente de código, o Icecast, o Ollama.
🏛️ Hub
Instância regional do sistema. Cada cidade/região tem seu hub com VPS dedicada e pode personalizar regras dentro do framework. Começa em Floripa (hub piloto).
🌊 Cebola Regional
Filosofia de expansão: bairro → cidade → Sul → Brasil. Cresce de dentro pra fora. Cada camada sustenta a próxima antes de expandir.
📻 Icecast
Servidor de streaming de rádio. Recebe o áudio do Liquidsoap e transmite pra todos os ouvintes simultaneamente. Mount: /radio. Porta: 8000.
📻 Liquidsoap
Software que alimenta o Icecast com áudio. Lê os MP3 da fila (/opt/ventosul/radio-queue/), faz loop, aplica crossfade e reconecta automaticamente se cair.
📻 Piper TTS
Motor de síntese de voz (Text-to-Speech) gratuito e offline. Gera os MP3 das locuções da rádio. Vozes: pt_BR-faber-medium (PT) e en_US-amy-medium (EN).
🛡️ Gate Admin
Proteção que verifica role no Supabase antes de carregar página. Se não tiver JWT → /login. Se JWT mas sem role admin → bloqueio. Roda síncrono antes do HTML renderizar.
🏛️ Marco Legal Startups
Lei 182/2021. Permite estrutura jurídica que combina missão de impacto (Sociedade de Benefício) com agilidade de startup. É a base legal da empresadobem.online.
🌊 Startup Mista
Modelo jurídico adotado: Marco Legal Startups + Sociedade de Benefício. Não é startup de impacto pura (Marco Legal Startups (LC 182/2021)) nem empresa extrativa. Permite o modelo 95%/99% de retorno com estrutura empresarial.
🔍 OCR Tesseract.js
Biblioteca de leitura ótica de caracteres (OCR) que roda 100% no browser do usuário, sem servidor. Usada na importação de cardápio por foto. Suporta português + inglês. Custo R$ 0.
Foto do cardápio → Tesseract extrai texto → IA separa produtos e preços → inseridos no estoque automaticamente.
👁️ Butler Vision
IA de visão computacional integrada ao painel do comerciante. Analisa foto de produto (câmera ou galeria) e sugere nome, categoria e descrição automaticamente. Usa Llama 3.2 Vision via Cloudflare Workers AI — custo R$ 0.
Comerciante tira foto de uma caixa de macarrão → Butler Vision preenche "Macarrão espaguete 500g" na categoria "Mercearia".
💳 Plano trial
14 dias de qualquer plano comercial sem cartão de crédito. Ativado pelo botão "Experimentar grátis" na página /comerciante-planos. Registrado na tabela comerciante_plano_ativo com campo trial_ate.
📊 butler_progresso
Tabela Supabase que salva o progresso do onboarding de cada comerciante. Guarda: tipo de negócio detectado pelo Butler, próxima etapa, total de conversas, última interação.
📻 Spot de rádio
Anúncio de até 30–60 segundos criado por comerciante (plano Pro ou Premium) e gerado automaticamente pelo pipeline da VPS via Piper TTS. Vai direto pra fila da estação Comércio. Registrado em radio_spots.
Padaria cria spot "Pão quentinho saindo agora, às 7h, Rua X" → pipeline gera MP3 → Renzo lê no ar.
📻 Personagens da rádio
Cada estação tem um locutor com voz e persona própria: Faber (Vida Boa), Cosmos (Cultura), Renzo (Comércio), Kraken (Economia), Edresson (Ilha Hoje + Plantão). Vozes geradas por Piper TTS.
📈 Dashboard financeiro (Rádio Economia)
Painel ao vivo com cotações de USD, EUR, BTC e ETH em reais. Alimentado pela AwesomeAPI (gratuita). Kraken comenta as variações e conecta ao cenário do SulCoin.
🦋 Bluesky auto-post
Cada notícia gerada pelo pipeline da rádio é publicada automaticamente em @ventosultech.bsky.social. Executado pelo anão Noturno via GitHub Actions.

📈 As 3 Fases — o dinheiro sempre volta pra galera

🌱 FASE 1 — Semente · 0% pro fundador

Hub novo, até 5.000 participantes. A partir de 500 pagantes o custo computacional já está coberto. Tudo o que entrar acima vira promoção pros clientes do hub. Fundador é voluntário.

🚀 FASE 2 — Crescimento · 5% pro fundador

Hub maduro em escala. Os 5% pagam o desenvolvimento contínuo do app. ~95% volta pros usuários em descontos, promoções, eventos e vantagens — e cada participante pode medir e escolher como distribui seu incentivo.

🌳 FASE 3 — Consolidação · 1% pro fundador

Rede grande, autossustentável. 1% cobre os custos pessoais do fundador. 99% de toda a receita de comércio, usuários e rede social volta pra benefício da comunidade do app. 1% de muita gente é mais que suficiente.

🧮 Fórmula aberta

preço = custo real do hub ÷ pagantes ativos custo coberto a partir de 500 pagantes o que entrar acima → PROMOÇÃO pros clientes fundador recebe: 0% (Fase 1) | 5% (Fase 2) | 1% (Fase 3) todo o restante → participantes da rede

Confira o cálculo em tempo real: /transparencia — custo do hub, pagantes, fase atual, quanto voltou.

💡 Por que isso funciona

⚖️
Marco Legal Startups
Estrutura jurídica que garante o modelo sem comprometer princípios de impacto e solidariedade.
🔄
Inversão do varejo extrativo
iFood/Rappi cobram 23-30% e levam pra fora. Aqui cobra-se centavos e o lucro fica entre quem usa.
📌
Taxa fixa, não percentual
Comerciante sabe quanto vai pagar. Não vira refém de algoritmo de marketplace.
🪙
SulCoin lastreado
Não é cripto especulativa. Cada token tem registro HMAC, reservas confirmadas, auditoria pública.
🗺️
Hubs regionais autônomos
Cada estado/cidade personaliza regras dentro do framework. Federação desde o dia 1.
🤖
IA gratuita pra sempre
LLMs open-source no servidor próprio. Nenhum R$ de IA sai do bolso do usuário.
"Cobra pouco. Devolve muito.
95% volta pro usuário na Fase 2, 99% na Fase 3.
1% do Sul inteiro paga melhor que 30% de uns poucos."