自采联营门店系统开发

README.md

@@ -88,8 +88,9 @@ mvn spring-boot:run
 
 ## 数据库
 
-- **脚本位置**：`src/main/resources/db/mysql-item-sync.sql`  
-- **主要表**：`item_sync_log`（任务汇总）、`item_sync_snapshot`（条码快照/变更跳过）、`item_sync_detail`（单次明细）、`item_sync_cache`（旧版 MD5 缓存，可不用）、`lemeng_oauth_token`（Token 持久化）  
+- **脚本位置**：`src/main/resources/db/mysql-item-sync.sql`；已有旧库增量对齐见 `mysql-item-sync-upgrade.sql`  
+- **主要表**：`item_sync_log`（任务汇总）、`item_sync_snapshot`（条码快照/变更跳过）、`item_sync_detail`（单次明细）、`lemeng_oauth_token`（Token 持久化）  
+- **已废弃**：旧表 `item_sync_cache`（MD5 缓存）已不再使用；若库中仍存在可执行 `mysql-drop-item-sync-cache.sql` 删除  
 - 本地 H2 可使用 `ddl-auto=update` 自动建表；MySQL 建议执行上述脚本或由 Hibernate 按策略创建（以运维规范为准）。
 
 ---

src/main/java/cn/nhsoft/hanni/item/model/ItemSyncCache.java

-package cn.nhsoft.hanni.item.model;
-
-import javax.persistence.*;
-import java.util.Date;
-
-/**
- * 商品同步缓存，用于变更检测
- */
-@Entity
-@Table(name = "item_sync_cache", indexes = {@Index(columnList = "barcode")})
-public class ItemSyncCache {
-
-    @Id
-    @GeneratedValue(strategy = GenerationType.IDENTITY)
-    private Long id;
-
-    @Column(name = "barcode", length = 64, unique = true)
-    private String barcode;
-
-    @Column(name = "content_hash", length = 64)
-    private String contentHash;
-
-    @Column(name = "update_time")
-    @Temporal(TemporalType.TIMESTAMP)
-    private Date updateTime;
-
-    @PrePersist
-    @PreUpdate
-    public void prePersist() {
-        if (updateTime == null) {
-            updateTime = new Date();
-        }
-    }
-
-    public Long getId() { return id; }
-    public void setId(Long id) { this.id = id; }
-    public String getBarcode() { return barcode; }
-    public void setBarcode(String barcode) { this.barcode = barcode; }
-    public String getContentHash() { return contentHash; }
-    public void setContentHash(String contentHash) { this.contentHash = contentHash; }
-    public Date getUpdateTime() { return updateTime; }
-    public void setUpdateTime(Date updateTime) { this.updateTime = updateTime; }
-}

src/main/java/cn/nhsoft/hanni/item/repository/ItemSyncCacheRepository.java

-package cn.nhsoft.hanni.item.repository;
-
-import cn.nhsoft.hanni.item.model.ItemSyncCache;
-import org.springframework.data.jpa.repository.JpaRepository;
-
-import java.util.List;
-import java.util.Optional;
-
-public interface ItemSyncCacheRepository extends JpaRepository<ItemSyncCache, Long> {
-
-    Optional<ItemSyncCache> findByBarcode(String barcode);
-
-    List<ItemSyncCache> findByBarcodeIn(List<String> barcodes);
-}

src/main/resources/db/mysql-item-sync.sql

 -- 汉尼外部 API 相关表（MySQL 8+， utf8mb4）
 -- 含：商品同步、乐檬 OAuth Token 持久化
 -- 执行前请替换库名： USE your_database;
+--
+-- 若库中已有旧表、仅需增量对齐字段/索引，请使用： mysql-item-sync-upgrade.sql
 
 SET NAMES utf8mb4;
 
@@ -69,19 +71,6 @@ CREATE TABLE IF NOT EXISTS `item_sync_detail` (
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='同步任务商品明细';
 
 -- ----------------------------
--- 旧版 MD5 变更缓存（当前逻辑已改用 snapshot，可不再使用；历史数据可保留）
--- ----------------------------
-CREATE TABLE IF NOT EXISTS `item_sync_cache` (
-    `id`           BIGINT       NOT NULL AUTO_INCREMENT,
-    `barcode`      VARCHAR(64)  NOT NULL,
-    `content_hash` VARCHAR(64)           DEFAULT NULL,
-    `update_time`  DATETIME(3)           DEFAULT NULL,
-    PRIMARY KEY (`id`),
-    UNIQUE KEY `uk_item_sync_cache_barcode` (`barcode`),
-    KEY `idx_item_sync_cache_barcode` (`barcode`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='商品同步缓存(旧)';
-
--- ----------------------------
 -- 乐檬 OAuth Token 持久化（与 JPA 实体 LemengOAuthToken 对应；服务重启从库加载）
 -- ----------------------------
 CREATE TABLE IF NOT EXISTS `lemeng_oauth_token` (