Skip to content

Mall Manager - C# Course project for the OOP with C# course in FMI

Notifications You must be signed in to change notification settings

NikolaTotev/Mall_Manager

Repository files navigation

Created By

  • Nikola Totev - FN 62271
  • Ivaylo Petkov - FN 62329

Literature/Other Resources

  • Programming .NET Components 2nd Edition by Juval Lowy
  • stackoverflow.com

Mall Manager Wiki

  • Installation

    • Standard .exe installation
    • Downloading repo & building project in Visual Studio
  • UI Walkthrough

    • Dashboard
    • Mall Menu
      • Rental spaces menu
      • Mall activities menu
      • Mall statistics page
    • Adding/Editing/Removing
      • Creating a mall
      • Add/Edit/Remove rental space
      • Add/Remove activity
        • For a room
        • For a mall
    • Statistics
    • Using command mode searching
  • Program Data Files

    • Location
    • What they are used for

Installation

Standard .exe installation

The easiest way to start Mall Manager is to download this repository. That is done like this:

After downloading the repository locate the .zip file on your computer and extract it. Once the the extraction is completed locate the "Exe Lanucher" Folder:

Open it and run "User_Interface.exe". Thats it! You are now ready to use Mall Manager 1.0.

Building in Visual Studio

Building in Visual Studio requires a couple more steps. Being by again downloading & extracting the repository file. Once complete locate the "C_Sharp_Course_Project" folder:

Open it and locate the only .sln item inside:

Double click it and if you have Visual Studio installed it should start up. If you do not have it you can download it here: https://visualstudio.microsoft.com/vs/ Once Visual Studio has started you may recive the following message:

Follow these steps: 1. Select the checkbox 2. Press Ok. Once you do it once, you may recieve it 2 more times. If you do execute the previous steps again. After that you should be greeted with an empty screen with the Solution Explorer at the top right of your screen. You may notice the following warning messages & green underlines:

These are showing because when downloading from Github, the nessecary NuGet packages are not downloaded. This issue is easliy fixed by simply building the solution. This is done by right clicking the solution which will show the following menu, then click "Build Solution" :

The warnings should have gone away and you are ready to lanunch the program: 1. Right-click on the User_Interface project 2. From the menu select "Set StartUp Project"

3. Press the "Start" button.

UI Walkthrough

Dashboard

This is the dashboard, from here you can create up to 2 malls or open a mall that is already created.

Mall Menu

Once you open a mall you are directed to this page. This is the mall menu. From here you can view:

  • The rental spaces of the mall
  • Activities for the mall as a whole
  • Statistics for the mall as a whole

Rental spaces menu

This is the rental spaces menu. From here you can Add and Remove rental spaced from the mall. You can also search by name or you can use CMS (Command Mode Search) .

Mall activities menu

This is the mall activities menu. From here you can Add and Remove activities from the current mall. You can also view statistics from the "Quick Stats" panel or open the full statistics from the "Stats" button.

Mall statistics page

This is the mall statistics page. Here you can view statistics about the mall.

Adding/Editing/Removing

Below are all of the supported Add, Edit & Remove operations that are supported. (This is not the final list of operations, the rest are put as "future development opportunities")

Note: If not explicitly mentionted the "Cancel" button returns you to the previous page and does not execute any operation

Creating a mall

Creating a mall is done through this window. The add button is active once all fields have a valid value.

Adding/Editing/Removing rental space

  • Adding a rental space is done through this menu. As before the "Add" button becomes active only when the fields have valid values.

  • Removing a rental space is done by selecting the rental space(s) you want to delete from the Rental Spaces menu and clicking the "Delete" button.

Notice: Only spaces with 0 associated activities will be deleted. If you attempt to delete a space that still have active activities you will recieve a warning.

Adding/Removing activity

There are two types of activity you can add: 1. For a mall: This associates the created activity only with the mall, not a specific room. 2. For a room: This associates the created activity only with the mall, not a specific room. Both use the same interface: (The same rules about the "Add" button apply as before.)

Removing an activity is done from the respective activities menus (for mall or room)

Statistics

Mall manager offers a number of data visualizations. You can access them from the dedicated "Stats" buttons or you can view the "Quick Stats" on the activity pages. Below are some examples:

Using Command Mode Search (CMS)

CMS is a powerful filtering tool that you can use to manage large amounts of rental spaces in an instant. It is activated from the Rental Spaces menu (Button marked with "1")

These are the available commands:

Searching by other string
  • $ T [string] - Search by room Type
  • $ NA [number] - Search by Number of Activityes
Searching by date
  • $ DC [string mm/dd/yyyy] - Search by Dated Created
  • $ DLE [string mm/dd/yyyy] - Search by Date Last Edited
Searching by number
  • $ RF[number] - Search by Room Floor
  • $ RN [number] - Search by Room Number

If you happen to forget these commands, you can always reference the hit button activated when CMS is turned on (Button marked in the first image with "2")

Program Data Files

Location

The program data files can be found in the app data folder. You can get there by following these steps: 1. Press Windows+R a window like this will pop up:

In it write %appdata% and press enter.

Search for the "MallManager_DATA" folder.

WARNING: Do NOT delete or modify any of the folders with in the "MallManager_DATA" folder! Doing so may corrupt the data and the program may not work properlly.

About

Mall Manager - C# Course project for the OOP with C# course in FMI

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages