📜 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
É
- ❌ Não é banco, exchange, corretora nem instituição de pagamento. O
dinheiro das compras é dividido pelo Mercado Pago na
hora; a empresa não guarda dinheiro de terceiros.
- ❌ SulCoin não é dinheiro, não é cripto e não é
investimento (§2).
- ❌ Não é provedor de internet (§23.9).
- ❌ Não faz sorteio, rifa, roleta nem “caixa surpresa” (Lei
5.768/71).
- ❌ Não revende dados pessoais.
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)
- ✅ Assistir vídeos do app (§3C)
- ✅ Compras em comerciantes parceiros (cashback em pontos)
- ✅ Quests Aurora completadas (validadas pelo Watcher PoW)
- ✅ Indicação de novos usuários (após confirmação)
- ✅ Bônus diário
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
- ✅ Desconto em comerciantes parceiros
- ✅ Serviços do comerciante dentro do app (§17.1)
- ✅ Benefícios e eventos da comunidade
2.4. Controle
- Toda emissão é registrada no
sulcoin_ledger
(anti-fraude), com origem rastreável.
- Forjas usam HMAC + cap diário (§15).
2.5. O que NÃO é permitido
- ❌ Trocar SulCoin por dinheiro, dentro ou fora do app.
- ❌ Auto-emissão (>10 emissões/dia = alerta automático).
- ❌ Múltiplas contas pra ganhar bônus (sistema detecta).
- ❌ Revender saldo.
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
- Manter dados verdadeiros (preço, foto, descrição).
- Honrar promoção publicada até validade.
- Aceitar SulCoin como cashback (% configurável pelo dono).
- Não publicar conteúdo ilegal/ofensivo.
- Foto deve ser real (Watcher PoW pode auditar).
3.3. Cobrança IA
- 3 gerações de promoção com IA incluídas.
- A partir da 4ª: 10§ por geração (pontos, não
reais).
- IA top tier (SambaNova) reservada pra promoções com valor monetário
detectado.
3A. MATCHING — ONDE ESTÁ O
MAIS BARATO
- A IA entende o pedido do usuário (texto ou voz): “café mais
barato perto de mim”.
- O Supabase cruza com os produtos e preços que os comerciantes
cadastraram, a distância e as promoções ativas.
- O app mostra as melhores opções, ordenadas por preço e
distância.
- Sem pagamento por posição: o resultado do matching
segue preço e distância, não quem pagou mais. Anúncio aparece marcado
como anúncio.
3B. COMPRAS COLETIVAS
AGENDADAS
- A compra coletiva é agendada: pra o fim de
semana, pro mês ou pro
ano.
- Quanto mais gente entra, maior o lote e
menor o preço combinado com o comerciante ou
fornecedor.
- Cada compra tem data de fechamento, quantidade mínima e preço por
faixa, tudo mostrado antes.
- Se não bater o mínimo, ninguém é cobrado.
- O pagamento também passa pela barra de decisão e pelo split do
Mercado Pago (§3D).
3C. VÍDEOS DO APP =
DESCONTO E SULCOIN
- Assistir aos vídeos do app (sobre ofertas, comerciantes, ações da
comunidade) dá desconto e SulCoin.
- A recompensa é fixa por tarefa e aparece antes de
começar (ex.: “assistir este vídeo = X§”).
- Nunca é aleatória. Proibido sorteio, rifa, roleta,
raspadinha ou caixa surpresa (Lei 5.768/71).
- Limite diário por usuário (anti-fraude).
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 |
- Split na hora: o Mercado Pago divide o
pagamento no momento da compra. Cada parte cai direto na conta
de quem recebe. A empresa nunca segura dinheiro de
terceiros.
- Parte do jogo social vai direto pra associação (§3E
e §23), que executa as ações.
- O usuário vê o valor de cada parte antes de confirmar. Sem letra
miúda.
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 |
- O Erasto não administra a associação sozinho e
não tem lucro com ela.
- O dinheiro da associação é da associação: conta própria, assembleia
e conselho fiscal próprios (§23.7).
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
- O jogo é só pra maiores de 18 anos. Sem
crianças nem adolescentes no jogo.
- Pessoas idosas são bem-vindas e jogam como
anciões.
4.2. Quests
- Quest é gerada por IA semanalmente (
gerar-quests).
- Toda quest tem critério objetivo de validação (foto
+ GPS).
- Watcher PoW (modelo vision) aprova/rejeita.
- Recompensa em SulCoin proporcional à dificuldade.
- Civic engagement: limpeza, fotografia patrimônio, mutirão.
- Missão de guilda é diferente: não é gerada por IA —
nasce de reclamação real da rádio ou do chat do bairro, e carrega a
origem rastreável. Ver §23.3.
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
- ❌ Sem armas (espada, arma de fogo, faca de combate).
- ❌ Sem nudez, violência explícita, política partidária.
- ❌ Sem competição direta entre players (jogo cooperativo).
{#5-ia-regras-de-uso-e-privacidade} ## 5. IA — REGRAS DE USO E
PRIVACIDADE
5.1. Onde a IA é usada
- 🌊 Litorânea — chat com turista
(Cerebras/Groq/SambaNova com fallback)
- 🤖 Automata — explicar o app
- ✨ Aurora — narrar RPG, gerar quests
- 👁️ Watcher PoW — validar fotos
- 🌙 IA noturna — auto-KB, fraude, auditor,
tradução
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)
- Cerebras, Groq, SambaNova, OpenRouter, Cloudflare → NÃO
treinam com input.
- Pollinations → público (só conteúdo já público).
- Ollama local → 100% privado.
5.4. Quem paga a IA
- A computação é paga pela empresa do dono (SLU), com o R$ 1/mês do
usuário, a publicidade e o 1% da barra de decisão
(§3D).
- Comerciante: 3 gerações incluídas, depois 10§ por geração
extra.
- B2G: contrato municipal cobre.
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
- Hub não recebe nem guarda dinheiro de usuário. Ações em dinheiro
passam pela associação local (§3E).
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
- São contratados e pagos em reais pela empresa do dono
(SLU), com a receita dela.
- Recebem quest de manutenção, executam e submetem prova (commit hash
+ foto se for físico).
- SulCoin que ganharem é só ponto de fidelidade, como
de qualquer usuário — nunca vira dinheiro.
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
- ⏳ Futuro: comerciante anunciante pode receber TV (contratação à
parte).
- Cliente físico aperta botão pra ativar pulso de 5
minutos.
- TV exibe propaganda segmentada por categoria agregada
(anônima).
- Sem geofencing 24/7. Sem dados pessoais na TV.
8.2. Privacidade
- Anônimo na TV.
- Lat/lng arredondado.
- TTL 5 min.
- Opt-in obrigatório.
9. B2G — REGRAS DE CONTRATO
9.1. Stakeholders
- Cadimpacto (Câmaras de Lojistas)
- SEBRAE
- Prefeituras (Florianópolis, Morretes, etc)
9.2. O que prefeitura recebe
- Painel municipal com fluxo turístico real
- Relatórios mensais com IA (auditor)
- API de dados anonimizados
- Marca branca (futuro)
9.3. Preços
- R$ 5k–30k/mês conforme tamanho.
10. TURISTA — DIREITOS E
DEVERES
10.1. Direitos
- Conta por R$ 1/mês, sem fidelidade — cancela quando quiser.
- Ganhar SulCoin por uso do app.
- Pedir exclusão de dados (LGPD) a qualquer momento.
- Reportar fraude/comerciante mal.
10.2. Deveres
- Não criar contas fake.
- Não publicar foto/conteúdo ofensivo.
- Respeitar tempo/espaço do comerciante.
11. CONFLITOS — COMO RESOLVE
11.1. Comerciante vs turista
- Reportar via app ou Telegram.
- Auditor IA analisa em ≤24h.
- Decisão automática se evidência for clara (foto, ledger).
- Se controverso, conselho decide (provisório, depois
conselho).
11.2. Suspeita de fraude
- Detector roda 03h.
- Conta marcada como “em revisão” (não bloqueada).
- Admin aprova/rejeita via Telegram (
/propostas).
- Se fraude confirmada: saldo congelado + investigação.
12. LGPD — DADOS PESSOAIS
- Coletamos: nome, email, telefone, foto perfil, transações SulCoin,
histórico de visitas.
- NÃO vendemos pra terceiros.
- Sanitizamos antes de IA externa.
- Direito de exclusão: pedir via app ou email
[email protected].
- Backup off-site criptografado AES-256.
13. ALTERAÇÕES NESTAS REGRAS
- Mudanças aprovadas pelo conselho (provisório).
- Versão fica registrada com data.
- Comerciantes e usuários são avisados no app 7 dias antes.
- Conselho de governança ⏳ a formar.
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)
- Nunca SulCoin “salta” de uma pool pra outra sem
registro.
- Cada movimentação tem:
pool_origem,
pool_destino, motivo,
auth.uid().
- Auditor IA confere semanalmente se soma das pools = total
ledger.
14.4. Quem pode mover entre
pools
- Sistema (RPCs cunhadoras) — automático.
- admin — manual via painel admin, sempre
registrado.
- Hub — só dentro da própria pool estadual.
- Ninguém mais.
14B. ECONOMIA DAS
MISSÕES — CICLO COMPLETO
14.1. Quem cadastra missão
- Hub estadual (PR/SC/RS)
- Comerciante com plano ativo
- Prefeitura B2G (contrato ativo)
- Aurora IA (com aprovação do conselho)
- Associação com termo de parceria assinado — só para
missões do próprio bairro, e só a partir de reclamação
rastreável (ver §23.3 e §23.5)
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
- Saldo SulCoin fica no
sulcoin_ledger (banco Supabase,
RLS protege).
- Carteira no app mostra saldo + histórico.
- Não tem “carteira blockchain” — é registro interno de pontos.
14.5. Como o player usa
- Só dentro do app: desconto em comerciante parceiro,
serviços e benefícios.
- Não existe saque, não existe Pix, não existe troca
por reais.
14.8. Auditoria pública
- Tabela
sulcoin_ledger → cada transação tem origem e
destino.
- Endpoint
/transparencia mostra agregados públicos.
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
- Cashback nas vendas (cliente usa pontos → comerciante recebe parte
em pontos)
- Missões e ações da comunidade
- Não se compra SulCoin com dinheiro.
17.3. Por que isso É BOM
- ✅ Comerciante vê retorno: gerou promoção → vendeu
mais
- ✅ Ponto circula dentro do app (não é
especulação)
18. COMERCIANTE — UM PLANO SÓ
- R$ 10/mês ou R$ 100/ano. Mesmo preço pra feirante,
loja ou rede.
- Inclui: cadastro de produtos, anúncio no app, aparecer no matching
de preço, 3 promoções com IA, QR de pagamento, Feira Digital.
- Prefeitura (B2G): contrato próprio (§9).
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 |
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”
- Voz (Whisper) → transcribir + tradutor + comando voz + dititar
review
- IA chat → guia + atendimento + tutorial + concierge +
recomendador
- GPS → bússola + rota + check-in quest + DOOH proximidade
- Câmera → foto produto + Watcher PoW + AR turismo (futuro) + scan
QR
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.
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)
- Produtos cadastrados, estoque com alertas, importação de
cardápio.
- IA assistente de vendas (com limite justo de uso).
- Plano de vendas e metas.
- Promoções com IA (3 incluídas, depois 10§ cada).
21.2. Tipos de arquivo aceitos
- 📷 JPG/PNG/WebP — fotos produto, vitrine,
equipe
- 🎥 MP4 curto (≤30s) — produto em movimento
- 📄 PDF — cardápio, ficha técnica, certificado
- 📊 Excel/CSV — importar 1.000 produtos de uma
vez
- 🎤 MP3/M4A — áudio narrando produto (vira
texto+tradução)
- 🗺️ KML/GeoJSON — múltiplas filiais
georreferenciadas
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
- Meta R$ + meta unidades
- Períodos: semanal / mensal / trimestral
- Realizado atualizado automático pelo
feira_compras
- IA monitora e avisa se está atrasado
- Visualização no
/admin-painel.html aba comerciante
(futuro)
- Comerciante pode oferecer cashback extra em pontos
= aparece com selo “🎁 Boost”.
- Os pontos saem da pool de descontos do próprio comerciante.
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 ⏳)
- Botão “Trilhas” vai pro grupo combinado
“Trilhas + Caça ao Tesouro” (Aurora já está assim)
- Botão novo “🏢 Comércio Pro” aparece na navbar pra
comerciantes com plano ativo e administradores
- Acessa: estoque, planos vendas, importar cardápio, IA assistente,
analytics
- Pra users normais: invisível (não polui)
22. ITENS AINDA EM CONSTRUÇÃO ⏳
- Conselho de governança do SulCoin.
- Integração do split Mercado Pago na barra de decisão.
- Registro da associação sem fins lucrativos (estatuto, CNPJ, 3–5
fundadores).
- Termos de Serviço jurídicos formais (advogado).
- Política de Privacidade jurídica formal (advogado).
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
- Toda guilda cadastrada tem NPC próprio,
tipo = 'guilda', com pino 2× maior que os
demais e nome visível.
- É o único tipo de NPC com destaque visual permanente. Motivo: é
ponto de encontro, não curiosidade.
- Aparece com
modo = 'ambos' — vale no Mapa Vivo e no
jogo.
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:
- Rádio — recado, pedido ou queixa que entra no
ar.
- 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:
- Associação de moradores / conselho comunitário com termo de
parceria assinado, limitado às missões do próprio bairro.
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
- O dinheiro que o usuário escolhe mandar pro jogo
social na barra de decisão (§3D) cai direto na conta da
associação, pelo split do Mercado Pago. Não passa pela empresa
do dono.
- O 1% de computação vai pra empresa do dono (SLU) —
é ele que mantém servidor, IA, mapa e rádio funcionando.
- Quem decide o uso do dinheiro da associação é a assembleia
da associação — não a Vento Sul. Trilha, plantio de árvore,
mutirão, equipamento da cozinha comunitária: a comunidade aponta.
- Sem fidelidade e sem multa de saída.
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 |
- A associação tem de 3 a 5 fundadores (moradores
e/ou comerciantes). O Erasto não administra sozinho e
não tem lucro com ela.
- Conselho fiscal da associação é o auditor oficial,
com acesso total às contas.
- Razão aberto: toda alocação registrada e
visível.
- Prestação de contas pública periódica, em português
claro.
23.8. Proibições da guilda
- ❌ Guilda não cobra de morador pra participar.
- ❌ Guilda não vira loja de um dono só — se o
resultado não é dividido, não é guilda.
- ❌ Missão de guilda não pode ser inventada sem
reclamação de origem (§23.3).
- ❌ A associação não repassa verba pra empresa do dono — o 1% de
computação já é separado na compra (§3D).
23.9. Internet das guildas
- O app patrocina a internet do lugar da guilda
por contrato (contrato de patrocínio entre a empresa do
dono e a associação).
- Quem contrata a internet é a associação, com um
provedor autorizado pela Anatel.
- O Vento Sul não é provedor de internet e não
revende conexão.
24. CONTATO
- App: vento-sul.tech
- Email: [email protected]
- Telegram: @ventosul (bot)
- Repos privados:
4ut0m474/vento-sul-*
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
- v1.2 — 14/10/2026: novo modelo do dono — usuário R$
1/mês; comerciante R$ 10/mês ou R$ 100/ano; matching IA + Supabase;
compras coletivas agendadas; vídeos com recompensa fixa (sem sorteio,
Lei 5.768/71); barra de decisão (1% obrigatório + escolha do usuário)
com split Mercado Pago; SulCoin só ponto de fidelidade (Lei 14.478/2022,
art. 3º), sem saque; guildas = associações reais com internet
patrocinada por contrato; Aurora com 7 classes sociais, anciões e só
maiores de 18; estrutura SLU + associação sem fins lucrativos.
Removidos: planos VIP/Grande, 1% pros Magos, saque Pix/taxa 5%/pacotes
de SulCoin, percentuais de fundador por fase, citação errada “LC
182/2021/71”.
- v1.2 (ajuste) — 14/10/2026: §23.9 movida pra antes
de §24; páginas Transparência e Como Funciona, aba “Saques” do admin e
texto da Adesão Municipal alinhados à v1.2.
- v1.1 — 02/08/2026: §23 — Guilda = centro
comunitário do bairro.
- v1.0: versão inicial.