Tipos de Usuários

O Módulo Empreendedorismo possui diferentes tipos de usuários, cada um com permissões e funcionalidades específicas.

Visão Geral

┌─────────────────────────────────────────────────────────────────┐
│                    TIPOS DE USUÁRIOS                            │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐
│  EMPREENDEDOR   │  │AGENTE ESTRUTUR. │  │     GESTOR      │
│                 │  │   (MENTOR)      │  │                 │
│  Cria planos    │  │  Revisa planos  │  │  Aprova agentes │
│  de negócio     │  │  e oferece      │  │  e monitora     │
│                 │  │  mentoria       │  │  o sistema      │
│                 │  │                 │  │                 │
│  Rota: /user    │  │  Rota: /agent   │  │  Rota: /admin   │
└─────────────────┘  └─────────────────┘  └─────────────────┘
         │                   │                    │
         │                   │                    │
         └───────────────────┼────────────────────┘
                             │
                             ▼
                    ┌─────────────────┐
                    │ INSTITUIÇÃO     │
                    │ FINANCEIRA      │
                    │                 │
                    │ Cadastra linhas │
                    │ de crédito      │
                    │                 │
                    │ Rota: /financial│
                    └─────────────────┘

---

Empreendedor

O empreendedor é o usuário principal do sistema, que deseja estruturar suas ideias de negócio.

Dados do Perfil

Campo	Descrição	Obrigatório
Nome completo	Nome completo do empreendedor	Sim
CPF	Documento de identificação	Sim
Telefone	Número para contato	Sim
Comprovante de residência	Arquivo PDF/imagem	Sim
Documento de ID	RG, CNH ou Passaporte	Sim
Precisa de ajuda	Se precisa de suporte extra	Não

Funcionalidades

• ✅ Criar e gerenciar múltiplos planos de negócio
• ✅ Preencher informações detalhadas do plano
• ✅ Upload de documentos anexos
• ✅ Solicitar mentoria
• ✅ Submeter plano para análise
• ✅ Visualizar feedback das correções
• ✅ Aplicar correções solicitadas
• ✅ Ver status do plano em tempo real
• ✅ Acessar informações de linhas de crédito
• ✅ Gerenciar perfil

Permissões

• Pode visualizar apenas seus próprios planos
• Pode acessar apenas seus documentos
• Pode criar/editar planos no status PENDING
• Não pode editar planos em UNDER_REVIEW ou IN_MENTORSHIP

Telas Principais

Rota	Tela	Descrição
/user/solicitations	Solicitações	Lista de planos de negócio
/user/solicitations/new	Nova Solicitação	Formulário de criação
/user/credit-lines	Linhas de Crédito	Opções de financiamento
/user/profile	Perfil	Dados pessoais

---

Agente Estruturador (Mentor)

O agente estruturador é um profissional de instituições de apoio que realiza a análise e mentoria de planos de negócio.

Dados do Perfil

Campo	Descrição	Obrigatório
Nome completo	Nome do profissional	Sim
CPF	Documento de identificação	Sim
Telefone	Número para contato	Sim
Cargo	Função na instituição	Sim
Instituição	Nome da instituição	Sim
CNPJ	CNPJ da instituição	Sim
Comprovante de residência	Arquivo PDF/imagem	Sim
Documentos de vínculo	Comprovante de vínculo institucional	Sim
Documentos de ID	RG, CNH ou Passaporte	Sim

Funcionalidades

• ✅ Visualizar Kanban Board com planos disponíveis
• ✅ Revisar planos de negócio
• ✅ Aprovar planos com feedback positivo
• ✅ Reprovar planos com justificativa
• ✅ Solicitar correções com descrição detalhada
• ✅ Anexar arquivo de referência nas correções
• ✅ Assumir mentoria de planos
• ✅ Monitorar mentorias ativas
• ✅ Ver métricas de desempenho
• ✅ Gerenciar perfil

Permissões

• Requer aprovação do gestor para estar ativo
• Pode visualizar planos em UNDER_REVIEW
• Pode visualizar apenas mentorias que assumiu
• Não pode alterar planos de outros mentores

Estados do Agente

Estado	Descrição
is_approved = False	Aguardando aprovação do gestor
is_approved = True	Ativo e pode revisar planos

Telas Principais

Rota	Tela	Descrição
/agent	Kanban Board	Quadro com planos por status
/agent/solicitacoes	Solicitações	Lista detalhada
/agent/metrics	Métricas	Dashboard de desempenho
/agent/profile	Perfil	Dados profissionais

---

Gestor

O gestor é o administrador que aprova agentes estruturadores e monitora o sistema.

Dados do Perfil

Campo	Descrição	Obrigatório
Nome completo	Nome do gestor	Sim
Cargo	Função/posição	Sim
Telefone	Número para contato	Sim

Funcionalidades

• ✅ Dashboard com métricas gerais do sistema
• ✅ Listar solicitações de aprovação de agentes
• ✅ Revisar documentação de agentes
• ✅ Aprovar agentes com notas
• ✅ Rejeitar agentes com justificativa
• ✅ Visualizar todos os planos de negócio
• ✅ Ver detalhes de planos com histórico
• ✅ Monitorar mentores ativos
• ✅ Gerenciar perfil

Permissões

• Acesso ao dashboard administrativo
• Pode revisar e aprovar/rejeitar agentes
• Pode visualizar todos os planos do sistema
• Não pode criar ou editar planos

Telas Principais

Rota	Tela	Descrição
/admin/dashboard	Dashboard	Métricas e visão geral
/admin/mentor-requests	Solicitações	Aprovação de mentores
/admin/business-plan	Planos	Lista de todos os planos
/admin/profile	Perfil	Dados pessoais

---

Instituição Financeira

A Instituição Financeira é o usuário responsável por cadastrar e gerenciar linhas de crédito disponíveis para os empreendedores.

Dados do Perfil

Campo	Descrição	Obrigatório
Nome da instituição	Nome oficial da instituição	Sim
CNPJ	Cadastro da empresa (14 dígitos)	Sim
Telefone	Número para contato	Sim
Nome do responsável	Nome do contato principal	Sim
Cargo do responsável	Função do responsável na instituição	Sim
Documentos de vínculo	Comprovantes de representação institucional	Sim

Funcionalidades

• ✅ Cadastrar linhas de crédito
• ✅ Definir requisitos e critérios
• ✅ Gerenciar ofertas ativas
• ✅ Visualizar planos elegíveis
• ✅ Gerenciar perfil

Permissões

• Requer aprovação do gestor para estar ativo
• Pode criar e gerenciar apenas suas próprias linhas de crédito
• Pode visualizar planos de negócio aprovados

Estados da Instituição

Estado	Descrição
is_approved = False	Aguardando aprovação do gestor
is_approved = True	Ativa e pode cadastrar linhas de crédito

Telas Principais

Rota	Tela	Descrição
/financial/credit-lines	Linhas de Crédito	Gerenciamento de linhas
/financial/profile	Perfil	Dados institucionais

---

Fluxo de Registro

┌─────────────────────────────────────────────────────────────────┐
│                    REGISTRO DE NOVO USUÁRIO                     │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │ Criar conta     │
                    │ (email + senha) │
                    └─────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │ Selecionar tipo │
                    │ de usuário      │
                    └─────────────────┘
                              │
          ┌───────────────────┼───────────────────┐
          ▼                   ▼                   ▼
   Empreendedor         Agente            Inst. Financeira
          │                   │                   │
          ▼                   ▼                   ▼
  Preencher dados     Preencher dados     Preencher dados
  pessoais + docs     profissionais       institucionais
          │                   │                   │
          ▼                   ▼                   ▼
    Email de            Email de            Email de
    verificação         verificação         verificação
          │                   │                   │
          ▼                   ▼                   ▼
   ┌──────────┐      Aguardar aprovação   Aguardar aprovação
   │  ATIVO   │           do gestor           do gestor
   └──────────┘               │                   │
                              ▼                   ▼
                    ┌──────────────────┐ ┌──────────────────┐
                    │ Aprovado? → ATIVO│ │ Aprovado? → ATIVO│
                    │ Rejeitado? → 🚫  │ │ Rejeitado? → 🚫  │
                    └──────────────────┘ └──────────────────┘

---

Comparativo de Funcionalidades

Funcionalidade	Empreendedor	Agente	Gestor	Inst. Financeira
Criar planos	✅	❌	❌	❌
Revisar planos	❌	✅	👁️	❌
Aprovar agentes	❌	❌	✅	❌
Aprovar inst. financeiras	❌	❌	✅	❌
Oferecer mentoria	❌	✅	❌	❌
Ver métricas	❌	✅	✅	❌
Cadastrar crédito	❌	❌	❌	✅
Dashboard	❌	✅	✅	❌

Legenda: ✅ Sim | ❌ Não | 👁️ Somente visualizar