> ## Documentation Index
> Fetch the complete documentation index at: https://developers.googa.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Googa Developers

> APIs para integrar NovelAI, HistorinhAI e NovelAudio como SVA (Serviço de Valor Agregado) em operadoras e parceiros de distribuição.

## O que é a plataforma Googa

A Googa opera três produtos editoriais nativos de IA — **NovelAI** (novela seriada para adultos),
**HistorinhAI** (histórias personalizadas para desenvolvimento infantil) e **NovelAudio**
(audiolivro seriado com narração neural). Os três compartilham o mesmo modelo de negócio — um
capítulo novo por dia, sessões de 5 a 10 minutos — e o mesmo modelo de parceria: um parceiro
(operadora de telecom, banco, varejista) integra uma vez e ativa qualquer combinação dos três
como benefício ou SVA premium na própria fatura ou app. A escolha de final no último capítulo é
exclusiva do NovelAI — HistorinhAI e NovelAudio têm desfecho único e fixo por história.

Esta documentação é o contrato técnico entre a Googa e quem integra: como autenticar, como
provisionar acesso por assinante, como receber eventos, e como tratamos dados pessoais —
incluindo dados de crianças no HistorinhAI. O que já está implementado e o que ainda é desenho
planejado está marcado explicitamente em cada página.

<CardGroup cols={2}>
  <Card title="Modelo de autenticação" icon="key" href="/architecture/supabase-auth-model">
    Como a identidade do parceiro, do assinante e do app se combinam — e o papel exato do Supabase nisso.
  </Card>

  <Card title="Referência de API" icon="code" href="/platform/overview">
    Entitlements, status de assinante, uso para billing e webhooks — os endpoints compartilhados por todo parceiro.
  </Card>

  <Card title="Segurança & LGPD" icon="shield-check" href="/security/overview">
    Criptografia, isolamento multi-tenant, base legal por finalidade, e o tratamento reforçado de dados de menores no HistorinhAI.
  </Card>
</CardGroup>

## Como ler esta documentação

Os produtos rodam sobre projetos [Supabase](https://supabase.com) — Postgres com Row
Level Security, autenticação e Edge Functions: NovelAI e NovelAudio **compartilham** o projeto
"Novel", e o HistorinhAI roda em um projeto próprio, isolado (ver [Modelo
multi-tenant](/architecture/multi-tenant-model)). Cada projeto é consumido diretamente pelos apps
oficiais (Web/PWA — não existem apps nativos iOS/Android hoje). O que este documento especifica é
a camada que estende esse modelo para um sistema
externo, como o de uma operadora: como ele provisiona acesso, recebe eventos e reconcilia billing,
sem nunca tocar diretamente no banco de dados dos produtos.

## Os três produtos, uma superfície de API

| Produto              | Domínio                              | Público          | O que a API de parceiro expõe                                                                                                                                                         |
| -------------------- | ------------------------------------ | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Platform** (comum) | `api.googa.com.br`                   | Todo parceiro    | Entitlements, status de assinante, billing usage, webhooks; SSO é planejado                                                                                                           |
| **NovelAI**          | `api.novelai.com.br`                 | Leitores adultos | Catálogo, progresso de leitura, capítulos liberados, escolhas de final, engajamento agregado                                                                                          |
| **NovelAudio**       | `api.novelai.com.br` (mesmo backend) | Ouvintes         | Catálogo de áudio, streaming, posição de reprodução (catálogo de vozes é roadmap — não existe hoje)                                                                                   |
| **HistorinhAI**      | `api.historinhai.com.br`             | Famílias         | **Somente** engajamento agregado e anonimizado — nenhum dado identificável de criança (perfis, geração e relatórios vivem só dentro do app; ver [HistorinhAI](/historinhai/overview)) |

NovelAI e NovelAudio compartilham o mesmo projeto Supabase e o mesmo backend físico —
`api.novelai.com.br` atende as duas superfícies (a Referência de API de cada produto continua
documentada em aba própria, porque os recursos são diferentes: um é texto, o outro é áudio).
HistorinhAI roda em um projeto Supabase isolado — decisão deliberada dado o tratamento de dados
de crianças — e por isso tem domínio próprio.
