Glossary

Domain terms used across 961tech docs and code. If you write a doc that uses a term not in this list and that isn't obvious from context, add it here.

Actors

Visitor — anonymous user, no account. Can browse, search, build a PC, and follow deep-links to retailers. Build state persists in a signed build_session HTTP cookie (1y expiry).

Builder — signed-in user. Inherits everything Visitor can do, plus saved builds, share-via-slug, and price drop alerts.

Retailer — Lebanese computer parts merchant whose listings are scraped (M1) or who self-onboards via a feed (UC-K, M3 deferred).

Operator — MASTER. Has admin tools (UC-J) and runs affiliate reconciliation (UC-L).

Catalog

Canonical product — A normalised SKU in 961tech's catalog (e.g., "Corsair RM850x"). Identified by category + brand + model + spec. One canonical product → many listings (one per retailer).

Listing — A specific retailer's offer for a canonical product. Carries priceUsd, stockState, imageUrl, the original listing URL, and a click-tracking deep-link.

Match rate — % of scraped listings that successfully resolve to a canonical product. M1 overall ≈ 13.5%. CPU 39.6%, GPU 40.3%, others under 10% pending LLM-assisted spec extraction.

AIB — Add-In Board. Third-party GPU manufacturers (ASUS, MSI, Gigabyte, etc.) that build cards using NVIDIA or AMD reference chips. Matching AIB cards is harder because retailer titles often lead with the AIB brand instead of NVIDIA/AMD.

Quote-only — Listing with no public USD price; merchant requires a quote request. 961Souq has many of these.

Build

Build — A user-assembled PC: one component per slot (CPU, COOLER, MOTHERBOARD, RAM, STORAGE, GPU, CASE, PSU). Owned by a Visitor (cookie) or Builder (account).

Slot — One of the 8 PC component categories in a Build.

Per-retailer cart — A cart for a single retailer containing the components of a Build that retailer carries.

Cart aggregator / multi-merchant optimizer — UC-12. Computes the cheapest combination of retailers to source a complete build, considering shipping, in-stock, and quote-only.

Compatibility check — UC-B. Set of rules verifying a Build's components physically and electrically work together (CPU socket vs motherboard, RAM type, PSU wattage, etc.). Currently rule-based; expanding in #22.

Conversion / affiliate

Deep-link — A 961tech URL (/api/go/r/[retailerId]/p/[listingId]) that records a Click and 302-redirects to the retailer's product page. UC-2 Buy via deep-link.

S2S postback — Server-to-server callback from retailer to 961tech confirming a click resulted in a purchase. Powers UC-L Affiliate reconciliation. Contract TBD (#17).

Other

M1 / M2 / M3 — Month 1, 2, 3 release scopes. M1 is the prototype shipped 2026-04-26 (v1.0.0-rebuild tag). M2 is the next milestone. M3 is deferred work (UC-K, laptops, prebuilts).

bits — Lebanese hosting provider; planned target for the v1 deploy (#19).

Cedar / petrol black / heat orange — Brand palette. Cedar green is the consumer accent (Lebanese cedar reference); petrol black is the page base; heat orange is for hot CTAs and the Operator role in diagrams.