[EN] | [PT]

🏥 Clinic SaaS

📝 Table of Contents

• Description
• Features
• Technologies
• Installation
• Usage
• Demo / Mock Mode
• Contributions
• License
• Contact

📖 Description

Clinic SaaS is a fullstack application designed for end-to-end management of medical clinics and health centers. It includes scheduling, patient records, clinical workflows, operations, and a patient portal.

✅ Features

• Role-based authentication (Admin, Doctor, Receptionist, Patient) with JWT; optional email 2FA on backend
• Admin dashboard with KPIs, charts, and alerts
• Patients CRUD with status control and full medical record (notes, evolutions, prescriptions, documents, authorizations)
• Appointments agenda with filters, creation/editing, check-in workflow, and attend screen
• Waiting list (queue) with status changes and filters
• Professionals and rooms management
• Health insurance (convênios) management and authorization requests
• Inventory (stock) management
• Patient portal with appointments, prescriptions, documents, receipts, and history
• AI clinical assistant panel during attendance
• Financial module scaffold (UI placeholder)

🧠 AI-Assisted Anamnesis

The system includes a smart AI-assisted anamnesis feature that supports clinical intake with dynamic suggestions and summaries during attendance.

Features:

• Dynamic question prompts based on the consultation context
• Support for structured fields and free text
• Automatic summarization of key findings
• Designed to speed up documentation during care

Example: When starting a consultation for abdominal pain, the system suggests diagnostic-oriented questions, such as presence of fever, pain characteristics, dietary history, and current medications. The AI summarizes the answers and highlights potential clinical hypotheses.

🛠 Technologies

Backend

• Python 3.11+
• FastAPI
• PostgreSQL
• SQLAlchemy + Alembic
• Redis
• Pydantic v2
• JWT Auth

Frontend

• Node.js v18+
• Next.js 13+ (App Router)
• TypeScript
• TailwindCSS
• shadcn/ui
• Zod
• SWR

DevOps

• Docker + Docker Compose
• Minio (S3 compatible storage)
• Nginx (optional)

⚙ Installation

Prerequisites

• Docker & Docker Compose installed
• .env file configured properly for backend and frontend

Step-by-step

# Clone the repository
git clone https://github.com/matfurrier/clinicmanager.git
cd clinicmanager

# Start services
docker-compose up --build

The app will be available at:

• Frontend: http://localhost:3000
• Backend: http://localhost:8000/docs (FastAPI Swagger UI)

🎮 Usage

Once running:

1. Admin user can log in via /login and configure:

   • Professionals and specialties
   • Rooms and clinic structure
   • Health insurances (convênios)
   • Inventory items

2. Patients can access the portal at /portal/:patientId to view:

   • Upcoming appointments
   • Prescriptions, medical documents, and receipts
   • Full history and authorization requests

3. Doctors can:

   • Access patient records, clinical notes, and evolutions
   • Attend appointments, finalize status, and register evolutions
   • Generate prescriptions and medical documents

4. Reception can:

   • Manage the waiting list and check-ins
   • Handle appointments and patient flow

5. The financial module UI is present but currently disabled (placeholder).

🧪 Demo / Mock Mode

The frontend supports MSW-based API mocking for demos.

1. Set NEXT_PUBLIC_API_MOCKING=enabled in the frontend environment.
2. Use demo credentials:
   • admin@admin.com / admin123
   • user@demo.com / admin123
   • moderator@demo.com / admin123

🤝 Contributions

Contributions, issues and feature requests are welcome!
Feel free to check the issues page.

📄 License

This project is licensed under the MIT License. See the LICENSE file for more details.

📬 Contact

Mateus Furrier - matfurrier@gmail.com
Project Link: https://www.furrierlabs.com.br/clinicsaas

If this project helped you, give it a ⭐️!

---

🇧🇷 PT - Versão em Português

📝 Índice

• Descrição
• Funcionalidades
• Tecnologias
• Instalação
• Uso
• Modo Demo / Mock
• Contribuições
• Licença
• Contato

📖 Descrição

Clinic SaaS é uma aplicação fullstack para a gestão completa de clínicas médicas e centros de saúde. Inclui agendamento, prontuário, operações clínicas e portal do paciente.

✅ Funcionalidades

• Autenticação com perfis (Admin, Médico, Recepção, Paciente) e JWT; 2FA por email no backend
• Dashboard com KPIs, gráficos e alertas
• Cadastro de pacientes com controle de status e prontuário completo (anotações, evoluções, prescrições, documentos, autorizações)
• Agenda com filtros, criação/edição, check-in e tela de atendimento
• Fila de espera com atualização de status e filtros
• Gestão de profissionais e salas
• Gestão de convênios e solicitações de autorização
• Gestão de estoque
• Portal do paciente com consultas, prescrições, documentos, recibos e histórico
• Assistente clínico com IA durante o atendimento
• Módulo financeiro em modo placeholder (UI desativada)

🧠 Anamnese com IA

O sistema oferece um recurso de anamnese assistida por IA que apoia o atendimento com perguntas e resumos dinâmicos durante a consulta.

Funcionalidades:

• Geração dinâmica de perguntas conforme o contexto da consulta
• Compatível com campos estruturados e texto livre
• Resumo automático dos principais achados
• Focado em acelerar a documentação clínica

Exemplo de uso: Ao iniciar uma consulta de dor abdominal, o sistema sugere perguntas clínicas orientadas para diagnóstico diferencial, como presença de febre, tipo da dor, histórico alimentar e uso de medicamentos. A IA resume as respostas e destaca possíveis hipóteses clínicas.

🛠 Tecnologias

Backend

• Python 3.11+
• FastAPI
• PostgreSQL
• SQLAlchemy + Alembic
• Redis
• Pydantic v2
• JWT Auth

Frontend

• Node.js v18+
• Next.js 13+ (App Router)
• TypeScript
• TailwindCSS
• shadcn/ui
• Zod
• SWR

DevOps

• Docker + Docker Compose
• Minio (armazenamento compatível com S3)
• Nginx (opcional)

⚙ Instalação

Pré-requisitos

• Docker e Docker Compose instalados
• Arquivo .env configurado corretamente

Passo a passo

# Clonar o repositório
git clone https://github.com/matfurrier/clinicmanager.git
cd clinicmanager

# Iniciar os serviços
docker-compose up --build

O sistema estará disponível em:

• Frontend: http://localhost:3000
• Backend: http://localhost:8000/docs (FastAPI Swagger UI)

🎮 Uso

Após iniciar:

1. O administrador acessa /login e configura:

   • Profissionais e especialidades
   • Salas e estrutura da clínica
   • Convênios
   • Itens de estoque

2. Os pacientes podem acessar o portal em /portal/:patientId para:

   • Ver consultas futuras
   • Acessar prescrições, documentos médicos e recibos
   • Consultar histórico e autorizações

3. Os médicos podem:

   • Acessar prontuário, anotações e evoluções
   • Atender consultas, finalizar atendimentos e registrar evoluções
   • Gerar prescrições e documentos

4. A recepção pode:

   • Gerenciar a fila de espera e check-ins
   • Controlar o fluxo de atendimentos

5. O módulo financeiro está presente, porém desativado (placeholder).

🧪 Modo Demo / Mock

O frontend suporta mocks via MSW para demonstração.

1. Defina NEXT_PUBLIC_API_MOCKING=enabled no ambiente do frontend.
2. Use as credenciais de demonstração:
   • admin@admin.com / admin123
   • user@demo.com / admin123
   • moderator@demo.com / admin123

🤝 Contribuições

Sugestões, issues e pull requests são bem-vindos!
Confira em: https://github.com/matfurrier/clinicmanager/issues

📄 Licença

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

📬 Contato

Mateus Furrier - matfurrier@gmail.com
Link do Projeto: https://www.furrierlabs.com.br/clinicsaas

Se esse projeto te ajudou, deixe uma ⭐️!