Skip to content

Gildaciolopes/doctor-schedule

BranchesTags

Repository files navigation

Dr. Schedule 🩺📅

Stars Forks

Dr. Schedule é um Software como Serviço (SaaS) robusto e intuitivo, projetado para simplificar e otimizar o gerenciamento de consultas em clínicas médicas e consultórios.

🌟 Sobre o Projeto

O Dr. Schedule visa resolver a complexidade no agendamento e gerenciamento de pacientes e médicos, oferecendo uma plataforma centralizada que facilita a organização diária de uma clínica. Com ele, é possível gerenciar horários, informações de pacientes, disponibilidade médica e muito mais, tudo de forma eficiente e integrada.

✨ Funcionalidades Principais

  • Gerenciamento Completo (CRUD):
    • Médicos
    • Pacientes
    • Agendamentos
  • Dashboard Interativo: Visualização de dados e métricas importantes da clínica.
  • Sistema de Autenticação:
    • Criação de conta e login seguros.
    • Login social com Google (OAuth).
  • Integração com Stripe: Gerenciamento de assinaturas e pagamentos para o SaaS.
  • Interface Moderna e Responsiva.

🛠️ Tecnologias Utilizadas

Este projeto foi construído utilizando um stack moderno e eficiente:

🚀 Começando

Siga estas instruções para configurar e rodar o projeto em seu ambiente local.

Pré-requisitos

Instalação

  1. Clone o repositório:

    git clone git@github.com:Gildaciolopes/doctor-schedule.git
cd doctor-schedule

  2. Instale as dependências:

    npm install
# ou
# yarn install
# ou
# pnpm install

  3. Configure as Variáveis de Ambiente:

    • Copie o arquivo .env.example para um novo arquivo chamado .env: 
      cp .env.example .env
    • Preencha as variáveis no arquivo .env com suas respectivas chaves e URLs. Veja a seção Variáveis de Ambiente para mais detalhes.

  4. Configure o Banco de Dados (Drizzle ORM):

    • Certifique-se que sua string de conexão DATABASE_URL no arquivo .env está correta e apontando para seu banco de dados PostgreSQL.
    • Execute as migrações do Drizzle para criar o schema no seu banco de dados: 
      npx drizzle-kit generate # Para gerar os arquivos de migração (se necessário ao modificar o schema)
npx drizzle-kit migrate  # Para aplicar as migrações ao banco de dados
      Nota: Verifique a documentação do Drizzle para os comandos exatos de geração e aplicação de migrações (push para desenvolvimento rápido ou generate + migrate para produção). Você pode precisar de drizzle-kit studio para visualizar seu schema. Para um setup inicial, você pode precisar de um comando como npx drizzle-kit push.

  5. Rode o servidor de desenvolvimento:

    npm run dev
# ou
# yarn dev
# ou
# pnpm dev

    Abra http://localhost:3000 no seu navegador para ver o resultado.

⚙️ Variáveis de Ambiente

As seguintes variáveis de ambiente precisam ser configuradas no seu arquivo .env para o correto funcionamento da aplicação:

# URL da sua base de dados PostgreSQL
DATABASE_URL="postgresql://USER:PASSWORD@HOST:PORT/DATABASE"

# Segredos para a autenticação com Better Auth
BETTER_AUTH_SECRET="[SEU_SEGREDO_COMPLEXO_PARA_BETTER_AUTH]"
BETTER_AUTH_URL="http://localhost:3000" # Ou a URL de produção

# Credenciais do Google OAuth para login social
GOOGLE_CLIENT_ID="[SEU_GOOGLE_CLIENT_ID]"
GOOGLE_CLIENT_SECRET="[SEU_GOOGLE_CLIENT_SECRET]"

# Chaves do Stripe
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY="[SUA_CHAVE_PUBLICAVEL_STRIPE]"
STRIPE_SECRET_KEY="[SUA_CHAVE_SECRETA_STRIPE]"
STRIPE_ESSENTIAL_PLAN_PRICE_ID="[ID_DO_PRECO_DO_PLANO_ESSENCIAL_NO_STRIPE]"
STRIPE_WEBHOOK_SECRET="[SEU_WEBHOOK]" # Use `npm run stripe:listen:dev` para obter um durante o desenvolvimento
NEXT_PUBLIC_STRIPE_CUSTOMER_PORTAL_URL="[URL_DO_SEU_PORTAL_DO_CLIENTE_STRIPE]"

# URL pública da sua aplicação
NEXT_PUBLIC_APP_URL="http://localhost:3000" # Ou a URL de produção

Importante: Nunca exponha suas chaves secretas e credenciais em repositórios públicos. O arquivo .env deve ser incluído no seu .gitignore.

📖 Uso

Após a instalação e configuração completa:

  1. Acesse a aplicação no seu navegador (normalmente http://localhost:3000).
  2. Crie uma conta ou faça login (inclusive com Google).
  3. Realize a assinatura de algum plano para usufruir do sistema. (utilize modo de testes da stripe para prosseguir em desenvolvimento).
  4. Crie sua própria clínica no sistema.
  5. Explore as funcionalidades de gerenciamento de médicos, pacientes e agendamentos.
  6. Acesse o dashboard para visualizar informações relevantes.

Para testar a integração com Stripe em desenvolvimento, você pode usar o comando:

npm run stripe:listen:dev

Isso irá encaminhar os webhooks do Stripe para sua aplicação local.

🤝 Contribuindo

Contribuições são o que fazem a comunidade open source um lugar incrível para aprender, inspirar e criar. Qualquer contribuição que você fizer será muito bem-vinda.

Se você tem alguma sugestão para melhorar este projeto, por favor, faça um fork do repositório e crie um pull request. Você também pode simplesmente abrir uma issue com a tag "enhancement". Não se esqueça de dar uma estrela ao projeto! Obrigado novamente! ⭐

  1. Faça um Fork do projeto (https://github.com/Gildaciolopes/doctor-schedule/fork)
  2. Crie sua Feature Branch (git checkout -b feature/AmazingFeature)
  3. Adicione suas mudanças (git add .)
  4. Comite suas mudanças (git commit -m 'Add some AmazingFeature')
  5. Faça o Push para a Branch (git push origin feature/AmazingFeature)
  6. Abra um Pull Request

As Pull Requests serão revisadas e, se alinhadas com os objetivos do projeto, poderão ser incorporadas.

Gildácio Lopes

📞 Contato

Gildácio Lopes - contato.gildaciolopes@gmail.com

Deploy do projeto: https://doctor-schedule-oz7u.vercel.app

About

SaaS de agendamentos para Clínicas

doctor-schedule-oz7u.vercel.app

Topics

react nodejs google node typescript clinic dashboard stripe reactjs nextjs postgresql prettier node-js doctor-appointment-management tailwindcss shadcn-ui drizzle-orm shadcn better-auth

Resources

Readme
Activity

Stars

25 stars

Watchers

0 watching

Forks

5 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages