fluentcart-developer 3.0.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (609) hide show
  1. package/LICENSE.md +26 -26
  2. package/README.md +59 -59
  3. package/dist/cards/fluentcart/templates-native.js +1087 -1087
  4. package/dist/cards/fluentcart/tools.js +2309 -2309
  5. package/dist/skills/fluentcart-developer/SKILL.md +108 -108
  6. package/dist/skills/fluentcart-developer/examples/README.md +30 -30
  7. package/dist/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/fluent-cart/checkout.php +32 -32
  8. package/dist/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/functions.php +40 -40
  9. package/dist/skills/fluentcart-developer/examples/sample-custom-addon/fluentcart-custom-addon.php +113 -113
  10. package/dist/skills/fluentcart-developer/examples/sample-custom-payment-gateway/fluentcart-custom-gateway-example.php +148 -148
  11. package/dist/skills/fluentcart-developer/examples/sample-fee-surcharge-plugin/fluentcart-fee-surcharge.php +38 -38
  12. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/README.md +22 -22
  13. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/sample-plugin-with-licensing-sdk.php +79 -79
  14. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/FluentLicensing.php +303 -303
  15. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/LicenseSettings.php +566 -566
  16. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/PluginUpdater.php +304 -304
  17. package/dist/skills/fluentcart-developer/examples/sample-shipping-carrier/fluentcart-custom-shipping-carrier.php +61 -61
  18. package/dist/skills/fluentcart-developer/references/api/authentication.md +452 -452
  19. package/dist/skills/fluentcart-developer/references/api/coupons.md +786 -786
  20. package/dist/skills/fluentcart-developer/references/api/customers.md +889 -889
  21. package/dist/skills/fluentcart-developer/references/api/files.md +609 -609
  22. package/dist/skills/fluentcart-developer/references/api/index.md +432 -432
  23. package/dist/skills/fluentcart-developer/references/api/licensing.md +633 -633
  24. package/dist/skills/fluentcart-developer/references/api/order-bump.md +384 -384
  25. package/dist/skills/fluentcart-developer/references/api/orders.md +814 -814
  26. package/dist/skills/fluentcart-developer/references/api/products.md +866 -866
  27. package/dist/skills/fluentcart-developer/references/api/roles-permissions.md +536 -536
  28. package/dist/skills/fluentcart-developer/references/api/subscriptions.md +827 -827
  29. package/dist/skills/fluentcart-developer/references/database/index.md +44 -44
  30. package/dist/skills/fluentcart-developer/references/database/models/activity.md +178 -178
  31. package/dist/skills/fluentcart-developer/references/database/models/applied-coupon.md +291 -291
  32. package/dist/skills/fluentcart-developer/references/database/models/attribute-group.md +239 -239
  33. package/dist/skills/fluentcart-developer/references/database/models/attribute-relation.md +181 -181
  34. package/dist/skills/fluentcart-developer/references/database/models/attribute-term.md +219 -219
  35. package/dist/skills/fluentcart-developer/references/database/models/cart.md +645 -645
  36. package/dist/skills/fluentcart-developer/references/database/models/coupon.md +427 -427
  37. package/dist/skills/fluentcart-developer/references/database/models/customer-addresses.md +348 -348
  38. package/dist/skills/fluentcart-developer/references/database/models/customer-meta.md +156 -156
  39. package/dist/skills/fluentcart-developer/references/database/models/customer.md +584 -584
  40. package/dist/skills/fluentcart-developer/references/database/models/dynamic-model.md +163 -163
  41. package/dist/skills/fluentcart-developer/references/database/models/label-relationship.md +155 -155
  42. package/dist/skills/fluentcart-developer/references/database/models/label.md +153 -153
  43. package/dist/skills/fluentcart-developer/references/database/models/license-activation.md +182 -182
  44. package/dist/skills/fluentcart-developer/references/database/models/license-meta.md +163 -163
  45. package/dist/skills/fluentcart-developer/references/database/models/license-site.md +208 -208
  46. package/dist/skills/fluentcart-developer/references/database/models/license.md +640 -640
  47. package/dist/skills/fluentcart-developer/references/database/models/meta.md +233 -233
  48. package/dist/skills/fluentcart-developer/references/database/models/order-address.md +391 -391
  49. package/dist/skills/fluentcart-developer/references/database/models/order-download-permission.md +144 -144
  50. package/dist/skills/fluentcart-developer/references/database/models/order-item.md +383 -383
  51. package/dist/skills/fluentcart-developer/references/database/models/order-meta.md +303 -303
  52. package/dist/skills/fluentcart-developer/references/database/models/order-operation.md +158 -158
  53. package/dist/skills/fluentcart-developer/references/database/models/order-promotion-stat.md +175 -175
  54. package/dist/skills/fluentcart-developer/references/database/models/order-promotion.md +250 -250
  55. package/dist/skills/fluentcart-developer/references/database/models/order-tax-rate.md +172 -172
  56. package/dist/skills/fluentcart-developer/references/database/models/order-transaction.md +440 -440
  57. package/dist/skills/fluentcart-developer/references/database/models/order.md +727 -727
  58. package/dist/skills/fluentcart-developer/references/database/models/product-detail.md +397 -397
  59. package/dist/skills/fluentcart-developer/references/database/models/product-download.md +258 -258
  60. package/dist/skills/fluentcart-developer/references/database/models/product-meta.md +153 -153
  61. package/dist/skills/fluentcart-developer/references/database/models/product-variation.md +556 -556
  62. package/dist/skills/fluentcart-developer/references/database/models/product.md +580 -580
  63. package/dist/skills/fluentcart-developer/references/database/models/relationships.md +427 -427
  64. package/dist/skills/fluentcart-developer/references/database/models/scheduled-action.md +175 -175
  65. package/dist/skills/fluentcart-developer/references/database/models/shipping-class.md +148 -148
  66. package/dist/skills/fluentcart-developer/references/database/models/shipping-method.md +280 -280
  67. package/dist/skills/fluentcart-developer/references/database/models/shipping-zone.md +205 -205
  68. package/dist/skills/fluentcart-developer/references/database/models/subscription-meta.md +173 -173
  69. package/dist/skills/fluentcart-developer/references/database/models/subscription.md +528 -528
  70. package/dist/skills/fluentcart-developer/references/database/models/tax-class.md +195 -195
  71. package/dist/skills/fluentcart-developer/references/database/models/tax-rate.md +225 -225
  72. package/dist/skills/fluentcart-developer/references/database/models/user-meta.md +166 -166
  73. package/dist/skills/fluentcart-developer/references/database/models/user.md +220 -220
  74. package/dist/skills/fluentcart-developer/references/database/models.md +404 -404
  75. package/dist/skills/fluentcart-developer/references/database/query-builder.md +860 -860
  76. package/dist/skills/fluentcart-developer/references/database/readme.md +276 -276
  77. package/dist/skills/fluentcart-developer/references/database/schema.md +1002 -1002
  78. package/dist/skills/fluentcart-developer/references/engineering/adding-custom-pages-to-the-customer-dashboard.md +395 -395
  79. package/dist/skills/fluentcart-developer/references/engineering/index.md +4 -4
  80. package/dist/skills/fluentcart-developer/references/engineering.md +4 -4
  81. package/dist/skills/fluentcart-developer/references/getting-started.md +249 -249
  82. package/dist/skills/fluentcart-developer/references/guides/frontend.md +519 -519
  83. package/dist/skills/fluentcart-developer/references/guides/index.md +107 -107
  84. package/dist/skills/fluentcart-developer/references/guides/integrations.md +600 -600
  85. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/index.md +237 -237
  86. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/labels-and-tracking.md +481 -481
  87. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/live-rates.md +269 -269
  88. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/reference.md +223 -223
  89. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/settings.md +370 -370
  90. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier.md +237 -237
  91. package/dist/skills/fluentcart-developer/references/guides/subscriptions.md +217 -217
  92. package/dist/skills/fluentcart-developer/references/hooks/actions/admin-and-templates.md +1079 -1079
  93. package/dist/skills/fluentcart-developer/references/hooks/actions/cart-and-checkout.md +1795 -1795
  94. package/dist/skills/fluentcart-developer/references/hooks/actions/customers-and-users.md +327 -327
  95. package/dist/skills/fluentcart-developer/references/hooks/actions/licenses.md +829 -829
  96. package/dist/skills/fluentcart-developer/references/hooks/actions/modules.md +81 -81
  97. package/dist/skills/fluentcart-developer/references/hooks/actions/orders.md +757 -757
  98. package/dist/skills/fluentcart-developer/references/hooks/actions/payments-and-integrations.md +1163 -1163
  99. package/dist/skills/fluentcart-developer/references/hooks/actions/pro-modules.md +219 -219
  100. package/dist/skills/fluentcart-developer/references/hooks/actions/products-and-coupons.md +1019 -1019
  101. package/dist/skills/fluentcart-developer/references/hooks/actions/subscriptions.md +1290 -1290
  102. package/dist/skills/fluentcart-developer/references/hooks/actions.md +16 -16
  103. package/dist/skills/fluentcart-developer/references/hooks/deprecated.md +60 -60
  104. package/dist/skills/fluentcart-developer/references/hooks/filters/cart-and-checkout.md +2032 -2032
  105. package/dist/skills/fluentcart-developer/references/hooks/filters/customers-and-subscriptions.md +1746 -1746
  106. package/dist/skills/fluentcart-developer/references/hooks/filters/integrations-and-advanced.md +2439 -2439
  107. package/dist/skills/fluentcart-developer/references/hooks/filters/modules.md +464 -464
  108. package/dist/skills/fluentcart-developer/references/hooks/filters/orders-and-payments.md +2658 -2658
  109. package/dist/skills/fluentcart-developer/references/hooks/filters/pro-modules.md +502 -502
  110. package/dist/skills/fluentcart-developer/references/hooks/filters/products-and-pricing.md +1785 -1785
  111. package/dist/skills/fluentcart-developer/references/hooks/filters/settings-and-configuration.md +2966 -2966
  112. package/dist/skills/fluentcart-developer/references/hooks/filters.md +14 -14
  113. package/dist/skills/fluentcart-developer/references/hooks/index.md +35 -35
  114. package/dist/skills/fluentcart-developer/references/index.md +625 -625
  115. package/dist/skills/fluentcart-developer/references/modules/fee-system.md +427 -427
  116. package/dist/skills/fluentcart-developer/references/modules/ghost-product-selling.md +440 -440
  117. package/dist/skills/fluentcart-developer/references/modules/index.md +484 -484
  118. package/dist/skills/fluentcart-developer/references/modules/licensing.md +342 -342
  119. package/dist/skills/fluentcart-developer/references/modules/order-bump.md +433 -433
  120. package/dist/skills/fluentcart-developer/references/modules/payment-methods.md +129 -129
  121. package/dist/skills/fluentcart-developer/references/modules/refunds.md +170 -170
  122. package/dist/skills/fluentcart-developer/references/modules/shipping.md +846 -846
  123. package/dist/skills/fluentcart-developer/references/modules/storage.md +986 -986
  124. package/dist/skills/fluentcart-developer/references/modules/subscription-vendor-ids.md +186 -186
  125. package/dist/skills/fluentcart-developer/references/modules/subscriptions.md +678 -678
  126. package/dist/skills/fluentcart-developer/references/payment-methods-integration/index.md +164 -164
  127. package/dist/skills/fluentcart-developer/references/payment-methods-integration/paddle-example.md +1648 -1648
  128. package/dist/skills/fluentcart-developer/references/payment-methods-integration/payment/setting/fields.md +353 -353
  129. package/dist/skills/fluentcart-developer/references/payment-methods-integration/quick-implementation.md +1079 -1079
  130. package/dist/skills/fluentcart-developer/references/payment-methods-integration.md +164 -164
  131. package/dist/skills/fluentcart-developer/references/restapi/checkout.md +573 -573
  132. package/dist/skills/fluentcart-developer/references/restapi/coupons.md +958 -958
  133. package/dist/skills/fluentcart-developer/references/restapi/customer-profile.md +1423 -1423
  134. package/dist/skills/fluentcart-developer/references/restapi/customers.md +1103 -1103
  135. package/dist/skills/fluentcart-developer/references/restapi/dashboard.md +1083 -1083
  136. package/dist/skills/fluentcart-developer/references/restapi/data-export.md +132 -132
  137. package/dist/skills/fluentcart-developer/references/restapi/email-notifications.md +846 -846
  138. package/dist/skills/fluentcart-developer/references/restapi/files.md +313 -313
  139. package/dist/skills/fluentcart-developer/references/restapi/index.md +127 -127
  140. package/dist/skills/fluentcart-developer/references/restapi/integrations.md +1000 -1000
  141. package/dist/skills/fluentcart-developer/references/restapi/inventory.md +192 -192
  142. package/dist/skills/fluentcart-developer/references/restapi/labels-and-attributes.md +797 -797
  143. package/dist/skills/fluentcart-developer/references/restapi/licensing.md +1733 -1733
  144. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-available-shipping-methods.md +30 -30
  145. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-checkout-summary.md +28 -28
  146. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-country-info.md +29 -29
  147. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-order-info.md +28 -28
  148. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-shipping-methods-list-view.md +30 -30
  149. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/login.md +66 -66
  150. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/place-order.md +179 -179
  151. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/apply-coupon.md +83 -83
  152. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/cancel-coupon.md +87 -87
  153. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/check-product-eligibility.md +59 -59
  154. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/create-coupon.md +230 -230
  155. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/delete-coupon.md +29 -29
  156. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon-settings.md +20 -20
  157. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon.md +27 -27
  158. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupon-codes.md +20 -20
  159. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupons.md +37 -37
  160. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/re-apply-coupons.md +75 -75
  161. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/store-coupon-settings.md +40 -40
  162. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/update-coupon.md +133 -133
  163. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-address-checkout.md +138 -138
  164. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-profile-address.md +119 -119
  165. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/dashboard-overview.md +22 -22
  166. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/delete-profile-address.md +46 -46
  167. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-order-details.md +30 -30
  168. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-portal-sections.md +29 -29
  169. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-profile-details.md +22 -22
  170. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-transaction-billing-address.md +30 -30
  171. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-upgrade-paths.md +31 -31
  172. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-downloads.md +29 -29
  173. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-orders.md +28 -28
  174. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/make-profile-address-primary.md +55 -55
  175. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/pause-subscription.md +29 -29
  176. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/resume-subscription.md +29 -29
  177. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/save-transaction-billing-address.md +92 -92
  178. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/select-address-for-checkout.md +32 -32
  179. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-address.md +115 -115
  180. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-details.md +69 -69
  181. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/attach-user.md +50 -50
  182. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/bulk-actions.md +65 -65
  183. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-address.md +135 -135
  184. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-customer.md +108 -108
  185. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/delete-address.md +62 -62
  186. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/detach-user.md +28 -28
  187. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/find-customer-order.md +27 -27
  188. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-attachable-users.md +20 -20
  189. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-addresses.md +28 -28
  190. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-orders.md +37 -37
  191. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-stats.md +27 -27
  192. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer.md +32 -32
  193. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/list-customers.md +37 -37
  194. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/recalculate-ltv.md +28 -28
  195. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/set-primary-address.md +72 -72
  196. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-additional-info.md +55 -55
  197. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-address.md +144 -144
  198. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-customer.md +123 -123
  199. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/attach-note-to-order.md +49 -49
  200. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-all-pages.md +21 -21
  201. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-single-page.md +55 -55
  202. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/delete-activity.md +28 -28
  203. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-country-info.md +29 -29
  204. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-dashboard-stats.md +22 -22
  205. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-filter-options.md +31 -31
  206. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-data.md +20 -20
  207. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-settings.md +20 -20
  208. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-print-templates.md +20 -20
  209. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-search-options.md +27 -27
  210. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-widgets.md +28 -28
  211. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/initialize-app.md +20 -20
  212. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-activities.md +33 -33
  213. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-attachments.md +21 -21
  214. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-countries.md +20 -20
  215. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/mark-activity-read.md +53 -53
  216. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/run-data-backfills.md +21 -21
  217. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-settings.md +54 -54
  218. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-tax-settings.md +73 -73
  219. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-print-templates.md +64 -64
  220. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/upload-attachment.md +42 -42
  221. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-customers-batch.md +129 -129
  222. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-licenses-batch.md +133 -133
  223. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-orders-batch.md +129 -129
  224. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-subscriptions-batch.md +129 -129
  225. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-customers-export-schema.md +21 -21
  226. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-licenses-export-schema.md +26 -26
  227. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-orders-export-schema.md +21 -21
  228. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-subscriptions-export-schema.md +21 -21
  229. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/enable-notification.md +57 -57
  230. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-digest-settings.md +22 -22
  231. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-notification.md +30 -30
  232. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-reminders.md +22 -22
  233. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-settings.md +22 -22
  234. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-shortcodes.md +22 -22
  235. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/list-notifications.md +20 -20
  236. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-default-template.md +66 -66
  237. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-notification.md +50 -50
  238. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-digest-settings.md +101 -101
  239. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-reminders.md +162 -162
  240. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-settings.md +99 -99
  241. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-digest-test.md +47 -47
  242. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-manual-reminder.md +51 -51
  243. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/update-notification.md +93 -93
  244. package/dist/skills/fluentcart-developer/references/restapi/operations/files/delete-file.md +31 -31
  245. package/dist/skills/fluentcart-developer/references/restapi/operations/files/get-bucket-list.md +28 -28
  246. package/dist/skills/fluentcart-developer/references/restapi/operations/files/list-files.md +30 -30
  247. package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-editor-file.md +32 -32
  248. package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-file.md +34 -34
  249. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/chained-data-request.md +46 -46
  250. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/change-feed-status.md +51 -51
  251. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/delete-feed.md +27 -27
  252. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-dynamic-options.md +29 -29
  253. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-lists.md +27 -27
  254. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-settings.md +27 -27
  255. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-feeds.md +20 -20
  256. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-settings.md +26 -26
  257. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/install-addon-plugin.md +49 -49
  258. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/list-addons.md +20 -20
  259. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/save-feed-settings.md +52 -52
  260. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/set-global-settings.md +50 -50
  261. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/bulk-update-stock.md +94 -94
  262. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/export-inventory.md +81 -81
  263. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-adjustment-history.md +26 -26
  264. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-inventory-stats.md +21 -21
  265. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/list-inventory.md +33 -33
  266. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/update-stock.md +75 -75
  267. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-attribute-group.md +31 -31
  268. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-label.md +31 -31
  269. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-terms.md +90 -90
  270. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-group.md +28 -28
  271. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-term.md +29 -29
  272. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-group.md +28 -28
  273. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-library.md +20 -20
  274. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-groups.md +32 -32
  275. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-terms.md +33 -33
  276. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-labels.md +20 -20
  277. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-groups.md +51 -51
  278. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-terms.md +56 -56
  279. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-group.md +37 -37
  280. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-term.md +39 -39
  281. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-label-selections.md +32 -32
  282. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-plugin-license.md +41 -41
  283. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-site-admin.md +60 -60
  284. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-plugin-license.md +18 -18
  285. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-admin.md +67 -67
  286. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-customer.md +47 -47
  287. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/delete-license.md +24 -24
  288. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/extend-license-validity.md +47 -47
  289. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-license-details.md +25 -25
  290. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-licenses-admin.md +26 -26
  291. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-activations.md +25 -25
  292. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-details.md +25 -25
  293. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-site.md +30 -30
  294. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-plugin-license-status.md +18 -18
  295. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-product-license-settings.md +24 -24
  296. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-customer-licenses.md +25 -25
  297. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-license-sites.md +33 -33
  298. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-licenses.md +38 -38
  299. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-activate-license.md +54 -54
  300. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-check-license.md +26 -26
  301. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-deactivate-license.md +46 -46
  302. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-download-license-package.md +23 -23
  303. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-get-license-version.md +26 -26
  304. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/regenerate-license-key.md +24 -24
  305. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/save-product-license-settings.md +193 -193
  306. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-activation-limit.md +53 -53
  307. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-status.md +52 -52
  308. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/create-order-bump.md +47 -47
  309. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/delete-order-bump.md +25 -25
  310. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/get-order-bump.md +25 -25
  311. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/list-order-bumps.md +29 -29
  312. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/update-order-bump.md +141 -141
  313. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/accept-dispute.md +47 -47
  314. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/bulk-actions.md +72 -72
  315. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-shipping.md +67 -67
  316. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-tax.md +98 -98
  317. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/change-customer.md +50 -50
  318. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/charge-now.md +29 -29
  319. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-and-change-customer.md +92 -92
  320. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-custom-order-item.md +68 -68
  321. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-order.md +351 -351
  322. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-renewal-now.md +29 -29
  323. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/delete-order.md +28 -28
  324. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/generate-missing-licenses.md +29 -29
  325. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order-transactions.md +27 -27
  326. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order.md +27 -27
  327. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-renewal.md +28 -28
  328. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-shipping-methods.md +28 -28
  329. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-single-transaction.md +28 -28
  330. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-order-currencies.md +22 -22
  331. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-orders.md +42 -42
  332. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-renewals.md +28 -28
  333. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/mark-as-paid.md +61 -61
  334. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/price-order.md +135 -135
  335. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/refund-order.md +72 -72
  336. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/resend-renewal-invoice.md +29 -29
  337. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/skip-renewal.md +48 -48
  338. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-order-statuses.md +28 -28
  339. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-pending-transaction.md +29 -29
  340. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address-id.md +60 -60
  341. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address.md +98 -98
  342. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order.md +172 -172
  343. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-statuses.md +77 -77
  344. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-subscription-details.md +84 -84
  345. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-transaction-status.md +51 -51
  346. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/void-renewal.md +30 -30
  347. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/create-pdf-template.md +42 -42
  348. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/delete-pdf-template.md +26 -26
  349. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/download-pdf-preview.md +44 -44
  350. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-factory-default-templates.md +19 -19
  351. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-status.md +21 -21
  352. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-template.md +26 -26
  353. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-saved-templates.md +21 -21
  354. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-seller-details.md +19 -19
  355. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/list-pdf-templates.md +19 -19
  356. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-pdf-template.md +53 -53
  357. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-seller-details.md +97 -97
  358. package/dist/skills/fluentcart-developer/references/restapi/operations/products/add-product-terms.md +64 -64
  359. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-edit-fetch.md +30 -30
  360. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-insert-products.md +62 -62
  361. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-products.md +59 -59
  362. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-variants.md +83 -83
  363. package/dist/skills/fluentcart-developer/references/restapi/operations/products/change-integration-status.md +64 -64
  364. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-dummy-products.md +45 -45
  365. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-product.md +81 -81
  366. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-variation.md +181 -181
  367. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-downloadable-file.md +27 -27
  368. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product-integration.md +30 -30
  369. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product.md +27 -27
  370. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-taxonomy-term.md +55 -55
  371. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-upgrade-path.md +27 -27
  372. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-variation.md +27 -27
  373. package/dist/skills/fluentcart-developer/references/restapi/operations/products/do-bulk-action.md +56 -56
  374. package/dist/skills/fluentcart-developer/references/restapi/operations/products/duplicate-product.md +56 -56
  375. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-products-by-ids.md +26 -26
  376. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-taxonomy-terms.md +20 -20
  377. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-terms-by-parent.md +60 -60
  378. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-variations-by-ids.md +26 -26
  379. package/dist/skills/fluentcart-developer/references/restapi/operations/products/find-subscription-variants.md +26 -26
  380. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-bundle-info.md +27 -27
  381. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-downloadable-url.md +27 -27
  382. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-max-excerpt-word-count.md +20 -20
  383. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-pricing-widgets.md +27 -27
  384. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-feeds.md +29 -29
  385. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-settings.md +31 -31
  386. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-pricing.md +28 -28
  387. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product.md +28 -28
  388. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-related-products.md +31 -31
  389. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-upgrade-settings.md +27 -27
  390. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-variation-upgrade-paths.md +28 -28
  391. package/dist/skills/fluentcart-developer/references/restapi/operations/products/group-bulk-update-variants.md +103 -103
  392. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-all-variants.md +26 -26
  393. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-product-variations.md +26 -26
  394. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-products.md +34 -34
  395. package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-shipping-class.md +27 -27
  396. package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-tax-class.md +27 -27
  397. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-bundle-info.md +56 -56
  398. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-product-integration.md +62 -62
  399. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-upgrade-path.md +78 -78
  400. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-product-variant-options.md +29 -29
  401. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-products-by-name.md +28 -28
  402. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-variants-by-name.md +28 -28
  403. package/dist/skills/fluentcart-developer/references/restapi/operations/products/set-variation-media.md +74 -74
  404. package/dist/skills/fluentcart-developer/references/restapi/operations/products/suggest-sku.md +28 -28
  405. package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-downloadable-files.md +134 -134
  406. package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-taxonomy-terms.md +61 -61
  407. package/dist/skills/fluentcart-developer/references/restapi/operations/products/toggle-product-tax-exemption.md +56 -56
  408. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-downloadable-file.md +98 -98
  409. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-inventory.md +56 -56
  410. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-long-desc-editor-mode.md +49 -49
  411. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-manage-stock.md +53 -53
  412. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-detail.md +58 -58
  413. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-pricing.md +225 -225
  414. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-shipping-class.md +49 -49
  415. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-tax-class.md +49 -49
  416. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-upgrade-path.md +78 -78
  417. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-option.md +79 -79
  418. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-tax-exemption.md +56 -56
  419. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation-pricing-table.md +49 -49
  420. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation.md +105 -105
  421. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/get-product-views.md +34 -34
  422. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/list-products.md +42 -42
  423. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/search-products.md +30 -30
  424. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/channel-rules.md +24 -24
  425. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/country-heat-map.md +22 -22
  426. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupon-overview.md +37 -37
  427. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupons.md +36 -36
  428. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-insights.md +31 -31
  429. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-overview.md +36 -36
  430. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-repeat.md +35 -35
  431. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segment-customers.md +36 -36
  432. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segments.md +30 -30
  433. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-value.md +34 -34
  434. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/dashboard-stats.md +30 -30
  435. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/failed-orders.md +34 -34
  436. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-new-vs-returning-customer.md +34 -34
  437. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-by-day-and-hour.md +34 -34
  438. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-meta.md +29 -29
  439. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-top-sold-products.md +34 -34
  440. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/future-renewals.md +31 -31
  441. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/generate-retention-snapshots.md +24 -24
  442. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-overview.md +30 -30
  443. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-activities.md +26 -26
  444. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-orders.md +20 -20
  445. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-revenue.md +37 -37
  446. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-at-risk.md +35 -35
  447. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-variations.md +33 -33
  448. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments.md +33 -33
  449. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/item-count-distribution.md +34 -34
  450. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-chart.md +30 -30
  451. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-pie-chart.md +22 -22
  452. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-summary.md +22 -22
  453. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/locations.md +43 -43
  454. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-chart.md +37 -37
  455. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-completion-time.md +34 -34
  456. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-mix.md +34 -34
  457. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-value-distribution.md +34 -34
  458. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-disputes.md +38 -38
  459. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-methods.md +36 -36
  460. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods.md +37 -37
  461. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison-launch.md +33 -33
  462. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison.md +40 -40
  463. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-detail.md +37 -37
  464. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-sales.md +37 -37
  465. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/refunds-overview.md +37 -37
  466. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/retention-snapshots-step.md +45 -45
  467. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sales-growth-chart.md +35 -35
  468. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/save-channel-rules.md +73 -73
  469. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/source-channels.md +37 -37
  470. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sources.md +49 -49
  471. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-cohorts.md +33 -33
  472. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-health.md +30 -30
  473. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-rebuys.md +37 -37
  474. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-retention.md +34 -34
  475. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-variations.md +22 -22
  476. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscriptions-overview.md +37 -37
  477. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/weeks-between-refund.md +34 -34
  478. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/assign-role.md +48 -48
  479. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/delete-role-assignment.md +47 -47
  480. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/get-role.md +25 -25
  481. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-managers.md +18 -18
  482. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-roles.md +18 -18
  483. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/search-users.md +25 -25
  484. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/update-role.md +43 -43
  485. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/create-saved-view.md +106 -106
  486. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/delete-saved-view.md +26 -26
  487. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/list-saved-views.md +25 -25
  488. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/update-saved-view.md +83 -83
  489. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-payment-addon.md +44 -44
  490. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-plugin-addon.md +44 -44
  491. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/change-storage-driver-status.md +56 -56
  492. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/check-paypal-webhook.md +26 -26
  493. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/create-storage-bucket.md +63 -63
  494. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/disconnect-payment-method.md +55 -55
  495. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/exchange-paypal-seller-auth-token.md +62 -62
  496. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-active-storage-drivers.md +20 -20
  497. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-checkout-fields.md +22 -22
  498. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-email-shortcodes.md +20 -20
  499. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-config-snippets.md +26 -26
  500. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-status.md +20 -20
  501. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-module-settings.md +20 -20
  502. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-connection-info.md +26 -26
  503. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-settings.md +26 -26
  504. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-permissions.md +22 -22
  505. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-plugin-addons.md +20 -20
  506. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-storage-driver-settings.md +27 -27
  507. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-store-settings.md +26 -26
  508. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-mcp-adapter.md +21 -21
  509. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-payment-addon.md +60 -60
  510. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-plugin-addon.md +64 -64
  511. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-payment-methods.md +20 -20
  512. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-storage-drivers.md +20 -20
  513. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-storage-buckets.md +67 -67
  514. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reorder-payment-methods.md +55 -55
  515. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reset-storage-driver-settings.md +45 -45
  516. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-checkout-fields.md +133 -133
  517. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-confirmation-settings.md +68 -68
  518. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-module-settings.md +68 -68
  519. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-design.md +67 -67
  520. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-settings.md +58 -58
  521. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-permissions.md +68 -68
  522. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-storage-driver-settings.md +62 -62
  523. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-store-settings.md +239 -239
  524. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/setup-paypal-webhook.md +48 -48
  525. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/toggle-mcp.md +40 -40
  526. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-storage-driver-connection.md +62 -62
  527. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-turnstile-keys.md +55 -55
  528. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-class.md +73 -73
  529. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-method.md +110 -110
  530. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-zone.md +56 -56
  531. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-class.md +29 -29
  532. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-method.md +29 -29
  533. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-zone.md +29 -29
  534. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class-profile.md +30 -30
  535. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class.md +29 -29
  536. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-packages.md +22 -22
  537. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-zone.md +27 -27
  538. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-countries.md +22 -22
  539. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-states.md +28 -28
  540. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-classes.md +31 -31
  541. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-zones.md +31 -31
  542. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/save-shipping-packages.md +112 -112
  543. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-class.md +79 -79
  544. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-method.md +113 -113
  545. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-zone.md +62 -62
  546. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-zone-order.md +52 -52
  547. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-auto-renew.md +30 -30
  548. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-subscription.md +52 -52
  549. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/confirm-subscription-switch.md +70 -70
  550. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/fetch-subscription-remote.md +28 -28
  551. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/generate-early-payment-link.md +29 -29
  552. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-customer-subscription.md +27 -27
  553. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-or-create-plan.md +69 -69
  554. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-setup-intent-attempts.md +30 -30
  555. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-subscription.md +28 -28
  556. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/initiate-early-payment.md +31 -31
  557. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-customer-subscriptions.md +27 -27
  558. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-subscriptions.md +39 -39
  559. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/pause-subscription.md +28 -28
  560. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/reactivate-subscription.md +28 -28
  561. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/resume-subscription.md +28 -28
  562. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/switch-payment-method.md +70 -70
  563. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-payment-method.md +69 -69
  564. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-vendor-ids.md +56 -56
  565. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/verify-vendor-ids.md +56 -56
  566. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-class.md +51 -51
  567. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-rate.md +117 -117
  568. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-product-override.md +27 -27
  569. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-shipping-tax-override.md +27 -27
  570. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-class.md +28 -28
  571. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-rate.md +27 -27
  572. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-id.md +27 -27
  573. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-rates.md +28 -28
  574. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-eu-vat-product-overrides.md +20 -20
  575. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-oss-country-rates.md +20 -20
  576. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-preconfigured-tax-rates.md +20 -20
  577. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-product-overrides.md +27 -27
  578. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-tax-settings.md +20 -20
  579. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-all-tax-rates.md +20 -20
  580. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-classes.md +20 -20
  581. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-records.md +37 -37
  582. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/mark-taxes-as-filed.md +58 -58
  583. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/reset-eu-vat-rates.md +21 -21
  584. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-configured-countries.md +57 -57
  585. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-country-tax-id.md +50 -50
  586. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-eu-vat-cross-border-settings.md +127 -127
  587. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-oss-country-rates.md +100 -100
  588. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-product-override.md +110 -110
  589. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-shipping-tax-override.md +52 -52
  590. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-tax-settings.md +166 -166
  591. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-country-status.md +54 -54
  592. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-tax-rate.md +116 -116
  593. package/dist/skills/fluentcart-developer/references/restapi/order-bumps.md +433 -433
  594. package/dist/skills/fluentcart-developer/references/restapi/orders.md +1212 -1212
  595. package/dist/skills/fluentcart-developer/references/restapi/pdf-templates.md +212 -212
  596. package/dist/skills/fluentcart-developer/references/restapi/products.md +2485 -2485
  597. package/dist/skills/fluentcart-developer/references/restapi/public-shop.md +191 -191
  598. package/dist/skills/fluentcart-developer/references/restapi/reports.md +3773 -3773
  599. package/dist/skills/fluentcart-developer/references/restapi/roles.md +403 -403
  600. package/dist/skills/fluentcart-developer/references/restapi/saved-views.md +136 -136
  601. package/dist/skills/fluentcart-developer/references/restapi/settings.md +1423 -1423
  602. package/dist/skills/fluentcart-developer/references/restapi/shipping.md +905 -905
  603. package/dist/skills/fluentcart-developer/references/restapi/subscriptions.md +1169 -1169
  604. package/dist/skills/fluentcart-developer/references/restapi/tax.md +1551 -1551
  605. package/dist/skills/fluentcart-developer/references/restapi.md +127 -127
  606. package/dist/skills/fluentcart-developer/scripts/cli.js +1 -1
  607. package/dist/version.d.ts +1 -1
  608. package/dist/version.js +1 -1
  609. package/package.json +66 -65
@@ -1,1002 +1,1002 @@
1
- # FluentCart Database Schema
2
-
3
- FluentCart uses custom database tables to store all the e-commerce data. Here are the list of database tables and their schema to understand overall database design and related data attributes of each model.
4
-
5
- ### Core Entity Relationships
6
-
7
- 🔍 Interactive ER Diagram
8
-
9
- Click on the diagram below to zoom in for better readability. The diagram shows the relationships between all FluentCart database tables.
10
-
11
- ### Schema Overview
12
-
13
- The FluentCart database schema is built around these core concepts:
14
-
15
- - **Orders & Transactions**: Complete order lifecycle management with payment tracking
16
- - **Customers & Addresses**: Customer relationship management with multiple address support
17
- - **Products & Variations**: Flexible product catalog with inventory management
18
- - **Subscriptions**: Recurring billing and subscription lifecycle management
19
- - **Coupons & Discounts**: Advanced discount system with conditions and stacking
20
- - **Shipping & Tax**: Configurable shipping zones and tax rate management
21
- - **Activity & Logging**: Comprehensive audit trail for all operations
22
- - **Email Notifications**: Automated email templates and delivery system
23
- - **Background Jobs**: Scheduled actions for automated processing
24
- - **Cart Management**: Shopping cart persistence and checkout flow
25
- - **Attributes & Labels**: Flexible product attributes and object tagging system
26
- - **Webhooks**: External integration logging and delivery tracking
27
- - **Licensing** (Pro): Software license management with activation tracking
28
- - **Promotions** (Pro): Order promotion tracking and statistics
29
-
30
- ### Key Design Principles
31
-
32
- 1. **Currency Precision**: All monetary values stored as BIGINT in cents to avoid floating-point precision issues
33
- 2. **Flexible Configuration**: JSON columns used for extensible configuration data
34
- 3. **Audit Trail**: Comprehensive activity logging for all important operations
35
- 4. **Referential Integrity**: Enforced in model code and application services. The migrations declare no SQL `FOREIGN KEY` constraints, so cascades and orphan cleanup are handled by FluentCart, not the database
36
- 5. **Performance Optimization**: Strategic indexing on frequently queried columns
37
- 6. **Multi-tenancy Ready**: UUID-based public identifiers for external integrations
38
-
39
- ## Database Tables
40
-
41
- ## fct_customers Table
42
-
43
- This table stores customer information and purchase history
44
-
45
- | Column | Type | Comment |
46
- | --- | --- | --- |
47
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
48
- | user_id | BIGINT UNSIGNED NULL | WordPress user ID |
49
- | contact_id | BIGINT UNSIGNED NOT NULL DEFAULT '0' | Contact ID |
50
- | email | VARCHAR(192) NOT NULL DEFAULT '' | Customer email |
51
- | first_name | VARCHAR(192) NOT NULL DEFAULT '' | First name |
52
- | last_name | VARCHAR(192) NOT NULL DEFAULT '' | Last name |
53
- | status | VARCHAR(45) NULL DEFAULT 'active' | active, inactive, archived |
54
- | purchase_value | JSON NULL | Purchase value data |
55
- | purchase_count | BIGINT UNSIGNED NOT NULL DEFAULT '0' | Total number of purchases |
56
- | ltv | BIGINT NOT NULL DEFAULT '0' | Lifetime value in cents |
57
- | first_purchase_date | DATETIME NULL | First purchase date |
58
- | last_purchase_date | DATETIME NULL | Last purchase date |
59
- | aov | DECIMAL(18,2) NULL | Average order value |
60
- | notes | LONGTEXT NOT NULL | Customer notes |
61
- | uuid | VARCHAR(100) NULL DEFAULT '' | Unique identifier |
62
- | country | VARCHAR(45) NULL | Country |
63
- | city | VARCHAR(45) NULL | City |
64
- | state | VARCHAR(45) NULL | State |
65
- | postcode | VARCHAR(45) NULL | Postal code |
66
- | created_at | DATETIME NULL | |
67
- | updated_at | DATETIME NULL | |
68
-
69
- Indexes:
70
-
71
- - email
72
- - user_id
73
-
74
- ## fct_orders Table
75
-
76
- This table stores the basic information of an order
77
-
78
- | Column | Type | Comment |
79
- | --- | --- | --- |
80
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
81
- | status | VARCHAR(20) NOT NULL DEFAULT 'draft' | draft / pending / on-hold / processing / completed / failed / refunded / partial-refund |
82
- | parent_id | BIGINT UNSIGNED NULL | Parent order |
83
- | receipt_number | BIGINT UNSIGNED NULL | |
84
- | invoice_no | VARCHAR(192) NULL DEFAULT '' | |
85
- | fulfillment_type | VARCHAR(20) NULL DEFAULT 'physical' | physical, digital, service, mixed |
86
- | type | VARCHAR(20) NOT NULL DEFAULT 'payment' | payment, renewal, refund |
87
- | mode | ENUM('live', 'test') NOT NULL DEFAULT 'live' | live / test |
88
- | shipping_status | VARCHAR(20) NOT NULL DEFAULT '' | unshipped / shipped / delivered / unshippable |
89
- | customer_id | BIGINT UNSIGNED NULL | |
90
- | payment_method | VARCHAR(100) NOT NULL | |
91
- | payment_status | VARCHAR(20) NOT NULL DEFAULT '' | |
92
- | payment_method_title | VARCHAR(100) NOT NULL | |
93
- | currency | VARCHAR(10) NOT NULL | |
94
- | subtotal | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
95
- | discount_tax | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
96
- | manual_discount_total | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
97
- | coupon_discount_total | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
98
- | shipping_tax | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
99
- | shipping_total | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
100
- | fee_total | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
101
- | tax_total | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
102
- | total_amount | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
103
- | total_paid | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
104
- | total_refund | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
105
- | rate | DECIMAL(24,12) NOT NULL DEFAULT '1.000000000000' | Base to presentment exchange rate, frozen at order time |
106
- | tax_behavior | TINYINT(1) NOT NULL DEFAULT 0 | 0 => no_tax, 1 => exclusive, 2 => inclusive |
107
- | note | TEXT NOT NULL DEFAULT '' | |
108
- | ip_address | TEXT NOT NULL DEFAULT '' | |
109
- | completed_at | DATETIME NULL DEFAULT NULL | |
110
- | refunded_at | DATETIME NULL DEFAULT NULL | |
111
- | uuid | VARCHAR(100) NOT NULL | |
112
- | config | JSON DEFAULT NULL | |
113
- | created_at | DATETIME NULL | |
114
- | updated_at | DATETIME NULL | |
115
-
116
- Indexes:
117
-
118
- - invoice_no (191)
119
- - type
120
- - customer_id
121
- - created_at, completed_at
122
-
123
- ## fct_coupons Table
124
-
125
- This table stores coupon definitions and rules
126
-
127
- | Column | Type | Comment |
128
- | --- | --- | --- |
129
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
130
- | title | VARCHAR(200) NOT NULL | Coupon title |
131
- | code | VARCHAR(50) NOT NULL UNIQUE | Coupon code (unique) |
132
- | priority | INT DEFAULT NULL | Coupon priority |
133
- | type | VARCHAR(20) NOT NULL | Coupon type |
134
- | conditions | JSON NULL | Coupon conditions |
135
- | amount | double NOT NULL | Discount amount |
136
- | use_count | INT DEFAULT 0 | Usage count |
137
- | status | VARCHAR(20) NOT NULL | Coupon status |
138
- | notes | LONGTEXT NOT NULL | Coupon notes |
139
- | stackable | VARCHAR(3) NOT NULL DEFAULT 'no' | Stackable flag (yes/no) |
140
- | show_on_checkout | VARCHAR(3) NOT NULL DEFAULT 'yes' | Show on checkout (yes/no) |
141
- | start_date | TIMESTAMP NULL | Start date |
142
- | end_date | TIMESTAMP NULL | End date |
143
- | created_at | DATETIME NULL | |
144
- | updated_at | DATETIME NULL | |
145
-
146
- Indexes:
147
-
148
- - code
149
- - status
150
-
151
- ## fct_order_items Table
152
-
153
- This table stores individual items within orders
154
-
155
- | Column | Type | Comment |
156
- | --- | --- | --- |
157
- | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
158
- | order_id | BIGINT UNSIGNED NOT NULL DEFAULT '0' | Reference to order |
159
- | post_id | BIGINT UNSIGNED NOT NULL DEFAULT '0' | WordPress post ID (product) |
160
- | fulfillment_type | VARCHAR(20) NOT NULL DEFAULT 'physical' | physical, digital, service |
161
- | payment_type | VARCHAR(20) NOT NULL DEFAULT 'onetime' | onetime, subscription, signup_fee |
162
- | post_title | TEXT NOT NULL | Product title |
163
- | title | TEXT NOT NULL | Item title (variation) |
164
- | object_id | BIGINT UNSIGNED NULL DEFAULT NULL | Variation ID |
165
- | cart_index | BIGINT UNSIGNED NOT NULL DEFAULT '0' | Position in cart |
166
- | quantity | INT NOT NULL DEFAULT '1' | Item quantity |
167
- | unit_price | BIGINT NOT NULL DEFAULT '0' | Price per unit in cents |
168
- | cost | BIGINT NOT NULL DEFAULT '0' | Cost in cents |
169
- | subtotal | BIGINT NOT NULL DEFAULT '0' | Line subtotal |
170
- | tax_amount | BIGINT NOT NULL DEFAULT '0' | Tax amount for this line |
171
- | shipping_charge | BIGINT NOT NULL DEFAULT '0' | Shipping charge |
172
- | discount_total | BIGINT NOT NULL DEFAULT '0' | Discount amount |
173
- | line_total | BIGINT NOT NULL DEFAULT '0' | Total line amount |
174
- | refund_total | BIGINT NOT NULL DEFAULT '0' | Refunded amount |
175
- | rate | BIGINT NOT NULL DEFAULT '1' | Exchange rate |
176
- | other_info | JSON NULL | Additional item data |
177
- | line_meta | JSON NULL | Line-specific metadata |
178
- | fulfilled_quantity | INT NOT NULL DEFAULT '0' | Quantity fulfilled |
179
- | referrer | TEXT NULL | Referral information |
180
- | created_at | DATETIME NULL | |
181
- | updated_at | DATETIME NULL | |
182
-
183
- Indexes:
184
-
185
- - order_id, object_id
186
- - post_id
187
-
188
- ## fct_subscriptions Table
189
-
190
- This table stores subscription information and billing cycles
191
-
192
- | Column | Type | Comment |
193
- | --- | --- | --- |
194
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
195
- | uuid | VARCHAR(100) NOT NULL | Unique identifier |
196
- | customer_id | BIGINT(20) UNSIGNED NOT NULL | Reference to customer |
197
- | parent_order_id | BIGINT(20) UNSIGNED NOT NULL | Initial order ID |
198
- | product_id | BIGINT(20) UNSIGNED NOT NULL | WordPress post ID |
199
- | item_name | TEXT NOT NULL | Subscription item name |
200
- | quantity | INT NOT NULL DEFAULT '1' | Subscription quantity |
201
- | variation_id | BIGINT(20) UNSIGNED NOT NULL | Product variation ID |
202
- | billing_interval | VARCHAR(45) NULL | Billing interval (day, week, month, year) |
203
- | signup_fee | BIGINT UNSIGNED NOT NULL DEFAULT 0 | Signup fee in cents |
204
- | initial_tax_total | BIGINT UNSIGNED NOT NULL DEFAULT 0 | Initial tax in cents |
205
- | recurring_amount | BIGINT UNSIGNED NOT NULL DEFAULT 0 | Recurring amount in cents |
206
- | recurring_tax_total | BIGINT UNSIGNED NOT NULL DEFAULT 0 | Recurring tax in cents |
207
- | recurring_total | BIGINT UNSIGNED NOT NULL DEFAULT 0 | Total recurring in cents |
208
- | bill_times | BIGINT(20) UNSIGNED NOT NULL DEFAULT 0 | Total billing cycles |
209
- | bill_count | INT UNSIGNED NOT NULL DEFAULT 0 | Current billing count |
210
- | expire_at | DATETIME NULL | Expiration date |
211
- | trial_ends_at | DATETIME NULL | Trial end date |
212
- | canceled_at | DATETIME NULL | Cancellation date |
213
- | restored_at | DATETIME NULL | Restoration date |
214
- | collection_method | ENUM('automatic', 'manual', 'system') NOT NULL DEFAULT 'automatic' | Payment collection method |
215
- | next_billing_date | DATETIME NULL | Next billing date |
216
- | trial_days | INT(10) UNSIGNED NOT NULL DEFAULT 0 | Trial period in days |
217
- | vendor_customer_id | VARCHAR(45) NULL | Payment gateway customer ID |
218
- | vendor_plan_id | VARCHAR(45) NULL | Payment gateway plan ID |
219
- | vendor_subscription_id | VARCHAR(45) NULL | Payment gateway subscription ID |
220
- | status | VARCHAR(45) NULL | active, canceled, expired, pending, trialing |
221
- | original_plan | LONGTEXT NULL | Original plan data |
222
- | vendor_response | LONGTEXT NULL | Payment gateway response |
223
- | current_payment_method | VARCHAR(45) NULL | Current payment method |
224
- | config | JSON DEFAULT NULL | Subscription configuration |
225
- | created_at | DATETIME NULL | |
226
- | updated_at | DATETIME NULL | |
227
-
228
- Indexes:
229
-
230
- - parent_order_id
231
-
232
- ## fct_order_transactions Table
233
-
234
- This table stores payment transactions for orders
235
-
236
- | Column | Type | Comment |
237
- | --- | --- | --- |
238
- | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
239
- | order_id | BIGINT UNSIGNED NOT NULL DEFAULT '0' | Reference to order |
240
- | order_type | VARCHAR(100) NOT NULL DEFAULT '' | |
241
- | transaction_type | VARCHAR(192) DEFAULT 'charge' | charge, refund, etc. |
242
- | subscription_id | INT(11) NULL | Reference to subscription |
243
- | card_last_4 | VARCHAR(4) NULL | Last 4 digits of card |
244
- | card_brand | VARCHAR(100) | Card brand |
245
- | vendor_charge_id | VARCHAR(192) NOT NULL DEFAULT '' | Payment gateway transaction ID |
246
- | payment_method | VARCHAR(100) NOT NULL DEFAULT '' | |
247
- | payment_mode | VARCHAR(100) NOT NULL DEFAULT '' | live, test |
248
- | payment_method_type | VARCHAR(100) NOT NULL DEFAULT '' | card, bank, etc. |
249
- | status | VARCHAR(20) NOT NULL DEFAULT '' | Transaction status |
250
- | currency | VARCHAR(10) NOT NULL DEFAULT '' | Transaction currency |
251
- | total | BIGINT NOT NULL DEFAULT '0' | Transaction amount in cents |
252
- | rate | DECIMAL(24,12) | Exchange rate |
253
- | uuid | VARCHAR(100) NULL DEFAULT '' | |
254
- | meta | JSON DEFAULT NULL | Transaction metadata |
255
- | created_at | DATETIME NULL | |
256
- | updated_at | DATETIME NULL | |
257
-
258
- Indexes:
259
-
260
- - vendor_charge_id (64)
261
- - payment_method
262
- - status
263
- - order_id
264
-
265
- ## fct_order_addresses Table
266
-
267
- This table stores order shipping and billing addresses
268
-
269
- | Column | Type | Comment |
270
- | --- | --- | --- |
271
- | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
272
- | order_id | BIGINT UNSIGNED NOT NULL | Reference to order |
273
- | type | VARCHAR(20) NOT NULL DEFAULT 'billing' | billing, shipping |
274
- | name | VARCHAR(192) NULL | Address name |
275
- | address_1 | VARCHAR(192) NULL | Address line 1 |
276
- | address_2 | VARCHAR(192) NULL | Address line 2 |
277
- | city | VARCHAR(192) NULL | City |
278
- | state | VARCHAR(192) NULL | State |
279
- | postcode | VARCHAR(50) NULL | Postal code |
280
- | country | VARCHAR(100) NULL | Country |
281
- | meta | JSON NULL | VAT number, legal registration ID and other extras |
282
- | created_at | DATETIME NULL | |
283
- | updated_at | DATETIME NULL | |
284
-
285
- Indexes:
286
-
287
- - (order_id, type)
288
-
289
- ## fct_order_operations Table
290
-
291
- This table stores order operation logs and analytics
292
-
293
- | Column | Type | Comment |
294
- | --- | --- | --- |
295
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
296
- | order_id | BIGINT(20) UNSIGNED NOT NULL | Reference to order |
297
- | created_via | VARCHAR(45) NULL | How the order was created |
298
- | emails_sent | TINYINT(1) NULL DEFAULT 0 | Emails sent flag |
299
- | sales_recorded | TINYINT(1) NULL DEFAULT 0 | Sales recorded flag |
300
- | utm_campaign | VARCHAR(192) NULL DEFAULT '' | UTM campaign tracking |
301
- | utm_term | VARCHAR(192) NULL DEFAULT '' | UTM term tracking |
302
- | utm_source | VARCHAR(192) NULL DEFAULT '' | UTM source tracking |
303
- | utm_medium | VARCHAR(192) NULL DEFAULT '' | UTM medium tracking |
304
- | utm_content | VARCHAR(192) NULL DEFAULT '' | UTM content tracking |
305
- | utm_id | VARCHAR(192) NULL DEFAULT '' | UTM ID tracking |
306
- | cart_hash | VARCHAR(192) NULL DEFAULT '' | Cart hash identifier |
307
- | refer_url | VARCHAR(192) NULL DEFAULT '' | Referral URL |
308
- | meta | JSON DEFAULT NULL | Additional operation metadata |
309
- | created_at | DATETIME NULL | |
310
- | updated_at | DATETIME NULL | |
311
-
312
- Indexes:
313
-
314
- - order_id
315
-
316
- ## fct_order_download_permissions Table
317
-
318
- This table stores download permissions for orders
319
-
320
- | Column | Type | Comment |
321
- | --- | --- | --- |
322
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
323
- | order_id | BIGINT(20) UNSIGNED NOT NULL | Reference to order |
324
- | variation_id | BIGINT(20) UNSIGNED NOT NULL | Reference to product variation |
325
- | download_id | BIGINT(20) UNSIGNED NOT NULL | Reference to download |
326
- | download_count | INT(11) NULL | Number of downloads |
327
- | download_limit | INT(11) NULL | Download limit |
328
- | access_expires | DATETIME NULL | Access expiration date |
329
- | customer_id | BIGINT(20) UNSIGNED NOT NULL | Reference to customer |
330
- | created_at | DATETIME NULL | |
331
- | updated_at | DATETIME NULL | |
332
-
333
- Indexes:
334
-
335
- - order_id
336
- - download_id
337
- - variation_id
338
-
339
- ## fct_product_variations Table
340
-
341
- This table stores product variations with pricing and inventory
342
-
343
- | Column | Type | Comment |
344
- | --- | --- | --- |
345
- | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
346
- | post_id | BIGINT(20) UNSIGNED NOT NULL | WordPress post ID |
347
- | media_id | BIGINT(20) UNSIGNED NULL | Media attachment ID |
348
- | serial_index | INT(5) NULL | Variation order |
349
- | sold_individually | TINYINT(1) UNSIGNED NULL DEFAULT 0 | Sold individually flag |
350
- | variation_title | VARCHAR(192) NOT NULL | Variation title |
351
- | variation_identifier | VARCHAR(100) NULL | Legacy identifier |
352
- | sku | VARCHAR(30) NULL | Stock keeping unit, unique across variations |
353
- | manage_stock | TINYINT(1) NULL DEFAULT 0 | Stock management enabled |
354
- | payment_type | VARCHAR(50) NULL | onetime, subscription |
355
- | stock_status | VARCHAR(30) NULL DEFAULT 'out-of-stock' | in-stock, out-of-stock, backorder |
356
- | backorders | TINYINT(1) UNSIGNED NULL DEFAULT 0 | Backorders allowed |
357
- | total_stock | INT(11) NULL DEFAULT 0 | Total stock quantity |
358
- | on_hold | INT(11) NULL DEFAULT 0 | Stock on hold |
359
- | committed | INT(11) NULL DEFAULT 0 | Committed stock |
360
- | available | INT(11) NULL DEFAULT 0 | Available stock |
361
- | fulfillment_type | VARCHAR(100) NULL DEFAULT 'physical' | physical, digital, service, mixed |
362
- | item_status | VARCHAR(30) NULL DEFAULT 'active' | active, inactive |
363
- | manage_cost | VARCHAR(30) NULL DEFAULT 'false' | Cost management enabled |
364
- | item_price | double DEFAULT 0 NOT NULL | Variation price |
365
- | item_cost | double DEFAULT 0 NOT NULL | Variation cost |
366
- | compare_price | double DEFAULT 0 NULL | Compare at price |
367
- | shipping_class | BIGINT(20) NULL | Shipping class ID |
368
- | other_info | longtext NULL | Additional variation data |
369
- | downloadable | VARCHAR(30) NULL DEFAULT 'false' | Downloadable flag |
370
- | created_at | DATETIME NULL | |
371
- | updated_at | DATETIME NULL | |
372
-
373
- Indexes:
374
-
375
- - post_id
376
- - stock_status
377
-
378
- ## fct_product_details Table
379
-
380
- This table stores product configuration and settings
381
-
382
- | Column | Type | Comment |
383
- | --- | --- | --- |
384
- | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
385
- | post_id | BIGINT(20) UNSIGNED NOT NULL | WordPress post ID |
386
- | fulfillment_type | VARCHAR(100) NULL DEFAULT 'physical' | physical, digital, service, mixed |
387
- | min_price | double DEFAULT 0 NOT NULL | Minimum price |
388
- | max_price | double DEFAULT 0 NOT NULL | Maximum price |
389
- | default_variation_id | BIGINT(20) UNSIGNED NULL | Default variation ID |
390
- | default_media | JSON NULL | Default media data |
391
- | manage_stock | TINYINT(1) NULL DEFAULT 0 | Stock management enabled |
392
- | stock_availability | VARCHAR(100) NULL DEFAULT 'in-stock' | in-stock, out-of-stock, backorder |
393
- | variation_type | VARCHAR(30) NULL DEFAULT 'simple' | simple, simple_variation, advance_variation |
394
- | manage_downloadable | TINYINT(1) NULL DEFAULT 0 | Downloadable management enabled |
395
- | other_info | JSON NULL | Additional product data |
396
- | created_at | DATETIME NULL | |
397
- | updated_at | DATETIME NULL | |
398
-
399
- Indexes:
400
-
401
- - post_id
402
- - stock_availability
403
-
404
- ## fct_product_meta Table
405
-
406
- This table stores product metadata
407
-
408
- | Column | Type | Comment |
409
- | --- | --- | --- |
410
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
411
- | object_id | BIGINT UNSIGNED NOT NULL | Reference to product |
412
- | object_type | VARCHAR(192) NULL | Object type |
413
- | meta_key | VARCHAR(192) NOT NULL | Meta key |
414
- | meta_value | LONGTEXT NULL DEFAULT NULL | Meta value |
415
- | created_at | DATETIME NULL | |
416
- | updated_at | DATETIME NULL | |
417
-
418
- Indexes:
419
-
420
- - meta_key
421
-
422
- ## fct_applied_coupons Table
423
-
424
- This table stores applied coupons to orders
425
-
426
- | Column | Type | Comment |
427
- | --- | --- | --- |
428
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
429
- | order_id | BIGINT UNSIGNED NOT NULL | Reference to order |
430
- | coupon_id | BIGINT UNSIGNED NULL | Reference to coupon |
431
- | code | VARCHAR(100) NOT NULL | Coupon code |
432
- | amount | double NOT NULL | Discount amount |
433
- | created_at | DATETIME NULL | |
434
- | updated_at | DATETIME NULL | |
435
-
436
- Indexes:
437
-
438
- - code
439
- - (coupon_id, order_id) — per-customer usage counting joins through these
440
-
441
- ## fct_customer_addresses Table
442
-
443
- This table stores customer shipping and billing addresses
444
-
445
- | Column | Type | Comment |
446
- | --- | --- | --- |
447
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
448
- | customer_id | BIGINT UNSIGNED NOT NULL | Reference to customer |
449
- | is_primary | TINYINT(1) NOT NULL DEFAULT 0 | Primary address flag |
450
- | type | VARCHAR(20) NOT NULL DEFAULT 'billing' | billing, shipping |
451
- | status | VARCHAR(20) NOT NULL DEFAULT 'active' | active, inactive |
452
- | label | VARCHAR(50) NOT NULL DEFAULT '' | Address label |
453
- | name | VARCHAR(192) NULL | Address name |
454
- | address_1 | VARCHAR(192) NULL | Address line 1 |
455
- | address_2 | VARCHAR(192) NULL | Address line 2 |
456
- | city | VARCHAR(192) NULL | City |
457
- | state | VARCHAR(192) NULL | State |
458
- | phone | VARCHAR(192) NULL | Phone number |
459
- | email | VARCHAR(192) NULL | Email address |
460
- | postcode | VARCHAR(32) NULL | Postal code |
461
- | country | VARCHAR(100) NULL | Country |
462
- | meta | JSON NULL | VAT number, legal registration ID and other extras |
463
- | created_at | DATETIME NULL | |
464
- | updated_at | DATETIME NULL | |
465
-
466
- Indexes:
467
-
468
- - customer_id, is_primary
469
- - type
470
- - status
471
-
472
- ## fct_customer_meta Table
473
-
474
- This table stores customer metadata
475
-
476
- | Column | Type | Comment |
477
- | --- | --- | --- |
478
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
479
- | customer_id | BIGINT UNSIGNED NULL DEFAULT NULL | Reference to customer |
480
- | meta_key | VARCHAR(192) NULL DEFAULT NULL | Meta key |
481
- | meta_value | LONGTEXT NULL DEFAULT NULL | Meta value |
482
- | created_at | DATETIME NULL | |
483
- | updated_at | DATETIME NULL | |
484
-
485
- Indexes:
486
-
487
- - meta_key
488
- - customer_id
489
-
490
- ## fct_carts Table
491
-
492
- This table stores shopping cart data
493
-
494
- | Column | Type | Comment |
495
- | --- | --- | --- |
496
- | customer_id | BIGINT(20) UNSIGNED NULL | Reference to customer |
497
- | user_id | BIGINT(20) UNSIGNED NULL | Reference to WordPress user |
498
- | order_id | BIGINT(20) UNSIGNED NULL | Reference to order |
499
- | cart_hash | VARCHAR(192) NOT NULL UNIQUE | Unique cart identifier |
500
- | checkout_data | LONGTEXT NULL | Checkout form data |
501
- | cart_data | LONGTEXT NULL | Cart contents |
502
- | utm_data | LONGTEXT NULL | UTM tracking data |
503
- | coupons | LONGTEXT NULL | Applied coupons |
504
- | first_name | VARCHAR(192) NULL | Customer first name |
505
- | last_name | VARCHAR(192) NULL | Customer last name |
506
- | email | VARCHAR(192) NULL | Customer email |
507
- | stage | VARCHAR(30) NULL DEFAULT 'draft' | draft, pending, in-complete, completed |
508
- | cart_group | VARCHAR(30) NULL DEFAULT 'global' | Cart group |
509
- | user_agent | VARCHAR(192) NULL | User agent string |
510
- | ip_address | VARCHAR(50) NULL | IP address |
511
- | completed_at | TIMESTAMP NULL | Completion timestamp |
512
- | created_at | DATETIME NULL | |
513
- | updated_at | DATETIME NULL | |
514
- | deleted_at | TIMESTAMP NULL | Soft delete timestamp |
515
-
516
- ## fct_product_downloads Table
517
-
518
- This table stores downloadable product files
519
-
520
- | Column | Type | Comment |
521
- | --- | --- | --- |
522
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
523
- | post_id | BIGINT(20) UNSIGNED NOT NULL | WordPress post ID |
524
- | product_variation_id | longtext NOT NULL | Product variation ID |
525
- | download_identifier | VARCHAR(100) NOT NULL UNIQUE | Unique download identifier |
526
- | title | VARCHAR(192) NULL | Download title |
527
- | type | VARCHAR(100) NULL | Download type |
528
- | driver | VARCHAR(100) NULL DEFAULT 'local' | Storage driver |
529
- | file_name | VARCHAR(192) NULL | File name |
530
- | file_path | TEXT NULL | File path |
531
- | file_url | TEXT NULL | File URL |
532
- | file_size | TEXT NULL | File size |
533
- | settings | TEXT NULL | Download settings |
534
- | serial | INT NULL | Serial number |
535
- | created_at | DATETIME NULL | |
536
- | updated_at | DATETIME NULL | |
537
-
538
- ## fct_subscription_meta Table
539
-
540
- This table stores subscription metadata
541
-
542
- | Column | Type | Comment |
543
- | --- | --- | --- |
544
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
545
- | subscription_id | BIGINT UNSIGNED NULL DEFAULT NULL | Reference to subscription |
546
- | meta_key | VARCHAR(192) NULL DEFAULT NULL | Meta key |
547
- | meta_value | LONGTEXT NULL DEFAULT NULL | Meta value |
548
- | created_at | DATETIME NULL | |
549
- | updated_at | DATETIME NULL | |
550
-
551
- Indexes:
552
-
553
- - subscription_id
554
- - meta_key
555
-
556
- ## fct_activity Table
557
-
558
- This table stores system activity and audit logs
559
-
560
- | Column | Type | Comment |
561
- | --- | --- | --- |
562
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
563
- | status | VARCHAR(20) NOT NULL DEFAULT 'info' | success / warning / failed / info |
564
- | log_type | VARCHAR(20) NOT NULL DEFAULT 'activity' | activity, api |
565
- | module_type | VARCHAR(100) NOT NULL DEFAULT 'order' | Full model path |
566
- | module_id | BIGINT NULL | Related record ID |
567
- | module_name | VARCHAR(192) NOT NULL DEFAULT 'order' | order, product, user, coupon, subscription, payment, refund, shipment, activity |
568
- | user_id | BIGINT UNSIGNED NULL | User who performed action |
569
- | title | VARCHAR(192) NULL | Activity title |
570
- | content | LONGTEXT NULL | Activity description |
571
- | read_status | VARCHAR(20) NOT NULL DEFAULT 'unread' | read, unread |
572
- | created_by | VARCHAR(100) NOT NULL DEFAULT 'FCT-BOT' | Creator identifier |
573
- | created_at | DATETIME NULL | |
574
- | updated_at | DATETIME NULL | |
575
-
576
- Indexes:
577
-
578
- - module_id
579
-
580
- ## fct_shipping_zones Table
581
-
582
- This table stores shipping zones configuration
583
-
584
- | Column | Type | Comment |
585
- | --- | --- | --- |
586
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
587
- | shipping_class_id | BIGINT UNSIGNED NULL | Scopes the zone to one shipping class; NULL means it applies to class-less items |
588
- | name | VARCHAR(192) NOT NULL | Zone name |
589
- | region | VARCHAR(192) NOT NULL | A country code, `all` (Whole World) or `selection` |
590
- | meta | JSON NULL | For `selection` zones: `countries` and `selection_type` (`included` / `excluded`) |
591
- | order | INT UNSIGNED NOT NULL DEFAULT 0 | Display order |
592
- | created_at | DATETIME NULL | |
593
- | updated_at | DATETIME NULL | |
594
-
595
- Indexes:
596
-
597
- - order
598
- - shipping_class_id
599
-
600
- ## fct_shipping_methods Table
601
-
602
- This table stores shipping methods within zones
603
-
604
- | Column | Type | Comment |
605
- | --- | --- | --- |
606
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
607
- | zone_id | BIGINT UNSIGNED NOT NULL | Reference to shipping zone |
608
- | title | VARCHAR(192) NOT NULL | Method title |
609
- | type | VARCHAR(50) NOT NULL | Method type |
610
- | settings | LONGTEXT NULL | Method settings: `configure_rate`, `class_aggregation`, `weight_tiers` |
611
- | is_enabled | TINYINT(1) NOT NULL DEFAULT 1 | Enabled flag |
612
- | states | JSON NULL | Restricts the method to these states within the zone |
613
- | amount | DECIMAL(10,2) NULL DEFAULT 0.00 | Base rate in base-currency major units, not cents (a percentage when `configure_rate` is `per_price`) |
614
- | order | INT UNSIGNED NOT NULL DEFAULT 0 | Display order |
615
- | meta | JSON NULL | |
616
- | created_at | DATETIME NULL | |
617
- | updated_at | DATETIME NULL | |
618
-
619
- Indexes:
620
-
621
- - zone_id
622
- - order
623
-
624
- ## fct_shipping_classes Table
625
-
626
- This table stores shipping classes
627
-
628
- | Column | Type | Comment |
629
- | --- | --- | --- |
630
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
631
- | name | VARCHAR(192) NOT NULL | Class name |
632
- | description | VARCHAR(500) NULL | Class description |
633
- | cost | DECIMAL(10,2) NOT NULL DEFAULT 0.00 | Surcharge in base-currency major units, not cents |
634
- | per_item | TINYINT(1) NOT NULL DEFAULT 0 | Per item flag |
635
- | type | VARCHAR(20) NOT NULL DEFAULT 'fixed' | Class type |
636
- | created_at | DATETIME NULL | |
637
- | updated_at | DATETIME NULL | |
638
-
639
- Indexes:
640
-
641
- - name
642
-
643
- ## fct_tax_classes Table
644
-
645
- This table stores tax class definitions
646
-
647
- | Column | Type | Comment |
648
- | --- | --- | --- |
649
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
650
- | title | VARCHAR(192) NULL | Tax class title |
651
- | slug | VARCHAR(100) NULL | Tax class slug |
652
- | description | LONGTEXT NULL | Tax class description |
653
- | meta | JSON DEFAULT NULL | Tax class metadata |
654
- | created_at | DATETIME NULL | |
655
- | updated_at | DATETIME NULL | |
656
-
657
- ## fct_tax_rates Table
658
-
659
- This table stores tax rate configurations
660
-
661
- | Column | Type | Comment |
662
- | --- | --- | --- |
663
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
664
- | class_id | BIGINT UNSIGNED NOT NULL | Tax class ID |
665
- | country | VARCHAR(45) NULL | Country code |
666
- | state | VARCHAR(45) NULL | State code |
667
- | postcode | TEXT NULL | Postal code (supports ranges) |
668
- | city | VARCHAR(45) NULL | City |
669
- | rate | VARCHAR(45) NULL | Tax rate |
670
- | name | VARCHAR(45) NULL | Tax name |
671
- | group | VARCHAR(45) NULL | Tax group |
672
- | priority | INT UNSIGNED NULL DEFAULT 1 | Priority |
673
- | is_compound | TINYINT UNSIGNED NULL DEFAULT 0 | Compound tax flag |
674
- | for_shipping | DECIMAL(10,2) NULL DEFAULT NULL | Shipping-tax rate override percentage (NULL = inherit base rate; 0 = no shipping tax) |
675
- | for_order | TINYINT UNSIGNED NULL DEFAULT 0 | Apply to order |
676
-
677
- Indexes:
678
-
679
- - class_id
680
- - priority
681
-
682
- ## fct_meta Table
683
-
684
- This table stores generic metadata for various objects
685
-
686
- | Column | Type | Comment |
687
- | --- | --- | --- |
688
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
689
- | object_type | VARCHAR(50) NOT NULL | Object type |
690
- | object_id | BIGINT NULL | Object ID |
691
- | meta_key | VARCHAR(192) NOT NULL | Meta key |
692
- | meta_value | LONGTEXT NULL | Meta value |
693
- | created_at | DATETIME NULL | |
694
- | updated_at | DATETIME NULL | |
695
-
696
- Indexes:
697
-
698
- - object_type
699
- - object_id
700
-
701
- ## fct_label Table
702
-
703
- This table stores labels for tagging objects
704
-
705
- | Column | Type | Comment |
706
- | --- | --- | --- |
707
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
708
- | value | VARCHAR(192) NOT NULL UNIQUE | Label value (unique) |
709
- | created_at | DATETIME NULL | |
710
- | updated_at | DATETIME NULL | |
711
-
712
- ## fct_order_meta Table
713
-
714
- This table stores order metadata
715
-
716
- | Column | Type | Comment |
717
- | --- | --- | --- |
718
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
719
- | order_id | BIGINT(20) NULL | Reference to order |
720
- | meta_key | VARCHAR(192) NOT NULL | Meta key |
721
- | meta_value | LONGTEXT NULL | Meta value |
722
- | created_at | DATETIME NULL | |
723
- | updated_at | DATETIME NULL | |
724
-
725
- Indexes:
726
-
727
- - order_id
728
-
729
- ## fct_order_tax_rate Table
730
-
731
- This table stores order tax rate information
732
-
733
- | Column | Type | Comment |
734
- | --- | --- | --- |
735
- | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
736
- | order_id | BIGINT(20) UNSIGNED NOT NULL | Reference to order |
737
- | tax_rate_id | BIGINT(20) NOT NULL | Reference to tax rate (signed; virtual EU VAT rates use negative IDs) |
738
- | shipping_tax | BIGINT NULL | Shipping tax amount |
739
- | order_tax | BIGINT NULL | Order tax amount |
740
- | total_tax | BIGINT NULL | Total tax amount |
741
- | meta | JSON DEFAULT NULL | Tax meta data |
742
- | filed_at | DATETIME NULL | Filed at |
743
- | created_at | DATETIME NULL | |
744
- | updated_at | DATETIME NULL | |
745
-
746
- Indexes:
747
-
748
- - (order_id, tax_rate_id) (unique)
749
-
750
- ## fct_webhook_logger Table
751
-
752
- This table stores webhook delivery logs and status
753
-
754
- | Column | Type | Comment |
755
- | --- | --- | --- |
756
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
757
- | source | VARCHAR(20) NOT NULL | Webhook source |
758
- | event_type | VARCHAR(100) NOT NULL | Event type |
759
- | payload | LONGTEXT NULL | Webhook payload |
760
- | status | VARCHAR(20) NOT NULL DEFAULT 'pending' | pending, sent, failed |
761
- | created_at | DATETIME NULL | |
762
- | updated_at | DATETIME NULL | |
763
-
764
- ## fct_scheduled_actions Table
765
-
766
- This table stores background job scheduling and execution
767
-
768
- | Column | Type | Comment |
769
- | --- | --- | --- |
770
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
771
- | scheduled_at | DATETIME NULL | When to run the action |
772
- | action | VARCHAR(192) NULL | Action to perform |
773
- | status | VARCHAR(20) NULL | pending, processing, completed, failed |
774
- | group | VARCHAR(100) NULL | order, subscription |
775
- | object_id | BIGINT UNSIGNED NULL DEFAULT NULL | Related object ID |
776
- | object_type | VARCHAR(100) NULL DEFAULT NULL | Object type |
777
- | completed_at | TIMESTAMP NULL | When action was completed |
778
- | retry_count | INT UNSIGNED DEFAULT 0 | Number of retries |
779
- | data | JSON NULL | Action data |
780
- | created_at | DATETIME NULL | |
781
- | updated_at | DATETIME NULL | |
782
- | response_note | LONGTEXT NULL | Response or error message |
783
-
784
- Indexes:
785
-
786
- - scheduled_at
787
- - status
788
-
789
- ## fct_atts_groups Table
790
-
791
- This table stores attribute groups for product attributes
792
-
793
- | Column | Type | Comment |
794
- | --- | --- | --- |
795
- | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
796
- | title | VARCHAR(192) NOT NULL | Group title |
797
- | slug | VARCHAR(192) NOT NULL UNIQUE | Group slug |
798
- | description | LONGTEXT NULL | Group description |
799
- | settings | LONGTEXT NULL | Group settings |
800
- | serial | INT(11) UNSIGNED NOT NULL DEFAULT 0 | Manual drag-order of groups in the admin |
801
- | is_system | TINYINT(1) NOT NULL DEFAULT 0 | Marks a group FluentCart created itself |
802
- | created_at | DATETIME NULL | |
803
- | updated_at | DATETIME NULL | |
804
-
805
- ## fct_atts_terms Table
806
-
807
- This table stores attribute terms within groups
808
-
809
- | Column | Type | Comment |
810
- | --- | --- | --- |
811
- | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
812
- | group_id | BIGINT(20) UNSIGNED | Reference to attribute group |
813
- | serial | INT(11) UNSIGNED | Term order |
814
- | title | VARCHAR(192) NOT NULL | Term title |
815
- | slug | VARCHAR(192) NOT NULL | Term slug |
816
- | description | LONGTEXT NULL | Term description |
817
- | settings | LONGTEXT NULL | Term settings |
818
- | created_at | DATETIME NULL | |
819
- | updated_at | DATETIME NULL | |
820
-
821
- Indexes:
822
-
823
- - group_id
824
-
825
- ## fct_atts_relations Table
826
-
827
- This table stores relationships between attributes and objects
828
-
829
- | Column | Type | Comment |
830
- | --- | --- | --- |
831
- | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
832
- | group_id | BIGINT(20) UNSIGNED NOT NULL | Reference to attribute group |
833
- | term_id | BIGINT(20) UNSIGNED NOT NULL | Reference to attribute term |
834
- | object_id | BIGINT(20) UNSIGNED NOT NULL | Related object ID |
835
- | created_at | DATETIME NULL | |
836
- | updated_at | DATETIME NULL | |
837
-
838
- Indexes:
839
-
840
- - group_id
841
- - term_id
842
- - object_id
843
-
844
- ## fct_label_relationships Table
845
-
846
- This table stores polymorphic relationships between labels and objects
847
-
848
- | Column | Type | Comment |
849
- | --- | --- | --- |
850
- | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
851
- | label_id | BIGINT(20) NOT NULL | Reference to label |
852
- | labelable_id | BIGINT(20) NOT NULL | Related object ID |
853
- | labelable_type | VARCHAR(192) NOT NULL | Object type |
854
- | created_at | DATETIME NULL | |
855
- | updated_at | DATETIME NULL | |
856
-
857
- Indexes:
858
-
859
- - label_id
860
- - labelable_id
861
-
862
- ## Pro Plugin Tables
863
-
864
- ### fct_licenses Table
865
-
866
- Software licences issued for a purchase (Pro).
867
-
868
- | Column | Type | Comment |
869
- | --- | --- | --- |
870
- | id | BIGINT UNSIGNED *Auto Increment* | |
871
- | status | VARCHAR(45) NULL DEFAULT 'active' | active, inactive, expired, disabled |
872
- | limit | BIGINT(20) UNSIGNED NOT NULL DEFAULT 0 | Activation limit |
873
- | activation_count | BIGINT(20) UNSIGNED NOT NULL DEFAULT 0 | Current activations |
874
- | license_key | VARCHAR(192) NULL | Licence key |
875
- | product_id | BIGINT(20) UNSIGNED NOT NULL | WordPress post ID of the product |
876
- | variation_id | BIGINT(20) UNSIGNED NOT NULL | Variation the licence was issued for |
877
- | order_id | BIGINT(20) UNSIGNED NOT NULL | Order the licence came from |
878
- | parent_id | BIGINT(20) UNSIGNED NULL | Parent licence, for upgrades and renewals |
879
- | customer_id | BIGINT(20) UNSIGNED NOT NULL | Licence owner |
880
- | expiration_date | DATETIME NULL | `NULL` means lifetime |
881
- | last_reminder_sent | DATETIME NULL | When the last expiry reminder went out |
882
- | last_reminder_type | VARCHAR(50) NULL | Which reminder stage was sent |
883
- | subscription_id | BIGINT(20) UNSIGNED NOT NULL DEFAULT 0 | Linked subscription, `0` when none |
884
- | config | json NULL | Extra licence configuration |
885
- | created_at | TIMESTAMP NULL | |
886
- | updated_at | TIMESTAMP NULL | |
887
-
888
- Indexes:
889
-
890
- - order_id
891
- - license_key
892
- - product_id
893
- - customer_id (`idx_licenses_customer_recovery`)
894
-
895
- ### fct_license_activations Table
896
-
897
- One row per site a licence is activated on (Pro). This table carries both `license_id` and `site_id`, so it is the join between licences and sites.
898
-
899
- | Column | Type | Comment |
900
- | --- | --- | --- |
901
- | id | BIGINT UNSIGNED *Auto Increment* | |
902
- | site_id | BIGINT(20) UNSIGNED NOT NULL | Reference to fct_license_sites |
903
- | license_id | BIGINT(20) UNSIGNED NOT NULL | Reference to fct_licenses |
904
- | status | VARCHAR(45) NULL DEFAULT 'active' | Activation status |
905
- | is_local | TINYINT NULL DEFAULT 0 | Local or staging install |
906
- | product_id | BIGINT(20) UNSIGNED NOT NULL | Product |
907
- | variation_id | BIGINT(20) UNSIGNED NOT NULL | Variation |
908
- | activation_method | VARCHAR(45) NULL DEFAULT 'key_based' | How the site activated |
909
- | activation_hash | VARCHAR(99) NULL | Activation hash |
910
- | last_update_version | VARCHAR(45) NULL | Version at the last update check |
911
- | last_update_date | DATETIME NULL | Last update check |
912
- | created_at | TIMESTAMP NULL | |
913
- | updated_at | TIMESTAMP NULL | |
914
-
915
- Indexes:
916
-
917
- - license_id
918
- - site_id
919
-
920
- ### fct_license_sites Table
921
-
922
- The sites themselves (Pro). Join through `fct_license_activations` to reach a licence's sites.
923
-
924
- | Column | Type | Comment |
925
- | --- | --- | --- |
926
- | id | BIGINT UNSIGNED *Auto Increment* | |
927
- | site_url | VARCHAR(192) NULL | Site URL |
928
- | server_version | VARCHAR(50) NULL | Server software version |
929
- | platform_version | VARCHAR(50) NULL | WordPress version |
930
- | other | JSON NULL | Additional site data |
931
- | created_at | TIMESTAMP NULL | |
932
- | updated_at | TIMESTAMP NULL | |
933
-
934
- Indexes:
935
-
936
- - site_url
937
-
938
- ### fct_license_meta Table
939
-
940
- This table stores license metadata (Pro feature)
941
-
942
- | Column | Type | Comment |
943
- | --- | --- | --- |
944
- | id | BIGINT UNSIGNED AUTO_INCREMENT, PRIMARY KEY | |
945
- | object_id | BIGINT UNSIGNED NULL DEFAULT NULL | Reference to object (license/activation/site) |
946
- | object_type | VARCHAR(100) NULL DEFAULT NULL | Can be: license / activation / site |
947
- | meta_key | VARCHAR(255) NULL DEFAULT NULL | Meta key |
948
- | meta_value | LONGTEXT NULL DEFAULT NULL | Meta value (JSON or string) |
949
- | created_at | TIMESTAMP NULL | |
950
- | updated_at | TIMESTAMP NULL | |
951
-
952
- Indexes:
953
-
954
- - meta_key
955
- - object_type
956
- - object_id
957
-
958
- ### fct_order_promotions Table
959
-
960
- This table stores order promotion data (Pro feature)
961
-
962
- | Column | Type | Comment |
963
- | --- | --- | --- |
964
- | id | BIGINT(20) UNSIGNED AUTO_INCREMENT, PRIMARY KEY | |
965
- | hash | VARCHAR(100) NOT NULL | |
966
- | parent_id | BIGINT(20) UNSIGNED NULL | |
967
- | type | VARCHAR(50) NOT NULL | |
968
- | status | VARCHAR(50) NOT NULL DEFAULT 'draft' | |
969
- | src_object_id | BIGINT(20) UNSIGNED NULL | |
970
- | src_object_type | VARCHAR(50) DEFAULT NULL | |
971
- | title | VARCHAR(194) DEFAULT NULL | |
972
- | description | TEXT DEFAULT NULL | |
973
- | conditions | JSON DEFAULT NULL | |
974
- | config | JSON DEFAULT NULL | |
975
- | priority | INT NOT NULL DEFAULT 1 | |
976
- | created_at | DATETIME NULL | |
977
- | updated_at | DATETIME NULL | |
978
-
979
- Indexes:
980
-
981
- - (type, status, src_object_id, src_object_type)
982
-
983
- ### fct_order_promotion_stats Table
984
-
985
- This table stores promotion statistics (Pro feature)
986
-
987
- | Column | Type | Comment |
988
- | --- | --- | --- |
989
- | id | BIGINT(20) UNSIGNED AUTO_INCREMENT, PRIMARY KEY | |
990
- | promotion_id | BIGINT(20) UNSIGNED NOT NULL | |
991
- | order_id | BIGINT(20) UNSIGNED NOT NULL | |
992
- | object_id | BIGINT(20) UNSIGNED NOT NULL | |
993
- | amount | BIGINT NOT NULL DEFAULT '0' | |
994
- | status | VARCHAR(50) NOT NULL DEFAULT 'offered' | |
995
- | created_at | DATETIME NULL | |
996
- | updated_at | DATETIME NULL | |
997
-
998
- Indexes:
999
-
1000
- - (promotion_id, object_id, order_id)
1001
-
1002
- ---
1
+ # FluentCart Database Schema
2
+
3
+ FluentCart uses custom database tables to store all the e-commerce data. Here are the list of database tables and their schema to understand overall database design and related data attributes of each model.
4
+
5
+ ### Core Entity Relationships
6
+
7
+ 🔍 Interactive ER Diagram
8
+
9
+ Click on the diagram below to zoom in for better readability. The diagram shows the relationships between all FluentCart database tables.
10
+
11
+ ### Schema Overview
12
+
13
+ The FluentCart database schema is built around these core concepts:
14
+
15
+ - **Orders & Transactions**: Complete order lifecycle management with payment tracking
16
+ - **Customers & Addresses**: Customer relationship management with multiple address support
17
+ - **Products & Variations**: Flexible product catalog with inventory management
18
+ - **Subscriptions**: Recurring billing and subscription lifecycle management
19
+ - **Coupons & Discounts**: Advanced discount system with conditions and stacking
20
+ - **Shipping & Tax**: Configurable shipping zones and tax rate management
21
+ - **Activity & Logging**: Comprehensive audit trail for all operations
22
+ - **Email Notifications**: Automated email templates and delivery system
23
+ - **Background Jobs**: Scheduled actions for automated processing
24
+ - **Cart Management**: Shopping cart persistence and checkout flow
25
+ - **Attributes & Labels**: Flexible product attributes and object tagging system
26
+ - **Webhooks**: External integration logging and delivery tracking
27
+ - **Licensing** (Pro): Software license management with activation tracking
28
+ - **Promotions** (Pro): Order promotion tracking and statistics
29
+
30
+ ### Key Design Principles
31
+
32
+ 1. **Currency Precision**: All monetary values stored as BIGINT in cents to avoid floating-point precision issues
33
+ 2. **Flexible Configuration**: JSON columns used for extensible configuration data
34
+ 3. **Audit Trail**: Comprehensive activity logging for all important operations
35
+ 4. **Referential Integrity**: Enforced in model code and application services. The migrations declare no SQL `FOREIGN KEY` constraints, so cascades and orphan cleanup are handled by FluentCart, not the database
36
+ 5. **Performance Optimization**: Strategic indexing on frequently queried columns
37
+ 6. **Multi-tenancy Ready**: UUID-based public identifiers for external integrations
38
+
39
+ ## Database Tables
40
+
41
+ ## fct_customers Table
42
+
43
+ This table stores customer information and purchase history
44
+
45
+ | Column | Type | Comment |
46
+ | --- | --- | --- |
47
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
48
+ | user_id | BIGINT UNSIGNED NULL | WordPress user ID |
49
+ | contact_id | BIGINT UNSIGNED NOT NULL DEFAULT '0' | Contact ID |
50
+ | email | VARCHAR(192) NOT NULL DEFAULT '' | Customer email |
51
+ | first_name | VARCHAR(192) NOT NULL DEFAULT '' | First name |
52
+ | last_name | VARCHAR(192) NOT NULL DEFAULT '' | Last name |
53
+ | status | VARCHAR(45) NULL DEFAULT 'active' | active, inactive, archived |
54
+ | purchase_value | JSON NULL | Purchase value data |
55
+ | purchase_count | BIGINT UNSIGNED NOT NULL DEFAULT '0' | Total number of purchases |
56
+ | ltv | BIGINT NOT NULL DEFAULT '0' | Lifetime value in cents |
57
+ | first_purchase_date | DATETIME NULL | First purchase date |
58
+ | last_purchase_date | DATETIME NULL | Last purchase date |
59
+ | aov | DECIMAL(18,2) NULL | Average order value |
60
+ | notes | LONGTEXT NOT NULL | Customer notes |
61
+ | uuid | VARCHAR(100) NULL DEFAULT '' | Unique identifier |
62
+ | country | VARCHAR(45) NULL | Country |
63
+ | city | VARCHAR(45) NULL | City |
64
+ | state | VARCHAR(45) NULL | State |
65
+ | postcode | VARCHAR(45) NULL | Postal code |
66
+ | created_at | DATETIME NULL | |
67
+ | updated_at | DATETIME NULL | |
68
+
69
+ Indexes:
70
+
71
+ - email
72
+ - user_id
73
+
74
+ ## fct_orders Table
75
+
76
+ This table stores the basic information of an order
77
+
78
+ | Column | Type | Comment |
79
+ | --- | --- | --- |
80
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
81
+ | status | VARCHAR(20) NOT NULL DEFAULT 'draft' | draft / pending / on-hold / processing / completed / failed / refunded / partial-refund |
82
+ | parent_id | BIGINT UNSIGNED NULL | Parent order |
83
+ | receipt_number | BIGINT UNSIGNED NULL | |
84
+ | invoice_no | VARCHAR(192) NULL DEFAULT '' | |
85
+ | fulfillment_type | VARCHAR(20) NULL DEFAULT 'physical' | physical, digital, service, mixed |
86
+ | type | VARCHAR(20) NOT NULL DEFAULT 'payment' | payment, renewal, refund |
87
+ | mode | ENUM('live', 'test') NOT NULL DEFAULT 'live' | live / test |
88
+ | shipping_status | VARCHAR(20) NOT NULL DEFAULT '' | unshipped / shipped / delivered / unshippable |
89
+ | customer_id | BIGINT UNSIGNED NULL | |
90
+ | payment_method | VARCHAR(100) NOT NULL | |
91
+ | payment_status | VARCHAR(20) NOT NULL DEFAULT '' | |
92
+ | payment_method_title | VARCHAR(100) NOT NULL | |
93
+ | currency | VARCHAR(10) NOT NULL | |
94
+ | subtotal | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
95
+ | discount_tax | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
96
+ | manual_discount_total | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
97
+ | coupon_discount_total | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
98
+ | shipping_tax | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
99
+ | shipping_total | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
100
+ | fee_total | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
101
+ | tax_total | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
102
+ | total_amount | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
103
+ | total_paid | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
104
+ | total_refund | BIGINT NOT NULL DEFAULT '0' | Amount in cents |
105
+ | rate | DECIMAL(24,12) NOT NULL DEFAULT '1.000000000000' | Base to presentment exchange rate, frozen at order time |
106
+ | tax_behavior | TINYINT(1) NOT NULL DEFAULT 0 | 0 => no_tax, 1 => exclusive, 2 => inclusive |
107
+ | note | TEXT NOT NULL DEFAULT '' | |
108
+ | ip_address | TEXT NOT NULL DEFAULT '' | |
109
+ | completed_at | DATETIME NULL DEFAULT NULL | |
110
+ | refunded_at | DATETIME NULL DEFAULT NULL | |
111
+ | uuid | VARCHAR(100) NOT NULL | |
112
+ | config | JSON DEFAULT NULL | |
113
+ | created_at | DATETIME NULL | |
114
+ | updated_at | DATETIME NULL | |
115
+
116
+ Indexes:
117
+
118
+ - invoice_no (191)
119
+ - type
120
+ - customer_id
121
+ - created_at, completed_at
122
+
123
+ ## fct_coupons Table
124
+
125
+ This table stores coupon definitions and rules
126
+
127
+ | Column | Type | Comment |
128
+ | --- | --- | --- |
129
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
130
+ | title | VARCHAR(200) NOT NULL | Coupon title |
131
+ | code | VARCHAR(50) NOT NULL UNIQUE | Coupon code (unique) |
132
+ | priority | INT DEFAULT NULL | Coupon priority |
133
+ | type | VARCHAR(20) NOT NULL | Coupon type |
134
+ | conditions | JSON NULL | Coupon conditions |
135
+ | amount | double NOT NULL | Discount amount |
136
+ | use_count | INT DEFAULT 0 | Usage count |
137
+ | status | VARCHAR(20) NOT NULL | Coupon status |
138
+ | notes | LONGTEXT NOT NULL | Coupon notes |
139
+ | stackable | VARCHAR(3) NOT NULL DEFAULT 'no' | Stackable flag (yes/no) |
140
+ | show_on_checkout | VARCHAR(3) NOT NULL DEFAULT 'yes' | Show on checkout (yes/no) |
141
+ | start_date | TIMESTAMP NULL | Start date |
142
+ | end_date | TIMESTAMP NULL | End date |
143
+ | created_at | DATETIME NULL | |
144
+ | updated_at | DATETIME NULL | |
145
+
146
+ Indexes:
147
+
148
+ - code
149
+ - status
150
+
151
+ ## fct_order_items Table
152
+
153
+ This table stores individual items within orders
154
+
155
+ | Column | Type | Comment |
156
+ | --- | --- | --- |
157
+ | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
158
+ | order_id | BIGINT UNSIGNED NOT NULL DEFAULT '0' | Reference to order |
159
+ | post_id | BIGINT UNSIGNED NOT NULL DEFAULT '0' | WordPress post ID (product) |
160
+ | fulfillment_type | VARCHAR(20) NOT NULL DEFAULT 'physical' | physical, digital, service |
161
+ | payment_type | VARCHAR(20) NOT NULL DEFAULT 'onetime' | onetime, subscription, signup_fee |
162
+ | post_title | TEXT NOT NULL | Product title |
163
+ | title | TEXT NOT NULL | Item title (variation) |
164
+ | object_id | BIGINT UNSIGNED NULL DEFAULT NULL | Variation ID |
165
+ | cart_index | BIGINT UNSIGNED NOT NULL DEFAULT '0' | Position in cart |
166
+ | quantity | INT NOT NULL DEFAULT '1' | Item quantity |
167
+ | unit_price | BIGINT NOT NULL DEFAULT '0' | Price per unit in cents |
168
+ | cost | BIGINT NOT NULL DEFAULT '0' | Cost in cents |
169
+ | subtotal | BIGINT NOT NULL DEFAULT '0' | Line subtotal |
170
+ | tax_amount | BIGINT NOT NULL DEFAULT '0' | Tax amount for this line |
171
+ | shipping_charge | BIGINT NOT NULL DEFAULT '0' | Shipping charge |
172
+ | discount_total | BIGINT NOT NULL DEFAULT '0' | Discount amount |
173
+ | line_total | BIGINT NOT NULL DEFAULT '0' | Total line amount |
174
+ | refund_total | BIGINT NOT NULL DEFAULT '0' | Refunded amount |
175
+ | rate | BIGINT NOT NULL DEFAULT '1' | Exchange rate |
176
+ | other_info | JSON NULL | Additional item data |
177
+ | line_meta | JSON NULL | Line-specific metadata |
178
+ | fulfilled_quantity | INT NOT NULL DEFAULT '0' | Quantity fulfilled |
179
+ | referrer | TEXT NULL | Referral information |
180
+ | created_at | DATETIME NULL | |
181
+ | updated_at | DATETIME NULL | |
182
+
183
+ Indexes:
184
+
185
+ - order_id, object_id
186
+ - post_id
187
+
188
+ ## fct_subscriptions Table
189
+
190
+ This table stores subscription information and billing cycles
191
+
192
+ | Column | Type | Comment |
193
+ | --- | --- | --- |
194
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
195
+ | uuid | VARCHAR(100) NOT NULL | Unique identifier |
196
+ | customer_id | BIGINT(20) UNSIGNED NOT NULL | Reference to customer |
197
+ | parent_order_id | BIGINT(20) UNSIGNED NOT NULL | Initial order ID |
198
+ | product_id | BIGINT(20) UNSIGNED NOT NULL | WordPress post ID |
199
+ | item_name | TEXT NOT NULL | Subscription item name |
200
+ | quantity | INT NOT NULL DEFAULT '1' | Subscription quantity |
201
+ | variation_id | BIGINT(20) UNSIGNED NOT NULL | Product variation ID |
202
+ | billing_interval | VARCHAR(45) NULL | Billing interval (day, week, month, year) |
203
+ | signup_fee | BIGINT UNSIGNED NOT NULL DEFAULT 0 | Signup fee in cents |
204
+ | initial_tax_total | BIGINT UNSIGNED NOT NULL DEFAULT 0 | Initial tax in cents |
205
+ | recurring_amount | BIGINT UNSIGNED NOT NULL DEFAULT 0 | Recurring amount in cents |
206
+ | recurring_tax_total | BIGINT UNSIGNED NOT NULL DEFAULT 0 | Recurring tax in cents |
207
+ | recurring_total | BIGINT UNSIGNED NOT NULL DEFAULT 0 | Total recurring in cents |
208
+ | bill_times | BIGINT(20) UNSIGNED NOT NULL DEFAULT 0 | Total billing cycles |
209
+ | bill_count | INT UNSIGNED NOT NULL DEFAULT 0 | Current billing count |
210
+ | expire_at | DATETIME NULL | Expiration date |
211
+ | trial_ends_at | DATETIME NULL | Trial end date |
212
+ | canceled_at | DATETIME NULL | Cancellation date |
213
+ | restored_at | DATETIME NULL | Restoration date |
214
+ | collection_method | ENUM('automatic', 'manual', 'system') NOT NULL DEFAULT 'automatic' | Payment collection method |
215
+ | next_billing_date | DATETIME NULL | Next billing date |
216
+ | trial_days | INT(10) UNSIGNED NOT NULL DEFAULT 0 | Trial period in days |
217
+ | vendor_customer_id | VARCHAR(45) NULL | Payment gateway customer ID |
218
+ | vendor_plan_id | VARCHAR(45) NULL | Payment gateway plan ID |
219
+ | vendor_subscription_id | VARCHAR(45) NULL | Payment gateway subscription ID |
220
+ | status | VARCHAR(45) NULL | active, canceled, expired, pending, trialing |
221
+ | original_plan | LONGTEXT NULL | Original plan data |
222
+ | vendor_response | LONGTEXT NULL | Payment gateway response |
223
+ | current_payment_method | VARCHAR(45) NULL | Current payment method |
224
+ | config | JSON DEFAULT NULL | Subscription configuration |
225
+ | created_at | DATETIME NULL | |
226
+ | updated_at | DATETIME NULL | |
227
+
228
+ Indexes:
229
+
230
+ - parent_order_id
231
+
232
+ ## fct_order_transactions Table
233
+
234
+ This table stores payment transactions for orders
235
+
236
+ | Column | Type | Comment |
237
+ | --- | --- | --- |
238
+ | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
239
+ | order_id | BIGINT UNSIGNED NOT NULL DEFAULT '0' | Reference to order |
240
+ | order_type | VARCHAR(100) NOT NULL DEFAULT '' | |
241
+ | transaction_type | VARCHAR(192) DEFAULT 'charge' | charge, refund, etc. |
242
+ | subscription_id | INT(11) NULL | Reference to subscription |
243
+ | card_last_4 | VARCHAR(4) NULL | Last 4 digits of card |
244
+ | card_brand | VARCHAR(100) | Card brand |
245
+ | vendor_charge_id | VARCHAR(192) NOT NULL DEFAULT '' | Payment gateway transaction ID |
246
+ | payment_method | VARCHAR(100) NOT NULL DEFAULT '' | |
247
+ | payment_mode | VARCHAR(100) NOT NULL DEFAULT '' | live, test |
248
+ | payment_method_type | VARCHAR(100) NOT NULL DEFAULT '' | card, bank, etc. |
249
+ | status | VARCHAR(20) NOT NULL DEFAULT '' | Transaction status |
250
+ | currency | VARCHAR(10) NOT NULL DEFAULT '' | Transaction currency |
251
+ | total | BIGINT NOT NULL DEFAULT '0' | Transaction amount in cents |
252
+ | rate | DECIMAL(24,12) | Exchange rate |
253
+ | uuid | VARCHAR(100) NULL DEFAULT '' | |
254
+ | meta | JSON DEFAULT NULL | Transaction metadata |
255
+ | created_at | DATETIME NULL | |
256
+ | updated_at | DATETIME NULL | |
257
+
258
+ Indexes:
259
+
260
+ - vendor_charge_id (64)
261
+ - payment_method
262
+ - status
263
+ - order_id
264
+
265
+ ## fct_order_addresses Table
266
+
267
+ This table stores order shipping and billing addresses
268
+
269
+ | Column | Type | Comment |
270
+ | --- | --- | --- |
271
+ | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
272
+ | order_id | BIGINT UNSIGNED NOT NULL | Reference to order |
273
+ | type | VARCHAR(20) NOT NULL DEFAULT 'billing' | billing, shipping |
274
+ | name | VARCHAR(192) NULL | Address name |
275
+ | address_1 | VARCHAR(192) NULL | Address line 1 |
276
+ | address_2 | VARCHAR(192) NULL | Address line 2 |
277
+ | city | VARCHAR(192) NULL | City |
278
+ | state | VARCHAR(192) NULL | State |
279
+ | postcode | VARCHAR(50) NULL | Postal code |
280
+ | country | VARCHAR(100) NULL | Country |
281
+ | meta | JSON NULL | VAT number, legal registration ID and other extras |
282
+ | created_at | DATETIME NULL | |
283
+ | updated_at | DATETIME NULL | |
284
+
285
+ Indexes:
286
+
287
+ - (order_id, type)
288
+
289
+ ## fct_order_operations Table
290
+
291
+ This table stores order operation logs and analytics
292
+
293
+ | Column | Type | Comment |
294
+ | --- | --- | --- |
295
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
296
+ | order_id | BIGINT(20) UNSIGNED NOT NULL | Reference to order |
297
+ | created_via | VARCHAR(45) NULL | How the order was created |
298
+ | emails_sent | TINYINT(1) NULL DEFAULT 0 | Emails sent flag |
299
+ | sales_recorded | TINYINT(1) NULL DEFAULT 0 | Sales recorded flag |
300
+ | utm_campaign | VARCHAR(192) NULL DEFAULT '' | UTM campaign tracking |
301
+ | utm_term | VARCHAR(192) NULL DEFAULT '' | UTM term tracking |
302
+ | utm_source | VARCHAR(192) NULL DEFAULT '' | UTM source tracking |
303
+ | utm_medium | VARCHAR(192) NULL DEFAULT '' | UTM medium tracking |
304
+ | utm_content | VARCHAR(192) NULL DEFAULT '' | UTM content tracking |
305
+ | utm_id | VARCHAR(192) NULL DEFAULT '' | UTM ID tracking |
306
+ | cart_hash | VARCHAR(192) NULL DEFAULT '' | Cart hash identifier |
307
+ | refer_url | VARCHAR(192) NULL DEFAULT '' | Referral URL |
308
+ | meta | JSON DEFAULT NULL | Additional operation metadata |
309
+ | created_at | DATETIME NULL | |
310
+ | updated_at | DATETIME NULL | |
311
+
312
+ Indexes:
313
+
314
+ - order_id
315
+
316
+ ## fct_order_download_permissions Table
317
+
318
+ This table stores download permissions for orders
319
+
320
+ | Column | Type | Comment |
321
+ | --- | --- | --- |
322
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
323
+ | order_id | BIGINT(20) UNSIGNED NOT NULL | Reference to order |
324
+ | variation_id | BIGINT(20) UNSIGNED NOT NULL | Reference to product variation |
325
+ | download_id | BIGINT(20) UNSIGNED NOT NULL | Reference to download |
326
+ | download_count | INT(11) NULL | Number of downloads |
327
+ | download_limit | INT(11) NULL | Download limit |
328
+ | access_expires | DATETIME NULL | Access expiration date |
329
+ | customer_id | BIGINT(20) UNSIGNED NOT NULL | Reference to customer |
330
+ | created_at | DATETIME NULL | |
331
+ | updated_at | DATETIME NULL | |
332
+
333
+ Indexes:
334
+
335
+ - order_id
336
+ - download_id
337
+ - variation_id
338
+
339
+ ## fct_product_variations Table
340
+
341
+ This table stores product variations with pricing and inventory
342
+
343
+ | Column | Type | Comment |
344
+ | --- | --- | --- |
345
+ | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
346
+ | post_id | BIGINT(20) UNSIGNED NOT NULL | WordPress post ID |
347
+ | media_id | BIGINT(20) UNSIGNED NULL | Media attachment ID |
348
+ | serial_index | INT(5) NULL | Variation order |
349
+ | sold_individually | TINYINT(1) UNSIGNED NULL DEFAULT 0 | Sold individually flag |
350
+ | variation_title | VARCHAR(192) NOT NULL | Variation title |
351
+ | variation_identifier | VARCHAR(100) NULL | Legacy identifier |
352
+ | sku | VARCHAR(30) NULL | Stock keeping unit, unique across variations |
353
+ | manage_stock | TINYINT(1) NULL DEFAULT 0 | Stock management enabled |
354
+ | payment_type | VARCHAR(50) NULL | onetime, subscription |
355
+ | stock_status | VARCHAR(30) NULL DEFAULT 'out-of-stock' | in-stock, out-of-stock, backorder |
356
+ | backorders | TINYINT(1) UNSIGNED NULL DEFAULT 0 | Backorders allowed |
357
+ | total_stock | INT(11) NULL DEFAULT 0 | Total stock quantity |
358
+ | on_hold | INT(11) NULL DEFAULT 0 | Stock on hold |
359
+ | committed | INT(11) NULL DEFAULT 0 | Committed stock |
360
+ | available | INT(11) NULL DEFAULT 0 | Available stock |
361
+ | fulfillment_type | VARCHAR(100) NULL DEFAULT 'physical' | physical, digital, service, mixed |
362
+ | item_status | VARCHAR(30) NULL DEFAULT 'active' | active, inactive |
363
+ | manage_cost | VARCHAR(30) NULL DEFAULT 'false' | Cost management enabled |
364
+ | item_price | double DEFAULT 0 NOT NULL | Variation price |
365
+ | item_cost | double DEFAULT 0 NOT NULL | Variation cost |
366
+ | compare_price | double DEFAULT 0 NULL | Compare at price |
367
+ | shipping_class | BIGINT(20) NULL | Shipping class ID |
368
+ | other_info | longtext NULL | Additional variation data |
369
+ | downloadable | VARCHAR(30) NULL DEFAULT 'false' | Downloadable flag |
370
+ | created_at | DATETIME NULL | |
371
+ | updated_at | DATETIME NULL | |
372
+
373
+ Indexes:
374
+
375
+ - post_id
376
+ - stock_status
377
+
378
+ ## fct_product_details Table
379
+
380
+ This table stores product configuration and settings
381
+
382
+ | Column | Type | Comment |
383
+ | --- | --- | --- |
384
+ | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
385
+ | post_id | BIGINT(20) UNSIGNED NOT NULL | WordPress post ID |
386
+ | fulfillment_type | VARCHAR(100) NULL DEFAULT 'physical' | physical, digital, service, mixed |
387
+ | min_price | double DEFAULT 0 NOT NULL | Minimum price |
388
+ | max_price | double DEFAULT 0 NOT NULL | Maximum price |
389
+ | default_variation_id | BIGINT(20) UNSIGNED NULL | Default variation ID |
390
+ | default_media | JSON NULL | Default media data |
391
+ | manage_stock | TINYINT(1) NULL DEFAULT 0 | Stock management enabled |
392
+ | stock_availability | VARCHAR(100) NULL DEFAULT 'in-stock' | in-stock, out-of-stock, backorder |
393
+ | variation_type | VARCHAR(30) NULL DEFAULT 'simple' | simple, simple_variation, advance_variation |
394
+ | manage_downloadable | TINYINT(1) NULL DEFAULT 0 | Downloadable management enabled |
395
+ | other_info | JSON NULL | Additional product data |
396
+ | created_at | DATETIME NULL | |
397
+ | updated_at | DATETIME NULL | |
398
+
399
+ Indexes:
400
+
401
+ - post_id
402
+ - stock_availability
403
+
404
+ ## fct_product_meta Table
405
+
406
+ This table stores product metadata
407
+
408
+ | Column | Type | Comment |
409
+ | --- | --- | --- |
410
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
411
+ | object_id | BIGINT UNSIGNED NOT NULL | Reference to product |
412
+ | object_type | VARCHAR(192) NULL | Object type |
413
+ | meta_key | VARCHAR(192) NOT NULL | Meta key |
414
+ | meta_value | LONGTEXT NULL DEFAULT NULL | Meta value |
415
+ | created_at | DATETIME NULL | |
416
+ | updated_at | DATETIME NULL | |
417
+
418
+ Indexes:
419
+
420
+ - meta_key
421
+
422
+ ## fct_applied_coupons Table
423
+
424
+ This table stores applied coupons to orders
425
+
426
+ | Column | Type | Comment |
427
+ | --- | --- | --- |
428
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
429
+ | order_id | BIGINT UNSIGNED NOT NULL | Reference to order |
430
+ | coupon_id | BIGINT UNSIGNED NULL | Reference to coupon |
431
+ | code | VARCHAR(100) NOT NULL | Coupon code |
432
+ | amount | double NOT NULL | Discount amount |
433
+ | created_at | DATETIME NULL | |
434
+ | updated_at | DATETIME NULL | |
435
+
436
+ Indexes:
437
+
438
+ - code
439
+ - (coupon_id, order_id) — per-customer usage counting joins through these
440
+
441
+ ## fct_customer_addresses Table
442
+
443
+ This table stores customer shipping and billing addresses
444
+
445
+ | Column | Type | Comment |
446
+ | --- | --- | --- |
447
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
448
+ | customer_id | BIGINT UNSIGNED NOT NULL | Reference to customer |
449
+ | is_primary | TINYINT(1) NOT NULL DEFAULT 0 | Primary address flag |
450
+ | type | VARCHAR(20) NOT NULL DEFAULT 'billing' | billing, shipping |
451
+ | status | VARCHAR(20) NOT NULL DEFAULT 'active' | active, inactive |
452
+ | label | VARCHAR(50) NOT NULL DEFAULT '' | Address label |
453
+ | name | VARCHAR(192) NULL | Address name |
454
+ | address_1 | VARCHAR(192) NULL | Address line 1 |
455
+ | address_2 | VARCHAR(192) NULL | Address line 2 |
456
+ | city | VARCHAR(192) NULL | City |
457
+ | state | VARCHAR(192) NULL | State |
458
+ | phone | VARCHAR(192) NULL | Phone number |
459
+ | email | VARCHAR(192) NULL | Email address |
460
+ | postcode | VARCHAR(32) NULL | Postal code |
461
+ | country | VARCHAR(100) NULL | Country |
462
+ | meta | JSON NULL | VAT number, legal registration ID and other extras |
463
+ | created_at | DATETIME NULL | |
464
+ | updated_at | DATETIME NULL | |
465
+
466
+ Indexes:
467
+
468
+ - customer_id, is_primary
469
+ - type
470
+ - status
471
+
472
+ ## fct_customer_meta Table
473
+
474
+ This table stores customer metadata
475
+
476
+ | Column | Type | Comment |
477
+ | --- | --- | --- |
478
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
479
+ | customer_id | BIGINT UNSIGNED NULL DEFAULT NULL | Reference to customer |
480
+ | meta_key | VARCHAR(192) NULL DEFAULT NULL | Meta key |
481
+ | meta_value | LONGTEXT NULL DEFAULT NULL | Meta value |
482
+ | created_at | DATETIME NULL | |
483
+ | updated_at | DATETIME NULL | |
484
+
485
+ Indexes:
486
+
487
+ - meta_key
488
+ - customer_id
489
+
490
+ ## fct_carts Table
491
+
492
+ This table stores shopping cart data
493
+
494
+ | Column | Type | Comment |
495
+ | --- | --- | --- |
496
+ | customer_id | BIGINT(20) UNSIGNED NULL | Reference to customer |
497
+ | user_id | BIGINT(20) UNSIGNED NULL | Reference to WordPress user |
498
+ | order_id | BIGINT(20) UNSIGNED NULL | Reference to order |
499
+ | cart_hash | VARCHAR(192) NOT NULL UNIQUE | Unique cart identifier |
500
+ | checkout_data | LONGTEXT NULL | Checkout form data |
501
+ | cart_data | LONGTEXT NULL | Cart contents |
502
+ | utm_data | LONGTEXT NULL | UTM tracking data |
503
+ | coupons | LONGTEXT NULL | Applied coupons |
504
+ | first_name | VARCHAR(192) NULL | Customer first name |
505
+ | last_name | VARCHAR(192) NULL | Customer last name |
506
+ | email | VARCHAR(192) NULL | Customer email |
507
+ | stage | VARCHAR(30) NULL DEFAULT 'draft' | draft, pending, in-complete, completed |
508
+ | cart_group | VARCHAR(30) NULL DEFAULT 'global' | Cart group |
509
+ | user_agent | VARCHAR(192) NULL | User agent string |
510
+ | ip_address | VARCHAR(50) NULL | IP address |
511
+ | completed_at | TIMESTAMP NULL | Completion timestamp |
512
+ | created_at | DATETIME NULL | |
513
+ | updated_at | DATETIME NULL | |
514
+ | deleted_at | TIMESTAMP NULL | Soft delete timestamp |
515
+
516
+ ## fct_product_downloads Table
517
+
518
+ This table stores downloadable product files
519
+
520
+ | Column | Type | Comment |
521
+ | --- | --- | --- |
522
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
523
+ | post_id | BIGINT(20) UNSIGNED NOT NULL | WordPress post ID |
524
+ | product_variation_id | longtext NOT NULL | Product variation ID |
525
+ | download_identifier | VARCHAR(100) NOT NULL UNIQUE | Unique download identifier |
526
+ | title | VARCHAR(192) NULL | Download title |
527
+ | type | VARCHAR(100) NULL | Download type |
528
+ | driver | VARCHAR(100) NULL DEFAULT 'local' | Storage driver |
529
+ | file_name | VARCHAR(192) NULL | File name |
530
+ | file_path | TEXT NULL | File path |
531
+ | file_url | TEXT NULL | File URL |
532
+ | file_size | TEXT NULL | File size |
533
+ | settings | TEXT NULL | Download settings |
534
+ | serial | INT NULL | Serial number |
535
+ | created_at | DATETIME NULL | |
536
+ | updated_at | DATETIME NULL | |
537
+
538
+ ## fct_subscription_meta Table
539
+
540
+ This table stores subscription metadata
541
+
542
+ | Column | Type | Comment |
543
+ | --- | --- | --- |
544
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
545
+ | subscription_id | BIGINT UNSIGNED NULL DEFAULT NULL | Reference to subscription |
546
+ | meta_key | VARCHAR(192) NULL DEFAULT NULL | Meta key |
547
+ | meta_value | LONGTEXT NULL DEFAULT NULL | Meta value |
548
+ | created_at | DATETIME NULL | |
549
+ | updated_at | DATETIME NULL | |
550
+
551
+ Indexes:
552
+
553
+ - subscription_id
554
+ - meta_key
555
+
556
+ ## fct_activity Table
557
+
558
+ This table stores system activity and audit logs
559
+
560
+ | Column | Type | Comment |
561
+ | --- | --- | --- |
562
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
563
+ | status | VARCHAR(20) NOT NULL DEFAULT 'info' | success / warning / failed / info |
564
+ | log_type | VARCHAR(20) NOT NULL DEFAULT 'activity' | activity, api |
565
+ | module_type | VARCHAR(100) NOT NULL DEFAULT 'order' | Full model path |
566
+ | module_id | BIGINT NULL | Related record ID |
567
+ | module_name | VARCHAR(192) NOT NULL DEFAULT 'order' | order, product, user, coupon, subscription, payment, refund, shipment, activity |
568
+ | user_id | BIGINT UNSIGNED NULL | User who performed action |
569
+ | title | VARCHAR(192) NULL | Activity title |
570
+ | content | LONGTEXT NULL | Activity description |
571
+ | read_status | VARCHAR(20) NOT NULL DEFAULT 'unread' | read, unread |
572
+ | created_by | VARCHAR(100) NOT NULL DEFAULT 'FCT-BOT' | Creator identifier |
573
+ | created_at | DATETIME NULL | |
574
+ | updated_at | DATETIME NULL | |
575
+
576
+ Indexes:
577
+
578
+ - module_id
579
+
580
+ ## fct_shipping_zones Table
581
+
582
+ This table stores shipping zones configuration
583
+
584
+ | Column | Type | Comment |
585
+ | --- | --- | --- |
586
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
587
+ | shipping_class_id | BIGINT UNSIGNED NULL | Scopes the zone to one shipping class; NULL means it applies to class-less items |
588
+ | name | VARCHAR(192) NOT NULL | Zone name |
589
+ | region | VARCHAR(192) NOT NULL | A country code, `all` (Whole World) or `selection` |
590
+ | meta | JSON NULL | For `selection` zones: `countries` and `selection_type` (`included` / `excluded`) |
591
+ | order | INT UNSIGNED NOT NULL DEFAULT 0 | Display order |
592
+ | created_at | DATETIME NULL | |
593
+ | updated_at | DATETIME NULL | |
594
+
595
+ Indexes:
596
+
597
+ - order
598
+ - shipping_class_id
599
+
600
+ ## fct_shipping_methods Table
601
+
602
+ This table stores shipping methods within zones
603
+
604
+ | Column | Type | Comment |
605
+ | --- | --- | --- |
606
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
607
+ | zone_id | BIGINT UNSIGNED NOT NULL | Reference to shipping zone |
608
+ | title | VARCHAR(192) NOT NULL | Method title |
609
+ | type | VARCHAR(50) NOT NULL | Method type |
610
+ | settings | LONGTEXT NULL | Method settings: `configure_rate`, `class_aggregation`, `weight_tiers` |
611
+ | is_enabled | TINYINT(1) NOT NULL DEFAULT 1 | Enabled flag |
612
+ | states | JSON NULL | Restricts the method to these states within the zone |
613
+ | amount | DECIMAL(10,2) NULL DEFAULT 0.00 | Base rate in base-currency major units, not cents (a percentage when `configure_rate` is `per_price`) |
614
+ | order | INT UNSIGNED NOT NULL DEFAULT 0 | Display order |
615
+ | meta | JSON NULL | |
616
+ | created_at | DATETIME NULL | |
617
+ | updated_at | DATETIME NULL | |
618
+
619
+ Indexes:
620
+
621
+ - zone_id
622
+ - order
623
+
624
+ ## fct_shipping_classes Table
625
+
626
+ This table stores shipping classes
627
+
628
+ | Column | Type | Comment |
629
+ | --- | --- | --- |
630
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
631
+ | name | VARCHAR(192) NOT NULL | Class name |
632
+ | description | VARCHAR(500) NULL | Class description |
633
+ | cost | DECIMAL(10,2) NOT NULL DEFAULT 0.00 | Surcharge in base-currency major units, not cents |
634
+ | per_item | TINYINT(1) NOT NULL DEFAULT 0 | Per item flag |
635
+ | type | VARCHAR(20) NOT NULL DEFAULT 'fixed' | Class type |
636
+ | created_at | DATETIME NULL | |
637
+ | updated_at | DATETIME NULL | |
638
+
639
+ Indexes:
640
+
641
+ - name
642
+
643
+ ## fct_tax_classes Table
644
+
645
+ This table stores tax class definitions
646
+
647
+ | Column | Type | Comment |
648
+ | --- | --- | --- |
649
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
650
+ | title | VARCHAR(192) NULL | Tax class title |
651
+ | slug | VARCHAR(100) NULL | Tax class slug |
652
+ | description | LONGTEXT NULL | Tax class description |
653
+ | meta | JSON DEFAULT NULL | Tax class metadata |
654
+ | created_at | DATETIME NULL | |
655
+ | updated_at | DATETIME NULL | |
656
+
657
+ ## fct_tax_rates Table
658
+
659
+ This table stores tax rate configurations
660
+
661
+ | Column | Type | Comment |
662
+ | --- | --- | --- |
663
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
664
+ | class_id | BIGINT UNSIGNED NOT NULL | Tax class ID |
665
+ | country | VARCHAR(45) NULL | Country code |
666
+ | state | VARCHAR(45) NULL | State code |
667
+ | postcode | TEXT NULL | Postal code (supports ranges) |
668
+ | city | VARCHAR(45) NULL | City |
669
+ | rate | VARCHAR(45) NULL | Tax rate |
670
+ | name | VARCHAR(45) NULL | Tax name |
671
+ | group | VARCHAR(45) NULL | Tax group |
672
+ | priority | INT UNSIGNED NULL DEFAULT 1 | Priority |
673
+ | is_compound | TINYINT UNSIGNED NULL DEFAULT 0 | Compound tax flag |
674
+ | for_shipping | DECIMAL(10,2) NULL DEFAULT NULL | Shipping-tax rate override percentage (NULL = inherit base rate; 0 = no shipping tax) |
675
+ | for_order | TINYINT UNSIGNED NULL DEFAULT 0 | Apply to order |
676
+
677
+ Indexes:
678
+
679
+ - class_id
680
+ - priority
681
+
682
+ ## fct_meta Table
683
+
684
+ This table stores generic metadata for various objects
685
+
686
+ | Column | Type | Comment |
687
+ | --- | --- | --- |
688
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
689
+ | object_type | VARCHAR(50) NOT NULL | Object type |
690
+ | object_id | BIGINT NULL | Object ID |
691
+ | meta_key | VARCHAR(192) NOT NULL | Meta key |
692
+ | meta_value | LONGTEXT NULL | Meta value |
693
+ | created_at | DATETIME NULL | |
694
+ | updated_at | DATETIME NULL | |
695
+
696
+ Indexes:
697
+
698
+ - object_type
699
+ - object_id
700
+
701
+ ## fct_label Table
702
+
703
+ This table stores labels for tagging objects
704
+
705
+ | Column | Type | Comment |
706
+ | --- | --- | --- |
707
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
708
+ | value | VARCHAR(192) NOT NULL UNIQUE | Label value (unique) |
709
+ | created_at | DATETIME NULL | |
710
+ | updated_at | DATETIME NULL | |
711
+
712
+ ## fct_order_meta Table
713
+
714
+ This table stores order metadata
715
+
716
+ | Column | Type | Comment |
717
+ | --- | --- | --- |
718
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
719
+ | order_id | BIGINT(20) NULL | Reference to order |
720
+ | meta_key | VARCHAR(192) NOT NULL | Meta key |
721
+ | meta_value | LONGTEXT NULL | Meta value |
722
+ | created_at | DATETIME NULL | |
723
+ | updated_at | DATETIME NULL | |
724
+
725
+ Indexes:
726
+
727
+ - order_id
728
+
729
+ ## fct_order_tax_rate Table
730
+
731
+ This table stores order tax rate information
732
+
733
+ | Column | Type | Comment |
734
+ | --- | --- | --- |
735
+ | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
736
+ | order_id | BIGINT(20) UNSIGNED NOT NULL | Reference to order |
737
+ | tax_rate_id | BIGINT(20) NOT NULL | Reference to tax rate (signed; virtual EU VAT rates use negative IDs) |
738
+ | shipping_tax | BIGINT NULL | Shipping tax amount |
739
+ | order_tax | BIGINT NULL | Order tax amount |
740
+ | total_tax | BIGINT NULL | Total tax amount |
741
+ | meta | JSON DEFAULT NULL | Tax meta data |
742
+ | filed_at | DATETIME NULL | Filed at |
743
+ | created_at | DATETIME NULL | |
744
+ | updated_at | DATETIME NULL | |
745
+
746
+ Indexes:
747
+
748
+ - (order_id, tax_rate_id) (unique)
749
+
750
+ ## fct_webhook_logger Table
751
+
752
+ This table stores webhook delivery logs and status
753
+
754
+ | Column | Type | Comment |
755
+ | --- | --- | --- |
756
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
757
+ | source | VARCHAR(20) NOT NULL | Webhook source |
758
+ | event_type | VARCHAR(100) NOT NULL | Event type |
759
+ | payload | LONGTEXT NULL | Webhook payload |
760
+ | status | VARCHAR(20) NOT NULL DEFAULT 'pending' | pending, sent, failed |
761
+ | created_at | DATETIME NULL | |
762
+ | updated_at | DATETIME NULL | |
763
+
764
+ ## fct_scheduled_actions Table
765
+
766
+ This table stores background job scheduling and execution
767
+
768
+ | Column | Type | Comment |
769
+ | --- | --- | --- |
770
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
771
+ | scheduled_at | DATETIME NULL | When to run the action |
772
+ | action | VARCHAR(192) NULL | Action to perform |
773
+ | status | VARCHAR(20) NULL | pending, processing, completed, failed |
774
+ | group | VARCHAR(100) NULL | order, subscription |
775
+ | object_id | BIGINT UNSIGNED NULL DEFAULT NULL | Related object ID |
776
+ | object_type | VARCHAR(100) NULL DEFAULT NULL | Object type |
777
+ | completed_at | TIMESTAMP NULL | When action was completed |
778
+ | retry_count | INT UNSIGNED DEFAULT 0 | Number of retries |
779
+ | data | JSON NULL | Action data |
780
+ | created_at | DATETIME NULL | |
781
+ | updated_at | DATETIME NULL | |
782
+ | response_note | LONGTEXT NULL | Response or error message |
783
+
784
+ Indexes:
785
+
786
+ - scheduled_at
787
+ - status
788
+
789
+ ## fct_atts_groups Table
790
+
791
+ This table stores attribute groups for product attributes
792
+
793
+ | Column | Type | Comment |
794
+ | --- | --- | --- |
795
+ | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
796
+ | title | VARCHAR(192) NOT NULL | Group title |
797
+ | slug | VARCHAR(192) NOT NULL UNIQUE | Group slug |
798
+ | description | LONGTEXT NULL | Group description |
799
+ | settings | LONGTEXT NULL | Group settings |
800
+ | serial | INT(11) UNSIGNED NOT NULL DEFAULT 0 | Manual drag-order of groups in the admin |
801
+ | is_system | TINYINT(1) NOT NULL DEFAULT 0 | Marks a group FluentCart created itself |
802
+ | created_at | DATETIME NULL | |
803
+ | updated_at | DATETIME NULL | |
804
+
805
+ ## fct_atts_terms Table
806
+
807
+ This table stores attribute terms within groups
808
+
809
+ | Column | Type | Comment |
810
+ | --- | --- | --- |
811
+ | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
812
+ | group_id | BIGINT(20) UNSIGNED | Reference to attribute group |
813
+ | serial | INT(11) UNSIGNED | Term order |
814
+ | title | VARCHAR(192) NOT NULL | Term title |
815
+ | slug | VARCHAR(192) NOT NULL | Term slug |
816
+ | description | LONGTEXT NULL | Term description |
817
+ | settings | LONGTEXT NULL | Term settings |
818
+ | created_at | DATETIME NULL | |
819
+ | updated_at | DATETIME NULL | |
820
+
821
+ Indexes:
822
+
823
+ - group_id
824
+
825
+ ## fct_atts_relations Table
826
+
827
+ This table stores relationships between attributes and objects
828
+
829
+ | Column | Type | Comment |
830
+ | --- | --- | --- |
831
+ | id | BIGINT(20) UNSIGNED *Auto Increment* | Primary key |
832
+ | group_id | BIGINT(20) UNSIGNED NOT NULL | Reference to attribute group |
833
+ | term_id | BIGINT(20) UNSIGNED NOT NULL | Reference to attribute term |
834
+ | object_id | BIGINT(20) UNSIGNED NOT NULL | Related object ID |
835
+ | created_at | DATETIME NULL | |
836
+ | updated_at | DATETIME NULL | |
837
+
838
+ Indexes:
839
+
840
+ - group_id
841
+ - term_id
842
+ - object_id
843
+
844
+ ## fct_label_relationships Table
845
+
846
+ This table stores polymorphic relationships between labels and objects
847
+
848
+ | Column | Type | Comment |
849
+ | --- | --- | --- |
850
+ | id | BIGINT UNSIGNED *Auto Increment* | Primary key |
851
+ | label_id | BIGINT(20) NOT NULL | Reference to label |
852
+ | labelable_id | BIGINT(20) NOT NULL | Related object ID |
853
+ | labelable_type | VARCHAR(192) NOT NULL | Object type |
854
+ | created_at | DATETIME NULL | |
855
+ | updated_at | DATETIME NULL | |
856
+
857
+ Indexes:
858
+
859
+ - label_id
860
+ - labelable_id
861
+
862
+ ## Pro Plugin Tables
863
+
864
+ ### fct_licenses Table
865
+
866
+ Software licences issued for a purchase (Pro).
867
+
868
+ | Column | Type | Comment |
869
+ | --- | --- | --- |
870
+ | id | BIGINT UNSIGNED *Auto Increment* | |
871
+ | status | VARCHAR(45) NULL DEFAULT 'active' | active, inactive, expired, disabled |
872
+ | limit | BIGINT(20) UNSIGNED NOT NULL DEFAULT 0 | Activation limit |
873
+ | activation_count | BIGINT(20) UNSIGNED NOT NULL DEFAULT 0 | Current activations |
874
+ | license_key | VARCHAR(192) NULL | Licence key |
875
+ | product_id | BIGINT(20) UNSIGNED NOT NULL | WordPress post ID of the product |
876
+ | variation_id | BIGINT(20) UNSIGNED NOT NULL | Variation the licence was issued for |
877
+ | order_id | BIGINT(20) UNSIGNED NOT NULL | Order the licence came from |
878
+ | parent_id | BIGINT(20) UNSIGNED NULL | Parent licence, for upgrades and renewals |
879
+ | customer_id | BIGINT(20) UNSIGNED NOT NULL | Licence owner |
880
+ | expiration_date | DATETIME NULL | `NULL` means lifetime |
881
+ | last_reminder_sent | DATETIME NULL | When the last expiry reminder went out |
882
+ | last_reminder_type | VARCHAR(50) NULL | Which reminder stage was sent |
883
+ | subscription_id | BIGINT(20) UNSIGNED NOT NULL DEFAULT 0 | Linked subscription, `0` when none |
884
+ | config | json NULL | Extra licence configuration |
885
+ | created_at | TIMESTAMP NULL | |
886
+ | updated_at | TIMESTAMP NULL | |
887
+
888
+ Indexes:
889
+
890
+ - order_id
891
+ - license_key
892
+ - product_id
893
+ - customer_id (`idx_licenses_customer_recovery`)
894
+
895
+ ### fct_license_activations Table
896
+
897
+ One row per site a licence is activated on (Pro). This table carries both `license_id` and `site_id`, so it is the join between licences and sites.
898
+
899
+ | Column | Type | Comment |
900
+ | --- | --- | --- |
901
+ | id | BIGINT UNSIGNED *Auto Increment* | |
902
+ | site_id | BIGINT(20) UNSIGNED NOT NULL | Reference to fct_license_sites |
903
+ | license_id | BIGINT(20) UNSIGNED NOT NULL | Reference to fct_licenses |
904
+ | status | VARCHAR(45) NULL DEFAULT 'active' | Activation status |
905
+ | is_local | TINYINT NULL DEFAULT 0 | Local or staging install |
906
+ | product_id | BIGINT(20) UNSIGNED NOT NULL | Product |
907
+ | variation_id | BIGINT(20) UNSIGNED NOT NULL | Variation |
908
+ | activation_method | VARCHAR(45) NULL DEFAULT 'key_based' | How the site activated |
909
+ | activation_hash | VARCHAR(99) NULL | Activation hash |
910
+ | last_update_version | VARCHAR(45) NULL | Version at the last update check |
911
+ | last_update_date | DATETIME NULL | Last update check |
912
+ | created_at | TIMESTAMP NULL | |
913
+ | updated_at | TIMESTAMP NULL | |
914
+
915
+ Indexes:
916
+
917
+ - license_id
918
+ - site_id
919
+
920
+ ### fct_license_sites Table
921
+
922
+ The sites themselves (Pro). Join through `fct_license_activations` to reach a licence's sites.
923
+
924
+ | Column | Type | Comment |
925
+ | --- | --- | --- |
926
+ | id | BIGINT UNSIGNED *Auto Increment* | |
927
+ | site_url | VARCHAR(192) NULL | Site URL |
928
+ | server_version | VARCHAR(50) NULL | Server software version |
929
+ | platform_version | VARCHAR(50) NULL | WordPress version |
930
+ | other | JSON NULL | Additional site data |
931
+ | created_at | TIMESTAMP NULL | |
932
+ | updated_at | TIMESTAMP NULL | |
933
+
934
+ Indexes:
935
+
936
+ - site_url
937
+
938
+ ### fct_license_meta Table
939
+
940
+ This table stores license metadata (Pro feature)
941
+
942
+ | Column | Type | Comment |
943
+ | --- | --- | --- |
944
+ | id | BIGINT UNSIGNED AUTO_INCREMENT, PRIMARY KEY | |
945
+ | object_id | BIGINT UNSIGNED NULL DEFAULT NULL | Reference to object (license/activation/site) |
946
+ | object_type | VARCHAR(100) NULL DEFAULT NULL | Can be: license / activation / site |
947
+ | meta_key | VARCHAR(255) NULL DEFAULT NULL | Meta key |
948
+ | meta_value | LONGTEXT NULL DEFAULT NULL | Meta value (JSON or string) |
949
+ | created_at | TIMESTAMP NULL | |
950
+ | updated_at | TIMESTAMP NULL | |
951
+
952
+ Indexes:
953
+
954
+ - meta_key
955
+ - object_type
956
+ - object_id
957
+
958
+ ### fct_order_promotions Table
959
+
960
+ This table stores order promotion data (Pro feature)
961
+
962
+ | Column | Type | Comment |
963
+ | --- | --- | --- |
964
+ | id | BIGINT(20) UNSIGNED AUTO_INCREMENT, PRIMARY KEY | |
965
+ | hash | VARCHAR(100) NOT NULL | |
966
+ | parent_id | BIGINT(20) UNSIGNED NULL | |
967
+ | type | VARCHAR(50) NOT NULL | |
968
+ | status | VARCHAR(50) NOT NULL DEFAULT 'draft' | |
969
+ | src_object_id | BIGINT(20) UNSIGNED NULL | |
970
+ | src_object_type | VARCHAR(50) DEFAULT NULL | |
971
+ | title | VARCHAR(194) DEFAULT NULL | |
972
+ | description | TEXT DEFAULT NULL | |
973
+ | conditions | JSON DEFAULT NULL | |
974
+ | config | JSON DEFAULT NULL | |
975
+ | priority | INT NOT NULL DEFAULT 1 | |
976
+ | created_at | DATETIME NULL | |
977
+ | updated_at | DATETIME NULL | |
978
+
979
+ Indexes:
980
+
981
+ - (type, status, src_object_id, src_object_type)
982
+
983
+ ### fct_order_promotion_stats Table
984
+
985
+ This table stores promotion statistics (Pro feature)
986
+
987
+ | Column | Type | Comment |
988
+ | --- | --- | --- |
989
+ | id | BIGINT(20) UNSIGNED AUTO_INCREMENT, PRIMARY KEY | |
990
+ | promotion_id | BIGINT(20) UNSIGNED NOT NULL | |
991
+ | order_id | BIGINT(20) UNSIGNED NOT NULL | |
992
+ | object_id | BIGINT(20) UNSIGNED NOT NULL | |
993
+ | amount | BIGINT NOT NULL DEFAULT '0' | |
994
+ | status | VARCHAR(50) NOT NULL DEFAULT 'offered' | |
995
+ | created_at | DATETIME NULL | |
996
+ | updated_at | DATETIME NULL | |
997
+
998
+ Indexes:
999
+
1000
+ - (promotion_id, object_id, order_id)
1001
+
1002
+ ---