RiseUP/riseup-squad20
1
0
Fork 3
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
427 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 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%