ClinicFlow is a comprehensive clinic management backend built with .NET 10, Clean Architecture, and Domain-Driven Design. It provides a rich domain model for managing the full lifecycle of medical appointments — from scheduling and rescheduling to check-in, in-progress encounters, and completion — while enforcing business rules for each actor (patient, doctor, and staff).Documentation Index
Fetch the complete documentation index at: https://mintlify.com/0Crazy-0/ClinicFlow/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Get ClinicFlow running locally with Docker and PostgreSQL in minutes
Architecture
Understand the Clean Architecture layers, DDD aggregates, and CQRS patterns
Appointments
Explore the full appointment lifecycle: schedule, reschedule, check-in, and complete
API Reference
Browse all CQRS commands and queries with parameters and return types
What ClinicFlow Provides
ClinicFlow handles the operational core of a medical clinic through a rich domain model backed by PostgreSQL.Appointment Scheduling
Role-based scheduling with availability checks, overbooking, and specialty restrictions
Penalty System
Automated progressive warnings and temporary booking blocks for no-shows and late cancellations
Doctor Schedules
Weekly recurring availability slots per doctor, with deactivation and reassignment workflows
Medical Records
Structured clinical encounter records with dynamic form templates per appointment type
Patient Management
Primary patients and family members linked to a user account, with medical profiles
Users & Auth
JWT auth with phone verification, account lockout, and four distinct user roles
How It’s Built
ClinicFlow follows strict architectural principles to keep business logic isolated and testable.Domain Layer
Contains entities (
Appointment, Doctor, Patient, Schedule, MedicalRecord), value objects, domain events, and domain services. No external dependencies — pure C#.Application Layer
Orchestrates use cases via MediatR commands and queries. FluentValidation pipeline behavior validates every request before it reaches the handler.
ClinicFlow is under active development. The domain model, services, and application layer are feature-complete and comprehensively tested. An HTTP API presentation layer is forthcoming.