Entry point of OnTrack UIEnhancemnt
T3 / 2022
OnTrack is now a hybrid project which is using Bootstrap/AngularJS + MUI/Angular, it is build using different reusable components.
AngularJS support has officially ended as of January 2022. The code will remain accessible on GitHub, npm, Bower, and Release archive. This website will remain here indefinitely. The GitHub repository will be in an archived state, meaning that no new issues or pull requests can be submitted. CoffeeScript can be viewed as a fine complement to JavaScript, not a replacement.
Therefore, the OnTrack frontend is looking forward to switching to the new MUI/Angular approach and trying to keep things more up to date going forward.
Aims for Trimester
-
Testing new branch
- We have a special request from our director Andrew that we need to execute some on testing the doubtfire-web(quality/entity-service-to-npm) branch with doubtfire-api(refactor/entity-service-backend), write up some test scripts for people to run to verify that things work branch.
- Tests cases can just be actions for someone to perform. Now those branches have migrated much of the front end. We now need to exhaustively test it to make sure things work. Log the issue and report to director
-
Components Migration
- There is 168 components waiting to be migrated, in T3/2022, I hope we can continue the work that we left in previous trimester and assign some simple components for Juniors. Delivery lead should involve continuing the ongoing components, seniors should continue his work from previous trimester.
Deliverables
Short Term
- Gather information and continue the migration work that left from previous trimester.
- Develop and deliver at least 5 migrated components.
- Understand and plan for testing new branch
- Give Juniors OnTrack ASAP.
- Improve and fix outdated documents.
Long Term:
- Give enough passion for junior to involve into the same project next trimester
- Extent documentation for new member to be able to understand the project quickly.
What to do next
If you are new member into this team, welcome! and we are going to guide you step by step to show you what you sould do next if you are:
Junior
As a junior we suggest that you should:
- Do Upskilling understand the basic of AngularJS and Angular framework.
- Learning AngularJS A Guide to AngularJS Development (ISBN 978-1491916759)
- Angular JS tutorial
- To be added in next-trimester
- Set up the project on your local machine. For Windows user, you need to do an extra step to
inistall a WSL2 virtual machine. Make sure you dont have VMware or VirtualBox installed that
will enable the HyperV feature which conflict with Docker.
- Windows (WSL2)
- Follow Docker Compose with WSL2 guideline.
- Read Docker Setup Tutorial guideline.
- Watch
Docker Setup Tutorial
Please note that the tutorial used Windows CMD enviroment, it should use WSL2 machine instead. See the issue.
- Mac / Linux
- Read
Docker Setup Tutorial
guideline.
If the servers in the docker running into issues, please follow the backup plan - Troubleshooting Docker - Backup for OnTrack
- Read
Docker Setup Tutorial
guideline.
- Windows (WSL2)
- Migration
- Read Create Brach and Initial Migration guideline.
- Read Regular Commit guideline.
- Testing
- Read Unit Test guideline.
- Do report any issue or questions to the senior or deilvery lead.
- Writting docemnts during the learning process which you found intresting or worth to know.
- Start to migrate some simple components.
Senior
- Answer question from junior report the issue to the lead if no solution.
- Carry on the components that are in the middle of migrating in last trimester.
Once again, welcome to the team!