@omersx/bemms 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 BEMMS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -1,3 +1,204 @@
-# Temporary Holding Version
+# 🏥 BEMMS — Biomedical Engineering & Maintenance Management System
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![CI](https://github.com/omersx/bemms/actions/workflows/ci.yml/badge.svg)](https://github.com/omersx/bemms/actions/workflows/ci.yml)
+[![Docker Hub](https://img.shields.io/docker/pulls/omersx/bemms?logo=docker&label=Docker%20Hub)](https://hub.docker.com/r/omersx/bemms)
+[![npm version](https://img.shields.io/npm/v/@omersx/bemms.svg?logo=npm)](https://www.npmjs.com/package/@omersx/bemms)
+[![Next.js 15](https://img.shields.io/badge/Next.js-15-black?style=flat&logo=next.js)](https://nextjs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue?style=flat&logo=typescript)](https://www.typescriptlang.org/)
+[![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.4-38bdf8?style=flat&logo=tailwind-css)](https://tailwindcss.com/)
+[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-16-336791?style=flat&logo=postgresql)](https://www.postgresql.org/)
+[![Drizzle ORM](https://img.shields.io/badge/Drizzle_ORM-0.36-C5F74F?style=flat&logo=drizzle)](https://orm.drizzle.team/)
+[![Vitest](https://img.shields.io/badge/Vitest-5.0-6E9F18?style=flat&logo=vitest)](https://vitest.dev/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Compliance](https://img.shields.io/badge/Compliance-21_CFR_Part_11-emerald)]()
+
+**BEMMS** is a production-grade, full-stack Biomedical Engineering and Computerized Maintenance Management System (CMMS) designed for hospitals, clinical healthcare networks, and medical device service teams.
+
+It bridges the gap between frontline clinical healthcare workers and biomedical engineering teams—enabling instant equipment triage, QR-based mobile fault reporting, preventive maintenance tracking, and FDA 21 CFR Part 11 compliant cryptographic electronic signatures.
+
+> 📖 **Comprehensive Manual**: For in-depth architectural specs, interactive Mermaid workflows, complete database ERDs, state machines, and operational guidelines, see the **[Full Architecture & Operations Manual (full-readme.md)](full-readme.md)**.
+
+---
+
+## 🌟 Key Features
+
+### 1. 📋 Medical Equipment Inventory & Lifecycle Management
+- **Centralized Asset Registry**: Track equipment across hospitals, departments, wards, and rooms.
+- **Criticality & Risk Scoring**: Classify devices by WHO risk tiers (Class I, IIa, IIb, III) and operational criticality.
+- **Availability State Machine**: Real-time status tracking (`operational`, `operational_with_limitations`, `under_maintenance`, `under_repair`, `waiting_for_parts`, `awaiting_release`, `standby`, `out_of_service`, `decommissioned`).
+- **Complete Audit Trail**: Every status change, location relocation, and calibration event is permanently logged with timestamps and actor IDs.
+
+### 2. 📱 QR Code Generation & Mobile Field Scanning
+- **Instant Camera Scanner**: Built-in QR camera scanner (`html5-qrcode`) for instant mobile device lookup.
+- **High-Resolution QR Labels**: Printable labels with hospital branding, equipment name, asset tag, and direct URL.
+- **Public & Authenticated Scan Workflow**: Clinical staff can scan any unit from their phone to immediately view availability and report faults without typing serial numbers.
+
+### 3. 🎫 Clinical Helpdesk & Ticket Triage System
+- **Color-Coded Triage Queue**: Visual priority cards with left accent rails:
+  - 🔴 **Red / Rose**: New, unassigned, and high-urgency problem tickets.
+  - 🟡 **Yellow / Amber**: Active repairs underway.
+  - 📦 **Orange**: Paused awaiting spare parts from vendor.
+  - 🟢 **Emerald Green**: Repaired and certified operational.
+  - ⚪ **Slate Blue**: Signed off and permanently archived.
+- **Card View vs. Table View**: Seamless switcher between touch-friendly responsive cards and compact data tables.
+- **Live Status Filtering**: Real-time search by title, ticket #, equipment model, asset tag, and department.
+
+### 4. 📦 Spare Parts Hold & Vendor Workflow
+- **Integrated Supply Chain Hold**: Pause active repairs when replacement boards, sensors, or cables must be ordered.
+- **Clinical Department Visibility**: Automatically notifies ward staff and dashboard that equipment is on hold.
+- **One-Click Resumption**: Resume work instantly when parts arrive at the hospital workshop.
+
+### 5. 🔏 21 CFR Part 11 Compliant Electronic Signatures
+- **Cryptographic Tamper-Evidence**: Password re-authentication generates SHA-256 hash digests permanently chained into regulatory audit tables.
+- **Binding Attestation Statements**: Legal attestation captured for Acceptance, Resolution, and Formal Closure.
+- **Multi-Party Sign-Off**: Performer, Reviewer, and Release Authority signature hierarchies.
+
+### 6. 🔧 Preventive Maintenance (PM) & Compliance
+- **Automated Recurrence Engine**: Scheduled maintenance occurrences generated based on calendar frequency (monthly, quarterly, semi-annual, annual).
+- **Inspection Checklists**: Step-by-step biomedical verification procedures with electrical safety and calibration standards.
+
+### 7. 🏥 Hospital Hierarchy & Role-Based Access Control (RBAC)
+- **Multi-Tenant Architecture**: Organization ➔ Hospital ➔ Department ➔ Location.
+- **Strict Role Separation**:
+  - `SYS_ADMIN`: Complete system configuration, user provisioning, and audit logs.
+  - `BIOMED_MGR`: Work order allocation, QA approval, and compliance reporting.
+  - `BIOMED_ENG` / `BIOMED_TECH`: Active repair execution, electronic signatures, and parts tracking.
+  - `DEPT_MGR` / `CLINICAL_STAFF`: Equipment scanning, department availability tracking, and fault reporting.
+
+### 8. 🚨 Real-Time Ticket Dispatch & Native Push Notifications
+- **Instant Engineering Broadcast**: Submitting a ticket triggers native VAPID Web Push notifications and real-time SSE in-app alerts to all scoped biomedical engineers.
+- **Waiting-for-Engineer Indicators**: Clear live wait durations and visual urgency markers ("⏳ Waiting for engineer to accept").
+- **1-Click Responsibility Acceptance**: Engineers can accept ticket responsibility with 21 CFR Part 11 signatures directly from the dispatch alert.
+- **Clinical Reporter Updates**: Instant confirmation notifications sent to ward staff when an engineer takes ownership.
+
+---
+
+## 🛠️ Architecture & Tech Stack
+
+| Layer | Technology |
+|---|---|
+| **Framework** | [Next.js 15](https://nextjs.org/) (App Router, Server Actions, React 19) |
+| **Language** | [TypeScript 5.7](https://www.typescriptlang.org/) (Strict Mode) |
+| **Styling & UI** | [Tailwind CSS](https://tailwindcss.com/) + [shadcn/ui](https://ui.shadcn.com/) + [Radix UI](https://www.radix-ui.com/) |
+| **Database & ORM**| [PostgreSQL 16](https://www.postgresql.org/) + [Drizzle ORM](https://orm.drizzle.team/) |
+| **Authentication** | [Auth.js / NextAuth v5](https://authjs.dev/) with bcrypt password hashing |
+| **Validation** | [Zod](https://zod.dev/) type validation schemas |
+| **Testing** | [Vitest](https://vitest.dev/) (Unit & integration test suites) |
+| **Deployment** | [Docker Compose](https://docs.docker.com/compose/) + [Caddy](https://caddyserver.com/) Reverse Proxy |
+
+---
+
+## 🚀 Quick Start Guide
+
+### Prerequisites
+- [Node.js](https://nodejs.org/) (v20+ recommended)
+- [pnpm](https://pnpm.io/) (v9+) or npm
+- [Docker & Docker Compose](https://www.docker.com/)
+
+### 1. Clone the Repository
+```bash
+git clone https://github.com/omersx/bemms.git
+cd bemms
+```
+
+### 2. Configure Environment Variables
+Copy `.env.example` to `.env.local`:
+```bash
+cp .env.example .env.local
+```
+*(The default `.env.example` is pre-configured to work out-of-the-box with the local Docker database).*
+
+### 3. Start Database via Docker
+```bash
+docker compose up -d db
+```
+
+### 4. Install Dependencies & Initialize Database
+```bash
+pnpm install
+pnpm db:push
+pnpm db:seed
+```
+
+### 5. Start the Development Server
+```bash
+pnpm dev
+```
+Open **[http://localhost:3000](http://localhost:3000)** in your browser.
+
+**Default Administrator Account:**
+- **Email:** `admin@bemms.local`
+- **Password:** `admin123`
+
+---
+
+## 🧪 Testing & Code Quality
+
+Run automated test suites with Vitest:
+```bash
+# Run all tests once
+pnpm test
+
+# Run tests in watch mode
+pnpm test:watch
+
+# Generate code coverage report
+pnpm test:coverage
+```
+
+Type checking:
+```bash
+pnpm exec tsc --noEmit
+```
+
+---
+
+## 📁 Project Structure
+
+```text
+BEMMS-app/
+├── src/
+│   ├── app/                      # Next.js 15 App Router pages & API routes
+│   │   ├── (auth)/               # Login & authentication routes
+│   │   ├── (dashboard)/          # Authenticated application modules
+│   │   │   ├── admin/            # Hospital, department, user, and system administration
+│   │   │   ├── departments/      # Department overview and device availability
+│   │   │   ├── devices/          # Equipment lifecycle, profiles, and QR codes
+│   │   │   ├── maintenance/      # Tasks, work orders, and electronic signatures
+│   │   │   ├── reports/          # KPI dashboards, compliance, and workload reports
+│   │   │   ├── scan/             # Mobile camera QR scanner & lookup
+│   │   │   └── tickets/          # Helpdesk triage, status cards, and resolution
+│   │   └── api/                  # REST endpoints (export, QR, web push)
+│   ├── components/               # React UI components (shadcn/ui + domain components)
+│   │   ├── admin/                # Settings, audit logs, and data management
+│   │   ├── departments/          # Department visual cards and metrics
+│   │   ├── devices/              # Status badges, QR generators, and transfer dialogs
+│   │   ├── signatures/           # 21 CFR Part 11 signature dialogs and audit chain
+│   │   ├── tickets/              # Ticket cards view, triage panels, and resolution flows
+│   │   └── ui/                   # Reusable shadcn/ui primitives
+│   ├── lib/
+│   │   ├── actions/              # Next.js Server Actions (type-safe business logic)
+│   │   ├── auth/                 # RBAC, session verification, and permission checks
+│   │   ├── db/                   # Drizzle ORM schema definitions and migrations
+│   │   ├── utils/                # Cryptography (SHA-256), attestations, and exports
+│   │   └── validators/           # Zod validation schemas and unit tests
+├── docker-compose.yml            # Local development PostgreSQL configuration
+├── docker-compose.prod.yml       # Production container deployment
+├── Dockerfile                    # Multi-stage optimized production Docker build
+├── Caddyfile                     # Automatic HTTPS Caddy configuration
+└── package.json                  # Dependencies and scripts
+```
+
+---
+
+## 📜 Compliance & Regulatory Standards
+
+- **FDA 21 CFR Part 11**: Cryptographic password re-authentication, immutable audit logging, electronic signature manifest, and SHA-256 chain of custody.
+- **IEC 62353**: In-service and post-repair medical electrical equipment safety testing workflows.
+- **Role Separation of Duties**: Prevents engineers from approving their own work orders when managerial sign-off policy is active.
+
+---
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE).

package/drizzle.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from "drizzle-kit";
+
+export default defineConfig({
+  schema: "./src/lib/db/schema",
+  out: "./drizzle",
+  dialect: "postgresql",
+  dbCredentials: {
+    url: process.env.DATABASE_URL!,
+  },
+});
+

package/next.config.ts

@@ -0,0 +1,51 @@
+import type { NextConfig } from "next";
+import path from "path";
+
+const nextConfig: NextConfig = {
+  outputFileTracingRoot: path.resolve(__dirname),
+  // Standalone output enabled in Docker / production environments (avoids Windows symlink EPERM)
+  output: process.env.BUILD_STANDALONE === "true" ? "standalone" : undefined,
+  poweredByHeader: false,
+  serverExternalPackages: ["pg", "xlsx"],
+  // ESLint is handled separately by `tsc --noEmit` in CI; skip during `next build`
+  eslint: {
+    ignoreDuringBuilds: true,
+  },
+  redirects: async () => [
+    {
+      source: "/tickets/report",
+      destination: "/tickets/create",
+      permanent: true,
+    },
+    {
+      source: "/dashboard/my-work",
+      destination: "/maintenance/tasks",
+      permanent: true,
+    },
+  ],
+  headers: async () => [
+    {
+      source: "/:path*",
+      headers: [
+        { key: "X-Content-Type-Options", value: "nosniff" },
+        { key: "X-Frame-Options", value: "DENY" },
+        { key: "X-XSS-Protection", value: "1; mode=block" },
+        { key: "Referrer-Policy", value: "strict-origin-when-cross-origin" },
+        {
+          key: "Content-Security-Policy",
+          value: [
+            "default-src 'self'",
+            "script-src 'self' 'unsafe-inline' 'unsafe-eval'",
+            "style-src 'self' 'unsafe-inline'",
+            "img-src 'self' data: blob:",
+            "font-src 'self' data:",
+            "connect-src 'self'",
+            "frame-ancestors 'none'",
+          ].join("; "),
+        },
+      ],
+    },
+  ],
+};
+
+export default nextConfig;

package/package.json

@@ -1,6 +1,102 @@
 {
   "name": "@omersx/bemms",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "Biomedical Engineering & Maintenance Management System (BEMMS)",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/omersx/bemms.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "src",
+    "public",
+    "drizzle",
+    "next.config.ts",
+    "tailwind.config.ts",
+    "postcss.config.mjs",
+    "tsconfig.json",
+    "drizzle.config.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@auth/drizzle-adapter": "^1.7.4",
+    "@hookform/resolvers": "^5.9.1",
+    "@radix-ui/react-avatar": "^1.1.3",
+    "@radix-ui/react-checkbox": "^1.1.4",
+    "@radix-ui/react-dialog": "^1.1.6",
+    "@radix-ui/react-dropdown-menu": "^2.1.6",
+    "@radix-ui/react-label": "^2.1.2",
+    "@radix-ui/react-navigation-menu": "^1.2.5",
+    "@radix-ui/react-popover": "^1.1.23",
+    "@radix-ui/react-scroll-area": "^1.2.3",
+    "@radix-ui/react-select": "^2.1.6",
+    "@radix-ui/react-separator": "^1.1.2",
+    "@radix-ui/react-slot": "^1.1.2",
+    "@radix-ui/react-switch": "^1.3.7",
+    "@radix-ui/react-tabs": "^1.1.3",
+    "@radix-ui/react-toast": "^1.2.6",
+    "@radix-ui/react-tooltip": "^1.1.8",
+    "@types/qrcode.react": "^3.0.0",
+    "bcryptjs": "^2.4.3",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "date-fns": "^4.4.0",
+    "drizzle-orm": "^0.36.4",
+    "html5-qrcode": "^2.3.8",
+    "lucide-react": "^0.468.0",
+    "nanoid": "^6.0.1",
+    "next": "^15.1.0",
+    "next-auth": "5.0.0-beta.25",
+    "pg": "^8.13.1",
+    "qrcode": "^1.5.4",
+    "qrcode.react": "^4.2.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-hook-form": "^7.86.0",
+    "sonner": "^1.7.2",
+    "tailwind-merge": "^2.6.0",
+    "tailwindcss-animate": "^1.0.7",
+    "web-push": "^3.6.7",
+    "xlsx": "^0.18.5",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/bcryptjs": "^2.4.6",
+    "@types/node": "^22.10.0",
+    "@types/pg": "^8.11.10",
+    "@types/qrcode": "^1.5.6",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@types/web-push": "^3.6.4",
+    "@vitest/coverage-v8": "^5.0.0",
+    "autoprefixer": "^10.4.20",
+    "drizzle-kit": "^0.28.1",
+    "eslint": "^9.16.0",
+    "eslint-config-next": "^15.1.0",
+    "postcss": "^8.4.49",
+    "tailwindcss": "^3.4.16",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^5.0.0"
+  },
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:push": "drizzle-kit push",
+    "db:seed": "tsx --env-file=.env.local src/lib/db/seed.ts",
+    "db:studio": "drizzle-kit studio",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
 }

package/postcss.config.mjs

@@ -0,0 +1,7 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};
+

package/public/hospital_demo_devices.csv

@@ -0,0 +1,32 @@
+asset_number,name,model,serial_number,category,manufacturer,department,location,risk_classification,criticality,purchase_date,purchase_cost,installation_date,warranty_start_date,warranty_end_date
+HOSP-ICU-001,Mechanical Ventilator,Puritan Bennett 980,PB980-88412,Ventilator,Medtronic,Intensive Care Unit (ICU),ICU Bed 01,class_iib,high,2023-03-15,38500.00,2023-04-01,2023-04-01,2026-04-01
+HOSP-ICU-002,Patient Monitor IntelliVue,MX750,MX75-99210,Patient Monitor,Philips Healthcare,Intensive Care Unit (ICU),ICU Bed 01,class_iib,high,2023-03-15,14500.00,2023-04-01,2023-04-01,2026-04-01
+HOSP-ICU-003,Volumetric Infusion Pump,Infusomat Space,INF-43209,Infusion Pump,B. Braun,Intensive Care Unit (ICU),ICU Bed 02,class_iib,high,2023-05-10,3200.00,2023-05-20,2023-05-20,2025-05-20
+HOSP-ICU-004,Syringe Driver Pump,Perfusor Space,PRF-88124,Syringe Pump,B. Braun,Intensive Care Unit (ICU),ICU Bed 02,class_iib,high,2023-05-10,2800.00,2023-05-20,2023-05-20,2025-05-20
+HOSP-ICU-005,Blood Gas Analyzer,ABL90 FLEX,ABL-77401,Laboratory Analyzer,Radiometer,Intensive Care Unit (ICU),Stat Lab Station,class_iia,high,2023-02-18,22000.00,2023-03-01,2023-03-01,2026-03-01
+HOSP-EM-001,Crash Cart Biphasic Defibrillator,R Series Plus,R-992481,Defibrillator,Zoll Medical,Emergency Department,Resuscitation Bay 1,class_iib,high,2023-01-10,16800.00,2023-01-25,2023-01-25,2026-01-25
+HOSP-EM-002,12-Lead Diagnostic ECG,MAC 2000,MAC-55201,Electrocardiograph,GE Healthcare,Emergency Department,Triage Assessment Room,class_iia,high,2023-02-05,8500.00,2023-02-15,2023-02-15,2025-02-15
+HOSP-EM-003,Vital Signs Spot Monitor,Connex Spot 7100,CS-11849,Vital Signs Monitor,Welch Allyn,Emergency Department,Observation Ward,class_iia,medium,2023-04-12,4200.00,2023-04-20,2023-04-20,2025-04-20
+HOSP-EM-004,Point-of-Care Ultrasound,Sonosite Edge II,EDGE-44910,Ultrasound Scanner,Fujifilm Sonosite,Emergency Department,Trauma Bay 2,class_iia,medium,2023-06-01,29000.00,2023-06-15,2023-06-15,2026-06-15
+HOSP-EM-005,Portable Emergency Suction,LSU 4000,LSU-33109,Suction Unit,Laerdal Medical,Emergency Department,Crash Cart 2,class_iia,high,2023-01-15,1850.00,2023-01-25,2023-01-25,2025-01-25
+HOSP-OR-001,Anesthesia Workstation,Perseus A500,ANES-77192,Anesthesia Machine,Dräger,Surgery & Operating Theatre,OR Suite 1,class_iib,high,2022-11-20,68000.00,2022-12-05,2022-12-05,2025-12-05
+HOSP-OR-002,Advanced Electrosurgical Unit,Valleylab FT10,ESU-88231,Electrosurgical Unit,Medtronic,Surgery & Operating Theatre,OR Suite 1,class_iib,high,2023-04-18,24500.00,2023-05-02,2023-05-02,2026-05-02
+HOSP-OR-003,Electro-Hydraulic Operating Table,Alphamaquet 1150,OT-44109,Surgical Table,Maquet Getinge,Surgery & Operating Theatre,OR Suite 2,class_i,high,2022-10-15,42000.00,2022-11-01,2022-11-01,2025-11-01
+HOSP-OR-004,Dual LED Surgical Ceiling Light,Polaris 600,LT-66281,Surgical Light,Dräger,Surgery & Operating Theatre,OR Suite 1,class_i,medium,2022-10-20,18000.00,2022-11-05,2022-11-05,2025-11-05
+HOSP-OR-005,HD Laparoscopy Video Tower,IMAGE1 S,LAP-22019,Endoscopy System,Karl Storz,Surgery & Operating Theatre,OR Suite 2,class_iia,medium,2023-03-08,55000.00,2023-03-25,2023-03-25,2026-03-25
+HOSP-RAD-001,Mobile Digital C-Arm System,Cios Alpha,CARM-99120,Fluoroscopy System,Siemens Healthineers,Radiology & Medical Imaging,Special Procedures Room,class_iib,high,2022-09-10,95000.00,2022-10-01,2022-10-01,2025-10-01
+HOSP-RAD-002,Digital Radiography X-Ray System,Ysio Max,XRAY-33291,X-Ray System,Siemens Healthineers,Radiology & Medical Imaging,X-Ray Room 1,class_iib,high,2022-08-15,120000.00,2022-09-01,2022-09-01,2025-09-01
+HOSP-RAD-003,Premium Diagnostic Ultrasound,EPIQ 7,US-77102,Ultrasound Scanner,Philips Healthcare,Radiology & Medical Imaging,Ultrasound Suite,class_iia,medium,2023-02-12,72000.00,2023-03-01,2023-03-01,2026-03-01
+HOSP-RAD-004,Mobile Motorized X-Ray Unit,MobileDaRt Evolution,MOB-44918,Mobile X-Ray,Shimadzu,Radiology & Medical Imaging,Mobile Fleet Bay,class_iib,high,2023-05-20,62000.00,2023-06-05,2023-06-05,2026-06-05
+HOSP-LAB-001,Automated Clinical Chemistry Analyzer,Cobas c 311,COB-66291,Chemistry Analyzer,Roche Diagnostics,Clinical Laboratory,Main Lab Bench A,class_iia,high,2023-01-15,48000.00,2023-02-01,2023-02-01,2026-02-01
+HOSP-LAB-002,Automated CBC Blood Analyzer (Hematology),XN-550,HEM-88210,CBC Analyzer,Sysmex,Clinical Laboratory,Hematology Section,class_iia,high,2023-01-15,36000.00,2023-02-01,2023-02-01,2026-02-01
+HOSP-LAB-003,Refrigerated Benchtop Centrifuge,5810 R,CENT-11029,Laboratory Centrifuge,Eppendorf,Clinical Laboratory,Processing Area,class_i,medium,2023-04-10,9200.00,2023-04-22,2023-04-22,2025-04-22
+HOSP-LAB-004,Class II Biological Safety Cabinet,Herasafe 2030i,BSC-44192,Biosafety Cabinet,Thermo Fisher Scientific,Clinical Laboratory,Microbiology Room,class_iia,high,2023-03-01,13500.00,2023-03-15,2023-03-15,2026-03-15
+HOSP-PED-001,Neonatal Intensive Care Incubator,Isolette 8000 Plus,INC-77109,Infant Incubator,Dräger,Pediatrics,NICU Bay 1,class_iib,high,2023-02-25,28000.00,2023-03-10,2023-03-10,2026-03-10
+HOSP-PED-002,Infant Radiant Warmer,Giraffe Warmer,GWRM-33218,Infant Warmer,GE Healthcare,Pediatrics,Delivery Room 1,class_iib,high,2023-02-25,19500.00,2023-03-10,2023-03-10,2026-03-10
+HOSP-PED-003,LED Phototherapy Treatment System,neoBLUE LED,PHT-55410,Phototherapy Unit,Natus Medical,Pediatrics,Nursery Room 2,class_iia,medium,2023-05-05,5800.00,2023-05-18,2023-05-18,2025-05-18
+HOSP-PED-004,Infant Bubble CPAP System,Bubble CPAP BC100,CPAP-88129,Respiratory Support,Fisher & Paykel,Pediatrics,Step-down Nursery,class_iib,high,2023-06-12,8900.00,2023-06-25,2023-06-25,2026-06-25
+HOSP-DENT-001,Comprehensive Dental Operating Unit,Intego Pro,DNT-11920,Dental Chair Unit,Dentsply Sirona,Dental Clinic,Operatory 1,class_iia,high,2023-01-20,32000.00,2023-02-10,2023-02-10,2026-02-10
+HOSP-DENT-002,High-Frequency Intraoral X-Ray,Planmeca ProX,DXR-44129,Dental X-Ray,Planmeca,Dental Clinic,Operatory 1,class_iib,high,2023-01-20,11500.00,2023-02-10,2023-02-10,2026-02-10
+HOSP-DENT-003,Class B Dental Vacuum Autoclave,Lisa 500,AUTO-77218,Steam Sterilizer,W&H Dental,Dental Clinic,Sterilization Room,class_iia,high,2023-02-15,8200.00,2023-03-01,2023-03-01,2025-03-01
+

package/public/manifest.webmanifest

@@ -0,0 +1,31 @@
+{
+  "name": "BEMMS - Equipment Management",
+  "short_name": "BEMMS",
+  "description": "Biomedical Equipment Management and Maintenance System",
+  "start_url": "/dashboard",
+  "scope": "/",
+  "display": "standalone",
+  "background_color": "#0a0a0a",
+  "theme_color": "#2563eb",
+  "orientation": "any",
+  "categories": ["medical", "business", "utilities"],
+  "icons": [
+    {
+      "src": "/icons/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "/icons/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    },
+    {
+      "src": "/icons/icon-maskable-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "maskable"
+    }
+  ]
+}
+

package/public/sw.js

@@ -0,0 +1,177 @@
+// BEMMS Service Worker
+// Handles: caching, push notifications, offline shell
+
+const CACHE_NAME = 'bemms-v3';
+const STATIC_ASSETS = [
+  '/login',
+  '/dashboard',
+];
+
+// Install — pre-cache shell
+self.addEventListener('install', (event) => {
+  event.waitUntil(
+    caches.open(CACHE_NAME).then((cache) => {
+      return cache.addAll(STATIC_ASSETS).catch(() => {
+        // Non-critical if some assets fail to cache
+        console.log('[SW] Some assets failed to cache, continuing...');
+      });
+    })
+  );
+  self.skipWaiting();
+});
+
+// Activate — clean old caches
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    caches.keys().then((keys) => {
+      return Promise.all(
+        keys
+          .filter((key) => key !== CACHE_NAME)
+          .map((key) => caches.delete(key))
+      );
+    })
+  );
+  self.clients.claim();
+});
+
+// Fetch — network-first for navigation/API, cache-first for static
+self.addEventListener('fetch', (event) => {
+  const { request } = event;
+  const url = new URL(request.url);
+
+  // Skip non-GET, cross-origin, or localhost development
+  if (request.method !== 'GET' || url.origin !== self.location.origin) return;
+  if (url.hostname === 'localhost' || url.hostname === '127.0.0.1') return;
+
+  // API/data requests — network only
+  if (url.pathname.startsWith('/api/') || url.pathname.startsWith('/_next/data/')) return;
+
+  // Static assets — cache first
+  if (
+    url.pathname.startsWith('/_next/static/') ||
+    url.pathname.startsWith('/icons/') ||
+    url.pathname.endsWith('.png') ||
+    url.pathname.endsWith('.ico')
+  ) {
+    event.respondWith(
+      caches.match(request).then((cached) => {
+        if (cached) return cached;
+        return fetch(request).then((response) => {
+          if (response.ok) {
+            const clone = response.clone();
+            caches.open(CACHE_NAME).then((cache) => cache.put(request, clone));
+          }
+          return response;
+        });
+      })
+    );
+    return;
+  }
+
+  // Navigation — network first, fallback to cache
+  if (request.mode === 'navigate') {
+    event.respondWith(
+      fetch(request).catch(() => {
+        return caches.match(request).then((cached) => {
+          return cached || caches.match('/dashboard');
+        });
+      })
+    );
+    return;
+  }
+});
+
+// Push — receive and show native notification
+self.addEventListener('push', (event) => {
+  let data = { title: 'BEMMS', body: 'You have a new notification', url: '/notifications' };
+
+  try {
+    if (event.data) {
+      data = event.data.json();
+    }
+  } catch (e) {
+    if (event.data) {
+      data.body = event.data.text();
+    }
+  }
+
+  // Determine urgency from data
+  const isCritical = data.data?.priority === 'p1_critical' ||
+                     data.data?.impact === 'patient_care_affected';
+  const isNewTicket = data.data?.type === 'new_ticket';
+  const isAccepted = data.data?.type === 'ticket_accepted';
+
+  const options = {
+    body: data.body,
+    icon: '/icons/icon-192.png',
+    badge: '/icons/icon-192.png',
+    tag: data.tag || 'bemms-notification',
+    renotify: true,
+    silent: false, // Ensure native device notification sound plays
+    data: {
+      url: data.url || '/notifications',
+      ...data.data,
+    },
+    actions: data.actions || [],
+    vibrate: data.vibrate || (isCritical ? [200, 100, 200, 100, 200] : [100, 50, 100]),
+    requireInteraction: data.requireInteraction || isCritical || false,
+    // On Android, set notification color based on urgency
+    ...(isCritical && { badge: '/icons/icon-192.png' }),
+  };
+
+  // For new tickets, add View action if not already present
+  if (isNewTicket && options.actions.length === 0) {
+    options.actions = [
+      { action: 'view', title: '📋 View Ticket' },
+    ];
+  }
+
+  event.waitUntil(
+    self.registration.showNotification(data.title, options)
+  );
+
+  // Also notify all open app windows to refresh their notification count
+  event.waitUntil(
+    self.clients.matchAll({ type: 'window', includeUncontrolled: true }).then((clients) => {
+      clients.forEach((client) => {
+        client.postMessage({
+          type: 'PUSH_RECEIVED',
+          notification: {
+            title: data.title,
+            body: data.body,
+            url: data.url,
+            data: data.data,
+          },
+        });
+      });
+    })
+  );
+});
+
+// Notification click — open app to the right page
+self.addEventListener('notificationclick', (event) => {
+  event.notification.close();
+
+  const notificationData = event.notification.data || {};
+  const action = event.action; // 'view', 'accept', or empty (body click)
+  let url = notificationData.url || '/notifications';
+
+  // If they clicked the View action or the body, go to the ticket
+  if (action === 'view' || !action) {
+    url = notificationData.url || '/notifications';
+  }
+
+  event.waitUntil(
+    self.clients.matchAll({ type: 'window', includeUncontrolled: true }).then((clients) => {
+      // Try to focus an existing window
+      for (const client of clients) {
+        if (client.url.includes(self.location.origin) && 'focus' in client) {
+          client.navigate(url);
+          return client.focus();
+        }
+      }
+      // Open new window
+      return self.clients.openWindow(url);
+    })
+  );
+});