# Cancer Patient Management System — v1.0

## Quick Start

1. **Install Python 3.8+** — https://www.python.org/downloads/ (check "Add to PATH")
2. **Double-click `LAUNCH.bat`** — opens your browser automatically
3. **Log in** with one of the accounts below

> **No internet required.** Everything runs locally on your computer.

---

## Login Credentials

| Role    | Username           | Password    | Access Level                  |
|---------|-------------------|-------------|-------------------------------|
| Admin   | `admin`           | `admin123`  | Full system access            |
| Doctor  | `dr.martin`       | `doctor123` | All patients, alerts, labs    |
| Doctor  | `dr.leroy`        | `doctor123` | Pancreatic, Ovarian patients  |
| Doctor  | `dr.bernard`      | `doctor123` | AML, Hodgkin patients         |
| Doctor  | `dr.moreau`       | `doctor123` | Prostate, Lung patients       |
| Nurse   | `inf.moret`       | `nurse123`  | Assigned patients, vitals     |
| Nurse   | `inf.lambert`     | `nurse123`  | Assigned patients, vitals     |
| Nurse   | `inf.petit`       | `nurse123`  | Assigned patients, vitals     |
| Nurse   | `inf.roux`        | `nurse123`  | Assigned patients, vitals     |
| Patient | `patient.durand`  | `patient123`| Own records only              |
| Patient | `patient.martin`  | `patient123`| Own records only              |
| Patient | `patient.leroy`   | `patient123`| Own records only              |
| Patient | `patient.moreau`  | `patient123`| Own records only              |
| Patient | `patient.bernard` | `patient123`| Own records only              |
| Patient | `patient.petit`   | `patient123`| Own records only              |
| Patient | `patient.roux`    | `patient123`| Own records only              |
| Patient | `patient.lambert` | `patient123`| Own records only              |

---

## 8 Patient Cases Included

| # | Patient | Cancer | Stage | Protocol |
|---|---------|--------|-------|----------|
| 1 | Mme Claire Durand | Breast HER2+ | IIB | TCHP |
| 2 | M. Pierre Martin | Lung NSCLC | IIIA | Chemo + Durvalumab |
| 3 | Mme Sophie Leroy | Colorectal | IIIC | FOLFOX + Bevacizumab |
| 4 | M. Jean Moreau | Prostate mCRPC | IV | Cabazitaxel |
| 5 | M. Luc Bernard | AML | De novo | 7+3 Induction |
| 6 | Mme Marie Petit | Hodgkin Lymphoma | IIB | ABVD |
| 7 | M. Henri Roux | Pancreatic | IIIB | mFOLFIRINOX |
| 8 | Mme Isabelle Lambert | Ovarian | IV | Carbo/Paclitaxel + Olaparib |

---

## Features

- **Dashboard** — Real-time stats, alerts, role-based responsibilities
- **Patient Management** — 8 cancer cases with full clinical data
- **Medications** — 36 drugs with protocols, dosages, side effects
- **Alerts** — 7 active clinical alerts (auto-generated from vitals/labs)
- **Vital Signs** — Tracks temperature, BP, HR, SpO2 with abnormal flagging
- **Lab Results** — CBC, CMP, tumor markers, coagulation panels
- **Symptom Reports** — Patient self-reporting with CTCAE grading
- **Treatment Cycles** — Full treatment timeline per patient
- **Global Search** — Search across patients, meds, alerts, users
- **Role-Based Access** — Different views for Admin, Doctor, Nurse, Patient
- **Mobile-Friendly** — Responsive design with bottom navigation

---

## File Structure

```
CancerPatientSystem_v1.0/
├── LAUNCH.bat              ← Double-click to start
├── README.md               ← This file
├── api_server.py           ← Backend server (Python)
├── database.py             ← Database manager
├── seed_data.py            ← Demo data generator
├── data/
│   └── cancer_patients.db  ← Pre-seeded SQLite database
├── static/
│   └── index.html          ← Full application (SPA)
└── docs/
    ├── SYSTEM_ARCHITECTURE.md
    └── USER_CASES.md
```

---

## Requirements

- **Python 3.8+** (standard library only — no pip packages needed)
- **Any modern browser** (Chrome, Firefox, Edge, Safari)
- **Windows, macOS, or Linux**

---

## Stopping the Server

Press `Ctrl+C` in the terminal window, or simply close it.

To restart: double-click `LAUNCH.bat` again.