[go: up one dir, main page]

Skip to content

A webapp aiming to provide students information about the availability and quantity of items at the UCSB food bank

License

Notifications You must be signed in to change notification settings

ucsb-cs148-s21/1pm-t2-food-bank

Repository files navigation

1pm-t2-food-bank

Links

Heroku: https://t2-food-banks.herokuapp.com/

GitHub: https://github.com/ucsb-cs148-s21/1pm-t2-food-bank/

UCent Food Bank

This Webapp aims to provide students information about what items are available at the food bank, so students don't need to come to the food bank and leave empty handed because the food they want is unavailable.

Grand Vision

Know the availability and quantity of items at the food bank before physically being there

Team Members

Name GitHub ID Email
Jerry Wang missmiss20 tianchenwang@ucsb.edu
Liuhao Wu lwu5 liuhaowu@ucsb.edu
Kaiwen Li kaiwenli1 kaiwen_li@ucsb.edu
Sunrise Gao sunrise0stack xu_gao@ucsb.edu
Orion Schwellenbach JamesSchwellenbach jamesschwellenbach@ucsb.edu

Tech Stack

Frontend - React/Javascript/HTML/CSS

Backend - Spring Node.js

Database - Firebase

Testing - React Testing Library/JEST + JUnit + Postman

External Resources

  • UI design: Material-UI, Bootstrap, Font Awesome, Google Fonts
  • Third-party APIs: Google Auth, EmailJS, MomentJS
  • Numerous Youtube tutorials videos (linked in codebase and PR descriptions)

User Roles

  1. If I am a student, I can tell know what items are in the food bank and their corresponding quantities.
  2. If I am a student, I can looking for a restock of specific food that I have been wanting.
  3. If I am a staff, I can know what kind and quantity of food are distributed today to better arrange tomorrow's orders.
  4. If I am a staff, I will have permission to edit content on the wepapp, insert, modify, and delete items and give other users admin permissions.
  5. As a user, I can use the contact form on contact us page to submit a message to UCSB food bank staff.

Functionality

  • Going to our web app, user can click a NavBar item called inventory, where they can find the a list of food items with their categories, quantities, and limitations. User also has access to the search bar to search a food item based on its category or name.
  • After logging in, verified staff can login and access the staff portal page to modify food bank inventory.
  • Going to the contact us page, user can submit a contact us form to ucsb food bank staff. After submitting the form, user will receive an auto-reply emails and staff member can receive an email notification listing the form user has submitted. Currently, all incoming contact us forms are directed to liuhaowu@ucsb.edu.

Known Issues & Recommendations

  • In short 10 weeks of the class, we mainly focused on the implementation of our web app functionality, and thus advanced UI and aesthetics design is required in the future.
  • There's a existing Food Bank web app for introductional info (i.e. history, staff info, etc) and our web app is for intereactable and dynamic inventory data access. Consult with UCSB Food Bank administrators about integrating these two apps is recommended in the future.

Contributing

Fork it!

  1. Create your feature branch: git checkout -b my-new-feature
  2. Commit your changes: git commit -am 'Add some feature'
  3. Push to the branch: git push origin my-new-feature
  4. Submit a pull request :D

License

MIT

Final Project Quick Reference Guide

Final Presentation

User Manual

Design Document

Meeting Logs

Contributions

Deployment