Status. Proposed design only. Nothing in this vault is DG client approval. No application, service or test has been executed; every scenario is Not executed. Fees and dates are open.

Opportunities and Discovery

Purpose

Drafts, immutable versions, exact-version approval, publication, material revision, search and one transparent rule ranking.

Source notes

Versions-and-State, Data-Model, Step-04-Opportunities-Versions-Approvals, Step-05-Discovery-and-Rule-Ranking, Q02, Q03, Q06

Current state

Proposed. No code exists. Build steps: Step-04-Opportunities-Versions-Approvals, Step-05-Discovery-and-Rule-Ranking.

Minimal Context Set

Read these first, then only the sections the task needs:

1. Versions-and-State
2. Data-Model
3. Step-04-Opportunities-Versions-Approvals
4. Step-05-Discovery-and-Rule-Ranking
5. Q02
6. Q03
7. Q06

Tables and records owned

Opportunity, opportunity version, approval record, search index and ranking inputs.

Endpoints (illustrative, see Request-Pipeline)

POST /v1/opportunities, PATCH /v1/opportunities/{id}, POST /v1/opportunities/{id}/publish, GET /v1/opportunities, GET /v1/recommendations.

Revision and lifecycle are separate: V1 stays live while V2 is reviewed (Versions-and-State). No AI or percentage matching gate; ranking is rule-based.

Scenarios (primary step in this module)

T05, T06, T07, T08, T13, T14, T15, T21, T22

Statuses and gates: Scenario-Inventory. All Not executed.

Open decisions

Q02, Q03, Q06. Dependent behaviour is Blocked by Qnn; see Decision-Gates.

Known limitations

None recorded beyond the vault’s own boundaries.

Change history

Date	Change
2026-10-20	Created (bootstrap Phase 2)