How atharva2001/doctors-gallery works
Project type and purpose
• This is a microservices-based Doctor-Patient appointment platform.
• It comprises three standalone Python REST APIs—auth_service, core_services, and appointment_service—each containerized via Docker and orchestrated with docker-compose.
File structure
• Top-level files:
• docker-compose.yaml → defines multi-container orchestration and networking
• .gitignore / .dockerignore / LICENSE / README.md
• Services directories:
• auth_service/
– Dockerfile, main.py
– app/routes/ (login.py, register.py)
– app/model/ (User.py, Login.py)
– app/database/ (core.py, init.sql, register.py, login.py)
– app/common_utils/ (jwt_utils, log_utils, password_hash)
• core_services/
– Dockerfile, main.py
– app/routes/ (doctors.py, patients.py)
– app/models/ (users.py)
– app/database/ (core.py, doctors.py, patients.py)
• appointment_service/
– Dockerfile, main.py
– app/routes/appointment.py
– app/model/ (appointment.py, slots.py)
– app/database/ (core.py, appointment.py, slots.py)
– appointment.db (SQLite file)
• Common pattern: each service has its own code, DB layer, models, and HTTP routes.
README for additional insights
• Confirms the domain: “Doctor-Patient appointment platform.”
• Clients (Web/Mobile)
• auth_service container + User DB
• core_services container + Doctor/Patient DB
• appointment_service container + Appointment DB
• docker-compose network overlay
b. Relationships & interactions:
• Client → auth_service (POST /register, POST /login)
• Client → core_services (GET /doctors, GET /patients)
• Client → appointment_service (GET/POST /appointments)
• appointment_service → core_services (to verify doctor/patient IDs)
• appointment_service & core_services → auth_service (to verify JWT)
c. Architectural patterns & design principles:
• Microservices for bounded contexts
• Database-per-service for data autonomy
• RESTful APIs with clear route separation
• Containerization (Docker) + docker-compose for local orchestration
d. Key technologies & libraries:
• Python + Flask or FastAPI (app/routes structure)
• SQLAlchemy or direct SQLite (app/database modules)
• JSON Web Tokens (auth_service/common_utils/jwt_utils)
• Docker / docker-compose