How bcgov/nr-spar works
SPAR is a natural-resources application with a React client, a PostgreSQL REST backend, and a separate Oracle REST API. The principal workflow is a signed-in user working in the client with seedlot information, which the backend manages; the repository also contains orchard/parent-tree and seedlot-reporting capabilities, plus Oracle-backed parent-tree and CONSEP testing services. The sampled excerpts confirm selected service-to-repository and UI-to-API calls; other runtime connections are shown as unverified rather than asserted.
Main entry points: SeedlotService.java Seedlot management · Seedlot Seedlot workflows · SearchCriteriaService.java Search criteria · App.tsx React application
Components 19
SPAR Client
- React application
frontend/src/App.tsx - Seedlot workflows
frontend/src/views/Seedlot - Forest client lookup
frontend/src/api-service/forestClientsAPI.ts
PostgreSQL Backend
- Seedlot management
backend/src/main/java/ca/bc/gov/backendstartapi/service/SeedlotService.java - Seedlot REST endpoints
backend/src/main/java/ca/bc/gov/backendstartapi/endpoint/SeedlotEndpoint.java - Seedlot records
backend/src/main/java/ca/bc/gov/backendstartapi/repository/SeedlotRepository.java - Search criteria
backend/src/main/java/ca/bc/gov/backendstartapi/service/SearchCriteriaService.java - Saved criteria
backend/src/main/java/ca/bc/gov/backendstartapi/repository/SearchCriteriaRepository.java - Orchard services
backend/src/main/java/ca/bc/gov/backendstartapi/service/OrchardService.java - Seedlot reports
backend/src/main/java/ca/bc/gov/backendstartapi/report/SeedlotRegistrationReportService.java - Report templates
backend/src/main/java/ca/bc/gov/backendstartapi/report/ReportResourceService.java
Oracle API
- Parent-tree REST
oracle-api/src/main/java/ca/bc/gov/oracleapi/service/ParentTreeService.java - Parent-tree data
oracle-api/src/main/java/ca/bc/gov/oracleapi/repository/ParentTreeRepository.java - CONSEP activity search
oracle-api/src/main/java/ca/bc/gov/oracleapi/service/consep/ActivitySearchService.java - Activity search data
oracle-api/src/main/java/ca/bc/gov/oracleapi/repository/consep/ActivitySearchRepository.java - CONSEP test results
oracle-api/src/main/java/ca/bc/gov/oracleapi/service/consep/TestResultService.java
Supporting Services
- User identity
backend/src/main/java/ca/bc/gov/backendstartapi/security/LoggedUserService.java - Request correlation
backend/src/main/java/ca/bc/gov/backendstartapi/config/SparLog.java
Other components
- SPAR user
Connections 12
- SPAR user → React application: uses
- React application → Seedlot workflows: routes to
frontend/src/App.tsx - Seedlot workflows → Seedlot management: uses API
- Seedlot workflows → Forest client lookup: looks up client
frontend/src/views/Seedlot/SeedlotReviewClassB/read/ExtractionStorageRead.tsx - Seedlot management → Seedlot records: persists
- Seedlot REST endpoints → Seedlot management: dispatches
- Search criteria → User identity: gets user ID
backend/src/main/java/ca/bc/gov/backendstartapi/service/SearchCriteriaService.java - Search criteria → Saved criteria: saves criteria
backend/src/main/java/ca/bc/gov/backendstartapi/service/SearchCriteriaService.java - Seedlot management → Orchard services: uses orchard data
- Parent-tree REST → Parent-tree data: queries
oracle-api/src/main/java/ca/bc/gov/oracleapi/service/ParentTreeService.java - CONSEP activity search → Activity search data: searches
oracle-api/src/main/java/ca/bc/gov/oracleapi/service/consep/ActivitySearchService.java - Seedlot reports → Report templates: uses templates
backend/src/main/java/ca/bc/gov/backendstartapi/report/SeedlotRegistrationReportService.java