User Stories

Detailed user stories go here using the following template:

US.X
Story	As a _______ I want to ______ so that I can ________.
Involved Actors	______
Tests	AC.1 - Acceptance test 1 AC.2 - Acceptance test 2
Priority	MVP (Must be in product), Secondary (should have if possible), Tertiary (left for a future extension of project)
Status	Proposed -> Accepted -> In Progress -> In Review -> Completed

Known Actors

The following people are expected to use the system

1. Citizen: Any member of the public, granted access to public records. They are not expected to be technically minded, nor to have any real knowledge of the types of data available to them.
2. Member: A member of any of the governing boards, produces the records, is expected to have intermediate technical ability and inherent knowledge of the types and topics of records available.
3. Admin: A user that administers and controls the backend of the system

MVP Requirements

The following user stories outline the MVP (minimum viable product), or the product in a state that could be turned over to the client and used as is. Therefore these user stories are a functional subset of the final features of the product, and will be completed before work on Secondary or Tertiary user stories begins. These requirements are organized according to the following envisioned process: Data Ingestion, Data Analysis, Data Presentation

Ingestion

US.1
Story	As an Admin I want the system to operate using data obtained from a Sharepoint data dump so that it is compatible with the current governance system.
Involved Actors	Admin
Tests	AC.1 - Data from the Sharepoint Excel dump is present in the resulting application's database
Priority	MVP
Status	Proposed

US.2
Story	As an Admin I want the system to operate using data obtained from PDF documents uploaded to the governance website so that these documents can be served to visitors.
Involved Actors	Admin
Tests	AC.1 - Can be demonstrated that a PDF uploaded to the website has had it's data loaded into the resulting application's database
Priority	MVP
Status	Proposed

Analysis

US.3
Story	As an Admin I want to have the system automatically detect new entities from structured data so that it can easily update its system's knowledge.
Involved Actors	Admin
Tests	AC.1 - Demonstration that a person located in the structured data dump is found and labeled as such in the system database AC.2 - Demonstration that a committee located in the structured data dump is found and labeled as such in the system database
Priority	MVP
Status	Proposed

US.3.1
Story	As an Admin I want to have the system automatically detect meeting topics from structured data so that it can easily update its system's knowledge.
Involved Actors	Admin
Tests	AC.1 - Demonstration that a meeting topics are found in the system database from a specific meeting.
Priority	MVP
Status	Proposed

US.4
Story	As an Admin I want to have the system process bodies of text (unstructured data) and discover new keywords (topics) it contains so that I can return search results looking for those words
Involved Actors	Admin
Tests	AC.1 - The system is able to identify at least 1 topic of discussion for each paragraph in a PDF. AC.2 - The system does not identify meaningless words, such as connectives ('and', 'or') or adjectives/adverbs, as topics.
Priority	MVP
Status	Proposed

US.5
Story	As an Admin I want to have the system automatically detect known topics from any text it is fed so that they can be later analyzed or organized.
Involved Actors	Admin
Tests	AC.1 - Names of individuals from the GFC committees are extracted and linked to a block of text containing those names AC.2 - Text naming any GFC committee is identified as a key word
Priority	MVP
Status	Proposed

US.6
Story	As an Admin I want to have the system automatically link topics or entities to any text that mentions them, so that they can be later recalled.
Involved Actors	Admin
Tests	AC.1 - A paragraph on one subject can be used to find a paragraph on the same subject from a different PDF AC.2 - Should be able to demonstrate a search for one key word returning results mentioning that key word from different sources
Priority	MVP
Status	Proposed

Presentation

US.7
Story	As a Member I want to be able to perform a basic search (containing only 1 keyword) in less than 2 seconds 98% of the time so that I can find PDFs I need before a meeting begins.
Involved Actors	Member
Tests	AC.1 - Enter a basic search term key phrase and press search, results should appear in less than 2 seconds AC.2 - Try a basic search with a very short or very long key word.
Priority	MVP
Status	Proposed

US.8
Story	As a Citizen or Member I want to perform an advanced search (containing up to 7 key words or filters) in less than 5 seconds 98% of the time so that I can get PDFs that match a very specific set of criteria.
Involved Actors	Citizen, Member
Tests	AC.1 - Enter a 7 search term key phrase and press search, results should appear in less than 2 seconds AC.2 - Try an advanced search with very short or very long key words AC.3 - Try an advanced search with multiple filters and multiple key words (7 total)
Priority	MVP
Status	Proposed

US.9
Story	As a Citizen or Member I want to have complete documentation of the search functionalities or query language so that I can learn what I can do to have better searches.
Involved Actors	Citizen, Member
Tests	AC.1 - Page exists on the final website outlining the language that can be used to make a specific search AC.2 - Page contains all possible search functionalities or, if too large, at least 5 functions and a link to more complete documentation
Priority	MVP
Status	Proposed

US.10
Story	As a Citizen or Member I want to have the option of building an advanced search from pre-defined drop-downs so that I can make an advanced search with little query language knowledge.
Involved Actors	Citizen, Member
Tests	AC.1 - A page exists with tools to help build a query AC.2 - The query builder tool permits access to all of the entity types in the database
Priority	MVP
Status	Proposed

US.11
Story	As a Citizen I want to see an interactive visualization of mention frequency when I perform a search so that I can understand when a topic has gone stale or if it is currently highly mentioned.
Involved Actors	Citizen
Tests	AC.1 - A search provides an automatic visulization of frequency of results AC.2 - The visualization responds to user actions
Priority	MVP
Status	Proposed

US.12
Story	As a Citizen or Member I want to be able to access the system from a mobile device presented in a mobile-friendly format so that it is more user-friendly.
Involved Actors	Citizen, Member
Tests	AC.1 - The system is accessible from a modern android or iOS mobile phone AC.2 - The search features return same results as on desktop AC.3 - The visualizations are still available on the mobile version (though performance may not be as smooth)
Priority	MVP
Status	Proposed

US.13
Story	As a Member I want to be able to search the full text of all PDFs so that I can find topics that are mentioned anywhere in a document.
Involved Actors	Member
Tests	AC.1 - Able to find exact matches to full sentences AC.2 - Able to find matches to headers and footers of PDFs AC.2 - Able to find matches to body paragraphs of PDFs AC.2 - Able to find matches to text inside tables on PDFs
Priority	MVP
Status	Proposed

US.14
Story	As a Citizen or Member I want to be able see which committees a member sits on.
Involved Actors	Citizen, Member
Tests	AC.1 - A page or visualization exists that details a members' joined committees
Priority	MVP
Status	Proposed

US.15
Story	As a Citizen or Member I want to be able to make a search from the front page so that I can quickly find PDFs without having to navigate menus.
Involved Actors	Citizen, Member
Tests	AC.1 - A search box is available on the front page AC.2 - Submitting a search from this box has at least all search functionalities that are present anywhere else in site.
Priority	MVP
Status	Proposed

US.16
Story	As a Citizen or Member I want to be able to see results that are related to the root word/derivative words of my search term so that I can find the exact topic anywhere in a document. (eg. ethics, ethical, ethically)
Involved Actors	Citizen, Member
Tests	AC.1 - A search for 'ethics' returns results from 'ethical' AC.2 - A search for 'diverse' returns results from 'diversity'
Priority	Secondary
Status	Proposed

US.17
Story	As a Citizen or Member I want my misspelled search term to be corrected so that I can find the correct topics from any document.
Involved Actors	Citizen, Member
Tests	AC.1 - Words that do not match a standard english dictionary or keywords are suggested alternatives from these sources when searched AC.1.1 - 'comittee' should suggest to correct to 'committee' for example AC.2 - Suggestions include key words that are not in the standard english dictionary
Priority	MVP
Status	Proposed

US.18
Story	As a Citizen or Member I want the search tool to resemble other search tools so that it builds off of previous user experiences in search.
Involved Actors	Citizen, Member
Tests	AC.1 - 70% of newly introduced users know within 5 seconds where to go to start searching.
Priority	MVP
Status	Proposed

US.19
Story	As a Citizen or Member I want the Graphical User Interface to be attractive and intuitive to encourage users to get involved and use the tool.
Involved Actors	Citizen, Member
Tests	AC.1 - 70% of first time users, when tasked with searching for a person, should be able to complete the search within 3 tries.
Priority	MVP
Status	Proposed

Secondary User Stories

These user stories describe features that extend or compliment those that will be found in the MVP. The goal is to either have the ground laid to implement these features in a future development, or to have them almost or completely developed by the end of the project. But they will not be implemented until the MVP is viable.

US.20
Story	As a Citizen or Member I want to be able to see synonyms and related topics to my search term. (eg1. ethics - moral, justice, human rights; eg2: Adam - Did you mean Adam Brown or Adam Smith?)
Involved Actors	Citizen, Member
Tests	AC.1 - Searching for a key word suggests similar key words in the data base if available AC.2 - Searching for an individual or committee should suggest similar individuals or committees
Priority	MVP
Status	Proposed

US.21
Story	As a Citizen I want to be presented with a list of predefined searches so that I can answer questions without knowing what is available to me yet.
Involved Actors	Citizen
Tests	AC.1 - A page exists in the final product with predefined searches available AC.2 - At least 4 searches are phrased as questions that can be answered by their search results
Priority	Secondary
Status	Proposed

Tertiary User Stories

These user stories describe features of the system that may be useful to keep in mind, but will not be implemented by the team at this time. This is useful for keeping track of which parts of the system need to be made extensible for future development.

US.22
Story	As a Member I want to be able to get a list of PDFs that will be relevant to my meetings today so that I can quickly get up to speed for a meeting.
Involved Actors	Member
Tests	AC.1 - NA
Priority	Tertiary
Status	Proposed

US.23
Story	As a Citizen I want to be able to tell the governance boards what sort of information I am looking for so that the tools can be improved.
Involved Actors	Citizen
Tests	AC.1 - NA
Priority	Tertiary
Status	Proposed

US.24
Story	As a Member or Admin I want to be able to see some statistics about searches that are being made so that I know how the tool is being used.
Involved Actors	Member, Admin
Tests	AC.1 - NA
Priority	Tertiary
Status	Proposed

US.25
Story	As a Citizen I want to see a visualization of the frequency at which topics are mentioned so that I can understand which topics are important or are currently being discussed.
Involved Actors	Citizen
Tests	AC.1 - NA
Priority	Tertiary
Status	Proposed

US.26
Story	As an Admin I want to be able to set viewing permissions on a PDF so that I can control if a PDF can be seen by only members or by members and the public.
Involved Actors	Admin
Tests	AC.1 - NA
Priority	Tertiary
Status	Proposed

US.27
Story	As a Citizen I want to see a visualization of committees and participants so that I can see who is in charge of/involved in certain issues.
Involved Actors	Citizen
Tests	AC.1 - NA
Priority	Tertiary
Status	Proposed

US.38, US.29, and US.30 were made Tertiary as per outline with client that MVP for this project should focus on exploring possible outcomes, not being an easily managed system.

US.28
Story	As an Admin I want to be able to provide an updated dump of data from our Sharepoint system (that matches the same schema as the original dump), and have the system automatically update its information, so that I can avoid manually updating the system.
Involved Actors	Admin
Tests	AC.1 - NA
Priority	Tertiary
Status	Proposed

US.29
Story	As an Admin I want to be able to provide a set of new PDFs, and have the system automatically scrape new text and update its information, so that I can avoid manually updating the system.
Involved Actors	Admin
Tests	AC.1 - NA
Priority	Tertiary
Status	Proposed

US.30
Story	As an Admin I want to be able to edit or remove PDFs so that I can control what information is accessible to the public.
Involved Actors	Admin
Tests	AC.1 - NA
Priority	Tertiary
Status	Proposed

US.31 was moved to tertiary as the knowledge graph feature was deemed interesting, but ultimately too much specific effort for this edition of the product

US.31
Story	As a Citizen or Member I want to view the key information about a searched entity so that I can learn about one quickly without making a lot of searches. (eg1. Member - Name, Role, Term Start, Term End, Status, Email Address, Faculty, Job Title, committees sits on etc. eg2: Committee - Name, Committee ID, Description, Committee Coordinators Names Etc.)
Involved Actors	Citizen, Member
Tests	AC.1 - NA
Priority	Tertiary
Status	Proposed