Dr. Schedule 🩺📅

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:

• Frontend:
• Next.js (v15.3.2) - Framework React para produção.
• React (v19.0.0) - Biblioteca para construção de interfaces de usuário.
• Tailwind CSS (v4) - Framework CSS utility-first.
• Radix UI - Primitivas de UI acessíveis e não estilizadas.
• Lucide React - Ícones SVG.
• Shadcn/ui (implícito pelo uso de Radix e convenções)
• TanStack Query (React Query) - Gerenciamento de estado de servidor e data fetching.
• TanStack Table (React Table) - Tabelas agnósticas de UI.
• Recharts - Biblioteca de gráficos para React.
• React Hook Form - Gerenciamento de formulários.
• Zod - Validação de esquemas.
• Sonner - Notificações toast.
• date-fns / dayjs - Manipulação de datas.
• next-themes - Gerenciamento de temas (dark/light mode).
• Backend & Base de Dados:
• Next.js API Routes
• Drizzle ORM - ORM TypeScript.
• PostgreSQL - Banco de dados relacional (recomendado).
• Better Auth - Biblioteca de autenticação.
• Next Safe Action - Para Server Actions seguras.
• Pagamentos:
• Stripe - Plataforma de pagamentos online.
• Ferramentas de Desenvolvimento:
• TypeScript
• ESLint
• Prettier
• drizzle-kit - Ferramenta para migrações com Drizzle.

🚀 Começando

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

Pré-requisitos

• Node.js (versão LTS recomendada, ex: v20 ou superior)
• npm ou yarn ou pnpm
• Uma instância de banco de dados PostgreSQL rodando.
• Git

Instalação

1. Clone o repositório:

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

2. Instale as dependências:

   ```bash 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: bash 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: bash 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: bash 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