# Tenderline
> High-performance, fast, and SEO-led UK public procurement intelligence catalogue.

Tenderline normalises, links, and enriches official UK public procurement data into an evergreen procurement knowledge graph. It provides structured access for humans and AI agents to discover tenders, track buyer procurement history, identify winning suppliers, and analyze contract awards.

## Machine-Readable Resources
- **Tender Markdown Mirror:** Append `.md` to any canonical tender URL (e.g. `/tenders/{slug}.md`) or provide `Accept: text/markdown` header to retrieve a clean, LLM-optimized Markdown representation.
- **Public JSON API:** `GET /api/public/tenders/{ocid}` returns versioned, validated JSON with procedure details, lot breakdowns, awardees, signed contracts, and provenance links.
- **Sitemap:** `/sitemap.xml` contains a deliberately limited recent selection. Additional sitemaps cover active tenders and entity hubs; the historical catalogue remains accessible through search and permanent URLs.

## Canonical URL Hierarchy
- Tender Details: `https://tenderline.uk/tenders/{slug}-{ocid}`
- Buyer Intelligence: `https://tenderline.uk/buyers/{sourceId}`
- Supplier Directory: `https://tenderline.uk/suppliers/{sourceId}`
- Search & Filtering: `https://tenderline.uk/search`
- Market Insights & Early Engagement: `https://tenderline.uk/market-insights`
- Procurement Data Dashboard: `https://tenderline.uk/analytics`

## Core Concepts & Data Model
- **OCID (Open Contracting ID):** Stable identifier for the entire lifecycle of a procurement process (e.g. `ocds-h6vhtk-050df9`).
- **Procurement Lifecycle:**
  - `OPEN`: Tender proposals are actively being accepted prior to the deadline.
  - `CLOSED`: Submission deadline has passed; tenders are under evaluation.
  - `AWARDED`: Official award decision published with winning supplier(s) and contract value.
  - `ACTIVE CONTRACT`: Contract is currently under delivery with milestones and potential amendments.
  - `RE-PROCUREMENT`: Contract approaching renewal or re-tendering window.
- **Submission Route:** Identifies the external electronic tendering system (e.g. Delta eSourcing, Proactis, JAGGAER, Atamis, In-tend) where suppliers must submit bids.

## Data Provenance & Licensing
- Primary source: Official UK Find a Tender service OCDS (Open Contracting Data Standard) feed.
- Open Government Licence (OGL v3.0): Free for public and commercial reuse with attribution.