https://github.com/dnowdd/dr.agenda
O Dr. Agenda é uma plataforma para gestão eficiente de clínicas, com CRUD de médicos, pacientes, agendamentos, dashboard analítico e integração de assinaturas via Stripe. Construído com Next.js, Drizzle ORM e Tailwind CSS.
https://github.com/dnowdd/dr.agenda
appointment-scheduling clinic-management drizzle-orm fullstack healthcare medical-agenda nextjs postgresql react saas stripe tailwindcss typescript
Last synced: 4 months ago
JSON representation
O Dr. Agenda é uma plataforma para gestão eficiente de clínicas, com CRUD de médicos, pacientes, agendamentos, dashboard analítico e integração de assinaturas via Stripe. Construído com Next.js, Drizzle ORM e Tailwind CSS.
- Host: GitHub
- URL: https://github.com/dnowdd/dr.agenda
- Owner: Dnowdd
- License: mit
- Created: 2025-05-29T19:04:47.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-01T00:35:14.000Z (about 1 year ago)
- Last Synced: 2025-06-21T03:22:21.698Z (about 1 year ago)
- Topics: appointment-scheduling, clinic-management, drizzle-orm, fullstack, healthcare, medical-agenda, nextjs, postgresql, react, saas, stripe, tailwindcss, typescript
- Language: TypeScript
- Homepage:
- Size: 274 KB
- Stars: 6
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Dr. Agenda 🩺📅
  
**Dr. Agenda** é 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.
Este projeto foi desenvolvido com base nos aprendizados do curso pago **FullStackClub**, com significativas modificações e adições pessoais para atender a requisitos específicos e implementar funcionalidades desejadas.
---
## 🌟 Sobre o Projeto
O Dr. Agenda 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](https://nextjs.org/) (v15.3.2) - Framework React para produção.
- [React](https://react.dev/) (v19.0.0) - Biblioteca para construção de interfaces de usuário.
- [Tailwind CSS](https://tailwindcss.com/) (v4) - Framework CSS utility-first.
- [Radix UI](https://www.radix-ui.com/) - Primitivas de UI acessíveis e não estilizadas.
- [Lucide React](https://lucide.dev/) - Ícones SVG.
- [Shadcn/ui](https://ui.shadcn.com/) (implícito pelo uso de Radix e convenções)
- [TanStack Query (React Query)](https://tanstack.com/query/latest) - Gerenciamento de estado de servidor e data fetching.
- [TanStack Table (React Table)](https://tanstack.com/table/latest) - Tabelas agnósticas de UI.
- [Recharts](https://recharts.org/) - Biblioteca de gráficos para React.
- [React Hook Form](https://react-hook-form.com/) - Gerenciamento de formulários.
- [Zod](https://zod.dev/) - Validação de esquemas.
- [Sonner](https://sonner.emilkowal.ski/) - 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](https://nextjs.org/docs/api-routes/introduction)
- [Drizzle ORM](https://orm.drizzle.team/) - ORM TypeScript.
- [PostgreSQL](https://www.postgresql.org/) - Banco de dados relacional (recomendado).
- [Better Auth](https://github.com/LukyVj/better-auth) - Biblioteca de autenticação.
- [Next Safe Action](https://next-safe-action.dev/) - Para Server Actions seguras.
- **Pagamentos:**
- [Stripe](https://stripe.com/) - Plataforma de pagamentos online.
- **Ferramentas de Desenvolvimento:**
- [TypeScript](https://www.typescriptlang.org/)
- [ESLint](https://eslint.org/)
- [Prettier](https://prettier.io/)
- `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](https://nodejs.org/) (versão LTS recomendada, ex: v20 ou superior)
- [npm](https://www.npmjs.com/) ou [yarn](https://yarnpkg.com/) ou [pnpm](https://pnpm.io/)
- Uma instância de banco de dados [PostgreSQL](https://www.postgresql.org/download/) rodando.
- [Git](https://git-scm.com/)
### Instalação
1. **Clone o repositório:**
```bash
git clone git@github.com:Dnowdd/Dr.Agenda.git
cd Dr.Agenda
```
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](#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](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:
```env
# 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_SEU_PLANO_ESSENCIAL_NO_STRIPE]"
STRIPE_WEBHOOK_SECRET="[SEU_SEGREDO_DO_WEBHOOK_STRIPE]" # 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:
```bash
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/Dnowdd/Dr.Agenda/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.
---
## 📜 Licença
Este projeto é distribuído sob a Licença MIT. Veja o arquivo LICENSE para mais informações, ou leia abaixo:
```
MIT License
Copyright (c) 2025 David Aquino Queiroz
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```
## David Queiroz
## 📞 Contato
David Queiroz - david.queiroz@dnowdd.com
Link do Projeto: https://github.com/Dnowdd/Dr.Agenda
---
## 🙏 Agradecimentos
FullStackClub: Pelo conhecimento base fornecido através do curso.