BIZ-MARKETPLACE-DISCOVERY.md — alaivOS Business · Marketplace Discovery Capsule¶

Version: 0.1 (stub) · Date: April 2026 · Owner: Citerius Holdings LLC Audience: Omicron, Lambda/Mu/Nu, Pi, Rho, capsule developers Status: STUB — Omicron to populate

Full specification for the marketplace-discovery capsule — the two-sided auction + ranking + blockchain-anchored settlement layer shared by every Mode B branch (Tractus, Construx, future Healthcare/Legal marketplaces).

Referenced from: BIZ-PLATFORM-MASTER-REF.md §05, BIZ-CAPSULE-REGISTRY.md §05, TRX-BRANCH-SPEC.md marketplace sections. Blocks: Tractus marketplace launch; Construx subcontractor marketplace.

§01 — Capsule Identity¶

TODO: capsule_id, dependencies (entity-reputation, entity-verification, identity-lock, coverage-referral), mode compatibility, branches.

§02 — Auction Mechanics¶

TODO: blind hybrid auction — providers bid independently, see pseudonymous aggregate stats after submitting own bid; client sees all bids pseudonymously, selects provider. Bid windows per branch (Tractus 24h, Construx 48-72h).

§03 — Ranking Algorithm¶

TODO:

FinalScore = (ReputationScore × W_rep)
           + (ContextualFitScore × W_fit)
           + (BidCompetitivenessScore × W_bid)

Default weights: W_rep=0.40, W_fit=0.35, W_bid=0.25. Each component defined.

§04 — Branch Config Block¶

TODO: full JSON block (request_term, provider_term, client_term, currency, bid_window_hours, client_selection_window_hours, min_bids_before_stats_visible, ranking_weights, blockchain config).

§05 — Blockchain Anchoring¶

TODO: every material event anchored to Polygon (Mumbai first 90 days → mainnet). Async — operational flow never waits. Per-branch CiteriumMarketplace.sol instance (dev / staging / prod). Gas cost ~$0.011 USD per completed transaction.

§06 — Dispute Resolution¶

TODO: Risk Ops retrieves anchor trail for contractId. Immutable hash chain proves contested facts. Dispute flow steps 1-5.

§07 — Firestore Collections¶

TODO: marketplace_requests, marketplace_bids, marketplace_awards, blockchain_anchors — all append-only.

§08 — Cloud Functions¶

TODO: marketplace-openRequest, marketplace-submitBid, marketplace-awardProvider, marketplace-blockchainAgent (async anchor submitter).

§09 — UI Surfaces¶

TODO: client request form, provider bid interface, bid stats visibility logic, award notification, anchor trail viewer.

§10 — Per-Branch Config Status¶

TODO: Tractus (longhaul only v1, lastmile Phase 2), Construx (subcontractor bidding), future branches.

§11 — Security & Rate Limits¶

TODO: bid spamming defense, reputation-gated bid access, auth per role (client/provider/admin).

§12 — Analytics¶

TODO: win rate per provider, average bid count, time-to-award, anchor cost/month, dispute rate.

Maintained by Omicron. Update as decisions lock. Push to biz KV key biz-marketplace-discovery after each update.