v0.7 Stable

YNH Asset Management System

Enterprise IT Asset Lifecycle Management Platform

A modern, high-performance platform centralizing infrastructure tracking, maintenance records, and network mapping for Yanbu National Hospital.

Next.js 14 Firebase Tailwind CSS React 18
Project Overview

Purpose: YAMS solves critical operational challenges by transition from fragmented tracking to a unified, serverless infrastructure platform.

Problem Statement: Hospital IT environments often suffer from IP conflicts, untracked hardware lifecycles, and disconnected maintenance logs.

Key Goals: Centralize data, automate hardware identification, and provide real-time network visibility for IT administrators.

Asset Tracking
Real-Time Monitoring
Secure Access

Core Technology Stack

Frontend

  • Next.js 14 (App Router)
  • React 18 & Lucide Icons
  • Tailwind CSS Styling
  • ShadCN UI Framework

Backend

  • Cloud Firestore (NoSQL)
  • Firebase Auth (Anonymous)
  • Real-time Data Hooks
  • Firestore Security Rules

Deployment

  • Serverless Architecture
  • Offline LAN Ready
  • Firebase Emulator Suite
  • Local Hospital Infrastructure

Technical Architecture

Next.js Client
Firebase SDK
Firestore / Auth

YAMS utilizes a direct-to-firebase client architecture, removing the need for an intermediary API server, reducing latency and simplifying LAN deployment.

Platform Modules

Asset Registry

  • Gap-filling Serial Logic
  • Department Linkage
  • Hardware Prefixing

Network Map

  • IP Conflict Engine
  • Pool Tracking
  • Real-time Visualization

Maintenance

  • Historical Repair Logs
  • Lifecycle Monitoring
  • Status Triggers

Hardware Tester

  • Key Detection System
  • IT Diagnostics
  • Input Validation

Print Engine

  • CSS Sticker Generator
  • 6x3 Optimized Format
  • Batch Label Creation

Data Flow & Relationships

Central Inventory
Maintenance Logs
Department Map

Relational consistency is maintained across the NoSQL architecture through strict ID linking:
Inventory → Dept (ID) | Logs → Inventory (ID) | Inventory → Specs (ID)

Security Architecture

  • Silent Auth: Seamless hospital staff entry via Gate logic.
  • PIN Protection: High-security actions require secret PIN verification.
  • Identity Rules: Granular read/write permissions at the DB layer.
  • LAN Sandbox: Fully isolated from public internet traffic.
Real-time Sync Update
Zero Serial Gaps
Conflict IP Detection
Offline LAN Capable

LAN Deployment Setup

# Access hospital LAN host
Host Server IP: 192.168.1.50:3000
# Required Stack
Runtime: Node.js 18+
Backend: Firebase Emulator 12.x