Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision | ||
companion_planting:development_log [2017/06/11 21:21] – [Product Scope] ecohack | companion_planting:development_log [2017/11/13 22:23] – ecohack | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
- | ===== Research ===== | + | |
- | [[https:// | + | |
- | [[https:// | + | The ticket #959 is the information base for the specification. Its written in a markup language not compatible with this wiki. Redmine is used to track the tasks around the development so it makes more sense to make this location the primary datasource. To make your contributions usable, write in the ticket or use redmine markup in the CODE text. Copy it over from the redmine everytime its updated there: |
- | [[http:// | + | < |
- | [[http://organic.kysu.edu/BiointensiveMixtures.pdf|Paper by M.K. Bomford]] Further development on the KYSU research above. Has a few key conclusions, | + | Work together on this Spec on: https://pad.riseup.net/p/ |
- | * Results suggest that mixed planting can increase land-use efficiency of BIA systems under resource-limiting conditions. | + | When finished change Ticket: https:// |
- | * Cool-season crops should not be mixed with warm-season crops for synchronous growth in mixed plantings. | + | |
- | [[https:// | + | [[wiki|Back To Overview]] |
- | [[https:// | + | {{>toc}} |
- | [[https:// | + | h1. Software Requirement Specification |
- | =====Software Specifications===== | + | for " |
- | Software Requirement Specification | + | Version |
- | for Companion Planner | + | |
- | Version 0.1 | + | |
- | ====Introduction==== | + | h1. Introduction |
- | //Document Purpose | + | |
- | TO DO: Identify the product whose software requirements are specified, including the revision or release number. | + | |
- | Describe the scope of the product.// | + | |
- | ===Users=== | + | powerplant is a software that allows anyone planning a garden to utilize companion planting and other permaculture practices. It provides intelligent suggestions to help the gardener by advising the best planting schedules and combinations of crops to maximize the garden' |
- | Gardeners | + | h1. Users |
- | ===Goal=== | + | * Gardeners, including anyone who wants to plan a garden and is happy to use open source software. |
+ | ** Hobbyist - small home garden. 20 m2 | ||
+ | ** Countryside garden - 250 - 1000 m2 | ||
+ | ** Organic farmer - 1000 m2 + | ||
+ | ** Consultant - all of the above | ||
+ | ** Anyone who wants to plan a garden by using companion planting. | ||
+ | ** People who want to use open source/ open data software. | ||
- | Help with garden planning using companion plants to deter pests, improve the harvest and add variety ie more diversity. | + | More detail below. |
- | Taking into account: | + | h1. Goal |
- | * Soil type | + | |
- | * Climate | + | |
- | * Growth time | + | |
- | * Sun and water requirements | + | |
- | Improve harvest and diversity | + | The goal of powerplant is to help users effectively plan their garden |
+ | |||
+ | h2. Product Scope | ||
- | ====Product Scope==== | + | > Provide a short description of the software being specified and its purpose, including relevant benefits, objectives and goals. |
- | //TO DO: Provide a short description of the software being specified and its purpose, including relevant benefits, objectives, and goals.// | + | |
- | ===Software description=== | + | h3. Software description |
- | Convert data on crops into something usable by anyone interested in gardening. | + | * Offer fast and easy solution for knowing which crops (bene)fit together |
+ | * Provide an easy to follow schedule for planting, transplanting, | ||
+ | * Provide information about the crops themselves | ||
+ | * Push and pull crop information to/from several open data platforms | ||
+ | * User can submit changes to improve data | ||
+ | * Open-source/ | ||
- | Open-source | + | > TODO: write more and better text |
- | ===Objectives=== | + | h3. Objectives |
- | Improve planning process for anyone who wants to use permaculture principles in their gardening. | + | * Improve planning process for anyone who wants to use permaculture principles in their gardening. |
+ | * Save time during the planning process for anyone who wants to use permaculture principles in their gardening. | ||
+ | * Education of users | ||
+ | * Improve and collect data in open databases | ||
+ | * Increase harvest yield | ||
+ | * Connect with other open source projects for mutual benefit | ||
- | Save time during planning process for anyone who wants to use permaculture principles in their gardening. | + | h1. Overall Description |
- | Education of users | + | < |
+ | +-----------------------+ | ||
+ | | OpenFarm.cc API | | ||
+ | +-----------+-----------+ | ||
+ | ^ | ||
+ | | | ||
+ | | | ||
+ | | | ||
+ | v | ||
+ | +-------------+ | ||
+ | | Front End | ||
+ | +-------------+ | ||
+ | ^ | ||
+ | | | ||
+ | | | ||
+ | | | ||
+ | | | ||
+ | v | ||
+ | +--------------+--------+ | ||
+ | | FarmOS API | | ||
+ | +-----------------------+ | ||
+ | </ | ||
- | Improve and collect data | ||
- | ====Overall Description==== | + | h2. Product Perspective |
- | ===Product Perspective=== | + | Our vision is that people are able to plan their own gardens using companion planting and other permacultures practices using our app as a central resource for information. The resources we can provide to the user will grow as the app is used more. |
- | ==Users== | + | h2. Context |
- | Anyone who wants to plan a garden. | + | The information that we provide is all out there, we want to provide |
- | People who want to use open source software. | + | h2. Origin |
- | ==Outcome== | + | Permaculture guidelines, gardening best practices. |
+ | |||
+ | The permaculture ideals are: | ||
+ | |||
+ | * Care for the earth | ||
+ | * Care for the people | ||
+ | * Fair share | ||
+ | |||
+ | Open Source/ Open Data. | ||
+ | |||
+ | h3. Outcome | ||
A year of use of this software will result in: | A year of use of this software will result in: | ||
- | Users adding to data from all over the world (different climates, soil types) | + | * Users adding to data from all over the world (different climates, soil types) |
+ | * Maybe make some money for affiliate links (seeds, supplies) or donations | ||
+ | * Users plan garden and fields with our software | ||
+ | * Users are better educated about gardening and permaculture | ||
+ | * Enhance other open source projects with valuable information | ||
+ | * More development on powerplant resulting in better software | ||
+ | ** especially including more OS/OD enthusiasts | ||
+ | ** building up networks with different OS/OD projects | ||
+ | |||
+ | h2. Product Functionality | ||
- | // maybe need more added here // | + | > 1 TODO: Add major functions that the product must perform or must let the user perform. |
- | //TO DO: Describe the context and origin of the product being specified. | + | h3. Must Have |
- | Include a simple diagram that shows the major components of the overall system, subsystem interconnections, | + | |
- | ===Context=== | + | * Select different guides |
+ | * Offline and online user experience | ||
+ | * Suggestions for existing beds | ||
+ | * Mark a bed as full or not | ||
+ | * Notifications from schedule | ||
+ | * Tasks and actions | ||
+ | * Schedule | ||
- | The information that we provide is all out there, we want to provide a central source for all of it. | + | * user can signup/ login or decide |
+ | * user can create an account from garden data they' | ||
+ | * user can create beds | ||
+ | * user can create gardens | ||
- | ===Origin=== | + | * Need a list of available plants (internal) |
+ | * Need to be able to see compatible/ | ||
+ | * Need to be able to filter by compatibility with multiple plants (internal) | ||
+ | * Find optimal planting schedule for a target bed (with at least one user picked crop) | ||
- | Permaculture guidelines, gardening best practices. Permaculture ideals: Take of earth, regenerate soil. | ||
- | Permaculture ideals: | + | h3. Should Have |
- | * Care for earth | + | |
- | * Care for people | + | |
- | * Fair share | + | |
- | ====Product Functionality==== | + | * When offline: |
- | //TO DO: | + | ** Get suggestions for where to plant crops |
- | 1. Summarize the major functions that the product must perform or must let the user perform.// | + | *** TODO: Figure out if this is possible offline. |
- | | + | *** Only for plants |
- | | + | * If we get the data, notify the user of maintenance tasks include |
- | * Need to be able to filter by multiple plants | + | * Suggest |
- | | + | * List suggestions for following plants for harvested |
- | | + | * Sharing/ |
- | * Find optimal planting schedule | + | * Add a crop entry |
- | * Schedule must also include | + | ** fill out form |
- | * Find optimal planting combinations for any number of plants | + | ** should be validated |
- | * Based on distance between plants | + | * validation of other users data for a specific climate (proofread, rate, comment, improve) |
- | * Have some visualization of garden | + | ** flag trolls/... |
- | * Draw in current crops | + | * Keep track of nitrogen fixers/ |
- | * Fill in blank spaces in beds | + | * Save edit history for OpenFarm data |
- | * Filter crops added by algorithm based on preference | + | * permaculture zones: |
- | * Add/remove crops for any reason | + | ** a garden can have zones |
- | * Deny/change crops selected by algorithm | + | ** suggestions based on zones |
- | * Save user profiles with all information | + | *** plant zone is dependent on how much attention they need/how often you harvest |
- | | + | **** TODO: think about this, how to figure that out |
- | * Keep track of nitrogen fixers/ | + | |
- | * Take user feedback | + | |
- | * Sharing/collaboration between users | + | |
+ | h3. Cool to Have | ||
+ | * Include types of beds required for a crop | ||
+ | * Get revenue from links for more information. | ||
+ | * Plant pictures | ||
+ | * Print Shopping List | ||
+ | * modify the same garden by multiple users at the same time | ||
+ | * Have some visualization of garden beds with plants | ||
+ | * Draw in current crops | ||
+ | * Gamification | ||
+ | ** Levels/ | ||
+ | *** Contributor | ||
+ | *** Expert farmer | ||
+ | *** etc. | ||
- | //2. Organize the functions | + | > TODO: Figure out where these attributes belong: Soil conditions, grow time, climate, sun direction relative to each bed, labor required for each plant, sun+water required, best season/time to plant, care frequency, nitrogen/ consumption |
- | Aimee says: | + | h3. Minimal Viable Project |
- | Urgent: | + | |
- | Good combinations for current month | + | |
- | Less Urgent: | + | * The User should be able to select a minimum of two plants and the app will produce a result to list of plants in groups that are compatible with each other. |
- | Planting location | + | * It should only list small groups that are not contained in a bigger group |
+ | ** Example: {Nasturium, Potato, Onion} = {Nasturium, Potato}, {Onion} != {Nasturium, Potato}, {Onion}, {Potato}, {Nasturium} | ||
+ | * Search by Common english name or binoial name in the same field | ||
+ | ** If crop not found it should tell: "Plant not yet in the database or you wrote the name wrong :) - or you can try again using the binomial name" | ||
+ | * This should represent the function of creating multiple beds from a list of seeds/ | ||
+ | * TODO | ||
+ | ** Backend: Import plant data from PFAF database, import basic plant relationship data (firebase), create HTTP API call to get compatible groups from a big group of plants. | ||
- | Not urgent: | + | h3. Detailed function description. |
- | Visualizing beds | + | |
+ | h4. Select different Guides | ||
- | // 3. Provide | + | User should choose between different guides (from openfarm.cc) for a crop that fits their needs |
+ | * When adding a crop to a bed, users have the option | ||
+ | * Users can view the guide for a crop at any time from the crop details page | ||
+ | * Guides can be removed, added or changed | ||
- | // will create later // | + | h4. Offline and Online user experience |
- | ====Users | + | NEARLY the same UX (user experience) both offline |
- | //TO DO: | + | * Things a user will most likely want to do while offline. Use command pattern for the actions and queue them up. They sync when the phone/browser has network connection again. This also allows undo' |
- | 1. Identify | + | ** Add a new bed |
+ | ** Add existing crops to that bed | ||
+ | ** Change the status of a crop | ||
+ | ** Change status of a task | ||
+ | ** Switch to any other bed in their garden | ||
+ | ** View a guide/information for a crop | ||
- | * Hobbyist - small home garden. 20 m< | + | h4. Suggestions |
- | * Countryside garden - 250 - 1000 m< | + | |
- | * Organic farmer - 1000 m< | + | |
- | // 2. Describe the pertinent characteristics of each user. // | + | * Provide suggestions for adding specific crops to existing beds |
- | | + | ** User can ask for crop suggestions when adding crops to a garden |
- | * Countryside | + | * Provide suggestions for adding specific crops to a specific bed |
- | * Organic farmer - Prioritizing lower labor. Intermixed plants means more labor. Technologically literate, want to use software | + | ** User can also ask for suggestions for crops to add to a specific bed |
+ | * Must have at least one user-selected crop to provide suggestions | ||
- | ====Operating Environment==== | ||
- | //TO DO: | ||
- | Describe the environment in which the software will operate, including the hardware platform, operating system and versions, and any other software components or applications with which it must peacefully coexist. In this part, make sure to include a simple diagram that shows the major components of the overall system, subsystem interconnections, | ||
- | Lower range laptop | + | h4. Notifications |
- | Windows 10, Chrome, use in office or garden | + | Notify users of tasks that should be done for each garden/bed/crop on a given day |
+ | * Email notifications | ||
+ | ** should be opt out by default | ||
+ | ** include weekly summary of upcoming tasks | ||
- | Android x.x.x, Chrome, use in office or garden, but mainly garden | + | * Push notifications |
+ | ** Need to be enabled | ||
+ | ** include events happening on the current day | ||
- | ====Design and Implementation Constraints==== | + | h4. Tasks and Actions |
- | //TO DO: | + | |
- | Describe any items or issues that will limit the options available to the developers. | + | |
- | These might include:// | + | |
- | * //hardware limitations (timing requirements, | + | |
- | * // | + | |
- | * //specific technologies// | + | |
- | * //tools// | + | |
- | * //databases to be used// | + | |
- | * //language requirements// | + | |
- | * //User Documentation// | + | |
- | | + | * Right now, this would include planting, transplanting, and harvesting - only the major events |
- | screen should look like, how to interpret output. Need to document things before creating them. | + | * Users can add custom tasks from a predefined set of actions (or " |
- | * Need to use vanilla Javascript for front end. | + | ** Tasks are associated |
- | * Plain HTML, LESS for css | + | ** Repeatable tasks |
- | | + | * Mark tasks as complete, or postpone or ignore them |
- | * Have to use FarmOS database. | + | |
- | | + | |
- | * Back end: PHP to deal with database, Javascript to process business logic | + | |
+ | h4. Schedule | ||
- | //TO DO: | + | Find optimal planting schedule for a target bed (with at least one user picked crop) |
- | Describe what kind of manuals and what kind of help is needed for the software you will be developing. | + | * When adding a crop, users can get suggestions for when to plant it based on the duration of growth |
+ | * Goal is to maximize the overall yield and allow for consistent harvest throughout the year | ||
+ | |||
+ | Information accessible on timeline of different stages and locations of growth (i.e. when to grow in greenhouse and transplant them outside) | ||
+ | |||
+ | * Users can view the schedule for a location or bed as a chart | ||
+ | * Growth periods are shaded in bars, single events are represented as lines | ||
+ | * Should allow the user to see, at a quick glance, what is growing and when things can be harvested | ||
+ | ** Also be able to identify gaps in the schedule which could be filled | ||
+ | * Should also show information about compatibility interactions | ||
+ | ** Needs to be intuitive and simple to understand, obvious from one look at the schedule | ||
+ | |||
+ | h4. User Contributions | ||
+ | |||
+ | Users can contribute in the form of editing existing cropinformation, | ||
+ | |||
+ | Creating Guides should link into OpenFarm directly - Create Guide. | ||
+ | * pro: less work for developer | ||
+ | * contra: might be confusing for the user | ||
+ | Editing Guides should be put into powerplant " | ||
+ | Editing Cropinformation should be edited in OpenFarm directly. | ||
+ | Croprelation should be changed in the app and put into OpenFarm. | ||
+ | |||
+ | h3. Terminology | ||
+ | |||
+ | |||
+ | Location: Group of gardens whose permaculture zones are defined relative to a common zone 0 | ||
+ | Garden: combination of beds in the same vicinity and permaculture zone | ||
+ | Bed: Section in a garden (can be a greenhouse, a pot or a patch of soil) | ||
+ | Crop: Specific instance of a crop that will be planted in a bed | ||
+ | Transplant: action of moving a crop from a pot (non-bed) to a bed | ||
+ | Zone/Permaculture Zone: Ordered area from 0 to 5 by frequency of visits/maintance requirement (/often also related to proximity) | ||
+ | |||
+ | h3. 2. Provide a Data Flow Diagram of the system to show how these functions relate to each other. | ||
+ | |||
+ | Data flow diagram for cropinformation/ | ||
+ | |||
+ | < | ||
+ | |||
+ | ``````````` | ||
+ | `. | ||
+ | | ||
+ | | ||
+ | -````. User Interface .``````Send.```> | ||
+ | . . | ||
+ | . | ||
+ | . +.` | ||
+ | . ^ ``/ | ||
+ | . . : | ||
+ | . . | ||
+ | . . | ||
+ | . . | ||
+ | Request | ||
+ | . . | ||
+ | . . | ||
+ | . . | ||
+ | . .`` Response to request | ||
+ | . `Response | ||
+ | . .to Request | ||
+ | . .-`------ | ||
+ | . ^ | ||
+ | . . | ||
+ | . . | ||
+ | . . | ||
+ | . . | ||
+ | . -````````` | ||
+ | . | ||
+ | . .``Openfarm` . `. Power plant | ||
+ | .>/- `Database` .:< | ||
+ | .` ---:::--` . | ||
+ | .` `. | ||
+ | ````````` | ||
+ | `````````` | ||
+ | |||
+ | |||
+ | </ | ||
+ | |||
+ | h2. Users and Characteristics | ||
+ | |||
+ | h3. Identify the various users that you anticipate will use this product. | ||
+ | |||
+ | * Hobbyist - small home garden. 20 m2 | ||
+ | * Countryside garden - 250 - 1000 m2 | ||
+ | * Organic farmer - 1000 m2 + | ||
+ | * Consultant - all of the above | ||
+ | * Anyone who wants to plan a garden by using companion planting. | ||
+ | * People who want to use open source/ open data software. | ||
+ | |||
+ | h3. Describe the relevant and important characteristics of each user. | ||
+ | |||
+ | * All users: consistent harvest throughout the year | ||
+ | * Hobbyist - Not too much labor is better; organic/ | ||
+ | * Countryside garden - Same as Hobbyist, also wants to be self-sufficient | ||
+ | * Organic farmer - Same as Hobbyist, also prioritizing lower labor. Intermixed plants means more labor. Technologically literate, want to use software to improve their yields | ||
+ | * Consultant - Provide advice to other hobbyists/ | ||
+ | |||
+ | h2. Operating Environment | ||
+ | |||
+ | > Describe the environment in which the software will operate, including the hardware platform, operating system and versions, and any other software components or applications with which it must peacefully coexist. In this part, make sure to include a simple diagram that shows the major components of the overall system, subsystem interconnections, | ||
+ | |||
+ | * Lower range laptop | ||
+ | * Windows 10, Chrome, use in office or garden | ||
+ | * Android x.x.x, Chrome, use in office or garden, but mainly garden | ||
+ | * With temporary internet connection | ||
+ | |||
+ | h2. Design and Implementation Constraints | ||
+ | |||
+ | > Describe any items or issues that will limit the options available to the developers. These might include: | ||
+ | > * hardware limitations (timing requirements, | ||
+ | > * interfaces to other applications | ||
+ | > * specific technologies | ||
+ | > * tools | ||
+ | > * databases to be used | ||
+ | > * language requirements | ||
+ | > * User Documentation | ||
+ | |||
+ | * React for front end with JSX to generate HTML | ||
+ | * SASS for css | ||
+ | * Need to eventually be compatible with FarmOS. | ||
+ | * Need to eventually be compatible with Openfarm.cc. | ||
+ | * Want to be similar to Openfarm crop database structure. | ||
+ | * Want tasks to be similar to FarmOS Log data structure | ||
+ | * Text + photo editors. | ||
+ | * NodeJS as backend engine running ES6 | ||
+ | ** MongoDB for database with Mongoose as ODM | ||
+ | ** Express for route handling | ||
+ | ** Passport for user authentication | ||
+ | ** Mocha + Chai + supertest for unit testing and integration testing | ||
+ | * Mobile-first, | ||
+ | |||
+ | h2. User Documentation | ||
+ | |||
+ | > TO DO: Describe what kind of manuals and what kind of help is needed for the software you will be developing. | ||
List the user documentation components (such as user manuals, on-line help, and tutorials) that will be delivered along with the software.// | List the user documentation components (such as user manuals, on-line help, and tutorials) that will be delivered along with the software.// | ||
- | * User manual | + | Need to have user documentation. Usability will be severly limited without. Need to have in depth descriptions of how to input data, what screens should look like, how to interpret output. Need to document things before creating them. |
- | * FAQ | + | |
- | * First time user prompts | + | |
- | * Community talking points | + | |
- | * Chat rooms (FarmOS) | + | |
- | * Tutorials for most exemplary tasks | + | |
- | ====Specific Requirements==== | + | * User manual |
- | ===External Interface Requirements, | + | * FAQ |
- | //TO DO: | + | * First time user prompts |
- | Describe | + | * Community talking points |
- | Define error message display standards.// | + | * Chat rooms (like FarmOS) |
+ | * Tutorials for most exemplary tasks (Videos, ...) | ||
- | // come back to this // | + | h1. Specific Requirements |
- | ===Hardware Interfaces=== | + | h2. External Interface Requirements |
- | //TO DO: | + | > TO DO: Describe user interfaces, different screen images, any GUI standards, standard buttons and functions (e.g., Cancel) that will be available to the user. Define error message display standards. |
- | Describe the logical and physical characteristics of each interface between the software product and the hardware components of the system. This may include: | + | |
- | * the supported device types, | + | h3. GUI standards |
- | * the nature of the data and control interactions between the software and the hardware.// | + | |
+ | https:// | ||
+ | https:// | ||
+ | |||
+ | * Lots of rounded rectangles to contain components | ||
+ | * Font size standards based on Marvel prototype (maybe change to be based on screen size in the future) | ||
+ | ** Main page title: 26pt | ||
+ | ** Subtitle: 18pt | ||
+ | ** Body text: 14pt | ||
+ | * Sidebar menu accessible from any screen which shows the current location and allows jumping to any screen above it in the hierarchy (All Gardens -> Garden Dashboard -> Bed Dashboard -> Crop) | ||
+ | * Gardens and Beds contain 3 subscreens (fragments? | ||
+ | ** Dashboard, Beds/Crops, Schedule | ||
+ | ** Dashboard shows relevant tasks | ||
+ | ** Beds/Crops shows all Beds/Crops contained within the Garden/ | ||
+ | ** Schedule shows history of all past, present, and future crops for the Garden/ | ||
+ | * Any time there is a title/ | ||
+ | ** Menu items: Edit, delete | ||
+ | ** This is the main mechanism by which user can change settings/ | ||
+ | |||
+ | h3. View Description | ||
+ | |||
+ | "View the prototype! (INCOMPLETE)": | ||
+ | If you want to improve it contact franz@ecohackerfarm.org to get an invite. | ||
+ | |||
+ | > TODO: add many many more more more more views | ||
+ | |||
+ | h3. Hardware Interfaces | ||
+ | |||
+ | > Describe the logical and physical characteristics of each interface between the software product and the hardware components of the system. This may include, the supported device types, the nature of the data and control interactions between the software and the hardware. | ||
* 800x400 display | * 800x400 display | ||
Line 216: | Line 434: | ||
* 5mb local storage | * 5mb local storage | ||
+ | h3. Software Interfaces | ||
- | ===Software Interfaces=== | + | > TO DO: Describe: |
- | //TO DO: | + | |
- | + | ||
- | 1. Describe: | + | |
- | the connections between the product | + | * FarmOS |
- | databases, | + | ** FarmOS users can provide |
- | operating systems (Windows? Linux? Etc.), | + | ** There will have to be a moderate amount of translation between powerplant data format and FarmOS data format |
- | tools, | + | ** Rather than building a seperate FarmOS module, we will make our web app compatible with FarmOS |
- | libraries | + | ** A FarmOS module could be possible, but requires much more time and expertise than it is worth at the moment |
+ | * Openfarm.cc | ||
+ | ** Openfarm stores CropRelationships, | ||
+ | ** Powerplant users can choose to register their accounts with Openfarm as well | ||
+ | ** Users who do this will be able to save/modify this data | ||
+ | ** All users (registered or not), while load this data from Openfarm | ||
- | * FarmOS | + | > TO DO: Identify data items or messages coming into the system and going out and describe the purpose of each. |
- | //2. Identify data items or messages coming into the system and going out and describe the purpose of each. // | + | * FarmOS specs go here |
+ | * openfarm.cc specs go here | ||
- | // FarmOS specs go here // | + | > TO DO: Describe the services needed. |
- | //3. Describe the services needed. // | + | > TO DO: Identify data that will be shared across software components. |
- | // also later // | + | * need to look at what FarmOS stores and what we store |
+ | | ||
- | //4. Identify data that will be shared across software components.// | ||
- | // need to look at what FarmOS stores and what we store | + | h3. Communications Interfaces |
- | | + | |
- | ===Communications Interfaces=== | + | TO DO: |
- | //TO DO: | + | |
- | 1. Describethe | + | 1. Describe the requirements associated with any communication |
+ | 2. Define any pertinent message formatting. | ||
- | // define standards for communication | + | h2. communication |
- | //2. Define any pertinent message formatting.// | + | REST |
- | // more details w FarmOS// | + | " |
- | //3. Identify any communication standards that will be used, such as FTP or HTTP. // | + | API error messages have the following format: |
+ | < | ||
+ | { | ||
+ | status: Number, | ||
+ | message: (optional) String, | ||
+ | errors: (optional) { | ||
+ | fieldName1: String, | ||
+ | | ||
+ | } | ||
+ | } | ||
+ | </pre> | ||
- | * HTTP (REST, JSON) | + | @status@: |
+ | @errors@: Object containing error messages pertinent to specific UI elements, e.g. a login request with an incorrect password would result in @{password: " | ||
+ | @message@: A general description of the error, which can be displayed to the user | ||
- | //4. Specify any communication security or encryption issues, data transfer rates, and synchronization mechanisms.// | + | h4. communication security or encryption issues, data transfer rates, and synchronization mechanisms. |
* Profile could have sensitive info | * Profile could have sensitive info | ||
- | * Even in case of illegal crops being grown, info cannot be accessible by anyone | + | * Even in case of (locally) |
* Yield is sensitive | * Yield is sensitive | ||
* Complete transparency within network of gardeners, zero transparency outside | * Complete transparency within network of gardeners, zero transparency outside | ||
+ | * low bandwidth because garden usually has bad reception (GPRS traffic) | ||
+ | * Sync profile data between local and server | ||
- | ====Behavior Requirements==== | ||
+ | h2. Behavior Requirements | ||
- | ===Use Case View=== | + | h3. Use Case View |
- | //**TO DO:** Provide a use case diagram which will encapsulate the entire system and all possible actors.// | + | > TO DO: Provide a use case diagram which will encapsulate the entire system and all possible actors. |
- | //will do later// | + | " |
- | ====Next Steps==== | + | |
- | - Complete the specifications | + | h3. List of Use case |
- | - Completing function list | + | * a user has an empty garden, and they want to know what they should plant |
- | - Decide zthe software stack | + | * a user has a non-empty garden, and they want to know what they should add to it |
- | - ... | + | * user wants to track their garden' |
- | - MoSCoW (Must have, should have, could have) | + | * user has some data they want to contribute |
- | - Research interfaces | + | * cool to have |
+ | ** user wants to manage a garden | ||
+ | > TODO: Add more use cases | ||
+ | h3. Diagram | ||
+ | > TODO: Create use case diagrams involving each of the possible types of users | ||
- | ====Resources==== | ||
- | Github: ... (to be filled) | + | General TODO: |
+ | Convince openfarm to enhance companionship model or find a suitable ruby on rails developer | ||
+ | |||
+ | Diagrams: https:// | ||
+ | </ |