---

🏥 Aegis Suite — Clinic Management System

A full-stack, enterprise-grade Clinic Management System featuring a dark-themed glassmorphism UI, multi-threaded Java backend, real-time telemetry dashboard, role-based access control, and comprehensive patient EMR management.

---

📸 Overview

Aegis Suite is a Single Page Application (SPA) designed for modern healthcare clinics. It provides a unified platform for managing patients, doctors, appointments, prescriptions, billing, and real-time system diagnostics — all accessible through an elegant, premium dark-mode interface with glass-morphism design elements.

---

✨ Key Features

🔐 Authentication & Authorization

• Dual-Portal Login — Split login panel with separate Staff Login and Patient Login tabs
• Staff Registration — Register as Doctor, Receptionist, or Administrator with role-specific fields (e.g., medical specialty for doctors)
• Patient Sign-Up — Self-service patient registration with demographics, blood type, and secure passwords
• Forgot Password — Self-service password reset pipeline via email/username lookup
• Role-Based Access Control (RBAC) — Patients see a restricted dashboard; staff get full clinical tools

👥 Patient EMR Directory

• Consolidated 6-Column Master Index — Dense, responsive patient table with:
  • Patient Info (Name, ID, Registration Date)
  • Contact & Demographics (Gender, Age, Phone, Email)
  • Blood Type (color-coded badge)
  • Active Alerts (allergies & chronic conditions)
  • Vitals Trend (SVG sparkline charts)
  • Quick Actions (View, Edit, Delete)
• Full CRUD Operations — Add, edit, view, and retire patient records
• Real-Time Search & Filtering — Instant patient lookup across all fields

📅 Appointment Scheduler

• Interactive Calendar View — Visual scheduling with day/week/month navigation
• Live Clinical Queue — Drag-and-drop Kanban board for appointment status tracking
• Doctor Availability — Schedule appointments based on doctor specialties and availability

💊 Prescription Management

• Medication Records — Track drug names, dosages, frequencies, and durations
• Doctor-Patient Linking — Each prescription is tied to a specific doctor and patient
• Active Treatment Dashboard — View all active prescriptions at a glance

💰 Billing & Financial Ledger

• Invoice Generation — Create itemized bills with multiple line items
• Payment Status Tracking — Track paid, pending, and overdue invoices
• Financial Overview — Dashboard summaries of total revenue, outstanding amounts, and overdue notices

📊 Enterprise Telemetry Dashboard

• Real-Time System Metrics — Live monitoring of:
  • JVM Heap Memory Usage
  • Active Thread Count
  • Server Uptime
  • Total API Requests Served
  • Average Response Time
  • Database Record Count
• Glassmorphism Telemetry Cards — Responsive 4-column grid with color-coded accent borders
• SVG Sparkline Analytics — Inline vitals trend visualizations for patient records

🎨 Premium UI/UX

• Dark Mode Glassmorphism — Frosted glass panels with backdrop blur effects
• Lucide Icon Integration — Crisp, modern iconography throughout the interface
• Micro-Animations — Smooth hover effects, transitions, and interactive feedback
• Fully Responsive — Adapts from desktop to tablet to mobile viewports

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                    CLIENT (Browser SPA)                      │
│                                                             │
│   index.html ──── styles.css ──── app.js                    │
│                                   analytics.js              │
│                                   scheduler.js              │
│                                                             │
│   ┌─────────────┐  ┌──────────┐  ┌───────────────────┐     │
│   │ Auth Portal │  │ Dashboard│  │ EMR Patient Index  │     │
│   │ (Login/     │  │ (Stats & │  │ (CRUD Table +      │     │
│   │  Signup/    │  │  Tele-   │  │  Sparklines)       │     │
│   │  Forgot PW) │  │  metry)  │  │                    │     │
│   └─────────────┘  └──────────┘  └───────────────────┘     │
│   ┌─────────────┐  ┌──────────┐  ┌───────────────────┐     │
│   │ Scheduler   │  │ Prescrip-│  │ Billing & Ledger  │     │
│   │ (Calendar + │  │ tions    │  │ (Invoices +        │     │
│   │  Kanban)    │  │          │  │  Payments)         │     │
│   └─────────────┘  └──────────┘  └───────────────────┘     │
└──────────────────────┬──────────────────────────────────────┘
                       │  HTTP REST API (JSON)
                       ▼
┌─────────────────────────────────────────────────────────────┐
│              JAVA BACKEND (com.sun.net.httpserver)           │
│                                                             │
│   ClinicServer.java ─── Multi-threaded HTTP Server          │
│   │                     (CachedThreadPool on port 8081)     │
│   │                                                         │
│   ├── StaticFileHandler  → Serves /public/* assets          │
│   └── ApiHandler         → RESTful JSON endpoints           │
│       ├── /api/patients        (GET, POST, PUT, DELETE)     │
│       ├── /api/doctors         (GET, POST, PUT, DELETE)     │
│       ├── /api/appointments    (GET, POST, PUT, DELETE)     │
│       ├── /api/prescriptions   (GET, POST, PUT, DELETE)     │
│       ├── /api/billing         (GET, POST, PUT, DELETE)     │
│       ├── /api/dashboard       (GET – telemetry metrics)    │
│       ├── /api/login           (POST – authentication)      │
│       ├── /api/register        (POST – user registration)   │
│       └── /api/forgot-password (POST – password reset)      │
│                                                             │
│   Database.java ─── Data Persistence Layer                  │
│   Logger.java   ─── Request/Response Logging                │
└──────────────────────┬──────────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────────────┐
│                 DATA PERSISTENCE                            │
│                                                             │
│   📄 clinic_database.json  (JSON flat-file storage)         │
│   🗄️ clinic.db             (SQLite database)                │
└─────────────────────────────────────────────────────────────┘

---

📂 Project Structure

CLINIC MANAGEMENT SYSTEM/
│
├── 📄 README.md                          # This file
├── 📄 compile.bat                        # Java compilation script
├── 📄 run.bat                            # Server launch script (compile + run)
│
├── 📁 data/                              # Persistent data storage
│   ├── clinic_database.json              # JSON flat-file database
│   └── clinic.db                         # SQLite database
│
├── 📁 lib/                               # Java dependencies (bundled)
│   ├── gson.jar                          # Google Gson – JSON serialization
│   ├── sqlite-jdbc.jar                   # SQLite JDBC driver
│   ├── slf4j-api-2.0.9.jar              # SLF4J logging API
│   └── slf4j-simple-2.0.9.jar           # SLF4J simple implementation
│
├── 📁 public/                            # Frontend SPA assets
│   ├── index.html                        # Main SPA entry point (1100+ lines)
│   ├── 📁 css/
│   │   └── styles.css                    # Full design system & glassmorphism theme
│   └── 📁 js/
│       ├── app.js                        # Core SPA logic, routing, CRUD, auth
│       ├── analytics.js                  # SVG sparkline chart engine
│       └── scheduler.js                  # Calendar & appointment scheduling
│
├── 📁 src/main/java/com/clinic/          # Java backend source
│   ├── ClinicServer.java                 # HTTP server, API routing, handlers
│   ├── Database.java                     # Data access layer & persistence
│   ├── Logger.java                       # Request/response logging utility
│   └── 📁 models/                        # Data model POJOs
│       ├── Patient.java                  # Patient entity (vitals, allergies, etc.)
│       ├── Doctor.java                   # Doctor entity (specialty, schedule)
│       ├── Appointment.java              # Appointment entity
│       ├── Prescription.java             # Prescription entity (medications)
│       ├── Billing.java                  # Billing/invoice entity (line items)
│       └── User.java                     # Authentication user entity
│
└── 📁 target/classes/                    # Compiled Java .class files

---

🚀 Getting Started

Prerequisites

Requirement	Version
Java JDK	11 or higher
Operating System	Windows 10/11
Browser	Chrome, Edge, Firefox (modern)

No Maven, Gradle, or Node.js required! All dependencies are bundled in the lib/ folder.

Installation & Launch

1. Clone the repository

git clone https://github.com/silentguyracer/CLINIC-MANAGEMENT-SYSTEM-.git
cd CLINIC-MANAGEMENT-SYSTEM-

2. Run the application

.\run.bat

This will:

• ✅ Compile all Java source files
• ✅ Start the multi-threaded HTTP server
• ✅ Serve the frontend on http://localhost:8081

3. Open in browser

http://localhost:8081

---

🔑 Default Login Credentials

Portal	Username / Email	Password
Staff Login	admin	admin123
Patient Login	(Register via Sign Up)	(Your password)

---

🛠️ API Endpoints

Method	Endpoint	Description
GET	/api/patients	List all patients
POST	/api/patients	Create a new patient
PUT	/api/patients	Update patient record
DELETE	/api/patients?id={id}	Delete a patient
GET	/api/doctors	List all doctors
POST	/api/doctors	Add a new doctor
GET	/api/appointments	List all appointments
POST	/api/appointments	Schedule an appointment
GET	/api/prescriptions	List all prescriptions
POST	/api/prescriptions	Create a prescription
GET	/api/billing	List all invoices
POST	/api/billing	Create a billing entry
GET	/api/dashboard	System telemetry metrics
POST	/api/login	Authenticate user
POST	/api/register	Register new staff/patient
POST	/api/forgot-password	Reset password

---

🧰 Tech Stack

Layer	Technology
Frontend	HTML5, CSS3 (Glassmorphism), Vanilla JavaScript (ES6+)
Icons	Lucide Icons (CDN)
Backend	Java 11+ with com.sun.net.httpserver
Database	SQLite (via JDBC) + JSON flat-file
JSON Parsing	Google Gson
Logging	SLF4J Simple
Build System	Batch scripts (compile.bat, run.bat)
Concurrency	CachedThreadPool for multi-threaded request handling

---

📐 Design Philosophy

• 🌑 Dark-First Design — Carefully curated dark palette with HSL-tuned accent colors (cyan, purple, emerald, rose, amber)
• 🪟 Glassmorphism — Frosted-glass panels with backdrop-filter: blur() and subtle transparency
• 📱 Responsive-First — CSS Grid & Flexbox layouts that adapt across desktop, tablet, and mobile
• ⚡ Zero Dependencies (Frontend) — No React, No Angular, No build step — pure vanilla JS SPA
• 🔒 Role-Based Security — Patients and staff see entirely different interfaces based on authentication state

---

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

This project is open source and available under the MIT License.

---

👨‍💻 Author

Sahil Kumar

• GitHub: @silentguyracer

---

Built with ❤️ for modern healthcare management
_{Aegis Suite © 2026}