Application Flow

Challenge Platform Application Flow

Initializing data

The application makes use of seed files to ensure that content exists before it is run. This is a requirement to run the application; at a minimum, these models must be seeded in:

• States
• Districts
• Schools
• Challenge
• Experience Stage
• Idea Stage
• Recipe Stage

In addition to the above, the following must be introduced to the system, either through seed files or through the built-in Rails Admin interface. Without these, the end user will have no interaction points in the application.

• Themes
• Problem Statements
• Cookbooks
• Solution Stories

Administrative workflow

• Each transition to each step is made manually, by an individual capable of determining when the next step should be opened up. This is permitted in spite of the deadline to allow for a few late entries to be submitted.
• Each component of each stage (themes, problem statements, cookbooks, and solution stories) are to be entered in by hand, and as many as necessary are to be entered via Rails Admin.
• Presently, the UI ribbon only supports up to three of a theme, problem statement, cookbook, or solution story. More can exist but it will cause the ribbon to wrap.

Creating a new theme, problem statement, cookbook, or solution

The workflow for each of these is similar; the major differences is which object it's bound to.

1. Log in to the Rails Admin side of the application.
2. Navigate to the model you wish to create (e.g. if I wanted to create a new problem statement, I'd open "Problem Statements").
3. Click on the "Add New" tab.
4. Fill out the title. The description is not required for themes.
5. Attach it to the specific stage required. It will be available from a drop down menu.
6. Save!

Featuring Content (experience, idea, recipe, solution)

Content has the ability to be featured only by Community Guides. Other administrative, non-community guides will not be eligible to do this action, and a warning message may appear about this action.

To feature content:

1. Navigate to the content (Experiences, Ideas, Recipes, Solutions), and find the specific entry you wish to feature.
2. Click the "Edit" icon - a small pencil on the right hand side.
3. Find the "Featured" checkbox and select it.
4. Save!

Marking an idea as "Inspiration"

We permit the creation of ideas and allow them to be marked as "inspiration". They show up with a solid green background and are ordered in front of normal ideas. They can only be created via the Admin panel.

To mark an idea as "inspiration":

1. Navigate to "Ideas".
2. Search for the idea that one wishes to specifically mark as "Inspiration".
3. Click the "Edit" icon - a small pencil on the right hand side.
4. Find the "Inspiration" checkbox and select it.
5. Save!

Creating Solutions and Solution Stories

This is the most manual portion for administrators, as it entirely relies on them entering in the content required. To start, an administrator must have:

• Copy of content to be published
• Username/Email of the user who pioneered the solution
• Which experience(s) the solution was based off of
• Which idea(s) the solution was based off of
• Which recipe(s) the solution was based off of

Creating the Solution

1. Navigate to "Solutions" and click the "Add new" tab.
2. Fill out:

• Title
• Description
• Materials
• Effort (hours OR days OR weeks OR months, all lowercase)
• Links if needed
• Image if desired

3. Fill out the solution story here by selecting "Add a new Solution story". This will open up a modal with which to create a solution story.

4. Fill out the solution story:

• Title
• Description
• Image if desired

Be sure to bind it to the correct solution stage before saving.

5. Add the correct user to this solution.
6. Continue filling out:

• Community
• Conditions
• Evidence
• Protips

7. Create the steps to execute this solution by selecting "Add a new Step". This will open up a modal with which to create a new step.
8. Fill out:

• Title
• Description

Repeat Step 8 until you have reached the desired number of steps.

9. Fill in the experiences, ideas, and recipes that this solution links to by searching for them in the corresponding three boxes.

10. Save!

Basic Supported User Workflows

At a minimum, the Challenge Platform is capable of supporting these specified workflows. If there is any discrepancy in which this is not possible, you are encouraged to file a bug report and describe:

• What behavior you expect
• What behavior you're getting

Anonymous users

• Visit the home page
• Visit the Terms and Conditions page
• Visit the Privacy Policy page
• Visit the About Us page
• Register
• Authenticate with previously known and valid credentials
• View the current featured challenge
  • View any challenge, so long as a valid URL for it exists
• Interact with content in a non-persisted fashion (until one authenticates)
  • Comments
  • Voting
  • Suggestions
  • Ideas
  • Recipes
  • Solutions
• View another user's history

Registered users

• All of the above permissions of anonymous users, except:
  • Register
  • Authenticate

...as they have been presumed to pass these states.

• Save drafts of content

  • Comments
  • Voting
  • Suggestions
  • Ideas
  • Recipes
  • Solutions

• Publish content

  • Comments
  • Voting
  • Suggestions
  • Ideas
  • Recipes
  • Solutions

• View their own history

• Update their profile

• Upload an avatar

• Use their Twitter avatar