Project requirements
Executive summary
SAPAA is a nonprofit society that aims to support and protect Alberta’s government’s areas which are, the Provincial and Wildland Parks, Wilderness Areas, Ecological Reserves, Natural Areas and Provincial Recreation Areas. As such, ACS_Checkin is going to provide an Occupational Health and Safety compliant check_in service to streamline and improve current data-collecting processes. This will be done by submitting a form that will be then configured into a report on these areas. The main clientele for this project will mainly be individuals 60+ years of age who are interested in volunteering and protecting their nearby ecological communities.
Project glossary
- Site: A Site is a single protected area that SAPAA covers.
- SAPAA: Stewards of Alberta’s Protected Areas Association.
- Toolbox Safety Check: An OHS-compliant form that helps ensure user safety.
- Tool: The tool is a mobile application.
- Admin: An administrator that compiles the data into a report that will then be posted.
- Cached: Information currently inputted remains if a user changes applications/leaves the application.
- CSV file: Comma-separated values text sheet that can then be manipulated for data recording purposes
- UI: User-Interface; functionality where the user directly interacts with what is on their device
User Stories
US 1.01 - General Information About User
As a User, I want to input my general information in a form so that the tool can gather, who I am, when I have visited a particular site, as well as my location.
Acceptance Tests
- User can input their email address in a text field.
- Users can enter who they are (Guest, or previously identified steward)
- Users can input their first and last names
- Users can input their phone number
- Users, through a checkbox, can select if they are a SAPAA member or not
- Users can input the date of their visit
- Users can select a location (Dropdown list or geolocation)
- Users can self-identify if they are a designated government steward, a citizen steward or a guest
US 1.02 - Site Impressions
As a User, I want to input my general impression of the site, so that I can rate how natural the site is as well as input a detailed description of the site.
Acceptance Tests
- Users can rank a site from 0-4 on how natural a site is
- A User cannot click more than one option and clicking an option is mandatory to continue the form
- Users can write general information about the site with an appropriately formatted textbox
US 1.03 - Visit to Protected Area Details
As a User, I want to be able to document my visit so that I can track how long my trip duration was as well as my intention of visiting the site.
Acceptance Tests
- User can input how long their visit was
- Users can then input why they went from a list of given options (Visit nature, Hiking, Birding, Plant identification, Mushrooming, Historical/Cultural (e.g. signed nature trail), Canoeing/Kayaking, X-country Skiing, Snowshoeing, Winter hike, Night Sky Observations, Hunting/Trapping, OHV/Quading, PA Site inspection for SAPAA.)
- Users can click numerous options on why they went, however, can only click one option for how long the visit was
US 1.04 - Information about Services at the Site and Biological Observations
As a User, I want to input information about services available at the site so that I can provide comprehensive details about the amenities present.
Acceptance Tests
- Users can list available services such as (Parking lot or parking for 2 or more cars, Washroom, Directional signs on Feeder roads, Entrance signs, information, etc.)
- Users can describe the condition or quality of the services provided and some biological observations in the text field
- Users can input through a checklist if they submitted a report to Inaturalist as well.
- Users can report on the designation of a protected area: (Signage, Fencing, Fences, Stiles, Gates, Exists but in disrepair.)
US 1.05 - Information about Human Disturbances
As a User, I want to input information about human disturbances observed at the site, so that I can document any impacts on the environment caused by human activities.
Acceptance Tests
- Users can report Agricultural Activities such as Domestic Animal Grazing, Seeded Crops, None noted, or Other (see comments).
- Users can report Resource extraction activities like Oil/Gas wells, Mining (e.g. gravel), Tree Harvesting, Bark Stripping, Hunting (observed, blinds, etc.), Collecting/Trapping, Poaching (e.g. an animal dressing site out of season), None Noted, or Other (see comments).
- Users can report Motorized disturbances (ATV or vehicle activity) such as Off-Highway Vehicles (e.g. quads, motorbikes), 4×4 vehicles, None Noted, or Other (see comments).
- Users can report Animal or self-propelled activities including Hiking Trails, Biking Trails (e.g. mountain bikes), Fishing, Bird Watching, Botanical pursuits (e.g. plant identification), Picnicking, X-Country Skiing, Snowshoeing, None Noted, or Other (see comments).
- Users can report Gathering and Dumping Activities like Camping (lean-to's, fire rings, etc.), Buildings (non-industrial, e.g. trailers, sheds), Homeless camps, ‘Bush party’ sites (e.g. bottles), Recent fires or burns, Garbage dumping, None Noted, or Other (see comments).
- Users can report Infrastructure encroachment such as Power lines, Roads, Cut lines, Pipelines, Diversion of water (culverts, etc.), None Noted, or Other (see comments).
US 1.06 - Information about Work to Be Done
As a User, I want to input information about what work needs to be done at the site, so that I can communicate necessary maintenance or improvement tasks.
Acceptance Tests
- Users can specify Remediation/Protection Activities Needed with options such as Nothing, all good, Fencing, Re-vegetation, Invasive Weed Removal, Cleanup, Signs, Continued Monitoring, Fence maintenance, Educating Neighbours about Site Usage, or Other (see comments).
- Users can indicate recent actions taken to help the site including (Visit and Submitted This Report!, Signs Installed, Cleanup, Weed Control, Fencing, Talked to nearby residents, or Other (see comments).)
US 1.07 - Media Submission with Report
As a User, I want to input any media files (e.g., photos, videos) to submit with the report, so that I can provide visual evidence or context to support my observations.
Acceptance Tests
- Users can upload media files directly from their device.
- Accepted file formats include jpg, png, mp4, etc.
- Users can add captions or descriptions to the media files for clarity.
US 1.08 - Form Data Persistence
As a User, I want the data I input into my report to be cached, so that I can leave and come back to my report and not lose any progress.
Acceptance Tests
- Text field inputs will persist upon closing and reopening the app
- Drop-down fields will persist upon closing and reopening the app
- Checkboxes will persist upon closing and opening the app
- Information remains if the user is not connected to the internet
US 1.09 - UI Is Easily Readable
As a User, I want to be able to easily read all the text on the form while using reading glasses, so that I can accurately input my information without difficulty.
Acceptance Tests
- The user does not have to read small font-size text
- The user can zoom in to enlarge UI
US 1.10 - Input Non-Text Information Efficiently
As a User, I want to be able to complete the buttons and the drop-down menus in less than 90 seconds, so that I can complete the form in a timely manner.
Acceptance Tests
- Drop-down selection should close the drop-down upon selection
- Text for a button or a drop-down would be entirely visible on the screen (the user should not have to scroll to read the whole prompt)
- Buttons should be large enough that the user does not have a hard time selecting them
- Drop-down options should be large enough that the user does not have a hard time selecting them
US 1.11 - SAPAA Branding
As a User, I want to be able to see SAPAA branding, so that I can clearly see what organization the app is for.
Acceptance Tests
- Users can read SAPAA in large letters at the top of every screen
- Users can read “Stewards Helping Stewards” in smaller letters underneath at the top of the screen
US 1.12 - Integrated Text/Video Help
As a User, I want to be able to click a button and reveal additional information, so that I can get extra help when I don't understand a prompt.
Acceptance Tests
- Users can click the button next to the prompt
- The user sees a small pop-up window appear
- The pop-up is filled with text, or if a video is provided, the system plays the video
US 1.13 - Automatic Location
As a User, I want the app to know my current location, so that I can automatically find what site I am at and what sites are nearby.
Acceptance Tests
- The user gets prompted to ask if they would like to enable location
- The user’s Location field gets automatically filled out
- The user is still able to select a location manually
- A user can open a map and see nearby locations
US 1.14 - Image Size Reduction for SAPAA Standard
As a User, I want the tool to offer to reduce the size of images to SAPAA image management standard prior to submission, so that I can ensure compatibility and efficient handling of images.
Acceptance Tests
- The tool prompts the user to resize images to meet SAPAA standards before submission.
- Users can opt to resize images with a single click.
- The resized images maintain acceptable quality while meeting SAPAA standards.
US 1.15 - Reminder to Crop Images
As a User, I want the tool to remind me to crop images before submission with no minors in the photo, so that I can ensure legal and ethical compliance with image usage.
Acceptance Tests
- The tool displays a reminder to crop images before submission.
- Users are prompted to verify the absence of minors in the photo.
US 1.16 - Video Size Reduction for SAPAA Standard
As a User, I want the tool to reduce the size of video images to SAPAA image management standard prior to submission, so that I can ensure compatibility and efficient handling of videos.
Acceptance Tests
- The tool provides an option to resize videos to meet SAPAA standards before submission.
- Users can choose to resize videos with a single click.
- The resized videos maintain acceptable quality while meeting SAPAA standards.
US 1.17 - Video Renaming per SAPAA Style
As a User, I want the tool to offer to rename videos per SAPAA image management style prior to submission, so that I can ensure consistency and organization in file naming conventions.
Acceptance Tests
- The tool presents an option to rename videos according to the SAPAA image management style.
- Users can select the renaming option, which automatically adjusts the video filenames.
- The renamed videos adhere to SAPAA naming conventions.
US 1.18 - Selection and Flagging of Multiple Videos for Transmission
As a User, I want to be able to select and flag multiple videos on the same device for transmission as part of the Site Inspection Report, so that I can efficiently include relevant videos in the report.
Acceptance Tests
- The tool allows users to select multiple videos stored on the same device.
- Users can flag selected videos for transmission as part of the Site Inspection Report.
- The flagged videos are included in the report transmission process.
US 1.19 - Image Renaming per SAPAA Style
As a User, I want the tool to offer to rename images per SAPAA image management style before submission, so that I can ensure consistency and organization in file naming conventions.
Acceptance Tests
- The tool provides an option to rename images according to the SAPAA image management style.
- Users can choose the renaming option, which automatically adjusts the image filenames.
- The renamed images adhere to SAPAA naming conventions.
US 1.20 - Remember User Information
As a User, I want to be able to have my general information filled out automatically, so that I can save time from filling out my personal information every time.
Acceptance Tests
- The user’s general information section is filled in automatically
- Users can disable this if they would like to fill it out manually
US 2.01 - Toolbox Safety Check Before Form Submission
As a User, I want to be able to complete a toolbox safety check before submitting the form, so that I can ensure I have the necessary equipment and knowledge for safe site visitation.
Acceptance Tests
- The user is required to fill out a ‘toolbox safety’ check before each site visit.
- The user must answer questions that include:
- Who Are You? ACS confirms who is on the site visit including other ACS volunteers, guests of the volunteer, or counts of other individuals.
- Are You Alone? A reminder to the volunteer to let someone know where they are if they are travelling alone.
- Where Are You? An interactive map will allow the volunteer to confirm their geographic location or select a different location if necessary.
- Weather Preparedness. Weather conditions are captured, and the volunteer can add other details.
- Are You Ready? Based on the site and time of year, a series of short questions are asked in the form of a hazard assessment, examples: Wildlife encounters (bears, rutting ungulates), Traveling equipment (snowshoes, good footwear), Stranded Readiness depending on the site and distance from the vehicle.
US 2.02 - Toolbox Safety Check Completion in <90 Seconds
As a User, I want to complete the toolbox safety check in less than 90 seconds, so that I can efficiently prepare for my site visit without undue delay.
Acceptance Tests
- The toolbox safety check interface is designed for quick and intuitive completion.
- Users can navigate the checklist and confirm items rapidly.
- The system provides feedback or alerts if users spend too much time on any particular item, encouraging swift completion.
US 2.03 - 30 Minute check-in functionality
As a User, I want to be notified every 30 minutes with a check-in notification, so that if a check-in is missed, the application will continue to contact and provide an escalation procedure.
Acceptance Tests
- The application offers a 30-minute check-in
- If a check-in is missed, the application continues to contact the user
- The application has an escalation procedure to the ACS community until contact is re-established.
US 3.01 - Export Data as CSV
As a User, I want to export data collected in the form of a CSV file, so that I can analyze or share the information in other applications or formats.
Acceptance Tests
- Users can access an option to export form data from the application.
- The exported CSV file includes all relevant fields and entries from the form.
- The CSV file is compatible with Google spreadsheet software for easy manipulation and sharing.
US 3.02 - Read Data From Google Sheets
As an Admin, I want to be able to read the data from any submitted form in Google Sheets, so that I can review the submission and create a web post based on the inspection report.
Acceptance Tests
- Data from form submission automatically fills in a row in Google sheets
- Images are represented by a link in the Google sheets
- Test that submitting a report accurately fills the correct cells in Google sheets
US 4.01 - Achievements
As a User, I want to be able to look at my profile and see achievements that I have earned from filling out reports, so that I can see progress based on filling out reports and compare with others using the app.
Acceptance Tests
- User can open their profile and see achievements
- Users can see other people's achievements and how they compare to them
MoSCoW
Must Have
- US 1.01 - General Information About User
- US 1.02 - Site Impressions
- US 1.03 - Visit to Protected Area Details
- US 1.04 - Information about Services at the Site and Biological Observations
- US 1.05 - Information about Human Disturbances
- US 1.06 - Information about Work to Be Done
- US 1.07 - Media Submission with Report
- US 2.01 - Toolbox Safety Check Before Form Submission
- US 2.02 - Toolbox Safety Check Completion in <90 Seconds
- US 3.01 - Export Data as CSV
Should Have
- US 3.02 - Read Data From Google Sheet
- US 1.08 - Form Data Persistence
- US 1.09 - UI Is Easily Readable
- US 1.10 - Input Non-Text Information Efficiently
- US 1.11 - SAPAA Branding
Could Have
- US 1.12 - Integrated Text/Video Help
- US 1.13 - Automatic Location
- US 1.14 - Image Size Reduction for SAPAA Standard
- US 1.15 - Reminder to Crop Images
- US 1.16 - Video Size Reduction for SAPAA Standard
- US 1.17 - Video Renaming per SAPAA Style
- US 1.18 - Selection and Flagging of Multiple Videos for Transmission
- US 1.19 - Image Renaming per SAPAA Style
Would Like But Won't Get
- US 1.20 - Remember User Information
- US 4.01 - Achievements
Similar Products
-
- Recording and documenting information on biodiversity, species identification and observational data.
- INaturalist will be used as inspiration for app design, data tools integration, Interactive Map as well as general formatting on how an app based around documenting biodiversity may look like.
-
- SIREN is a collaborative citizen science platform enabling coastal communities and scientists to monitor and safeguard endangered marine mammals through data collection and analysis
- Siren will be used as inspiration for design in conservation efforts and data collection procedures
-
- App to monitor rare and common animals.
- This project it quite similar in functionality to our own. This helps us with inspiration on which features would be most useful and UI that works for those features.
Open-source Projects
-
- open-source online form builder.
- The application lets a user build forms in their browser on their own or from a template. This is very useful for us because we can experiment with the builder and see what options make the user experience the most streamlined without having to develop every single idea we have. From there we can get ideas on specific implementation based on the ideas we explored in the builder.
-
- Open-Source javascript form builder library.
- This library provides building blocks to create self hosted form management. This would be useful to help us develop considering our app is form based.