Welcome to the mission control subteam! We hope that you will stick around and learn quite a bit of things about frontend development and networking! However, before you can do that, you should review the resources given in this document to familiarize yourself.
If completely new, please refer to the urc's getting_started.md as that gives an overall view of everything. For local development you will need to follow the instructions to setup Docker to run the urc-2023 repository.
The mission control is the human interface to communicate bidirectionally (Sends and receives information) with the rover. For example, sending joystick inputs to the rover or displaying the rover's camera feed in real time.
The urc-2023 repo is the code that is run on the rover itself. Due to the code being very hardware specific, the docker container you run on your computer ensures standardization with the rover. Think of the rover as the "server".
The mission-control repo is completely separate from the urc-2023 as it is webpage-based, meaning the code is ran in the browser—and with modern browsers' standardization of features, a docker container is not needed. Think of the mission control as the "client".
-
Vue DevTools Chrome Extension: Can Inspect Components State and integrated with Pinia, allowing to see store's state.
In this particular codebase, we use the following libraries/tools/technologies. Please familiarize yourself with the concepts below:
- Vue Official Tutorial (We specifically use Vue 3 Composition API Single File Component)
- Prop drilling
- Reactiveness (when to use refs vs not)
- Lifecycle Hooks
- Read about Keep Alive onActivate() and onDeactivated() hooks vs onMounted() and onUnmounted() hooks
- Typescript
- Difference between Primitives and object types and their respective naming convention
- Pinia (Global state management store)
- How to create a store
- How to use a store
- ROS2 (Robot Operating System)
- high level understanding of:
- Subscribers and Publisher paradigm
- Topics, messageTypes
- Please refer to the urc-2023 documentation for more information about Ros
- high level understanding of:
- HTML/SCSS
- Roslibjs Source Code
- Node Package Manager (NPM)
- Difference between dependency and Dev-dependency and when installing packages, which one to install too.
Please look at the mission-control GitHub issues and look for Good First Issue. Some issues might only require only a fraction of the concepts above like UI related ones.
If you got here this far. I really appreciate you reading the documentation :)
-Adam Chhor, creator of the mission control repository