dotnet-estimation

With this project, we want to deliver a lightweight open-source tool for scrum-based workflows in which new task complexities can be easily estimated by the team and archived for a possible retrospective.

How to start the estimation application

Run the Application by executing the docker-compose up command in the root folder.

Routes

The estimation application's backend provides the following services and routes:

Session Status

Provides the user with information about if a session is valid and the task which is currently estimated.

• CRUD: GET
• Route: /estimation/v1/session/{id}/status
• Parameter
  • id: Session ID
• Returns statusResult-Object, including
  • bool isValid
  • TaskDto currentTask
    • long Id
    • string Title
    • string Description
    • string Url
    • Status Status
      • enum Status

Create Session

Enables a user to create a new estimation session.

• CRUD: POST
• Route: /estimation/v1/session/newSession
• Returns Session-Object, including
  • long Id
  • string InviteToken
  • DateTime ExpiresAt
  • List<Task> Tasks
  • List<User> Users
  • bool isValid

Add User to Session

Enables a user to join an existing and valid estimation session.

• CRUD: POST
• Route: /estimation/v1/session/{sessionId:long}/{userId}/joinSession
• Parameter:
  • sessionId: Session Id
  • userId: User Id
• Returns boolean
  • true if successful
  • false if unsuccessful

Add Estimation

Enables a user to provide an estimation during an existing and valid estimation session.

• CRUD: POST
• Route: /estimation/v1/session/{sessionId:long}/estimation
• Parameter
  • sessionId: Session Id
  • estimationDto: Object including string VoteBy and int Complexity
• Returns EstimationDto-Object, including
  • string VoteBy
  • int Complexity

Remove User from Session

Removes a user from an existing and valid estimation session.

• CRUD: PUT
• Route: /estimation/v1/session/{sessionId}/leaveSession/{userId}
• Parameter
  • sessionId: Session Id
  • userId: User Id
• Returns boolean
  • true if successful
  • false if unsuccessful

Invalidate/Terminate Session

Enables a user to invalidate/terminate an existing and valid estimation session.

• CRUD: PUT
• Route: /estimation/v1/session/{id:long}/invalidate
• Parameter
  • id: Session Id
• Returns boolean
  • true if successful
  • false if unsuccessful