Developer & QA index for all views shipped in M1–M4. Each entry includes a direct link, golden path to reach the view, confirmed use cases, and known gaps.
Replaces free-form Products with a TCGPlayer-style model: sellers pick a card from the global catalog and set price, condition, quantity, and language.
The seller's home base. Create, edit, and delete Pokémon card listings from a paginated data table. Listings tie a card from the global PokemonCards catalog to a price (MXN), condition, quantity, and language.
Golden path
Use cases
Known gaps
M1 missing use cases
Buyers can browse and find cards on the platform. The core marketplace loop: search → card page → add to cart.
Infinite-scroll grid of all Pokémon cards in the platform catalog. Each card tile shows the card image, set, lowest listing price in MXN, and active seller count. Filter pills let buyers narrow results by rarity, condition, price range, set ID, and sort order — all reflected in the URL.
Golden path
Use cases
Known gaps
Full card detail page. Shows card image, stats (HP, types, rarity, set, artist), and a table of all active seller listings for that card. Condition tabs (NM / LP / MP / HP / DMG) filter the listings table. Buyers pick a listing and add it to cart.
Golden path
Use cases
Known gaps
Shopping cart showing all items added from any card detail page. Items are grouped by seller (tenant). Each seller group has its own subtotal and independent checkout button — required because each seller processes payment via their own Stripe Connected Account.
Golden path
Use cases
Known gaps
M2 missing use cases
Orders have a complete lifecycle visible to both buyer and seller. Sellers can mark orders as shipped with a tracking number. Email notifications are sent on order confirmed and order shipped events.
Authenticated buyer view of all past orders, sorted newest first. Each row shows the order date, seller, item count, total in MXN, and a color-coded status badge (Pending / Paid / Shipped / Delivered / Cancelled).
Golden path
Use cases
Known gaps
Detailed view of a single order (/orders/[orderId]). Shows each line item with card image and price, order total, current status badge, and — once the seller marks it as shipped — the carrier name and tracking number.
Golden path
Use cases
Known gaps
Authenticated seller view of all orders placed through their store. Each order row shows card images, quantities, and order totals. Sellers can mark an order as shipped by entering a carrier name and tracking number. Submitting triggers the 'Order Shipped' email to the buyer.
Golden path
Use cases
Known gaps
M3 missing use cases
Platform is stable enough to invite the first real sellers. Commission logic corrected, dispute flow live, seller onboarding dead ends fixed, and fees are transparent before sign-up.
Platform automatically deducts an 8% commission on every completed sale, with a $8 MXN minimum and $850 MXN cap (~$50 USD). The fee is applied as a Stripe application_fee_amount on the seller's Connected Account checkout session — buyers and sellers never handle the split manually.
Golden path
Use cases
Known gaps
Buyers can report a problem with any completed order directly from the order detail page (/orders/[orderId]). Choose a reason (bad item, not delivered, fraud, or other), add a description, and submit. The report is filed in the Reports collection and visible to admins in the Payload admin panel.
Golden path
Use cases
Known gaps
bun run db:sync-cards to generate a live linkPayload admin UI only — navigate to /admin → Tenants or ReportsAdmins can suspend sellers and review dispute reports via the Payload admin UI. Suspended sellers are blocked from accepting new orders at checkout. Reports can be filtered by status (open / under-review / resolved) in the built-in list view.
Golden path
Use cases
Known gaps
Dead ends in the seller onboarding flow have been removed. After sign-up, sellers are taken directly to /stripe-verify. After completing Stripe onboarding they land on /seller/dashboard (not the Payload admin). The dashboard shows a persistent banner with a CTA to connect Stripe, and the 'New Listing' button is hidden until the seller's Stripe account is connected.
Golden path
Use cases
Known gaps
Static page explaining the VendeCartas commission structure to prospective sellers before they sign up. Shows a three-tier commission table, concrete MXN examples, and a FAQ about fund release timing. Linked from /stripe-verify so sellers can check fees mid-onboarding.
Golden path
Use cases
Known gaps
Super-admins can view all orders across every seller and release held funds after the 5-day escrow hold. Orders in Shipped status with shippedAt > 5 days ago show an enabled 'Liberar fondos' button. Clicking it calls stripe.payouts.create on the seller's Connected Account and transitions the order to Delivered.
Golden path
Use cases
Known gaps
M4 missing use cases
Logged-in users see a Bell icon in the navbar with a live notification count. Counts are derived from existing order statuses — no extra database collections required. Email confirmations are also sent to the seller's real email address on every new sale.
A Bell icon appears in the navbar for logged-in users. A red badge shows the total notification count, updated every 60 seconds. Clicking the bell opens a popover listing active notifications grouped by type: orders awaiting shipment (buyer), orders that have been shipped (buyer), and new sales to fulfill (seller).
Golden path
Use cases
Known gaps
A QA checklist of flows that cannot be reached or tested through the normal golden paths in the current build.
M1 — Seller Listings
M2 — Buyer Discovery
M3 — Order Lifecycle
M4 — Closed Beta