mataba/shop/docs/ADR/001-no-custom-tables-v1.md

ADR 001 – No Custom Tables in v1

Status: Accepted

Context

Wishlist/compare/Q&A/banners could use custom tables for performance. Customs add migration/upgrade burden and risk for a commercial theme sold on RTL-Theme where host environments vary.

Decision

Store all v1 data in WP primitives: CPT (xshop_banner, xshop_qa), wp_usermeta + cookies for wishlist/compare, single option xshop_settings. No custom tables.

Consequences

• Simpler install/uninstall, no dbDelta fragility.
• Query performance acceptable at ≤100k products; revisit if profiling shows bottleneck.
• Future ADR can introduce tables with migration path.