Welcome to MWHMart, a Next.js-based web application designed to facilitate the management of billboards, categories, items, inventory history, auctions, and a shop interface for both administrators and residents of the Muhammadiyah Welfare Home.

1. Accessing MWHMart
2. User Roles
3. Admin Guide
   • Managing Billboards
   • Managing Categories
   • Managing Items
   • Tracking Inventory History
   • Managing Auctions
   • Manage Users
4. Resident Guide
   • Browsing Categories and Items
   • Participating in Auctions
   • View Vouchers and Metrics
   • View Tasks
5. Support

To access MWHMart, navigate to the following URL: https://mwhmart.vercel.app/

You will be prompted to log in with your credentials. These are the current test accounts:

Admin
email: [email protected]
password: hack4good
phone: +65 00000000
otp: 000000

Resident
email: [email protected]
password: hack4good
phone: +65 1234 5678
otp: 123456

MWHMart has two primary user roles:

• Administrator: Responsible for managing the platform's content and overseeing operations.
• Resident: Users who interact with the platform to view vouchers, browse items, participate in auctions, and shop.

Administrators can create, update, and delete billboards which are the hero images on the shopping landing page to communicate new items to Residents.

Steps to Manage Billboards:

1. Log in as an administrator.
2. Navigate to the "Manage Billboards" section in the sidebar.
3. To create a new billboard, click on "Add Billboard," enter the relevant information, and save.
4. To edit an existing billboard, select it from the list, make the necessary changes, and save.
5. To delete an billboard, select it and click on "Delete."

Organize items into categories for efficient inventory management and easy navigation.

Steps to Manage Categories:

1. Navigate to the "Manage Categories" section in the sidebar.
2. To add a new category, click on "Add Category," enter the name and description, and save.
3. To edit a category, select it, make the necessary changes, and save.
4. To delete a category, ensure no items are assigned to it, then select and delete it.

Add, edit, or remove items available in the shop, including details like descriptions, prices, and stock levels.

Steps to Manage Items:

1. Navigate to the "Manage Items" section in the sidebar.
2. To add a new item, click on "Add Item," fill in the details, and save.
3. To edit an item, select it, update the information, and save.
4. To delete an item, select it and click on "Delete."

Monitor changes in inventory levels over time to maintain accurate records and identify trends.

Steps to Track Inventory History:

1. Navigate to the "Inventory History" section in the admin dashboard.
2. View logs of inventory changes, including additions, removals, and adjustments.

Set up and oversee auctions, including item listings, bidding processes, and finalizing auction results.

Steps to Manage Auctions:

1. Navigate to the "Manage Auctions" section in the admin dashboard.
2. To create a new auction, add the special item which is the item being auctioned off.
3. Then create the auction by providing the relevant details including the end date.
4. Monitor ongoing auctions to oversee bidding activity.
5. Finalize auctions by declaring winners and processing transactions.

Oversee the users and account management.

Steps to Create new Accounts:

1. Navigate to the "Create Accounts" section in the sidebar.
2. Fill in the details and specify the role.
3. Manage the users in the "Manage Users" section in the sidebar.

Explore available items organized by categories in the shop.

Steps to Browse Categories and Items:

1. Navigate to the "Shop" section.
2. Browse through categories to find items of interest.
3. Click on items to view detailed descriptions, prices, and availability.

Place bids on items of interest and track auction statuses

Keep track of what you've purchased and your vouchers.

View some tasks that would enable to get reward points to be used in auctions.