Content Management/Use Cases: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
No edit summary
Line 352: Line 352:


[[Image:Use_Cases.jpeg]]
[[Image:Use_Cases.jpeg]]

Browse through Content - John <br>
Download Content - John<br>
Crud Content - John<br>
View Recent History - Jason<br>
View system statistics - Jason<br>
Admin search for content (more powerful search) - Jason<br>
hide content - Paul<br>
Log into the system - Mike<br>
Log out of the system - Mike<br>
Submit content via e-mail - Paul<br>
Submit content via FTP - Paul<br>
Tag Content - Mike

Revision as of 21:13, 15 October 2007

Use Case 1 - Submitting Content via Web Interface

Use Case UC1: Submitting Content via Web Interface

Level: Content Submitter-level goal

Primary Actor: Content Submitter

Preconditions: Content submitter is logged into the system and has something that needs to be submitted

Stakeholders and their Interests: Content Submitter: Wants to help the OLPC project and submit their content with minimal effort. OLPC User: Wants to have content available to learn from or reference. Administrator: Wants to make sure all content is appropriate and tagged properly.

Main Success Scenario:

  1. Content submitter (CS) is at main submission page with content ready to upload.
  2. CS selects files to upload.
  3. CS enters the title and appropriate tags for the content.
  4. CS reviews submission once again before submitting.
  5. System presents CS with a confirmation notice that content was submitted properly.

Extensions:

  • 3a. Content submitter does not enter some necessary information (title, tags, or selection of content):
    • 1. System notifies the CS that necessary information is missing and asks them to enter it.

Use Case 2 - Retrieving Content

Use Case UC2: Retrieving content

Level: User-level goal

Primary Actor: End User

Stakeholders and their Interests: OLPC User: Wants to look quickly look through/for content in a general category

Main Success Scenario:

  1. User arrives at start page.
  2. User selects language for content they wish to view
  3. User selects general category for content they are interested in
  4. User refines subcategory for content

(User repeats step 4 until subcategory is specific enough)

  1. User chooses relevant document to view

Extensions:

  • a. System may fail to render content page:
    • 1. User goes back.
    • 2. User tries to view content again.
  • 5a. Content doesn't exist
    • 1. User goes back and tries different categories

Special Requirements: Language localization on prompts, text based content, and descriptions/tags

Use Case 3 - Translating Content

Use Case UC3: Translating Content

Level: Content Submitter-Level

Primary Actor: Content Submitter

Preconditions: User has found a page that they would like to translate.

Stakeholders and their Interests: OLPC User: Wants to view content in their native language.

Main Success Scenario:

  1. Content Submitter (CS) Select translation submission option.
  2. CS translate content and tags content with new language.
  3. CS submits new content.
  4. System presents CS with a confirmation notice.

Post Conditions: Newly translated content is processed and made available by the system.

Open Issues: Translation already exists.

Use Case 4 - Search via Web Interface

Use Case UC4: Search via Web Interface

Level: User-level goal

Primary Actor: User

Stakeholders and their Interests: User: Wishes to find relevant content

Main Success Scenario:

  1. User displays search page
  2. User inputs search terms
  3. User indicates that search may begin
  4. Results are displayed, ranked by relevancy
  5. User selects a result (View Use Case commences)

Extensions:

  • 4a. No results
    • 1. User is notified that no results were found
  • 4b. Search term invalid
    • 1. User is notified that the search term was invalid
    • 2. Search page redisplayed

Special Requirements: Interface supports internationalization

Open Issues: Which specific issues make a search term invalid

Use Case 5 - Hide Content

Use Case UC5: Hide Content

Level: Administrator-Level

Primary Actor: Administrator

Preconditions: Administrator is logged into the system and on the page they want to remove

Stakeholders and their Interests: Administrator: Wants to temporarily remove a page from public view.

Main Success Scenario:

  1. Administrator clicks on hide page link.

Post Conditions: Page is no longer available to non-Administrators

Use Case 6 - Submit Content Via E-mail

Use Case UC6: Submit Content via E-mail

Level: Content Submitter-level

Primary Actor: Content Submitter

Preconditions: Content submitter has e-mail program open

Stakeholders and their Interests: Content Submitter: Wants to help the OLPC project and submit their content with minimal effort.
OLPC User: Wants to have content available to learn from or reference.
Administrator: Wants to make sure all content is appropriate and tagged properly.

Main Success Scenario:

  1. Content submitter (CS) has new e-mail window open
  2. CS puts the title and appropriate tags for the content in a text file labeled tags.
  3. CS selects tag file and content to upload.
  4. CS sends email to auto submitter address.
  5. System sends confirmation e-mail to CS
  6. CS checks e-mail for confirmation of receipt.

Extensions:

  • 3a. Content submitter does not send attached text file:
    • 1. CS reads e-mail sent by system with error message.

Open Issues: Should zip files or other archive formats be required

Use Case 7 - Submit Content via FTP

Use Case UC7: Submit Content via FTP

Level: Content Submitter-level

Primary Actor: Content Submitter

Preconditions: Content submitter has ftp program open

Stakeholders and their Interests: Content Submitter: Wants to help the OLPC project and submit their content with minimal effort.
OLPC User: Wants to have content available to learn from or reference.
Administrator: Wants to make sure all content is appropriate and tagged properly.

Main Success Scenario:

  1. CS puts the title and appropriate tags for the content in a text file labeled tags.
  2. CS creates a zip file named after their login, containing content and tags file
  3. CS uploads zip file.
  4. System sends confirmation e-mail to CS
  5. CS checks e-mail for confirmation

Extensions:

  • 3a. Content submitter does not send correctly formatted file:
    • 1. System sends e-mail with error message.


Use Case 8 - View Recent History

Use Case UC8: View Recent History

Level: Administrator-level

Primary Actor: Administrator

Preconditions: Administrator is logged into the system and at the history view page

Stakeholders and their Interests: Administrator: Wants to review recent changes in the system

Main Success Scenario:

  1. Administrator selects the types of information he/she wants to review and sends the request.
  2. System displays history

Extensions:

  • a. System may fail to render history page.
    • 1. Administrator resends request.

Use Case 9 - View System Statistics

Use Case UC9: View system Statistics

Level: Administrator-level

Primary Actor: Administrator

Preconditions: Administrator is logged into the system and at the statistics page

Stakeholders and their Interests: Administrator: Wants to see the statistics of the system

Main Success Scenario:

  1. System displays the statistics.

Extensions:

  • a. System may fail to render statistics page.
    • 1. Administrator refreshes the statistics page.

Use Case 10 - Administrative Search For Content

Use Case UC10: Administrative Search For Content

Level: Administrator-level

Primary Actor: Administrator

Preconditions: Administrator is logged into the system and at the administrator search page

Stakeholders and their Interests: Administrator: Wants to see the statistics of the system

Main Success Scenario:

  1. Administrator inputs search terms
  2. Administrator selects search conditions.
  3. Administrator indicates that search may begin
  4. System displays search results, ranked by relevancy.
  5. Administrator selects a result. (View Use Case commences)

Extensions:

  • 4a. No results
    • 1. Administrator is notified that no results were found
  • 4b. Search term invalid
    • 1. Administrator is notified that the search term was invalid
    • 2. Search page redisplayed

Special Requirements: Interface supports internationalization

Open Issues: Which specific issues make a search term invalid

Use Case 11 - Browse Through Content

Use Case UC11: Browse Through Content

Level: User-level goal

Primary Actor: User

Stakeholders and their Interests: User: Wants to retrieve related content

Main Success Scenario

  1. User finds some content and would like to view related material
  2. Links are available in the current content for users to follow that will lead them to the related material
  3. Linked content is displayed, along with links to things relating to new material

Special Requirements: Links to related content may need to be in multiple languages

Use Case 12 - Download Content

Use Case UC12: Download Content

Level: User-level goal

Primary Actor: User

Stakeholders and their Interests: User: Wants to make content available offline/locally

Main Success Scenario

  1. User finds content that they would like to download
  2. User selects to download the content
  3. Content is downloaded

Special Requirements: User must have enough disk space available for the content to be stored locally

Use Case 13 - CRUD Content

Use Case UC13: CRUD Content

Level: Administrator-level goal

Primary Actor: Administrator

Preconditions: Administrator is logged in

Stakeholders and their Interests: Administrator: Wants to make modifications to submitted content

Main Success Scenario

  1. Administrator finds content that they'd like to manipulate
  2. Administrator creates (tags), retrieves, updates, or deletes the content
  3. A summary of the changes is presented
  4. Administrator accepts and submits changes

Extensions:

  • 4a. Administrator does not want to submit changes
    • 1. Administrator selects to cancel the changes instead of submitting them

Open Issues: What type of manipulation can the administrator do?

Use Case 14 - Log Into The System

Use Case UC14: Log Into The System

Level: Administrative-level goal, submitter-level goal

Primary Actor: User

Stakeholders and their Interests: User: Wishes to access restricted functions

Main Success Scenario

  1. User visits restricted page
  2. User inputs OpenID identifier
  3. User indicates input completion
  4. Restricted page displayed

Extensions

  • 4a. Failed login
    • 1. User is notified that login failed
    • 2. Login page redisplayed
  • 4b. User prompted for password
    • 1. User inputs password
    • 2. User indicates input completion

Special Requirements: User understands how to use OpenID

Use Case 15 - Log Out Of The System

Use Case UC15: Log Out Of The System

Level: Administrative-level goal, submitter-level goal

Primary Actor: User

Stakeholders and their Interests: User: Wishes to end login session

Main Success Scenario

  1. User selects logout item
  2. Confirmation message displayed


Use Case 16 - Tag Content

Use Case UC16: Tag Content

Level: Administrative-level goal

Primary Actor: User

Stakeholders and their Interests: User: Wishes tag content

Main Success Scenario

  1. User visits content administrator page
  2. User inputs tags
  3. User indicates input completion
  4. Confirmation displayed


Use Cases.jpeg