System business rule specification specimen addition - ESG-Project/documentation GitHub Wiki
← Home / Requirements / Business Rules
This business rule defines the requirements for adding new specimens, including data fields, auto-calculations, and validations.
Rule Details
| Field | Content |
|---|---|
| Identification | BR08 |
| Business Rule | Specimen Addition |
| Description | Specifies mandatory and optional fields for new specimen entries, including automatic calculations for DBH and Basal Area, and real-time species autocomplete. |
| Source | System Requirements |
| Priority | High |
| Status | Active |
Implementation Details
- Mandatory fields for new specimens: Species, Plot (number or "Isolated"), Height (m), and at least one CBH (cm) value (up to 6 possible).
- Optional fields: Family (auto-populated, editable if species not found), Category (Exotic, Invasive Exotic, Protected by Law), Coordinates (latitude/longitude), and Observations (free text).
- Real-time autocomplete for Species search.
- Validations: Height and CBH values must be greater than 0; CBH must have between 1 and 6 values.
- Automatic Calculations: DBH (Diameter at Breast Height) and Basal Area (m²) are calculated by the system based on entered data.
- Data validation occurs upon submission, and the operation can be canceled at any time.
Related Components
- Specimen Data Entry Form
- Species Autocomplete Service
- Calculation Engine
- Data Validation Module
History
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0 | 2025-07-29 | System | Initial version |
Notes
- Ensures data consistency and reduces manual calculation errors.
- Flexibility for field data collection variations (multiple CBH measurements).