Summary
Kyjuanbrown is a healthcare-focused backend platform built to manage patient records, provider data, visit history, appointment workflows, recall operations, staff activity, and dashboard reporting from one secure and structured system.
Kyjuanbrown
Backend system for patient management, visit tracking, appointment scheduling, recall workflows, role permissions, dashboard analytics, and operational reporting.
Kyjuanbrown is a healthcare-focused backend platform built to manage patient records, provider data, visit history, appointment workflows, recall operations, staff activity, and dashboard reporting from one secure and structured system.
FastAPIPythonREST APIsJWT AuthenticationAsync API DesignRender Deployment
Project Status delivered
Duration 3 months
Model Backend Case Study
Duration 3 months
Model Backend Case Study
Project Overview
A backend-first summary of the product problem and the solution direction behind the full project delivery.
Problem
The client needed a reliable backend system to manage patients, visits, appointments, call outcomes, recall follow-ups, staff roles, and dashboard visibility without depending on scattered spreadsheets or manual tracking. The platform also needed secure access control and scalable APIs for daily healthcare operations.
Solution
I developed a FastAPI-based backend with modular APIs for authentication, role-based permissions, patient management, provider management, visit records, appointment scheduling, recall call tracking, status workflows, dashboard summaries, search, filtering, and pagination. Redis-backed OTP support, JWT security, Tortoise ORM models, Dockerized deployment, and Nginx reverse proxy support were used to make the system clean, secure, and production-ready.
Project Architecture
A single system architecture snapshot preserved as proof of the delivery design and implementation flow.
Technology Stack
The stack used across the full build, covering service logic, data storage, infrastructure, cloud setup, frontend integration points, and delivery tooling.
Backend
FastAPIPythonREST APIsJWT AuthenticationAsync API Design
Cloud
Render DeploymentVPS HostingLinux ServerDomain & Reverse Proxy Setup
Database
SQL DatabaseTortoise ORMAerich MigrationsRedis
Frontend
Admin DashboardHealthcare Operations Dashboard
Infrastructure
DockerDocker ComposeNginxVPS Deployment
Integrations
Email / OTP FlowDashboard API IntegrationHealthcare Workflow APIs
Tools
GitGitHubPostmanSwagger/OpenAPI
Key Features
The core capabilities were implemented as production-facing modules, shaped for real usage, maintainability, and future scale.
Feature 01
Authentication & Authorization
Secure login, protected endpoints, JWT access tokens, and refresh-token based session handling.
Feature 02
Role-Based Access Control
Permission-aware access for admins, managers, agents, and operational users.
Feature 03
User & Permission Management
Backend structure for managing users, groups, permissions, reporting hierarchy, and active staff access.
Feature 04
OTP Verification
Redis-backed OTP verification flow with expiration, retry control, and secure short-lived validation.
Feature 05
Patient Management
Structured patient APIs for creating, updating, searching, filtering, and managing patient records.
Feature 06
Patient Contact Management
Support for patient phone, email, address, and communication-related contact information.
Feature 07
Patient Status Tracking
Operational status flow including not started, contacted, interested, not interested, booked, declined, and call-back-later states.
Feature 08
Patient Priority Management
Priority-based patient classification using high, medium, and low priority levels.
Feature 09
Provider Management
Provider records for connecting patient visits and appointments with healthcare professionals.
Feature 10
Visit Management
Visit history tracking with completed, missed, canceled, and declined visit statuses.
Feature 11
Appointment Scheduling
Appointment APIs for scheduling, updating, canceling, completing, and tracking patient appointments.
Feature 12
Recall Workflow
Recall-ready patient follow-up system for call tracking, interest level, outcome notes, and next-step visibility.
Feature 13
Call Data Management
Call outcome records for tracking agent communication, patient interest, callback needs, and appointment conversion.
Feature 14
Dashboard Summary View
Admin summary endpoints for patients, appointments, visits, recalls, staff activity, and operational KPIs.
Feature 15
Agent Workflow Support
Agent-focused APIs for managing assigned patients, call progress, appointment updates, and recall outcomes.
Feature 16
Manager Oversight
Manager-level visibility into staff performance, patient progress, call activity, and appointment conversion.
Feature 17
Admin Panel Support
Backend APIs powering centralized controls for users, patients, providers, visits, appointments, and reporting.
Feature 18
Search, Filtering & Pagination
Optimized list APIs for patients, appointments, visits, users, providers, and call records.
Feature 19
Status-Based Reporting
Dashboard-ready data grouped by patient status, visit status, appointment status, priority, and agent activity.
Feature 20
Production Deployment Support
Dockerized backend structure with environment-based settings, Nginx routing, and server-ready configuration.
Challenges & Solutions
The main engineering tradeoffs handled during delivery instead of being deferred into post-launch cleanup.
Production Tradeoff
Complex patient workflow management
Resolved
- Challenge: Patient records needed to move through multiple operational states such as contacted, interested, booked, declined, and callback later without losing context.
- Solution: Designed clear patient status and priority flows so agents and managers could track every patient stage consistently from the dashboard.
Production Tradeoff
Appointment and visit consistency
Resolved
- Challenge: Appointments, providers, visits, patient statuses, and call outcomes needed to stay connected across different operational actions.
- Solution: Built separate but connected modules for appointments, visits, providers, patients, and call data to keep the healthcare workflow traceable and extendable.
Production Tradeoff
Recall and follow-up tracking
Resolved
- Challenge: The team needed a reliable way to track patient recall calls, interest level, outcomes, and next steps without manual spreadsheets.
- Solution: Implemented recall-focused call data models and APIs so follow-up activity could be recorded, filtered, reviewed, and reported from the dashboard.
Production Tradeoff
Role-based operational security
Resolved
- Challenge: Admins, managers, agents, and staff needed different access levels for sensitive patient and operational data.
- Solution: Applied JWT authentication, role-based access control, group permissions, and protected endpoint boundaries for secure healthcare operations.
Production Tradeoff
Large patient dataset handling
Resolved
- Challenge: Patient, appointment, visit, and call records could become difficult to load and manage as data increased.
- Solution: Used pagination, filtering, searchable APIs, indexed query paths, and optimized ORM access patterns for smoother dashboard performance.
Production Tradeoff
Dashboard reporting accuracy
Resolved
- Challenge: The dashboard needed reliable summaries for patient statuses, agent activity, appointments, visits, recall progress, and operational performance.
- Solution: Created summary-ready API structures that aggregate healthcare workflow data into clean dashboard metrics and reporting views.
Production Tradeoff
Deployment reliability
Resolved
- Challenge: The backend needed to run consistently across development, staging, and production environments.
- Solution: Prepared Docker-based deployment, environment configuration, database migration support, and Nginx reverse proxy setup for stable production delivery.
Performance Optimizations
Optimized the backend for faster response times, steadier throughput, and more predictable behavior under production traffic.
- Async FastAPI endpoints
- Redis-backed OTP and short-lived workflow data
- Database indexing for searchable patient and appointment records
- Pagination for patient, visit, appointment, provider, and call-data lists
- Optimized query paths for dashboard summary APIs
- Connection pooling
- Reusable service-layer structure
- Separated auth, patient, visit, appointment, and recall modules
- Status-based filtering for operational dashboards
- Nginx reverse proxy for production routing
- Dockerized deployment workflow
- Environment-based configuration
- Swagger/OpenAPI documentation for faster API testing
Security Measures
Applied practical safeguards across authentication, validation, permissions, and transport security to protect the platform in production.
- JWT authentication
- Password hashing
- Role-based permissions
- Group-based access control
- Protected admin endpoints
- Protected patient data endpoints
- Input validation
- CORS protection
- Environment-based secret management
- OTP expiration and retry control
- Permission-aware dashboard actions
- Restricted privileged operations
CI/CD Pipeline Flow
Releases stay repeatable through a clear path from source control to health-checked production deployment.
GitHub Push
Backend Build
Environment Configuration
Database Migration
Docker Image Build
Docker Compose Deploy
Nginx Reverse Proxy
Health Check
Screenshots Gallery
Representative product surfaces supported by the APIs, workflows, and operational foundations built for the project.
Related Projects
Other projects with similar concerns around architecture, deployment, permissions, and scalability.
Subscription-based multi-role SaaS backend with authentication, billing, notifications, coupons, savings, support messaging, and admin operations.
FastAPI • Tortoise ORM • Aerich Migrations • JWT Authentication • REST APIs • Background Tasks • Modular Service Architecture • Stripe • Firebase Cloud Messaging • SMTP Email Service • PostgreSQL • Redis • SaaS Dashboard • Admin Panel • Notification UI • Support Messaging UI • Docker • Docker Compose • Nginx • GitHub Actions • Docker Hub • Health Checks • VPS Hosting • Git • Postman • Swagger/OpenAPI • Linux Server
Open projectSubscription-based audio journaling backend with secure authentication, recording uploads, admin controls, real-time notifications, and billing workflows.
FastAPI • Tortoise ORM • JWT • WebSocket • Stripe • Firebase • Storage Services • MySQL/SQLite • Redis • Admin Dashboard • Client App • Docker • APScheduler • Nginx • Git • Postman • Swagger/OpenAPI
Open project