Campus Management System Institutional Portal

Campus Management System — Institutional Portal is a responsive web application designed for vocational academies, esthetics schools, and educational institutions that manage clock-hour programs.

Key Features

• Four role-based workspaces: Super Admin, Office Staff, Instructor, and Student.

• Student enrollment, records, and profile management.

• Attendance tracking and correction logging.

• Clock-hour progress monitoring and completion projections.

• Exam score entry and automated letter grade calculation.

• Practical service tracking and digital sign-off.

• Financial ledger, payment plans, and tuition summaries.

• Document management and institutional notifications.

• SAP evaluation and compliance reporting interfaces.

• Responsive dark-gold glassmorphism design.

Technology Stack

• Frontend: React 19

• Build Tool: Vite 8

• Styling: Vanilla CSS

• Icons: Lucide React

• Linter: Oxlint

Requirements

• Node.js v18.0.0 or higher recommended.

• npm or yarn.

Installation

1. Navigate to the project directory.

2. Install dependencies using npm install.

3. Configure environment variables using .env.example.

4. Start the application with npm run dev.

5. Open http://localhost:5173 in your browser.

Demo Access

• Super Admin: admin / admin

• Office Staff: office / office

• Instructor: instructor / instructor

• Student: student / student

Available Commands

• npm run lint — Run code linting.

• npm run build — Build the production bundle.

• npm run preview — Preview the production build.

Demo and API Configuration

The application supports an in-memory demo mode when VITE_API_BASE_URL is empty. An API client and service integration layer are included in the documented project architecture, but a live backend integration is not confirmed by the README.

See README.md for configuration details and the project structure.