Growing the Grapes: Requirements Definition
Growing the Grapes (Tank 1)
The "Growing the Grapes" Tank can be broken down into the following key components:
The Daily Log
The Runbook
The Dashboard
The Daily Log is a visual calendar that allows costaflores.com website VISITORS to view daily, monthly, and yearly views of two primary elements:
What human activities are taking place in the vineyard?
Historical data for temperature (max and min), subsoil humidity index, and solar irradiance.
The Daily Log
These are the functional requirements for the Daily Log. The Daily Log is a visual representation of what activities happen in the vineyard throughout the year, and environmental conditions (temperature, water, sun).
Req | P | Definition | Owner | Notes |
---|---|---|---|---|
1.1.1 | 1 | The daily log should have three views available for visitors: daily, monthly, and yearly. |
| Ideally, this could be circular or spiraling. |
1.1.2 | 1 | From the log, the user should be able to visualize the tasks that were executed on each day, and open the Runbook entry for each by selecting the task. |
|
|
1.1.3 | 1 | The yearly view of the log should present tasks as relevant to the different stages of the grape growing season. |
| For example... |
1.1.4 | 1 | The daily log should present data in the three views (daily, monthly, and yearly) for: |
| Much of the data will be collected using Reiner Van der Lee's VINDUINO. (this needs a separate requirement ID section). |
1.1.5 | 2 | Users should be able to visualize differences from one year to the next, of multiple years. |
| One example: |
1.1.6 | 1 | The log should have a field indicating the last time the daily log was updated. |
|
|
1.1.7 | 1 | These tasks should be extracted by the content management system (Magnolia) from the runbook ticketing platform (Jira) and represented in the different views (calendars). |
|
|
1.1.8 | 1 | The daily log must be localized in the following languages: English, Spanish, with a documented procedure for adding support for additional languages (documented in the project Wiki). |
|
|
The Runbook
These are the functional requirements for the Runbook.
The Runbook is the platform where activities performed on the vineyard (tasks) are recorded by the people performing them (Farmers).
The purpose of the runbook platform is to document all the activities that take place during the year in the vineyard. We document these activities so that we can:
Analyze the amount of time spent, and tools required for each task
Compare the different timing of activities from one year to the next
Provide a didactic description (text and video) of viticulture tasks
Map tasks according to specific locations in the vineyard (row, claro, plant)
Req | P | Definition | Owner | Notes |
---|---|---|---|---|
1.2.1 | 1 | The Runbook entry (ticket) must include the following fields for each task:
| SMF | The tools, chemicals and farmers are finite lists. Name is a drop down list. All other fields are user selectable. |
1.2.2 | 1 | The Farmer must be able to create a new ticket, review and update an existing ticket, and delete a ticket both from a smartphone app (android?) and web application. | Mr. Sinatra | Use a ticketing platform like Jira? |
1.2.3 | 1 | Tickets should be chosen from a defined and finite number of task entries, selected from historic vineyard logs. (Dropdown) | Mike Barrow | Created from the list from existing bitácora entries. |
1.2.4 | 1 | The tool used by the Farmer to create, review, update, and delete tickets must be in Spanish. | Mr. Sinatra |
|
1.2.5 | 1 | Tasks should be mapped, both textually and visually, to indicate location by row, claro, plant, giving the farmer the option to input start location and end location, with an option for ALL for each of the three categories of row, claro, plant. This should be agile and simple for farmers to use. | Mr. Sinatra | Tasks only need to be mapped textually for data entry (when creating/modifying the ticket), but visually for reports for end users. |
1.2.6 | 2 | The runbook "Tools" data shoud be extracted from a fixed database with the following fields:
| Mr. Sinatra | This information will be useful for creating a tool inventory and calculating asset values. We might use the ERP inventory db for this? |
1.2.7 | 1 | The "Chemicals" data should be extracted from a fixed inventory database with the following fields: Product Name | Mr. Sinatra | This will allow us to determine data, such as: Total amount applied from year-to-year (May 6-May 5) |
1.2.8 | 1 | Chemicals used during each ticket should be subtracted from the inventory automatically. | Mr. Sinatra | For example, when a farmer uses 2Kg of Copper, this needs to be subtracted from the copper stock in the chemicals inventory. |
1.2.9 | 1 | Logistics stakeholders (i.e. Mike, Mica) should be able to assign, delete, and update tasks to a queue for the group of farmers (Santos and Yolanda) to execute. Tasks should be assignable to begin at a future date and/or included in a queue. | Mr. Sinatra |
|
1.2.10 | 1 | The Runbook entries (all fields) must be localized in English and Spanish, with a documented procedure for adding support for additional languages (documented in the project Wiki). | Mr. Sinatra |
|
The Dashboard
These are the functional requirements for The Dashboard.
The Dashboard is a real-time presentation of the current state of the vineyard. The idea behind the dashboard is to have one location where visitors (and all other stakeholders) can visualize real-time information about the vineyard (for example, weather information), and accumulated year-to-year counters regarding.
Req | P | Definition | Owner | Notes |
---|---|---|---|---|
1.3.1 | 1 | All stakeholders should be able to visualize the dashboard (read-only) | Mr. Sinatra |
|
1.3.2 | 1 | The Dashboard should present current weather information: Temperature | Mr. Sinatra | Mike will provide the data stream for the weather information. |
1.3.3 | 1 | The dashboard should present the following cumulative statistics for the year (May 6-May5). This data should be extracted from the Chemicals DB, showing the total amounts applied per hectare and total for: Co (Copper) | Mr. Sinatra | Mike should compile the complete listing of chemicals. |
1.3.4 | 1 | The dashboard should present, for each of the three varietals present in the vineyard (Malbec, Petit Verdot, and Cabernet Sauvignon) indicators for sugar, total acidity, and pH (Bx, TA, pH). These values should be extracted from a database with the following fields: Varietal (choice from three) | Mr. Sinatra | For most of the year, these values will reflect the values from last year's harvest. This information can be created in categories in Magnolia and updated manually. Presenting historical data for these values in the log would be ideal. |
1.3.5 |
| The dashboard should also indicate the stage within the growing cycle for each varietal:
| Mr. Sinatra | This could be iconographic. |
1.3.6 | 3 | The dashboard should include annual totals for the following: Show total number of hours of work executed for the year. | Mr. Sinatra |
|
1.3.7 | 3 | Create a customized bottle shaped bar chart detailing the distribution of tasks in the vineyard. | Mr. Sinatra |
|
1.3.8 | 1 | The dashboard should include access to a Costaflores vineyard cam. | Mr. Sinatra |
|