Topcoder-X Processor - Gitlab unit tests

Challenge Objectives

• Topcoder-X is a node web application used by copilots to manage direct tasks.

• This challenge will implement unit tests to ensure the processor and receiver work as expected for Gitlab projects.

Project Background

• Topcoder-X is a new framework we are building to allow for easy, transparent integration with Gitlab and Github for managing tasks on Topcoder through Gitlab and Github issues.  Each issue on Gitlab or Github will be automatically associated with a specific challenge on Topcoder and this challenge will be updated automatically for assignee, prize, etc... and it will be opened and closed for payment as the Gitlab or Github ticket is opened, modified, and closed.

• Future challenges will tweak the existing functionality based on feedback from copilots, fix bugs, and will implement new functionality.

Technology Stack

• Node is used as the main language for Topcoder-X.  

• MongoDB is used for data storage, and Kafka is used for message queueing

• We currently deploy to Heroku.  There are 3 instances needed - receiver, processor, and the UI

• Note that this environment takes a fair bit of configuration to get all the pieces set up and working together.  Please ensure you budget a proper amount of time to work through deployment issues.

Code access

There are currently three pieces to this app:

* Topcoder-X Receiver (https://github.com/topcoder-platform/topcoder-x-receiver)

* Topcoder-X Processor (https://github.com/topcoder-platform/topcoder-x-processor)

* Topcoder-X UI (https://github.com/topcoder-platform/topcoder-x-ui)

The receiver handles incoming messages on activity from both Gitlab and Github.  These messages are passed as part of webhook callbacks that are supported on each platform.  The receiver parses these messages from the Gitlab or Github specific format, creating new, consolidated messages that get pushed into Kafka and then "processed" by the processor.

The UI is going to be used by copilots and others to set up the necessary settings for individual projects in Topcoder-X, including all the repo and Topcoder project information.  It will also be used by copilots to have a centralized view of all their projects at once.

You can find detailed information on deployment and configuration here:

https://github.com/topcoder-platform/topcoder-x-ui/blob/develop/TopcoderXDeploy.md 

Individual requirements

This ticket is the major requirement for this challenge:

• https://github.com/topcoder-platform/topcoder-x-processor/issues/8

Deployment guide and validation document

You must provide:

An README.md that covers:

• Local deployment and how to run the tests

• Heroku deployment

• Configuration for the receiver, processor, and UI

A comprehensive validation.md that covers:

• How to validate the output of the unit tests and ensure that no issues or other items are left opened

Validation video / screencast

• No video is required for this challenge.

What To Submit

 

• A patch file that targets the “develop” branch of https://github.com/topcoder-platform/topcoder-x-processor

• Ensure your patch file updates the deployment documentation in the README, if necessary

• A Validation.md that covers the details above

Final Submission Guidelines

Please see above