ojamoto_models 1.0.0

package/migrations/2026000010-create-user-roles.js

@@ -0,0 +1,48 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("user_roles", {
+      user_role_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      user_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      role_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "roles", key: "role_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("user_roles", ["user_id"]);
+    await queryInterface.addIndex("user_roles", ["role_id"]);
+    // Prevents assigning the same role to the same user twice
+    await queryInterface.addIndex("user_roles", ["user_id", "role_id"], {
+      unique: true,
+      name: "user_roles_user_id_role_id_unique",
+    });
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("user_roles");
+  },
+};

package/migrations/2026000011-create-sessions.js

@@ -0,0 +1,61 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("sessions", {
+      session_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      user_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      device_id: {
+        type: Sequelize.INTEGER,
+        allowNull: true,
+        references: { model: "devices", key: "device_id" },
+        onDelete: "SET NULL",
+        onUpdate: "CASCADE",
+      },
+      refresh_token: {
+        type: Sequelize.TEXT,
+        allowNull: false,
+        comment: "Hashed before storage",
+      },
+      expires_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        comment: "7 days from issuance",
+      },
+      revoked: {
+        type: Sequelize.BOOLEAN,
+        allowNull: false,
+        defaultValue: false,
+        comment: "Set true on logout",
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("sessions", ["user_id"]);
+    await queryInterface.addIndex("sessions", ["device_id"]);
+    // Speeds up the lookup in refreshToken/logout controllers
+    await queryInterface.addIndex("sessions", [
+      "user_id",
+      "device_id",
+      "revoked",
+    ]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("sessions");
+  },
+};

package/migrations/2026000012-create-escrows.js

@@ -0,0 +1,80 @@
+"use strict";
+
+const { ESCROW_STATUS } = require("../services/constants");
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("escrows", {
+      escrow_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      buyer_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+      },
+      seller_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+      },
+      product_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "products", key: "product_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+      },
+      amount: {
+        type: Sequelize.DECIMAL(15, 2),
+        allowNull: false,
+        comment: "Agreed transaction value",
+      },
+      platform_fee: {
+        type: Sequelize.DECIMAL(15, 2),
+        allowNull: false,
+        defaultValue: 0.0,
+        comment: "AutoParts NG escrow fee",
+      },
+      currency: {
+        type: Sequelize.STRING(3),
+        allowNull: false,
+        defaultValue: "NGN",
+      },
+      status: {
+        type: Sequelize.ENUM(...Object.values(ESCROW_STATUS)),
+        allowNull: false,
+        defaultValue: ESCROW_STATUS.PENDING,
+      },
+      delivery_deadline: {
+        type: Sequelize.DATEONLY,
+        allowNull: true,
+        comment: "Auto-release trigger date if buyer does not confirm",
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("escrows", ["buyer_id"]);
+    await queryInterface.addIndex("escrows", ["seller_id"]);
+    await queryInterface.addIndex("escrows", ["product_id"]);
+    await queryInterface.addIndex("escrows", ["status"]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("escrows");
+  },
+};

package/migrations/2026000013-create-wallet-transactions.js

@@ -0,0 +1,70 @@
+"use strict";
+
+const {
+  WALLET_TRANSACTION_TYPE,
+  WALLET_TRANSACTION_STATUS,
+} = require("../services/constants");
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("wallet_transactions", {
+      wallet_transaction_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      wallet_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "wallets", key: "wallet_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      user_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+        comment: "Denormalized for quick queries",
+      },
+      type: {
+        type: Sequelize.ENUM(...Object.values(WALLET_TRANSACTION_TYPE)),
+        allowNull: false,
+      },
+      amount: {
+        type: Sequelize.DECIMAL(15, 2),
+        allowNull: false,
+      },
+      currency: {
+        type: Sequelize.STRING(3),
+        allowNull: false,
+        defaultValue: "NGN",
+      },
+      reference: {
+        type: Sequelize.STRING(100),
+        allowNull: false,
+        unique: true,
+        comment: "Flutterwave ref or internal reference",
+      },
+      status: {
+        type: Sequelize.ENUM(...Object.values(WALLET_TRANSACTION_STATUS)),
+        allowNull: false,
+        defaultValue: WALLET_TRANSACTION_STATUS.PENDING,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("wallet_transactions", ["wallet_id"]);
+    await queryInterface.addIndex("wallet_transactions", ["user_id"]);
+    await queryInterface.addIndex("wallet_transactions", ["status"]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("wallet_transactions");
+  },
+};

package/migrations/2026000014-create-product-images.js

@@ -0,0 +1,43 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("product_images", {
+      product_image_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      product_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "products", key: "product_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      image_url: {
+        type: Sequelize.STRING(500),
+        allowNull: false,
+        comment: "AWS S3 URL",
+      },
+      position: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        defaultValue: 0,
+        comment: "Display order",
+      },
+      ai_metadata: {
+        type: Sequelize.JSON,
+        allowNull: true,
+        comment: "Brand, model, condition extracted by AI analysis",
+      },
+    });
+
+    await queryInterface.addIndex("product_images", ["product_id"]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("product_images");
+  },
+};

package/migrations/2026000015-create-escrow-events.js

@@ -0,0 +1,50 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("escrow_events", {
+      escrow_event_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      escrow_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "escrows", key: "escrow_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      event_type: {
+        type: Sequelize.STRING(100),
+        allowNull: false,
+        comment: "FUNDED | ACCEPTED | DELIVERED | RELEASED etc.",
+      },
+      description: {
+        type: Sequelize.TEXT,
+        allowNull: true,
+        comment: "Human-readable event detail",
+      },
+      created_by: {
+        type: Sequelize.INTEGER,
+        allowNull: true,
+        references: { model: "users", key: "user_id" },
+        onDelete: "SET NULL",
+        onUpdate: "CASCADE",
+        comment: "User or system actor (null = system)",
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("escrow_events", ["escrow_id"]);
+    await queryInterface.addIndex("escrow_events", ["created_by"]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("escrow_events");
+  },
+};

package/migrations/2026000016-create-logistics.js

@@ -0,0 +1,55 @@
+"use strict";
+
+const { LOGISTICS_STATUS } = require("../services/constants");
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("logistics", {
+      logistics_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      escrow_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        unique: true,
+        references: { model: "escrows", key: "escrow_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+      },
+      provider: {
+        type: Sequelize.STRING(100),
+        allowNull: false,
+        comment: "GIG | DHL | FedEx",
+      },
+      tracking_number: {
+        type: Sequelize.STRING(100),
+        allowNull: false,
+      },
+      status: {
+        type: Sequelize.ENUM(...Object.values(LOGISTICS_STATUS)),
+        allowNull: false,
+        defaultValue: LOGISTICS_STATUS.SHIPPED,
+      },
+      delivery_proof_url: {
+        type: Sequelize.STRING(500),
+        allowNull: true,
+        comment: "AWS S3 URL — photo or waybill",
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("logistics");
+  },
+};

package/migrations/2026000017-create-ratings.js

@@ -0,0 +1,56 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("ratings", {
+      rating_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      escrow_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        unique: true,
+        references: { model: "escrows", key: "escrow_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+        comment: "One rating per completed escrow",
+      },
+      buyer_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+      },
+      seller_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+      },
+      rating: {
+        type: Sequelize.TINYINT,
+        allowNull: false,
+      },
+      comment: {
+        type: Sequelize.TEXT,
+        allowNull: true,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("ratings", ["buyer_id"]);
+    await queryInterface.addIndex("ratings", ["seller_id"]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("ratings");
+  },
+};

package/migrations/2026000018-create-disputes.js

@@ -0,0 +1,84 @@
+"use strict";
+
+const {
+  DISPUTE_REASON,
+  DISPUTE_STATUS,
+  DISPUTE_RESOLUTION,
+} = require("../services/constants");
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("disputes", {
+      dispute_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      escrow_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "escrows", key: "escrow_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+      },
+      opened_by: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+        comment: "Buyer or seller who opened the dispute",
+      },
+      reason: {
+        type: Sequelize.ENUM(...Object.values(DISPUTE_REASON)),
+        allowNull: false,
+      },
+      description: {
+        type: Sequelize.TEXT,
+        allowNull: false,
+        comment: "Buyer/seller's initial explanation when opening the dispute",
+      },
+      assigned_admin: {
+        type: Sequelize.INTEGER,
+        allowNull: true,
+        references: { model: "admin_users", key: "admin_id" },
+        onDelete: "SET NULL",
+        onUpdate: "CASCADE",
+        comment: "NULL until assigned by super admin",
+      },
+      status: {
+        type: Sequelize.ENUM(...Object.values(DISPUTE_STATUS)),
+        allowNull: false,
+        defaultValue: DISPUTE_STATUS.OPEN,
+      },
+      resolution: {
+        type: Sequelize.ENUM(...Object.values(DISPUTE_RESOLUTION)),
+        allowNull: true,
+        defaultValue: null,
+      },
+      resolution_note: {
+        type: Sequelize.TEXT,
+        allowNull: true,
+        comment: "Admin explanation of decision",
+      },
+      resolved_at: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("disputes", ["escrow_id"]);
+    await queryInterface.addIndex("disputes", ["opened_by"]);
+    await queryInterface.addIndex("disputes", ["assigned_admin"]);
+    await queryInterface.addIndex("disputes", ["status"]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("disputes");
+  },
+};

package/migrations/2026000019-create-dispute-evidence.js

@@ -0,0 +1,50 @@
+"use strict";
+
+const { EVIDENCE_FILE_TYPE } = require("../services/constants");
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("dispute_evidence", {
+      dispute_evidence_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      dispute_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "disputes", key: "dispute_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      uploaded_by: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+      },
+      file_url: {
+        type: Sequelize.STRING(500),
+        allowNull: false,
+        comment: "AWS S3 URL",
+      },
+      file_type: {
+        type: Sequelize.ENUM(...Object.values(EVIDENCE_FILE_TYPE)),
+        allowNull: false,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("dispute_evidence", ["dispute_id"]);
+    await queryInterface.addIndex("dispute_evidence", ["uploaded_by"]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("dispute_evidence");
+  },
+};

package/migrations/2026000020-create-dispute-messages.js

@@ -0,0 +1,44 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("dispute_messages", {
+      dispute_message_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      dispute_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "disputes", key: "dispute_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      sender_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+        comment: "Buyer or seller user id",
+      },
+      message: {
+        type: Sequelize.TEXT,
+        allowNull: false,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("dispute_messages", ["dispute_id"]);
+    await queryInterface.addIndex("dispute_messages", ["sender_id"]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("dispute_messages");
+  },
+};

package/migrations/2026000021-create-notifications.js

@@ -0,0 +1,50 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("notifications", {
+      notification_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      user_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      type: {
+        type: Sequelize.STRING(100),
+        allowNull: false,
+        comment: "ESCROW_FUNDED | PAYMENT_RELEASED | DISPUTE_OPENED etc.",
+      },
+      title: {
+        type: Sequelize.STRING(255),
+        allowNull: false,
+      },
+      message: {
+        type: Sequelize.TEXT,
+        allowNull: false,
+      },
+      read_status: {
+        type: Sequelize.BOOLEAN,
+        allowNull: false,
+        defaultValue: false,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("notifications", ["user_id"]);
+    await queryInterface.addIndex("notifications", ["user_id", "read_status"]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("notifications");
+  },
+};