Skip to content

A Retrospective Facilitation App build for a MSc in Digital Technology Solutions

License

Notifications You must be signed in to change notification settings

DMurf/Introspective

Repository files navigation

Contributors Forks Stargazers Issues MIT License


Logo

Introspective

A retrospective-enabling tool, built for DTSS submission for Northeastern University.

View · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

This project is the final output of my DTSS MSc, delivering an application to facilitate Retrospectives based on other service offerings, peer-reviewed articles, and user research and feedback.

Environment URL Status CodeCov
Production https://introspective.azurewebsites.net/ GitHub Actions Workflow Status codecov
Test https://test-introspective.azurewebsites.net/ GitHub Actions Workflow Status N/A

(back to top)

Built With

(back to top)

Getting Started

This is an AspNet MVC application, using npm for content.

Installation

This guide takes the following assumptions:

  • You already have npm and visual studio installed
  • You have access to a Microsoft SQL server and with enough permissions to run scripts, create databases, and stored procedures.
  • You have an Azure B2C tenant (if not, see below)
  1. Clone
https://github.com/DMurf/Introspective.git
  1. Navigate to root

  2. Run Introspective.sql located in Introspective/_ScriptOut/ Introspective

  3. Update appsettings.json ConnectionString with your connection string

  4. Run Tests + npm install

  5. Enjoy!

(back to top)

Azure B2C

If you don't have an Azure B2C tenant set up already, follow this guide from Microsoft, as a minimum you'll need to follow Tutorials 1-3. This will leave you with:

  • An Azure B2C tenant
  • A registered web application (for example Introspective)
  • Sign Up and Sign In, logout, and password reset user flows

In the Introspective.Web/appsettings.json file the following lines need to be completed

"AzureAdB2C": {
    "secretValue": "",
    "secretId": "",
    "Instance": "",
    "ClientId": "",
    "Domain": "",
    "SignedOutCallbackPath": "/profile/gone",
    "CallbackPath": "/signin-oidc",
    "SignUpSignInPolicyId": "B2C_1_signupsignin",
    "EditProfilePolicyId": "B2C_1_profileediting"
  }

Usage

Getting started!

  • Navigate to the home page
  • Click on the Register/Sign In link
  • Navigate to the bottom of the page and click "Sign up now"
  • Register with Azure B2C (Microsoft hold your details, not me!)
    • You'll need to get a code from Microsoft via email confirming your email address
  • Once registered, sign in.
  • Navigate to the dashboard in the top navigation

Administrative

If you are an administrator the Admin navigation link will work for you

  • Click on it once signed in
  • You will be able to see Boards, Projects, and Sprint on the left hand-side
  • Navigate to them and add new of whatever you need

Use of dashboard

The Dashboard will list your projects, boards, and sprints. It will also let you enter your "Niko niko" for that sprint and view the "Niko summary" for the sprint.

If you are an super admin you can add users to Projects on the dashboard.

Front page

Front page in dark

Retroboard

Front page in dark

Permissions

This application has three permissions levels:

  • 0 - Participant
  • 1 - Delivery Manager/Scrum Master (Admin)
  • 2 - Super Admin

By default all users are created as participant, but an appsetting key exists to enable "Power Mode" this allows any participant to boost themselves to DM level. This can be disabled in the appsetting but if enabled the logged in user can navigate to /Profile/MakeDM and they will be able to function as a DM.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Project Link: https://github.com/DMurf/Introspective

(back to top)