Appearance
Source:
CONTEXT.md. Edit it there; this page is generated at build time.
Affiliate Site
A Laravel + Filament affiliate-marketing content site: editorial content (reviews, comparisons, curated lists, guides) drives readers to affiliate offers for a catalog of products.
Language
Product: A catalog entry for a real-world item that can be recommended — has a name, brand, images, and one or more Affiliate Links. Reusable across many pieces of content so a single product's data and link are maintained once. Avoid: Item, offer (offer is a property of a Product, not the Product itself)
Brand: The manufacturer or merchant a Product belongs to. A shared catalog entity, not duplicated per Product.
Review: A content piece evaluating a single Product: overall rating, admin-defined sub-scores, pros/cons, spec table, verdict, FAQ. Works generically for any Product — not restricted to products that also appear in a Listicle or Comparison. Also carries first-hand evidence fields — is_hands_on (whether we physically tested the unit; the FTC prohibits implying testing that didn't happen), how_we_tested, tested_at, a short verdict_summary TL;DR distinct from the long verdict, measurements (quantitative test data), alternatives, a changelog of edits, last_reviewed_at, and its own gallery of first-hand photos (the site's strongest E-E-A-T signal — distinct from the Product's stock catalog image).
Comparison: A content piece pitting two or more Products head-to-head via a feature-by-feature table.
Listicle: A "best of X" content piece: an ordered list of Product picks, each with a rank and a written blurb. A pick can also carry an Award and a best_for one-line superlative. Also has how_we_picked (selection methodology) and last_reviewed_at. Avoid: List, roundup
Award: An optional superlative label on a single Listicle entry (e.g. "Best Overall", "Best Budget"), paired with a one-line best_for (e.g. "Best for public transport"). A property of the entry (the product-in-this-listicle), not of the Product itself — the same Product could earn a different Award in a different Listicle.
Measurement: A single quantitative data point recorded during hands-on testing for a Review (e.g. "Boil time: 95 seconds"), stored as {label, value, unit, note}. Distinct from Spec: a Spec is a manufacturer-stated attribute of the Product; a Measurement is something we personally measured while testing — first-hand evidence, not a catalog fact.
Affiliate Link: A named, cloaked outbound URL on a Product that redirects through the site (e.g. /go/{slug}) to the real affiliate/merchant destination. A Product can carry more than one (different Merchants), each independently trackable. Carries its own price/list_price/lowest_used_price and a price_updated_at timestamp; a price is only ever displayed while it is fresh relative to its Merchant's max_price_age_minutes — a stale price must never be shown (see Merchant). Avoid: Referral link, outbound link (too generic — this term implies the cloaking + tracking behavior specifically)
Merchant: The store or affiliate network an Affiliate Link points to (e.g. Amazon, Impact, or a direct merchant relationship) — a shared catalog entity, not free text. Replaces the old free-text network string column on Affiliate Link. Carries the merchant's licence requirements: disclosure_note (required disclosure copy, e.g. Amazon's "As an Amazon Associate..."), requires_price_timestamp (whether displayed prices need an "as of {time}" stamp), and max_price_age_minutes (how long a cached price may be shown before it's considered stale — Amazon's operating agreement caps this at 24h). Avoid: Network (that's now just a descriptive field on Merchant, not the entity itself)
Article: A content piece with no ratings or product references — title, body, hero image only. Covers both evergreen buying-advice ("Guide") and timely blog/news ("Post"); these are a type on Article used only for URL/section routing, not separate models, since their fields are identical. Avoid: Guide, Post, Blog post (all are just an Article type, not a distinct concept)
Click: A first-party record of a visitor following an Affiliate Link: which Product, which piece of content it was clicked from, when, and referrer. Logged in our own database in addition to firing a GTM/GA4 event — powers internal reporting (e.g. "top clicked products") independently of Google Analytics.
Author: The public-facing byline on content — name, photo, bio, credentials. Distinct from the admin User login (a User can be linked to an Author, but Author is what readers see, for on-page expertise/trust signals).
Redirect: A rule sending an old path on this site to a new address, with a 301 (moved for good) or 302 (temporary). Consulted only when a request would otherwise 404, so it can never hide a live page. Written automatically when a live record's slug changes. Not the same as an Affiliate Link's /go/{slug} redirect, which sends readers off-site to a merchant and is handled by RedirectController.
Page: An admin-editable static page (title + rich text + slug) for non-editorial content like About, Contact, Affiliate Disclosure, Privacy Policy, Terms — kept editable rather than hardcoded so policy text can change without a deploy.
Contact Message: A message a reader sent through the public contact form at /contact: name, email, subject, message, and whether an editor has handled it. Read-only once received; replies happen by email. Kept for twelve months, then pruned. Avoid: Enquiry, ticket, lead
Comment: A reader's comment on an Article (guide or blog post): name, email, a plain-text body, and a status — pending, approved or rejected. Held until an editor approves it; only approved comments show on the page, oldest first, and the email never shows. Reviews, Comparisons and Listicles take no comments, so reader opinion never sits beside a verdict or disclosure. Rejected comments are pruned 30 days after rejection. Avoid: Review (that is our own verdict on a Product), feedback, reply
Site Settings: The single set of site-wide values editors change without a deploy: site name, tagline, logo, favicon, footer blurb, contact email, social links, and SEO defaults (title template, site description, default share image, X handle, extra robots.txt rules). One row, cached until the next save. Secrets and third-party IDs (GTM, newsletter) are deliberately not Site Settings — they are environment config. Avoid: Options, config (config means config/*.php and .env)
Category: A flat (non-nested) grouping assigned independently to both content (Review/Comparison/Listicle/Article) and Product — content picks its own Category to power hub pages and nav regardless of which products it discusses; Product carries its own for catalog filtering. No freeform tagging alongside it in v1.
Spec: An admin-defined key/value attribute row on a Product (e.g. "Material: Stainless Steel"), not a fixed schema. The same Spec rows drive a Review's spec table and a Comparison's feature matrix (a Comparison aligns matching Spec keys across the Products being compared).