How bhalisasodo/tenderpreneur works
BoQPro is a procurement-pricing platform for South African tender contractors and suppliers. Contractors create a BoQ, upload or enter scope, parse and correct line items, then match suppliers and broadcast quote requests; suppliers submit quotes, which contractors compare and select or override before producing audit-ready exports. The graph includes the contractor and supplier portals, API domain stages, and persistence, audit, and provider-adapter layers. Relationships not visible in excerpts are included only where documented in the README; unsampled adapter internals are not inferred.
Main entry points: main.py FastAPI application · parsing/router.py Document parsing · quotes/router.py Quote requests · database.py Database
Components 21
User portals
- Contractor portal
apps/web/app/contractor - Supplier portal
apps/web/app/supplier - Web API client
apps/web/lib/api.ts
BoQ preparation
- BoQ management
apps/api/app/domains/boq/router.py - Document parsing
apps/api/app/domains/parsing/router.py - Scope segmentation
apps/api/app/domains/parsing/segmentation.py - Spreadsheet extraction
apps/api/app/domains/parsing/spreadsheet.py - LLM adapters
apps/api/app/integrations/llm
Supplier sourcing
- Supplier profiles
apps/api/app/domains/suppliers/router.py - Supplier matching
apps/api/app/domains/matching/service.py - Quote requests
apps/api/app/domains/quotes/router.py - Notifications
apps/api/app/integrations/notifications - Export generation
apps/api/app/domains/exports/router.py - PDF and Excel renderer
apps/api/app/integrations/exports/renderer.py
API and platform
- Authentication
apps/api/app/domains/auth/router.py - Audit trail
apps/api/app/domains/audit/service.py - Domain models
apps/api/app/core/models.py - Database
apps/api/app/core/database.py - FastAPI application
apps/api/app/main.py
Other components
- Contractor
- Supplier
Connections 33
- Contractor → Contractor portal: uses
README.md - Supplier → Supplier portal: uses
README.md - Contractor portal → Web API client: requests via
apps/web/app/contractor/boqs/new/page.tsx - Supplier portal → Web API client: requests via
apps/web/app/supplier/page.tsx - Web API client → FastAPI application: calls API
README.md - FastAPI application → BoQ management: registers route
apps/api/app/main.py - FastAPI application → Document parsing: registers route
apps/api/app/main.py - FastAPI application → Supplier profiles: registers route
apps/api/app/main.py - FastAPI application → Quote requests: registers route
apps/api/app/main.py - FastAPI application → Export generation: registers route
apps/api/app/main.py - FastAPI application → Authentication: registers route
apps/api/app/main.py - BoQ management → Document parsing: starts parsing
README.md - Document parsing → Scope segmentation: structures scope
README.md - Document parsing → Spreadsheet extraction: extracts spreadsheets
README.md - Document parsing → LLM adapters: uses provider
apps/api/app/domains/parsing/router.py - Quote requests → Supplier matching: matches suppliers
apps/api/app/domains/quotes/router.py - Supplier profiles → Supplier matching: supplies profiles
apps/api/app/domains/suppliers/router.py - Quote requests → Notifications: notifies suppliers
README.md - Supplier portal → Quote requests: submits quotes via
README.md - Contractor portal → Quote requests: compares quotes via
README.md - Contractor portal → Export generation: requests exports via
README.md - Export generation → PDF and Excel renderer: renders files
apps/api/app/domains/exports/router.py - BoQ management → Audit trail: records changes
apps/api/app/domains/boq/router.py - Document parsing → Audit trail: records parse
apps/api/app/domains/parsing/router.py - Quote requests → Audit trail: records quote actions
apps/api/app/domains/quotes/router.py - Export generation → Audit trail: reads history
apps/api/app/domains/exports/router.py - BoQ management → Database: reads and writes
apps/api/app/domains/boq/router.py - Document parsing → Database: reads and writes
apps/api/app/domains/parsing/router.py - Quote requests → Database: reads and writes
apps/api/app/domains/quotes/router.py - Supplier matching → Database: reads profiles
apps/api/app/domains/matching/service.py - Audit trail → Database: persists events
apps/api/app/domains/audit/service.py - Database → Domain models: maps entities
apps/api/app/core/models.py - Authentication → Database: authenticates against
apps/api/app/domains/auth/router.py