tt-entities 0.0.55 → 0.1.0

package/dist/libs/tatayab-entities-library/entities/refund.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"refund.entity.js","sourceRoot":"","sources":["../../../../libs/tatayab-entities-library/src/entities/refund.entity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"refund.entity.js","sourceRoot":"","sources":["../../../../libs/tatayab-entities-library/src/entities/refund.entity.ts"],"names":[],"mappings":"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"}

package/libs/tatayab-entities-library/src/entities/order-edit-item.entity.ts

@@ -0,0 +1,101 @@
+import {
+  Table,
+  Column,
+  Model,
+  ForeignKey,
+  BelongsTo,
+  DataType,
+} from 'sequelize-typescript';
+import { OrderEditSession } from './order-edit-session.entity';
+import { OrderItem, OrderItemType } from './order-item.entity';
+import { Product } from './product.entity';
+import { ProductVariant } from './product-variant.entity';
+import { Bundle } from './bundle.entity';
+
+/**
+ * OrderEditItem — Edit Order feature.
+ *
+ * Working-copy basket line for an OrderEditSession. Seeded 1:1 from the
+ * order's current OrderItems when a session is opened (sourceOrderItemId
+ * set), then mutated freely (add/remove/change quantity) without touching
+ * the live OrderItems. On confirm, diffed against OrderItems and applied —
+ * see OrderEditController::replaceOrderItems / reconcileStock in
+ * tatayab-dashboard.
+ *
+ * Mirrors OrderItem's shape closely (itemType/productId/productVariantId/
+ * bundleId/composedSku/quantity/unitPrice/lineTotal) so the diff is a
+ * straightforward field-by-field comparison. bundleSelectionsJson mirrors
+ * OrderItemBundleSelection rows for itemType=bundle lines.
+ */
+@Table
+export class OrderEditItem extends Model {
+  @ForeignKey(() => OrderEditSession)
+  @Column({ allowNull: false })
+  declare sessionId: number;
+
+  @Column({
+    type: DataType.ENUM(...Object.values(OrderItemType)),
+    allowNull: false,
+    defaultValue: OrderItemType.PRODUCT,
+  })
+  declare itemType: OrderItemType;
+
+  // ── Product fields ────────────────────────────────────────────────────────────
+  @ForeignKey(() => Product)
+  @Column({ allowNull: true })
+  declare productId?: number;
+
+  @ForeignKey(() => ProductVariant)
+  @Column({ allowNull: true })
+  declare productVariantId?: number;
+
+  // ── Bundle fields ─────────────────────────────────────────────────────────────
+  @ForeignKey(() => Bundle)
+  @Column({ allowNull: true })
+  declare bundleId?: number;
+
+  @Column({ allowNull: true })
+  declare composedSku?: string;
+
+  // ── Pricing ───────────────────────────────────────────────────────────────────
+  @Column({ allowNull: false, defaultValue: 1 })
+  declare quantity: number;
+
+  @Column({ type: DataType.DECIMAL(10, 3), allowNull: false })
+  declare unitPrice: number;
+
+  @Column({ type: DataType.DECIMAL(10, 3), allowNull: false })
+  declare lineTotal: number;
+
+  // ── Diff anchor ───────────────────────────────────────────────────────────────
+  // Set when this line corresponds to an existing OrderItem (possibly with a
+  // changed quantity). Null if this line was newly added during this edit.
+  // On confirm: present -> update that OrderItem in place (preserving id);
+  // absent -> create a new OrderItem.
+  @ForeignKey(() => OrderItem)
+  @Column({ allowNull: true })
+  declare sourceOrderItemId?: number;
+
+  // Array of {productId, productVariantId, productNameEn, productNameAr,
+  // variantLabelEn, variantLabelAr, sortOrder} — same shape as
+  // OrderItemBundleSelection rows. Only set for itemType=bundle.
+  @Column({ type: DataType.JSON, allowNull: true })
+  declare bundleSelectionsJson?: object;
+
+  // ── Associations ──────────────────────────────────────────────────────────────
+
+  @BelongsTo(() => OrderEditSession)
+  declare session: OrderEditSession;
+
+  @BelongsTo(() => OrderItem, { foreignKey: 'sourceOrderItemId' })
+  declare sourceOrderItem?: OrderItem;
+
+  @BelongsTo(() => Product)
+  declare product?: Product;
+
+  @BelongsTo(() => ProductVariant)
+  declare variant?: ProductVariant;
+
+  @BelongsTo(() => Bundle)
+  declare bundle?: Bundle;
+}

package/libs/tatayab-entities-library/src/entities/order-edit-session.entity.ts

@@ -0,0 +1,47 @@
+import {
+  Table,
+  Column,
+  Model,
+  ForeignKey,
+  BelongsTo,
+  HasMany,
+  DataType,
+} from 'sequelize-typescript';
+import { Order } from './order.entity';
+import { OrderEditItem } from './order-edit-item.entity';
+
+/**
+ * OrderEditSession — Edit Order feature.
+ *
+ * An in-progress edit lock on an Order. One active (non-expired) session
+ * per order — a second admin opening "Edit Order" while one exists sees a
+ * "currently being edited by X" warning with a takeover option. Cancel =
+ * delete this row (cascades to its OrderEditItems) — zero impact on the
+ * live order. Confirm = applies the edit in a transaction (see
+ * OrderEditController::confirm in tatayab-dashboard) then deletes this row.
+ *
+ * expiresAt = createdAt + 2 hours (SESSION_LIFETIME_MINUTES in
+ * OrderEditController). Expired sessions are treated as gone and silently
+ * replaced on the next "Edit Order" click.
+ */
+@Table
+export class OrderEditSession extends Model {
+  @ForeignKey(() => Order)
+  @Column({ allowNull: false })
+  declare orderId: number;
+
+  // e.g. "admin:42" — the admin who opened this session.
+  @Column({ allowNull: false })
+  declare createdBy: string;
+
+  @Column({ type: DataType.DATE, allowNull: false })
+  declare expiresAt: Date;
+
+  // ── Associations ──────────────────────────────────────────────────────────────
+
+  @BelongsTo(() => Order)
+  declare order: Order;
+
+  @HasMany(() => OrderEditItem)
+  declare items: OrderEditItem[];
+}

package/libs/tatayab-entities-library/src/entities/order-item-change-log.entity.ts

@@ -0,0 +1,84 @@
+import {
+  Table,
+  Column,
+  Model,
+  ForeignKey,
+  BelongsTo,
+  HasOne,
+  DataType,
+} from 'sequelize-typescript';
+import { Order } from './order.entity';
+import { Refund } from './refund.entity';
+import { OrderPayment } from './order-payment.entity';
+
+export enum OrderEditScenario {
+  SAME = 'same',
+  REFUND = 'refund',
+  ADDITIONAL_PAYMENT = 'additional_payment',
+}
+
+/**
+ * OrderItemChangeLog — Edit Order feature, rule 2 (full historical
+ * basket-change log).
+ *
+ * One row PER CONFIRMED EDIT (not per item) — editNumber is sequential per
+ * order (1, 2, 3...). beforeItemsJson/afterItemsJson are full snapshots of
+ * the basket immediately before/after this edit, so the "Edit History" tab
+ * on Order Detail never needs to re-resolve product names for old entries
+ * even if a product is later renamed or deleted.
+ *
+ * priceDelta = newTotal - oldTotal (positive = customer owes more, negative
+ * = refund issued, ~zero = no payment change). scenario determines which of
+ * refund/additionalPayment (below) is populated, if either.
+ */
+@Table
+export class OrderItemChangeLog extends Model {
+  @ForeignKey(() => Order)
+  @Column({ allowNull: false })
+  declare orderId: number;
+
+  // Sequential per order: 1, 2, 3... — the Nth confirmed edit on this order.
+  @Column({ allowNull: false })
+  declare editNumber: number;
+
+  // Snapshot of the basket immediately BEFORE this edit was applied.
+  @Column({ type: DataType.JSON, allowNull: false })
+  declare beforeItemsJson: object;
+
+  // Snapshot of the basket immediately AFTER this edit was applied.
+  @Column({ type: DataType.JSON, allowNull: false })
+  declare afterItemsJson: object;
+
+  // Pre-rendered human-readable diff, e.g.
+  // "Invictus: 2 -> 1, Champion: 0 -> 1 (+1)". Computed once at confirm-time.
+  @Column({ type: DataType.TEXT, allowNull: false })
+  declare summary: string;
+
+  @Column({ type: DataType.DECIMAL(10, 3), allowNull: false, defaultValue: 0 })
+  declare priceDelta: number;
+
+  @Column({
+    type: DataType.ENUM(...Object.values(OrderEditScenario)),
+    allowNull: false,
+  })
+  declare scenario: OrderEditScenario;
+
+  // e.g. "admin:42"
+  @Column({ allowNull: false })
+  declare changedBy: string;
+
+  // ── Associations ──────────────────────────────────────────────────────────────
+
+  @BelongsTo(() => Order)
+  declare order: Order;
+
+  // Set only when scenario = 'refund' (and not a COD adjustment) — the
+  // refund this edit produced.
+  @HasOne(() => Refund, { foreignKey: 'editLogId' })
+  declare refund?: Refund;
+
+  // Set only when scenario = 'additional_payment' (and not a COD
+  // adjustment) — the OrderPayments top-up this edit produced.
+  @HasOne(() => OrderPayment, { foreignKey: 'editLogId' })
+  declare additionalPayment?: OrderPayment;
+}

package/libs/tatayab-entities-library/src/entities/order-item.entity.ts

@@ -110,6 +110,11 @@ export class OrderItem extends Model {
   })
   declare fulfillmentStatus: OrderItemFulfillmentStatus;
 
+  // How many units have been physically received from vendor POs so far.
+  // When fulfilledQuantity >= quantity, the item is fully sourced.
+  @Column({ defaultValue: 0 })
+  declare fulfilledQuantity: number;
+
   // ── Associations ──────────────────────────────────────────────────────────────
 
   @BelongsTo(() => Order)

package/libs/tatayab-entities-library/src/entities/order-payment.entity.ts

@@ -0,0 +1,107 @@
+import {
+  Table,
+  Column,
+  Model,
+  ForeignKey,
+  BelongsTo,
+  DataType,
+} from 'sequelize-typescript';
+import { Order } from './order.entity';
+import { OrderItemChangeLog } from './order-item-change-log.entity';
+
+export enum OrderPaymentType {
+  ONLINE = 'online',
+  OFFLINE = 'offline',
+}
+
+export enum OrderPaymentStatus {
+  PENDING = 'pending',
+  PAID = 'paid',
+  FAILED = 'failed',
+  CANCELLED = 'cancelled',
+}
+
+/**
+ * OrderPayment — Edit Order feature, rule 3c (additional payments beyond
+ * the original).
+ *
+ * The ORIGINAL payment stays in Orders.paymentMethodSlug/paymentStatus/
+ * paymentReference/paidAt exactly as today — implicitly "sequence 0" and
+ * NEVER has a row here. Each edit that raises the order total and requires
+ * an extra payment gets its own row with sequence >= 1, in order
+ * (UNIQUE(orderId, sequence)). A never-edited order has zero rows.
+ *
+ * Multiple edits over an order's lifetime each get their own sequence —
+ * Order Detail's Payment tab renders the original payment plus
+ * order.additionalPayments[] (this table, ordered by sequence), so "two (or
+ * N) payment methods on one order" scales naturally.
+ *
+ * sequence is also used as:
+ *  - the gateway-facing reference suffix "-P{sequence}" (each top-up is a
+ *    distinct transaction on the gateway's side — see
+ *    *PaymentService::buildOrderInput()'s $sequence param)
+ *  - the trailing /{sequence} path segment in the unified payment-result
+ *    URL (AbstractPaymentGatewayService::paymentResultUrl()), so
+ *    PaymentResultController knows which row to display/update.
+ *
+ * For an offline payment method (e.g. cash), confirm() marks this row
+ * status='paid'/type='offline'/paidAt=now() immediately — no link is
+ * generated. For an online method, status starts 'pending' and a checkout
+ * link is generated post-commit (paymentLinkToken set on success).
+ */
+@Table
+export class OrderPayment extends Model {
+  @ForeignKey(() => Order)
+  @Column({ allowNull: false })
+  declare orderId: number;
+
+  // The edit that created this top-up requirement.
+  @ForeignKey(() => OrderItemChangeLog)
+  @Column({ allowNull: true })
+  declare editLogId?: number;
+
+  // 1, 2, 3... per order — the Nth additional payment.
+  @Column({ allowNull: false })
+  declare sequence: number;
+
+  @Column({ type: DataType.DECIMAL(10, 3), allowNull: false })
+  declare amount: number;
+
+  @Column({ allowNull: false })
+  declare currency: string;
+
+  @Column({ allowNull: false })
+  declare paymentMethodSlug: string;
+
+  @Column({
+    type: DataType.ENUM(...Object.values(OrderPaymentType)),
+    allowNull: false,
+  })
+  declare type: OrderPaymentType;
+
+  @Column({
+    type: DataType.ENUM(...Object.values(OrderPaymentStatus)),
+    allowNull: false,
+    defaultValue: OrderPaymentStatus.PENDING,
+  })
+  declare status: OrderPaymentStatus;
+
+  // Gateway transaction ID (online) or manual reference (offline).
+  @Column({ allowNull: true })
+  declare paymentReference?: string;
+
+  // Token used in the unified payment-result URL for this top-up.
+  @Column({ allowNull: true })
+  declare paymentLinkToken?: string;
+
+  @Column({ type: DataType.DATE, allowNull: true })
+  declare paidAt?: Date;
+
+  // ── Associations ──────────────────────────────────────────────────────────────
+
+  @BelongsTo(() => Order)
+  declare order: Order;
+
+  @BelongsTo(() => OrderItemChangeLog)
+  declare editLog?: OrderItemChangeLog;
+}

package/libs/tatayab-entities-library/src/entities/order.entity.ts

@@ -14,6 +14,9 @@ import { OrderStatus } from './order-status.entity';
 import { OrderItem } from './order-item.entity';
 import { OrderStatusHistory } from './order-status-history.entity';
 import { UserTransaction } from './user-transaction.entity';
+import { OrderItemChangeLog } from './order-item-change-log.entity';
+import { OrderPayment } from './order-payment.entity';
+import { OrderEditSession } from './order-edit-session.entity';
 
 @Table
 export class Order extends Model {
@@ -159,6 +162,9 @@ export class Order extends Model {
   })
   declare refundStatus: string;
 
+  @Column({ type: DataType.BOOLEAN, defaultValue: false })
+  declare hasEverNeededVendor: boolean;
+
   @Column({ type: DataType.BOOLEAN, defaultValue: false })
   declare cashCollected: boolean;
 
@@ -197,4 +203,13 @@ export class Order extends Model {
 
   @HasMany(() => UserTransaction)
   declare transactions: UserTransaction[];
+
+  @HasMany(() => OrderItemChangeLog)
+  declare changeLogs: OrderItemChangeLog[];
+
+  @HasMany(() => OrderPayment)
+  declare additionalPayments: OrderPayment[];
+
+  @HasMany(() => OrderEditSession)
+  declare editSessions: OrderEditSession[];
 }

package/libs/tatayab-entities-library/src/entities/refund.entity.ts

@@ -9,6 +9,12 @@ import {
 import { Order } from './order.entity';
 import { User } from './user.entity';
 import { SysUser } from './sys.user.entity';
+import { OrderItemChangeLog } from './order-item-change-log.entity';
+
+export enum RefundSource {
+  CANCELLATION = 'cancellation',
+  ORDER_EDIT = 'order_edit',
+}
 
 export enum RefundMethod {
   WALLET = 'wallet',
@@ -55,6 +61,23 @@ export class Refund extends Model {
   @Column({ type: DataType.TEXT, allowNull: true })
   declare notes?: string;
 
+  // Where this refund originated. 'order_edit' refunds are created when an
+  // edit lowers the order total (rule 3b) and the admin chose 'wallet' or
+  // 'bank' as the refund method. Existing cancellation-flow refunds keep the
+  // default 'cancellation' — no backfill needed.
+  @Column({
+    type: DataType.ENUM(...Object.values(RefundSource)),
+    allowNull: false,
+    defaultValue: RefundSource.CANCELLATION,
+  })
+  declare source: RefundSource;
+
+  // Set when source = 'order_edit' — links this refund to the specific edit
+  // that produced it (OrderItemChangeLogs.id). Null for cancellation refunds.
+  @ForeignKey(() => OrderItemChangeLog)
+  @Column({ allowNull: true })
+  declare editLogId?: number;
+
   @Column({ type: DataType.DATE, allowNull: true })
   declare processedAt?: Date;
 
@@ -72,4 +95,6 @@ export class Refund extends Model {
   declare processor?: SysUser;
   @BelongsTo(() => SysUser, { foreignKey: 'createdBy', as: 'creator' })
   declare creator?: SysUser;
+  @BelongsTo(() => OrderItemChangeLog, { foreignKey: 'editLogId' })
+  declare editLog?: OrderItemChangeLog;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tt-entities",
-  "version": "0.0.55",
+  "version": "0.1.0",
   "description": "Tatayab entities library",
   "main": "dist/libs/tatayab-entities-library/index.js",
   "types": "dist/libs/tatayab-entities-library/index.d.ts",

package/src/app.module.ts

@@ -16,8 +16,6 @@ import { getDbModels } from '@app/tatayab-entities-library';
       password: process.env.MYSQL_PASSWORD,
       port: 3306,
       models: getDbModels(),
-      autoLoadModels: true,
-      synchronize: true,
       logging: false,
       define: {
         timestamps: true,

package/src/database/config.js

@@ -5,7 +5,7 @@ module.exports = {
     host: process.env.MYSQL_HOST,
     port: process.env.MYSQL_PORT,
     username: process.env.MYSQL_USER,
-    password: process.env.MYSQL_PASS,
+    password: process.env.MYSQL_PASSWORD,
     database: process.env.MYSQL_DATABASE,
   },
   LOCAL: {
@@ -13,7 +13,7 @@ module.exports = {
     host: process.env.MYSQL_HOST,
     port: process.env.MYSQL_PORT,
     username: process.env.MYSQL_USER,
-    password: process.env.MYSQL_PASS,
+    password: process.env.MYSQL_PASSWORD,
     database: process.env.MYSQL_DATABASE,
   },
   STAGING: {
@@ -21,7 +21,7 @@ module.exports = {
     host: process.env.MYSQL_HOST,
     port: process.env.MYSQL_PORT,
     username: process.env.MYSQL_USER,
-    password: process.env.MYSQL_PASS,
+    password: process.env.MYSQL_PASSWORD,
     database: process.env.MYSQL_DATABASE,
   },
   PRODUCTION: {
@@ -29,7 +29,7 @@ module.exports = {
     host: process.env.MYSQL_HOST,
     port: process.env.MYSQL_PORT,
     username: process.env.MYSQL_USER,
-    password: process.env.MYSQL_PASS,
+    password: process.env.MYSQL_PASSWORD,
     database: process.env.MYSQL_DATABASE,
   },
 };