How dilom21/clinica-oftalmologica-api works
This is a FastAPI backend for an ophthalmology clinic. Users authenticate and are authorized before using patient, appointment, and clinical-record workflows; the broader module tree also covers inventory, payments, administrative reporting, and patient interaction. Sampled routes call domain services, which use repositories and SQLAlchemy models; shared dependencies provide database sessions and role/permission checks. The README is empty, so several product capabilities are identified from module names only; their internal flows are not asserted.
Main entry points: main.py API application · api/router.py User and auth API · auth_service.py Login service · api/router.py Appointment API
Components 25
Platform
- API application
app/main.py - Runtime configuration
app/core/config.py - Database sessions
app/database/session.py - Relational database
Identity & Access
- Auth dependencies
app/core/dependencies.py - Token security
app/core/security.py - User and auth API
app/modules/gestion_usuarios_seguridad/api/router.py - Login service
app/modules/gestion_usuarios_seguridad/services/auth_service.py - User and role data
app/modules/gestion_usuarios_seguridad/repositories/repository.py
Patient Care
- Patient API
app/modules/gestion_pacientes/api/router.py - Patient service
app/modules/gestion_pacientes/services/service.py - Patient records
app/modules/gestion_pacientes/repositories/repository.py - Appointment API
app/modules/gestion_agenda_citas/api/router.py - Appointment services
app/modules/gestion_agenda_citas/services/citas.py - Schedule and availability
app/modules/gestion_agenda_citas/services/service.py - Appointment data
app/modules/gestion_agenda_citas/repositories/repository.py - Clinical record API
app/modules/gestion_historial_clinico/api/router.py - Clinical record service
app/modules/gestion_historial_clinico/services/service.py - Clinical record data
app/modules/gestion_historial_clinico/repositories/repository.py
Clinic Operations
- Inventory and suppliers
app/modules/gestion_inventario_proveedores - Payments
app/modules/gestion_pagos - Reports and dashboard
app/modules/reportes_panel_administrativo
Patient Engagement
- Notifications and chatbot
app/modules/notificaciones_interaccion_chatbot - Email delivery
app/shared/services/email_service.py
Other components
- Clinic user
Connections 22
- Clinic user → API application: uses API
- API application → User and auth API: registers routes
app/main.py - API application → Patient API: registers routes
app/main.py - API application → Clinical record API: registers routes
app/main.py - API application → Appointment API: registers routes
app/main.py - User and auth API → Login service: calls login
app/modules/gestion_usuarios_seguridad/api/router.py - Login service → User and role data: looks up user
app/modules/gestion_usuarios_seguridad/services/auth_service.py - Login service → Token security: verifies and issues token
app/modules/gestion_usuarios_seguridad/services/auth_service.py - User and auth API → Auth dependencies: requires permissions
app/modules/gestion_usuarios_seguridad/api/router.py - Auth dependencies → Database sessions: opens session
app/core/dependencies.py - Database sessions → Relational database: connects
app/database/session.py - Patient API → Patient service: calls
app/modules/gestion_pacientes/api/router.py - Patient service → Patient records: uses repository
app/modules/gestion_pacientes/services/service.py - Appointment API → Appointment services: calls
app/modules/gestion_agenda_citas/api/router.py - Appointment API → Schedule and availability: calls
app/modules/gestion_agenda_citas/api/router.py - Appointment services → Appointment data: uses repository
app/modules/gestion_agenda_citas/services/citas.py - Schedule and availability → Appointment data: reads schedules
app/modules/gestion_agenda_citas/services/service.py - Clinical record API → Clinical record service: calls
app/modules/gestion_historial_clinico/api/router.py - Clinical record service → Clinical record data: uses repository
app/modules/gestion_historial_clinico/services/service.py - Clinical record service → Appointment data: checks and updates visit
app/modules/gestion_historial_clinico/services/service.py - Runtime configuration → Database sessions: configures database
- Email delivery → Runtime configuration: loads mail settings
app/shared/services/email_service.py