a7med7c/rafiq

Purpose and deployable surfaces

Rafiq is a health-management platform for patients and family-managed health profiles: records/documents, medicines and reminders, appointments, emergency contacts, AI chat/voice assistance, notifications, reviews, and administration. It has:

• ASP.NET Core API entry point: src/Rafiq.API/Program.cs

• Angular browser client: RafiqAngular/src/main.ts

• Capacitor-packaged Angular mobile client: RafiqMobile/src/main.ts, with Android host RafiqMobile/android/app/src/main/java/com/rafiq/app/MainActivity.java

The Angular and mobile app trees are largely parallel; mobile adds device-oriented services and Capacitor native shells.

Backend layering and request boundary

The backend follows clean/CQRS-style separation:

• HTTP controllers expose feature APIs and mediate requests: src/Rafiq.API/Controllers/AuthController.cs, src/Rafiq.API/Controllers/PatientProfilesController.cs, src/Rafiq.API/Controllers/AiChatController.cs.

• Application commands, queries, handlers, validators, DTOs, and cross-cutting pipeline behaviors implement use cases: src/Rafiq.Application/Features/PatientProfiles, src/Rafiq.Application/Features/AiChat, src/Rafiq.Application/Common/Behaviors/ValidationBehavior.cs.

• Domain owns entities, enums, exceptions, and repository contracts: src/Rafiq.Domain/Entities, src/Rafiq.Domain/Repositories, src/Rafiq.Domain/Constants/Roles.cs.

• Infrastructure implements persistence and external integrations: src/Rafiq.Infrastructure/Persistence/RafiqDbContext.cs, src/Rafiq.Infrastructure/DependencyInjection.cs.

Program.cs and service-registration extensions compose these layers; API middleware centralizes exception mapping, user access restrictions, and Hangfire dashboard authorization.

Identity, authorization, and profile ownership

Authentication supports registration/login, refresh/revoke token lifecycle, password recovery, phone verification, and Google login. API/client boundaries attach and retain credentials through:

src/Rafiq.Application/Features/Auth, src/Rafiq.Infrastructure/Services/auth/IdentityService.cs, RafiqAngular/src/app/Interceptors/auth.interceptor.ts.

Health data is scoped to a patient health profile rather than simply an account. Family/caregiver sharing is modeled as profile access with invitations, roles, and access requests:

src/Rafiq.Domain/Entities/User/HealthProfileAccess.cs,

src/Rafiq.Application/Features/PatientProfiles,

src/Rafiq.Infrastructure/Services/HealthProfileAuthorizationService.cs.

Client route guards enforce authenticated, guest, and admin navigation states.

Clinical-data and scheduling workflows

Feature handlers manage appointments, allergies/chronic diseases, emergency contacts, prescriptions, imaging/lab/general documents, user medicines, and reminder definitions/logs. Key data model boundaries are:

src/Rafiq.Domain/Entities/Documents,

src/Rafiq.Application/Features/MedicineReminders,

src/Rafiq.Application/Features/MedicationReminderEngine.

Uploads are stored through a file-storage abstraction, currently with API-hosted upload directories and a local implementation:

src/Rafiq.Infrastructure/Services/LocalFileStorageService.cs,

src/Rafiq.API/wwwroot/uploads,

src/Rafiq.Application/Common/Interfaces/IFileStorageService.cs.

Medication and appointment changes schedule background work; due reminders can be confirmed, skipped, or snoozed and produce log records.

AI document, chat, and voice subsystem

AI is a first-class backend capability with access controls, telemetry, request classification, usage/audit operations, persisted conversations/messages, and health-profile-aware context:

src/Rafiq.Infrastructure/Services/Ai/InstrumentedAiChatService.cs,

src/Rafiq.Application/Features/AiChat/Services/HealthQueryContextBuilder.cs,

src/Rafiq.Domain/Entities/Chat/AiConversation.cs.

Document uploads for prescriptions, labs, imaging, medicine boxes, and general documents are analyzed asynchronously using specialized prompts/DTOs:

src/Rafiq.Application/AI/Prompts,

src/Rafiq.Infrastructure/Services/BackgroundJobs/DocumentAnalysisJob.cs,

src/Rafiq.Application/Features/GeneralDocuments/Commands/UploadGeneralDocumentAsync.

Voice interactions create sessions, process messages through an agent loop, and execute registered domain tools such as booking appointments or managing medicines:

src/Rafiq.Application/VoiceAgent/Agent/VoiceAgentLoop.cs,

src/Rafiq.Application/VoiceAgent/Tools/ToolRegistry.cs,

RafiqMobile/src/app/Services/voice-agent.service.ts.

Notifications, jobs, and external services

Hangfire-backed background jobs handle document analysis, chat processing/classification, missed appointments, and medication schedules:

src/Rafiq.Infrastructure/Services/BackgroundJobs,

src/Rafiq.Infrastructure/Services/MedicationReminders/MedicationReminderScheduler.cs,

src/Rafiq.API/Middleware/HangfireDashboardAuthorizationFilter.cs.

Real-time in-app notifications use SignalR hub and connection management:

src/Rafiq.Infrastructure/Services/Notifications/NotificationHub.cs,

src/Rafiq.Infrastructure/Services/Notifications/SignalRNotificationService.cs,

RafiqAngular/src/app/Services/signalr.service.ts.

Named integrations indicate AWS Bedrock for AI, Google token validation, and email/SMS/WhatsApp delivery (including Twilio settings):

src/Rafiq.Infrastructure/Services/BedrockService.cs,

src/Rafiq.Infrastructure/Services/auth/GoogleTokenValidator.cs,

src/Rafiq.Infrastructure/Services/Notifications/WhatsAppService.cs.

Client composition

Angular routes bootstrap public/auth/onboarding flows, authenticated health-management pages, AI UI, and a separate admin feature area:

RafiqAngular/src/app/app.routes.ts,

RafiqAngular/src/app/Pages/onboarding,

RafiqAngular/src/app/Features/admin/admin.routes.ts.

Client services form the API-facing boundary and maintain selected profile, token, notification, document-analysis, and localization state:

RafiqAngular/src/app/Services/profile-selection.service.ts,

RafiqAngular/src/app/Services/document-analysis-state.service.ts,

RafiqAngular/src/app/i18n/ar.ts.

The mobile variant additionally provides media-picker/download capabilities and native deployment through Capacitor.