'use strict'; /** * 对外 OpenAPI 请求幂等表。 * * 外部系统(WMS)回调可能因超时重试,同一请求不应重复执行: * - 以 (app_key, method, request_id) 唯一; * - request_hash 记录 method + app_key + 请求报文摘要,防止同一 request_id 搭配不同报文; * - status:0 处理中 / 1 成功 / 2 失败;处理完成后 response_body 保存完整响应, * 重试时直接回放原响应(含逐单成功/失败结果)。 * * 与 callback_logs 的区别:callback_logs 是异步、截断的排查日志;本表是可回放的幂等凭据。 */ module.exports = { async up(queryInterface, Sequelize) { await queryInterface.createTable('openapi_request_idempotency', { id: { type: Sequelize.BIGINT.UNSIGNED, primaryKey: true, autoIncrement: true, comment: '主键', }, app_key: { type: Sequelize.STRING(100), allowNull: false, comment: '请求携带的 app_key', }, method: { type: Sequelize.STRING(100), allowNull: false, comment: 'OpenAPI 方法名(模块.动作)', }, request_id: { type: Sequelize.STRING(100), allowNull: false, comment: '调用方请求ID(query request_id / header X-Request-Id / body requestId)', }, request_hash: { type: Sequelize.STRING(64), allowNull: false, comment: 'method + app_key + 请求报文摘要,防止同一 request_id 复用不同报文', }, principal_id: { type: Sequelize.BIGINT.UNSIGNED, allowNull: true, comment: '按 app_key 定位到的主体ID', }, warehouse_id: { type: Sequelize.BIGINT.UNSIGNED, allowNull: true, comment: '按 app_key 定位到的仓库ID', }, status: { type: Sequelize.TINYINT, allowNull: false, defaultValue: 0, comment: '状态:0处理中 1成功 2失败', }, http_status: { type: Sequelize.INTEGER, allowNull: true, comment: '响应 HTTP 状态码', }, response_body: { type: Sequelize.TEXT('medium'), allowNull: true, comment: '完整响应报文(重试时原样回放)', }, created_at: { type: Sequelize.DATE, allowNull: true, comment: '创建时间' }, updated_at: { type: Sequelize.DATE, allowNull: true, comment: '更新时间' }, }); await queryInterface.addIndex('openapi_request_idempotency', [ 'app_key', 'method', 'request_id' ], { name: 'uk_openapi_request_id', unique: true, }); await queryInterface.addIndex('openapi_request_idempotency', [ 'created_at' ], { name: 'idx_openapi_request_created', }); }, async down(queryInterface) { await queryInterface.removeIndex('openapi_request_idempotency', 'idx_openapi_request_created'); await queryInterface.removeIndex('openapi_request_idempotency', 'uk_openapi_request_id'); await queryInterface.dropTable('openapi_request_idempotency'); }, };