This page is the map that ties the DomiDo platform's product evidence, requirement documents, APIs, and acceptance criteria together. It exists so reviewers can confirm that nothing in the mock has been dropped on the way to engineering and that nothing in the requirements has been invented without a source. When a question about a feature arises, this is the page to consult first — it points to the originating evidence and to the verification path. The page reads top-down: first the source-by-source map from product evidence to the requirement documents that capture it, then the cross-document matrix showing where each requirement family lives, then the interface and acceptance traceability tables that close the loop to the API and the test catalogue, then the inventory of claim classes the project has removed from earlier drafts to keep the document set evidence-bound.
The startup's phased rollout — Phase A Web/PWA public interest beta with the user-owned gallery and non-binding interest reservations, Phase A.5 gated SetupIntent no-capture pre-orders and supply readiness, Phase B capture, fulfilment, and payout release, Phase C expansion, native deferral, and feature phase gates — traces to the platform delivery strategy and to the explicit decision to insert Phase A.5 before Phase B fulfilment. The React Native and Expo target, React Native Web for Web/PWA, Web desktop as the current mandatory validation target, and iOS and Android compatibility through platform adapters trace to the architecture section and the architecture decision records.
Specific surfaces trace to the mock files that originated them. The shared application shell — configured language, locale, and search scopes, the IRS shell and config paths, and the acceptance criteria for the shared shell — traces to components/app-header.jsx and the shared mock files. The multilingual user-generated content surface — backend-configured supported languages, asynchronous LLM translation jobs, the LocalizedText resource, source-language fallback, privacy exclusions, and authorisation-preserving translated variants — traces to the user language selector, the dashboard preferred-language field, and every free-form create, listing, designer, help, and message input in the mock. The reliability and recovery surface — lean Phase A reliability targets, operational health, readiness, and liveness endpoints, dependency degradation behaviour, transaction retry and reconciliation, worker recovery, provider outage handling, and backup and restore rehearsal — traces to the platform availability expectations, the backend architecture, the beta operations plan, and the user reliability audit. The telemetry, support, and beta-learning surface — the controlled product-event taxonomy, analytics ingestion, support queue, replies, and SLA, beta feedback, founder dashboard, alert rules, incidents, correlation ids, and data-class separation — traces to the user telemetry and support audit, the startup delivery plan, the founder beta dashboard requirement, and the mock support, help, account, and dashboard surfaces. The authentication modal traces specifically to components/auth-modal.jsx.
The discovery and create surfaces trace to the home, gallery, and create mock. The supported model and source formats (GLB, GLTF, OBJ, STL), the 100-megabyte limit, the listing card, and the discovery, search, save, and share requirements all trace to the home, gallery, and listing mock files and to the product correction that locked the upload formats. The create flow — draft stages, style reference presets, saved-draft resume, the compulsory front face, optional faces, configurable generation costs, model feedback, the block kit, BOM, assembly, publish, and disabled Phase A remixes — traces to create.jsx, create-stages.jsx, create-stages-2.jsx, and the product corrections.
Commerce and order traceability is grouped by phase. The Phase A non-binding interest reservation, cancellation, no-card and no-charge and no-order and no-pre-order language, the Phase A.5 invited SetupIntent no-capture pre-order, typed checkout mutations, jurisdiction support, Stripe-only payment where active, supported-card copy from Stripe and jurisdiction, jurisdictional VAT, and the Phase B PaymentIntent and order capture trace to the listing, checkout, and dashboard mock files and to the payment corrections. The Phase A.5 pre-order commitment, cancellation, conversion readiness, the absence of receipt, invoice, shipment, and promised ship date, the Phase B order creation, the missing-block wait, the production-readiness wait, the order notifications, tracking detail, delivery preferences, typed order actions, returns, replacements, reports, return fees, and disputes trace to the buyer dashboard and order mock files and to the order corrections. The blacklist and restriction state, support and dispute challenge, audit, and permission rules trace to the customer-extremism and anti-abuse correction.
Designer surfaces trace to their own mock files. Listing-owner launch, scene staging, photo generation, video generation, the library, private generated assets, add-to-listing, and configurable generation costs and options trace to promo-studio.jsx, listing-designer-sections.jsx, and DomiDo Listing.html. Listing edit, owner editor aggregate, moderation rerun configuration, similarity and uniqueness state, analytics, review replies, Q&A replies, FAQ candidates, message reports, claim actions, Promo Studio launch, royalty 0–25, VAT-inclusive royalty, derived price, ad-boost context, and the Phase A disabled remixes trace to the designer listing and dashboard mock files and to the payout and royalty corrections. The Phase A.5 Stripe Connect states, KYC, configurable payout thresholds, fees, schedules, and labels, payout readiness, projected royalties, statement previews, payout request fee default 2%, below-minimum fee default 2%, payout no earlier than 30 days after Phase B delivery, transfer ledger, failed payouts, reserves, disputes, activity, and tax exports trace to dashboard-data.jsx, dashboard-designer.jsx, mobile-designer.jsx, the settings mock files, the payout corrections, and the Phase A.5 designer activation decision.
The help, workshop, legal, and footer surfaces — the Docusaurus-published static help-and-workshop article layer, the general help information architecture, the article reader, search, and support structure, the platform backend user-generated comments, replies, likes, and reports, admin-only content mutation and publication, and the removal of specific article-body requirements — trace to the workshop, help, and shared mock files and to the content correction.
| Requirement family | Primary documents | Verification documents |
|---|---|---|
| Delivery phase governance | Software overview, functional, data, business rules | Interface, OpenAPI, use cases, acceptance |
| Universal app target and test gate | Software overview, engineering, non-functional, architecture | Acceptance |
| Evidence policy and product corrections | Software overview | This traceability page, acceptance |
| Shared shell, footer, configuration | Software overview, functional, data | Interface, OpenAPI, acceptance |
| Multilingual UGC translation | Software overview, functional, data, security, audit | Interface, OpenAPI, acceptance |
| Reliability, robustness, recovery | Non-functional, functional, data, security operations, integration, backend spec | Interface, OpenAPI, acceptance |
| Observability, support, beta learning | Software overview, functional, data, non-functional, audit, backend spec, security operations | Interface, OpenAPI, acceptance |
| Authentication | Software overview, functional, data, security, user roles | Interface, OpenAPI, acceptance |
| Security, denial-of-service, idempotency | Security, non-functional, functional, data, security operations, integration, backend spec | Interface, OpenAPI, acceptance |
| Public discovery and listings | Software overview, functional, data | Interface, OpenAPI, use cases, acceptance |
| Create, upload, generation, model feedback | Software overview, functional, data, business rules, security, audit | Interface, OpenAPI, use cases, acceptance |
| Promo Studio | Software overview, functional, data, business rules, security, audit, user roles | Interface, OpenAPI, use cases, acceptance |
| Stripe checkout, payment, jurisdiction | Software overview, functional, data, business rules, security, audit | Interface, OpenAPI, use cases, acceptance |
| Pre-orders, orders, returns, trust, build companion | Software overview, functional, data, business rules, security, audit | Interface, OpenAPI, use cases, acceptance |
| Designer listing, royalty, remix disable | Software overview, functional, data, business rules, audit, user roles | Interface, OpenAPI, use cases, acceptance |
| Payout, tax, statements | Software overview, functional, data, business rules, security, audit, user roles | Interface, OpenAPI, use cases, acceptance |
| Privacy, help, legal, admin content | Software overview, functional, data, security, audit, non-functional, user roles | Interface, OpenAPI, use cases, acceptance |
The interface specification organises every REST path defined by the platform into API groups. The table below collects them so a reviewer can locate the path catalogue for each functional area without re-reading the full interface page.
| API group | Paths |
|---|---|
| Operations | /health, /livez, /readyz |
| Shell, config, analytics | /app-shell, /footer, /config/jurisdictions, /config/generation-costs, /config/create-style-presets, /config/promo-studio, /config/payouts, /config/feature-phases, /config/translations, /config/product-events, /search, /newsletter-signups, /analytics/events |
| Authentication and account identity | /auth/oauth, /auth/sign-out, /me, /me/preferences, /me/dashboard, /me/trust-restrictions |
| Discovery | /gallery/listings, /listings/{listingId}, /listings/{listingId}/related, /listings/{listingId}/save, /listings/{listingId}/share, /listings/{listingId}/questions, /listings/{listingId}/reviews, /designers, /designers/{designerId}, /designers/{designerId}/follow |
| Create | /media/uploads, /media/{mediaId}/crop, /design-drafts/current, /design-drafts, /design-drafts/{draftId}, /design-drafts/{draftId}/reference-media, /design-drafts/{draftId}/projection-faces/{face}, /design-drafts/{draftId}/projection-faces/{face}/generate, /design-drafts/{draftId}/projection-faces/autofill, /design-drafts/{draftId}/projection-faces/{face}/history/{historyId}/restore, /design-drafts/{draftId}/model-jobs, /design-drafts/{draftId}/model-tryouts/{tryoutId}/select, /design-drafts/{draftId}/model-tryouts/{tryoutId}/feedback, /design-drafts/{draftId}/block-kit-jobs, /design-drafts/{draftId}/block-kit/bom, /design-drafts/{draftId}/block-kit/assembly, /design-drafts/{draftId}/publish-settings, /design-drafts/{draftId}/save, /design-drafts/{draftId}/publish, /jobs/{jobId}, /jobs/{jobId}/cancel, /jobs/{jobId}/retry, /tag-suggestions, /assist/text-jobs |
| Reservations | /listings/{listingId}/interest, /me/interest-reservations, /interest-reservations/{reservationId}, /admin/interest-reservations, /interest-reservations/{reservationId}/invite-preorder |
| Commerce | Phase A.5 and Phase B /cart, /cart/items, /cart/items/{itemId}, /cart/items/{itemId}/save-for-later, /saved-carts, /saved-carts/{savedCartId}/resume, /saved-carts/{savedCartId}, /checkout, /checkout/delivery, /checkout/payment, /checkout/setup-intent, /checkout/stripe-session, /checkout/promo-code, /checkout/review, /checkout/confirm, /stripe/webhook |
| Pre-orders | /pre-orders, /pre-orders/{preOrderId}, /pre-orders/{preOrderId}/cancel |
| Orders | /orders, /orders/{orderId}, /orders/{orderId}/tracking, /orders/{orderId}/cancel, /orders/{orderId}/payment-retry, /orders/{orderId}/delivery-address, /orders/{orderId}/delivery-preferences, /orders/{orderId}/returns, /orders/{orderId}/return-assessments, /orders/{orderId}/replacements, /orders/{orderId}/reports, /orders/{orderId}/disputes, /orders/{orderId}/receipt, /orders/{orderId}/invoice, /orders/{orderId}/build-companion, /orders/{orderId}/build-companion/photos |
| Designer | /designer/profile, /designer/dashboard, /designer/listings, /designer/listings/{listingId}/editor, /designer/listings/{listingId}, /designer/listings/{listingId}/duplicate, /designer/listings/{listingId}/artifact-pack/download, /designer/listings/{listingId}/royalty, /designer/listings/{listingId}/ad-boost, /designer/listings/{listingId}/moderation-jobs, /designer/listings/{listingId}/similarity, /designer/listings/{listingId}/analytics, /designer/listings/{listingId}/copy-change-requests, /designer/listings/{listingId}/promo-studio, /designer/listings/{listingId}/promo-studio/scene, /designer/listings/{listingId}/promo-studio/photo-jobs, /designer/listings/{listingId}/promo-studio/video-jobs, /designer/listings/{listingId}/promo-studio/assets, /designer/listings/{listingId}/promo-studio/assets/download, /designer/listings/{listingId}/promo-studio/assets/{assetId}, /designer/listings/{listingId}/promo-studio/assets/{assetId}/download, /designer/listings/{listingId}/promo-studio/assets/{assetId}/listing-gallery, /designer/sales, /designer/sales/{saleId}, /designer/sales/{saleId}/dispute, /designer/action-queue, /designer/messages/{messageId}/reply, /designer/listings/{listingId}/questions/{questionId}/reply, /designer/listings/{listingId}/questions/{questionId}/faq-candidate, /designer/reviews/{reviewId}/reply, /designer/message-threads/{threadId}/nodes/{nodeId}/reply, /designer/message-threads/{threadId}/nodes/{nodeId}/report, /designer/claims/{claimId}/actions, /designer/payout-account, /designer/payout-account/connect, /designer/payout-account/schedule, /designer/payouts, /designer/payouts/request, /designer/payouts/{payoutId}, /designer/payouts/{payoutId}/retry, /designer/payout-reserves, /designer/payout-events, /designer/statements, /designer/statements/{statementId}/export, /designer/tax-statements/{taxYear}/export |
| Account, help, legal, admin, beta operations | /account/profile, /account/profile/avatar, /account/addresses, /account/addresses/{addressId}, /account/payment-references, /account/payment-references/setup-intent, /account/payment-references/{paymentReferenceId}, /account/notification-items, /account/notification-items/{notificationId}/read, /account/notification-items/read-all, /account/privacy, /account/data-export-requests, /account/lifecycle-requests, /account/security, /account/security/password, /account/security/2fa, /account/security/sessions/{sessionId}, /account/notifications, /help/articles, /help/topics, /help/articles/{slug}, /help/articles/{slug}/feedback, /help/articles/{slug}/bookmark, /help/articles/{slug}/comments, /help/articles/{slug}/comments/{commentId}/replies, /help/articles/{slug}/comments/{commentId}/like, /help/articles/{slug}/comments/{commentId}/report, /beta/feedback, /support/conversations, /support/conversations/{conversationId}, /support/conversations/{conversationId}/messages, /admin/beta, /admin/beta/export, /admin/support/conversations, /admin/support/conversations/{conversationId}, /admin/support/conversations/{conversationId}/messages, /admin/reliability/incidents, /admin/alert-rules, /admin/help/articles, /admin/help/articles/{slug}, /admin/help/articles/{slug}/publish, /admin/help/topics, /admin/help/publication-artifacts, /legal/cookie-preferences |
The acceptance criteria are grouped by surface so that each group can be cross-checked against the requirement documents it depends on. The table below names the requirement coverage for each acceptance group.
| Acceptance group | Requirement coverage |
|---|---|
| Delivery phase governance, shared shell, authentication, configuration | Software overview, functional shared shell and authentication, data identity and configuration, security authentication, role permissions for public, account, and admin |
| Multilingual user-generated content | Software overview multilingual policy, functional translation rules, data LocalizedText and translation job data, interface translation configuration and job interfaces, security LLM privacy controls, audit translation events |
| Upload and create | Software overview create, functional create, data media and create, business rules upload and create, security upload, audit media and create |
| Discovery and listing | Software overview public, functional discovery and listing, data listing, use cases discovery |
| Cart and checkout | Software overview buyer, functional checkout, data checkout and pre-order, business rules checkout and payment, security payment and order |
| Orders, returns, trust, build companion | Functional pre-orders, orders, returns, trust, data pre-orders and orders and trust, business rules order and trust, security order rules, audit order and trust events |
| Designer | Software overview designer, functional designer and payout, data designer commerce, business rules designer, role permissions for designer |
| Account, help, privacy, audit, observability | Software overview account, privacy, help, observability, functional help, legal, and operations, data support, analytics, and beta, security privacy and admin, audit, non-functional privacy, accessibility, observability |
| API, security, reliability, requirement hygiene | Interface and OpenAPI parity, reference integrity, public and private security, standard errors, rate limits, idempotency, CSRF, webhook safety, dependency failure behaviour, health, readiness, liveness, restore rehearsal, requirement hygiene |
The current requirement set has removed the following claim classes from earlier drafts to keep the document set evidence-bound. Unsupported payment-provider and payment-option requirements are gone — Stripe is the only payment provider. The obsolete model-and-source upload size limit has been replaced by the 100-megabyte rule, and model and source uploads other than GLB, GLTF, OBJ, and STL have been removed. Fixed AI generation cost requirements have been removed because costs are configurable, and post-checkout manual queue and wait-time metric requirements have been removed entirely. Fixed payout numbers, fixed payout days, fixed per-block royalty copy, and fixed reversal windows have all been removed in favour of configuration. Specific Workshop and Help article-body, slug, shipping, material, application-statistic, and story requirements have been removed; the platform keeps only the Docusaurus public publication layer, the general content structure, the platform backend discussion and support records, and the admin-only content mutation and publication rules.
Several monetisation claim classes have likewise been removed. Mock-visible designer monetisation, royalty, payout, tax, ad boost, and remix surfaces that conflict with the product corrections are removed; remixes are disabled in Phase A. Promo Studio and payout, reserve, and dispute workflow demo values are removed — credit costs, payout grace and hold windows, reserve percentages, dispute fees, payout dates, and provider tool labels must come from configuration or source transaction and provider state. Threshold, fake-popularity, guaranteed-fulfilment checkout semantics and unphased no-charge claims are removed: Phase A SetupIntent pre-orders are replaced with non-binding interest reservations, SetupIntent no-capture pre-orders are permitted only in Phase A.5 after gates, and Phase B is required before charged orders, fulfilment readiness, receipts, invoices, shipment, and payout release. Mock language lists, locale and currency lists, country choices, delivery labels, search scopes, moderation rerun costs, and ad-boost budget ranges are removed as production truth — they are configuration examples unless returned by API configuration. Mock carrier labels, ETA values, fixed VAT rates, refund timing, attachment limits, report categories, auto-reply text, and seeded Help comments are removed as production truth — they are demo data unless returned by typed domain resources or configuration. UI localisation is no longer conflated with user-generated content translation — mock language controls do not by themselves satisfy multilingual content requirements, and the backend must store source text and asynchronous translated variants for configured supported languages.