Sonora REST API - Plataforma de Geração de Conteúdo com IA

API REST Django completa para criação de conteúdo para redes sociais usando inteligência artificial. Sistema integrado com Google OAuth, sistema de créditos, assinaturas e geração automatizada de texto e imagens.

🏗️ Arquitetura do Sistema

📱 Core Features

Geração de Conteúdo com IA: Texto e imagens otimizadas para Feed, Reels e Stories
Sistema de Créditos: Controle de uso baseado em créditos com preços fixos
Perfil do Criador: Onboarding em 3 etapas com personalização de marca
Assinaturas: Planos mensais, trimestrais, semestrais e anuais via Stripe
Sistema de Fontes: 26 fontes Google profissionais para overlay de texto
Autenticação Avançada: Email + Google OAuth com JWT tokens

🎨 Sistema de Perfil do Criador

Onboarding em 3 Etapas

📝 Etapa 1: Informações Pessoais
├── Nome Profissional
├── Profissão
├── Handle do Instagram
└── WhatsApp

🏢 Etapa 2: Informações do Negócio
├── Nome do Negócio
├── Especialização
├── Descrição do Negócio
├── Website e Instagram Empresarial
├── Público-Alvo (gênero, idade, localização, interesses)
└── Cidade de Atuação

🎨 Etapa 3: Identidade Visual
├── Tom de Voz (profissional, descontraído, amigável)
├── Paleta de 5 Cores (gerada automaticamente se não definida)
└── Logo (opcional, base64)

💳 Sistema de Créditos e Assinaturas

Modelo de Preços Fixos

FIXED_PRICES = {
    'image_generation': Decimal('0.23'),  # R$ 0,23 por imagem
    'text_generation': Decimal('0.02'),   # R$ 0,02 por texto
}

Tipos de Assinatura

Monthly: Renovação mensal
Semester: A cada 6 meses
Yearly: Anual

Sistema de Créditos

📊 Estrutura de Créditos:
├── monthly_credits: Créditos renovados automaticamente
├── balance: Saldo atual do usuário
├── monthly_credits_allocated: Créditos do ciclo atual
├── monthly_credits_used: Créditos utilizados no mês
└── last_credit_reset: Data do último reset mensal

Transações de Créditos

Usage: Uso em operações de IA (texto/imagem)
Monthly Allocation: Renovação mensal automática

🤖 Sistema de Geração de Conteúdo

Tipos de Conteúdo Suportados

📱 Feed Posts

Estrutura: Método AIDA (Atenção, Interesse, Desejo, Ação)
Formatação: Parágrafos curtos, emojis estratégicos
Otimização: Compliance com Meta e Google Ads
CTA: Uma única chamada para ação natural

🎬 Reels

Formato: Roteiro de até 15 segundos
Estrutura: Blocos de tempo ([0s-3s], [3s-6s], etc.)
Gancho: Forte impacto nos primeiros 3 segundos
Linguagem: Frases curtas e dinâmicas

📖 Stories

Formato: 1 tela interativa
Texto: Frases curtas e impactantes
Interação: Incentivo a engajamento
CTA: Direta e clara

Geração de Imagens

📐 Formatos Automáticos

Feed: 1080x1080px (quadrado)
Reel Cover: 1080x1920px (vertical)
Story: 1080x1920px com área segura

🎨 Sistema de Overlay de Texto

26 Fontes Google: Poppins, Montserrat, Inter, Oswald, etc.
Posicionamento: 9 posições (top-left, center-center, etc.)
Efeitos: Drop shadows, strokes, cores personalizadas
Responsivo: Ajuste automático de tamanho

{
  "titulo": {
    "title-content": "Seu Título Aqui",
    "font-family": "Poppins",
    "font-size": "48px",
    "font-weight": "bold",
    "color": "#FFFFFF",
    "drop-shadow": "2px 2px 4px rgba(0,0,0,0.8)",
    "location": "top-center"
  }
}

🚀 Início Rápido

1. Instalação

# Clonar repositório
git clone https://github.com/Sonora-Content-Producer/Sonora-REST-API.git
cd Sonora-REST-API

# Criar ambiente virtual
python -m venv test_env
source test_env/bin/activate  # Linux/Mac
# ou test_env\Scripts\activate  # Windows

# Instalar dependências
pip install -r requirements.txt

2. Configuração

# Configurar banco de dados
python manage.py migrate

# Criar superusuário
python manage.py createsuperuser

# Executar servidor
python manage.py runserver

3. Configurar APIs Externas

# Setup Google OAuth
python scripts/setup_google_oauth.py

# Setup Stripe
python scripts/setup_stripe.py

# Teste APIs
python scripts/test_google_auth.py

� Endpoints da API

📱 Principais Endpoints

🔐 Autenticação
├── POST /api/v1/auth/login/           # Login com email/senha
├── POST /api/v1/auth/google/          # Login com Google OAuth
├── POST /api/v1/auth/register/        # Registro de usuário
└── POST /api/v1/auth/refresh/         # Refresh token JWT

👤 Perfil do Criador
├── GET    /api/v1/creator-profile/           # Obter perfil
├── POST   /api/v1/creator-profile/           # Criar perfil
├── PUT    /api/v1/creator-profile/           # Atualizar perfil completo
├── PATCH  /api/v1/creator-profile/step-1/    # Completar etapa 1
├── PATCH  /api/v1/creator-profile/step-2/    # Completar etapa 2
└── PATCH  /api/v1/creator-profile/step-3/    # Completar etapa 3

🤖 Geração de Conteúdo
├── POST /api/v1/ideabank/generate-content/   # Gerar texto
├── POST /api/v1/ideabank/generate-image/     # Gerar imagem
├── POST /api/v1/ideabank/regenerate-content/ # Regenerar texto
└── POST /api/v1/ideabank/regenerate-image/   # Regenerar imagem

💳 Sistema de Créditos
├── GET  /api/v1/credits/balance/             # Saldo de créditos
├── GET  /api/v1/credits/transactions/        # Histórico
├── POST /api/v1/credits/purchase/            # Comprar créditos
└── GET  /api/v1/credits/packages/            # Pacotes disponíveis

📊 Assinaturas
├── GET  /api/v1/subscriptions/plans/         # Planos disponíveis
├── POST /api/v1/subscriptions/subscribe/     # Assinar plano
├── GET  /api/v1/subscriptions/status/        # Status da assinatura
└── POST /api/v1/subscriptions/cancel/        # Cancelar assinatura

📚 Estrutura do Projeto

Sonora-REST-API/
├── 📁 CreatorProfile/          # Sistema de perfil do criador
│   ├── models.py              # CreatorProfile, UserBehavior
│   ├── serializers.py         # Serialização para API
│   ├── views.py               # Endpoints do perfil
│   └── services/              # Lógica de negócio
├── 📁 CreditSystem/           # Sistema de créditos e assinaturas
│   ├── models.py              # UserCredits, CreditTransaction, SubscriptionPlan
│   ├── middleware.py          # Validação de créditos
│   └── services/              # Integração Stripe
├── 📁 IdeaBank/               # Sistema de geração de conteúdo
│   ├── models.py              # Post, PostIdea
│   ├── gemini_service.py      # Integração Google Gemini
│   └── services/              # AI Services (OpenAI, Anthropic, etc.)
│       ├── post_ai_service.py          # Orquestração principal
│       ├── text_overlay_service.py     # Sistema de fontes
│       ├── ai_service_factory.py       # Factory pattern
│       └── base_ai_service.py          # Classe base
├── 📁 static/fonts/           # 26 Google Fonts (8.1MB)
├── 📁 scripts/                # Scripts de configuração e teste
└── 📁 docs/                   # Documentação completa

🛠️ Tecnologias e Dependências

Backend

Django 4.2+: Framework web principal
Django REST Framework: API REST
PostgreSQL: Banco de dados principal
JWT: Autenticação stateless
Celery: Processamento assíncrono

APIs de IA

Google Gemini: Geração de texto e imagem (principal)
OpenAI GPT: Modelos alternativos
Anthropic Claude: Opção premium

Pagamentos e Assinaturas

Stripe: Processamento de pagamentos
Webhooks: Automação de assinaturas

Processamento de Imagem

Pillow (PIL): Manipulação de imagens
26 Google Fonts: Sistema completo de tipografia

🚢 Deploy e Produção

Vercel (Recomendado)

# Deploy automático
vercel --prod

# Ou usar script personalizado
./deploy_to_vercel.sh

Variáveis de Ambiente Necessárias

# Django
SECRET_KEY=your-secret-key
DEBUG=False
ALLOWED_HOSTS=your-domain.com

# Database
DATABASE_URL=postgresql://user:pass@host:port/db

# Google APIs
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret
GEMINI_API_KEY=your-gemini-api-key

# Stripe
STRIPE_PUBLISHABLE_KEY=pk_live_...
STRIPE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...

# OpenAI (opcional)
OPENAI_API_KEY=sk-...

# Anthropic (opcional)
ANTHROPIC_API_KEY=sk-ant-...

� Documentação Detalhada

🚀 Início Rápido

Configuração Inicial - Setup completo
Deploy no Vercel - Produção

🔐 Autenticação

Google OAuth - Integração completa
JWT Tokens - Sistema de tokens

🤖 Sistema de IA

Modelos Disponíveis - Gemini, OpenAI, Anthropic
Geração de Texto - Prompts e personalização
Geração de Imagem - Overlays e fontes

💳 Sistema de Créditos

Integração Stripe - Pagamentos e webhooks
Gestão de Créditos - Transações e saldos
Planos de Assinatura - Configuração de planos

🎨 Sistema de Fontes

Coleção de Fontes - 26 fontes Google disponíveis
Overlay de Texto - Sistema de sobreposição

👤 Perfil do Criador

Onboarding - Processo em 3 etapas
Personalização - Cores e identidade visual

🧪 Scripts de Teste e Configuração

# Testes do sistema
python scripts/test_google_auth.py          # Teste Google OAuth
python scripts/test_all_fonts.py            # Teste todas as 26 fontes
python scripts/create_font_showcase.py      # Showcase visual das fontes
python scripts/test_credit_deduction_e2e.py # Teste sistema de créditos

# Configuração
python scripts/setup_google_oauth.py        # Setup Google OAuth
python scripts/setup_stripe.py              # Setup Stripe
python scripts/manage_google_oauth.py       # Gerenciar OAuth

# Debug e desenvolvimento
python scripts/test_api_debug.py            # Debug da API
python scripts/test_working_models.py       # Teste modelos de IA
python scripts/test_ai_selection.py         # Teste seleção de IA

🔧 Utilitários de Desenvolvimento

Gerenciamento de Fontes

Font Test Suite: Validação completa de todas as fontes
Font Showcase Generator: Demonstração visual
Font Collection: 26 fontes organizadas por categoria

Sistema de IA

Model Selection: Escolha automática baseada em custo-benefício
Credit Validation: Validação antes de operações
Fallback System: Modelos alternativos em caso de falha

Monitoramento

Credit Transactions: Histórico completo de transações
User Behavior: Tracking de preferências
Subscription Status: Monitoramento de assinaturas

🌟 Features Destacadas

🎯 Personalização Inteligente

Contexto automático do perfil do criador nos prompts
Paleta de cores da marca aplicada automaticamente
Tom de voz respeitado na geração de conteúdo

💰 Sistema Econômico

Preços fixos: R$ 0,02 (texto) e R$ 0,23 (imagem)
Seleção automática do modelo mais econômico
Renovação mensal automática de créditos

🎨 Design Profissional

26 fontes Google profissionais
Sistema de overlay com efeitos avançados
Formatos otimizados para cada tipo de conteúdo

⚡ Performance e Escalabilidade

Factory pattern para serviços de IA
Middleware de validação de créditos
Processamento assíncrono com Celery
Deploy serverless no Vercel

📞 Suporte e Contribuição

Documentação de Referência

AI Service Refactoring - Arquitetura dos serviços
Credit System Integration - Sistema de créditos
Frontend Error Handling - Tratamento de erros
Google Console Setup - Configuração OAuth
Postman Testing Guide - Testes de API

Contato

Repositório: Sonora-Content-Producer/Sonora-REST-API
Issues: Para bugs e solicitações de features
Discussions: Para dúvidas e discussões técnicas

🚀 Sonora REST API - Plataforma completa de geração de conteúdo com IA para criadores de conteúdo e profissionais de marketing digital.

Name		Name	Last commit message	Last commit date
Latest commit History 86 Commits
.cursor/rules		.cursor/rules
.github/workflows		.github/workflows
.vercel		.vercel
.vscode		.vscode
CreatorProfile		CreatorProfile
CreditSystem		CreditSystem
GlobalOptions		GlobalOptions
IdeaBank		IdeaBank
Sonora_REST_API		Sonora_REST_API
Users		Users
docs		docs
scripts		scripts
staticfiles		staticfiles
.env.example		.env.example
.gitignore		.gitignore
.vercelignore		.vercelignore
GOOGLE_OAUTH_DEBUG.md		GOOGLE_OAUTH_DEBUG.md
README.md		README.md
STRIPE_CONFIG.md		STRIPE_CONFIG.md
build_files.sh		build_files.sh
comprehensive_webhook_debug.py		comprehensive_webhook_debug.py
manage.py		manage.py
requirements-development.txt		requirements-development.txt
requirements-vercel.txt		requirements-vercel.txt
requirements.txt		requirements.txt
vercel.json		vercel.json

PostNow-AI/PostNow-REST-API

Folders and files

Latest commit

History

Repository files navigation

Sonora REST API - Plataforma de Geração de Conteúdo com IA

🏗️ Arquitetura do Sistema

📱 Core Features

🎨 Sistema de Perfil do Criador

Onboarding em 3 Etapas

💳 Sistema de Créditos e Assinaturas

Modelo de Preços Fixos

Tipos de Assinatura

Sistema de Créditos

Transações de Créditos

🤖 Sistema de Geração de Conteúdo

Tipos de Conteúdo Suportados

📱 Feed Posts

🎬 Reels

📖 Stories

Geração de Imagens

📐 Formatos Automáticos

🎨 Sistema de Overlay de Texto

🚀 Início Rápido

1. Instalação

2. Configuração

3. Configurar APIs Externas

� Endpoints da API

📱 Principais Endpoints

📚 Estrutura do Projeto

🛠️ Tecnologias e Dependências

Backend

APIs de IA

Pagamentos e Assinaturas

Processamento de Imagem

🚢 Deploy e Produção

Vercel (Recomendado)

Variáveis de Ambiente Necessárias

� Documentação Detalhada

🚀 Início Rápido

🔐 Autenticação

🤖 Sistema de IA

💳 Sistema de Créditos

🎨 Sistema de Fontes

👤 Perfil do Criador

🧪 Scripts de Teste e Configuração

🔧 Utilitários de Desenvolvimento

Gerenciamento de Fontes

Sistema de IA

Monitoramento

🌟 Features Destacadas

🎯 Personalização Inteligente

💰 Sistema Econômico

🎨 Design Profissional

⚡ Performance e Escalabilidade

📞 Suporte e Contribuição

Documentação de Referência

Contato

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages