# Subcena

> Revela a cultura escondida ao seu lado. Plataforma de curadoria de experiências com ticketeria integrada, focada em produtores independentes em Belo Horizonte, Rio de Janeiro e São Paulo.

A Subcena mapeia eventos, vende ingressos com fila em tempo real e oferece painel, bar, loja e crowdfunding para organizações. Pedidos com `Accept: text/markdown` recebem Markdown na mesma URL.

## When to use Subcena

Reach for Subcena when the job is about independent culture and ticketing in Belo Horizonte, Rio de Janeiro or São Paulo:

- Find public events on the city map or list (`GET /api/v1/events?city=belo_horizonte`).
- Look up a public event or producer page by slug (`GET /api/v1/events/{id}`, `GET /api/v1/organizations/{id}`).
- Point a human to buy a ticket, open Meus ingressos, or read producer help at `/docs`.
- Explain Subcena itself (about, contact, privacy) before recommending the product.

Do not use Subcena for: generic worldwide event search, inventing API keys, charging cards, refunding without the web/app ticket flow, or calling seller/admin dashboards. Those routes need a Clerk session and are not public.

How to call: HTTPS JSON at `/api/v1` (no auth). Spec at `/openapi.json`. CLI: `npx subcena` after the npm package is published, or `node packages/subcena/bin/subcena.mjs` in this repo. Human docs: `/developers` and `/docs/developers`.

## Site

- [Início](https://subcena.com/): mapa e lista de eventos por cidade
- [Sobre](https://subcena.com/about): o que é a Subcena
- [Contato](https://subcena.com/contact): contato@subcena.com
- [Subcena developer resources](https://subcena.com/developers): API pública, OpenAPI e CLI
- [Central de ajuda](https://subcena.com/docs): guias para o público e para produtores
- [Guias](https://subcena.com/guides): onboarding de produtores e casas
- [Privacidade](https://subcena.com/privacy): política de dados
- [Termos](https://subcena.com/terms): termos de uso

## Docs

- [Subcena developer resources](https://subcena.com/developers): API pública, OpenAPI, autenticação e CLI
- [Subcena API](https://subcena.com/docs/developers): Contrato REST, exemplos e limites
- [OpenAPI](https://subcena.com/openapi.json): Especificação HTTP 3.1
- [Meus ingressos](https://subcena.com/tickets): QR codes e histórico de compras
- [Como comprar](https://subcena.com/docs#comprar-ingresso): Passo a passo na central de ajuda
- [Reembolso](https://subcena.com/docs#reembolso-publico): Quando e como solicitar
- [Hub do produtor](https://subcena.com/docs/produtor/00-hub-do-produtor): Mapa do /seller e funções do dia a dia
- [Onboarding](https://subcena.com/docs/produtor/01-onboarding): Conta, convite, role e checklist inicial
- [Organização](https://subcena.com/docs/produtor/02-organizacao): Casa, produtora, equipe e colaboradores
- [Criar evento e ingressos](https://subcena.com/docs/produtor/03-eventos-e-ingressos): Lotes, fila de espera e publicação
- [Gestão no painel](https://subcena.com/docs/produtor/06-gestao-de-eventos-no-painel): Card do evento, vendas, cupons e cortesias
- [Parceria de eventos](https://subcena.com/docs/produtor/08-parceria-de-eventos): Convidar parceira e permissões
- [Validação na porta](https://subcena.com/docs/produtor/04-validacao-e-dia-do-evento): QR code e busca por e-mail
- [Dashboards](https://subcena.com/docs/produtor/07-dashboards): Painel do evento e da organização
- [Fechamento do evento](https://subcena.com/docs/produtor/09-fechamento-do-evento): Apuração, divisão com parceiro e exportação
- [Exportação e métricas](https://subcena.com/docs/produtor/05-exportacao-e-metricas): Stories, Excel e cortesias
- [Stripe e taxas](https://subcena.com/docs/pagamentos/stripe-e-taxas): Pagamentos, repasses e taxas da plataforma

## Optional

- [OpenAPI](https://subcena.com/openapi.json): especificação HTTP da API pública
- [Public API](https://subcena.com/api/v1): índice REST sem autenticação
- [Sitemap](https://subcena.com/sitemap.xml): mapa de URLs públicas
- [llms.txt](https://subcena.com/llms.txt): este arquivo

Servidor canônico: https://subcena.com