FRC Portal

This project was developed for my FIRST Robotics Team 2363, Triple Helix. We needed a way to handle team and event registration as well as hours and metrics tracking.

Version 2.15.1

• Composer dependency updates
• Add Discord Login
• Removed local login (create local admin)
• Add encryption for sensitive items in the database
• Remove bag day for seasons >= 2020
• Added Discord as login provider
• Add Admin Event/Season filter sidenav's
• Fix minor GUI issues
  • Remove right sidenav
  • Replace tables in user profile with cards

Version 2.14.1

• changed sign in QR code to a url to allow native qr scanners
• Composer updates

Version 2.13.8

• Add/edit/delete school
• Fixed installer
• fix various typos
• Remove customized items from
• Update composer dependencies
• Remove last traces of hardcoded "Team 2363"
• Add exceptions to functions
• Prevent overlapping time slots
• Removed old functions
• Add Middleware to always pull token even if not required
• Added logic to limit information for event endpoint if not authed
• Added public /events page to view all events
• Prevent event registration changes after event starts. Admins can still make changes in admin section.
• Add logging and view under admin
• Add route names
• Add Github and Amazon Login providers
• Prompt for authentication prior to showing sign in list
• Update OAuth to use direct links and not Satellizer library
• Enable linking accounts
• Fix Facebook
• Fix "active users per Year" report. Limit time to only build season so there aren't duplicate entries
• Create initial rooms during event creation
• Add other user types
• Add ability for users to add additional hotel rooms
• Updated Javascript QR code scanning library
• Change max sign in length to 18 hours
• Fixed issue with submitting and denying missing hours requests

Version 2.12.0

• Simplified some code
• Upgraded Facebook API to 3.1
• Add master Cronjob - Linked individual cronjobs to main
• Add list of registered users to event page
• Fixed Sign in/out email
• Event Registration dialog - Only show Transportation section content once there is data
• Add standardized functions to reports
• update installer with CLI for DB information
• Add dialog to edit Google Form Mapping
• Add manifest endpoint for dynamic Manifest file.
• Update Composer libraries
• Update Annual and Event Requirement tables to not show inactive members who are not registered but have a placeholder record in DB
• Added ability to select multiple users on Event/Season Requirements tables

Version 2.11.0

• Add JSON field to season model to allow customization of google form columns mapping to DB
• Use 3rd party API to guess gender of new users
• Fix time slot issue with event registration
• Add toggle on event admin for Time Slots
• Fix profile event's check items & date format
• Added CodeFactor integration to review code, cleaned up a lot of the code base using identified issues
• Remove Service Account dialog and only display client email. Upload button now where modal button was.
• Fix Event Room model. Room Type value was not set correctly.
• Fix school names not displaying on admin users page

Version 2.10.0

• Added button to download latest responses from Google form
• Organized functions to poll Membership Form
• Updated Change User Status cronjob to execute on the last day of month
• Re-added google maps embed to event page
• Update look of Login Settings page
• Minor style changes
• Add Event Requirements toggles on Event Admin page & add server side logic to update
• Add button to test Slack notifications
• Update search queries to use best practice
• Add food options to event registration
• Add food order column to event admin page
• Add additional search methods on Admin Users, Admin Season, Admin Event
• Add weekly minimum hour requirement
• Update Composer

Version 2.9.0

• Add Monolog to app
• Add error checking for calendar syncing
• Event and Season registration will list all users who are Active or have a Registration
• Fix credential issue for Google APIs
• Removed Google Maps JavaScript API as it now requires a billing account
• Fixed disappearing deadline on sync or update

Version 2.8.0

• Minor fixes
• Upload form for Google Service Account Credentials file
• Fix initial install script
• Developing Roles and Permissions (not implemented yet)
• Created new Auth Class to set logged in user throughout app
• Fixed routes without requiring Admin Permissions
• Update composer decencies

Version 2.7.0

• Fix various styling issues
• Add setting to require a team email to login
• Replace login notification with toast
• Pull Google Calendar Event info for event registration deadline events
• Lazy load controllers, filters, services
• Update event registration menu. Simplify process.
• Update New Event Dialog. New Event Dialog -> Event Search.
• Added right-click context menu for Event Admin. Removed Edit Registration button.
• Updated event registration slack notifications.
• Added DB export before DB modifications

Getting Started

Prerequisites

• PHP 7.0 or greater
• MySQL

Installing

Clone Git Repo

git clone https://github.com/legoguy1000/FRC-Portal.git

Run initalInstall.php script located in (/api/app/)

php initalInstall.php

Go to https://realfavicongenerator.net/ and generate your favicons. place files in /favicons/.

To upgrade an existing install pull the latest version from git and run the postUpgrade.php script

git pull
php postUpgrade.php

Go to url and login using provided admin credentials and configure accordingly

Running the tests

Explain how to run the automated tests for this system

Break down into end to end tests

Explain what these tests test and why

Give an example

And coding style tests

Explain what these tests test and why

Give an example

Deployment

Add additional notes about how to deploy this on a live system

Built With

• AngularJS - The web framework used
• Angular Material - Theme
• PHP - Backend
• Slim PHP Framework - API framework
• Eloquent - OOP model
• MySQL - SQL Database

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

• Alex Resnick - Project Owner - legoguy1000

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

• Hat tip to anyone whose code was used
• Inspiration
• etc