systemjus57/university-asset-management

University Asset Management System — PHP/MySQL asset lifecycle tracker (Somali National University FYP) # University Asset Management System Final Year Project — Somali National University. Tracks university-owned assets through their full lifecycle: registration, allocation, transfer, maintenance, auditing, requisition, and disposal, with role-based access for four user types. ## Tech stack - **Backend:** PHP (PDO + prepared statements, no framework) - **Database:** MySQL / MariaDB - **Frontend:** HTML, CSS, vanilla JavaScript - **Architecture:** MVC-style separation — `/config` and `/includes` hold data/business logic, `/modules/**` act as controllers (fetch data, then include a view partial), `/static` holds presentation assets only. ## Folder structure ``` /config Database connection (config/database.php) and app config (config/config.php) /includes /layout Shared header/sidebar/footer/forbidden-page partials auth.php Session guards: requireLogin(), requireRole(), hasRole() functions.php Sanitization, CSRF, flash messages, activity/login logging, status badges bootstrap.php Single include point used by every module entry file /modules /auth login.php, logout.php /dashboard Role-aware summary dashboard /assets Register / edit / view (full history) / list & filter assets /assigned Allocate assets to departments/custodians, mark returned/repair /transfers Transfer assets between departments /maintenance Report & manage maintenance tickets /audits Physical audit records (found / missing / damaged) /requisitions Department requests → Officer/Admin review → approve/reject/issue /disposals Officer/Admin requests disposal → Top Management approves/rejects /users /departments /categories /locations Admin-only master data CRUD /reports Assets by dept/category/status, main …