RiseUP/riseup-squad20
1
0
Fork 3
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
386 Commits 14 Branches 0 Tags
Go to file
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE

README.md

🏥 MEDIConnect

Plataforma de Gestão de Saúde Inteligente

Combatendo o absenteísmo em clínicas e hospitais através de tecnologia e inovação

Next.js TypeScript React Tailwind CSS Supabase

📋 Índice

  1. Visão Geral
  2. Problema e Solução
  3. Funcionalidades
  4. Tecnologias
  5. Instalação
  6. Como Usar
  7. Fluxos de Usuário
  8. Componentes Principais
  9. Contribuindo
  10. Licença
  11. Contato

🎯 Visão Geral

MEDIConnect é uma plataforma web moderna e intuitiva desenvolvida para revolucionar a gestão de saúde em clínicas e hospitais. Com foco na redução do absenteísmo (faltas em consultas), a plataforma oferece uma experiência completa para pacientes, profissionais de saúde e administradores.

🌟 Diferenciais

  • 🤖 Zoe IA Assistant: Assistente virtual inteligente para suporte aos usuários
  • 📱 Interface Responsiva: Design moderno e adaptável a qualquer dispositivo
  • 🔐 Autenticação Segura: Sistema robusto com perfis diferenciados
  • ⚡ Performance: Construído com Next.js 15 para máxima velocidade
  • 🎨 UX/UI Premium: Interface limpa e profissional voltada para área da saúde

🩺 Problema e Solução

O Problema

O absenteísmo (não comparecimento a consultas agendadas) é um problema crítico em clínicas e hospitais, causando:

  • ⏰ Desperdício de tempo dos profissionais
  • 💰 Perda de receita para estabelecimentos
  • 📉 Redução da eficiência operacional
  • 😔 Impacto negativo no atendimento de outros pacientes

Nossa Solução

MEDIConnect oferece um sistema inteligente de gestão que:

  • ✅ Facilita o agendamento e reagendamento de consultas
  • ✅ Permite visualização clara da agenda para profissionais
  • ✅ Oferece assistência via IA para dúvidas e suporte

✨ Funcionalidades

👤 Para Pacientes

  • 🏠 Dashboard Personalizado: Visão geral de consultas e exames
  • 📅 Agendamento: Sistema fácil de marcar consultas
  • 📋 Resultados de Exames: Acesso seguro a laudos e resultados
  • 👨‍⚕️ Busca de Profissionais: Encontre médicos por especialidade
  • 💬 Zoe IA Assistant: Tire dúvidas 24/7 com nossa assistente virtual

👨‍⚕️ Para Profissionais

  • 📊 Dashboard Profissional: Visão completa de atendimentos
  • ✍️ Editor de Laudos: Crie e edite laudos médicos de forma rápida
  • 👥 Gestão de Pacientes: Acesse informações dos pacientes
  • 📈 Agenda: Visualização clara de consultas

🔧 Para Administradores

  • 📊 Dashboard Administrativo: Métricas e estatísticas em tempo real
  • 📈 Relatórios Detalhados: Análise de comparecimento e absenteísmo
  • 👥 Gestão Completa: Gerencie pacientes, profissionais e agendamentos
  • 🎯 Painel de Controle: Visão 360° da operação da clínica

🛠️ Tecnologias

Frontend (Atual)

Backend (Integrado)

  • Supabase - Backend as a Service (PostgreSQL)
  • Authentication - Sistema de autenticação completo
  • Storage - Armazenamento de arquivos e documentos
  • REST API - Endpoints integrados para todas as funcionalidades

Ferramentas de Desenvolvimento

  • ESLint - Linter para código JavaScript/TypeScript
  • PostCSS - Transformação de CSS
  • Autoprefixer - Prefixos CSS automáticos

🚀 Instalação

Pré-requisitos

Certifique-se de ter instalado:

  • Node.js 18.17 ou superior
  • npm
  • Git

Passo a Passo

  1. Clone o repositório
git clone https://git.popcode.com.br/RiseUP/riseup-squad20.git
cd susconecta
  1. Instale as dependências
npm install
  1. Configuração de ambiente (desenvolvimento)

Observação: o projeto possui valores fallback em susconecta/lib/env-config.ts, mas o recomendado é criar um arquivo .env.local não versionado com suas credenciais locais.

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://seu-projeto.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=pk_... (anon key)

# Aplicação
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_API_URL=http://localhost:3000/api

Boas práticas de segurança

  • Nunca exponha a service_role key no frontend.
  • Proteja operações sensíveis com Row-Level Security (RLS) no Supabase ou mova-as para rotas/Edge Functions server-side.
  • Não commite .env.local no repositório (adicione ao .gitignore).
  1. Inicie o servidor de desenvolvimento
npm run dev
  1. Acesse a aplicação

Abra http://localhost:3000 no seu navegador.

💻 Como Usar

Navegação Principal

🏠 Página Inicial

Acesse /home para conhecer a plataforma e suas funcionalidades.

🔐 Autenticação

O sistema possui três níveis de acesso:

  • Pacientes: /login-paciente
  • Profissionais: /login-profissional
  • Administradores: /login-admin

📱 Funcionalidades por Perfil

Como Paciente:

  1. Faça login em /login-paciente
  2. Acesse seu dashboard em /paciente
  3. Agende consultas em /consultas
  4. Visualize resultados em /paciente/resultados
  5. Gerencie seu perfil em /perfil

Como Profissional:

  1. Faça login em /login-profissional
  2. Acesse seu dashboard em /profissional
  3. Gerencie sua agenda em /agenda
  4. Crie laudos em /laudos-editor
  5. Visualize pacientes em /pacientes

Como Administrador:

  1. Faça login em /login-admin
  2. Acesse o painel em /dashboard
  3. Visualize relatórios em /dashboard/relatorios
  4. Gerencie o sistema completo

🎭 Fluxos de Usuário

Fluxo de Agendamento (Paciente)

graph LR
A[Login Paciente] --> B[Dashboard]
B --> C[Buscar Médico]
C --> D[Selecionar Especialidade]
D --> E[Escolher Horário]
E --> F[Confirmar Agendamento]
F --> G[Receber Confirmação]

Fluxo de Atendimento (Profissional)

graph LR
A[Login Profissional] --> B[Ver Agenda]
B --> C[Realizar Consulta]
C --> D[Criar Laudo]
D --> E[Enviar para Paciente]
E --> F[Atualizar Status]

Fluxo Administrativo

graph LR
A[Login Admin] --> B[Dashboard]
B --> C[Visualizar Métricas]
C --> D[Gerar Relatórios]
D --> E[Analisar Absenteísmo]
E --> F[Tomar Decisões]

🧩 Componentes Principais

🤖 Zoe IA Assistant

Assistente virtual inteligente que oferece:

  • Suporte 24/7 aos usuários
  • Respostas a dúvidas frequentes
  • Upload de arquivos para análise
  • Interação por voz

Arquivos:

  • components/ZoeIA/ai-assistant-interface.tsx
  • components/ZoeIA/voice-powered-orb.tsx
  • components/ZoeIA/demo.tsx

📅 Sistema de Agendamento

Gerenciamento completo de consultas e exames:

  • Calendário interativo
  • Seleção de horários disponíveis
  • Confirmação automática
  • Lembretes e notificações

Arquivos:

  • components/features/agendamento/
  • components/features/Calendario/
  • app/(main-routes)/consultas/

📋 Editor de Laudos

Ferramenta profissional para criação de laudos médicos:

  • Interface intuitiva
  • Frases pré-definidas
  • Exportação em PDF

Arquivos:

  • app/laudos-editor/
  • lib/laudo-exemplos.ts
  • lib/laudo-notification.ts

📊 Dashboard Analytics

Painéis administrativos com:

  • Métricas em tempo real
  • Gráficos interativos
  • Relatórios de absenteísmo
  • Análise de desempenho

Arquivos:

  • components/features/dashboard/
  • app/(main-routes)/dashboard/
  • lib/reportService.ts

🤝 Contribuindo

Contribuições são bem-vindas! Siga estes passos:

1. Fork o projeto

Clique no botão "Fork" no topo da página.

2. Clone seu fork

git clone https://git.popcode.com.br/RiseUP/riseup-squad20.git
cd susconecta

3. Crie uma branch

git checkout -b feature/nova-funcionalidade

4. Faça suas alterações

Desenvolva sua funcionalidade seguindo os padrões do projeto.

5. Commit suas mudanças

git add .
git commit -m "feat: adiciona nova funcionalidade X"

Padrão de commits:

  • feat: Nova funcionalidade
  • fix: Correção de bug
  • docs: Documentação
  • style: Formatação
  • refactor: Refatoração
  • test: Testes
  • chore: Manutenção

6. Push para seu fork

git push origin feature/nova-funcionalidade

7. Abra um Pull Request

Descreva suas mudanças detalhadamente.

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

📞 Contato

MEDIConnect Team

Desenvolvido com ❤️ pelo squad 20

Transformando a gestão de saúde através da tecnologia

Next.js

Description
No description provided
Readme 94 MiB
Languages
TypeScript 98.9%
CSS 0.8%
JavaScript 0.3%