Git it Together

Consolidate the tools you need to implement agile scrum on existing GitHub repositories.

Table of Contents

1. Usage
   1. Login
   2. Adding Repositories
   3. Adding and Removing Deliverables or Resources
   4. Deleting User Projects
   5. Utilizing Live Chat
   6. Using Video Chat
2. Installation
3. Database and GitHub API
4. Database Schema
5. GitHub API
6. Ideas for Future Contributions
7. Team

Login

Login through Auth O using your GitHub account. If you create an account instead of using GitHub, you will not be able to access your repositories.

Usage

Adding Repositories

Search your GitHub repos and add them using the drop-down list. Once added, your repos will be accessible from your profile. Note that if your repo is forked from a parent, the parent repo will be used as the source for the project. This allows you to collaborate with other users who forked the same repo.

Adding and Removing Deliverables or Resources

Fill out the form entirely and then submit, the lists will automatically update when you or anyone else adds/deletes deliverables/resources. To delete an item press the X that is located next to it. Deliverables will show up on Github as they are added or closed in the app.

Deleting User Projects

Click the trash icon to the right of the project name in the project view. This removes it from your list, but does not delete the project itself. If you delete a project by mistake, you can always re-add it in the project list view.

Utilizing Live Chat

Simply enter a message into the chat input bar and hit enter. Your message will be emitted to all other users in the same project and saved to the database. Your messages will persist even after you leave the project. Chat searching uses the existing chat data, and simply returns a parsed array of only chats that meet the chat term entries.

Using Video Chat

Each project comes equipped with a dynamically created Appear.in room. Simply click "enter room" to join your teammates in a live chat.

Installation

Fork and clone the respository to your local machine. Use npm install to install the required dependencies. To start the app you can use:

npm run build
npm start

or npm run quick which builds then runs.

Database and GitHub API

Database Schema

Project [id (integer), owner (string), get_repo (string), name (string), description (string)]

Resource [id (integer), project_id (integer, foreign key from Project), user (string), name (string), link (string)]

Deliverable [id (integer), project_id (integer, foreign key from Project), owner (string), task (string), status (string), due_date (string), progress (string), points (integer)]

UserProjects [id (integer), user (string), project_id (integer, foreign key from Project)]

Message [id (integer), user (string), text (string), room (string)]

Note: owner and user fields should always be a GitHub handle

GitHub API

Git It Together uses the GitHub API to obtain information about repositories. For more infomation see the GitHub Developer Guide.

Ideas for Future Contributions

• Display summaries and thumbnails of resources using Open Graph
• Create a custom video chat module
• Integrate Git It Together with GitHub issues
• Add ability to change deliverable categories
• Make assign deliverables a dropdown of users connected to the project (currently a text input)
• Display users connected to a project
• Give repo owners admin access over projects, including adding and removing users

Team

• Product Owner: James Mitchell
• Scrum Master: Meg Viar
• Development Team Members: Kyle Anson, Simon de Moor, Jordan Stubblefield

Legacy Team

• Product Owner: Faiz Mohammed
• Scrum Master: Mohammad Farooqi
• Development Team Members: Alex Moores, Seán Ellison-Chen