📜 REGRAS OFICIAIS — Vento Sul

Versão 1.2 · Última atualização: 2026-10-14 Novo na 1.2: modelo econômico do dono (usuário R$1/mês, comerciante R$10/mês ou R$100/ano), barra de decisão na compra com split Mercado Pago, SulCoin só como ponto de fidelidade, guildas como associações reais, estrutura jurídica (SLU + associação sem fins lucrativos). Ver histórico em §25. Este documento é a fonte canônica da verdade. Em qualquer dúvida, este texto vale. Ainda em construção: itens marcados com ⏳ ainda não estão fechados.


1. O QUE É O VENTO SUL

O Vento Sul é uma central de informação do Sul do Brasil (Paraná, Santa Catarina, Rio Grande do Sul): avisa o usuário onde estão as ofertas, as promoções, os eventos, as praias, as trilhas e as ações da comunidade perto dele.

Em palavras simples: - Usuário paga R$ 1 por mês pra receber os avisos de ofertas e usar o app. - Comerciante paga R$ 10 por mês ou R$ 100 por ano pra anunciar. - A IA + banco de dados (Supabase) cruzam o que você procura com o que os comerciantes oferecem — por exemplo: “onde está o café mais barato perto de mim?”. - Compras coletivas agendadas (fim de semana, mês ou ano) juntam muita gente pra comprar em lotes maiores e pagar menos. - Assistir aos vídeos do app dá desconto e SulCoin (recompensa fixa por tarefa). - Na hora da compra, a barra de decisão mostra pra onde vai o dinheiro: 1% obrigatório pra manter o app e o resto o usuário escolhe (§3D). - Guildas são associações reais de moradores e/ou comerciantes; o app patrocina a internet desses lugares por contrato (§23).

O que o Vento Sul NÃO É


2. SULCOIN — PONTOS DE FIDELIDADE

2.1. Natureza

SulCoin (símbolo § ou suli) é ponto de fidelidade, e só isso. - Nunca é convertido em reais nem em Pix. - Nunca pode ser sacado. - Só vale dentro do app (descontos, serviços, benefícios). - Não é dinheiro e não é cripto. Não é ativo virtual nos termos da Lei 14.478/2022, art. 3º, porque não é negociável nem transferível pra fora do app e não serve como meio de pagamento ou investimento. - Não se compra SulCoin com dinheiro. Ele só é ganho fazendo tarefas.

2.2. Como se ganha (sempre valor fixo por tarefa)

Toda recompensa é fixa e anunciada antes. Nada é aleatório: sem sorteio, rifa, roleta, raspadinha ou caixa surpresa (Lei 5.768/71).

2.3. Como se usa

2.4. Controle

2.5. O que NÃO é permitido


3. PREÇOS E COMERCIANTE — REGRAS

3.1. Quanto custa

Quem Preço O que recebe
Usuário R$ 1 / mês Avisos de ofertas, matching de preço, rádio, mapa, jogo Aurora
Comerciante R$ 10 / mês ou R$ 100 / ano Anunciar no app, aparecer no matching, promoções com IA
Prefeitura (B2G) contrato próprio (§9) Painel municipal e quests cívicas

Não existem outros planos de comerciante.

3.2. Deveres do comerciante

3.3. Cobrança IA


3A. MATCHING — ONDE ESTÁ O MAIS BARATO


3B. COMPRAS COLETIVAS AGENDADAS


3C. VÍDEOS DO APP = DESCONTO E SULCOIN


3D. BARRA DE DECISÃO NA COMPRA

Em toda compra feita pelo app aparece uma barra simples mostrando pra onde vai o dinheiro do Vento Sul nessa compra:

Parte Pra onde vai Quem decide
1% obrigatório Empresa do dono (SLU) — computação e manutenção do app fixo
O resto O usuário escolhe: anúncio da própria loja ou jogo social (trilhas, plantio de árvores, ações da comunidade) o usuário

3E. ESTRUTURA JURÍDICA

Entidade O que é O que recebe
Empresa do Erasto (SLU — Sociedade Limitada Unipessoal) dona do app as mensalidades de R$ 1, o 1% da barra de decisão e a publicidade dos comerciantes
Associação sem fins lucrativos (3 a 5 moradores e/ou comerciantes) executa as ações sociais as doações da parte “jogo social” da barra de decisão

4. AURORA RPG — REGRAS

4. AURORA RPG — REGRAS

4.1. As 7 Classes Sociais (papéis reais, SEM ARMAS)

Classe Equipamento Papel
Desbravador mapa, bússola Explorador
Guerreiro megáfone Mobilizador civil (mutirão)
Mago notebook Tecnologia (ajuda o bairro com o app)
Alquimista caldeirão Chef
Ancião (Sábio) livro, lupa Os idosos são os anciões: guardam a memória, as receitas e a história do bairro
Forjador martelo de obra Executor físico
Watcher câmera Auditor PoW (valida fotos)

4.5. Idade

4.2. Quests

4.4. Onde as classes se encontram

As 7 classes não jogam soltas: elas se encontram na guilda, que é o centro comunitário real do bairro. O ciclo completo — quem colhe, quem beneficia, quem prova e quem divide — está em §23.4.

4.3. Proibições absolutas


{#5-ia-regras-de-uso-e-privacidade} ## 5. IA — REGRAS DE USO E PRIVACIDADE

5.1. Onde a IA é usada

5.2. Privacidade (sanitização)

Antes de QUALQUER chamada a IA externa: - CPF, CNPJ, email, telefone, Pix, cartão → mascarados ([CPF], [EMAIL] etc). - Senha, token, api_key → bloqueia chamada (não envia). - UUID → mascarado parcial. - Histórico → sanitizado.

5.3. TOS dos providers (jan 2026)

5.4. Quem paga a IA


6. HUBS ESTADUAIS — REGRAS

6.1. Função

Cada estado (PR, SC, RS) tem hub que distribui SulCoin pra projetos cumprindo KPI.

6.2. Dinheiro

6.3. Quem decide ⏳

Conselho de hub a definir. Provisório: 3 representantes locais.


7. MAGOS AURORA — REGRAS

7.1. Quem pode ser

Devs convidados que mantêm o app.

7.2. Como ganham

7.3. Não tem CLT

Magos são contratados por tarefa. Sem vínculo trabalhista.


8. DOOH (Vitrine Digital) — REGRAS

8.1. Como funciona

8.2. Privacidade


9. B2G — REGRAS DE CONTRATO

9.1. Stakeholders

9.2. O que prefeitura recebe

9.3. Preços


10. TURISTA — DIREITOS E DEVERES

10.1. Direitos

10.2. Deveres


11. CONFLITOS — COMO RESOLVE

11.1. Comerciante vs turista

  1. Reportar via app ou Telegram.
  2. Auditor IA analisa em ≤24h.
  3. Decisão automática se evidência for clara (foto, ledger).
  4. Se controverso, conselho decide (provisório, depois conselho).

11.2. Suspeita de fraude


12. LGPD — DADOS PESSOAIS


13. ALTERAÇÕES NESTAS REGRAS


14. POOLS DE SULCOIN — ALOCAÇÃO POR FINALIDADE

As pools são só de pontos SulCoin. Nenhuma pool guarda reais: dinheiro de verdade é dividido pelo Mercado Pago na hora da compra (§3D).

14.0. Pools oficiais

Pool Símbolo Origem (entrada) Destino (saída)
Missões 🎯 Pontos reservados por quem cadastra missão Recompensa quests Aurora
Descontos 🛍️ Pontos oferecidos pelos comerciantes Cashback em pontos
Vídeos 🎬 Pontos da campanha de vídeo Recompensa fixa por vídeo assistido
Hub PR / SC / RS 🏛️ Pontos de convênios estaduais Iniciativas no estado
Bônus 🎁 Pontos do sistema Bônus diário, indicações

14.2. Movimentação entre pools (REGRA DE OURO)

14.4. Quem pode mover entre pools


14B. ECONOMIA DAS MISSÕES — CICLO COMPLETO

14.1. Quem cadastra missão

14.2. Reserva PRÉVIA

Toda missão com prêmio de N SulCoin exige reserva dos pontos ANTES de ir ao ar. Sem reserva = quest não fica visível. Se a missão envolve dinheiro (material, muda de árvore, lanche do mutirão), esse dinheiro é da associação e sai da conta dela.

14.3. Como o player ganha

Player aceita missão "Foto da praia ABC"
    ↓
Player executa, envia 3 fotos com geo
    ↓
Watcher PoW (vision IA) audita: ✅ APROVA
    ↓
Pontos reservados → saldo do player (50§)

Se Watcher rejeita: os pontos voltam pra pool de quem cadastrou.

14.4. Como o player guarda

14.5. Como o player usa

14.8. Auditoria pública


15. SEGURANÇA DA POOL

15.1. Cap diário

Nenhuma conta pode emitir mais que 1.000§/dia sem aprovação manual.

15.2. RPCs cunhadoras (que fazem mint)

TODAS marcadas como SECURITY DEFINER chamáveis só por service_role. Edge Functions usam, app público não chama direto.

15.3. HMAC nas forjas

Forjas (eventos especiais que emitem) usam HMAC pra validar origem. Sem HMAC = ignorado.

15.4. Lote anti-spam

Convite 10 amigos = 1 reserva, depois 1 confirmação por amigo (anti-bot).

15.5. Ledger imutável

sulcoin_ledger é append-only. Nunca update/delete em registros antigos. Correção = nova linha de estorno.


17. ECONOMIA DO COMERCIANTE — PRA QUE ELE PRECISA DE SULCOIN

Princípio: o comerciante precisa de SulCoin pra coisas que retornam vendas. Não enchemos o app de feature; cada serviço cobra resolve dor real.

17.1. Tarifas de uso (em §)

Serviço Custo Quem oferece Free tier Por que SulCoin?
Gerar promoção via IA voz 10§ llama-pool top tier 3 grátis IA top custa real
Boost (subir 1 dia no top) 50§ algoritmo de busca — escassez = prioridade
Tradução premium PT/EN/ES/DE 5§/idioma tradutor-batch grátis 1x/oferta manutenção
DOOH airtime extra (5min bonus) 30§ painel TV — espaço limitado
Foto produto IA (Pollinations) 8§ gerador imagem grátis 2x/mês curadoria
Análise de concorrência (IA) 100§ auditor + LLM — computação cara
Push pra clientes do bairro 20§ notificações segmentadas — atenção do user vale
Cupom QR exclusivo 5§ gerador QR grátis rastreável
Resposta IA reviews (auto) 15§/semana llama-pool — tempo dele = $
Relatório mensal 50§ auditor-app — computação
Foto Watcher PoW certificada ⭐ 25§ vision IA — autenticidade vale ouro

17.2. Como o comerciante CONSEGUE SulCoin

17.3. Por que isso É BOM


18. COMERCIANTE — UM PLANO SÓ


19. FERRAMENTAS MULTIPLICADORAS — SEM CUSTO EXTRA PRO USUÁRIO

O que já temos pode oferecer mais sem custo extra:

Ferramenta Hoje Como ESTENDER (futuro)
📍 GPS bússola direção pro destino + OpenStreetMap + OSRM (rota grátis, linha pelas ruas, indicação “vire na próxima”)
🌤️ Clima (open-meteo) já temos via Tool + alerta “boa hora pra praia X agora”
🌊 Maré/ondas ⏳ — API pública gratis (Stormglass tem free tier limitado)
🎤 Voz transcribir Whisper local + tradutor on-the-fly PT↔︎EN↔︎ES↔︎DE
📷 Foto upload + Watcher PoW valida autenticidade
💬 Chat Litorânea llama-pool + memória persistente (já tem)
🔍 Busca texto + busca semântica via embeddings HF
🗺️ Mapa só dot no GPS + OpenStreetMap tiles grátis + offline tiles
💰 Calculadora gorjeta/câmbio ⏳ — offline, simples
🎫 Eventos próximos ⏳ — feeds RSS de prefeituras

19.1. Bússola → Mapa interativo com rota

Próxima implementação: integrar OpenStreetMap + OSRM (Open Source Routing Machine): - 100% grátis e self-hostable - Linha pelas ruas até o destino - Voz: “vire à direita na próxima quadra” - Modo pedestre, carro, bike - Cache de tiles offline pro turista sem 4G - Não cobra nada extra — cobre OSM hospeda

19.2. Princípio “1 ferramenta = N serviços”


19.3. PRINCÍPIOS NINJA — toda ferramenta segue

Ninja = rápido + barato + sustentável + sem gambiarra (não trambique).

Pilar Como aplicamos
⚡ Rápido Cache global edge (CF Worker, KV) antes de chamar qualquer API. Hit instantâneo.
💰 Barato Free tier waterfall (5 providers IA grátis somados). Open Source > pago. Pollinations último recurso.
🌱 Sustentável Circuit breaker (95% quota → bloqueia). Monitor 4x/dia HEAD-only (~36 req/dia). Sem polling burro.
🛠️ Sem gambiarra Componentes oficiais (Supabase Edge Functions, Leaflet, OSRM, OSM tiles). Sem fork hack.
🧱 1 = N Cada ferramenta serve N casos (voz = transcrever+traduzir+ditar; câmera = foto+Watcher+OCR+QR).
🛡️ Privacidade-by-default Sanitização PII antes de qualquer IA externa. Cache anônimo (hash, sem PII).
🔁 Falha-pra-fallback Provider 1 cai → 2 → 3 → Pollinations grátis → KB local. App nunca quebra.
📦 Pre-computar quando dá Tradução em batch noturno (não em tempo real). Quests semanais (não por click).
🎯 Aprovação humana antes de aplicar IA propõe → admin aprova → vira realidade. Nada decide sozinho coisa séria.
📜 Tudo regrado Whitepaper editável (versionado). Em divergência app-vs-regra, regra prevalece.

19.4. NINJA SCORECARD por ferramenta

Ferramenta Rápido Barato Sustentável Sem gambi
Litorânea AI (chat) ⚡⚡⚡ Cerebras 1800 tok/s 5 free + cache circuit breaker OpenAI-compat oficial
Mapa rota OSRM cache 24h CF KV 100% grátis sem chave servers oficiais OSM
Whisper voz rápido local $0 (sua máquina) sem chamada externa model oficial
Watcher PoW local Ollama vision $0 sem chamada llama3.2-vision oficial
Recomendador <100ms (banco) $0 IA só SQL RPC oficial
Auto-KB noturno 1x/dia barato crontab pg_cron só lê tabela
Cache global edge <50ms mundo todo 100k req/dia free TTL 7d auto-clean CF Worker oficial

19.5. Aurora — 3 ERAS por classe (NOVO)

Cada uma das 7 classes tem 3 visuais por época histórica: - 🕯️ Passado (medieval colonial brasileiro) - 📱 Presente (atual streetwear) - 🤖 Futuro (cyber neon, sem arma)

User escolhe sua era no /aurora-classes.html. Total: 21 variantes geradas via Pollinations (grátis), persistidas em aurora_classes_eras.

19.5.1. Avatar com rosto do user (roadmap ⏳)

Próxima feature: - User tira selfie - InsightFace detecta rosto + landmarks - InstantID + Stable Diffusion (rodando local na MX570 ou Hugging Face Space) gera variante com rosto preservado - 100% open source, gratuito - Rosto fica só local (LGPD) - 1 selfie = 21 avatares possíveis (cada classe × era)


21. COMERCIANTE COMO ASSISTENTE DE NEGÓCIOS

Comerciante não é só “loja cadastrada”. Vento Sul vira co-piloto de gestão.

21.1. O que o comerciante tem (R$ 10/mês ou R$ 100/ano)

21.2. Tipos de arquivo aceitos

21.3. IA Assistente do negócio

Endpoint: POST /functions/v1/comerciante-assistente { dono_uuid, pergunta }

Carrega no contexto: - Perfil do negócio (especialidade, bio) - Estoque ativo + alertas mínimos - Plano de vendas + realizado - Ofertas ativas - Últimas 7 dias de vendas

Tipos de pergunta que ela responde com dados reais: - “Como tá minha venda essa semana?” - “Que produto promover hoje?” - “Falta o quê pra bater minha meta mensal?” - “Compara meu pastel com a concorrência” - “Gera post pra instagram do meu suco novo” - “Qual produto tá pra vencer estoque?”

21.4. Plano de vendas

21.5. Integração com SulCoin

21.6. Princípio: comerciante FIDELIZA, não anuncia

Vento Sul não é Google Ads. É rede rede de impacto. O comerciante: - Constrói fila de clientes que voltam (cashback SulCoin) - Tem dados próprios em painel (não é refém de plataforma) - Pode exportar tudo (CSV/JSON) a qualquer momento - Conversa direto com clientes via app (sem intermediário cobrando 30%)


21.7. Importar cardápio (NOVO)

Endpoint: POST /functions/v1/cardapio-importar { dono_uuid, texto_bruto, fonte }

Tela: /comerciante-cardapio.html

Fluxo: 1. Comerciante: cola texto, fala via mic, ou sobe foto/PDF/CSV 2. IA fraca (Gemma free OpenRouter) extrai produtos estruturados (~15-30s, custa zero) 3. Insere automático em comerciante_estoque com nome/preço/categoria 4. Comerciante revisa e ajusta quantidade

Por que IA fraca? Extração estruturada não precisa modelo top. Gemma 26B free do OpenRouter resolve com 80% acerto. Demora um pouco mais mas zero custo.

21.8. Reorganização UI (TODO ⏳)


22. ITENS AINDA EM CONSTRUÇÃO ⏳


23. GUILDA = CENTRO COMUNITÁRIO DO BAIRRO

23.0. A guilda não é metáfora

No Aurora, “guilda” não é um clã de jogo. Guilda é uma associação real de moradores e/ou comerciantes do bairro — a associação de moradores, a associação comercial, o conselho comunitário ou o galpão que a comunidade já tem, com CNPJ, assembleia e chave na porta.

Consequência prática: não existe guilda sem lugar físico e sem gente. Não se cria guilda no app. Se cadastra a que já existe.

23.1. O que a guilda faz

Função O que é na vida real
Produz cozinha comunitária: defumado, conserva, doce, panificação
Beneficia transforma o que se perde (safra, excedente de pesca) em produto de prateleira longa
Distribui vende junto, compra insumo junto, divide transporte
Divide reparte o resultado entre os associados que entraram na fornada
Organiza é onde as classes se encontram e o mutirão sai do papel

23.2. A guilda no Mapa Vivo

23.3. ORIGEM DAS MISSÕES (regra nova e obrigatória)

Missão de guilda NÃO é inventada por IA. Ela nasce de reclamação de gente real, capturada em dois canais:

  1. Rádio — recado, pedido ou queixa que entra no ar.
  2. Chat do bairro — mensagem no canal da comunidade.
Reclamação (rádio ou chat)
    ↓  alguém da guilda promove a reclamação a pauta
Pauta na assembleia / no grupo
    ↓  define escopo, quem faz, e os pontos necessários
Missão cadastrada (com reserva PRÉVIA — §14B.2 vale igual)
    ↓
Classes executam → Watcher prova → SulCoin aloca
    ↓
Resultado vira registro no razão aberto + pauta de volta na rádio

Rastreabilidade: toda missão de guilda carrega o origem_id da reclamação que a gerou. Missão sem origem rastreável não é missão de guilda — pode ser quest normal (§4.2), mas não usa o selo da guilda.

23.4. O ciclo das classes fechando na guilda

Passo Classe O que faz
1 🧭 Desbravador acha e mapeia onde tem matéria-prima se perdendo
2 🌳 Anão Forjador colhe a nativa / recolhe o excedente
3 ⚗️ Alquimista beneficia na cozinha comunitária — é onde o valor multiplica
4 🔨 Forjador executa o físico: bancada, reparo, estrutura
5 🛡️ Guerreiro mobiliza o mutirão, chama a rua
6 📖 Ancião (Sábio) registra o processo, a receita, a origem
7 👁️ Watcher audita e assina a prova (foto + geo)
8 🏛️ Guilda vende junto e divide entre os associados

Sem o passo 7, o passo 8 não acontece. Prova antes de valor, sempre.

23.5. Quem pode cadastrar missão de guilda

Adendo ao §14B.1 — a lista de quem cadastra missão passa a incluir:

Mesmas obrigações de todo mundo: reserva prévia de pontos (§14B.2), critério objetivo de validação (§4.2) e auditoria do Watcher.

23.6. COMO O DINHEIRO CHEGA NA ASSOCIAÇÃO

Compra no app
    ↓  (Mercado Pago divide na hora)
├── 1% → empresa do dono (computação e manutenção)
└── resto → escolha do usuário:
      ├── anúncio da própria loja
      └── jogo social → conta da associação → ações no bairro

23.7. Governança — o que a associação controla

Quem Controla
Vento Sul (SLU) opera a tecnologia (app, rádio, mapa, sistema)
Associação governa, gasta e presta contas da verba da comunidade

23.8. Proibições da guilda

23.9. Internet das guildas


24. CONTATO


Este documento está vivo. Cada nova feature traz nova seção. Em caso de divergência entre comportamento do app e regra escrita aqui, regra escrita prevalece até atualização.


25. HISTÓRICO DE VERSÕES