Tenders-SA.org is South Africa's premier AI-powered tender discovery and application platform. We democratize access to government and private procurement opportunities through intelligent matching, automated application assistance, and comprehensive business intelligence tools.

• Homepage: https://www.tenders-sa.org
• All Tenders: https://www.tenders-sa.org/sa-tenders
• Blog & Resources: https://www.tenders-sa.org/blog
• Features: https://www.tenders-sa.org/features
• Platform Changelog: https://www.tenders-sa.org/changelog

• Browse by Category: https://www.tenders-sa.org/sa-tenders/categories
• Browse by Province: https://www.tenders-sa.org/sa-tenders/provinces
• Browse Organizations: https://www.tenders-sa.org/sa-tenders/organizations
• Active Tenders: https://www.tenders-sa.org/sa-tenders/tenders
• Awards: https://www.tenders-sa.org/sa-tenders/awards
• Cancellations: https://www.tenders-sa.org/sa-tenders/cancellations

• B-BBEE Calculator: https://www.tenders-sa.org/tools/bbbee-calculator
• CIDB Grade Calculator: https://www.tenders-sa.org/tools/cidb-calculator
• Company & Director Lookup: https://www.tenders-sa.org/tools/company-director-lookup
• Company Intelligence: https://www.tenders-sa.org/tools/company-intelligence
• Compliance Checker: https://www.tenders-sa.org/tools/compliance-checker
• Forensic Analysis: https://www.tenders-sa.org/tools/forensic-analysis
• Provincial Heatmap: https://www.tenders-sa.org/tools/provincial-tender-heatmap
• Readiness Assessment: https://www.tenders-sa.org/tools/readiness-assessment
• All Tools: https://www.tenders-sa.org/tools

• Services Hub: https://www.tenders-sa.org/services
• Business Profile Creation: Comprehensive business registration assistance
• CSD Registration: Central Supplier Database setup support
• B-BBEE Certification: Black Economic Empowerment guidance
• CIDB Registration: Construction Industry Development Board support

• Developer Portal: https://www.tenders-sa.org/publishers/developers
• API Documentation: https://api.tenders-sa.org/docs
• TypeScript SDK: @tenders-sa-org/sdk-js
• Python SDK: tendersa-sdk
• CLI Tool: @tenders-sa-org/cli

Tenders-SA.org leverages advanced artificial intelligence to transform tender discovery:

• Smart Matching Algorithm: AI analyzes your company profile, industry experience, B-BBEE level, and past performance to calculate compatibility scores for every tender
• Automated Application Assistance: AI pre-fills tender applications, generates proposal drafts, and identifies compliance requirements
• Document Analysis: Intelligent extraction of evaluation criteria, technical specifications, and mandatory requirements from tender documents
• Predictive Value Estimation: Machine learning models estimate tender values with confidence ratings
• Company Intelligence: Deep supplier analysis including award history, B-BBEE status, and procurement patterns

• Real-time Synchronization: Daily updates from eTenders API via Cloudflare Workers edge infrastructure
• Multi-Status Tracking: Active tenders, awards, cancellations, and notices
• Provincial Coverage: All 9 provinces with dedicated filters and heatmaps
• Category Organization: 50+ industry categories from construction to IT services
• Organization Profiles: 1000+ government departments, SOEs, and municipalities

• Publication Type Navigation: Filter by Tenders, Awards, Cancellations, Corrigenda
• Status Filters: Active, Closed, Awarded, Cancelled tenders with SEO-optimized pages
• Geographic Targeting: Province-specific searches with density visualizations
• Date Range Filtering: Closing dates, award dates, publication dates
• Value Range Filtering: Minimum/maximum tender values
• Full-Text Search: Search tender titles, descriptions, and requirements

16 free and premium tools to maximize tender success:

Free Tools:

• B-BBEE Score Calculator with equity breakdown
• CIDB Grade Calculator with project value limits
• Company & Director Lookup (live CIPC verification)
• Compliance Checker with requirement validation
• Preparation Planner with timeline management
• Template Generator for common tender documents

Premium Tools:

• Forensic Procurement Analysis with red-flag detection
• Company Intelligence with competitive insights
• Joint Venture Suite for partnership structuring
• Tender Value Estimator with confidence ratings
• Provincial Heatmap with opportunity density
• Readiness Assessment with gap analysis

Registered users access a comprehensive tender management workspace:

• Onboarding Wizard: Guided 7-step company profile setup with completeness scoring
• Matched Tenders: AI-powered recommendations with compatibility scores
• Application Workspace: Multi-tab interface for proposal writing with AI assistance
• Document Vault: Secure storage with expiry tracking and auto-attachment to applications
• Notification Center: Advanced filtering, bulk actions, and multi-channel delivery
• AI Chat Assistant: Context-aware help integrated with knowledge base
• Analytics Dashboard: Track applications, success rates, and tender engagement

RESTful API for third-party integrations:

• Enriched Tender Data: AI summaries, key requirements, classification metadata
• Company Profiles: B-BBEE enriched profiles with award history
• Organization Intelligence: Buyer/department data with Google/Wikidata enrichment
• Document Analysis: AI-extracted evaluation criteria and technical specs
• Value Estimates: Computed tender values with confidence ratings
• Award Analytics: Aggregated analytics by B-BBEE level, province, sector

Available SDKs:

• TypeScript/JavaScript SDK (@tenders-sa-org/sdk-js)
• Python SDK (tendersa-sdk)
• CLI Tool (@tenders-sa-org/cli)

Embeddable Widgets:

• Procurement Intelligence Widget
• Award Winners Feed
• Top Companies Widget
• Sector Trends Chart
• Provincial Heatmap

Frontend:

• Next.js 15 with App Router
• TypeScript with strict mode
• ShadCN UI component library
• Tailwind CSS for styling
• React 19 with Server Components

Backend:

• Next.js API Routes
• Prisma ORM with PostgreSQL
• Redis for caching and real-time features
• Custom JWT authentication
• Cloudflare Workers for edge computing

AI & Machine Learning:

• Google Gemini 1.5 Pro (primary)
• Groq Llama 3.1 (fallback)
• Hedged execution for reliability
• Context-aware prompting
• Token usage tracking

Infrastructure:

• AWS Cape Town (af-south-1) production deployment
• Cloudflare Workers for tender synchronization
• Cloudflare R2 for document storage
• Cloudflare D1 for edge database
• Redis for session and cache management

Document Processing:

• Python microservice for PDF extraction (PyMuPDF)
• AI-powered document analysis
• Multi-format support (PDF, DOCX, DOC, XLSX, PPTX, ODT, RTF)
• ZIP archive handling with recursive extraction

1. Source: eTenders.gov.za OCDS API
2. Edge Sync: Cloudflare Worker fetches and normalizes data
3. Document Storage: R2 for permanent document hosting
4. AI Enrichment: Title enhancement, classification, value estimation
5. Main Database: PostgreSQL with Prisma ORM
6. Search Index: Full-text search with category/province facets

1. Profile Analysis: Company capabilities, B-BBEE, industry experience
2. Eligibility Filtering: Hard requirement gates (location, value, category)
3. Compatibility Scoring: 10+ weighted factors with confidence ratings
4. Redis Caching: Incremental batch processing with progress tracking
5. Ranking: Personalized recommendations sorted by compatibility

1. Download: Fetch from R2 or original source with fallback
2. Text Extraction: Format-specific extractors (PDF, Office, archives)
3. AI Analysis: Gemini 1.5 Pro with structured output
4. Quality Gate: Novelty and completeness validation
5. Storage: PostgreSQL with versioning and audit trail

Domain-Based Schema Organization (26 domains, 150+ models):

• Base Domain: Core authentication and user models
• User Domain: Users, companies, directors, profiles
• Tender Domain: Tenders, documents, organizations, sources
• Matching Domain: Applications, scoring, recommendations
• Document Domain: Vault, analysis, knowledge base
• Notification Domain: Multi-channel delivery system (7 models)
• Subscription Domain: Payments, plans, invoicing
• AI Domain: Conversations, messages, feedback, usage (5 models)
• Compliance Domain: POPIA audit, consent, data protection (7 models)
• Intelligence Domain: Procurement intel, alerts, reports (9 models)
• Publisher Domain: API keys, domains, widgets
• SEO Domain: Metadata, sitemaps, schema markup
• Trust Domain: Platform badges, tender evidence, source credibility

Key Features:

• Additive-only schema evolution for safety
• POPIA compliance with full audit trail
• Real-time features (presence, notifications)
• Complete AI integration tracking
• Multi-tenant support for publishers

1. Register & Build Profile:

   • Complete company profile with industry, B-BBEE, capabilities
   • Upload supporting documents (tax clearance, registrations)
   • Set preferences for tender notifications

2. Discover Tenders:

   • Browse AI-matched recommendations on dashboard
   • Search by category, province, organization, or keywords
   • Filter by status, value range, closing date
   • View detailed tender specifications

3. Analyze Opportunities:

   • AI-extracted evaluation criteria and requirements
   • Compatibility score with detailed breakdown
   • Estimated tender value with confidence rating
   • Competitor intelligence and award history

4. Apply with AI Assistance:

   • Pre-filled application forms from company profile
   • AI-generated proposal drafts
   • Automated document attachment from vault
   • Compliance checker with requirement validation

5. Track & Learn:

   • Application status tracking
   • Success rate analytics
   • Winning pattern identification
   • Continuous profile optimization

1. API Integration:

   • RESTful API with enriched tender data
   • SDKs for TypeScript, Python, CLI
   • Webhook notifications for new tenders
   • Rate limiting and authentication

2. Embeddable Widgets:

   • Procurement intelligence feed
   • Award winners showcase
   • Sector trends visualization
   • Provincial opportunity heatmap
   • Top companies leaderboard

3. White-Label Solutions:

   • Custom domain mapping
   • Branded widget styling
   • Impression tracking and analytics
   • Revenue sharing models

Starter - R499/month:

• 10 tender applications per month
• AI-matched recommendations
• Basic search and filtering
• Email notifications
• Document vault (5 documents)

Professional - R1,299/month:

• 50 applications per month
• Advanced AI features (proposal generation, compliance checking)
• Priority support
• Document vault (50 documents)
• Analytics dashboard
• API access (1,000 requests/month)

Enterprise - R3,999/month:

• Unlimited applications
• Dedicated account manager
• Custom API limits
• White-label widgets
• SLA guarantee (99.9% uptime)
• Advanced analytics and reporting

• Pay-Per-Application: R150 per application (no subscription required)
• Professional Services: Tender writing, compliance audits, B-BBEE consulting
• API Licensing: Developer API subscriptions and overage fees
• Data Products: Anonymized procurement intelligence reports
• Widget Embedding: Publisher revenue sharing for third-party integrations

• Target Market: 2.4M registered businesses in South Africa
• Focus Segments: SMEs in construction, IT, consulting, logistics
• Differentiation: Only AI-powered tender matching platform in South Africa
• Value Proposition: 80% time savings on tender discovery and application

Full Protection of Personal Information Act implementation:

• Consent management with granular controls
• Purpose limitation and data minimization
• Comprehensive audit logging
• Right to access and data portability
• Right to erasure with secure deletion
• Data retention policies
• Security incident tracking

• Custom JWT-based authentication (7-day expiry)
• Secure HTTP-Only cookie transport
• Edge middleware for token injection
• Role-based access control (User, Admin, Super Admin)
• Session management with Redis
• Password hashing with bcrypt (12 rounds)

• Input validation with Zod schemas
• SQL injection prevention (parameterized queries)
• XSS protection (content sanitization)
• CSRF protection on state-changing operations
• Rate limiting on authentication endpoints
• Environment variable security

• AWS production deployment in Cape Town region
• Encrypted database connections (PostgreSQL SSL)
• Secrets management (AWS Secrets Manager)
• Regular security audits
• Backup and disaster recovery procedures

• Node.js 20+ (LTS recommended)
• PostgreSQL 15+ or SQLite (development)
• Redis 7+ (optional for caching)
• Git for version control

# Clone repository
git clone https://github.com/Tenders-SA/tenders-sa.org.git
cd tenders-sa.org

# Install dependencies
npm install

# Setup environment variables
cp .env.example .env
# Edit .env with your configuration

# Build database schema from domain files
npm run schema:build

# Initialize database
npx prisma db push
npx prisma generate

# Seed sample data (optional)
npx tsx prisma/seed.ts

# Start development server
npm run dev

Access the application at http://localhost:3000

Required environment variables:

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/tenders_sa"
DIRECT_URL="postgresql://user:password@localhost:5432/tenders_sa"

# Authentication
JWT_SECRET="your-secure-random-secret"
NEXTAUTH_URL="http://localhost:3000"
NEXTAUTH_SECRET="your-auth-secret"

# AI Providers
GEMINI_API_KEY="your-gemini-api-key"
GROQ_API_KEY="your-groq-api-key"

# Cloudflare
CLOUDFLARE_WORKER_URL="https://tender-source.tenders-sa.org"
CLOUDFLARE_WORKER_SECRET="your-worker-secret"

# Redis (optional)
REDIS_URL="redis://localhost:6379"

# Email (optional)
RESEND_API_KEY="your-resend-key"
SENDPULSE_API_KEY="your-sendpulse-key"

# CIPC Integration (optional)
CIPC_USERNAME="your-cipc-username"
CIPC_PASSWORD="your-cipc-password"

# Development
npm run dev              # Start dev server (localhost:3000)
npm run build            # Production build (only on AWS)
npm run start            # Start production server

# Database
npm run schema:build     # Build schema from domain files
npm run db:push          # Sync schema to database
npm run db:studio        # Open Prisma Studio
npm run db:validate      # Validate schema
npm run db:seed          # Load sample data

# Code Quality
npm run lint             # Run ESLint
npm run type-check       # TypeScript compilation check
npm run format           # Format with Prettier

# Testing
npm run test             # Run all tests
npm run test:watch       # Watch mode
npm run test:coverage    # Coverage report

The platform supports Windows development with automatic compatibility handling:

# Kill Node processes
Stop-Process -Name "node" -Force

# Find process on port 3000
Get-NetTCPConnection -LocalPort 3000

# Set Windows-specific environment variables
$env:DISABLE_BLOG_FS="true"
$env:DISABLE_KB_FS="true"

# Start development
npm run dev

• Status: LIVE in production (AWS Cape Town)
• Uptime: 99.9% SLA target
• Daily Tender Sync: Automated via Cloudflare Workers
• Users: Growing SME and enterprise customer base
• Tenders: 10,000+ active listings

2026 Q2 (Current):

• ✅ Dev API Enriched v0.1 — Intelligence platform evolution
• ✅ Published 7 npm packages under @tenders-sa-org scope
• ✅ Stabilized 83 core service modules (zero TS errors achieved)
• ✅ Document Conversion System — DOCX/DOC AI pipeline support
• ✅ Unified Document Extraction — 10+ format support with ZIP handling
• ✅ Platform Changelog System with automated maintenance

2026 Q1:

• ✅ Tender Ingestion Service stabilization (90% production-ready)
• ✅ Matching Algorithm enhancement with dual-path scoring
• ✅ Batch Stabilization Sprint across 83 modules
• ✅ Trust System implementation (platform badges, tender evidence)
• ✅ Cache Optimization & Remediation (deduplication, pattern deletion)

2025 Q4:

• ✅ Security Hardening (JWT validation, rate limiting, stack trace removal)
• ✅ Schema Consolidation (26 domain files, 150+ models)
• ✅ Service Layer Refactor (N+1 query fixes, silent error handling)
• ✅ Procurement Intelligence System (9 source adapters, 22 API routes)
• ✅ Email Templates Extraction (7 reusable templates)

• Matching Algorithm: Dual-path unification pending (tender detail vs automation)
• React Error 31: Frontend patched, backend score field type refinement needed
• OCPO Integration: Restricted supplier blacklist sync in progress
• Analysis Framework: Document classification expansion (14+ section taxonomy)

Immediate Priorities (Q2 2026):

• Amazon SES adoption for high-volume email
• OCPO Restricted Supplier Integration
• Tender Detail Analysis Framework improvements
• Competitive Intelligence embedded views

Near-Term Roadmap (Q3 2026):

• Mobile application (React Native)
• Real-time collaboration features (WebSocket)
• Advanced analytics dashboard
• Machine learning model improvements

Long-Term Vision (2027):

• Pan-African expansion (Kenya, Nigeria, Ghana)
• Blockchain-based bid verification
• Automated compliance reporting
• Tender writing automation suite

This is a proprietary platform under active development. Contributions are limited to authorized team members.

The project follows strict development workflows documented in:

• .clinerules/production-rules.md — GSD 4-phase cycle (PLAN → BUILD → TEST → SHIP)
• .kiro/steering/WORKFLOWS.md — 5 canonical workflows
• .kiro/steering/IMMUTABLE_REGISTRY.md — Frozen module catalog
• .kiro/steering/PRODUCTION_STABILITY.md — Module stability scoring

AI agents (Gemini, Cline, Kiro) are integrated into the development workflow. See AGENTS.MD for:

• Agent identity and role assignment
• Context loading strategies
• Skill loading protocols
• Inter-agent communication via Git

This project contains proprietary business logic and is protected under South African intellectual property laws. The codebase is for authorized use only.

• Privacy Policy: POPIA-compliant data handling
• Terms of Service: Platform usage agreements
• Cookie Policy: GDPR cookie compliance
• Refund Policy: Subscription cancellation terms
• SLA: Uptime and support commitments

This project uses open-source software under the following licenses:

• Next.js (MIT)
• React (MIT)
• Prisma (Apache 2.0)
• Tailwind CSS (MIT)
• ShadCN UI (MIT)

See package.json for complete dependency list.

• Email: support@tenders-sa.org
• Phone: +27 (0)XX XXX XXXX (business hours)
• Help Center: https://www.tenders-sa.org/support
• Live Chat: Available on dashboard (registered users)

• API Documentation: https://api.tenders-sa.org/docs
• Developer Portal: https://www.tenders-sa.org/publishers/developers
• SDK Issues: GitHub Issues (respective SDK repositories)
• Technical Support: developers@tenders-sa.org

• Press Inquiries: press@tenders-sa.org
• Media Kit: https://www.tenders-sa.org/press

• B-BBEE Integration: Level-based matching and contractor requirements
• POPIA Compliance: Full data protection framework
• CIDB Integration: Construction Industry Development Board data
• CSD Support: Central Supplier Database registration assistance
• ZAR Currency: Local pricing and payment processing

• Government Tenders: National, provincial, municipal opportunities
• SOE Tenders: State-owned enterprises (Eskom, Transnet, etc.)
• Private Sector: Corporate procurement opportunities
• SME Support: Tools and guidance for small businesses
• Industry Coverage: Construction, IT, consulting, logistics, services

All 9 South African provinces with dedicated pages and analytics:

• Gauteng
• Western Cape
• KwaZulu-Natal
• Eastern Cape
• Limpopo
• Mpumalanga
• North West
• Free State
• Northern Cape

• Tender Database: 10,000+ active listings
• Daily Syncs: 100% success rate via Cloudflare Workers
• API Uptime: 99.9% (30-day average)
• Search Latency: <100ms (p95)
• Document Processing: 95% success rate

• Profile Completion: 70% (7-step wizard)
• Weekly Tender Views: 15+ per active user
• Match-to-Application: 8% conversion rate
• User Retention: <5% monthly churn

• Month 3: 200 subscribers (R150k MRR)
• Month 6: 800 subscribers (R600k MRR)
• Month 12: 2,500 subscribers (R2.5M MRR)
• Year 1: R20M annual run rate

Built with ❤️ for South African Business Growth

Tenders-SA.org — Transforming how businesses discover and win tenders through AI-powered intelligence.

Version: 1.0.0
Last Updated: June 2026
Status: Production Deployment