CH 20Basic

Facilities, Asset & Operations Management

NexusOne's operational backbone — facility registry & room reservations, the complete asset lifecycle from procurement through depreciation to disposal, preventive and corrective maintenance, a full procurement pipeline with vendor management, and consumable inventory tracking. Entirely Basic tier — no AI dependency.

Basic Tier Features

Basic

Facility Registry & Reservations

Basic
  • Register campuses, buildings, classrooms, labs, halls, meeting rooms, staff rooms, computer rooms, activity rooms, grounds and utility areas
  • Each facility gets an auto-generated code, capacity, amenities list and status (Available / Reserved / Under Maintenance / Closed)
  • Room and lab booking with automatic time-slot conflict detection — double-booking is rejected with a clear error
  • "My Bookings" view for any staff member plus an all-bookings view for facilities admins
  • Web UI: /dashboard/admin/facilities and /dashboard/admin/facilities/reservations

Asset Registry & Lifecycle

Basic
  • Track IT equipment, furniture, lab equipment, sports equipment, vehicles, library books, electronics and security equipment
  • Full lifecycle: procurement → in-use → under maintenance → retired / disposed, with an auto-generated asset code and warranty tracking
  • Assignment to a staff member or department with full assignment history and condition-at-assignment/return capture
  • Straight Line, Written Down Value and Custom depreciation methods with an auto-computed current value and month-by-month schedule
  • Bulk asset import from CSV for initial registry setup
  • Web UI: /dashboard/admin/assets and /dashboard/admin/depreciation

Preventive & Corrective Maintenance

Basic
  • Maintenance schedules per asset with daily/weekly/monthly/quarterly/annual frequency and completion history
  • Maintenance tickets with auto-generated ticket number, issue type, severity, and a full status workflow (Open → Assigned → In Progress → Waiting for Parts → Resolved → Closed)
  • Downtime tracking (downtimeStart/downtimeEnd) with an aggregate downtime report per asset
  • Any authenticated user can report an issue; assignment and resolution are scoped to facilities admins and technicians
  • Web UI: /dashboard/admin/maintenance (schedules & tickets)

Procurement — Purchase Requests & Orders

Basic
  • Purchase requests with auto-generated request number and a dynamic multi-level approval workflow (teacher → HOD, amount > ₹50,000 → all → Admin)
  • Accountant/Admin convert an approved request into a Purchase Order sent to a vendor, with per-line-item delivery tracking
  • PO status progresses Sent → Partially Delivered → Delivered → Completed as receipts are recorded
  • Every request/approval/rejection/conversion and every PO payment writes an AuditLog entry; vendor payments post to the Finance ledger (FinancePosting)
  • Web UI: /dashboard/purchase-requests and /dashboard/admin/purchase-orders

Vendor Management

Basic
  • Vendor registry with auto-generated vendor code, company details, payment terms and contracts (AMC / PO / Service / Supply Agreement)
  • Bank details and contracts are restricted to Accountant and Admin roles and excluded from general vendor listings
  • Performance rating auto-computed from quality/delivery/pricing/service reviews, updated automatically on every completed PO
  • Vendor performance report ranks every vendor by rating, spend and on-time delivery rate
  • Web UI: /dashboard/admin/vendors

Consumable Inventory Management

Basic
  • Stock tracking for stationery, cleaning supplies, lab/IT/sports consumables, food & catering and maintenance supplies
  • Reorder level and reorder quantity per item, with an auto-computed stock status (In Stock / Low Stock / Out of Stock)
  • Restock and Issue actions each write a stock-history entry (quantity, balance after, who, when, notes)
  • Low-stock alerts endpoint surfaces every item at or below its reorder level for the facilities dashboard
  • Web UI: /dashboard/admin/inventory

Operations Analytics

Basic
  • Asset utilisation by category (in-use vs. available vs. under maintenance) and an overall utilisation rate
  • Asset downtime report aggregated per asset from resolved maintenance tickets
  • Procurement spend analysis by department and by month
  • Vendor performance ranking and per-vendor order/spend history

API Reference — Chapter 20

Facilities & Reservations

GET/api/facilities

List facilities with type/status/search filters and stats

POST/api/facilities

Register a facility — auto-generates the facility code

GET/api/facilities/reservations

List reservations, optionally scoped to the current user (?mine=true)

POST/api/facilities/reservations

Book a facility — rejects overlapping time-slot bookings with a 409

DELETE/api/facilities/reservations/:id

Cancel a reservation — the requester or a facilities admin/admin

Assets & Depreciation

GET/api/assets

Asset register with category/status/condition filters and aggregate stats

POST/api/assets/:id/assign

Assign an asset to a user, creating an AssetAssignment history record

POST/api/assets/:id/return

Return an assigned asset — closes the AssetAssignment record

POST/api/assets/bulk-upload

Bulk-create assets from a CSV file

GET/api/assets/reports/utilisation

Utilisation rate by category and overall

GET/api/depreciation/asset/:id/schedule

Month-by-month depreciation schedule for an asset

PUT/api/depreciation/bulk-update

Recalculate depreciation across every asset in one run

Maintenance

POST/api/maintenance/schedules

Create a preventive maintenance schedule

POST/api/maintenance/schedules/:id/complete

Mark a scheduled maintenance task completed

POST/api/maintenance/tickets

Report a maintenance issue — open to any authenticated user

POST/api/maintenance/tickets/:id/comments

Add a comment to a ticket's discussion thread

GET/api/maintenance/reports/downtime

Aggregate asset downtime from resolved tickets

Procurement & Vendors

POST/api/purchase-requests

Submit a purchase request — approval workflow built dynamically by role and amount

POST/api/purchase-requests/:id/convert-to-po

Accountant/Admin converts an approved request into a Purchase Order

GET/api/purchase-requests/reports/spend

Procurement spend analysis by department and by month

PUT/api/purchase-orders/:id/send-to-vendor

Send a purchase order to its vendor

POST/api/purchase-orders/:id/deliveries

Record a delivery against a PO's line items

POST/api/purchase-orders/:id/payments

Record a vendor payment — posts a FinancePosting expense entry

POST/api/vendors/:id/contracts

Add a vendor contract (AMC / PO / Service / Supply Agreement) — Accountant/Admin only

POST/api/vendors/:id/review

Submit a quality/delivery/pricing/service rating, recomputing the vendor's overall rating

GET/api/vendors/reports/performance

Vendor performance ranking across quality, delivery, pricing and service

Inventory

GET/api/inventory

Consumable stock list with category/stockStatus filters and stats

POST/api/inventory/:id/restock

Add stock — records a stock-history entry

POST/api/inventory/:id/issue

Issue stock — rejects the request if quantity exceeds current stock

GET/api/inventory/alerts/low-stock

Items at or below their reorder level

Frontend Pages

PathRoleDescriptionTier
/dashboard/admin/facilitiesFacilities Admin / AdminFacility registry, filters, and the book/reserve flowBasic
/dashboard/admin/facilities/reservationsEvery staff roleMy Bookings, plus an all-bookings toggle for facilities adminsBasic
/dashboard/admin/assetsFacilities Admin / AdminAsset register with search, filter and category breakdownBasic
/dashboard/admin/depreciationFacilities Admin / AdminDepreciation schedules and valuation reportsBasic
/dashboard/admin/maintenanceFacilities Admin / AdminPreventive schedules and corrective maintenance ticket queueBasic
/dashboard/teacher/maintenanceTeacherReport a facility/asset issue and track its own reported ticketsBasic
/dashboard/admin/vendorsAccountant / Facilities Admin / AdminVendor registry with contract managementBasic
/dashboard/purchase-requestsEvery staff role (approval-scoped)Purchase request creation and approval queueBasic
/dashboard/admin/purchase-ordersAccountant / AdminPurchase order management and vendor paymentsBasic
/dashboard/admin/inventoryFacilities Admin / AdminConsumable stock register with restock/issue and stock historyBasic

Mobile — Facilities Admin

Under app/(facilities-admin)/: asset browse, maintenance schedules & tickets, purchase requests & orders, facility browse with in-app booking and conflict feedback, a reservations list with cancel, inventory browse with restock/issue actions, and a low-stock alerts screen.