User stories - ESG-Project/documentation GitHub Wiki
This document contains all user stories for the Suassu environmental management system. The stories are organized by module and include their classification (MVP, Product, Evolution, Incremental) and current implementation status.
User Story Template and Approach
Each user story follows the standard format:
As a [role], I want to [action] so that [benefit]
Template Components:
- Role: Defines who wants the feature (e.g., technician, admin, finance manager)
- Action: Describes what the user wants to do
- Benefit: Explains why the user wants this feature (implicit in our stories)
Status Tracking:
- Completed: Feature is implemented and in production
- Pending: Feature is planned but not yet implemented
User Stories by Module
User Management
| ID | User Story | Status | Classification |
|---|---|---|---|
| US01 | As a user, I want to access and maintain my profile. | Completed | MVP |
| US02 | As an admin, I want to maintain users in my company. | Completed | MVP |
| US03 | As a technician, I want to maintain clients in my company. | Completed | MVP |
Project Management
| ID | User Story | Status | Classification |
|---|---|---|---|
| US04 | As a technician, I want to maintain projects for each client in my company. | Completed | MVP |
| US05 | As a technician, I want to maintain the map location for each project. | Completed | MVP |
Documental Management
| ID | User Story | Status | Classification |
|---|---|---|---|
| US06 | As a technician, I want to maintain environmental licenses for each project. | Completed | MVP |
| US07 | As a technician, I want to maintain conditions for each license. | Completed | MVP |
| US08 | As a technician, I want to maintain protocols for each project. | Completed | MVP |
| US09 | As a technician, I want to maintain official letters for each project. | Completed | MVP |
| US10 | As a technician, I want to maintain complements for each official letter. | Completed | MVP |
| US11 | As a technician, I want to receive email notifications about upcoming and pending deadlines related to my company's projects. | Completed | MVP |
| US12 | As a technician, I want to view a summary of upcoming and pending deadlines in the system. | Completed | Product |
System Administration
| ID | User Story | Status | Classification |
|---|---|---|---|
| US13 | As an admin, I want to maintain system parameters (e.g., vehicle fuel consumption, gasoline price, tax rate). | Completed | Product |
| US14 | As an admin, I want to maintain products offered by the company for commercial proposal completion. | Completed | Product |
| US25 | As an admin, I want to maintain product types offered by the company for commercial proposal completion. | Completed | Product |
Commercial Management
| ID | User Story | Status | Classification |
|---|---|---|---|
| US15 | As a technician, I want to maintain commercial proposals for each client. | Completed | Product |
| US16 | As a technician, I want to generate a commercial proposal document for each proposal to be sent to the client. | Completed | Product |
| US17 | As a technician, I want to mark commercial proposals as accepted or rejected. | Completed | Product |
Financial Management
| ID | User Story | Status | Classification |
|---|---|---|---|
| US18 | As a finance manager, I want to maintain financial transactions in the system (e.g., receivables, received amounts, and expenses). | Pending | Product |
| US19 | As a finance manager, I want to view a summary of current month's financial information. | Pending | Product |
| US20 | As a finance manager, I want to view a calendar with scheduled transactions for each day of the month. | Pending | Product |
| US21 | As a finance manager, I want to view a list of all company projects. | Pending | Product |
| US22 | As a finance manager, I want to access financial information for a specific project. | Pending | Product |
| US23 | As a finance manager, I want to generate financial transactions for each accepted commercial proposal. | Pending | Product |
Dashboard & Analytics
| ID | User Story | Status | Classification |
|---|---|---|---|
| US24 | As a technician, I want to view a dashboard with general statistical data about projects. | Pending | Incremental |
Phytosociological Analysis
| ID | User Story | Status | Classification |
|---|---|---|---|
| US25 | As a user, I want to create a new analysis by entering basic information, so that I can organize and start a new forest inventory. | Pending | Product |
| US26 | As a user, I want to view a list of all my registered analyses, so that I can quickly access the work I need to continue. | Pending | Product |
| US27 | As a user, I want to edit the information of an existing analysis, so that I can correct or update general data as the work progresses. | Pending | Product |
| US28 | As a user, I want to delete an analysis, so that I can remove incorrect or outdated entries from the system. | Pending | Product |
| US29 | As a user, I want to access the "Species Data" section within a project, so that I can start entering field measurements. | Pending | Product |
| US30 | As a user, I want to add a new specimen by selecting its species and filling in measurements like height and CBH, so that I can accurately record data for each tree. | Pending | Product |
| US31 | As a user, while adding a specimen, I want the option to create a new species not yet in the system, so that my workflow is not interrupted. As an administrator, I want to manage the species list to ensure consistency. | Pending | Product |
| US32 | As a user, I want to import field data in batch from a spreadsheet, so that I can streamline the data entry process for large projects. | Pending | Product |
| US33 | As a user, I want to view a table with all specimens registered for a specific analysis, so that I can check the data that has been entered. | Pending | Product |
| US34 | As a user, I want to click on a specimen in the list to see its complete details, so that I can perform a detailed verification of a specific record. | Pending | Product |
| US35 | As a user, I want to request a change in a specimen's data, so that I can correct or update information. | Pending | Product |
| US36 | As an administrator, I want to view a list of specimen data change requests, so that I can review the requested alterations. | Pending | Product |
| US37 | As an administrator, I want to approve or reject changes in a specimen request, so that I can maintain data integrity. | Pending | Product |
| US38 | As a user, I want to quickly access a consolidated dashboard with key phytosociological analysis indicators, to get an overview and investigate project metrics. | Pending | Product |
| US39 | As a user, I want the system to automatically calculate and display all phytosociological parameters by species, so that I can conduct in-depth analyses. | Pending | Product |
| US40 | As a user, I want to generate and view a complete forest inventory table, so that I can validate data quality and prepare the technical report. | Pending | Product |
| US41 | As a user, I want to verify the estimated total Volume and Density in the Environmental Impact Assessment section, so that I can plan compensatory projects. | Pending | Product |
| US42 | As a user, I want the system to calculate and display environmental compensation obligations and forest replacement, so that I can comply with legislation. | Pending | Product |
| US43 | As a user, I want to export and share project reports and tables in formats like PDF, Excel, or CSV, so that I can collaborate and present accurate data. | Pending | Product |
Unspecified Epics
| User Story | Status | Classification |
|---|---|---|
| As a technician, I want to maintain feasibility studies for each project. | Pending | Evolution |
| As a technician, I want to maintain forest management for each project. | Pending | Evolution |
| As a technician, I want to maintain flora survey and monitoring for each project. | Pending | Evolution |
| As a technician, I want to maintain fauna survey and monitoring for each project. | Pending | Evolution |
| As a technician, I want to maintain documents for each project through links to an external public repository. | Pending | Evolution |
| As a technician, I want to maintain photographic records for each project. | Pending | Evolution |
| As a technician, I want to maintain Waste Transport Manifest (MTR) for each project. | Pending | Evolution |
| As a technician, I want to maintain topography for each project. | Pending | Evolution |
| As a technician, I want to maintain inspections for each project. | Pending | Evolution |
| As a technician, I want to exchange messages through the system. | Pending | Evolution |