FINEV - Plataforma de Mentoria

FINEV e uma plataforma SaaS de mentoria com foco em conexao entre mentor e mentorado, com recursos administrativos, perfis publicos e suporte a IA.

A FINEV evolui de uma plataforma de mentoria para uma infraestrutura digital de desenvolvimento profissional e fortalecimento de PMEs africanas.

O roadmap inclui:

Estruturação de indicadores para PMEs

Camada de diagnóstico inteligente

Escalabilidade como MentorIA-as-a-Service

Arquitetura

• backend/: API Express, Postgres, uploads e email.
• frontend/: servidor Express para paginas, env.js dinamico e SSR de perfil publico.
• docs/, infra/: apoio a documentacao e infraestrutura.

Como rodar localmente

1. cd backend
2. npm install
3. Configure .env
4. npm run dev
5. cd frontend
6. npm install
7. Configure .env
8. npm run dev
9. (Opcional) npm run build:css no frontend

Variaveis de ambiente (backend)

• PORT (padrao 5000)
• NODE_ENV (ex: development ou production)
• DATABASE_URL ou DB_USER, DB_HOST, DB_NAME, DB_PASSWORD, DB_PORT
• JWT_SECRET
• FRONTEND_URL
• BACKEND_URL
• UPLOADS_PATH (caminho base para /uploads)
• EMAIL_USER, EMAIL_PASS, EMAIL_FROM
• EMAIL_SERVICE ou EMAIL_HOST, EMAIL_PORT, EMAIL_SECURE
• EMAIL_POOL (padrao true)
• EMAIL_TIMEOUT_MS (padrao 60000)
• GEMINI_API_KEY ou GOOGLE_GENAI_API_KEY
• PROFILE_VIEW_SALT
• SHARE_URL_SECRET, SHARE_URL_TTL_SECONDS
• ADMIN_EMAIL, ADMIN_PASSWORD

Variaveis de ambiente (frontend)

• PORT (padrao 3000)
• NODE_ENV
• BACKEND_URL (usado para env.js e SSR do perfil publico)

Funcionalidades principais

• Autenticacao e gerenciamento de perfil.
• Mentorias, mentores, sessoes e areas.
• Painel admin com gestao de usuarios, mentores e mentorias.
• Perfil publico com link compartilhavel.
• Upload de avatar.
• Recuperacao de senha por email.
• Chat IA para mentoria.

Implementacoes recentes

• Avatares agora sao sempre lidos do banco, sem fallback em localStorage.
• Remocao de avatar aceita avatarUrl: null no update de perfil.
• Uploads usam UPLOADS_PATH e headers Cross-Origin-Resource-Policy + Access-Control-Allow-Origin para evitar bloqueio em dominios diferentes.
• Email de recuperacao configuravel via EMAIL_* e timeout padrao de 60s.
• Busca de email Gmail considera aliases com pontos e +.
• Tabelas do admin responsivas (linhas em formato card no mobile).
• Filtros do admin responsivos (busca e selects empilham no mobile).
• Login/logout limpam estado do cliente mantendo apenas o tema.

Notas operacionais

• Se aparecer erro de timeout no envio de email, ajuste EMAIL_TIMEOUT_MS.
• Se o avatar nao carregar, valide o arquivo em UPLOADS_PATH/avatars e o endpoint /uploads.