Desenvolvimento de Marketplace Educacional Ppp: Professores Pagam Professores

Resumo Técnico – PPP (Professores Pagam Professores)

O PPP – Professores Pagam Professores é um MVP de marketplace educacional que permite a professores venderem ou doarem materiais didáticos digitais (PDFs, slides, vídeos curtos, áudios, jogos, roteiros, etc.) De autoria própria.
O sistema utiliza links externos de entrega (Google Drive, Dropbox, OneDrive) e foi projetado para ser simples, seguro e totalmente voltado à educação.

Objetivos do MVP

Criar uma plataforma funcional para publicação, compra e download de materiais digitais.

Implementar pagamentos via Stripe Checkout com cálculo e registro de comissão (90% criador / 10% PPP).

Garantir acesso automático aos links externos após pagamento confirmado.

Permitir download imediato de materiais gratuitos.

Disponibilizar painel do criador, painel administrativo e e-mails automáticos.

Cumprir normas de segurança, autoria e LGPD.

Arquitetura e Stack Técnica

Front-end: Next.js 14 (App Router) + TypeScript + TailwindCSS.

Back-end: Supabase (Auth + Postgres).

Pagamentos: Stripe Checkout + Webhooks (atualização de status e cálculo de comissão).

E-mails: Resend ou SendGrid (cadastro, compra, aprovação, entrega).

Hospedagem: Vercel (front) + Supabase (DB).

Logs: Supabase Logs + Vercel Analytics.

Funcionalidades Principais

Autenticação: cadastro/login e redefinição de senha.

Perfis de Criadores: foto, bio, disciplinas e materiais publicados.

Publicação: formulário com título, descrição, capa, tags, categoria, preço e link de entrega criptografado.

Catálogo: busca por palavra-chave e filtros (disciplina, tipo, preço).

Checkout: pagamento seguro via Stripe; webhook marca pedido como “paid” e libera acesso.

Comissão: cálculo automático de 90/10 e registro da venda com valores líquidos e brutos.

Biblioteca: materiais comprados ou gratuitos com botões “Acessar conteúdo”.

Avaliações: notas e comentários dos compradores.

Admin: aprovação de materiais, moderação de denúncias e exportação CSV de relatórios.

Doações: materiais gratuitos disponíveis sem checkout.

Requisitos Não Funcionais

Performance: carregamento de páginas em até 2s (rede 4G).

Segurança: autenticação JWT, criptografia de URLs e logs de acesso.

LGPD: consentimento explícito, política de privacidade, exclusão e exportação de dados.

Acessibilidade: contraste, navegação por teclado e alt-text obrigatório.

Observabilidade: monitoramento de falhas e logs centralizados.

Regras de Autoria e Conformidade

Todos os materiais devem ser de autoria própria.

É Proibido publicar conteúdo plagiado ou de terceiros.

Violações geram exclusão imediata, bloqueio de ganhos e multa de até R$5.000,00.

O autor é responsável por garantir o funcionamento dos links externos.

O PPP atua apenas como intermediário e não hospeda arquivos.

Modelagem de Dados

users: id, name, email, bio, avatar, role.

Materials: id, user_id, title, description, price_cents, cover_url, status.

Material_links: id, material_id, link_url_encrypted.

Orders: id, buyer_id, total_cents, status, provider_id, gross, net, commission.

Order_items: id, order_id, material_id, price_cents.

Reviews: id, user_id, material_id, rating, comment.

Flags: id, user_id, material_id, reason, status.

Configs: key, value.

Fluxos e Critérios de Aceite

Cadastro e login com e-mail e senha (com confirmação).

Publicação de material com campos obrigatórios e aprovação de admin.

Compra via Stripe → webhook confirma pagamento → status “paid”.

Cálculo e registro automático da comissão (90/10) no banco.

Liberação imediata dos links após pagamento.

Materiais gratuitos liberados automaticamente.

Avaliações visíveis na página do material.

Admin exporta relatórios de vendas e usuários.

Critérios: todos os fluxos devem funcionar integralmente e registrar logs; links não podem ser exibidos antes do pagamento; cálculo e registro da comissão devem estar corretos.

Cronograma de Entregas (6 semanas)

Setup, autenticação e layout base.

CRUD de materiais e painel do criador.

Catálogo e busca.

Integração completa Stripe + biblioteca.

Painel admin, notificações e e-mails automáticos.

Testes, logs, auditoria de pagamentos e deploy final.

Entregáveis Obrigatórios

Código-fonte completo (Next.js + Supabase + Stripe).

Deploy funcional (Vercel + Stripe Test).

Sistema de pagamentos 100% funcional, com:

Checkout seguro via Stripe;

Retorno automático via Webhook;

Cálculo e registro da comissão (90/10);

Registro de vendas e repasses em banco.

Painel administrativo completo (aprovação, relatórios, export CSV).

Painel do criador operacional (publicação e extrato de vendas).

Sistema de e-mails automáticos e logs de envio.

Scripts SQL e documentação de setup.

Políticas de privacidade, termos de uso e cláusula de autoria.

Checklist de segurança, LGPD e logs de auditoria.