OSMICS

Table of Contents

• Overview
• Goals
• What Our Application Provides
• Mockup Pages
• User Guide
• Developer Guide
• Development History
• Deployment
• Quality Assurance
• Team Members

Overview

The ICS department is in need of an office space management system. Currently, there is no management system, which makes it difficult to reassign offices or assess rooms’ inventory.

Goals

Our goal is to develop a user friendly application that can assist the entire ICS department with distribution of key information and management.

What Our Application Provides

This application will mainly provide the ICS Department’s administrative office and tech support with an inventory and office space management system. Additionally, students and faculty also have access to the site, but with a different scope. Faculty can book conference rooms, and can update their office hours. Students on the other hand can look up faculty members, or locate where a certain room may be.

Mockup Pages

User Guide

This section provides a walkthrough for the app

Landing Page

What the user sees when they first go to the site.

Sign-In

Where the user can sign-in.

Home Page Default User

A home page that includes a zoomable map of POST. Faculty is also visible as well as room reservations. The blue hovering button is for accessibility.

Admin Home Page

Admin can see all of the users and modify their information.

Admin can add faculty accounts which makes their profiles. They can also edit and modify the faculty profiles. They can also delete accounts by using the delete button for easier access.

Admin can add student accounts without profiles into the system. They can change the first name and last name of the student user. Delete is also implemented to serve the same function.

Admin can add faculty accounts without profiles into the system. They can change the first name and last name of the faculty user. Delete has the same function as the ones above.

Room Admin

Admin can see all of the rooms and modify their information, can add rooms, and view room details.

A tab for equipment which consists of furniture and tech such as TV’s, telephones and more.

A section for room jacks and also has edit and delete functions.

Room Reservation

Room reservation allow certain users and roles to request for a room to use.

This is the room reservation inside of the home page which links to the reserve page.

Faculty Page

Where the list of faculty can be seen by all users. They also have a search bar to find professors profiles.

However, only admin and office can add new faculty, as well as download the csv file.

It is noted that edit profile button will only function for the respective faculty user. While admin and office can edit faculty profiles indefinitely.

Clubs

Each club has their own page with various information such as meeting times, Discord invites, and more.

People with the role of Admin or Office also have the ability of adding clubs.

Developer Guide

First, install Meteor.

Next, go to the OSMICS github page. and make a copy of the repo to your local computer.

Then, cd into the app directory and use:

meteor npm install

And finally, run the system with:

meteor npm run start

If everything is good, the application will appear at http://localhost:3000.

Development History

The development process for OSMICS follows Issue Driven Project Management:

• Development consists of a sequence of milestones.
• Each milestone is specified as a set of tasks.
• Each task is described using a Github Issue, and is assigned to a single developer.
• The work for each task is accomploished with a gut branch named “issue-XX”, where XX is replaced by the issue number.
• When a task is complete, its corresponding issue is closed and its git branch is merged into main.

• The state of each task for a milestone is managed using a Github Project Board.

• M1 (Milestone 1)
  • Completed Mockups
• M2 (Milestone 2)
  • Implemented pages based on the mockups
• M3 (Milestone 3)
  • Revamp user interface
  • Add an interactive map prototype
  • Add more functionality such as adding rooms, adding faculty, and a discuss page
• M4 (Milestone 4)
  • Further improvements in the user interface
  • Add club collections
  • Add club pages and clubs in the navigation bar
  • Reimplemented logic for Roles
• M5(Milestone 5)
  • Improved on overall quality and design of app
  • Finished certain backend issues
  • Interactive map has better usage and readability
• M6(Milestone 6)
  • Implemented delete function for certain actions such as deleting users accounts
  • Interactive map can update user profile bubble if add or delete user was used
  • Added csv function to download certain data

Deployment

You can find our website here.

Quality Assurance

To ensure quality assurance, we are using several tools including eslint and testcafe.

To run testcafe for development run:

$ meteor npm run test-acceptance-development

To run testcafe with headless (similar to how it will run once committed to Github) run:

$ meteor npm run test-acceptance-ci

To run eslint:

$ meteor npm run lint

Team Members

• Devin Arquines
• James Louie Grande
• Malia Liu
• Susan Ma
• Gwyneth Raquepo
• Giorgio Tran
• Jerome Wasserman

Team Contract

For comments or questions, please contact us via our project’s GitHub.