Plataforma para geração de cupons de desconto

Documento de Projeto Executivo: Plataforma "i-tudo"1. Visão Geral do ProjetoO objetivo é construir uma plataforma de fidelidade e marketing em rede, chamada i-tudo, composta por um aplicativo para clientes (iOS/Android) e painéis web para lojistas e administradores. A plataforma visa criar um ecossistema onde clientes são recompensados por consumir dentro de uma rede de empresas parceiras de segmentos exclusivos, incentivando a retenção e o fluxo de consumo entre os parceiros.2. Componentes da Arquiteturao sistema será composto por quatro componentes principais que se comunicam através de uma api central:•api central (backend): o cérebro do sistema, contendo toda a lógica de negócios, regras de gamificação, processamento financeiro e comunicação com o banco de dados.•Banco de Dados: Armazenará de forma segura e relacional todos os dados de usuários, parceiros, benefícios, transações e ofertas.•Aplicativo do Cliente (Frontend - iOS & Android): A interface principal para o consumidor final.•Painéis Web (Frontend - Web):•Painel do Lojista: Ferramenta de trabalho para o parceiro no ponto de venda (PDV).•Painel do Administrador: Ferramenta de gestão estratégica para o dono da plataforma.3. Especificações do Backend (API Central)•Autenticação:•Cliente: Login e cadastro via CPF.•Lojista/Admin: Login via usuário e senha.•Implementar jwt (json web tokens) para segurança das sessões.•Módulo de Benefícios:•Tipos de Cupons:•TARGETED (Direcionado): Válido apenas na loja que o gerou.•FREE (Livre): Válido em qualquer parceiro da rede.•Cashback: Saldo em valor monetário (R$) acumulado na carteira do cliente.•Regras: Todos os benefícios (cupons e cashback) devem ter uma data de criação e expirar automaticamente após 30 dias.•Intransferibilidade: Benefícios são estritamente vinculados ao CPF do cliente.•Motor de Recompensas (Gamificação):•Deve rastrear métricas por usuário (volume de gastos, frequência, diversidade de lojas).•Deve implementar um sistema de níveis de cliente (ex: Iniciante, Fiel, Embaixador).•Deve gerar "Cupons Livres" progressivamente, com base no nível e nas métricas do cliente (regra configurável pelo Admin).•Módulo de Geolocalização:•Endpoint para receber coordenadas do cliente e retornar uma lista de parceiros ordenados por proximidade.•Capacidade de suportar notificações push georreferenciadas (geofencing).•Módulo Financeiro (Monetização):•Planos: Suporte para dois modelos de parceiro:•ESSENCIAL: Taxa de adesão única + comissão sobre o valor do desconto utilizado.•PROFISSIONAL: Mensalidade fixa recorrente.•Faturamento Automatizado:•Geração de faturas mensais automáticas para parceiros do plano ESSENCIAL.•A fatura deve ser um extrato detalhado de todas as transações que geraram comissão.•Integração com Gateway de Pagamento (Stripe, PagSeguro, etc.):•Geração de cobranças via Pix e Boleto.•Gestão de assinaturas para cartão de crédito (plano PROFISSIONAL).•Webhook para receber confirmações de pagamento em tempo real.•Sistema de Suspensão Automática:•Monitorar faturas vencidas.•Enviar notificações de cobrança em intervalos pré-definidos.•Suspender o acesso do parceiro automaticamente após 10 dias de atraso.•Reativar o acesso do parceiro instantaneamente após a confirmação do pagamento.4. Especificações do Aplicativo do Cliente (iOS & Android)•Identidade Visual: Utilizar a logo e a paleta de cores (vermelho, preto/cinza escuro) da marca "i-tudo".•Telas Principais:•Cadastro/Login: Via CPF. Solicitar permissão de localização (GPS) ou, como alternativa, cadastro de endereço manual.•Tela Inicial (Home): Seção principal "Ofertas Perto de Você", baseada em geolocalização. Acesso rápido ao saldo de cashback/cupons. Vitrine de ofertas do marketplace.•Carteira Digital: Abas para "Cupons" e "Cashback". Cards de cupons devem mostrar valor, loja de origem (se aplicável) e data de expiração em destaque.•Mapa da Rede: Mapa interativo com pins para cada parceiro, com filtros por categoria.•Marketplace de Ofertas: Vitrine onde parceiros podem anunciar produtos específicos com descontos ou cashback especiais.•Notificações Push: Receber notificações de novos benefícios, ofertas próximas (geofencing) e avisos.5. Especificações do Painel do Lojista (Web Responsivo)•Acesso: Login e senha criados pelo Administrador.•Tela Principal (PDV):•Interface otimizada para agilidade no caixa.•Campo único para inserção do CPF do cliente.•Exibição clara dos benefícios disponíveis para o CPF informado.•Botões grandes e claros para "Utilizar Cupom" ou "Usar Saldo de Cashback".•O sistema deve validar o tipo de cupom (TARGETED vs. FREE) antes de permitir o resgate.•Geração de Benefícios: Interface para o lojista inserir o valor de uma compra e o sistema gerar o benefício correspondente para o cliente.•Gestão de Ofertas: Ferramenta para o lojista criar e publicar suas próprias ofertas no marketplace do aplicativo.•Seção Financeira: Acesso ao histórico de faturas, extratos detalhados e opções de pagamento (Pix/Boleto).6. Especificações do Painel do Administrador (Web)•Acesso: Login e senha seguros para o administrador da plataforma.•Dashboard Principal: Visão geral com os principais KPIs da rede (nº de clientes, transações, volume financeiro, ranking de parceiros, etc.).•Módulo de Gestão de Parceiros:•Formulário para cadastrar novos parceiros com todos os dados (CNPJ, endereço, segmento, etc.).•Ferramenta para criar e gerenciar os logins dos lojistas.•Controle de exclusividade por segmento/região.•Módulo Financeiro:•Dashboard para acompanhar o status de todas as faturas (Pagas, Em Aberto, Vencidas).•Acesso a todos os extratos gerados.•Configurações do gateway de pagamento.•Configurações do Sistema:•Área para configurar as regras do "Motor de Recompensas" (níveis de cliente, valores para geração de cupons livres, etc.).•Gestão de textos de notificações e e-mails automáticos.Este documento serve como um ponto de partida completo. Uma equipe técnica pode usá-lo para estimar o tempo e o custo do desenvolvimento, bem como para iniciar a construção imediata do produto.