AGENTS.md

@@ -1,7 +1,7 @@
 # AGENTS.md
 
 适用范围：`D:\AI Code\3danzhuang-wuyongjie-mainline` 全仓库。
-未单独说明时，先遵循当前 agent 自己的全局规则（ZCode：`C:\Users\54972\.zcode\v2\AGENTS.md`；Codex：`C:\Users\54972\.codex\AGENTS.md`）。
+未单独说明时，先遵循全局规则：`C:\Users\54972\.codex\AGENTS.md`。
 这份文件只记录本仓库当前有效的补充规则和核查入口，不保存密码、密钥、数据库连接串或对象存储密钥。
 
 重要边界：`D:\AI Code\3danzhuang` 是历史旧现场；当前正式工作目录以 `D:\AI Code\3danzhuang-wuyongjie-mainline` 为准。除非用户明确要求，不要混用旧目录、旧服务器别名、旧部署脚本或旧截图结论。
@@ -10,7 +10,7 @@
 
 - 外层目录 `D:\AI Code\3danzhuang-wuyongjie-mainline` 是 Git 仓库根目录。
 - 主应用目录是 `furniture-3d-system/`；用户未指定目录时，默认在这里执行代码、测试、构建和脚本。
-- 技术栈以当前 `furniture-3d-system/package.json` 为准（核心：Next.js App Router + React + TypeScript + Prisma/PostgreSQL + Jest + Playwright + Tailwind CSS + Three.js/R3F；另有 ioredis、puppeteer、exceljs/xlsx、zod、zustand 等）。package.json 变动后文档不自动同步，以实时核查为准。
+- 技术栈以当前 `furniture-3d-system/package.json` 为准：Next.js App Router、React、TypeScript、Prisma/PostgreSQL、Jest、Playwright、Three.js/R3F、七牛/对象存储相关脚本等。
 - `CLAUDE.md`、旧 README、`docs/历史归档/` 和早期部署文档里可能仍有旧苹果风格、MinIO、旧 Docker 部署、旧模型数量、旧 Product/SKU 口径等信息；只能当历史参考，不能覆盖当前代码、workflow 文档和实时命令结果。
 - 工作树可能有用户或其他协作者留下的未跟踪文件、日志、贴图和本地产物。只处理本次任务明确相关的文件，不要顺手清理或回退无关现场。
 
@@ -43,21 +43,6 @@
 - 不要在脏工作树上直接 merge/rebase。先看 `git status --short`，分清本次改动、用户改动、本地产物和无关未跟踪文件。
 - 常规任务完成必要验证后，可以按协作流程推进 `commit / push`；`main`、生产发布、破坏性操作、删除数据、改远端历史等高风险动作必须有用户明确授权。
 
-### 主线部署标准流程（每次"主线部署"都走这一套）
-
-本仓库有两根主线，都不直接提交：`main` 是生产部署唯一来源（由 `WuYongJie` 收口），`origin/codex/xuxiake-mainline` 是共享开发次主线（日常回流基线）。
-
-每次用户要求"主线部署"，严格按以下顺序，不跳步、不直接支线 → main：
-
-1. **在支线开发** → 提交到任务分支（如 `codex/wuyongjie-xxx`），不碰两根主线。
-2. **fetch xuxiake** → 必须先 `git fetch origin`，看 `origin/codex/xuxiake-mainline` 有没有新提交。
-3. **有新提交** → `merge origin/codex/xuxiake-mainline` 拉下来处理冲突（长期共享分支用 merge，不 rebase）；只处理冲突文件，不扩范围。
-4. **合并到 xuxiake** → 把支线合进 `origin/codex/xuxiake-mainline`，并 `push` 更新次主线。
-5. **合并到 main** → 把 xuxiake 合进 `main`，并 `push origin main`（本步需用户授权）。
-6. **用 main 部署** → 走 `scripts/deploy-yydd-prod-from-git.ps1`（默认源 `origin/main`），部署后核对 commit / 进程 / 端口 / 日志 / 关键页面（本步需用户授权）。
-
-发布前必须确认 `git ls-remote origin refs/heads/main`、本地 `origin/main`、目标部署 commit 三者一致。
-
 ## 4. 生产与部署
 
 - 当前正式网址：`https://cp.jiansun.vip/`。
@@ -71,7 +56,7 @@
 - 旧 `192.168.58.20`、本机泛别名 `prod`、旧 `gongxiangp2 / youyidian-3d-material` 生产信息都不能套用到本项目。
 - 生产动作前至少实时确认：目标主机、远端目录、PM2 进程、`current` 软链接、监听端口和 `https://cp.jiansun.vip/api/health`。
 - 生产数据库、迁移、主数据地基相关动作先只读核查；需要写入时必须有备份、目标库身份、确认口令和可回滚路径。
-- 对象存储当前要按 `src/lib/storage.ts`、`storage:*` 脚本、七牛迁移/GC 文档和生产环境变量实时核对；不要把历史 MinIO/S3 备份脚本当成当前生产存储真相。
+- 对象存储当前要按 `src/lib/storage`、`storage:*` 脚本、七牛迁移/GC 文档和生产环境变量实时核对；不要把历史 MinIO/S3 备份脚本当成当前生产存储真相。
 
 ## 5. 当前主链与模块边界
 
@@ -91,9 +76,6 @@
 - 仓库管理/轻仓库：`src/app/warehouse`、`src/app/api/warehouse`
 - 仓库质检：`src/app/warehouse-quality`、`src/app/api/warehouse-quality`
 - AI 出图工作台：`src/app/ai-render-workbench`
-- 审批工作流：`src/app/approval-workflows`
-- 素材库：`src/app/materials`
-- 移动端：`src/app/mobile`
 - 平台组件库：`src/components/platform`
 - 主链规则与类型：`src/lib/open-product`、`src/lib/planning`
 
@@ -103,13 +85,13 @@
 - 规格款：`AssetVariant`
 - 草稿组：`DraftGroup`
 - 准 SKU：`PreSku`
-- 入库结果：正式 `Product / ProductSKU`（`SKU` 是业务概念，Prisma 模型名是 `ProductSKU`）
+- 入库结果：正式 `Product / SKU`
 - 产品资料侧非集成开品：`IntakeNonIntegratedProduct / IntakeNonIntegratedSkuItem`
 
 旧 CAD 兼容链继续存在，但不是新平台主数据源：
 
 - 页面：`src/app/products`、`src/app/products/[id]`、`src/app/products/[id]/assembly`、`src/app/products/[id]/skus/[skuId]`
-- 旧链模型和服务包括 `Product / ProductSKU / Panel / Hole / ProductHardware`、`assembly.service`、`panel.service`、`hole.service` 等。
+- 旧链模型和服务包括 `Product / SKU / Panel / Hole / ProductHardware`、`assembly.service`、`panel.service`、`hole.service` 等。
 - 旧链可以继续服务历史产品、CAD 导入、装配步骤和兼容发布后能力，但不要反向主导资产中心、草稿组或产品资料主链。
 
 共享接缝默认谨慎处理：
@@ -132,10 +114,9 @@
 - Service 负责业务规则、权限校验、事务编排、缓存和跨模块协调。
 - Repository 负责数据访问。
 - 任何新接口必须有明确输入输出 DTO/校验口径。
-- 不是必须的话，不要使用兜底逻辑；原生主逻辑能做好，就先把主逻辑、状态契约和数据来源修正确。兜底只能用于明确的兼容、降级或应急场景，不能用来掩盖本应修好的业务规则、接口契约或前端状态问题。
 - 任何 Prisma 模型调整必须带迁移，并补齐主数据/迁移核查；生产/准生产禁止用 `prisma db push` 替代迁移。
 - 影响命名、BOM、包装、安装步骤、SKU、barcode、批次、入库承接的数据问题，优先从数据源和业务规则修，不在页面上压报错或绕校验。
-- SPU、SKU、barcode、批次不能混用：SPU 是父级产品款，SKU 是 SPU 下的具体子项（Prisma 模型名 `ProductSKU`），barcode 是绑定到最终 SKU 的业务定位值；基于某 SKU 派生的新 SKU 必须仍属于同一 SPU，并按业务要求继承或明确指定批次。
+- SPU、SKU、barcode、批次不能混用：SPU 是父级产品款，SKU 是 SPU 下的具体子项，barcode 是绑定到最终 SKU 的业务定位值；基于某 SKU 派生的新 SKU 必须仍属于同一 SPU，并按业务要求继承或明确指定批次。
 
 ## 7. 前端与视觉硬规则
 
@@ -148,18 +129,42 @@
 - 现有 `apple-*` token、深色 `ObsidianControlShell`、历史主题 CSS 只能作为兼容遗留；新功能不得以它们作为视觉方向。
 - 前端改造不得把现有后台习惯、普通 SaaS 审美或共享组件默认皮肤当成最终依据；如果组件库默认视觉和 Stitch/资产中心标准冲突，应在组件库体系内做专用变体、重写皮肤或局部重构。
 - 没有出现在设计稿、组件规范或业务必要路径里的说明文案、辅助卡片、重复统计块、解释区，不要为了“更易懂”自行添加；工作区必须抓重点，图片类功能要让图片和关键动作成为第一层级。
-- 涉及前端动画、入退场、滚动联动、时间线、拖拽、SVG 或动效性能时，先判断是否有助于理解和操作；需要时优先按技术栈调用对应 GSAP Skill，并继续遵守 Impeccable。React 必须使用 `useGSAP` 或带 `gsap.context().revert()` 的完整清理，滚动相关实例必须销毁并在布局变化时正确刷新；优先动画 `transform/opacity`，尊重 `prefers-reduced-motion`，不得为装饰滥用动效。
 - 前端修改后优先用真实页面、截图、1920×1080 视口和必要的移动端视口验证，不只看代码。
 
-## 8. 验证、收口与规范审查
+## 8. 验证与收口
 
 - 修改后必须做最小但有效的验证；不能验证就明确说明未验证原因和风险。
-- 常用验证命令以当前 `package.json` 为准，优先选和改动范围匹配的最小集合：`npm run type-check`、`npm run build`、`npm test -- <相关测试>`、`npm run lint`；对象存储用 `npm run storage:gc:audit` / `npm run storage:gc:apply`，主数据用 `npm run db:foundation:*` 相关只读或授权脚本。
+- 常用验证命令以当前 `package.json` 为准，优先选择和改动范围匹配的最小集合：
+  - `npm run type-check`
+  - `npm run build`
+  - `npm test -- <相关测试>`
+  - `npm run lint`
+  - `npm run storage:gc:audit` / `npm run storage:gc:apply -- --plan <file> --confirm-delete`
+  - `npm run db:foundation:*` 相关只读或授权脚本
 - 前端体验类改动要结合浏览器实际操作和截图验证；涉及 3D/canvas 时要确认画面非空、尺寸正确、交互可用。
-- 生产验证必须包含真实健康检查和日志/PM2/端口等现场证据，不能只说"本地构建通过"。
-- 规范审查固定只查三件事：架构有没有被破坏、视觉有没有跑偏、这次是不是根因修复。结论只能是 `passed` / `passed with warnings` / `rejected`；只要架构违规、视觉违规或明显补丁式修复，就必须 `rejected`。非独立复审时必须写明"这是自审，不是独立复审"。统一清单：`furniture-3d-system/docs/workflow/规范审查清单.md`。没有规范审查结论，任务不算完成。
+- 生产验证必须包含真实健康检查和日志/PM2/端口等现场证据，不能只说“本地构建通过”。
+- 没有“规范审查结论”，任务不算完成。
 
-## 9. 敏感信息和交接
+## 9. 规范审查
+
+规范审查固定只查三件事：
+
+- 架构有没有被破坏。
+- 视觉有没有跑偏。
+- 这次是不是根因修复。
+
+结论只能是：
+
+- `passed`
+- `passed with warnings`
+- `rejected`
+
+只要架构违规、视觉违规，或明显是补丁式修复，就必须 `rejected`。
+如果这次不是独立复审，必须明确写出“这是自审，不是独立复审”。
+
+统一清单：`furniture-3d-system/docs/workflow/规范审查清单.md`
+
+## 10. 敏感信息和交接
 
 - 账号密码、访问密钥、数据库连接串、对象存储密钥等敏感信息只能放在本地安全材料里，不写入 Git、共享文档、普通交接文本或长期记忆；生产域名、PM2 名称、部署目录这类非密钥运行入口可以写进仓库文档，但必须保持最新。
 - 仓库内协作文档只写非敏感入口、流程和职责；凭据类信息必须用 `[REDACTED_SECRET]` 或本地路径说明替代。

furniture-3d-system/.env.example

@@ -1,211 +0,0 @@
-# 本地运行
-NODE_ENV=development
-NEXT_PUBLIC_APP_URL=http://localhost:3000
-
-# 数据库
-DATABASE_URL=postgresql://USER:PASSWORD@HOST:5432/DB_NAME?schema=public
-
-# 员工工时花名只读人员配置来源（可选；开发环境配置后会合并正式人员配置）
-SUPPLY_CHAIN_PRODUCT_ARCHIVE_READ_DATABASE_URL=postgresql://READ_USER:READ_PASSWORD@READ_HOST:5432/READ_DB
-SUPPLY_CHAIN_PRODUCT_ARCHIVE_READ_DATABASE_SSL_REJECT_UNAUTHORIZED=true
-
-# 产品全量档案的聚水潭 SQL Server 只读来源
-JST_REPORT_DB_HOST=
-JST_REPORT_DB_PORT=1433
-JST_REPORT_DB_NAME=
-JST_REPORT_DB_SCHEMA=rpt
-JST_REPORT_DB_USER=
-JST_REPORT_DB_PASSWORD=
-JST_REPORT_DB_ENCRYPT=true
-JST_REPORT_DB_TRUST_SERVER_CERTIFICATE=true
-# 换货规则表 app.jst_sku_replace_rule 与 rpt 视图使用独立授权；留空时复用上面的主机、库和账号。
-JST_SKU_REPLACE_RULE_SCHEMA=app
-JST_SKU_REPLACE_RULE_DB_USER=
-JST_SKU_REPLACE_RULE_DB_PASSWORD=
-# 停产下架链接日快照最大导入延迟（小时）；超时保留已有链接。
-JST_DISCONTINUATION_LINK_MAX_AGE_HOURS=26
-# 数据库链接快照仅用于诊断；低于已有链接该比例时拒绝覆盖。
-JST_DM_MIN_EXISTING_COVERAGE_RATIO=0.5
-
-# 停产下架服务器 Chrome / RPA。
-JST_RPA_BROWSER_URL=http://127.0.0.1:9222
-JST_RPA_PROFILE_DIR=
-JST_RPA_CHROME_EXECUTABLE=
-JST_RPA_HEADLESS=true
-JST_RPA_DEBUG_PORT=9222
-JST_RPA_PYTHON=/usr/bin/python3
-# 聚水潭账号密码登录，仅配置在服务器私有环境文件，禁止提交真实值。
-JST_RPA_LOGIN_ID=
-JST_RPA_LOGIN_PASSWORD=
-JST_RPA_ATTEMPTS=3
-JST_RPA_FALLBACK_BATCH_SIZE=10000
-
-# OA 新品流程看板数据源。默认 mysql；切换到 JSReportReplica 时设为 mssql。
-OA_BOARD_SOURCE_DRIVER=mysql
-# MySQL 来源兼容配置。
-OA_BOARD_SOURCE_DB_HOST=
-OA_BOARD_SOURCE_DB_PORT=3306
-OA_BOARD_SOURCE_DB_NAME=
-OA_BOARD_SOURCE_DB_USER=
-OA_BOARD_SOURCE_DB_PASSWORD=
-OA_BOARD_SOURCE_DB_CHARSET=utf8mb4
-OA_BOARD_SOURCE_DB_SSL=false
-
-# SQL Server 来源：JSReportReplica.rpt 的 ding_Workflow、ding_WorkflowScheme、ding_WorkflowTask 只读视图。
-# 使用 mssql 来源时，快照仍写入下方配置的企划 MySQL 库。
-OA_BOARD_MSSQL_HOST=
-OA_BOARD_MSSQL_PORT=1433
-OA_BOARD_MSSQL_DATABASE=JSReportReplica
-OA_BOARD_MSSQL_SCHEMA=rpt
-OA_BOARD_MSSQL_USERNAME=
-OA_BOARD_MSSQL_PASSWORD=
-OA_BOARD_MSSQL_ENCRYPT=false
-OA_BOARD_MSSQL_TRUST_SERVER_CERTIFICATE=true
-OA_BOARD_MSSQL_CONNECTION_TIMEOUT_MS=15000
-OA_BOARD_MSSQL_REQUEST_TIMEOUT_MS=120000
-
-# OA 看板快照目标（MySQL）。留空时兼容复用 PLANNING_DATABASE_URL / PLANNING_DB_*。
-# 配置此组变量后，可保证切换 SQL Server 来源时所有快照、超时跟进和日报数据仍保存在企划库。
-OA_BOARD_SNAPSHOT_DATABASE_URL=
-OA_BOARD_SNAPSHOT_DB_HOST=
-OA_BOARD_SNAPSHOT_DB_PORT=3306
-OA_BOARD_SNAPSHOT_DB_NAME=
-OA_BOARD_SNAPSHOT_DB_USER=
-OA_BOARD_SNAPSHOT_DB_PASSWORD=
-OA_BOARD_SNAPSHOT_DB_CHARSET=utf8mb4
-OA_BOARD_SNAPSHOT_DB_SSL=false
-
-# HR 员工目录（SQL Server）。OA 快照仅在本地员工目录无法匹配时使用，
-# 用于将 ding_WorkflowTask.userId 解析成当前负责人的姓名。
-HR_SQLSERVER_HOST=
-HR_SQLSERVER_PORT=1433
-HR_SQLSERVER_DATABASE=
-HR_SQLSERVER_USERNAME=
-HR_SQLSERVER_PASSWORD=
-HR_SQLSERVER_ENCRYPT=false
-HR_SQLSERVER_TRUST_SERVER_CERTIFICATE=true
-
-# 产品资料供应商与仓库目录（SQL Server 报表库，只读）
-JST_PLANNING_SQLSERVER_HOST=
-JST_PLANNING_SQLSERVER_PORT=1433
-JST_PLANNING_SQLSERVER_DATABASE=
-JST_PLANNING_SQLSERVER_USERNAME=
-JST_PLANNING_SQLSERVER_PASSWORD=
-JST_PLANNING_SQLSERVER_SCHEMA=rpt
-JST_PLANNING_SQLSERVER_ENCRYPT=false
-JST_PLANNING_SQLSERVER_TRUST_SERVER_CERTIFICATE=true
-
-# 登录和令牌
-JWT_SECRET=replace-with-random-secret
-JWT_EXPIRES_IN=7d
-
-# 钉钉登录（OAuth 应用；只用于登录授权和用户信息获取）
-DINGTALK_LOGIN_CLIENT_ID=
-DINGTALK_LOGIN_CLIENT_SECRET=
-DINGTALK_CALLBACK_ORIGIN=
-
-# 钉钉开放平台 API（通讯录、待办、审批等服务端调用）
-DINGTALK_API_CLIENT_ID=
-DINGTALK_API_CLIENT_SECRET=
-
-# 钉钉待办：OA 阶段超时预警，以及预计出货日前 15 天的品牌策划主管提醒。
-DINGTALK_TODO_ENABLED=false
-DINGTALK_TODO_DETAIL_BASE_URL=
-DINGTALK_TODO_SOURCE_APP=oa-board
-DINGTALK_TODO_ESCALATION_ENABLED=false
-DINGTALK_TODO_ESCALATION_DAYS=3
-# DINGTALK_AGENT_ID=
-
-# 清货池多包标记钉钉通知：填写在职员工目录中的姓名，默认推送卷帘大将。
-SUPPLY_CHAIN_CLEARANCE_COMBO_NOTIFICATION_RECIPIENT=卷帘大将
-
-# 由壹点通知中心（仅服务端使用，项目密钥禁止提交或暴露给浏览器）
-YYD_NOTIFICATION_CENTER_URL=https://sc.jiansun.vip/notification-center
-YYD_NOTIFICATION_PROJECT_CODE=furniture_platform
-YYD_NOTIFICATION_PROJECT_SECRET=
-YYD_NOTIFICATION_TIMEOUT_MS=10000
-
-# 店铺账号新增时，梦汐/扬灵群使用的钉钉“由壹点”群机器人。
-# webhook 地址和签名密钥只配置在本地/正式站运行环境，不要提交真实值。
-DINGTALK_STORE_ACCOUNT_GROUP_WEBHOOK_URL=
-DINGTALK_STORE_ACCOUNT_GROUP_WEBHOOK_SECRET=
-DINGTALK_STORE_ACCOUNT_GROUP_WEBHOOK_TIMEOUT_MS=10000
-STORE_ACCOUNT_NOTIFICATION_RETRY_SECRET=
-
-# 产品开发待办定时任务（仅服务端/部署 cron 使用，须与其他任务密钥分开）
-PRODUCT_DEVELOPMENT_TODO_CRON_SECRET=
-
-# 对象存储
-# 必填，不能留空。当前生产桶使用 qiniu；只有明确切换适配器时才改为 s3/minio。
-STORAGE_PROVIDER=qiniu
-OBJECT_STORAGE_FILE_PATH=dev
-STORAGE_FILE_PATH=dev
-
-# 七牛云 Kodo
-QINIU_ACCESS_KEY=replace-with-qiniu-access-key
-QINIU_SECRET_KEY=replace-with-qiniu-secret-key
-QINIU_BUCKET=sucaiku-js
-QINIU_PUBLIC_DOMAIN=https://qny.jiansun.vip
-QINIU_FILE_PATH=dev
-QINIU_USE_HTTPS=true
-QINIU_PRIVATE_BUCKET=true
-QINIU_PRIVATE_URL_EXPIRES_SECONDS=7200
-
-# S3/MinIO 兼容适配器
-# STORAGE_PROVIDER=s3
-S3_ENDPOINT=http://127.0.0.1:9000
-S3_PUBLIC_ENDPOINT=http://127.0.0.1:9000
-S3_ACCESS_KEY=replace-with-s3-access-key
-S3_SECRET_KEY=replace-with-s3-secret-key
-S3_BUCKET=replace-with-s3-bucket
-S3_FILE_PATH=dev
-S3_REGION=us-east-1
-S3_ENABLE_PATH_STYLE=true
-
-# 外部 AI 生图
-EXTERNAL_IMAGE_GENERATE_TIMEOUT_MS=180000
-
-# BOM 核算竞品分析
-# 留空表示分析服务尚未接入；本地开发可显式填 fixture 验证完整工作台。
-# 生产环境禁止使用 fixture。
-BOM_COSTING_ANALYSIS_PROVIDER=
-# 真实竞品分析使用 market-detail-multimodal；Key 只放本地/生产环境变量。
-BOM_COSTING_MARKET_API_BASE_URL=https://qh.yydd.ai
-BOM_COSTING_MARKET_API_KEY=replace-with-market-open-api-key
-# 复用 AI 服务配置面板中已激活的多模态模型连接。
-BOM_COSTING_AI_SERVICE_TYPE=prompt-optimizer
-BOM_COSTING_MARKET_TIMEOUT_MS=60000
-# 最终结构与 BOM 汇总默认最多等待 110 秒；GPT-5 兼容网关会强制收紧到该上限，避免上游两分钟截断造成任务假死。
-BOM_COSTING_AI_TIMEOUT_MS=110000
-BOM_COSTING_AI_MAX_IMAGES=20
-# GPT-5 兼容网关的最终 BOM 汇总最多使用 12000 个输出额度，避免冗长回复拖垮整项任务。
-BOM_COSTING_AI_MAX_TOKENS=12000
-BOM_COSTING_AI_REASONING_EFFORT=low
-BOM_COSTING_MODELING_PROVIDER=
-
-# BOM 核算实时同款采购预估（1688 官方图搜）。
-# 网关固定为 https://skills-gateway.1688.com/api/find_product/1.0.0。
-# AK 只放服务器私密环境变量，服务端会按 x-csk-* 协议签名；实时同款价固定 × 90%
-# 是整件采购预估，历史 BOM 仅保留为结构参考。不要把 AK 写入 Git 或 NEXT_PUBLIC_* 变量。
-ALIBABA_1688_IMAGE_SEARCH_AK=replace-with-1688-image-search-ak
-# 仅在官方网关地址调整时设置；系统会拒绝非官方 HTTPS 地址。
-ALIBABA_1688_IMAGE_SEARCH_ENDPOINT_URL=https://skills-gateway.1688.com/api/find_product/1.0.0
-ALIBABA_1688_IMAGE_SEARCH_TIMEOUT_MS=45000
-ALIBABA_1688_IMAGE_SEARCH_MIN_SIMILARITY=0.78
-ALIBABA_1688_IMAGE_SEARCH_PAGE_SIZE=10
-ALIBABA_1688_IMAGE_SEARCH_PURCHASE_AMOUNT=1
-ALIBABA_1688_IMAGE_SEARCH_TAGS=4306497
-
-# 素材库白底图回传
-MATERIAL_LIBRARY_WHITE_BACKGROUND_API_ENABLED=false
-MATERIAL_LIBRARY_WHITE_BACKGROUND_API_BASE_URL=https://example.com
-MATERIAL_LIBRARY_WHITE_BACKGROUND_API_KEY=replace-with-material-library-api-key
-# 检测报告查询（不填则复用上面素材平台的 BaseUrl / API Key；都没有时「是否有检测报告」显示为空）
-MATERIAL_LIBRARY_CERTIFICATE_REPORT_API_BASE_URL=
-MATERIAL_LIBRARY_CERTIFICATE_REPORT_API_KEY=
-
-# 产品全量档案以图搜图（模型文件放在仓库外，不提交到 Git）
-IMAGE_SEARCH_MODEL_PATH=
-IMAGE_SEARCH_MODEL_SOURCE_BASE_URL=https://www.modelscope.cn/models/Xenova/dinov2-small/resolve/master
-IMAGE_SEARCH_MIN_SHAPE_COSINE=0.78
-IMAGE_SEARCH_MIN_SHAPE_MARGIN=0.08

furniture-3d-system/.gitattributes

@@ -1 +0,0 @@
-*.sh text eol=lf

furniture-3d-system/.gitignore

@@ -2,7 +2,6 @@
 
 # dependencies
 /node_modules
-/node_modules.pnpm-mixed
 /.pnp
 .pnp.*
 .yarn/*
@@ -16,9 +15,6 @@
 
 # next.js
 /.next/
-/.next-*/
-/.next-oa-preview*/
-/.next-oa-webpack/
 /out/
 /.data/
 
@@ -37,7 +33,6 @@ yarn-error.log*
 
 # env files (can opt-in for committing if needed)
 .env*
-!.env.example
 
 # vercel
 .vercel
@@ -73,9 +68,3 @@ typecheck-latest.log
 .local-test-*.log
 tsconfig.typecheck.generated.json
 local-packages/npm-cache/cache/_logs/
-
-# 脚本监控 Agent 本机凭据
-agents/script-monitor/config.json
-
-# 下载中心本地运行时产物
-.download-center/

furniture-3d-system/agents/script-monitor/README.md

@@ -1,30 +0,0 @@
-# 供应链脚本监控 Agent
-
-每台运行脚本的机器部署一份 Agent。Agent 只主动向产品平台发起 HTTP 请求，不需要为被监控机器开放入站端口。
-
-## 接入
-
-1. 在供应链中心的“脚本监控”页面点击“接入机器”，生成独立的 `agentId` 和 `agentToken`。
-2. 复制本目录到目标机器，把 `config.example.json` 复制为 `config.json`，填入凭据、内外网地址和脚本任务说明。
-3. 先运行 `node agent.mjs` 确认上报，再使用 `pm2 start ecosystem.config.cjs` 常驻。
-
-需要在平台点击“立即运行”的脚本，必须在 `config.json` 对应任务中显式配置
-`"allowManualRun": true`。平台只会下发脚本 `key`，Agent 始终执行本机配置里预存的
-`command`，不会接收平台传来的任意命令。Agent 默认每 5 秒主动领取一次执行请求，
-因此内网机器不需要开放入站端口。
-
-`connectionMode` 支持：
-
-- `intranet`：只走内网地址。
-- `internet`：只走公网地址，生产必须使用 HTTPS。
-- `auto`：优先内网，失败后自动尝试公网。
-
-## 记录真实运行结果
-
-对于需要记录开始时间、耗时、退出码和输出的任务，用包装器代替原命令：
-
-```bash
-node /opt/furniture-script-monitor/run-script.mjs supply-chain-archive-sync
-```
-
-包装器执行 `config.json` 中同一 `key` 的 `command`，并在开始与结束时上报。Agent Token 只保存在目标机器的 `config.json`，该文件已被仓库忽略。

furniture-3d-system/agents/script-monitor/agent.mjs

@@ -1,410 +0,0 @@
-import { createHash } from 'node:crypto'
-import { execFileSync, spawn } from 'node:child_process'
-import { existsSync, readFileSync, statSync } from 'node:fs'
-import { hostname, platform, release } from 'node:os'
-import { dirname, resolve } from 'node:path'
-import { fileURLToPath, pathToFileURL } from 'node:url'
-
-export const AGENT_VERSION = '1.0.0'
-const AGENT_DIR = dirname(fileURLToPath(import.meta.url))
-
-function requiredText(value, label) {
-  if (typeof value !== 'string' || !value.trim()) throw new Error(`缺少 ${label}`)
-  return value.trim()
-}
-
-export function loadConfig(configPath = process.env.SCRIPT_MONITOR_CONFIG || resolve(AGENT_DIR, 'config.json')) {
-  if (!existsSync(configPath)) {
-    throw new Error(`配置文件不存在：${configPath}，请复制 config.example.json 为 config.json`)
-  }
-  const config = JSON.parse(readFileSync(configPath, 'utf8'))
-  config.agentId = requiredText(config.agentId, 'agentId')
-  config.agentToken = requiredText(config.agentToken, 'agentToken')
-  config.connectionMode = String(config.connectionMode || 'auto').toLowerCase()
-  if (!['intranet', 'internet', 'auto'].includes(config.connectionMode)) {
-    throw new Error('connectionMode 必须是 intranet、internet 或 auto')
-  }
-  config.reportIntervalSec = Math.max(15, Number(config.reportIntervalSec) || 60)
-  config.requestTimeoutMs = Math.max(1000, Number(config.requestTimeoutMs) || 10000)
-  config.commandPollIntervalSec = Math.min(60, Math.max(2, Number(config.commandPollIntervalSec) || 5))
-  config.scripts = Array.isArray(config.scripts) ? config.scripts : []
-  return config
-}
-
-function normalizeCenterUrl(value) {
-  if (typeof value !== 'string' || !value.trim()) return null
-  const url = new URL(value.trim())
-  if (!['http:', 'https:'].includes(url.protocol)) throw new Error(`不支持的中心地址协议：${url.protocol}`)
-  return url.toString().replace(/\/$/, '')
-}
-
-export function resolveCenterEndpoints(config) {
-  const intranet = normalizeCenterUrl(config.centerUrls?.intranet)
-  const internet = normalizeCenterUrl(config.centerUrls?.internet)
-  const endpoints = []
-  if (config.connectionMode !== 'internet' && intranet) endpoints.push({ kind: 'INTRANET', url: intranet })
-  if (config.connectionMode !== 'intranet' && internet) endpoints.push({ kind: 'INTERNET', url: internet })
-  if (endpoints.length === 0) throw new Error('当前连接模式没有可用的 centerUrls 地址')
-  return endpoints
-}
-
-export async function postToCenter(config, route, payload) {
-  let lastError = null
-  for (const endpoint of resolveCenterEndpoints(config)) {
-    const controller = new AbortController()
-    const timeout = setTimeout(() => controller.abort(), config.requestTimeoutMs)
-    try {
-      const response = await fetch(`${endpoint.url}${route}`, {
-        method: 'POST',
-        signal: controller.signal,
-        headers: {
-          'content-type': 'application/json',
-          authorization: `Bearer ${config.agentToken}`,
-          'x-script-monitor-agent-id': config.agentId,
-        },
-        body: JSON.stringify({
-          ...payload,
-          ...(route.endsWith('/report')
-            ? { connectionKind: payload.connectionKind ?? endpoint.kind }
-            : {}),
-        }),
-      })
-      if (!response.ok) {
-        const message = await response.text().catch(() => '')
-        throw new Error(`HTTP ${response.status}${message ? `：${message.slice(0, 240)}` : ''}`)
-      }
-      return { endpoint, body: await response.json().catch(() => null) }
-    } catch (error) {
-      lastError = error
-    } finally {
-      clearTimeout(timeout)
-    }
-  }
-  throw lastError ?? new Error('没有可用的中心地址')
-}
-
-function hashKey(value) {
-  return createHash('sha256').update(value).digest('hex').slice(0, 20)
-}
-
-function redactCommand(command) {
-  return String(command || '')
-    .replace(/([A-Z0-9_]*(?:TOKEN|SECRET|PASSWORD|KEY)[A-Z0-9_]*=)([^\s]+)/gi, '$1[REDACTED]')
-    .replace(/(https?:\/\/[^:/\s]+:)[^@/\s]+@/gi, '$1[REDACTED]@')
-    .slice(0, 2000)
-}
-
-function readPm2() {
-  try {
-    const raw = execFileSync('pm2', ['jlist'], { encoding: 'utf8', timeout: 5000 })
-    return JSON.parse(raw)
-  } catch {
-    return []
-  }
-}
-
-function scanPm2() {
-  return readPm2().map((processInfo) => {
-    const name = String(processInfo.name || '未命名 PM2 进程')
-    const status = processInfo.pm2_env?.status === 'online'
-      ? 'RUNNING'
-      : processInfo.pm2_env?.status === 'stopped'
-        ? 'DISABLED'
-        : processInfo.pm2_env?.status === 'errored'
-          ? 'FAILED'
-          : 'UNKNOWN'
-    return {
-      key: `pm2:${name}`,
-      name,
-      taskDescription: '',
-      jobType: 'PM2',
-      schedule: null,
-      commandPreview: redactCommand(processInfo.pm2_env?.pm_exec_path || ''),
-      expectedIntervalSec: null,
-    status,
-    isEnabled: status !== 'DISABLED',
-    canManualRun: false,
-      lastStartedAt: processInfo.pm2_env?.pm_uptime
-        ? new Date(processInfo.pm2_env.pm_uptime).toISOString()
-        : null,
-      lastResultSummary: status === 'RUNNING'
-        ? `PM2 在线，PID ${processInfo.pid || '-'}`
-        : `PM2 状态：${processInfo.pm2_env?.status || 'unknown'}`,
-    }
-  })
-}
-
-function parseCronLine(line) {
-  const value = line.trim()
-  if (!value || value.startsWith('#')) return null
-  const special = value.match(/^@(reboot|yearly|annually|monthly|weekly|daily|hourly)\s+(.+)$/)
-  const regular = value.match(/^(\S+\s+\S+\s+\S+\s+\S+\s+\S+)\s+(.+)$/)
-  const schedule = special ? `@${special[1]}` : regular?.[1]
-  const command = special?.[2] ?? regular?.[2]
-  if (!schedule || !command) return null
-  const tag = command.match(/#\s*([\w.-]{3,})\s*$/)?.[1]
-  const name = tag || command.split(/\s+/).filter(Boolean).slice(-1)[0] || 'cron task'
-  return {
-    key: `cron:${hashKey(`${schedule}\n${command}`)}`,
-    name,
-    taskDescription: '',
-    jobType: 'CRON',
-    schedule,
-    commandPreview: redactCommand(command.replace(/\s+#.*$/, '')),
-    expectedIntervalSec: null,
-    status: 'UNKNOWN',
-    isEnabled: true,
-    canManualRun: false,
-  }
-}
-
-function scanCron() {
-  if (platform() === 'win32') return []
-  try {
-    const raw = execFileSync('crontab', ['-l'], { encoding: 'utf8', timeout: 5000 })
-    return raw.split(/\r?\n/).map(parseCronLine).filter(Boolean)
-  } catch {
-    return []
-  }
-}
-
-function checkProcess(name) {
-  try {
-    if (platform() === 'win32') {
-      const output = execFileSync('tasklist', ['/FI', `IMAGENAME eq ${name}`], { encoding: 'utf8', timeout: 4000 })
-      return output.toLowerCase().includes(String(name).toLowerCase())
-    }
-    execFileSync('pgrep', ['-f', '--', name], { stdio: 'ignore', timeout: 4000 })
-    return true
-  } catch {
-    return false
-  }
-}
-
-function checkConfiguredScript(script) {
-  if (script.enabled === false) return { status: 'DISABLED', summary: '监控已停用' }
-  const check = script.resultCheck
-  if (!check) return { status: 'UNKNOWN', summary: null }
-
-  if (check.type === 'file') {
-    try {
-      const stat = statSync(requiredText(check.path, 'resultCheck.path'))
-      const ageSec = Math.max(0, Math.round((Date.now() - stat.mtimeMs) / 1000))
-      const fresh = !check.maxAgeSec || ageSec <= Number(check.maxAgeSec)
-      const largeEnough = check.minBytes == null || stat.size >= Number(check.minBytes)
-      return {
-        status: fresh && largeEnough ? 'SUCCESS' : 'FAILED',
-        summary: `文件 ${stat.size} B，${ageSec} 秒前更新`,
-      }
-    } catch (error) {
-      return { status: 'FAILED', summary: `文件检查失败：${error.message}` }
-    }
-  }
-
-  if (check.type === 'systemd') {
-    try {
-      const service = requiredText(check.service, 'resultCheck.service')
-      const state = execFileSync('systemctl', ['is-active', service], { encoding: 'utf8', timeout: 4000 }).trim()
-      return { status: state === 'active' ? 'RUNNING' : 'FAILED', summary: `systemd：${state}` }
-    } catch {
-      return { status: 'FAILED', summary: 'systemd 服务未运行' }
-    }
-  }
-
-  if (check.type === 'process') {
-    const running = checkProcess(requiredText(check.name, 'resultCheck.name'))
-    return { status: running ? 'RUNNING' : 'FAILED', summary: running ? '进程正在运行' : '未找到目标进程' }
-  }
-
-  return { status: 'UNKNOWN', summary: '未识别的结果检查类型' }
-}
-
-function normalizeConfiguredScript(script) {
-  const key = requiredText(script.key, 'scripts[].key')
-  const result = checkConfiguredScript(script)
-  return {
-    key,
-    name: requiredText(script.name, `scripts[${key}].name`),
-    taskDescription: String(script.taskDescription || '').slice(0, 2000),
-    jobType: String(script.jobType || 'OTHER').toUpperCase(),
-    schedule: script.schedule ? String(script.schedule).slice(0, 240) : null,
-    commandPreview: redactCommand(script.commandPreview || script.command || ''),
-    expectedIntervalSec: script.expectedIntervalSec ? Number(script.expectedIntervalSec) : null,
-    status: result.status,
-    isEnabled: script.enabled !== false,
-    canManualRun: script.allowManualRun === true && Boolean(script.command),
-    lastResultSummary: result.summary,
-  }
-}
-
-export function collectScripts(config) {
-  const byKey = new Map()
-  if (config.autoDiscover?.cron !== false) {
-    for (const script of scanCron()) byKey.set(script.key, script)
-  }
-  if (config.autoDiscover?.pm2 !== false) {
-    for (const script of scanPm2()) byKey.set(script.key, script)
-  }
-  for (const script of config.scripts) {
-    const normalized = normalizeConfiguredScript(script)
-    byKey.set(normalized.key, { ...(byKey.get(normalized.key) || {}), ...normalized })
-  }
-  return [...byKey.values()]
-}
-
-export async function reportSnapshot(config) {
-  const scripts = collectScripts(config)
-  const result = await postToCenter(config, '/api/internal/script-monitor/report', {
-    hostname: hostname(),
-    os: `${platform()} ${release()}`,
-    agentVersion: AGENT_VERSION,
-    reportIntervalSec: config.reportIntervalSec,
-    scripts,
-  })
-  console.log(`[script-monitor] 已通过${result.endpoint.kind === 'INTRANET' ? '内网' : '公网'}上报 ${scripts.length} 个脚本`)
-}
-
-function keepTail(current, chunk, limit = 12000) {
-  const next = current + chunk.toString()
-  return next.length > limit ? next.slice(-limit) : next
-}
-
-async function reportManualRun(config, command, input) {
-  return postToCenter(config, '/api/internal/script-monitor/run', {
-    commandId: command.id,
-    scriptKey: command.scriptKey,
-    scriptName: command.scriptName,
-    taskDescription: command.taskDescription || '',
-    jobType: String(command.jobType || 'OTHER').toUpperCase(),
-    ...input,
-  })
-}
-
-export async function executeManualCommand(config, command) {
-  const script = config.scripts.find((item) => item.key === command.scriptKey)
-  const startedAt = new Date()
-  const externalRunId = `manual:${command.id}`
-  if (!script?.command || script.allowManualRun !== true) {
-    const message = 'Agent 配置未开放该脚本的手动运行权限'
-    await reportManualRun(config, command, {
-      externalRunId,
-      status: 'FAILED',
-      trigger: 'manual',
-      startedAt: startedAt.toISOString(),
-      finishedAt: new Date().toISOString(),
-      durationMs: 0,
-      exitCode: 1,
-      resultSummary: message,
-      errorTail: message,
-    })
-    return
-  }
-
-  await reportManualRun(config, command, {
-    externalRunId,
-    status: 'RUNNING',
-    trigger: 'manual',
-    startedAt: startedAt.toISOString(),
-  })
-  let outputTail = ''
-  let errorTail = ''
-  try {
-    const child = spawn(script.command, {
-      cwd: script.cwd ? resolve(script.cwd) : process.cwd(),
-      env: process.env,
-      shell: true,
-      stdio: ['ignore', 'pipe', 'pipe'],
-    })
-    child.stdout.on('data', (chunk) => {
-      outputTail = keepTail(outputTail, chunk)
-      process.stdout.write(chunk)
-    })
-    child.stderr.on('data', (chunk) => {
-      errorTail = keepTail(errorTail, chunk)
-      process.stderr.write(chunk)
-    })
-    const exitCode = await new Promise((resolveExit, reject) => {
-      child.once('error', reject)
-      child.once('close', (code) => resolveExit(code ?? 1))
-    })
-    const finishedAt = new Date()
-    await reportManualRun(config, command, {
-      externalRunId,
-      status: exitCode === 0 ? 'SUCCESS' : 'FAILED',
-      trigger: 'manual',
-      startedAt: startedAt.toISOString(),
-      finishedAt: finishedAt.toISOString(),
-      durationMs: finishedAt.getTime() - startedAt.getTime(),
-      exitCode,
-      resultSummary: exitCode === 0 ? '手动运行成功' : `手动运行失败，退出码 ${exitCode}`,
-      outputTail,
-      errorTail,
-    })
-  } catch (error) {
-    const finishedAt = new Date()
-    await reportManualRun(config, command, {
-      externalRunId,
-      status: 'FAILED',
-      trigger: 'manual',
-      startedAt: startedAt.toISOString(),
-      finishedAt: finishedAt.toISOString(),
-      durationMs: finishedAt.getTime() - startedAt.getTime(),
-      exitCode: 1,
-      resultSummary: `手动运行启动失败：${error.message}`,
-      errorTail: error.message,
-    })
-  }
-}
-
-export async function pollManualCommand(config) {
-  const result = await postToCenter(
-    config,
-    '/api/internal/script-monitor/commands/claim',
-    {},
-  )
-  const command = result.body?.data?.command
-  if (!command) return false
-  await executeManualCommand(config, command)
-  return true
-}
-
-async function main() {
-  const config = loadConfig()
-  const run = async () => {
-    try {
-      await reportSnapshot(config)
-    } catch (error) {
-      console.error('[script-monitor] 上报失败：', error.message)
-    }
-  }
-  let commandBusy = false
-  const poll = async () => {
-    if (commandBusy) return
-    commandBusy = true
-    try {
-      await pollManualCommand(config)
-    } catch (error) {
-      console.error('[script-monitor] 手动任务轮询失败：', error.message)
-    } finally {
-      commandBusy = false
-    }
-  }
-  await run()
-  await poll()
-  const timer = setInterval(run, config.reportIntervalSec * 1000)
-  const commandTimer = setInterval(poll, config.commandPollIntervalSec * 1000)
-  const stop = () => {
-    clearInterval(timer)
-    clearInterval(commandTimer)
-    process.exit(0)
-  }
-  process.on('SIGINT', stop)
-  process.on('SIGTERM', stop)
-}
-
-if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
-  main().catch((error) => {
-    console.error('[script-monitor] 启动失败：', error.message)
-    process.exit(1)
-  })
-}

furniture-3d-system/agents/script-monitor/agent.test.mjs

@@ -1,79 +0,0 @@
-import assert from 'node:assert/strict'
-import test from 'node:test'
-import { executeManualCommand } from './agent.mjs'
-
-function config(overrides = {}) {
-  return {
-    agentId: 'agent-1',
-    agentToken: 'secret-token',
-    connectionMode: 'internet',
-    centerUrls: { internet: 'https://monitor.example.test' },
-    requestTimeoutMs: 5000,
-    scripts: [{
-      key: 'local-check',
-      name: '本机检查',
-      taskDescription: '验证手动触发',
-      jobType: 'MANUAL',
-      allowManualRun: true,
-      command: `${JSON.stringify(process.execPath)} -e "console.log('manual-ok')"`,
-    }],
-    ...overrides,
-  }
-}
-
-function command() {
-  return {
-    id: 'command-1',
-    scriptKey: 'local-check',
-    scriptName: '本机检查',
-    taskDescription: '验证手动触发',
-    jobType: 'MANUAL',
-  }
-}
-
-test('manual command executes only the local configured command and reports its result', async () => {
-  const previousFetch = globalThis.fetch
-  const reports = []
-  globalThis.fetch = async (_url, init) => {
-    reports.push(JSON.parse(init.body))
-    return new Response(JSON.stringify({ success: true, data: { ok: true } }), {
-      status: 200,
-      headers: { 'content-type': 'application/json' },
-    })
-  }
-  try {
-    await executeManualCommand(config(), command())
-  } finally {
-    globalThis.fetch = previousFetch
-  }
-
-  assert.equal(reports.length, 2)
-  assert.equal(reports[0].status, 'RUNNING')
-  assert.equal(reports[1].status, 'SUCCESS')
-  assert.equal(reports[1].exitCode, 0)
-  assert.match(reports[1].outputTail, /manual-ok/)
-  assert.equal(reports[1].commandId, 'command-1')
-})
-
-test('manual command is rejected when allowManualRun is not explicitly enabled', async () => {
-  const previousFetch = globalThis.fetch
-  const reports = []
-  globalThis.fetch = async (_url, init) => {
-    reports.push(JSON.parse(init.body))
-    return new Response(JSON.stringify({ success: true, data: { ok: true } }), {
-      status: 200,
-      headers: { 'content-type': 'application/json' },
-    })
-  }
-  const blockedConfig = config()
-  blockedConfig.scripts[0].allowManualRun = false
-  try {
-    await executeManualCommand(blockedConfig, command())
-  } finally {
-    globalThis.fetch = previousFetch
-  }
-
-  assert.equal(reports.length, 1)
-  assert.equal(reports[0].status, 'FAILED')
-  assert.match(reports[0].resultSummary, /未开放/)
-})

furniture-3d-system/agents/script-monitor/config.example.json

@@ -1,36 +0,0 @@
-{
-  "agentId": "PASTE_AGENT_ID_HERE",
-  "agentToken": "PASTE_AGENT_TOKEN_HERE",
-  "agentName": "仓库服务器 01",
-  "connectionMode": "auto",
-  "centerUrls": {
-    "intranet": "http://10.0.0.20:3001",
-    "internet": "https://cp.jiansun.vip"
-  },
-  "reportIntervalSec": 60,
-  "commandPollIntervalSec": 5,
-  "requestTimeoutMs": 10000,
-  "autoDiscover": {
-    "cron": true,
-    "pm2": true
-  },
-  "scripts": [
-    {
-      "key": "supply-chain-archive-sync",
-      "name": "供应链产品档案同步",
-      "taskDescription": "同步聚水潭商品档案、仓库和供应商扩展字段",
-      "jobType": "CRON",
-      "schedule": "*/15 * * * *",
-      "expectedIntervalSec": 900,
-      "allowManualRun": true,
-      "command": "npm run sync:supply-chain-product-archive",
-      "cwd": "/opt/furniture-3d-system-prod/current",
-      "resultCheck": {
-        "type": "file",
-        "path": "/opt/furniture-3d-system-prod/shared/logs/product-archive-sync.log",
-        "maxAgeSec": 1800,
-        "minBytes": 1
-      }
-    }
-  ]
-}

furniture-3d-system/agents/script-monitor/ecosystem.config.cjs

@@ -1,15 +0,0 @@
-module.exports = {
-  apps: [{
-    name: 'furniture-script-monitor-agent',
-    script: 'agent.mjs',
-    cwd: __dirname,
-    instances: 1,
-    exec_mode: 'fork',
-    autorestart: true,
-    watch: false,
-    env: {
-      NODE_ENV: 'production',
-      SCRIPT_MONITOR_CONFIG: `${__dirname}/config.json`,
-    },
-  }],
-}

furniture-3d-system/agents/script-monitor/run-script.mjs

@@ -1,82 +0,0 @@
-import { spawn } from 'node:child_process'
-import { randomUUID } from 'node:crypto'
-import { resolve } from 'node:path'
-import { loadConfig, postToCenter } from './agent.mjs'
-
-function keepTail(current, chunk, limit = 12000) {
-  const next = current + chunk.toString()
-  return next.length > limit ? next.slice(-limit) : next
-}
-
-async function sendRun(config, script, input) {
-  return postToCenter(config, '/api/internal/script-monitor/run', {
-    scriptKey: script.key,
-    scriptName: script.name,
-    taskDescription: script.taskDescription || '',
-    jobType: String(script.jobType || 'OTHER').toUpperCase(),
-    ...input,
-  })
-}
-
-async function main() {
-  const scriptKey = process.argv[2]
-  if (!scriptKey) throw new Error('用法：node run-script.mjs <script-key>')
-  const config = loadConfig()
-  const script = config.scripts.find((item) => item.key === scriptKey)
-  if (!script) throw new Error(`配置中不存在脚本：${scriptKey}`)
-  if (!script.command) throw new Error(`脚本 ${scriptKey} 未配置 command`)
-
-  const externalRunId = `${scriptKey}:${randomUUID()}`
-  const startedAt = new Date()
-  await sendRun(config, script, {
-    externalRunId,
-    status: 'RUNNING',
-    trigger: 'wrapper',
-    startedAt: startedAt.toISOString(),
-  }).catch((error) => {
-    console.warn('[script-monitor-run] 开始状态上报失败，不阻断原脚本：', error.message)
-  })
-
-  let outputTail = ''
-  let errorTail = ''
-  const child = spawn(script.command, {
-    cwd: script.cwd ? resolve(script.cwd) : process.cwd(),
-    env: process.env,
-    shell: true,
-    stdio: ['ignore', 'pipe', 'pipe'],
-  })
-  child.stdout.on('data', (chunk) => {
-    outputTail = keepTail(outputTail, chunk)
-    process.stdout.write(chunk)
-  })
-  child.stderr.on('data', (chunk) => {
-    errorTail = keepTail(errorTail, chunk)
-    process.stderr.write(chunk)
-  })
-
-  const exitCode = await new Promise((resolveExit, reject) => {
-    child.once('error', reject)
-    child.once('close', (code) => resolveExit(code ?? 1))
-  })
-  const finishedAt = new Date()
-  await sendRun(config, script, {
-    externalRunId,
-    status: exitCode === 0 ? 'SUCCESS' : 'FAILED',
-    trigger: 'wrapper',
-    startedAt: startedAt.toISOString(),
-    finishedAt: finishedAt.toISOString(),
-    durationMs: finishedAt.getTime() - startedAt.getTime(),
-    exitCode,
-    resultSummary: exitCode === 0 ? '脚本执行成功' : `脚本退出码 ${exitCode}`,
-    outputTail,
-    errorTail,
-  }).catch((error) => {
-    console.warn('[script-monitor-run] 运行结果上报失败，保留原退出码：', error.message)
-  })
-  process.exitCode = exitCode
-}
-
-main().catch((error) => {
-  console.error('[script-monitor-run] 执行失败：', error.message)
-  process.exitCode = 1
-})

furniture-3d-system/docs/integrations/dropship-return-address-push-api.md

@@ -1,109 +0,0 @@
-# 1688代发异常事项：退货地址推送接口
-
-## 交付与启用
-
-本接口供外部系统按 SPU 推送退货地址。正式站发布包含该接口的版本并配置独立密钥后，对方即可按本文调用。
-
-部署人员在生产运行环境配置 `DROPSHIP_RETURN_ADDRESS_API_KEY`，使用独立随机密钥（建议至少32个随机字节），由双方通过安全渠道交接；密钥不进入 Git、对接文档、URL 或普通日志。未配置时接口返回503。无需提供数据库账号，无需平台用户登录。
-
-## 请求
-
-- 方法：`POST`
-- 正式地址：`https://cp.jiansun.vip/api/external/supply-chain/dropship-return-addresses`
-- 本地联调：`http://localhost:3001/api/external/supply-chain/dropship-return-addresses`
-- 请求头：`Content-Type: application/json`、`x-api-key: <对接密钥>`
-- 每批1–100条；单条推送也使用 `items` 数组。
-
-```json
-{
-  "items": [
-    {
-      "spu": "DF-C1YMJ0009",
-      "returnAddress": "收件人：张三；电话：138xxxxxxxx；地址：江苏省……"
-    }
-  ]
-}
-```
-
-| 字段 | 必填 | 规则 |
-| --- | --- | --- |
-| `spu` | 是 | 1–120位字母、数字、下划线或连字符；自动去除首尾空格并转为大写 |
-| `returnAddress` | 是 | 去除首尾空格后1–500字；收件人、电话、详细地址合并为一段文字 |
-
-仅接收上述字段。额外传入发票类型、安装方式等字段，该条会失败，不会改动这些字段。
-
-调用示例（密钥由调用方运行环境注入）：
-
-```bash
-curl --request POST \
-  'https://cp.jiansun.vip/api/external/supply-chain/dropship-return-addresses' \
-  --header 'Content-Type: application/json' \
-  --header "x-api-key: ${DROPSHIP_RETURN_ADDRESS_API_KEY}" \
-  --data '{"items":[{"spu":"DF-C1YMJ0009","returnAddress":"收件人：张三；电话：138xxxxxxxx；地址：江苏省……"}]}'
-```
-
-## 写入规则
-
-1. 一SPU一退货地址，同SPU下所有SKU共用；按档案中的DF代发范围核验，不受当月业绩筛选影响。
-2. SPU必须已存在于产品档案。没有维护记录时自动创建维护记录；不会创建产品档案。
-3. 新地址覆盖该SPU原有地址（包括人工填写的地址），以数据库实际处理顺序为准。
-4. 只更新退货地址和维护人/时间，保留发票类型、整装/拆装；新增维护记录时其他字段使用原有空值默认值。
-5. 空地址拒绝，不能通过这个接口清空地址。重复推送同一地址返回 `UNCHANGED`，不重复写入或变更时间。
-6. 同批重复SPU（含大小写/首尾空格差异）的重复项全部失败，其余条目继续处理；每批按输入顺序返回结果。
-7. 每条独立保存，某条失败不撤销已经成功的条目。实际地址变化写入1688代发异常事项操作日志，标记“外部退货地址同步”，包含前后值与请求编号。
-8. 当前页面默认只显示有业绩SPU；无业绩产品推送成功后，切换“全部SPU”查看。
-
-## 响应
-
-HTTP200表示批次已处理，**仍须检查 `data.failedCount` 和每条 `status`**。
-
-```json
-{
-  "success": true,
-  "data": {
-    "total": 2,
-    "successCount": 1,
-    "failedCount": 1,
-    "updatedCount": 1,
-    "unchangedCount": 0,
-    "results": [
-      {
-        "index": 1,
-        "spu": "DF-C1YMJ0009",
-        "status": "UPDATED",
-        "updatedAt": "2026-10-24T04:00:00.000Z"
-      },
-      {
-        "index": 2,
-        "spu": "DF-MISSING",
-        "status": "FAILED",
-        "code": "SPU_NOT_FOUND",
-        "message": "产品档案中不存在该代发 SPU"
-      }
-    ]
-  },
-  "meta": {
-    "requestId": "服务端请求编号",
-    "timestamp": "2026-10-24T04:00:00.000Z"
-  }
-}
-```
-
-`index` 从1开始，对应请求数组顺序；`UPDATED` 表示新增或更新成功，`UNCHANGED` 表示地址已一致。两种均计入 `successCount`。时间使用UTC ISO8601格式。
-
-| 每条失败码 | 含义与处理 |
-| --- | --- |
-| `INVALID_ITEM` | 字段格式、地址为空/过长或包含额外字段；修正数据后重推 |
-| `DUPLICATE_SPU` | 同批存在重复SPU；去重后重推 |
-| `SPU_NOT_FOUND` | 不存在对应DF代发档案；核对SPU或等待档案同步后重推 |
-| `WRITE_FAILED` | 保存失败；重试该条，持续失败时附 `meta.requestId` 联系管理员 |
-
-| HTTP状态 | 含义 |
-| --- | --- |
-| 200 | 批次已处理，检查逐条结果 |
-| 400 | 非法JSON、缺少items、空批次、超过100条或多余顶层字段；整批不写入 |
-| 401 | 缺少密钥或密钥错误；整批不写入 |
-| 503 | 服务端未配置对接密钥；整批不写入 |
-| 500 | 系统错误；提供请求编号排查 |
-
-网络超时或500时可能已有部分条目保存。可重推相同地址；如果期间出现更新，应重新取得上游最新地址再推送，避免旧批次覆盖新地址。调用方不应并发推送同一SPU。

furniture-3d-system/docs/integrations/finance-store-account-password-reveal.md

@@ -1,153 +0,0 @@
-# 财务系统店铺密码直接显示契约
-
-状态：生产接口已上线；2026-09-09 按当前明文存储规则修正 `passwordConfigured`。
-
-## 存储事实与授权边界
-
-- 密码真相源是 `public."StoreAccount"."passwordCiphertext"`。字段名是历史遗留；当前规则将新值以明文保存，读取链路对历史 `v1:` AES-256-GCM 值保留兼容。
-- 存量 `v1:` 值已由 `scripts/migrate-store-account-plaintext-20260908.js` 迁移。`STORE_ACCOUNT_ENCRYPTION_KEY` 仅用于可能残留或恢复出的历史 `v1:` 值，不参与当前明文值读取。
-- `passwordConfigured` 只表示存储值是否非空，不校验字符集或密码强度；因此包含 `+`、`/`、`=` 等字符的密码也会正确返回 true。它不返回密码本身。
-- 普通 `store_account_reader` 可读视图、不能读取基表或密码列。此次迁移不增加其基表权限。
-- 本接口只信任专用服务身份 `finance-store-accounts`。财务系统必须在自身后端校验用户登录态、查看/复制权限及店铺范围，然后从可信会话中取 `requesterId`。不得把客户端传入的任意人员 ID 当成操作者。服务凭据仅保存在财务后端，禁止交给浏览器。
-- 不提供密码列表或批量导出。财务页面可在已通过自身页面权限校验后，自动读取当前可见页最多 50 个账号；CSV 和共享镜像仍只读取 `passwordConfigured`。复制操作继续走单账号接口。上游审计记录的用户 ID 是专用财务服务的身份断言，未授权请求中的 ID 不可信，`serviceId=null`。
-
-## HTTP 契约
-
-生产配置完成后的地址：
-
-`POST https://cp.jiansun.vip/internal/store-accounts/{id}/password/reveal`
-
-`POST https://cp.jiansun.vip/internal/store-accounts/visible-page/password/reveal`
-
-`id` 为 `accounts_v1.id`，仅接受单个 1–128 位字母、数字、下划线或连字符。无查询参数；禁止在 URL、请求体、请求头中传待读取密码。
-
-请求头：
-
-```http
-Authorization: Bearer <专用服务令牌>
-Content-Type: application/json
-```
-
-请求体（严格拒绝额外字段，最大 1024 字节，1 秒内读取完毕）：
-
-```json
-{ "requesterId": "finance-user-123", "purpose": "view" }
-```
-
-`purpose` 仅允许 `view` 或 `copy`。`requesterId` 是财务会话中的稳定人员标识，1–128 位 `[A-Za-z0-9_.:@-]`。不接受批量 ID、查询参数、普通登录 Cookie/JWT、普通数据库凭据或其他内部任务密钥。
-
-当前页批量请求严格只接受以下字段，正文最大 8192 字节；`accountIds` 为 1 至 50 个互不重复且符合单账号 ID 规则的值：
-
-```json
-{ "requesterId": "finance-user-123", "purpose": "view", "accountIds": ["account-1", "account-2"] }
-```
-
-成功 `200`：
-
-```json
-{ "requestId": "<服务端生成的 UUID>", "password": "<仅本次响应体中的密码>" }
-```
-
-当前页批量成功的 HTTP 状态为 `200`，每个账号分别返回 `200/404/429/503`。每项都有独立 UUID；只有状态 `200` 的项包含密码，并按请求顺序完整返回：
-
-```json
-{
-  "requestId": "<批次 UUID>",
-  "items": [
-    { "accountId": "account-1", "requestId": "<项目 UUID>", "status": 200, "password": "<密码>" },
-    { "accountId": "account-2", "requestId": "<项目 UUID>", "status": 404 }
-  ]
-}
-```
-
-所有状态均返回 `Cache-Control: no-store`、`Pragma: no-cache`、`X-Content-Type-Options: nosniff`。`X-Request-Id` 与响应体、审计的追踪 ID 相同。不会在响应头中放密码。
-
-错误体：
-
-```json
-{ "requestId": "<UUID>", "error": { "code": "FORBIDDEN", "message": "请求被拒绝" } }
-```
-
-| HTTP | code | 含义 |
-|---|---|---|
-| 403 | FORBIDDEN | 服务认证失败、非 HTTPS、非法 ID/JSON/用途、额外参数或非 POST |
-| 404 | PASSWORD_NOT_FOUND | 账号不存在或没有可用密码，两者不区分 |
-| 429 | RATE_LIMITED | 任一限流窗口超限 |
-| 503 | UNAVAILABLE | 密钥/解密、数据库、限流或审计不可用；不返回内部异常 |
-
-审计或数据库故障优先返回 503，绝不在无法持久化成功审计时返回密码。数据库完全不可用时无法保存该次失败审计，由网关仅记录追踪 ID、状态与时间供运维关联。成功审计表示服务器已授权并生成响应，不等同于浏览器已经复制成功。
-
-## 限流和超时
-
-- 单账号数据库滚动窗口：服务全部账号 30 次/分钟、300 次/24 小时；同一人员 10 次/分钟；同一账号 5 次/分钟。公网 TLS 网关保留 1 KiB 敏感请求正文上限，财务端把 50 行当前页拆成两个最多 25 个账号的批次；批次标记因此按服务 20 次/分钟、1000 次/24 小时、同一人员 10 次/分钟限流，等价于原每页额度。批次中的每个账号仍受同一账号 5 次/分钟限制。查看和复制共享账号额度，轮换令牌不重置服务身份或额度。
-- 已认证的成功、404、参数拒绝和解密失败均占额度；429 不延长窗口。额度检查与审计在同一数据库事务中用事务级锁串行化，跨进程/重启共享状态。
-- 429 不携带剩余数量或精确窗口，避免推测其他用户行为。客户端不得自动重试密码读取；提示用户稍后再试，持续超限联系管理员。
-- 财务客户端设置总超时 10 秒、禁用自动重定向和重试。后端池上限 4、连接获取 1 秒、SQL 执行 1.5 秒/客户端查询 2 秒、锁等待 1 秒，路由运行预算 10 秒。网关必须配置请求体 1 秒和总请求截止，防止慢请求占用。
-- 入口网关还需按来源 IP 对全部请求（包括未授权请求）限制为 60 次/分钟，返回 429 JSON 和 `no-store`；这项入口防滥用配置属于上线门禁。应用层数据库限流负责已认证的敏感读取。
-
-## 环境变量（仅名称及要求）
-
-| 名称 | 所在系统与要求 |
-|---|---|
-| STORE_ACCOUNT_ENCRYPTION_KEY | 仅用于兼容历史 `v1:` 密文，至少 32 字符；生产不回退到 JWT_SECRET |
-| STORE_ACCOUNT_FINANCE_TOKEN | 上游专用服务令牌，密码学随机至少 32 字节，base64url 编码，43–128 字符；缺失时拒绝全部调用 |
-| STORE_ACCOUNT_FINANCE_TOKEN_PREVIOUS | 上游可选旧令牌，仅用于短时轮换；主令牌缺失时旧令牌也不生效 |
-| STORE_ACCOUNT_REVEAL_EDGE_TOKEN | 上游与可信 TLS 网关之间的独立随机凭据，base64url 43–128 字符；与财务令牌完全分离，不提供给财务系统；缺失时拒绝全部调用 |
-| DATABASE_URL | 上游现有数据库连接；仅专用不输出查询/异常的连接池读取密文、写审计 |
-| STORE_ACCOUNT_REVEAL_URL | 财务后端配置完整 HTTPS 地址模板 |
-| STORE_ACCOUNT_REVEAL_VISIBLE_PAGE_URL | 财务后端配置当前页批量 HTTPS 地址；必须使用精确 `visible-page` 路径 |
-| STORE_ACCOUNT_REVEAL_TOKEN | 财务后端保存与上游专用令牌对应的值 |
-| STORE_REVEAL_TEST_ADMIN_URL | 仅本地集成测试；必须指向回环地址、有建测试库/角色权限的 PostgreSQL |
-| STORE_REVEAL_TEST_POSTGRES_CONTAINER | 仅本地日志验收，指定本地 PostgreSQL 容器以只读扫描测试期间日志 |
-
-## HTTPS、日志和缓存上线门禁
-
-1. 财务后端至公开入口及跨主机的所有代理链路必须使用验证证书的 HTTPS，禁止 HTTP 跳转、跳过证书验证、明文 FRP/跨主机上游。当前 PR 不修改生产 TLS 拓扑；上线前逐跳核实，不满足即不启用令牌。
-2. 应用不以 URL 或未经认证的转发头证明 TLS。必须由受控网关在实际 HTTPS 入口覆盖 `X-Forwarded-Proto: https` 及 `X-Store-Reveal-Edge-Token`（值来自独立 `STORE_ACCOUNT_REVEAL_EDGE_TOKEN`），剥除客户端原有同名头；HTTP 入口直接拒绝，不能注入上述凭据。应用对网关凭据做定时安全比较，缺失/错误或协议不是 https 时拒绝。凭据仅上游和网关持有，不提供给财务系统；配置文件 0600，不通过 `nginx -T` 等诊断输出展示。仍需封闭应用直连并逐跳验证 TLS，独立凭据不代替网络加密。
-3. 对精确路径 `/internal/store-accounts/*/password/reveal` 禁止网关缓存、响应落盘缓冲、CDN缓存、请求/响应体及 Authorization 采集；包括 APM、WAF、异常上报、链路追踪和调试抓包。网关日志只允许时间、方法、路径（不带参数）、状态、耗时、追踪 ID。不要采集响应对象。
-4. 网关自己的 403/404/429/503 也使用脱敏 JSON、`Cache-Control: no-store` 和追踪 ID；不得返回上游诊断页。禁止将该路由接入通用 `withApi`/request logger；目前路由直接返回白名单响应，不记录异常对象。
-5. 数据库查询结果包含当前明文密码；严禁记录 SQL 结果、绑定参数或异常对象，不要启用该连接池的参数/结果追踪。密码写入及历史格式迁移期间同样关闭 PostgreSQL/pgAudit 的绑定参数和错误参数记录。
-6. 财务后端同样禁用正文采集、缓存及异常对象打印。浏览器在进入已授权页面后只读取当前可见页，避免 localStorage/sessionStorage/Service Worker 持久化；页面隐藏或离开时清除页面密码，不把密码放入通知、埋点或消息队列。
-
-## 视图与审计迁移
-
-初始迁移：`prisma/migrations/20260908120000_store_account_password_reveal/migration.sql`。明文状态修复：`prisma/migrations/20260909100000_fix_store_account_password_configured_plaintext/migration.sql`。
-
-- 新增 `StoreAccountPasswordAccessAudit`，固定字段为请求追踪 ID、人员标识、服务身份、账号 ID、用途、HTTP状态、数据库时间；不关联用户/店铺外键，以保留未授权、不存在和删除账号的失败审计。状态 200 表示成功，其他状态表示失败。
-- 只在原视图存在时，以原视图查询作为子查询，在末尾追加 `passwordConfigured boolean`，保留原字段、筛选、每行内容、ID、所有者与 ACL；`EXISTS` 不会产生重复行。未配置外部视图的环境不擅自创建外部读入口。
-- `passwordConfigured` 的当前定义为 `passwordCiphertext <> ''`。修复迁移仅替换这个布尔表达式，并在事务内核对原字段逐行内容、视图所有者和 ACL 未变；不读取或输出密码。
-- 明文迁移已由独立脚本完成。本状态修复不改任何密码或银行账号数据，也不增加普通只读账号权限。审计数据至少保留 365 天。
-
-迁移前由 DBA 只读确认目标库、视图定义/所有者/ACL、字段顺序、行数与唯一性、密码聚合、普通读取账号和其成员角色权限。若生产仍以本次基线验收，COUNT 与 DISTINCT id 必须均为 958；若业务新增/删除则暂停并重新确认基线，不改数据凑数。
-
-备份与执行顺序（生产必须在明确批准后执行）：
-
-1. 备份当前 `main`/部署 SHA、现有视图 DDL/ACL/所有者及 `_prisma_migrations` 状态。生成目标库 `pg_dump -Fc` 备份并验证可读取；备份进入生产主机权限 0700 目录，文件 0600，不进入 Git 或共享日志。备份可能含密文，按敏感材料管理。
-2. 本次不修改任何密码、银行卡号或服务令牌；备份不得进入 Git 或普通日志。
-3. 执行明文状态修复迁移，视图短时获得 DDL 锁（最多等 5 秒，执行预算 30 秒）；不回放未审查的其他迁移。
-4. 在同一只读快照比较迁移前后原字段行集、顺序/类型、行数/唯一性和权限；运行 `scripts/sql/check-store-account-password-reveal.sql`，确认最后字段 boolean，报告 true/false/null 聚合。预计当前数据为 957/1/0，但必须执行后实测。
-5. 按项目主线发布流程部署，完成逐跳 TLS、网关日志/限流/缓存检查后再配令牌。生产虚构账号的创建、调用与删除属于额外生产写入，需单独批准；不要调用真实账号作为测试。
-
-回滚：先移除财务令牌阻止新调用并回退应用 SHA。新增状态列与审计表可安全保留以避免丢失审计；旧应用不依赖它们。需要完整结构回退时，经 DBA 检查依赖后，在事务中以备份 DDL 重建旧视图并恢复原所有者/ACL（PostgreSQL 不允许 `CREATE OR REPLACE VIEW` 删除尾列，禁止随意 `DROP ... CASCADE`）。审计记录保留，不直接删表；按项目规则处理已应用迁移历史，禁止直接删除 `_prisma_migrations` 记录或用 `db push`。任何完整结构回退先在隔离库演练。
-
-## 密钥轮换
-
-服务令牌：在受限凭据系统生成新随机令牌；旧值暂放 `STORE_ACCOUNT_FINANCE_TOKEN_PREVIOUS`，新值放主变量，重启上游；更新财务后端，使用虚构账号验收；移除旧值并重启。两值对应同一服务身份，审计/额度不变。怀疑泄露时立即撤销旧值，宁可短暂拒绝请求。
-
-网关凭据：暂停此接口，在网关及上游同时更新 `STORE_ACCOUNT_REVEAL_EDGE_TOKEN` 后验收并恢复；不支持旧值并行。不得将网关凭据与服务令牌设成相同值。
-
-历史兼容密钥：当前明文规则不需要为新值轮换数据密钥。若确认数据库中不存在 `v1:` 值并且备份保留策略允许，可另行评估退役历史解密密钥；退役前必须检查备份恢复场景，不能直接删除。
-
-## 本次验证记录
-
-- 当前页批量扩展的服务、HTTP 路由和代理边界共 3 个测试套件、41 项测试通过；`npm run type-check` 通过。测试覆盖 1–50 个账号、重复账号拒绝、部分 404/429/503、批次与每账号审计，以及失败时不返回明文。
-- 单元/HTTP/代理路由测试：34 项通过，含伪造 HTTPS URL/转发头和错误网关凭据拒绝。
-- 追加现有代理路由的 7 项回归，与 10 项集成测试合计 6 套件、51 项全部通过。
-- 隔离本地 PostgreSQL 集成测试：10 项通过，覆盖完整加解密与 HTTP handler、已提交审计、403/404/429/no-store、并发/跨实例限流、分钟/24小时配额、审计失败拒绝泄露、原字段及筛选保留、958/958 与 boolean 957/1/0、普通只读角色拒绝基表/密码/审计读取。
-- 开启本地测试连接的 PostgreSQL statement 日志，只在内存扫描 `docker logs`；应用日志、审计行、SQL请求与真实数据库日志均未检出随机测试密码。测试无需打印测试密码，断言只输出布尔结果。
-- Type-check 通过；范围内 ESLint 通过。全仓库主数据边界巡检有 6 项已有违规，均位于本次未修改模块；不得据此声称全仓库通过。
-- 2026-09-09 生产只读复核确认：958 行、958 个唯一 ID、957 条非空密码、1 条空密码；旧正则导致状态误报为全 false。本迁移用于恢复预期聚合 true/false/null = 957/1/0。
-
-运行：`npx jest --runInBand --runTestsByPath src/server/services/store-account-password-reveal.service.test.ts src/proxy-store-account-reveal.test.ts "src/app/internal/store-accounts/[id]/password/reveal/route.test.ts" tests/integration/store-account-password-reveal.test.ts`。未配置本地测试库变量时，集成套件明确 skip，不能算真实数据库验收通过。
-
-收口：**passed with warnings**。这是自审，不是独立复审。Route → Service → Repository 边界保持；未修改 UI；状态字段与当前明文存储规则对齐，专用认证、审计和限流边界不变。

furniture-3d-system/docs/workflow/1688-dropship-integration.md

@@ -1,101 +0,0 @@
-# 1688 Dropship Integration
-
-## Scope
-
-The module at `/supply-chain/new-products/1688-dropship-data` includes the DF
-product table, date and multi-select column filters, real-performance ordering,
-and daily/weekly/monthly trend details with prior-month comparisons.
-
-It reads the shared product archive and daily sales fact table. The shared
-`barcode + statDate` key, unmatched source barcodes, synchronization lock,
-staging, and atomic publication are preserved. No second daily table or
-archive foreign key is introduced.
-
-## Field Contract
-
-| Display | Source / calculation |
-| --- | --- |
-| Sales amount | `sales_amount` -> daily `salesAmount` |
-| Real performance | `real_performance` |
-| After-sale amount | `after_sale_amount` |
-| After-sale cost rate | After-sale amount / real performance; blank for zero denominator |
-| Gross profit | Real performance - clear sales cost - send freight |
-| SKU operator | DF barcode/day distinct `ider`, latest nonempty value in selected period |
-| Total cost | Latest available daily `unitCost + estimatedFreight` in selected period; missing components are displayed as zero |
-| Unit cost | Latest available daily DF cost from `goods_count = 1` observations; the existing product cost excludes freight; missing values are displayed as zero |
-| Estimated freight | Average `send_freight` for the same DF barcode/day where `goods_count = 1`; the stored value remains null when no quantity-one observations exist and the page displays zero |
-
-The archive's existing `shipAmount` continues to use `clear_goods_cost`.
-It must not be substituted for the dropship module's `salesAmount`.
-Cost ties use quantity-one frequency, total frequency, then descending unit cost. The page displays total cost before unit cost and estimated freight.
-
-## Deployment Prerequisites
-
-Code publication is not production deployment or database/data synchronization.
-No credentials, database dumps, local accounts, or local environment files are
-included in this change.
-
-1. Confirm the target PostgreSQL identity, backup, and migration readiness using
-   the repository deployment/database workflow. Apply migration
-   `20260912120000_add_daily_sales_dropship_fields` after the existing mainline
-   daily-sales migration. Do not replay the old local prototype's daily-table
-   creation migrations against the mainline database.
-2. Generate the Prisma client and build the application with the target's
-   existing environment configuration.
-3. Run the existing `npm run sync:supply-chain-product-archive-daily --` command
-   with `--backfill`, `--apply`,
-   `--confirm=sync-supply-chain-product-archive-sales-performance-daily`,
-   `--expected-database-identity=...`, and
-   `--expected-source-database-identity=...` using verified identities.
-   The upstream requires read access to the configured
-   `JST_REPORT_DB_SCHEMA.dws_sn_sales_full_info_di`; credentials remain in the
-   target environment's `JST_REPORT_DB_*` variables.
-4. Check the completed sales sync run, historic DF `salesAmount` completeness,
-   module view permission `newProduct1688DropshipData`, images, filters, totals,
-   and trend comparisons. The existing daily schedule then maintains the data.
-
-The migrations add `skuOperator` (empty by default), `unitCost` (nullable),
-`estimatedFreight` (nullable), and `salesAmount` (nullable). Historical facts need a backfill; the ordinary
-seven-day refresh does not populate all older dates. Until backfilled, unknown
-sales totals display as `--`, not zero or shipped amount.
-
-Filtering uses the existing cache service with user-scoped keys and a 24-hour
-TTL. Multi-process deployments should provide the existing shared Redis cache.
-The module uses its own authenticated DF-only image route under
-`/api/supply-chain/1688-dropship-data/source-image`. Its view permission does not
-require granting access to the full product archive; the shared image service
-and its source/URL restrictions are retained.
-Rollback can restore the prior application version while retaining the additive
-columns; do not drop the daily table or discard its history.
-
-## Validation And Review
-
-Independent review conclusion: `passed with warnings`. Architecture and
-root-cause handling passed, including the corrected image-permission boundary.
-The existing visual implementation was retained; target-environment screenshots
-and real-data acceptance were not performed in this integration.
-
-Final integration includes shared-mainline update `5156ead4`, retaining its
-separate dropship-issues entry and permissions. After merging, 20 focused Jest
-suites (171 tests), TypeScript checking, relevant ESLint, and the production
-build passed. The build retains two unrelated broad-file-pattern warnings in
-the existing OCR route and DWG wrapper.
-
-The integration was checked with focused Jest suites for the page, trends,
-filters, permissions, image route, service/repository mapping, and shared daily
-sync; TypeScript checking; changed-file ESLint; and a production build using
-isolated placeholder configuration (no live database). An in-memory PostgreSQL
-compatibility replay confirmed that the additive migration retains existing
-DF/non-DF facts and the original primary key. Image-route tests exercise the
-real request/auth wrapper, including module-only access and denied requests.
-
-The repository-wide `db:verify-master-data:code` and
-`db:verify-master-data:truth` audits still fail on existing baseline issues.
-Independent comparison with clean shared-mainline commit `38259cc4` found no
-new blocking findings: code-audit finding content is unchanged apart from
-schema line offsets, and the truth-audit JSON is identical. These global audit
-failures are not presented as passing checks.
-
-No target deployment, live target database migration/backfill, or live-data
-browser validation of the integrated version is included in this publication.
-The existing local test application and its prototype database are unchanged.

furniture-3d-system/docs/workflow/产品全量档案同步性能治理.md

@@ -1,78 +0,0 @@
-# 产品全量档案同步性能治理
-
-## 范围与业务规则
-
-本次治理覆盖源库集中取数、匹配索引、事务批量写入、来源快照、断点续跑与日销优先调度。保留字段来源、负责人优先级、只填空值、首次来源初始化不记变更日志等既有规则。
-
-公司 SQL Server 只读，使用个人账号。验证写入只发生在本机 PostgreSQL 55432 的独立测试 schema；public 业务表只读。本轮没有生产配置、定时器或生产数据变更，没有提交、推送、main 合并或部署。
-
-## 来源读取
-
-- 一轮先固定档案 id、条码、SKU、供应商、仓库及初始图片状态，再集中读取价格、公共库存、清仓、库存监控、供应商、仓库、图片七类来源。最多两个来源同时读取，每个来源尝试独占一个连接池，池大小为 1。
-- 请求通过 OPENJSON 传入，不受原每 200 条重复查询限制。库存监控仍按原始目标批次匹配和选最新记录，保留条码优先、SKU 唯一兜底的口径。
-- 图片保留 DF 全量刷新、nonDF 仅补当前无图档案的范围。主视图 jst_skumap 按 shop_id、shop_i_id、shop_sku_id 三列主键每页 50,000 条读取编码，再按命中的主键精确读取图片；另外两张图片表分别以哈希匹配读取请求编码，并读取 DF 范围；重复命中由最新非空选择去重。使用 COMPRESS 与 UTF-16 JSON 无损传输，跨页、跨表选择最新非空图片，保留时间的亚毫秒顺序，不截断图片。
-- 每个来源的成功结果独立原子保存，带 SHA-256、条数和行结构校验。重启复用已完成来源，失败来源重新读取；来源未读完不发布部分结果。图片三张表还会分别保存已完成结果，失败后只重读未完成的表；主表内部分页尚不持久化中间页。
-- 每次请求有完整传输的墙钟限时：图片 600 秒，其他来源 300 秒。PRODUCT_ARCHIVE_SNAPSHOT_QUERY_TIMEOUT_MS 可统一覆盖，范围 1,000～600,000 毫秒。超时取消请求，以 ETIMEOUT 进入原有 30 秒、120 秒、300 秒退避重试；认证、权限、结构错误不重试。
-- 每批写前重新读取当前人员与图片，保留人工负责人保护；条码、SKU、供应商或仓库改变时拒绝旧快照。原先已有图的 nonDF 档案中途被清空，也要求新的 run key，避免使用未请求对应图片的旧快照。
-- 各来源在不同时间读取，不构成跨公司库与应用库的同一时刻事务快照。后续新 run key 会重新读取来源。
-
-## 匹配、写入与调度
-
-- 来源数组建立索引，共享图片索引跨批复用。保留原 find 的首条命中与原始来源顺序。
-- 每批最多 200 档案，在一个事务中按 id 排序锁定当前行，更新变化字段、字段来源、来源记录和逐字段日志。日志失败时整批回滚。来源日期传值、明确 null、未传三种状态保持原行为。
-- Service 计算计划，Repository 负责数据访问与事务；Repository 只通过参数接收 planner，不在运行时调用 Service。
-- PostgreSQL advisory lock 命名空间 90710：3 为写入轮次，4 为日销意向，5 为全量任务排他。日销先登记意向，后台当前批完成后让行。同库重复全量任务返回 SKIPPED_RUNNING；连接中断后拒绝继续写。
-- 主补全与 JST 基础档案按批让行。负责人流程与生产类型阶段以整阶段持锁。JST 某项写入失败时停止启动新项，等待同批已发出写入结束后再释放锁，不保存失败批次进度。
-- 匹配 mapper 保留原映射职责；类型、索引、快照、编排和事务已按职责拆分。没有新增界面或视觉样式。
-
-## 运行与续跑
-
-入口：scripts/sync-supply-chain-product-archive-enrichment.ts。保留 --apply、固定确认词、目标库及来源身份门禁。
-
-- 默认 run key 为北京时间日期；相同配置重启继续已提交批次，已完成阶段跳过。
-- 跨天续跑使用原 run key，例如 --run-key=2026-10-21。
-- 同日需要重新读取最新来源时使用新 key，例如 --run-key=2026-10-21-second，保留原断点。
-- 目标库、来源身份、关键代码或批次参数变化会拒绝旧断点；损坏文件不会静默按空来源继续。
-- 断点经临时文件、fsync、原子 rename 保存。批次提交后、保存前中断会重放该批，通过比较当前值避免重复记录未变化字段。
-- 默认目录：本地 D:\ChanPing\.local-services\checkpoints\product-archive-sync；生产发布结构下 shared/product-archive-sync-checkpoints。可用 PRODUCT_ARCHIVE_SYNC_CHECKPOINT_DIR 指定。
-- ARCHIVE_SOURCE_SNAPSHOT 输出来源读取与复用状态，ARCHIVE_PICTURE_PAGE 输出主表扫描及命中进度，ARCHIVE_SYNC_BATCH 与 ARCHIVE_SYNC_PHASE 输出批次和阶段计时。
-- 本机 Node、Jest、TypeScript、ESLint 都通过 .local-services/scripts/invoke-node-hidden.ps1 启动。
-
-## 验证记录（2026-10-21）
-
-全部写入位于本机独立副本 archive_full_1792578871629。基础来源真实读取 81,070 条，副本从 75,527 档案增至 81,074 条。随后覆盖全部档案，对修改前 mapper/applyPatch 构建的独立 oracle 逐批核对档案业务字段、来源业务字段和逐字段日志。排除 id、自动更新时间、同步时间等每轮必然不同的元数据。
-
-- 全部 81,074 档案通过；比较 1,092,416 条来源记录及 15,290 条新增逐字段日志，结果一致。
-- 首、中、末三个 200 条批次的六类来源共 18 项新旧取数对比通过。
-- 图片主表 24,581,427 行按主键读至表尾，和独立 COUNT_BIG 结果一致；命中并精确回查 64,382 行，三表完成后得到 32,944 个最新非空图片编码。
-- 13 组、97 项相关测试通过；TypeScript、源码 ESLint、diff --check 通过；3001 健康接口 database=connected、api=running。
-- 在真实本机 PostgreSQL 验证日志失败整批回滚、日销在后台批次间优先、失败释放锁及同库全量排他。测试也覆盖后表失败复用主表、来源快照损坏、断点恢复、超时取消和 JST 失败等待已发出写入结束。
-
-### 分阶段计时
-
-以下是同一独立副本的分阶段实测，包含真实公司库读取与本地写入。部分来源读取在前置阶段完成，并在完整比对时复用，故这是分阶段累计，不是一次连续正式站整轮耗时。为了便于评估，累计值单独加上已提前读取的六类来源时间，且未扣除生产并发取数可能节省的重叠时间；旧逻辑 oracle 比对开销不计入执行成绩。
-
-| 阶段 | 实测 |
-| --- | ---: |
-| 基础商品来源 81,070 条 | 173.81 秒 |
-| 基础档案写入（更新 75,523，新增 5,547） | 270.33 秒 |
-| 负责人流程首次应用（变更 2,317） | 51.36 秒 |
-| 提前读取的六类非图片来源，分别累计 | 204.30 秒 |
-| 三表图片完整取数 | 806.17 秒 |
-| 共享数据、补全匹配和写入（复用来源，扣除 oracle 比对） | 81.08 秒 |
-| 产品类型实际同步 | 39.68 秒 |
-| 分阶段累计 | 27.11 分钟 |
-
-图片主表单独耗时 787.83 秒，三表总图片来源 806.17 秒。完整补全验证实际墙钟 5.77 分钟，其中旧逻辑比对 4.42 分钟。
-
-另一个 1,000 档案旧新写入试验中，匹配加写入从 44.13 秒降至 0.92 秒，约 48 倍；该局部试验不含源库，不能作为整轮加速倍数。
-
-### 适用限制与收口
-
-公司库负载和网络有波动。先前相同来源的读取曾明显变慢，不能据本地累计值承诺正式站固定耗时。完整生产成绩需正式发布后实测。负责人和产品类型阶段以整阶段让行；图片恢复以单表完成为边界，未完成的主表仍需重读。增量镜像、公司库索引与 DDL 不在本次范围。
-
-本轮未提交、推送、合并 main 或部署，生产写入为 0。提交状态：可提交；main 标记：可合并 main。源码、测试及本说明共 31 个文件，登记为 awaiting_review。
-
-规范结论：passed with warnings，这是自审，不是独立复审。架构职责保持；无视觉改动；修复重复扫描、线性查找、逐条事务和失败后重读已完成来源的原因。警告为尚无连续生产整轮计时及上述阶段让行限制。
-
-审计证据：D:\ChanPing\.local-services\audits\archive-sync-performance-20261021\complete-review-result.json。

furniture-3d-system/docs/workflow/产品全量档案图片索引操作说明.md

@@ -1,54 +0,0 @@
-# 产品全量档案图片索引操作说明
-
-全量档案本地图片索引只读取 `SupplyChainProductArchive.image`。上游「我司 SKU 命中」继续使用现有独立图搜服务。
-
-## 更新规则
-
-- 有图片且没有索引：建立索引。
-- 图片地址变化、旧索引失效、模型版本或向量规格变化：重新索引。
-- 图片为空或地址已经变化：旧向量退出本地搜索。任务会把旧记录标为 `STALE`。
-- 下载或计算失败：保存 `FAILED` 和原因，六小时后再次尝试；图片地址再次变化则立即处理。
-- 图片内容相同、地址不同：复用向量并更新地址与状态，避免反复处理同一张图片。
-- 下载、计算期间图片改变或产品删除：提交前锁定并核对档案行，丢弃过期结果，下一轮处理最新图片。
-- 所有索引任务使用同一 PostgreSQL 会话锁，避免手动补索引、同步触发与定时任务并发计算。
-- 正常增量任务不会重新下载全部已就绪图片；同一 URL 下替换了图片内容时，使用完整内容核验命令。
-
-## 本地命令
-
-在主应用目录执行，模型沿用现有 `IMAGE_SEARCH_MODEL_PATH` 或 `.local-services/models/dinov2-small`。
-
-```bash
-# 每次最多处理 200 条缺失、换图或到期重试记录
-npm run image-search:index
-
-# 补齐当前全部待处理记录，并立即重试历史失败
-npm run image-search:index -- --limit=0 --retry-now
-
-# 下载所有带图档案，核验同一 URL 下的图片内容变化
-npm run image-search:index -- --all --limit=0
-```
-
-命令持续输出已处理、成功、复用、失败、跳过、过期结果丢弃和失效条数；失败行输出条码与原因。最后输出本轮结果及待处理数量。失败仍会进入后续重试，本轮失败数必须单独关注，`remaining` 只计算已到重试时间的记录。
-
-## 生产启用
-
-代码必须先进入被授权的 `origin/main`，再经统一部署入口发布。安装定时器与首次补索引按用户授权执行，不能把本地开发完成等同于生产已启用。
-
-安装入口：`scripts/install-product-archive-image-index-timer.sh`。它要求现有生产模型文件齐全，并让任务显式使用共享模型目录。当前应用启动命令已注入模型路径，无须为本功能重写应用环境。
-
-- 服务：`furniture-product-archive-image-index.service`。
-- 定时器：`furniture-product-archive-image-index.timer`，每五分钟检查，单次最多处理 200 条，失败六小时后重试。
-- 两个现有全量同步服务分别增加本功能自己的 `image-index.conf`，同步成功后异步启动索引服务。
-- 前台保存、导入及其他来源的图片变化由五分钟定时检查覆盖；索引下载与推理不阻塞保存请求。
-- 通过 `PRODUCT_ARCHIVE_IMAGE_INDEX_LIMIT` 可在安装时调整单次处理上限。
-- 脚本和日志通过发布目录与 systemd 管理，不手工修改发布目录。
-
-```bash
-bash scripts/install-product-archive-image-index-timer.sh
-systemctl status furniture-product-archive-image-index.timer --no-pager
-journalctl -u furniture-product-archive-image-index.service -n 50 --no-pager
-```
-
-首次补齐历史缺口可等待定时任务分批完成；需要一次补完时，手动索引命令必须指向共享模型路径。运行中的另一索引任务会返回 `LOCKED`，稍后重试。
-
-验收应核对有图档案与索引的关联，而不是只看 `READY` 行数：当前地址一致、状态 `READY`、模型版本与 768 维向量均符合要求才是可用索引。历史 404 或不可读取地址不能靠索引任务生成图片，需要按条码定位源图片问题。

furniture-3d-system/docs/workflow/外部只读数据库开放操作说明.md

@@ -21,16 +21,13 @@ SELECT *
 FROM external.product_catalog_wide_v1;
 ```
 
-这张视图是一条码一行。正式 `Product / ProductSKU` 已存在时输出正式条码商品行；正式商品尚未落库但 non-integrated 已进入 ready 状态时，补输出可消费的开发阶段条码行。外部系统必须按 `barcode_business_key` 做主同步、去重和幂等更新；同一 SKU 下多个条码会输出多行。
+这张视图是一 SKU 一行。正式 `Product / ProductSKU` 已存在时输出正式商品行；正式商品尚未落库但 non-integrated 已进入 ready 状态时，补输出可消费的开发阶段 SKU 行。外部系统按 `barcode_business_key` 做主同步。
 
 补充口径：
 
 - non-integrated ready 行会带上主图、开发阶段限价和基础商品字段。
-- non-integrated ready 行会带上产品开发明细页的负责人字段：外观设计师、结构设计师、SPU 负责人、商品企划、空间设计师、采购负责人；正式商品行没有开发阶段上下文时这些列保持空值。
 - non-integrated ready 行尚未正式化时，正式 BOM、包装库存、仓库库位和 SKU 质检摘要字段会保持 `0 / NULL / []`。
 - 需要核对开发阶段头信息或 SKU 明细真值时，继续读取 `external.intake_products_ready_v1 / external.intake_sku_items_ready_v1`。
-- 图片、模型、贴图等 URL 字段在外部视图中输出为完整系统入口，例如 `https://cp.jiansun.vip/api/storage/object?key=...`。这些入口仍由应用侧鉴权和对象存储跳转控制，不把私有桶短期签名 URL 固化进数据库。
-- 非生产环境如需使用其他站点域名，可由数据库管理员设置 `ALTER DATABASE <DB_NAME> SET app.external_asset_base_url = '<APP_ORIGIN>';`；未设置时默认使用正式站点 `https://cp.jiansun.vip`。
 
 限价口径固定如下：
 
@@ -42,15 +39,14 @@ FROM external.product_catalog_wide_v1;
 
 | 方向 | 推荐视图 | 用途 |
 | --- | --- | --- |
-| 产品资料 | `external.product_catalog_wide_v1` | 一条码一行的商品目录宽表，覆盖正式条码与可消费的 non-integrated ready 条码 |
+| 产品资料 | `external.product_catalog_wide_v1` | 一 SKU 一行的商品目录宽表，覆盖正式 SKU 与可消费的 non-integrated ready SKU |
 | 产品限价 | `external.intake_product_limits_v1` | 非集成产品限价来源明细 |
+| 产品资料明细 | `external.product_assets_v1` / `external.product_bom_v1` | SKU 素材和 BOM 明细 |
 | 仓库管理 | `external.warehouse_locations_v1` | 库位资料 |
 | 仓库管理 | `external.sku_warehouse_stock_v1` | 正式 SKU 库存和库位 |
 | 仓库管理 | `external.packaged_items_v1` | 已关联正式 SKU 的包装库存项 |
 | 仓库质检 | `external.sku_quality_inspections_v1` | SKU 质检记录 |
 
-补充说明：`external.product_assets_v1` / `external.product_bom_v1` 是外部契约巡检覆盖的明细视图，但不在当前 `external_core_reader` 核心授权包内；外部系统确实需要逐条素材或 BOM 时，必须单独评审并追加白名单授权。
-
 暂不开放：
 
 - `public` schema 原表。
@@ -149,60 +145,7 @@ psql "postgresql://external_core_reader:<REDACTED_SECRET>@<DB_HOST>:5432/<DB_NAM
 psql "$DATABASE_URL" -f scripts/sql/check-external-readonly-contract.sql
 ```
 
-## 7. 同步到 JSReportReplica.app 中间库
-
-如果外部系统不直接连本项目 PostgreSQL，而是统一从 `JSReportReplica` 中间库读取，本项目维护一份 `external` 核心视图到 `app` schema 的项目专属前缀表同步。
-
-`JSReportReplica.app` 是多个项目共用的应用 schema，本项目同步目标表固定使用 `furniture3d_` 前缀，避免和其他项目的对外数据混用。源库视图仍是 `external.*`，只有中间库目标表加前缀。
-
-默认同步表：
-
-- `app.furniture3d_product_catalog_wide_v1`
-- `app.furniture3d_intake_product_limits_v1`
-- `app.furniture3d_warehouse_locations_v1`
-- `app.furniture3d_sku_warehouse_stock_v1`
-- `app.furniture3d_packaged_items_v1`
-- `app.furniture3d_sku_quality_inspections_v1`
-- `app.furniture3d_external_readonly_sync_runs`：同步运行日志。
-
-主宽表仍然是：
-
-```sql
-SELECT *
-FROM app.furniture3d_product_catalog_wide_v1;
-```
-
-同步入口：
-
-```bash
-npm run sync:external-jsreport
-npm run sync:external-jsreport:apply
-```
-
-第一个命令只演练并输出源视图行数；第二个命令才会写入 `JSReportReplica.app`。脚本会先写临时表，再替换正式表，避免同步中途留下半截数据。
-
-生产定时器安装入口：
-
-```bash
-bash scripts/install-external-jsreport-sync-timer.sh
-```
-
-安装脚本只会在生产服务器本地生成 `/opt/furniture-3d-system-prod/shared/external-jsreport-sync.env` 模板。真实连接信息只允许写在这个本地 env 文件里，并保持 `600` 权限，不要写入 Git、文档或群公告。
-
-必要环境变量：
-
-- `DATABASE_URL` 或 `EXTERNAL_JSREPORT_SOURCE_DATABASE_URL`：源 PostgreSQL 连接。
-- `JSREPORT_REPLICA_HOST`
-- `JSREPORT_REPLICA_PORT`
-- `JSREPORT_REPLICA_DATABASE`
-- `JSREPORT_REPLICA_USERNAME`
-- `JSREPORT_REPLICA_PASSWORD`
-- `JSREPORT_REPLICA_SCHEMA`
-- `EXTERNAL_JSREPORT_TARGET_TABLE_PREFIX`：中间库目标表前缀，默认 `furniture3d_`。
-
-默认定时频率是每 45 分钟同步一次。安装后 5 分钟触发首次同步，后续按上次同步完成时间间隔 45 分钟再次执行；可通过 `EXTERNAL_JSREPORT_SYNC_ON_BOOT_SEC` 调整首次触发延迟，通过 `EXTERNAL_JSREPORT_SYNC_INTERVAL` 调整同步间隔。
-
-## 8. 规范审查
+## 7. 规范审查
 
 结论：`passed`
 

furniture-3d-system/docs/workflow/生产部署入口说明.md

@@ -24,20 +24,6 @@
 
 只做生产/目标库地基核查时，优先在远端应用目录执行 `npm run db:foundation:audit:production-readonly`。该命令不事务回放治理迁移 SQL，只通过只读迁移状态和质量查询生成 `.master-data-audits/foundation-production-readonly-current/manifest.json`，适合把脱敏 summary 或 manifest 交回主线收口。拿到 manifest 后，用 `npm run db:foundation:verify-production-readonly -- --manifest <manifest.json>` 做机器验收；只有 `accepted: true` 才能把这份证据计入生产级地基收口。
 
-## 聚水潭 RPA 登录凭据
-
-- 本地可在 `furniture-3d-system/.env.jst-rpa-auth` 保存
-  `JST_RPA_LOGIN_ID` 和 `JST_RPA_LOGIN_PASSWORD` 两项。该文件被 `.env*`
-  忽略规则排除，禁止提交 Git。
-- 正式部署脚本会自动发现该文件，上传到目标机 `incoming` 临时目录，再安全合并进
-  `/opt/furniture-3d-system-prod/shared/.env`；正式 `.env` 和临时文件均保持
-  `600`，临时文件在部署结束后删除。
-- 使用其他安全位置时，可给部署入口显式传
-  `-JstRpaAuthFile <凭据文件绝对路径>`。未提供文件时会保留正式机已有值，不会被空值覆盖。
-- 部署完成后可执行
-  `node_modules/.bin/tsx scripts/jst-shop-goods-rpa.ts --action=login`
-  验证登录态，不执行链接导出。
-
 ## 花名册同步
 
 - 花名册同步属于当前 `furniture-3d-system` 自有能力，不依赖 `shujuku2` 或旧入口机。
@@ -48,57 +34,6 @@
 - 定时频率：每天 `03:00` 和 `15:00`。
 - 源库连接信息只允许放在生产本地 `/opt/furniture-3d-system-prod/shared/employee-directory-sync.env`，不能写入 Git 或共享文档。
 - 生产应用内部接口密钥继续从 `/opt/furniture-3d-system-prod/shared/.env` 的 `HR_SYNC_SECRET` 读取。
-- 人员信息表的钉钉组织同步使用 `furniture-3d-system/scripts/install-dingtalk-directory-sync-timer.sh`，生产 systemd 名称为 `furniture-dingtalk-directory-sync.service` / `furniture-dingtalk-directory-sync.timer`。
-- 钉钉同步每天 `03:00` 执行一次，读取生产共享 `.env` 中的 `DINGTALK_API_CLIENT_ID` 和 `DINGTALK_API_CLIENT_SECRET`，并自动更新人员信息；正式页面仍保持只读。钉钉网页登录使用独立的 `DINGTALK_LOGIN_CLIENT_ID`、`DINGTALK_LOGIN_CLIENT_SECRET`，两组凭据不能混用。
-- 人员信息的每日更新口径：钉钉新人自动新增一行；在职人员按钉钉更新部门/负责人；人工覆盖（manualOverride）的行保持不变；**离职人员不做删除，只在页面把「在职状态」变为离职**（方案 B：先比对上一轮在册且本轮抓取范围内消失的人，再逐个调 `user/get` 确认 60121 用户不存在才标记；抓取人数明显缩水时整轮跳过并写入告警）。
-- 首次部署后需在正式服务器执行该安装脚本，并手动执行一次 `npm run sync:dingtalk-directory:apply` 完成首次填充；后续由 systemd 每日执行。
-
-## BOM 成本参考镜像
-
-- 用户核算请求只读取本地 PostgreSQL 镜像，不在请求中连接上游 `rpt.pm_bomBaseInfo`。
-- 低压只读预检：`npm run sync:bom-cost-reference -- --dry-run --max-pages=2`；默认单连接、每页 100 行、完整页之间等待 250ms。
-- 真实同步必须显式传 `--apply`、固定确认词、目标 PostgreSQL 身份和来源 SQL Server 身份；上游登录必须是 `report_reader`，`app_writer` 会被程序拒绝。
-- 生产定时器安装脚本：`furniture-3d-system/scripts/install-bom-cost-reference-sync-timer.sh`。
-- 生产 systemd 名称：`furniture-bom-cost-reference-sync.service` / `furniture-bom-cost-reference-sync.timer`。
-- 默认调度：每天中国标准时间 `02:00`，附带最多 10 分钟随机延迟；安装时可通过非敏感环境变量调整。
-- 上游连接继续只使用生产共享 `.env` 中现有的 `JST_PLANNING_SQLSERVER_* / report_reader`；不在第二个文件中重复保存密码。
-- 首次运行安装脚本只会创建权限为 `600` 的 `/opt/furniture-3d-system-prod/shared/bom-cost-reference-sync.env` 门禁与限速模板；目标/来源身份未填齐或现有只读配置不完整时拒绝安装定时器。
-- 本地参考行只保留最新成功批次，避免每日约 76 万行无限增长；历史场景在自己的明细快照中保留来源行、指纹、单价、规则和原始计算依据，不依赖旧镜像行回查。
-- 镜像新鲜度按最新成功批次的完成时间判断。上游当前可见的创建时间只作审计展示，不能用来判断当天同步是否过期。
-- 准确度回测：`npm run backtest:bom-cost-reference -- --sample-size=30`，只读最新成功镜像，不访问上游；样本限制 20 至 50 个，任一可比较 SKU 超过固定 10% 误差门槛即失败。
-- 迁移、真实同步、安装/启用定时器和生产回测都必须另行获得生产操作授权；部署代码本身不代表这些动作已经执行。
-
-## 商品 SABC 月度核算
-
-- 核算命令：`npm run run:product-sabc -- --year=2026 --month=8 --mode=APPLY --confirm=run-product-sabc`；试算（只算不写库）用 `--mode=PREVIEW`，末尾加 `--skip-if-exists` 可跳过已生成月份。
-- 8 月人工表对账命令：`npm run compare:product-sabc-xlsx`，默认读取本机下载的人工工作簿；生产执行前应先完成产品全量档案日销售数据同步。
-- 生产定时器安装脚本：`furniture-3d-system/scripts/install-product-sabc-timer.sh`。
-- 生产 systemd 名称：`furniture-product-sabc-monthly.service` / `furniture-product-sabc-monthly.timer`。
-- 默认调度：每月 3 日中国标准时间 `03:00`，附带最多 10 分钟随机延迟；服务生成上一个自然月的数据，已生成过则跳过（不覆盖管理员的重算结果）。
-- 生成即冻结：每次生成会把整行明细写入 `SupplyChainProductArchiveSabcResult.snapshot`，页面、筛选下拉、导出和经营总览都只读取该快照。生成之后档案的销售状态、人员字段等变化都不会再改变已生成月份的数据。
-- 重新生成（页面「执行核算」）仅限管理员（`ADMIN` / `SUPER_ADMIN`）；其他账号只能查看冻结结果。本地一键刷新 `node scripts/local-sync-archive.mjs` 在每月 3 日前会跳过 SABC 步骤，需要立刻重算时用 `--force-sabc`。
-- SABC 的销售收款总金额、真实业绩、发货件数、商品毛利额和售后金额统一读取 `SupplyChainProductArchiveSalesPerformanceDaily`，与产品全量档案页面保持同一月度口径。
-- 首次安装生成权限为 `600` 的 `/opt/furniture-3d-system-prod/shared/product-sabc-timer.env`，默认 `PRODUCT_SABC_TIMER_MODE=APPLY`；如需先观察可临时改为 `PREVIEW`（只试算不写库、不冻结）。
-- SABC 自动任务只读取现有 `DATABASE_URL`；上游日销售同步任务继续使用 `JST_REPORT_DB_*`，凭据不写入定时器配置。安装、迁移、首次 APPLY 和生产核算都需要单独授权。
-
-## 操作日志保留策略
-
-- 清理脚本：`npm run db:cleanup-operation-logs` 默认只做 dry-run；只有显式传入 `--apply --confirm=cleanup-operation-logs` 才会删除数据。
-- 自动清理范围严格限定为 `OperationLog` 中 `SYSTEM + SUPPLY_CHAIN_PRODUCT_ARCHIVE + details.kind=UPDATED + SUCCESS` 且创建时间早于 30 天的字段变更。
-- 用户操作、商品档案导入、失败/重试日志及其他业务范围日志至少保留 365 天；本次策略不自动删除超过 365 天的审计日志。
-- 生产安装入口：`furniture-3d-system/scripts/install-operation-log-retention-timer.sh`。
-- 生产 systemd 名称：`furniture-operation-log-retention.service` / `furniture-operation-log-retention.timer`，默认每天中国标准时间 `04:30` 执行，附带最多 10 分钟随机延迟。
-- 安装脚本会在 `/opt/furniture-3d-system-prod/shared/operation-log-retention.env` 保存权限为 `600` 的数据库身份门禁和非敏感参数；身份未填写或保留天数不是 30 天时拒绝启用。
-- 首次启用前必须先在生产执行 dry-run，核对候选数量、数据库身份和 systemd 落点；生产安装、首次 `--apply` 和后续代码部署均需另行获得授权。
-
-## 停产需求确认超时收口
-
-- 收口脚本：`furniture-3d-system/scripts/finalize-production-stop-confirmations.ts`，把超过确认截止时间仍未反馈的停产需求按「默认同意停产」落库，并给未反馈的确认人记 `TIMEOUT` 票。
-- 生产安装入口：`furniture-3d-system/scripts/install-production-stop-confirmation-finalize-timer.sh`。
-- 生产 systemd 名称：`furniture-production-stop-confirmation-finalize.service` / `furniture-production-stop-confirmation-finalize.timer`，默认每 10 分钟检查一次（北京时间），附带最多 1 分钟随机延迟；可用 `PRODUCTION_STOP_FINALIZE_CALENDAR` 覆盖调度。
-- 收口逻辑幂等：只处理「已过截止时间且仍待确认」的需求，重复执行不会重复收口；失败由 systemd 在 5 分钟后自动重试。
-- 运行日志：`journalctl -u furniture-production-stop-confirmation-finalize -n 100 --no-pager`，每次运行输出本次收口的需求数量。
-- 首次安装与启用：在项目根执行 `bash scripts/install-production-stop-confirmation-finalize-timer.sh`（需 root，脚本写入 `/etc/systemd/system/` 并 `enable --now`）；安装/启用定时器属于生产操作，需要另行获得授权。
 
 ## 明确排除
 

furniture-3d-system/docs/workflow/铺货与业绩快照定时更新.md

@@ -1,23 +0,0 @@
-# 铺货与业绩快照定时更新
-
-本机 3001 的 Windows 计划任务 `Furniture-DistributionSnapshots-3001` 每天北京时间 09:00 顺序更新铺货明细、真实业绩。任务使用 `+08:00` 开始边界；错过时间后在机器可运行时补执行，重复触发不并发。电脑需开机、用户登录且公司报表库与本地 PostgreSQL 可连接。此任务未配置到正式站。
-
-本机入口在 `D:\ChanPing\.local-services\scripts\run-distribution-snapshots.vbs`，依次调用隐藏 PowerShell、统一 Node 无窗口入口和个人凭据注入器。凭据仅运行时读取 `LOCAL_SECRETS.md` 的公司数据库节，不进入源码或日志。所有公司库操作均为 SELECT。
-
-仓库入口 `scripts/sync-distribution-snapshots.ts` 验证来源和目标身份、持有任务锁，串行执行两个同步 CLI。日志及每次前后计数、含索引物理字节数、业绩统计区间报告写到 `D:\ChanPing\.local-services\logs\distribution-snapshots`。失败返回非零退出码，可从计划任务 LastTaskResult 和阶段日志定位；不自动报告成功。
-
-铺货先读取目标管理、人员、店铺映射，字段一次补齐后写入连接专属临时表。自然键去重后核对实际条数、三类来源，较上一版减少超过 20% 时拒绝发布，等待人工核查。通过后在一个事务中替换正式表，失败保留上一版。最终替换阶段持有表锁，页面查询可能等待；临时表和会话锁会在进程退出后自动释放。没有新增长期全量副本，没有反复 UPDATE 数百万行。
-
-组合补齐：`rpt.jst_comboProductInfo` 与 `rpt.jst_comboProductItem` 只提供完整套装编码、组成条码和数量。同步从三张 skumap 中同时匹配档案条码及包含档案条码的组合编码，每个原始套装规格仅保存一次。轻量组成关系写入 `SupplyChainDistributionComboItem`，与铺货规格在同一事务发布；读取视图 `SupplyChainDistributionListingResolved` 将套装规格关联到组成条码。页面按条码及平台、店铺ID、铺货ID去重，直接铺货与多个套装共享同一链接时计一次，组件数量不乘链接数。链接状态保持 skumap/目标管理原口径，不使用组合头 enabled 替代。关系缺失、组成为空或发布校验失败时保留上一批完整快照。
-
-页面支持搜索组合编码/名称，并在链接明细的条码列查看“直接铺货”“组合套装”或两者共有及具体套装数量。Excel 铺货页保留原始货号和规格，新增独立“组合关系”工作表，避免重复保存/导出整份宽数据。业绩匹配可识别通过套装覆盖的子条码链接；只使用业绩源已经提供的子条码金额，不将套装金额复制或按数量自动分摊。
-
-首次补齐可在两个同步 CLI 上显式增加 `--reuse-direct-snapshot`：先在本地数据库中将已发布的档案直接规格复制到临时表，再从三张源表读取组合规格，整体校验后统一替换。直接规格原有同步时间与内容保留，便于精确比较组合净增量。此选项不用于每日任务；定时任务默认完整刷新直接与组合规格。
-
-业绩沿用独立版本发布：当月截至昨天以内源库最新可用日，按条码、店铺、铺货 ID 汇总；成功后保留当前和上一成功版本。每月 1 日当月无完整统计日时保留前一版并报出失败，页头继续显示实际统计周期。铺货与业绩不能作为一个跨库事务提交：铺货成功但业绩失败时，铺货保留新版本，业绩保留上一成功版，任务整体显示失败。
-
-手动运行和定时执行使用相同入口，不并发补数。此文档不授权部署。
-
-正式站经独立授权后，先核实目标库、来源库身份和磁盘余量，再通过统一部署入口应用三个迁移。服务器从公司库只读生成自己的快照，不复制整个本地数据库。个人凭据沿用 shared/marketing-sales-personal.env，目标和来源身份门禁放在权限为 600 的 shared/distribution-snapshots.env，分别为 DISTRIBUTION_EXPECTED_DATABASE 和 DISTRIBUTION_EXPECTED_SOURCE（host:port/database 格式）。来源连接的其他 JST_REPORT_DB_* 配置沿用 shared/.env。
-
-生产安装入口 scripts/install-distribution-snapshots-timer.sh 校验身份及依赖后，启用 furniture-distribution-snapshots.timer，每天 Asia/Shanghai 09:00 执行；错过的调度补执行。对应 service 通过 scripts/run-distribution-snapshots.sh 运行同一串行同步入口，日志在 journalctl -u furniture-distribution-snapshots，前后条数与空间报告在 shared/logs/distribution-snapshots。手动首次执行使用 systemctl start --no-block furniture-distribution-snapshots.service；任务锁防止并发，失败状态需核查报告和日志。本机任务与生产任务独立，安装生产任务不会停用本机任务。

furniture-3d-system/docs/数据字典/03-类目配置.md

@@ -1,163 +0,0 @@
-# 类目配置取数与筛选逻辑
-
-> 用途：给需要接入类目配置数据的开发人员使用。本文描述当前代码和数据库的真实口径（2026-09-24 更新：合并为单表展示结构）。
->
-> 重要：本文不包含数据库连接串、账号、密码。连接信息统一见《README.md》。
-
-## 1. 数据源与责任边界
-
-- **权威数据源**：本系统 `DATABASE_URL` 指向的 PostgreSQL，schema `public`，共 2 张表（见第 2 节）。数据通过类目配置页面人工维护 + Excel 导入，**没有外部同步来源**。
-- **业务作用**：
-  1. 维护「二级类目 → 一级类目」的唯一归属（产品全量档案类目列的规范值来源）；
-  2. 维护每个类目的 4 档规模阈值（爆款/热卖款/动销款/低动销款 × 业绩区间、日销区间）与「分类」归属。
-- **人工维护原则**：直接写表会绕过唯一键校验和页面权限，接入方一律只读。
-
-### 1.1 代码依据
-
-- Prisma 模型：`prisma/schema.prisma` 中 `SupplyChainProductArchiveCategoryConfig`、`SupplyChainProductArchiveCategoryScaleRow`。
-- 页面：`src/app/supply-chain/database/category-config/`（单表展示，数据源即规模行表）。
-- 服务：`supply-chain-product-archive-category-scale-row.service.ts`（页面主数据源，含类目清单同步）、`supply-chain-product-archive-category-config.service.ts`（类目主表维护）。
-
-## 2. 物理表清单与分工
-
-| 表名 | 角色 | 当前行数量级 |
-| --- | --- | --- |
-| `"SupplyChainProductArchiveCategoryScaleRow"` | **类目规模行（页面当前数据源）**：一行 = 二级类目 × 规模标签，自带一级类目、分类、阈值 | 类目数 × 4 |
-| `"SupplyChainProductArchiveCategoryConfig"` | **类目主表**：一行一个二级类目的身份记录（唯一性、启停状态），供产品档案同步、类目下拉等消费方使用 | 80+ |
-
-两表关系：
-
-```text
-ScaleRow（页面表：一级/二级/分类/阈值/标签，行=类目×档位，唯一键 categoryL2+scaleLabel）
-   │ 服务写入时自动同步（新增/改行会把一级类目、分类落到主表）
-   ▼
-Config（类目身份表：categoryL2 全表唯一 + status 启停，供外部消费方取类目清单）
-```
-
-> 历史说明：旧三表结构中的「分类档位模板表」（`SupplyChainProductArchiveCategoryGroupTier`）已于 2026-09-24 迁移（20260924160000）删除，其数据已按类目展开并入规模行表；旧接口 `/api/supply-chain/category-config/group-tiers/*` 已下线。
-
-## 3. 表字段字典
-
-### 3.1 `"SupplyChainProductArchiveCategoryScaleRow"`（类目规模行，页面数据源）
-
-| 字段 | 类型/约束 | 业务含义 | 取值规则 |
-| --- | --- | --- | --- |
-| `id` | `TEXT` 主键 | 行 ID | 系统生成 |
-| `categoryL1` | `TEXT NOT NULL DEFAULT ''` | 一级类目（≤160 字符） | 页面/导入必填 |
-| `categoryL2` | `TEXT NOT NULL` | 二级类目名（≤160 字符） | 与 `scaleLabel` 联合唯一 |
-| `categoryGroup` | `TEXT NOT NULL DEFAULT ''` | 分类（如 电脑桌/书桌、其他沙发类） | 空 = 未分类 |
-| `scaleLabel` | `TEXT NOT NULL` | 规模标签 | 只能是 爆款/热卖款/动销款/低动销款 |
-| `performanceStart` | `DECIMAL(14,2)` NOT NULL | 业绩起点（元） | |
-| `performanceEnd` | `DECIMAL(14,2)` 可空 | 业绩终点（元） | **NULL = 不设上限** |
-| `dailySalesStart` | `DECIMAL(12,2)` NOT NULL | 日销起点（件/天） | 支持小数 |
-| `dailySalesEnd` | `DECIMAL(12,2)` 可空 | 日销终点（件/天） | NULL = 不设上限 |
-| `sortOrder` | `INTEGER` | 档位顺序：爆款1 → 热卖款2 → 动销款3 → 低动销款4 | 判定从高档往低档取第一个命中 |
-| `createdAt` / `updatedAt` | `TIMESTAMP(3)` | 系统字段 | |
-
-约束：`UNIQUE(categoryL2, scaleLabel)`——一个类目每个标签只有一行；索引：`categoryL2`、`categoryGroup`。
-
-### 3.2 `"SupplyChainProductArchiveCategoryConfig"`（类目主表）
-
-| 字段 | 类型/约束 | 业务含义 | 取值规则 |
-| --- | --- | --- | --- |
-| `id` | `TEXT` 主键 | 配置记录 ID | 系统生成 |
-| `categoryL2` | `TEXT` 唯一 | 二级类目名（≤160 字符） | 全表唯一 |
-| `categoryL1` | `TEXT NOT NULL` | 一级类目（≤160 字符） | |
-| `categoryGroup` | `TEXT NOT NULL DEFAULT ''` | 分类 | 空 = 未分类 |
-| `scaleLabel` | `TEXT NOT NULL DEFAULT ''` | 【预留未使用】 | 阈值数据在 ScaleRow 表 |
-| `performanceStart` / `performanceEnd` | `DECIMAL(14,2)` 可空 | 【预留未使用】 | 同上 |
-| `dailySalesStart` / `dailySalesEnd` | `DECIMAL(12,2)` 可空 | 【预留未使用】 | 同上 |
-| `status` | `TEXT`，`ACTIVE` / `INACTIVE` | 启用/停用；停用的不进类目选项 | 默认 `ACTIVE` |
-| `createdAt` / `updatedAt` | `TIMESTAMP(3)` | 系统字段 | |
-
-索引：`categoryL1`、`categoryGroup`、`status`；`categoryL2` 唯一。
-
-## 4. 其他线程取数方式
-
-### 4.1 只读 SQL（直连数据库）
-
-```sql
--- 4.1.1 页面同款数据：全部规模行（一级类目、二级类目、分类、4 档阈值）
-SELECT "categoryL1", "categoryL2", "categoryGroup", "scaleLabel",
-       "performanceStart", "performanceEnd", "dailySalesStart", "dailySalesEnd"
-FROM "SupplyChainProductArchiveCategoryScaleRow"
-ORDER BY "categoryL2" ASC, "sortOrder" ASC;
-
--- 4.1.2 某个类目的 4 档阈值
-SELECT "scaleLabel", "performanceStart", "performanceEnd", "dailySalesStart", "dailySalesEnd"
-FROM "SupplyChainProductArchiveCategoryScaleRow"
-WHERE "categoryL2" = '住宅家具 - 书桌'
-ORDER BY "sortOrder" ASC;
-
--- 4.1.3 类目身份清单（供下拉/同步用，只取启用的）
-SELECT "categoryL1", "categoryL2", "categoryGroup"
-FROM "SupplyChainProductArchiveCategoryConfig"
-WHERE "status" = 'ACTIVE'
-ORDER BY "categoryL1" ASC, "categoryL2" ASC;
-
--- 4.1.4 某分类下的全部类目及其阈值
-SELECT "categoryL2", "scaleLabel", "performanceStart", "performanceEnd"
-FROM "SupplyChainProductArchiveCategoryScaleRow"
-WHERE "categoryGroup" = '电脑桌/书桌'
-ORDER BY "categoryL2" ASC, "sortOrder" ASC;
-```
-
-注意事项：
-
-- 表名/字段名**必须带双引号**保持大小写。
-- 终点列为 `NULL` 表示不设上限，不要写成 0。
-- 停用（`INACTIVE`）类目历史仍在 Config 表里，统计按 `status` 过滤。
-- 商品/档案行上的类目与分类是写入时的快照，改配置不回刷历史数据。
-
-### 4.2 代码内取数（同仓库服务）
-
-```ts
-// 规模行（页面同款数据：一行=类目×档位，含一级类目与分类）
-import { supplyChainProductArchiveCategoryScaleRowService } from
-  '@/server/services/supply-chain-product-archive-category-scale-row.service'
-await supplyChainProductArchiveCategoryScaleRowService.list({ page: 1, pageSize: 100 })
-await supplyChainProductArchiveCategoryScaleRowService.listAll({ categoryGroup: '电脑桌/书桌' })
-
-// 类目身份清单（产品全量档案同步、类目下拉在用）
-import { supplyChainProductArchiveCategoryConfigService } from
-  '@/server/services/supply-chain-product-archive-category-config.service'
-await supplyChainProductArchiveCategoryConfigService.list({ page: 1, pageSize: 100, status: 'ACTIVE' })
-
-import { supplyChainProductArchiveCategoryConfigRepository } from
-  '@/server/repositories/supply-chain-product-archive-category-config.repository'
-await supplyChainProductArchiveCategoryConfigRepository.findActiveByCategoryL2('住宅家具 - 书桌')
-```
-
-### 4.3 走 API（需要登录 + 供应链权限）
-
-| 接口 | 方法 | 说明 |
-| --- | --- | --- |
-| `/api/supply-chain/category-config/scale-rows` | GET / POST | 规模行列表 / 新增（写入时自动同步类目主表） |
-| `/api/supply-chain/category-config/scale-rows/{id}` | PATCH / DELETE | 规模行编辑 / 删除 |
-| `/api/supply-chain/category-config/scale-rows/export` · `/import` | GET / POST | 导出（筛选跟随当前搜索/分类/标签） / 流式导入（表头：一级类目、二级类目、分类、规模标签、业绩起终点、日销起终点） |
-| `/api/supply-chain/category-config/scale-rows/groups` | GET | 去重分类列表（筛选项） |
-| `/api/supply-chain/category-config` · `/{id}` | GET/POST/PATCH | 类目身份维护（供应商新品推荐下拉也走这里） |
-| `/api/supply-chain/category-config/export` · `/import` | GET / POST | 类目身份导出 / 导入 |
-
-权限：查询走类目节点「查看」，导出走「下载」，写入走「编辑」；角色 `SUPER_ADMIN/ADMIN/SUPERVISOR` 或业务角色 `MANAGEMENT`。
-
-## 5. 现有消费方（改动前必读）
-
-| 消费方 | 取数点 | 依赖 |
-| --- | --- | --- |
-| 产品全量档案（DF/聚水潭同步） | `jst-sku-product-archive-sync.service.ts`、`jst-sku-product-archive-full-sync.service.ts` | `findActiveByCategoryL2`：仅启用类目作为规范值 |
-| 供应商新品推荐类目下拉 | `/api/supply-chain/supplier-recommended-products/category-options` | Config `service.list`，仅 `ACTIVE` |
-| 类目配置页面 | 第 4.3 节接口 | — |
-
-改 `status`、`categoryL2` 名称、删除类目前先确认不影响以上消费方。
-
-## 6. 接入前检查清单
-
-- [ ] 表名/字段名带双引号保持大小写。
-- [ ] 方向：`categoryL2`（二级）→ `categoryL1`（一级）；`categoryGroup`（分类）是独立维度，不是一级类目，空 = 未分类。
-- [ ] 终点列 `NULL` = 不设上限，不要当 0 处理。
-- [ ] 档位判定顺序：爆款 → 热卖款 → 动销款 → 低动销款，从高到低取第一个命中区间。
-- [ ] 阈值数据取 `ScaleRow` 表；Config 表上的 `scaleLabel`/阈值列为预留未使用。
-- [ ] 停用（`INACTIVE`）配置历史仍在 Config 表里，统计按 `status` 过滤。
-- [ ] 商品/档案行上的类目、分类是写入时快照，改配置不回刷历史数据。
-- [ ] 页面写操作会双写两表（规模行 + 类目主表同步），外部只读不写就不会产生不一致。

furniture-3d-system/docs/数据字典/13-内容视频流程看板.md

@@ -1,99 +0,0 @@
-# 内容视频流程看板取数与筛选逻辑
-
-> 用途：给需要接入「新品-视频进度（内容部）」（钉钉内容视频流程）数据的开发人员使用。本文描述当前代码和数据库的真实口径（2026-10-08 首版）。
->
-> 重要：本文不包含数据库连接串、账号、密码。该页面数据**不存在本系统 PostgreSQL**，全部来自企划 MySQL 的同步快照。
-
-## 1. 数据源与责任边界
-
-- **页面直接数据源**：企划 MySQL（连接变量 `JST_PLANNING_DB_*`，生产为生产服务器本机实例）的 `planning_database` 库，快照表 `oa_video_flow_board_snapshot`。
-- **原始数据源**：钉钉 OA 审批镜像库的 `ding_Workflow` / `ding_WorkflowScheme` / `ding_WorkflowTask` 三张表，按流程编码过滤：
-  - 内容视频流程 `PROC-AE9FF3E1-A442-4E6A-85CF-0F2B86409673`（登记在 `oa-board.constants.ts` 的 `OA_BOARD_PROCESS_CODES.video`）。
-- **同步方式**：`scripts/sync-oa-video-flow-board.ts --apply`（即 `npm run sync:oa-video-flow:apply`，服务 `oa-video-flow-board.service.ts`）全量拉取该流程全部实例与表单字段，按"一条流程实例 = 一行"写入快照表，并用 `sync_version` 清理已消失的实例。生产由 systemd 定时器（`install-oa-board-sync-timer.sh` 安装的 `furniture-oa-board-sync.timer`）每 15 分钟在主看板、品牌策划看板之后顺序执行。
-- **责任边界**：镜像库与钉钉侧的数据质量不由本系统负责；本系统保证"镜像库 → 快照 → 页面"这一段。下游一律**只读快照表**，不要直连 ding_ 三张源表（源表结构随钉钉变化，无稳定性承诺）。
-- **与新品主链的关系**：内容视频流程**不参与** OA 新品看板主链的项目聚合、总状态与时效矩阵（其表单无开款编号/关联单号，仅有 SPU）。本表是独立流程维度的进度数据。
-
-### 1.1 代码依据
-
-- 同步与快照读写的唯一实现：`src/server/services/oa-video-flow-board.service.ts`（建表 DDL 在 `ensureSnapshotTable`，自动建表）。
-- 源库连接复用：`oa-board-sync.service.ts` 导出的 `openOaBoardSourceMysqlConnection` / `openOaBoardSourceSqlServer`（跟随 `OA_BOARD_SOURCE_DRIVER`）。
-- 页面接口：`GET /api/intake/oa-board/video-flow`（参数 `keyword` / `demandType` / `brand` / `status` / `page` / `pageSize`，需登录态）。
-- 页面组件：`src/app/intake/oa-board/OaBoardVideoFlowPanel.tsx`（Tab 参数 `tab=video-flow`）。
-
-## 2. 物理表（MySQL · planning_database）
-
-| 物理表 | 用途 | 键与索引 |
-| --- | --- | --- |
-| `oa_video_flow_board_snapshot` | 最新快照，一行 = 一条内容视频流程实例 | `row_key` 唯一；`spu` / `status` / `stage_label` / `demand_type` / `brand` / `created_date` 有索引 |
-
-同步任务自动建表（`CREATE TABLE IF NOT EXISTS`），引擎 InnoDB，字符集 utf8mb4。
-
-## 3. 字段字典
-
-| 字段 | 类型 | 含义 | 取值规则 |
-| --- | --- | --- | --- |
-| `row_key` | `VARCHAR(191)` 唯一 | 钉钉流程实例 ID（processInstanceId），幂等拉取键 | 源表主键，稳定不变 |
-| `business_id` | `VARCHAR(128)` | 流程发起编号 | 形如 `202610071758000088167` |
-| `title` | `VARCHAR(255)` | 流程标题 | `XX提交的内容视频和图片申请流程` |
-| `submitter_name` | `VARCHAR(255)` | 提交人姓名 | 从标题提取；`originator_user_id` 存钉钉用户 ID 兜底 |
-| `status` | `VARCHAR(32)` | 流程状态 | `RUNNING` / `COMPLETED` / `TERMINATED` |
-| `demand_department` | `VARCHAR(255)` | 需求部门 | 表单字段「需求部门」 |
-| `demand_type` | `VARCHAR(255)` | 需求类型 | 如 淘系-逛逛视频 / 抖音-千川素材视频 / 安装视频 / AI视频 等 13 种 |
-| `task_type` | `VARCHAR(255)` | 任务类型 | 如 布景拍摄 / 二次剪辑 |
-| `install_video_category` | `VARCHAR(255)` | 安装视频分类 | 仅安装视频类需求有值（如 B档） |
-| `brand` | `VARCHAR(255)` | 品牌 | 表单字段「品牌」 |
-| `scene_category` | `VARCHAR(255)` | 场景类别 | 如 卧室 / 客厅 / 玄关 |
-| `spu` | `VARCHAR(64)` | SPU | 大写规范化；约 3% 行无值（账号维护等非产品需求） |
-| `product_id` | `VARCHAR(128)` | 商品ID | 表单字段「商品ID」，可能为"暂无" |
-| `sample_barcodes` | `TEXT` | 样品条码 | 表单「样品明细」表格中商品编码列，多值分号分隔 |
-| `content_owner` | `VARCHAR(255)` | 内容部负责人 | 表单字段 |
-| `planning_supervisor` | `VARCHAR(255)` | 品牌策划主管 | 表单字段 |
-| `script_director` | `VARCHAR(255)` | 编导 | 流程推进到该环节时才填，未填为 NULL |
-| `cameraman` | `VARCHAR(255)` | 摄像 | 同上 |
-| `editor` | `VARCHAR(255)` | 剪辑 | 同上 |
-| `retoucher` | `VARCHAR(255)` | 修图 | 可选环节 |
-| `cover` | `VARCHAR(255)` | 封面 | 同上 |
-| `stage_label` | `VARCHAR(64)` | 当前阶段 | 推断规则见第 4 节 |
-| `acceptance_result` | `VARCHAR(255)` | 验收结果 | 表单「运营/策划/客服验收结果」 |
-| `score` | `VARCHAR(64)` | 评分 | 表单「评分」 |
-| `created_date` | `DATETIME` | 流程发起时间（北京时间） | 源表 createAt |
-| `finished_date` | `DATETIME` | 流程完成时间 | RUNNING 为 NULL |
-| `duration_days` | `DECIMAL(10,2)` | 总时效（天） | 发起 → 完成；未完成计至同步时刻 |
-| `last_source_updated_at` | `DATETIME` | 源表最近更新时间 | 增量拉取判据 |
-| `sync_version` | `VARCHAR(64)` | 本次同步批次标识 | 全表同批；用于清理已消失实例 |
-| `synced_at` | `TIMESTAMP` | 本行最近同步时间 | 数据新鲜度判据（`MAX(synced_at)`） |
-
-## 4. 阶段（stage_label）推断规则
-
-源表只有 activityId 没有节点名，首版按表单字段的推进顺序推断（钉钉流程设计中角色字段按环节顺序逐步填写）：
-
-```text
-status = COMPLETED  → 已完结
-status = TERMINATED → 已终止
-验收结果或评分已填   → 验收/评分
-否则取已填角色的最后一个：
-  编导 → 编导制作 → 摄像 → 摄影拍摄 → 剪辑 → 剪辑制作
-  → 修图/封面 → 封面/修图制作
-一个角色都没填      → 需求发起
-```
-
-若后续拿到钉钉流程节点名清单，可升级为 activityId 级精确映射（预留位：`oa-board.constants.ts` 的 `OA_BOARD_ACTIVITY_MAPPING_SEED.video` 当前为空数组）。
-
-## 5. 接入示例（一律只读）
-
-```sql
--- 按 SPU 拉该产品的全部视频流程
-SELECT * FROM oa_video_flow_board_snapshot WHERE spu = 'SJ0159';
-
--- 只看进行中的
-SELECT * FROM oa_video_flow_board_snapshot WHERE status = 'RUNNING';
-
--- 增量拉取（幂等键 row_key）
-SELECT * FROM oa_video_flow_board_snapshot
-WHERE last_source_updated_at > :上次拉取时间;
-
--- 取数前先看新鲜度（生产最多滞后 15 分钟）
-SELECT MAX(synced_at) FROM oa_video_flow_board_snapshot;
-```
-
-关联口径：与产品数据对齐用 `spu` 或 `sample_barcodes` 中的条码；本表**没有开款编号**，不要与主看板的 `OPENING:` 维度直接关联。

furniture-3d-system/docs/架构设计/BOM成本预估v2-agent方案设计-20260916.md

@@ -1,188 +0,0 @@
-# BOM 成本预估 v2（agent 方案）设计文档
-
-> 日期：2026-09-16
-> 状态：设计稿，待评审
-> 前置阅读：`docs/项目总览.md`、`src/server/services/bom-costing/agent/`（已建成的引擎）
-> 关联会话结论：1688 以图搜图锚定为过渡方案（双重失败已实测证伪），终局为 agent 估算 + 公司数据
-
-## 1. 一句话定位
-
-**粘贴竞品链接 → 几分钟后得到一张诚实的成本预估卡。**
-
-原始需求从未变过。v2 的一切设计决策都回到这句话：数字 + 构成故事 + 诚实的区间，工序全部退到幕后。
-
-## 2. v1 的教训（为什么 v2 长这样）
-
-| v1 的问题 | 根因 | v2 的对策 |
-|---|---|---|
-| 工序暴露给用户（逐图泳道、五阶段时间线、重算模式、复核流） | 工程美德当成了产品 | 一根进度条 + 一张卡；审计链存在但默认隐藏 |
-| 27 个 SKU 全量核算（用户等十几分钟才见结果） | 首结果时间没有被设计 | 首批 3 个精算先出结果，其余按需点算，结果缓存 |
-| 十几分钟等待 | 按 SKU 串行/并发全量跑 | case 级一次运行，2-3 分钟 |
-| 复杂度随精度承诺膨胀 | 用流程堆精度 | 用数据+校准逼近精度（±10% 是"尽量"的校准目标） |
-| 1688 锚定顶替估算 | 上线压力下的权宜 | 1688 永远是后台交叉验证信号 |
-
-**必须保留的教训**：用户会锚定数字。区间 + 置信度 + 不确定点是答案的一部分，不是脚注——这是"给一个数"和"给一个诚实的数"的差别。
-
-## 3. 设计总纲（五条，裁决一切分歧）
-
-1. **预估，不是核算**：输出是带区间与置信度的假设生成器，供决策筛选，永不承诺报价级精度。
-2. **agent 主导分析，代码承载确定性**：看什么图、怎么拆结构、查什么价格由 agent 决定；一切数值计算（汇总、区间合成、损耗）由确定性代码完成。模型永不算数、永不编价。
-3. **价格只认公司数据**：历史 BOM 镜像是唯一定价依据（检索→分类中位→cohort→损耗四级回退）；1688 行情仅作后台交叉验证，永不成为展示价。
-4. **前端来源中性（不可触碰）**：界面永不出现 1688 字样/报价/链接；一切序列化出口经过 `src/lib/bom-costing/public-estimate-text.ts`。
-5. **实测闸门**：agent 流程未经回测与真实案例对比验证（偏差分布达标）前，不替换任何线上行为。
-
-## 4. 用户形态
-
-### 4.1 默认入口：预估卡 + 全量 SKU 按需核算
-
-**覆盖率是需求，等待时间是体验问题**——所有 SKU 都要能出结果，但采用"先出一批、其余按需点算"的渐进交付：
-
-```
-粘贴链接 → [进度条：抓取中 → 分析中 → 出预估]（2-3 分钟）→
-
-┌────────────────────────────────────────┐
-│ 源氏木语 白蜡木实木衣柜                  │
-│ 预计出厂成本   ¥260 – 380（首批 3 个 SKU）│
-│ 置信度：中等                            │
-│ 板材 ¥180± · 五金 ¥25± · 加工+人工 ¥60± · 包材 ¥15± │
-│ 依据：8 张商品图 + 公司历史 BOM 12 条     │
-│ 不确定：板厚未确认；铰链数量按两门推定     │
-└────────────────────────────────────────┘
-SKU 列表（27 个）：
-  [¥260.29 已核算] (3) 原木色 0.9米两门   ← 首批自动精算
-  [¥375.48 已核算] (7) 原木色 1.0米      ← 首批自动精算
-  [¥406.77 已核算] (18) 原木色 1.96米    ← 首批自动精算
-  [点击核算] (4) 原木色 0.9米/高2.2米     ← 用户点击后单独运行
-  [点击核算] ...                         ← 已算结果缓存，不重跑
-────────────────────────────────────────
-商品图片（保留现有形式：主图/SKU图/详情图 分类浏览 + 大图预览）
-```
-
-- **首批自动精算**：默认 3 个代表性 SKU（跨度原则：最小/最大/中间，或按材质/结构差异选），2-3 分钟出卡——用户立刻有结果。
-- **其余 SKU 按需点算**：未核算的 SKU 显示占位按钮，用户点击触发单 SKU agent 运行（复用现有 per-SKU runner，1-2 分钟/个）；**结果持久缓存**，重复点击不重跑。
-- 进度状态只有三个：抓取中 / 分析中 / 出预估（含失败态与重试按钮）。
-- **渐进展开**：点构成 → BOM 行明细；点行 → 证据（哪张图、哪条镜像参考行）。审计链存在，默认折叠。
-- **商品图片保留现有展示形式**（主图/SKU 图/详情图分类 + 逐图状态 + 大图预览）：用户需要直接查看竞品链接内容，图片是判断依据，不是工程噪声。
-
-### 4.2 深度模式（保留现有工作台）
-
-需要全量 27 SKU 拆解、人工核对、证据溯源的用户，从预估卡一键进入现有工作台。v2 验证前工作台不动；验证后它降级为二级入口，不再是默认。
-
-## 5. 架构：case 级 agent 运行
-
-### 5.1 运行编排（新，核心增量）
-
-交付模型：**首批自动精算 + 其余按需点算**。现有 per-SKU runner 是按需点算的执行体，case 级编排负责首批选择与结果汇总。
-
-```
-阶段一：runBomCostingAgentEstimateForCase(caseId)（首批）
-  1. 取案例简报（标题/渠道/已解析品类 skill）+ 归档素材 + SKU 清单（含尺寸）
-  2. 代码侧选首批 SKU（默认 3 个：最小/最大/中间，或按材质/结构差异；
-     单 SKU 商品即为它自己）
-  3. 逐个运行现有 per-SKU agent 循环（结构行 + 查价）
-  4. 代码侧汇总出 EstimateCard：卡面五行/区间/置信度 + SKU 列表状态
-     （已核算 3 / 待核算 24）
-
-阶段二：按需点算（用户驱动）
-  用户点击未核算 SKU → 单 SKU agent 运行（现有 runner）→
-  结果持久缓存 → 卡面/SKU 列表实时更新
-```
-
-- 首批预算：≤24 轮 / ≤32 次模型调用 / ≤8 分钟（per-SKU 预算 × 3 + 编排开销）。
-- **结果缓存**：per-SKU 结果按 (caseId, skuId, 引擎版本) 持久化；点击已核算 SKU 直接展示缓存，不重跑。SKU 重算 = 显式刷新动作（换引擎版本或用户主动重跑）。
-- 失败语义：首批中单个 SKU 失败 → 该 SKU 标记失败可单独重试，不拖垮整卡；结构成功但价格饥饿 → 出结果但区间放宽 + 不确定点说明（PARTIAL 是合法产物）。
-- 并发上限与幂等：同一 SKU 的点算请求可去重合并（进行中重复点击返回同一运行）。
-
-### 5.2 输出契约：EstimateCard（case 级）
-
-```ts
-interface BomEstimateCard {
-  caseId: string
-  title: string
-  skus: Array<{                    // 全量 SKU 清单 + 状态
-    externalSkuId: string
-    name: string
-    status: 'ESTIMATED' | 'PENDING' | 'FAILED' | 'RUNNING'
-    estimate?: BomCostingAgentEstimate   // 已核算时：行/区间/置信度/evidence
-    cachedAt?: string
-  }>
-  firstBatchSkuIds: string[]       // 首批自动精算的 SKU
-  breakdown: Array<{               // 卡面五行（由已核算 SKU 的行汇总；随点算增长）
-    category: 'BOARD'|'STEEL'|'ACCESSORY'|'PACKAGING'|'PROCESSING'|'LABOR'
-    total: number | null           // null = 该组无价，卡面显示"待补"
-  }>
-  totalRange: { min: number; max: number }   // 当前已核算 SKU 的区间包络
-  confidence: number               // 已核算 SKU 的最小置信度
-  openQuestions: string[]          // 卡面"不确定"（已核算 SKU 的并集）
-  usage: { rounds; modelCalls; elapsedMs }
-}
-```
-
-原则：明细（行级）保留在各 SKU 的 estimate 里供展开；卡面只消费 breakdown/totalRange/confidence/openQuestions，并随按需点算增量更新。
-
-### 5.3 价格供给（核心依赖，最大缺口）
-
-首测"定价饥饿"的根治项——把 v1 场景服务的回退链包装成 agent 工具：
-
-| 优先级 | 工具 | 包装自 |
-|---|---|---|
-| P0 | 尺寸感知镜像检索（分类/材质词/尺寸/参考 SKU 多级过滤） | `findReferenceCandidates` |
-| P0 | 分类画像中位价 | `fillCategoryProfileFallbacks` |
-| P1 | 同类 cohort 报价 | `resolveCohortQuote` |
-| P1 | 历史损耗率 | `applyHistoricalLossFactorFallbacks` |
-| P2 | AI 补估（置信度上限 0.75 + 标记复核） | 现有 estimator |
-
-工具输出纪律：摘要级（无供应商/店铺/链接），带 sourceRowId 供 evidence 引用，单位明确。**1688 工具维持现状**（只透出状态/参考价/区间/可比数四个中性字段）。
-
-### 5.4 数据与知识资产接入（全部保留，形态不变）
-
-| 资产 | v2 中的角色 | 接入形态 |
-|---|---|---|
-| 历史 BOM 镜像（每日 MSSQL 同步） | 唯一价格依据 | 工具（5.3） |
-| 品类 Skill（5 个）+ 结构先验 | agent 脑中的专家清单：必备组件、证据纪律、校验规则 | 提示词注入（`renderBomCostingAgentSkillKnowledge`，已建成） |
-| 材质目录 | 材质身份唯一权威 | 工具（已接线） |
-| 商品抓取/归档/抠图 | 看图取证的素材 | 工具 + mission 组装（已接线；抠图模型待切 remove-background） |
-| 1688 行情 | 后台交叉验证信号 | 工具（已接线，中性摘要） |
-
-### 5.5 校准闭环（±10% "尽量"的实现方式）
-
-- **回测**：历史 BOM 镜像抽 20-50 个真实 SKU，同一规则/agent 重算 vs 真实成本，产出误差分布（复用 `backtest:bom-cost-reference` 基建）。
-- **shadow 对比**：agent 结果与现行引擎结果对同一案例并排落库（工程域），持续记录偏差（`report:bom-cost-shadow-divergence` 同款模式）。
-- **阈值语义**：±10% 是回测循环追的校准目标（按品类分段看分布），不是单案例门禁。偏差大 → 调工具/知识/提示词 → 再回测。
-- 未过门槛 → agent 流程保持旁路，线上仍是现行方案。
-
-## 6. 前端形态
-
-- **新入口**：`/bom-costing` 默认视图替换为预估卡流（粘贴框 → 卡 → SKU 列表 → 图片浏览）。
-- **商品图片**：保留现有展示形式（主图/SKU 图/详情图分类 tab + 大图预览 + 逐图状态），用户需要直接查看竞品内容；它从"处理进度件"回归"内容主体"。
-- **SKU 列表**：已核算显示价格，未核算显示"点击核算"按钮（运行中显示进度态）；点击结果写缓存并即时更新卡面。
-- **组件**：新 `BomEstimateCard`（平台组件体系 + 白曜石规范），状态只有 加载/成功/失败(可重试)。
-- **现有工作台**：不动，作为深度模式从卡进入。
-- **移动端**：卡、SKU 列表与图片浏览响应式。
-- 红线复检：卡面文案经过 `publicEstimateWarningText` 清洗；evidence 展开层同样不得出现来源敏感词。
-
-## 7. 落地顺序（每步可独立验证）
-
-| 步骤 | 内容 | 验收 |
-|---|---|---|
-| ① | 价格回退工具（P0 两个） | 对已知案例重跑，未定价行显著下降 |
-| ② | 首批编排 + EstimateCard 契约 + 按需点算与结果缓存 | 单案例 2-8 分钟出首批卡；点击未核算 SKU 增量出结果且缓存生效 |
-| ③ | 预估卡前端（含 SKU 列表与现有图片浏览）+ 三态进度 | 真人走通 粘贴→出卡→点算其他 SKU→看图核对 全流程 |
-| ④ | 回测 + shadow 接入，按品类出基线报告 | 误差分布报告（对照 ±10% 目标） |
-| ⑤ | 实测样本扩到 5-10 案例，按品类定门槛 | 达标 → 翻转默认入口；未达标 → 继续迭代 |
-
-## 8. 红线（重申）
-
-1. 前端永不出现 1688 相关内容；一切文本出口过脱敏契约。
-2. agent 引擎在过实测闸门前保持旁路（不替换线上行为）。
-3. 区间 + 置信度 + 不确定点是答案的一部分，任何展示形态不得省略。
-4. 单价只来自工具结果；总额只由代码汇总。
-5. 现有工作台在 v2 过门槛前不删不改语义。
-
-## 9. 当前资产清单（截至本文日期）
-
-已建成：agent 契约/工具层/循环/网关适配/skill 知识渲染/per-SKU runner（27 测试）、镜像与材质只读仓储、1688 中性摘要工具、板材开料工具、shadow 报表、trial 试跑脚本、生产真实案例（源氏木语 27 SKU）对照数据。
-
-待建：价格回退工具（5.3 表）、case 级编排、EstimateCard 契约与前端、回测接入。
-
-外部依赖：1688 新 key（当前过期，影响搜图与 A/B 实测，不影响 ①② 开发）。

furniture-3d-system/docs/架构设计/BOM成本预估产品口径.md

@@ -1,43 +0,0 @@
-# BOM 成本预估产品口径
-
-本文是 BOM 成本功能的产品口径裁决入口。代码、界面、测试或历史文档与本文冲突时，应先按本文区分“成本预估”与旧链路内部一致性检查，再决定是否修改实现。
-
-## 产品承诺
-
-- 本功能提供带区间、置信度和待确认项的成本预估，不提供报价级精确核算。
-- 预估结果允许与实际采购价、旧规则结果或其他参考信号存在明显差异；差异本身不构成失败。
-- 缺少依据的单价可以为空，未解决行应进入待确认项，不得为了提高覆盖率编造价格。
-- Agent 决定查看什么资料、调用什么工具以及引用什么证据；总额、损耗、开料、分位数和行小计由确定性代码计算。
-- 正式 Agent 引擎以公司历史 BOM 镜像、材质目录和损耗经验为主要价格依据；临时交付阶段按下节的整件九折方案展示单一预估结果。
-
-## 临时整件九折方案
-
-- 正式 Agent 引擎完善前，相似度合格的实时同款报价取中位数并固定乘以 `0.90`，作为前端唯一整件预估价。
-- 没有可用同款、图片不可用或服务失败时，沿用结构预估，页面仍只显示一套结果。
-- 原始报价、候选商品、九折过程和原结构价只保留在后台审计字段；普通接口和前端不得出现来源名称、商品链接、供应商或采购系数。
-- 临时整件价生效时，前端不得同时显示结构分类金额、行小计、贡献占比或旧规则价格；BOM 部件、材质、尺寸和数量仍可在详情中查看。
-- 正式 Agent 引擎通过产品验收后，在保持同一前端单结果契约的前提下替换临时价格来源。
-
-## 验收口径
-
-Agent 旁路试验主要验证：
-
-1. 能否稳定完成工具调用并返回符合契约的结果。
-2. 区间、置信度、证据和待确认项是否完整且容易理解。
-3. 单价是否来自工具结果，总额是否由代码汇总。
-4. 未定价行是否明确保留，而不是被虚构金额掩盖。
-5. 前端是否保持来源中性，不泄露供应商、店铺、商品链接或实时市场来源。
-
-Agent 与旧引擎、实际采购价或市场信号的差异仅作为观察数据，不设全局固定百分比通过门槛。按品类统计差异可以帮助理解结果分布，但不能自动判定预估失败。
-
-## 旧 10% 门槛的边界
-
-`backtest:bom-cost-reference` 中的 10% 只用于验证同一历史参考镜像内“已存总额”和“逐行确定性重建”是否一致，属于数据与重建逻辑检查。它不评价页面成本预估或 Agent 预估准确度，不得显示为产品目标，也不得复用于 Agent 灰度验收。
-
-数据库中的 `targetErrorPercent` 暂时保留用于旧数据和接口兼容；新界面不得展示为成本预估承诺。后续清理旧模型时再通过正式 migration 移除。
-
-## 术语
-
-- 用户可见名称统一使用“BOM 成本预估”“预估结果”“重新预估”。
-- `bom-costing` 等技术目录、路由和历史模型名暂时保留，避免为改名引入无关迁移。
-- “核算”仅可用于描述已经确认的历史采购/生产成本，不能描述本功能输出。

furniture-3d-system/docs/架构设计/OA看板-钉钉待办接入方案-20260729.md

@@ -1,310 +0,0 @@
-# OA 看板钉钉待办接入方案
-
-## 结论
-
-正式系统**不能只靠新增环境变量**就直接发送钉钉待办。
-
-原因：
-
-1. 仓库当前只实现了钉钉登录与用户识别，没有“创建 / 更新 / 删除钉钉待办”的服务代码。
-2. 当前没有“业务流程记录 <-> 钉钉待办 ID”的持久化表。
-3. 当前没有发送幂等、失败重试、关闭待办、升级提醒等基础能力。
-
-但从现有代码基础看，**补一层服务实现后，再由正式环境配置环境变量即可上线**。
-
-## 现有基础
-
-### 已具备
-
-1. 钉钉 OAuth 登录能力
-   - 文件：`src/server/services/dingtalk-auth.service.ts`
-   - 已能完成：
-     - 构建授权地址
-     - 获取用户 access token
-     - 获取 unionId
-     - 获取 app access token
-     - 用 unionId 换取 userId
-     - 获取用户详情
-
-2. 用户钉钉身份字段
-   - 系统已保存并使用：
-     - `dingtalkUserId`
-     - `dingtalkUnionId`
-
-3. OA 看板责任人映射
-   - OA 看板已经能把不同阶段映射到默认责任角色 / 人员字段。
-   - 例如首单下单待发起时可兜底为 `采购/跟单`。
-
-4. 责任与跟进界面基础
-   - 页面已有“责任与跟进”区域，适合作为钉钉待办的业务入口。
-
-### 尚缺失
-
-1. 钉钉待办发送 service
-2. 待办投递日志表
-3. 待办幂等规则
-4. 待办关闭 / 更新规则
-5. 定时升级提醒任务
-6. 正式环境待办配置项
-
-## 官方能力判断
-
-根据钉钉开放平台官方文档，待办能力当前支持：
-
-1. 创建工作待办
-2. 更新待办
-3. 删除待办
-4. 查询用户待办
-
-与本项目相关的关键点：
-
-1. 创建待办时需要应用身份和用户身份，不能只知道姓名。
-2. 待办通常需要可回跳的 `detailUrl`，跳回本系统详情页或看板页。
-3. 如果要做闭环，流程状态变更后还要同步更新或关闭钉钉侧待办。
-
-官方文档参考：
-
-- [待办概述](https://open.dingtalk.com/document/development/dingtalk-todo-task-overview)
-- [创建钉钉待办任务](https://open.dingtalk.com/document/development/add-dingtalk-to-do-task)
-- [更新钉钉待办任务](https://open.dingtalk.com/document/development/updates-dingtalk-to-do-tasks)
-- [删除钉钉待办任务](https://open.dingtalk.com/document/development/delete-dingtalk-to-do-tasks)
-- [更新钉钉待办执行者状态](https://open.dingtalk.com/document/development/update-dingtalk-to-do-status)
-
-## 正式环境建议新增的环境变量
-
-下面这些变量建议作为**待办功能正式接入专用配置**。当前代码尚未消费它们。
-
-```env
-# 是否启用 OA 看板钉钉待办
-DINGTALK_TODO_ENABLED=false
-
-# 钉钉开放平台 API 应用配置（待办、审批等服务端调用）
-DINGTALK_API_CLIENT_ID=
-DINGTALK_API_CLIENT_SECRET=
-
-# 钉钉网页登录使用独立 OAuth 应用配置，不与 API 应用混用
-DINGTALK_LOGIN_CLIENT_ID=
-DINGTALK_LOGIN_CLIENT_SECRET=
-DINGTALK_CALLBACK_ORIGIN=
-
-# 待办跳转回系统的基础地址
-DINGTALK_TODO_DETAIL_BASE_URL=
-
-# 用于构造钉钉待办来源标识 / 业务空间
-DINGTALK_TODO_SOURCE_APP=oa-board
-
-# 是否开启超时升级提醒
-DINGTALK_TODO_ESCALATION_ENABLED=false
-
-# 超时升级阈值（天）
-DINGTALK_TODO_ESCALATION_DAYS=3
-```
-
-如果最终接入方案要求额外的应用标识，还可能需要：
-
-```env
-DINGTALK_AGENT_ID=
-```
-
-是否必须取决于最终选用的钉钉待办接口版本与应用类型。
-
-## 建议新增的数据表
-
-建议新增一张专门的待办投递表，避免把钉钉待办状态散落在 JSON 里。
-
-建议表名：
-
-- `oa_board_dingtalk_todo_dispatch`
-
-用途：
-
-1. 记录某个业务流程 / 阶段是否已创建钉钉待办
-2. 保存钉钉待办 ID / 执行人 / 状态
-3. 支持去重、重试、关闭、审计
-
-SQL 草案见：
-
-- `scripts/sql/create-oa-board-dingtalk-todo-dispatch-table.sql`
-
-## 建议的发送时机
-
-### 第一阶段：最小闭环
-
-先只做一类待办：
-
-1. 当流程进入新的“当前审批阶段”
-2. 且解析出了唯一责任人
-3. 且该阶段还没有有效待办
-4. 则创建一条钉钉待办
-
-建议首批接入阶段：
-
-1. `产品设计-外观`
-2. `产品设计-结构`
-3. `产品生产-首单下单`
-4. `限价-发起`
-
-原因：
-
-1. 这些阶段责任人相对清晰
-2. 都已经有字段或规则可映射负责人
-3. 业务价值高，适合先验证
-
-### 第二阶段：关闭与更新
-
-当以下任一情况发生时，同步钉钉待办：
-
-1. 当前阶段变化
-   - 关闭旧待办
-   - 为新阶段责任人创建新待办
-
-2. 流程完成 / 驳回 / 终止
-   - 关闭对应待办
-
-3. 负责人变更
-   - 更新执行人，或关闭旧待办后重建
-
-### 第三阶段：升级提醒
-
-当流程满足以下条件时再发升级提醒：
-
-1. 阶段超时
-2. 原待办已创建
-3. 距离上次提醒超过冷却时间
-4. 升级接收人可解析
-
-升级对象建议：
-
-1. 当前负责人
-2. 当前负责人上级
-3. 商品企划 / 荆川 / 管理员可选兜底
-
-## 负责人解析策略
-
-待办发送目标不能只靠中文名，必须最终落到钉钉身份。
-
-建议解析顺序：
-
-1. 当前运行任务的 `userId`
-   - 直接映射 `dingtalkUserId`
-
-2. 表单中责任人字段
-   - 如 `appearanceDesigner`、`structureDesigner`、`merchandiserOwner`、`pricingOwner`
-   - 用姓名匹配本地用户 / 员工目录，取 `dingtalkUserId`
-
-3. 阶段默认角色兜底
-   - 例如 `采购/跟单`
-   - 通过角色到成员名单的映射表进一步解析
-
-如果一个阶段只能解析到“角色名”而不能解析到唯一员工，建议：
-
-1. 不直接发待办
-2. 记录 `NEEDS_OWNER_MAPPING`
-3. 在看板中提示“负责人映射未完成”
-
-## 需要新增的服务模块
-
-建议至少拆成这几个文件：
-
-1. `src/server/services/dingtalk-todo.service.ts`
-   - 创建 / 更新 / 删除待办
-   - 管理 app token
-
-2. `src/server/services/oa-board-dingtalk-todo-dispatch.service.ts`
-   - 负责业务规则
-   - 判断是否该发待办
-   - 生成 payload
-   - 落库记录
-
-3. `src/server/services/oa-board-owner-resolution.service.ts`
-   - 负责将阶段负责人解析成钉钉用户
-
-4. `scripts/sync-oa-board-todos.ts`
-   - 用于定时补发、关闭、升级
-
-## 需要新增的 API / 任务
-
-### 后台任务
-
-建议新增定时任务：
-
-1. `sync:oa-board:todos`
-   - 扫描当前有效流程
-   - 创建缺失待办
-   - 关闭失效待办
-   - 触发升级提醒
-
-### 管理接口
-
-如有需要，可新增：
-
-1. `POST /api/intake/oa-board/todo-dispatch/retry`
-   - 手工重试失败待办
-
-2. `GET /api/intake/oa-board/todo-dispatch`
-   - 查看待办发送日志
-
-## 幂等与重试建议
-
-待办系统必须做幂等。
-
-建议唯一业务键：
-
-```text
-board_key + stage_key + receiver_dingtalk_user_id
-```
-
-规则：
-
-1. 同一个业务键，只允许存在 1 条 `OPEN / PENDING / RETRYING` 记录
-2. 接口超时后不立即重发，先查日志状态
-3. 网络失败按指数退避重试
-
-## 正式环境能否“只配置就开”
-
-最终判断：
-
-1. **现在不能**
-   - 因为缺少待办发送代码和日志表
-
-2. **补完代码后可以**
-   - 正式系统只需配置环境变量
-   - 再开启定时任务即可
-
-## 推荐落地顺序
-
-### P1
-
-1. 新增待办投递表
-2. 新增 `dingtalk-todo.service.ts`
-3. 先打通“创建待办”
-4. 先只接 `产品生产-首单下单`
-
-### P2
-
-1. 接入更多阶段
-2. 做关闭 / 更新逻辑
-3. 做负责人映射异常日志
-
-### P3
-
-1. 做超时升级提醒
-2. 做看板内待办发送状态可视化
-3. 做手工重试与运维面板
-
-## 建议的产品口径
-
-为了降低误发风险，建议待办文案统一包含：
-
-1. 开款编号
-2. 当前阶段
-3. 目标动作
-4. 超时状态
-5. 跳转链接
-
-示例：
-
-```text
-【OA 新品流程看板】XP2026070900000291 已进入“产品生产-首单下单”，请尽快处理。
-```
-

furniture-3d-system/docs/架构设计/供应链产品全量档案字段来源对照表.md

@@ -1,121 +0,0 @@
-# 供应链产品全量档案字段来源对照表
-
-更新时间：2026-10-16
-
-## 1. 合并与追踪规则
-
-- 汇总表：`SupplyChainProductArchive`
-- 唯一合并键：`barcode`
-- 来源记录：`SupplyChainProductArchiveSource`
-- 字段级来源：`SupplyChainProductArchive.fieldSourceMap`
-- 产品全量档案页面使用的来源数据必须先写入 `SupplyChainProductArchive` 或图片缓存；页面列表不再临时联查来源库。
-- 新品图片先用 `external.product_catalog_wide_v1.archive_image` 判断当前 SKU/条码行是否真的有图；确认有图后，保存同一行标准化的绝对 `image_url`，绝对地址为空时才保留 `archive_image`。当 `archive_image` 为空时禁止读取 `image_url`，因为该列此时可能回退到产品级图片。宽表当前行无图时，再按当前条码/SKU精确查询素材库；命中的链接和来源信息保存在 `SupplyChainProductArchiveImageCache`。图片二进制不写入 PostgreSQL，图片变化不进入商品修改日志。
-- 首次建立商品档案只记录一条“商品档案导入”；后续来源值实际变化时，按条码、字段、旧值、新值和来源写入 `OperationLog`。
-- 扩展字段通过 `sync:supply-chain-product-archive-enrichment` 分批同步；重复执行时只有值发生变化的字段才更新主表并写日志。
-- 生产定时入口为 `scripts/install-supply-chain-product-archive-sync-timer.sh`，默认每 15 分钟先同步 `rpt.jst_sku` 基础档案，再同步供应商、仓库、生产周期、日销和价格等扩展字段。
-- 聚水潭来源只读取 `JSReportReplica.rpt.jst_sku` 中 `item_type = '成品'` 的行。
-- `jst_sku` 只更新本表明确列出的字段；空值不覆盖其他来源的已有值。
-- 已由 `JST_SKU` 提供且有值的字段，不再被产品开发同步覆盖。
-- 一级类目由 `SupplyChainProductArchiveCategoryConfig` 按 JST 二级类目匹配，未配置时保持空值。
-- 创建时间优先级固定为：`云杉商品资料.xlsx` 的“创建时间” > `jst_sku.created` > 产品开发创建时间。
-- 云杉文件只在部署或补数时通过导入脚本读取一次，不进入 Git，页面运行时不读取 Excel。
-- 体积统一由同一来源记录的长、宽、高相乘计算；任一尺寸缺失、不是有效数字或不大于 0 时保持空值。
-- 未列出的字段不猜测、不兜底，保持原来源或空值。
-
-## 2. 当前字段对照
-
-| 全量档案字段 | 页面表头 | JST_SKU 来源 | 产品开发来源 | 其他来源 | 转换规则 |
-| --- | --- | --- | --- | --- | --- |
-| `barcode` | 条码 | `rpt.jst_sku.sku_id` | `external.product_catalog_wide_v1.barcode_business_key` |  | 去空格并转大写；档案唯一键 |
-| `spu` | SPU | `rpt.jst_sku.i_id` | `archive_spu` |  | 去空格并转大写 |
-| `sku` | SKU | `rpt.jst_sku.other_7` | `archive_sku` |  | 去空格并转大写；JST 空值不兜底 |
-| `image` | 图片 |  | `external.product_catalog_wide_v1.archive_image` + `image_url` | 素材库接口 + `SupplyChainProductArchiveImageCache.previewUrl` | 新品以当前 SKU/条码行 `archive_image` 非空为前提，保存同一行标准化 `image_url`；`archive_image` 为空时不得使用可能回退到产品级图片的 `image_url`；当前行无图时再按当前条码/SKU精确查询素材库，命中链接长期复用，未命中则留空 |
-| `businessCreatedAt` | 创建时间 | `rpt.jst_sku.created` | `product_development_created_at`，空时取 `source_created_at` | 云杉文件“创建时间”按条码匹配 | 按固定优先级覆盖 |
-| `categoryL1` | 一级类目 |  | `sales_category_name` | `SupplyChainProductArchiveCategoryConfig.categoryL1` | JST 行按完整二级类目匹配配置表 |
-| `categoryL2` | 二级类目 | `rpt.jst_sku.category` | `archive_product_category_name` |  | JST 原样保留完整类目文本 |
-| `productName` | 商品名称 | `rpt.jst_sku.name` | `archive_product_name` |  | 原样保留 |
-| `designer` | 设计师 | 暂不接入 | `archive_designer` |  |  |
-| `productStatus` | 商品状态 | `rpt.jst_sku.other_5` | `sku_sales_status` |  | 只接受“销售、停产、退市” |
-| `material` | 材质 | `rpt.jst_sku.other_10` | `archive_material` |  | 原样保留 |
-| `color` | 颜色 | `rpt.jst_sku.properties_value` | `archive_color` |  | 原样保留 |
-| `weight` | 重量 | `rpt.jst_sku.weight` | `sample_weight_kg` |  | 转十进制数；空值不覆盖 |
-| `length` | 长 | `rpt.jst_sku.l` | `package_length_cm` |  | 转十进制数；空值不覆盖 |
-| `width` | 宽 | `rpt.jst_sku.w` | `package_width_cm` |  | 转十进制数；空值不覆盖 |
-| `height` | 高 | `rpt.jst_sku.h` | `package_height_cm` |  | 转十进制数；空值不覆盖 |
-| `volume` | 体积 | `rpt.jst_sku.l * w * h` | `package_length_cm * package_width_cm * package_height_cm` |  | 不读取来源体积列，统一按长宽高计算 |
-| `packType` | 单双包 | `rpt.jst_sku.other_8` | `package_set_count` |  | 1-9 转为非双包至九包；已是标准文字时原样保留 |
-| `productTag` | 商品标签 | `rpt.jst_sku.labels` | `product_tag` |  | 原样保留 |
-| `installDocId` | 安装图纸/视频 ID | `rpt.jst_sku.other_9` | `drawing_id` |  | 原样保留 |
-| `spec` | 产品尺寸 | 从 `rpt.jst_sku.name` 提取 | `archive_spec` |  | 提取三轴尺寸，统一 `/` 分隔，保留小数和范围 |
-| `brand` | 品牌 | `rpt.jst_sku.brand` | `brand_name` |  | 原样保留 |
-| `orderType` | 叫货类型 | `rpt.jst_sku.other_price_2` | `purchase_order_method` |  | 按现有枚举归一 |
-| `storageType` | 入库/代发 |  |  | `SupplyChainProductArchiveWarehouseConfig.storageType` | 按出入库仓库名称匹配配置表 |
-| `isSeasonal` | 是否季节性产品 | 暂无来源 | 暂无来源 |  | 保持空值 |
-| `replaceCount` | 替换款数量 | 暂无来源 | 暂无来源 |  | 保持空值 |
-| `region` | 区域 |  |  | `rpt.js_supplier.region` | 按供应商名称匹配后写主表 |
-| `supplierName` | 供应商 | `rpt.jst_sku.supplier_name` | `archive_supplier_name` |  | 原样保留 |
-| `supplierType` | 供应商类型 |  |  | `rpt.js_supplier.scmtype` | 按供应商名称匹配后写主表 |
-| `supplierStatus` | 供应商状态 |  |  | `rpt.js_supplier.coopersgn` | `1=合作`、`2=不合作` |
-| `purchaseOwner` | 采购 |  | `archive_purchase_owner` | `rpt.js_supplier.buyer` | 供应商采购非空时覆盖产品开发采购 |
-| `settlementMethod` | 结算方式 |  |  | `rpt.js_supplier.paycyclesgn` | 按供应商名称匹配 |
-| `boardProvider` | 板材提供方 |  |  | `rpt.js_supplier.undefined2` | 按供应商名称匹配 |
-| `penaltyStatus` | 违约金赔付状态 |  |  | `rpt.js_supplier.undefined1` | 按供应商名称匹配 |
-| `warehouseType` | 仓库属性 |  |  | `rpt.jst_warehouseInfo.remark2` | 按出入库仓库名称匹配 |
-| `warehouseHead` | 仓库负责人 |  |  | `SupplyChainProductArchiveWarehouseConfig.warehouseHead` | 按出入库仓库名称匹配配置表 |
-| `minimumOrderQuantity` | 产品起订量 |  | `archive_minimum_order_quantity` | `rpt.pm_stockMonitor.minimum` | stock monitor 非空时覆盖产品开发起订量 |
-| `firstLeadTime` | 首单生产周期 |  |  | `rpt.pm_stockMonitor.produceCycle` | 条码优先、SKU 唯一匹配兜底 |
-| `palletSpec` | 托盘参数 |  |  | `rpt.pm_stockMonitor.trayParameter` | 条码优先、SKU 唯一匹配兜底 |
-| `dailySales` | 采购日销 |  |  | `rpt.pm_stockMonitor.purchaseSale` | 按条码匹配最新记录 |
-| `sales3d` | 3日日销 |  |  | `rpt.pm_stockMonitor.threeAvgSale` | 按条码匹配最新记录 |
-| `sales7d` | 7日日销 |  |  | `rpt.pm_stockMonitor.sevenAvgSale` | 按条码匹配最新记录 |
-| `sales15d` | 15日日销 |  |  | `rpt.pm_stockMonitor.fifteenAvgSale` | 按条码匹配最新记录 |
-| `purchasePrice` | 采购价 | `rpt.jst_sku.purchase_price` |  |  | 按档案条码精确匹配 `jst_sku.sku_id`；匹配不到时留空 |
-| `costPrice` | 成本价（聚水潭） | `rpt.jst_sku.cost_price` |  |  | 按档案条码精确匹配 `jst_sku.sku_id`；匹配不到时留空。DF 条码自 2026-10-16 起同样取本来源（原 `rpt.dws_sn_sales_full_info_di.goods_cost` 为金额口径，已停用） |
-| `costPriceSecondary` | 成本价（新品） |  | `external.product_catalog_wide_v1.cost_price` |  | 按档案条码精确匹配 `barcode_business_key`，只读取 `catalog_source = INTAKE_READY` 的新品行；匹配不到或来源为空时留空 |
-
-## 3. JST_SKU 第一批字段覆盖率
-
-统计范围：`item_type = '成品'`，共 65,164 行。
-
-| 来源字段 | 对应档案字段 | 非空行数 |
-| --- | --- | ---: |
-| `sku_id` | 条码 | 65,164 |
-| `i_id` | SPU | 65,164 |
-| `name` | 商品名称、规格解析 | 65,164 |
-| `other_7` | SKU | 63,537 |
-| `other_5` | 商品状态 | 63,771 |
-| `other_9` | 安装图纸/视频 ID | 24,792 |
-| `other_10` | 材质 | 31,394 |
-| `properties_value` | 颜色 | 63,855 |
-| `category` | 二级类目 | 63,539 |
-| `weight` | 重量 | 35,754 |
-| `l` | 长 | 38,224 |
-| `w` | 宽 | 38,083 |
-| `h` | 高 | 38,124 |
-| `other_8` | 单双包 | 61,908 |
-| `labels` | 商品标签 | 以本次来源库实时数据为准 |
-| `brand` | 品牌 | 以本次来源库实时数据为准 |
-| `supplier_name` | 供应商 | 以本次来源库实时数据为准 |
-
-## 4. 来源代码
-
-| 来源代码 | 来源系统 | Schema | 对象 |
-| --- | --- | --- | --- |
-| `JST_SKU` | 聚水潭 JSReportReplica | `rpt` | `jst_sku` |
-| `PRODUCT_DEVELOPMENT` | 家具产品开发系统 | `external` | `product_catalog_wide_v1` |
-| `CATEGORY_CONFIG` | 供应链中心类目配置 | `public` | `SupplyChainProductArchiveCategoryConfig` |
-| `JST_SUPPLIER` | 聚水潭 JSReportReplica | `rpt` | `js_supplier` |
-| `JST_STOCK_MONITOR` | 聚水潭 JSReportReplica | `rpt` | `pm_stockMonitor` |
-| `JST_WAREHOUSE_INFO` | 聚水潭 JSReportReplica | `rpt` | `jst_warehouseInfo` |
-| `JST_SKU_PRICE` | 聚水潭 JSReportReplica | `rpt` | `jst_sku` |
-| `PRODUCT_CATALOG_COST_PRICE` | 家具产品开发系统 | `external` | `product_catalog_wide_v1` |
-| `WAREHOUSE_CONFIG` | 供应链中心 | `public` | `SupplyChainProductArchiveWarehouseConfig` |
-| `YUNSHAN_PRODUCT_EXPORT` | 云杉商品资料 | Excel 工作表名 | Excel 文件名 |
-
-## 5. 生产同步入口
-
-- 产品开发页面保存成功后，会按当前产品即时同步 `external.product_catalog_wide_v1` 的档案字段。
-- 聚水潭及其关联表由 systemd timer 周期检查。同步过程可以重复执行，主表只写实际变化，商品修改日志只记录后续真实变化。
-- 定时任务安装前必须在生产服务器的 `shared/supply-chain-product-archive-sync.env` 填写目标 PostgreSQL 和来源 SQL Server 的身份校验值；文件权限固定为 `600`，其中不保存数据库密码。
-- 安装命令只在发布完成并获得生产操作授权后执行：`bash scripts/install-supply-chain-product-archive-sync-timer.sh`。
-- 新品即时同步以宽表当前 SKU/条码行的 `archive_image` 是否存在为准，并把同一行标准化的绝对 `image_url` 写入档案和 `SupplyChainProductArchiveImageCache`。宽表当前行无图时，页面才按当前条码/SKU调用素材库接口并回写链接；存量图片规则不在本次新品图片调整范围内。

furniture-3d-system/docs/架构设计/停产下架服务器运行与上游数据依赖.md

@@ -1,180 +0,0 @@
-# 停产下架服务器运行与上游数据依赖
-
-更新日期：2026-10-26
-
-## 1. 服务器每日入口
-
-服务器入口：
-
-```bash
-node scripts/run-supply-chain-discontinuation-daily.mjs
-```
-
-执行顺序：
-
-1. 生成 Prisma Client。
-2. 同步虚拟云仓库存快照。
-3. 生成编码维度通知和库存预警。
-4. 通过服务器 Chrome 从聚水潭“店铺商品管理”导出完整链接并生成链接维度快照。
-5. 生成未下架监控与乐捐快照。
-
-生产安装：
-
-```bash
-sudo bash scripts/install-supply-chain-discontinuation-linux-timer.sh
-```
-
-默认使用 systemd，每日北京时间 10:30 执行，`Persistent=true` 会在服务器恢复后补跑。
-服务名默认为 `furniture-discontinuation-daily`。
-
-RPA 使用的 Python 必须显式可执行：
-
-- 正式机默认 `/usr/bin/python3`，安装器会检查可执行权限并写入
-  `JST_RPA_PYTHON=/usr/bin/python3`。
-- 如果正式机使用虚拟环境或其他路径，安装前设置
-  `DISCONTINUATION_PYTHON_BIN=/明确路径/python3`。
-- 每日同步在连接聚水潭页面、开始导出前先执行 `python3 --version` 预检；
-  路径不存在、不可执行或版本命令失败时立即终止，不会等到导出完成后才发现。
-
-## 2. 数据源与生成责任
-
-| 数据 | 服务器读取来源 | 应用侧生成方式 | 是否依赖个人电脑 |
-| --- | --- | --- | --- |
-| 商品状态、组合商品、库存 | `JianSun_Old.JianSun`、`JSReportReplica.rpt` | 服务端 SQL 只读，应用生成本地快照 | 否 |
-| 虚拟云仓库存 | `JianSun_Old.JianSun.dbo.jst_virtualstockStocksInfo` | 服务端脚本读取，应用生成本地日快照 | 否 |
-| 替换规则（PM） | `JSReportReplica.rpt.pm_replacementManage` | 服务端 SQL 只读 | 否 |
-| 替换规则（聚水潭） | `JSReportReplica.rpt.jst_sku_replace_rule` | 读取最新 `snapshot_date` | 否 |
-| 供应商剩余库存 | `JianSun_Old.JianSun.dbo.plm_productDiscontinuation` | 服务端 SQL 只读 | 否 |
-| 链接完整快照 | 聚水潭“店铺商品管理”前台导出 | 服务器 Chrome + RPA，分批导出后落本地链接快照 | 否（需服务器浏览器登录态） |
-| 链接数据库快照（诊断） | `JianSun_Old.JianSun.dbo.dm_jst_shop_goods_link_daily` | 只用于比对和排障，不作为每日全量写入源 | 否 |
-| 订单与订单明细 | `JSReportReplica.rpt.jst_Orders`、`jst_orderitem`、`jst_qmcust_orderlist*` | 服务端 SQL 只读 | 否 |
-| 产品档案、负责人、申诉审核状态 | 应用 PostgreSQL | 应用自身写入 | 否 |
-
-## 3. 数据库链接快照仅用于诊断
-
-`dm_jst_shop_goods_link_daily` 的真实字段包括：
-
-- `run_date`
-- `shop_i_id`
-- `shop_sku_id`
-- `sku_id`
-- `online_status`
-- `stock_sync_status`
-- `imported_at`
-
-该表缺少大量完整导出链接，不能作为链接维度最终数据源。2026-10-26 对比结果：
-
-- 数据库快照：52,639 行，按条件过滤后匹配通知仅 1,868 条。
-- 聚水潭完整导出：246,480 条，全部匹配通知。
-- 数据库快照缺少 99% 以上完整链接，只能用于差异诊断。
-
-诊断脚本带覆盖率保护：如果数据库快照结果不足已有链接的 50%，会拒绝覆盖。
-
-可配置：
-
-```text
-JST_DISCONTINUATION_LINK_MAX_AGE_HOURS=26
-```
-
-手动核对：
-
-```bash
-node_modules/.bin/tsx scripts/sync-supply-chain-discontinuation-links-from-dm.ts \
-  --date=YYYY-MM-DD \
-  --dry-run
-```
-
-## 4. 上游任务归属
-
-已确认此前完整链接由个人 Mac 的 launchd 每日 09:00 启动 RPA 生成，随后写入数据库。
-数据库日快照不是完整当前链接。
-
-新的服务器方案：
-
-- Linux 安装器同时安装 `furniture-jst-rpa-browser.service`。
-- Chrome 使用持久化 profile，并通过本机 CDP 端口供 RPA 使用。
-- 每日入口从服务器 Chrome 导出完整聚水潭数据。
-- 正常整单导出最多尝试 3 次，任一次成功立即结束；只有全部失败后才按每批
-  10,000 个编码降级导出，避免页面偶发失败时立即产生大量分批记录。
-- 首次部署优先把已登录的聚水潭 profile 放到 `JST_RPA_PROFILE_DIR`，或在服务器图形/VNC 环境完成一次登录。
-- 服务器私有环境文件可配置 `JST_RPA_LOGIN_ID` 和
-  `JST_RPA_LOGIN_PASSWORD`；持久登录态失效时 RPA 会自动填写账号密码登录页。
-  凭据只能保存在权限为 `600` 的服务器共享 `.env`，禁止提交到 Git。
-- 自动登录遇到验证码、短信验证或密码错误时会明确失败并保留已有链接，不覆盖完整快照。
-
-首次登录示例：
-
-```bash
-sudo systemctl stop furniture-jst-rpa-browser.service
-sudo env JST_RPA_HEADLESS=false \
-  JST_RPA_PROFILE_DIR=/opt/furniture-3d-system-prod/shared/jst-rpa-profile \
-  node scripts/launch-jst-rpa-browser.mjs
-```
-
-在图形界面登录聚水潭后停止该进程，再启动 systemd 浏览器服务。
-
-如需允许登录态失效后自动重新登录，在服务器私有环境文件
-`/opt/furniture-3d-system-prod/shared/.env` 中配置以下两项后重启每日服务：
-
-```text
-JST_RPA_LOGIN_ID=<聚水潭登录账号>
-JST_RPA_LOGIN_PASSWORD=<聚水潭登录密码>
-```
-
-不要把这些值写入仓库、聊天记录、普通日志或 systemd 命令行参数。
-正式部署入口会自动读取本机被忽略的
-`furniture-3d-system/.env.jst-rpa-auth`，并在发布时合并上述两项；也可通过
-`-JstRpaAuthFile` 指定其他权限受限的凭据文件。部署结束后临时凭据会被删除。
-配置后可只验证登录，不执行导出：
-
-```bash
-node_modules/.bin/tsx scripts/jst-shop-goods-rpa.ts --action=login
-```
-
-## 5. 重跑保护
-
-通知：
-
-- 按 `(barcode, statDate)` 原地 upsert，保持既有通知 ID 不变。
-- 同日重跑成功后，当天通知集合必须与最新计算结果完全一致；不再命中的旧通知
-  会删除，其旧链接按外键级联删除。
-- 通知、链接清理和库存预警写入位于同一数据库事务。计算或写入失败时整体
-  回滚，原有通知和链接保持不变。
-- 当天停产/退市商品整体为 0 时也走同一清理事务，不保留上一轮通知。
-
-乐捐：
-
-- 同日重跑不再先删除全部当天记录。
-- 已进入 `PENDING_REVIEW`、`APPROVED`、`REJECTED`、`RETURNED` 的记录保留。
-- 仅清理不再命中当前结果且仍为 `PENDING_APPEAL` 或 `LEFT_EMPLOYEE` 的旧记录。
-- 候选 ID 虽在事务外读取，最终 `DELETE` 会再次校验数据库中的最新状态；候选
-  读取后刚提交的申诉不会被误删。
-- 清理和 upsert 位于同一数据库事务，失败时整体回滚。
-
-链接导入：
-
-- 旧链接删除、新链接解析和写入使用同一事务。
-- 最终有效写入为 0 时默认回滚并保留旧链接快照。
-- 只有业务明确确认当天正常零链接时，才可给导入命令追加
-  `--allow-zero-links`，允许清空当天链接。
-
-## 6. 文件交付
-
-- 每日入口：`scripts/run-supply-chain-discontinuation-daily.mjs`
-- Linux 安装器：`scripts/install-supply-chain-discontinuation-linux-timer.sh`
-- 完整链接 RPA：`scripts/jst-shop-goods-rpa.ts`
-- 服务器浏览器：`scripts/launch-jst-rpa-browser.mjs`
-- 链接数据库诊断：`scripts/sync-supply-chain-discontinuation-links-from-dm.ts`
-- 通知重跑保护：`src/server/repositories/supply-chain-discontinuation-notice.repository.ts`
-- 乐捐重跑保护：`src/server/services/supply-chain-discontinuation-penalty-sync.ts`
-
-## 7. 本地验证结果
-
-2026-10-26 使用完整聚水潭导出验证：
-
-- 完整导出：246,480 条链接。
-- 链接落库后共 246,480 条，涉及 304 个负责人。
-- 同日重跑通知后链接数量和通知 ID 未变化。
-- 未下架监控首次同步生成 516 条。
-- 未下架监控第二次同步仍为 516 条，无重复。
-- 自动化测试覆盖链接条件过滤、去重、新鲜度拒绝、通知/乐捐状态保护。

furniture-3d-system/docs/架构设计/停产下架管理数据源-20261019.md

@@ -1,256 +0,0 @@
-# 停产下架管理数据源
-
-更新时间：2026-10-20
-
-## 1. 当前状态
-
-停产下架管理已按新口径重新接入数据源：
-
-- 通知下架-编码维度已接入并生成每日快照。
-- 通知下架-链接维度已接入并生成每日快照。
-- 库存预警已接入，读取当日 `ProductInventorySnapshot`。
-- 未下架监控与申诉已接入，读取聚水潭订单头及订单明细生成月度乐捐明细。
-- 页面、页签、表头、筛选、分页和导出能力已保留。
-- 四个页签均支持导出当前筛选结果：编码维度、链接维度、库存预警、未下架监控与申诉分别使用独立字段和文件名。
-- 页面查询接口只读取本地快照，不再实时访问 SQL Server。
-- 每日生成入口按北京时间生成当天快照；同日重跑只替换当天数据，历史日期不动。
-
-## 2. 数据流边界
-
-页面和查询接口只读本地落库结果，不直接访问外部库：
-
-```text
-外部权威数据源
-  -> 每日 09:00 同步/计算任务
-  -> 本地快照及业务表
-  -> 停产下架页面 API
-  -> 页面筛选、展示和导出
-```
-
-本地承接表：
-
-| 数据类别 | 本地表 |
-| --- | --- |
-| 虚拟云仓库存 | `SupplyChainVirtualInventorySnapshot` |
-| 库存预警（按商品编码 + 仓库） | `ProductInventorySnapshot` |
-| 通知下架-编码维度 | `SupplyChainDiscontinuationNotice` |
-| 通知下架-链接维度 | `SupplyChainDiscontinuationNoticeLink` |
-| 未下架订单和乐捐 | `SupplyChainDiscontinuationPenalty` |
-
-## 3. 权威数据源
-
-### 3.1 简尚库存
-
-来源：`JianSun.dbo.jst_inventoryInfo_view`
-
-页面使用“公有可用数”口径：
-
-```text
-公有可用数
-= 库存
-- 虚拟云仓库存
-- 订单锁定数（包含缺货仓订单占有数）
-```
-
-- 虚拟云仓库存来自 `JianSun.dbo.jst_virtualstockStocksInfo`，按商品编码汇总。
-- 公有可用数小于 0 时按 0 处理。
-- 仓库名称通过 `JianSun.dbo.jst_warehouseInfo` 映射。
-- `三方-南昌樵舍仓` 作为京喜渠道仓单独汇总，不计入普通简尚库存。
-- 渠道专用仓库存不计入简尚主库存，单独返回到“渠道专用仓库存”和“专用仓备注”。
-- 库存预警的“库存所在仓库”只统计实际计入公有可用数且有正库存的普通仓。
-- 同一商品在多个仓库有库存时拆成多条明细，不合并仓库名称。
-- 虚拟云仓库存按各仓库存占比分摊到仓库明细，分摊后各行公有可用数合计与原商品汇总值一致。
-- 虚拟云仓先落到本地 `SupplyChainVirtualInventorySnapshot`，日任务只读本地快照，避免链接服务器偶发超时。
-- 日常通过 `scripts/sync-supply-chain-virtual-inventory-snapshot.ts` 从 `JianSun.dbo.jst_virtualstockStocksInfo` 同步；链接服务器不可用时，可用 `scripts/import-supply-chain-virtual-inventory-snapshot.ts` 导入页面导出文件作为兜底。
-
-### 3.2 工厂库存
-
-来源：`plm_productDiscontinuation`
-
-- 使用 `remainingStock` 作为供应商剩余库存量。
-- 按 `skucode` 去重，空条码忽略；同一商品编码存在多条记录时，以 `createTime DESC, Id DESC` 最新创建的一条为准。
-
-### 3.3 商品状态
-
-商品状态以聚水潭源表 `rpt.jst_sku.other_5` 为准，只纳入实时状态为停产、退市的编码。
-
-- 本地产品全量档案只用于补充 SKU、成本、名称等资料。
-- 本地档案同步较慢时，不能用档案中的旧状态决定当天停产/退市结果。
-- 若源表有、档案暂时没有的新停产编码，使用源表条码、货号和成本兜底进入计算。
-
-### 3.4 组合商品
-
-来源：
-
-- `rpt.jst_comboProductInfo`：组合商品主表。
-- `rpt.jst_comboProductItem`：组合商品与子商品明细。
-
-规则：
-
-- 只检查 `enabled=1` 的组合商品。
-- 子商品数量 `qty>0` 才参与判断。
-- 组合中任一子商品为停产/退市，且该子商品的简尚库存 + 工厂库存 = 0，则组合商品进入通知下架。
-- 支持组合嵌套：若子商品本身也是组合，继续向下递归检查，并对循环引用做保护。
-- 组合商品自身库存仍按组合编码从简尚库存和工厂库存表读取，用于页面展示。
-
-### 3.5 可替换商品
-
-来源：`rpt.pm_replacementManage` 与 `rpt.jst_sku_replace_rule`，两张表按同一套货号继承和条码展开规则合并。
-
-- `pm_replacementManage` 只读取 `delete=0` 且替换货号非空的数据；聚水潭表按启用/删除字段可用性自动过滤无效行。
-- 聚水潭替换表使用 `rpt.jst_sku_replace_rule`，只读取最新 `snapshot_date`；原编码取 `sku_id`，替换编码取 `data`，`data` 中逗号分隔的多个候选按顺序保留。
-- 同一原编码同时存在两张表规则时优先使用聚水潭替换表；聚水潭表不可读取时记录告警，并继续使用 `pm_replacementManage`。
-- 优先按完整商品编码匹配；完整编码没有规则时，按商品档案货号继承同货号其他条码的替换规则。
-- 兼容反向录入：若当前停产条码或其货号等于 `replaceSku`，则反向使用对应 `sku` 作为替换来源。
-- 同一原编码存在多条规则时，取 `createTime` 最新的一条。
-- 替换目标能在商品档案映射时，必须展开为具体 barcode；同货号有多个条码时优先销售、有库存、最近更新的条码。
-- 替换目标完全无法映射时，仍展示规则中的替换编码，但是否换图、区别点和价格差允许为空。
-- 是否换图取 `isSwapping`，1 为是。
-- 区别点取 `differentPoints`。
-- 价格差沿用现有页面口径：替换商品成本 - 原商品成本。
-
-### 3.6 店铺链接
-
-正式来源：聚水潭“店铺商品管理”完整前台导出（服务器 Chrome + RPA）。
-
-- 每日编码维度生成后，服务器 Chrome 自动批量查询并导出完整链接。
-- 默认先执行单次全量导出，连续尝试 3 次；第 1、2 次失败后重置页面再重试，
-  任一次成功立即结束；只有三次都失败后才切换为每批 10,000 个编码的分批导出。
-- 只保留 `online_status='是'` 且 `stock_sync_status='开启同步'` 的导出记录。
-- 全部批次成功后，在数据库事务中替换当天链接；失败时保留已有完整链接。
-- 最终有效写入为 0 时默认回滚；确有业务依据的正常零链接必须显式使用
-  `--allow-zero-links`，避免异常空文件清空当天快照。
-- 每个平台店铺商品编码独立展示，不合并多个平台店铺商品编码，不加总线上库存。
-- 运营负责人取 `op_TargetManagement.ider`（ID负责人）。
-- 部门负责人取 `op_TargetManagement.currCater`。
-- 利润中心取 `op_TargetManagement.dept`。
-- 同一商品ID在负责人表中存在多条时，按 `realTime DESC, Id DESC` 取最新一条。
-- 最终结果落到本地 `SupplyChainDiscontinuationNoticeLink`，页面不直接读取 Excel 或大表。
-
-链接维度页面字段顺序：
-
-1. 统计时间
-2. 平台
-3. 店铺名称
-4. 商品ID
-5. 平台店铺商品编码
-6. 线上商品编码
-7. 线上库存
-8. 运营负责人
-9. 部门负责人
-10. 利润中心
-11. 处理说明
-12. 可替换商品编码
-13. 区别点
-14. 是否换图
-15. 价格差
-16. 渠道专用仓库存
-
-前 10 项来自聚水潭完整导出和负责人表；后 6 项关联同一系统商品编码的编码维度快照。
-
-历史数据源差异留档：
-
-- 聚水潭前台导出：234,656 行、234,641 个唯一链接。
-- legacy 链接结果：779,412 行。
-- 完全匹配：234,337 个链接。
-- legacy 多余：545,075 个链接。
-- 仅使用 `jst_skumap` 主表：447,558 行。
-- 主表与前台精确匹配：182,276 个链接。
-- 主表漏掉前台链接：52,380 个。
-- 主表多出前台链接：265,282 个。
-- `jst_skumap.enabled=1` 无法完整复刻前台“库存同步状态 + 店铺链接是否上架”的当前视图。
-
-`dm_jst_shop_goods_link_daily` 仅用于差异诊断：
-
-- 2026-10-26 快照共 52,639 行，`imported_at` 为当天 10:18。
-- 同日聚水潭完整导出为 246,480 条；数据库快照匹配通知后只有 1,868 条，缺少 99% 以上完整链接。
-- 因此该表不能作为链接维度最终数据源。
-
-数据库快照诊断命令：
-
-```bash
-pnpm exec tsx scripts/sync-supply-chain-discontinuation-links-from-dm.ts --date=YYYY-MM-DD
-```
-
-只做只读核对时加 `--dry-run`。脚本默认在结果不足已有链接的 50% 时拒绝覆盖。
-
-Linux 每日任务（北京时间 10:30）：
-
-```bash
-sudo bash scripts/install-supply-chain-discontinuation-linux-timer.sh
-```
-
-任务顺序为“虚拟云仓库存快照 → 编码维度通知快照与库存预警快照 →
-聚水潭完整链接导出 → 未下架监控与乐捐快照”。
-
-每日任务启动时会先按当前 `prisma/schema.prisma` 重新生成 Prisma Client，
-并输出各数据源阶段日志，避免加载到旧客户端或无法判断卡在某一张外部表。
-系统不再依赖个人 Mac；服务器使用独立的 `furniture-jst-rpa-browser.service`
-和持久化 Chrome 登录态。
-RPA Python 路径由 `JST_RPA_PYTHON` 明确指定；Linux 安装器默认
-`/usr/bin/python3`，可用 `DISCONTINUATION_PYTHON_BIN` 覆盖。同步动作会在连接
-浏览器和开始导出前预检 Python，路径或执行权限有误时立即失败。
-正常整单导出次数默认由 `JST_RPA_ATTEMPTS=3` 控制，分批兜底大小默认由
-`JST_RPA_FALLBACK_BATCH_SIZE=10000` 控制。
-聚水潭账号密码只从服务器私有 `.env` 的 `JST_RPA_LOGIN_ID` 和
-`JST_RPA_LOGIN_PASSWORD` 读取；持久登录态有效时不会重复提交登录，
-失效时才自动填写登录页。凭据不得写入仓库或日志。
-
-只补库存预警、不重跑通知和链接时：
-
-```bash
-pnpm exec tsx scripts/generate-supply-chain-inventory-alert-snapshot.ts
-```
-
-服务与定时器日志通过 `journalctl -u furniture-discontinuation-daily` 查看。
-
-> 预策不作为任何数据源或参考流程；其数据正确仅因为每天人工导入了聚水潭前台文件。
-
-### 3.7 订单
-
-- 其他平台订单头：`jst_Orders`
-- 其他平台订单明细：`jst_orderitem`
-- 淘系订单头：`jst_qmcust_orderlist`
-- 淘系订单明细：`jst_qmcust_orderlist_item`
-
-订单只用于“未下架监控与申诉”和乐捐计算，不参与通知编码或库存预警：
-
-- 订单明细通过 `shop_sku_id` 与通知链接维度的平台店铺商品编码匹配。
-- 仅统计当月有通知下架的链接。
-- 排除订单状态 `Sent`（已发货）、`Delivering`（发货中）、`Split`（被拆分）、`Merged`（被合并）。
-- 仅当订单付款日期达到该链接首次通知下架日期后的第 2 天（含），才进入未处理明细；不按具体时分判断。
-- 页面默认统计日期为北京时间当天，可手动切换历史日期。
-- 未下架监控按“任务生成日期”归档，并实时计算到当前时间；通知后第 2 天起的所有后续订单都计入，不只是第 2 天当天。
-- 每日任务固定处理三天前的通知队列：23 日统计 20 日通知、22 日起流入的订单；24 日统计 21 日通知、23 日起流入的订单。
-- 同一订单命中同一平台店铺商品编码只计一笔；同一订单命中两个链接计两笔。
-- 乐捐唯一键为“内部订单号 + 平台店铺商品编码”，重复来源数据不会重复计费。
-- 运营可对自己的待申诉明细上传凭证并发起申诉；有业务管理操作权限的人员可审核通过、驳回或打回。
-- 申诉和审核均支持按链接批量处理：同一平台店铺商品编码下符合条件的订单一次覆盖。
-- 审核通过后原乐捐记录保留，但页面展示与月度汇总按 0 元计算，实现自动减免。
-- 负责人离职或无法匹配到员工目录在职记录时，状态显示“人员已离职”，乐捐金额按 0 元计算且不能申诉。
-- “人员已离职”可作为申诉状态筛选；筛选后可批量向部门负责人的钉钉个人工作通知推送处理提醒。
-- 未下架监控页顶部显示本月有效乐捐合计（¥10/单），审核通过的明细不计入合计。
-- 未下架监控支持个人列显示/拖拽排序、紧凑展示和筛选字段配置。
-
-## 4. 业务口径
-
-- 通知下架：商品状态为停产或退市，且简尚库存 + 工厂库存 = 0。
-- 京喜渠道判断：普通简尚库存、工厂库存和渠道专用仓库存均为 0，仅 `三方-南昌樵舍仓` 有库存时，处理说明为“仅京喜下架”；存在有效替换款时为“仅京喜替换”。
-- 南昌樵舍仓无库存或其他仓库仍有库存时，是否通知及替换判断继续沿用原逻辑；需要进入通知时，处理说明显示“全渠道下架”或“全渠道替换”。
-- 组合通知：组合商品任一子编码为停产/退市且合计库存为 0，整个组合进入通知下架。
-- 库存预警：商品状态为停产或退市，且公有可用数 + 工厂库存为 1 至 5；0 库存只进入通知下架。
-- 多仓商品先按商品编码判断是否进入预警，再拆成仓库明细；工厂库存没有仓库来源时单独展示为仓库为空的一条明细。
-- 通知后订单监控：付款日期达到该链接首次通知下架日期后的第 2 天（含）。例如 20 日通知，22 日全天的订单都计入。
-- 排除订单状态：已发货、发货中、被合并、被拆分。
-- 乐捐：按“订单 + 链接”组合计算，每组 10 元；同一订单命中两个链接计两笔。
-- 乐捐按月累计，次月 1 日开启新账期，历史明细保留。
-- 运营人员只能查看自己的订单和申诉数据。
-
-## 5. 接入约束
-
-- 新同步任务负责写入本地快照，页面 API 不承担跨库实时计算。
-- 编码维度、链接维度和库存预警必须使用同一统计日的库存口径。
-- 历史通知数据一经生成不得覆盖，每日任务只新增当日结果。
-- 同一统计日允许重跑并替换当天快照，其他日期保持不变。
-- 统计日期统一使用北京时间。
-- 页面查询不得直接访问任一外部数据源。

furniture-3d-system/docs/架构设计/外部只读契约巡检说明.md

@@ -47,9 +47,8 @@ npx prisma db execute --file scripts/sql/check-external-readonly-contract.sql
 - `missing_external_column`
 - `external_contract_private_column_risk`
 - `external_view_json_source_dependency_risk`
-- `external_readonly_role_public_schema_grant_risk`
-- `external_readonly_role_non_select_grant_risk`
-- `external_asset_url_unstable_or_internal_risk`
+- `external_reader_public_schema_grant_risk`
+- `external_reader_non_select_grant_risk`
 - `product_assets_data_url_risk`
 - `product_sku_business_key_duplicate_risk`
 - `intake_product_business_key_duplicate_risk`

furniture-3d-system/docs/架构设计/外部只读视图字段字典-v1.md

@@ -168,10 +168,6 @@
 | `visual_planning` | 空间/视觉负责人 |
 | `structure_designer` | 结构设计负责人 |
 | `purchase_owner` | 采购负责人结构化字段 |
-| `appearance_designer` | 外观设计师明确字段；来自非集成产品基础列 |
-| `spu_owner` | SPU 负责人明确字段；优先来自结构化 profile，旧运营负责人只作兜底 |
-| `planning_owner` | 商品企划明确字段；来自结构化 profile |
-| `space_designer` | 空间设计师明确字段；优先来自结构化 profile 的空间/视觉负责人 |
 | `product_development_kind` | 开发类型 |
 | `goods_type` | 商品类型 |
 | `material_type` | 材料类型 |
@@ -181,7 +177,7 @@
 
 - 该视图过滤已软删除记录。
 - 产品名称、图片、品类、年份、状态、开发类型、货品类型、材质类型、生产类型和结构化负责人字段来自 `IntakeNonIntegratedProductProfile`，不再直接读取 `payload`。
-- `designer / operator / purchaser` 是兼容列，优先输出 profile 中的结构设计、商品企划、采购负责人；旧产品行列只作为兼容兜底。新接入优先读取 `appearance_designer / structure_designer / spu_owner / planning_owner / space_designer / purchase_owner` 这些明确字段。
+- `designer / operator / purchaser` 是兼容列，优先输出 profile 中的结构设计、商品企划、采购负责人；旧产品行列只作为兼容兜底。
 - `intake_product_id` 只用于内部追踪和问题定位；外部系统同步、去重和幂等更新必须优先使用 `product_business_key`。
 - 不开放 `visibility`、`departmentId`、`teamId`、审批状态、内部确认状态。
 - `external.intake_products_ready_v1` 使用同一字段结构，但只保留产品名称、品类、开发类型和 `product_business_key` 都已补齐的记录。外部系统做稳定同步时优先读取 ready 视图；`intake_products_v1` 用于治理对账和人工补齐。
@@ -215,41 +211,6 @@
 | `size_json` | 尺寸 JSON |
 | `color` | 颜色/花色 |
 | `material` | 材质 |
-| `appearance_designer` | 产品开发明细的外观设计师；开发阶段 ready 行来自产品资料负责人字段，正式商品行暂为空 |
-| `structure_designer` | 产品开发明细的结构设计师；开发阶段 ready 行来自产品资料负责人字段，正式商品行暂为空 |
-| `spu_owner` | 产品开发明细的 SPU 负责人；开发阶段 ready 行来自产品资料负责人字段，正式商品行暂为空 |
-| `planning_owner` | 产品开发明细的商品企划；开发阶段 ready 行来自产品资料负责人字段，正式商品行暂为空 |
-| `space_designer` | 产品开发明细的空间设计师；开发阶段 ready 行来自产品资料负责人字段，正式商品行暂为空 |
-| `purchase_owner` | 产品开发明细的采购负责人；开发阶段 ready 行来自产品资料负责人字段，正式商品行暂为空 |
-| `supplier_name` | 产品定厂供应商名称；开发阶段 ready 行来自结构化 SKU 定厂资料，正式商品行暂为空 |
-| `supplier_code` | 产品定厂供应商编码；开发阶段 ready 行来自结构化 SKU 定厂资料，正式商品行暂为空 |
-| `factory_warehouse` | 产品定厂发货仓；与库存库位 `warehouse_location_name` 是两个不同业务字段 |
-| `shipping_method` | 产品定厂发货方式 |
-| `minimum_order_quantity` | 产品定厂最低起订量 |
-| `tax_included_unit_price` | 产品定厂含税单价 |
-| `lead_time` | 产品定厂交期 |
-| `install_method` | 产品定厂安装方式 |
-| `jst_product_pushed_at` | 商品资料成功推送聚水潭的时间；未成功推送时为空 |
-| `is_external_intake` | 是否由外部录入人员创建 |
-| `supply_chain_archive_eligible` | 是否满足供应链产品全量档案当前入档规则 |
-| `source_pricing_row_id` | 产品开发核价记录 ID，用于追踪原始业务记录 |
-| `source_product_id` | 产品开发产品 ID，用于定向增量同步和排查 |
-| `source_sku_item_id` | 产品开发结构化 SKU 行 ID |
-| `product_development_created_at` | 产品首次录入产品开发系统的时间，作为档案创建时间口径 |
-| `product_development_updated_at` | 产品开发系统最近更新时间 |
-| `archive_spu / archive_sku` | 产品全量档案使用的 SPU、SKU 口径 |
-| `archive_product_name` | 产品全量档案商品名称，来自条码对应规格名称 |
-| `archive_image` | 产品开发条码/SKU 图片原值 |
-| `sales_category_name` | 一级类目，例如桌类、柜类 |
-| `archive_product_category_name` | 二级类目原值，档案同步时补住宅家具/商业办公/其他前缀 |
-| `sku_sales_status` | 销售状态原值；档案只接受销售、停产、退市 |
-| `brand_name` | 产品开发品牌 |
-| `sample_weight_kg` | 样包测量重量（千克） |
-| `package_length_cm / package_width_cm / package_height_cm` | 样包长宽高（厘米） |
-| `package_volume_cm3` | 样包体积（立方厘米） |
-| `package_set_count` | 套件量；档案转换为非双包、双包至九包 |
-| `purchase_order_method` | 叫货/采购方式 |
-| `archive_shipping_method` | 产品全量档案的入仓/代发口径 |
 | `warehouse_location_code` | 仓库库位编码 |
 | `warehouse_zone / warehouse_aisle / warehouse_shelf / warehouse_bin` | 库位物理位置 |
 | `warehouse_location_status` | 库位状态：`ACTIVE` / `INACTIVE` |
@@ -288,16 +249,9 @@
 
 注意：
 
-- 产品全量档案只读取本宽表中 `supply_chain_archive_eligible = true` 的记录，不再由同步程序直接关联产品开发业务表或解析 `payload`。
-- 当前入档规则为：产品开发系统创建、商品资料已成功推送聚水潭、创建人不是外部录入人员。
-- 同一条码即使最终目录行优先采用正式商品，产品开发的入档字段仍按条码附加在该行末尾，避免来源标记被正式行覆盖。
-
-- 该视图保持一条码一行，适合外部系统做商品目录同步；同一 SKU 下多个条码会输出多行。
+- 该视图保持一 SKU 一行，适合外部系统做商品目录同步。
 - 如果外部系统只想读一张表，优先使用该宽表；它已经覆盖正式 SKU 与可消费的 non-integrated ready SKU，以及产品资料、库存库位摘要、包装库存摘要和最新质检摘要。
-- 需要逐条素材或逐条 BOM 时，仍读取 `external.product_assets_v1 / external.product_bom_v1`；这两张明细视图是否对外授权，以当前 `external_core_reader` 白名单为准。
-- 所有 URL 字段都应是完整系统入口；相对的 `/api/...` 或 `/materials/...` 路径会在外部视图层按 `app.external_asset_base_url` 补全，未设置时默认补到 `https://cp.jiansun.vip`。
-- `appearance_designer / structure_designer / spu_owner / planning_owner / space_designer / purchase_owner` 是产品开发明细页红框负责人字段的外部同步口径；它们只对 non-integrated ready 行有明确来源，正式商品行没有开发阶段上下文时保持空值。
-- `supplier_name / supplier_code / factory_warehouse / shipping_method / minimum_order_quantity / tax_included_unit_price / lead_time / install_method` 来自结构化非集成 SKU 定厂资料；外部视图不读取 `payload.factoryRows`。其中 `factory_warehouse` 是定厂发货仓，不得与库存库位字段混用。
+- 需要逐条素材或逐条 BOM 时，仍读取 `external.product_assets_v1 / external.product_bom_v1`。
 - 需要逐条包装库存或质检明细时，读取 `external.packaged_items_v1 / external.sku_quality_inspections_v1`。
 - 限价口径：`存量商品明细` 的产品一般没有限价，宽表会输出 `limit_price_status = NOT_APPLICABLE`；`产品开发明细`、`模块化产品明细` 到 `产品限价` 节点确认后，限价视为正式口径并输出为 `CONFIRMED`。
 - `product_id / sku_id` 只用于内部追踪；正式行会输出正式产品/SKU ID，non-integrated ready 行会输出 `intake_product_id / intake_sku_item_id`；外部主同步、去重和幂等更新必须使用 `barcode_business_key`。

furniture-3d-system/docs/架构设计/店铺账号管理取数与筛选逻辑.md

@@ -1,363 +0,0 @@
-# 店铺账号管理取数与筛选逻辑
-
-> 用途：给需要接入店铺账号管理数据的开发人员使用。本文描述当前代码和数据库的真实口径。
->
-> 重要：本文不包含数据库连接串、账号、密码、加密密钥或任何业务明文数据。当前数据由本系统人工维护，不直接从外部数据库同步。
-
-## 1. 数据源与责任边界
-
-- **权威数据源**：本系统使用 `DATABASE_URL` 指向的 PostgreSQL 数据库，数据通过本系统店铺账号管理页面/API 人工新增、编辑、导入和维护。
-- **不属于数据源的内容**：聚水潭、京东、京喜等外部系统目前不是本模块的自动同步来源；不能假设外部系统中存在同一份实时数据。
-- **推荐接入方式**：优先调用本系统鉴权 API。若确实需要数据库直读，应由数据库管理员单独创建只读账号或只读视图，并按本文的字段白名单开放；不要复用应用账号，也不要把应用数据库密码或加密密钥交给外部系统。
-- **人工维护原则**：不要直接写入业务表绕过 Service。直接写入会跳过页面权限、字段权限、密文加密、唯一键校验和操作日志。
-
-### 1.1 代码与迁移依据
-
-当前数据契约以以下文件为准：
-
-- Prisma 模型：`prisma/schema.prisma` 中 `StoreAccount`、`StoreAccountStoreProfile`、`StoreAccountChangeLog`、`StoreAccountFieldPermission`、`SupplyChainPermissionOverride`。
-- 建表迁移：`prisma/migrations/20260826120000_add_store_account_management/migration.sql`。
-- 店铺主体和银行卡字段、平台资料表迁移：`prisma/migrations/20260828100000_extend_store_account_profiles/migration.sql`。
-- 列表筛选规则：`src/server/repositories/store-account-management.repository.ts`。
-- 业务校验、脱敏和日志：`src/server/services/store-account-management.service.ts`。
-- 导出字段：`src/server/services/store-account-management-export.service.ts`。
-
-## 2. 物理表清单与关联关系
-
-PostgreSQL 物理表名使用双引号保留大小写，取数时应写成下表中的名称。
-
-| 物理表 | 用途 | 主要关联键 | 是否主业务数据 |
-| --- | --- | --- | --- |
-| `"StoreAccount"` | 店铺账号主记录，一行代表一个店铺下的一种账号 | `id`；业务唯一键为 `storeName + accountType + account` | 是 |
-| `"StoreAccountStoreProfile"` | 京东/京喜店铺资料，一行代表一个店铺的一个平台资料 | 逻辑关联 `storeName`，平台由 `platform` 区分 | 是（扩展资料） |
-| `"StoreAccountChangeLog"` | 新增、编辑、导入、查看敏感字段、资料维护的审计日志 | `storeAccountId` 可为空；资料日志用 `storeName` | 否（审计） |
-| `"StoreAccountFieldPermission"` | 店铺账号字段对业务类型/个人的可见、只读、可编辑配置 | `fieldKey + subjectKey` 唯一 | 否（权限配置） |
-| `"SupplyChainPermissionOverride"` | 页面级的查看、下载、编辑权限 | `targetKey + subjectKey + action` 唯一；本模块 `targetKey = 'storeAccountManagement'` | 否（权限配置） |
-
-`StoreAccountStoreProfile` 与 `StoreAccount` 没有数据库外键，应用层按 `storeName` 关联。因此外部查询时要注意：资料表可能没有对应账号行，也可能一个店铺有多个账号行；不要用 `id` 去连接资料表。
-
-## 3. `"StoreAccount"` 字段字典
-
-| 字段 | PostgreSQL 类型/约束 | 业务含义 | 空值与敏感性 |
-| --- | --- | --- | --- |
-| `id` | `TEXT`，主键 | 账号记录 ID | 系统生成，不为空 |
-| `storeName` | `TEXT NOT NULL` | 店铺名称，也是资料表的逻辑关联键 | 不应为空；支持多选筛选 |
-| `operationOwner` | `TEXT NOT NULL DEFAULT ''` | 店铺运营负责人 | 空字符串表示未维护 |
-| `operationDepartmentHead` | `TEXT NOT NULL DEFAULT ''` | 店铺运营部门负责人 | 空字符串表示未维护 |
-| `operationDirector` | `TEXT NOT NULL DEFAULT ''` | 店铺运营总监 | 空字符串表示未维护 |
-| `profitCenter` | `TEXT NOT NULL DEFAULT ''` | 店铺所属利润中心 | 空字符串或：`运营中心A`、`运营中心B`、`运营中心C`、`运营中心G` |
-| `subject` | `TEXT NOT NULL DEFAULT ''` | 店铺主体 | 空字符串表示未维护 |
-| `accountType` | `TEXT NOT NULL` | 账号类型 | 正常值 `MAIN`（主账号）、`SUB`（子账号）；不完整导入允许空字符串或 `/` |
-| `account` | `TEXT NOT NULL` | 登录账号 | 新增时必填 |
-| `passwordCiphertext` | `TEXT NOT NULL DEFAULT ''` | 密码密文 | 绝不作为普通取数字段返回；空字符串表示未设置 |
-| `boundBankAccountNumberCiphertext` | `TEXT NOT NULL DEFAULT ''` | 店铺绑定银行卡号密文 | 与密码同等级敏感；空字符串表示未设置 |
-| `boundPhone` | `TEXT NOT NULL DEFAULT ''` | 绑定手机号 | 空字符串表示未维护 |
-| `verificationContact` | `TEXT NOT NULL DEFAULT ''` | 手机号验证码对接人 | 空字符串表示未维护 |
-| `jstOrderService` | `TEXT NOT NULL DEFAULT ''` | 聚水潭订单服务号 | 空字符串表示未维护 |
-| `accountGroupName` | `TEXT NOT NULL DEFAULT ''` | 账号分组名称 | 空字符串表示未维护 |
-| `createdById` | `TEXT` 可空 | 首次创建人 ID | 系统审计字段 |
-| `updatedById` | `TEXT` 可空 | 最近修改人 ID | 系统审计字段 |
-| `createdAt` | `TIMESTAMP(3) NOT NULL` | 账号记录创建时间 | 系统生成；列表按此字段倒序 |
-| `updatedAt` | `TIMESTAMP(3) NOT NULL` | 账号记录最近修改时间 | 系统自动更新时间 |
-
-约束和索引：
-
-- 唯一约束：`("storeName", "accountType", "account")`，导入按这三个字段执行 upsert。
-- 索引：`storeName`、`account`、`accountType`、`updatedAt`。
-- 本表没有软删除字段；空白字段是空字符串，不使用“系统默认值”兜底。
-
-## 4. `"StoreAccountStoreProfile"` 字段字典
-
-该表用于“京东/京喜店铺资料”次页面的后续维护，不要求在账号主表导入时同时填写。
-
-| 字段 | PostgreSQL 类型/约束 | 业务含义 | 取值规则 |
-| --- | --- | --- | --- |
-| `id` | `TEXT`，主键 | 店铺平台资料 ID | 系统生成 |
-| `storeName` | `TEXT NOT NULL` | 店铺名称 | 与 `StoreAccount.storeName` 逻辑关联 |
-| `platform` | `TEXT NOT NULL` | 平台代码 | `JD`=京东，`JX`=京喜 |
-| `merchantNumber` | `TEXT NOT NULL DEFAULT ''` | 商户号（钱包商户号） | 空字符串表示未维护 |
-| `secondaryMerchantNumber` | `TEXT NOT NULL DEFAULT ''` | 二级商户号 | 空字符串表示未维护 |
-| `merchantStoreId` | `TEXT NOT NULL DEFAULT ''` | 商家 ID（钱包店铺号） | 空字符串表示未维护 |
-| `companyId` | `TEXT NOT NULL DEFAULT ''` | 公司 ID（京麦店铺 ID） | 空字符串表示未维护 |
-| `createdById` | `TEXT` 可空 | 首次创建人 ID | 系统审计字段 |
-| `updatedById` | `TEXT` 可空 | 最近修改人 ID | 系统审计字段 |
-| `createdAt` | `TIMESTAMP(3) NOT NULL` | 资料创建时间 | 系统生成 |
-| `updatedAt` | `TIMESTAMP(3) NOT NULL` | 资料最近修改时间 | 系统自动更新时间 |
-
-约束和平台规则：
-
-- 唯一约束：`("storeName", "platform")`，同一店铺同一平台只有一条资料。
-- 店铺名以 `京东-` 开头时只能使用 `JD`；以 `京喜-` 开头时只能使用 `JX`。
-- 非 `京东-` 或 `京喜-` 开头的店铺不支持店铺资料页面/API，服务端会拒绝读取或保存。
-- 资料字段通过 `storeName` 关联账号主表，导出时会按平台展开为京东四列和京喜四列。
-
-## 5. `"StoreAccountChangeLog"` 字段与日志格式
-
-| 字段 | PostgreSQL 类型/约束 | 含义 |
-| --- | --- | --- |
-| `id` | `TEXT`，主键 | 日志 ID |
-| `storeAccountId` | `TEXT` 可空 | 账号记录 ID；店铺资料变更时为空 |
-| `storeName` | `TEXT NOT NULL` | 店铺名称 |
-| `operation` | `TEXT NOT NULL` | 操作类型 |
-| `actorId` | `TEXT` 可空 | 操作人 ID |
-| `actorName` | `TEXT NOT NULL` | 操作人名称 |
-| `changes` | `JSONB NOT NULL` | 字段变更明细数组 |
-| `createdAt` | `TIMESTAMP(3) NOT NULL` | 日志时间 |
-
-当前 `operation` 代码：
-
-| operation | 含义 |
-| --- | --- |
-| `CREATE` | 新增账号 |
-| `UPDATE` | 编辑账号 |
-| `IMPORT_CREATE` | 导入新增 |
-| `IMPORT_UPDATE` | 导入更新 |
-| `BATCH_UPDATE` | 批量修改 |
-| `VIEW_PASSWORD` | 查看密码 |
-| `VIEW_BANK_ACCOUNT` | 查看银行卡号 |
-| `PROFILE_UPDATE` | 修改京东/京喜店铺资料 |
-
-`changes` 的标准元素为：
-
-```json
-{
-  "field": "operationOwner",
-  "previousValue": "原值",
-  "nextValue": "新值"
-}
-```
-
-特殊字段和资料字段：
-
-- `password`、`boundBankAccountNumber` 只记录“已设置/未设置”，不写入明文或密文。
-- 查看敏感字段时记录 `nextValue: "已查看"`。
-- 平台资料字段使用 `JD.merchantNumber`、`JX.companyId` 这样的字段名。
-- API 返回日志前还会根据当前调用人的字段权限过滤隐藏字段。
-
-## 6. `"StoreAccountFieldPermission"` 字段字典
-
-| 字段 | PostgreSQL 类型/约束 | 含义 |
-| --- | --- | --- |
-| `id` | `TEXT`，主键 | 权限记录 ID |
-| `fieldKey` | `TEXT NOT NULL` | 店铺账号字段 key，如 `account`、`password`、`boundBankAccountNumber` |
-| `subjectKey` | `TEXT NOT NULL` | 业务类型或个人主体 |
-| `visibility` | `TEXT NOT NULL DEFAULT 'READONLY'` | `HIDDEN`、`READONLY` 或 `EDITABLE` |
-| `updatedById` | `TEXT` 可空 | 最后配置人 ID |
-| `createdAt` / `updatedAt` | `TIMESTAMP(3)` | 权限记录时间 |
-
-当前可配置的业务类型 `subjectKey`：
-
-`design`（设计）、`planning`（企划）、`brandCenter`（策划）、`purchase`（采购）、`merchandiser`（采购-跟单）、`pricing`（采购-核价）、`quality`（采购-质检）、`operation`（运营）、`warehouse`（仓库）、`customerService`（客服）、`management`（经管）、`viewer`（普通用户）。
-
-个人例外使用 `user@<用户ID>`。唯一约束为 `("fieldKey", "subjectKey")`。`createdAt`、`updatedAt` 是系统字段，不能通过字段权限配置为可编辑。
-
-## 7. 页面级权限表
-
-`"SupplyChainPermissionOverride"` 的 `targetKey` 固定为 `storeAccountManagement`，`action` 为 `view`、`download`、`edit`。
-
-| 场景 | 当前规则 |
-| --- | --- |
-| 未登录 | 所有店铺账号接口返回 401 |
-| 页面查看 | 需要工作台可见且 `storeAccountManagement:view` 生效 |
-| 新增、编辑、导入、批量修改 | 需要页面 `edit` |
-| 导出全部或已选 | 需要页面可见，且调用人是管理员或经管 |
-| 配置字段权限 | 需要页面可见，且调用人是管理员或经管 |
-| 密码/银行卡查看 | 还要通过对应字段权限；服务端单独记录查看日志 |
-
-字段可见性解析顺序：
-
-1. 页面没有 `view` 时，所有字段均为 `HIDDEN`。
-2. 先取页面编辑能力形成基础值：系统时间字段只读，密码和银行卡默认隐藏，普通字段按页面编辑能力为可编辑或只读。
-3. 同一字段的业务类型配置按 `EDITABLE > READONLY > HIDDEN` 合并。
-4. `user@<用户ID>` 的个人配置覆盖业务类型配置。
-5. 没有页面编辑权时，即使字段配置为 `EDITABLE` 也会降为只读；系统时间字段永远不会变成可编辑。
-
-列表接口对隐藏字段返回空字符串；密码和银行卡只返回 `passwordConfigured`、`boundBankAccountNumberConfigured` 布尔值，不返回密文。
-
-## 8. 列表取数与筛选逻辑
-
-### 8.1 API 参数
-
-`GET /api/supply-chain/store-account-management`
-
-| 参数 | 默认/限制 | 逻辑 |
-| --- | --- | --- |
-| `page` | 默认 `1`，最小 `1` | 页码 |
-| `pageSize` | 默认 `50`，范围 `1..200` | 每页行数；页面常用 50/100/200 |
-| `search` | 最多 120 字符 | 关键词，可用空格、逗号、中文逗号、分号分隔多个 token |
-| `storeName` | 最多 120 字符 | 店铺名称多选值，同样支持逗号、中文逗号、分号分隔 |
-| `accountType` | 空、`MAIN`/`SUB` 或显示名 | 包含匹配；页面显示主账号/子账号 |
-| `operationOwner` | 空或文本 | 店铺运营负责人包含匹配 |
-| `accountGroupName` | 空或文本 | 账号分组名称包含匹配 |
-| `createdAtGranularity` | `year`、`month`、`day` | 创建时间筛选粒度 |
-| `createdAtValue` | 年 `YYYY`；月 `YYYY-MM`；日 `YYYY-MM-DD` | 与粒度配套的值 |
-
-### 8.2 条件组合
-
-- 不同筛选项之间是 **AND**。
-- `search` 内部每个 token 会对以下字段做 **OR**：`storeName`、`account`、`operationOwner`、`operationDepartmentHead`、`operationDirector`、`profitCenter`、`subject`、`boundPhone`、`verificationContact`、`jstOrderService`、`accountGroupName`。
-- `search` 不搜索密码、银行卡、创建时间、修改时间和京东/京喜资料字段。
-- `storeName` 会拆分并去重，使用精确 `IN` 匹配；最多取 500 个店铺名。
-- `accountType`、`operationOwner`、`accountGroupName` 使用不区分大小写的 `contains` 匹配。
-- 创建时间使用中国时区 `+08:00` 的半开区间：`[开始时间, 结束时间)`。例如 `2026-08` 是 `2026-08-01 00:00:00+08:00`（含）到 `2026-09-01 00:00:00+08:00`（不含）。
-
-### 8.3 排序与分页
-
-固定排序：
-
-```sql
-ORDER BY "createdAt" DESC, "id" ASC
-```
-
-因此最新创建的记录永远在前面；`id ASC` 只用于创建时间相同时稳定排序。分页使用 `OFFSET (page - 1) * pageSize LIMIT pageSize`，同时查询总数。
-
-成功响应核心结构：
-
-```json
-{
-  "success": true,
-  "data": {
-    "rows": [],
-    "storeNames": ["京东-示例店"],
-    "pageInfo": { "page": 1, "pageSize": 50, "total": 0, "totalPages": 1 },
-    "fieldAccess": {}
-  },
-  "meta": { "requestId": "...", "timestamp": "..." }
-}
-```
-
-`storeNames` 是全表去重后按名称升序返回的店铺列表，用于前端多选；它不受当前页面筛选条件限制。
-
-## 9. 只读 SQL 示例
-
-以下 SQL 仅用于说明字段和筛选口径，执行账号必须是单独的只读账号。示例不包含密码密文列。
-
-### 9.1 最新账号列表
-
-```sql
-SELECT
-  "id", "storeName", "operationOwner", "operationDepartmentHead",
-  "operationDirector", "profitCenter", "subject", "accountType",
-  "account", "boundPhone", "verificationContact", "jstOrderService",
-  "accountGroupName", "createdAt", "updatedAt"
-FROM "StoreAccount"
-ORDER BY "createdAt" DESC, "id" ASC
-LIMIT 50 OFFSET 0;
-```
-
-### 9.2 店铺 + 账号类型 + 月份筛选
-
-```sql
-SELECT
-  "id", "storeName", "accountType", "account", "createdAt", "updatedAt"
-FROM "StoreAccount"
-WHERE "storeName" IN ('京东-示例店', '京喜-示例店')
-  AND "accountType" = 'MAIN'
-  AND "createdAt" >= TIMESTAMPTZ '2026-08-01 00:00:00+08:00'
-  AND "createdAt" <  TIMESTAMPTZ '2026-09-01 00:00:00+08:00'
-ORDER BY "createdAt" DESC, "id" ASC;
-```
-
-### 9.3 关键词筛选的 SQL 等价写法
-
-```sql
-WHERE (
-  "storeName" ILIKE '%' || $1 || '%'
-  OR "account" ILIKE '%' || $1 || '%'
-  OR "operationOwner" ILIKE '%' || $1 || '%'
-  OR "operationDepartmentHead" ILIKE '%' || $1 || '%'
-  OR "operationDirector" ILIKE '%' || $1 || '%'
-  OR "profitCenter" ILIKE '%' || $1 || '%'
-  OR "subject" ILIKE '%' || $1 || '%'
-  OR "boundPhone" ILIKE '%' || $1 || '%'
-  OR "verificationContact" ILIKE '%' || $1 || '%'
-  OR "jstOrderService" ILIKE '%' || $1 || '%'
-  OR "accountGroupName" ILIKE '%' || $1 || '%'
-)
-```
-
-多个 token 时，把每个 token 的上述括号用 `AND` 连接。
-
-### 9.4 查询平台资料
-
-```sql
-SELECT
-  "storeName", "platform", "merchantNumber", "secondaryMerchantNumber",
-  "merchantStoreId", "companyId", "createdAt", "updatedAt"
-FROM "StoreAccountStoreProfile"
-WHERE "storeName" = $1
-  AND "platform" IN ('JD', 'JX')
-ORDER BY "platform" ASC;
-```
-
-资料缺失时不要补默认值；没有行或字段为空都表示尚未维护。
-
-### 9.5 查询审计日志
-
-```sql
-SELECT
-  "id", "storeAccountId", "storeName", "operation",
-  "actorId", "actorName", "changes", "createdAt"
-FROM "StoreAccountChangeLog"
-WHERE "storeName" = $1
-ORDER BY "createdAt" DESC
-LIMIT 200;
-```
-
-## 10. 当前 API 接口清单
-
-所有接口都要求登录，并返回统一的 `{ success, data/error, meta }` 包装。接口权限还会检查工作台权限和 `storeAccountManagement` 页面权限。
-
-| 方法 | 路径 | 用途 | 主要限制 |
-| --- | --- | --- | --- |
-| `GET` | `/api/supply-chain/store-account-management` | 分页列表、筛选、店铺名称选项 | 页面 `view` |
-| `POST` | `/api/supply-chain/store-account-management` | 新增账号 | 页面 `edit`；店铺名、账号类型、账号必填 |
-| `GET` | `/api/supply-chain/store-account-management/{id}` | 单条账号 | 页面 `view` |
-| `PATCH` | `/api/supply-chain/store-account-management/{id}` | 编辑账号 | 页面 `edit`；只更新有权限的字段 |
-| `POST` | `/api/supply-chain/store-account-management/import` | Excel/CSV 导入账号 | 页面 `edit`；10 MB、5000 行；NDJSON 进度 |
-| `POST` | `/api/supply-chain/store-account-management/batch` | 批量修改前预览 | 页面 `edit` + 目标字段 `EDITABLE`；最多 500 条 |
-| `PATCH` | `/api/supply-chain/store-account-management/batch` | 批量修改 | 同上；密码、银行卡和系统时间不可批量修改 |
-| `GET` | `/api/supply-chain/store-account-management/export` | 导出全部账号 | 仅管理员或经管；包含明文密码/银行卡，必须严格控制调用方 |
-| `GET` | `/api/supply-chain/store-account-management/export?scope=selected&ids=id1,id2` | 导出已选账号 | 仅管理员或经管；最多 200 个 ID |
-| `GET` | `/api/supply-chain/store-account-management/logs?id=...` | 查询单账号日志 | 页面 `view`；返回内容按字段权限过滤 |
-| `GET` | `/api/supply-chain/store-account-management/logs?storeName=...` | 查询店铺日志 | 页面 `view`；最多返回 200 条 |
-| `GET` | `/api/supply-chain/store-account-management/{id}/password` | 查看密码明文 | 字段可见；响应不缓存，并写查看日志 |
-| `GET` | `/api/supply-chain/store-account-management/{id}/bank-account` | 查看银行卡号明文 | 字段可见，并写查看日志 |
-| `GET` | `/api/supply-chain/store-account-management/permissions` | 读取字段权限配置 | 仅管理员或经管 |
-| `PUT` | `/api/supply-chain/store-account-management/permissions` | 保存字段权限配置 | 仅管理员或经管；最多 500 条更新 |
-| `GET` | `/api/supply-chain/store-account-management/profiles?storeName=...` | 读取京东/京喜店铺资料 | 页面 `view`；店铺名前缀必须匹配 |
-| `PATCH` | `/api/supply-chain/store-account-management/profiles` | 保存平台资料 | 页面 `edit`；平台必须与店铺名前缀一致 |
-| `GET` | `/api/supply-chain/store-account-management/profiles/template?platform=JD\|JX` | 下载平台资料模板 | 页面 `edit` |
-| `POST` | `/api/supply-chain/store-account-management/profiles/import` | 导入平台资料 | 页面 `edit`；表单字段 `file` + `platform`，10 MB、5000 行 |
-
-导出文件为 XLSX，包含账号主表字段、解密后的密码和绑定银行卡号，以及按 `JD`/`JX` 展开的八个店铺资料字段。外部系统若不需要敏感字段，不应调用导出接口，应该调用列表接口或使用只读白名单视图。
-
-## 11. 导入、更新和空白值规则
-
-- 主表导入支持中文表头和内部英文 key；未知列会被忽略。
-- 行数上限 5000，文件上限 10 MB；每一行按 `storeName + accountType + account` upsert，并写入 `IMPORT_CREATE` 或 `IMPORT_UPDATE` 日志。
-- 普通文本字段导入空白会保存为空字符串，表示“未维护”；不会套用系统默认值。
-- 密码和绑定银行卡号为空时不会覆盖已有密文；要清除敏感值需由具备相应字段编辑权限的业务流程明确处理，不能通过普通空白导入误清除。
-- 新增账号时 `storeName`、`accountType`、`account` 必填，`accountType` 正常应为 `MAIN` 或 `SUB`。
-- 批量修改会先返回所选记录当前值预览，再统一更新；每条实际发生变化的记录写一条 `BATCH_UPDATE` 日志。
-- 平台资料导入只识别“店铺名称”和四个资料字段，按店铺名和平台 upsert；空白资料仍然允许保存。
-
-## 12. 敏感字段与外部接入注意事项
-
-1. `passwordCiphertext` 和 `boundBankAccountNumberCiphertext` 使用 AES-256-GCM 存储，密钥来自服务端 `STORE_ACCOUNT_ENCRYPTION_KEY`（生产必须配置至少 32 个字符）。
-2. 外部系统不能自行解密，也不能索要或复制该密钥；密文列不应进入普通数据同步任务、日志或缓存。
-3. 普通列表接口只返回“是否已设置”布尔值；明文只通过受权限保护的查看接口或管理员/经管导出得到，并且会留下审计日志。
-4. 字段权限和页面权限不是同一层：先满足页面 `view/edit`，再应用业务类型和个人字段权限。
-5. 直连数据库时建议只开放不敏感白名单字段，至少排除两个 `*Ciphertext` 字段、权限表和日志中的敏感上下文；如需日志，应单独授予审计读取权限。
-6. 当前没有外部只读视图或公开 Token 契约。外部接入前应由系统负责人确认鉴权方式、限流、字段白名单、数据刷新频率和脱敏要求。
-
-## 13. 接入前检查清单
-
-- [ ] 确认读取的是当前 `DATABASE_URL` 对应的 PostgreSQL，而不是历史数据库或外部平台库。
-- [ ] 使用本文中的双引号物理表名和字段名，确认迁移已执行。
-- [ ] 明确只读范围：主表、平台资料、日志、权限配置是否都需要。
-- [ ] 明确是否需要京东/京喜资料，按 `storeName + platform` 读取，不能按账号 `id` 连接。
-- [ ] 明确筛选时区为中国 `+08:00`，创建时间使用半开区间。
-- [ ] 按 `createdAt DESC, id ASC` 保持与页面相同的排序。
-- [ ] 不读取或传播密码、银行卡密文；需要明文时走授权接口并保留审计记录。
-- [ ] 不直接写表；新增、编辑、导入和权限变更必须走系统 API 或经负责人批准的维护流程。

furniture-3d-system/docs/架构设计/数据库主数据治理与外部只读契约.md

@@ -134,7 +134,6 @@
 - `payload.skuItems` 作为历史过程快照保留，用于同步差异巡检，不作为对外主数据来源。
 - `IntakeNonIntegratedProductProfile` 承接产品名称、主图、品类、销售分类、年份、状态、开发类型、货品类型、材质类型、生产类型、主要负责人等产品头主数据。
 - `IntakeNonIntegratedProductLimitRow` 承接产品限价行，来源是 `productLimitRows` 的结构化同步副本，不允许外部系统直接读取 `payload` 推断限价。
-- 产品定厂的供应商、发货仓、发货方式、最低起订量、含税单价、交期和安装方式由 `IntakeNonIntegratedSkuItem` 结构化列承接；`payload.factoryRows` 只保留兼容快照，不作为外部主读来源。
 - `external.intake_products_v1` 读取 `IntakeNonIntegratedProductProfile`，不再直接从 `payload` / `openingReference` 读取产品头主数据。
 - `external.intake_product_limits_v1` 读取 `IntakeNonIntegratedProductLimitRow`；`存量商品明细` 默认限价不适用，`产品开发明细` 和 `模块化产品明细` 到 `产品限价` 节点确认后才视为正式限价。
 - `external.intake_products_v1 / external.intake_sku_items_v1` 显式输出稳定业务键：`product_business_key = 品牌:SPU`，`sku_business_key = 品牌:SPU:SKU编码`；这些键用于产品归组和兼容关联。
@@ -215,7 +214,7 @@ CREATE SCHEMA IF NOT EXISTS external;
 | 视图 | 用途 |
 | --- | --- |
 | `external.product_skus_v1` | 正式产品 SKU 主数据 |
-| `external.product_catalog_wide_v1` | 一条码一行的商品目录聚合宽表，覆盖正式条码与可消费的 non-integrated ready 条码，以及产品资料、开发阶段负责人、限价、库存库位摘要、包装库存摘要和最新质检摘要 |
+| `external.product_catalog_wide_v1` | 商品目录聚合宽表，覆盖正式 SKU 与可消费的 non-integrated ready SKU，以及产品资料、限价、库存库位摘要、包装库存摘要和最新质检摘要 |
 | `external.intake_product_limits_v1` | 非集成产品限价白名单 |
 | `external.warehouse_locations_v1` | 仓库库位资料 |
 | `external.sku_warehouse_stock_v1` | 正式 SKU 库存和库位 |
@@ -233,17 +232,12 @@ CREATE SCHEMA IF NOT EXISTS external;
 只读账号授权原则：
 
 ```sql
-GRANT USAGE ON SCHEMA external TO external_core_reader;
-GRANT SELECT ON external.product_catalog_wide_v1 TO external_core_reader;
-GRANT SELECT ON external.intake_product_limits_v1 TO external_core_reader;
-GRANT SELECT ON external.warehouse_locations_v1 TO external_core_reader;
-GRANT SELECT ON external.sku_warehouse_stock_v1 TO external_core_reader;
-GRANT SELECT ON external.packaged_items_v1 TO external_core_reader;
-GRANT SELECT ON external.sku_quality_inspections_v1 TO external_core_reader;
+GRANT USAGE ON SCHEMA external TO external_reader;
+GRANT SELECT ON ALL TABLES IN SCHEMA external TO external_reader;
+ALTER DEFAULT PRIVILEGES IN SCHEMA external
+GRANT SELECT ON TABLES TO external_reader;
 ```
 
-不要给外部账号使用 `SELECT ON ALL TABLES IN SCHEMA external` 这类全量授权；新增外部视图必须单独评审后追加白名单。
-
 禁止：
 
 - 给外部账号授权 `public` schema 全表读取。

furniture-3d-system/docs/架构设计/数据库混乱点治理台账.md

@@ -160,7 +160,6 @@
 - 代码巡检已增加“未归类本地存储”硬护栏：非测试源码里的 `localStorage/sessionStorage` 直接读写和 `createJSONStorage` 封装持久化用途必须被归类为主数据风险、兼容缓存、旧缓存，或明确列入非主数据 UI/登录态缓存；未归类时命令失败，避免新的本地主数据真相源漏进系统。
 - 代码巡检已增加“应用层本地 JSON 文件主数据源”硬护栏：`src` 下不得用同步或异步 `readFile/writeFile`、`require/import` 读写或导入本地 `.json` 文件作为产品、资料库、权限或外部同步真相；导入载荷、迁移计划、备份和测试夹具必须留在明确的工具/测试边界内。
 - 代码巡检已增加非集成产品 `payload` 查询护栏：开发类型、负责人、待办和列表筛选不得直接把 `payload` JSON 当作并列真相源；历史兜底必须通过 `payloadJsonWhenProfileMissing(...)` 明确绑定到 profile 缺失场景。
-- 非集成产品定厂字段已结构化到 `IntakeNonIntegratedSkuItem`：供应商、供应商编码、工厂仓库、发货方式、最低起订量、含税单价、交期和安装方式均以 SKU 明细列为真相；`payload.factoryRows` 只保留迁移兼容快照和流程型字段，运行时回显与 `external.product_catalog_wide_v1` 不得再从该 JSON 兜底取定厂字段。`factoryWarehouse` 表示供应商发货仓，不得和库存仓位 `warehouse_location_name` 混用。
 - 代码巡检已增加关键地基表写入边界护栏：`src/app` 下的 Route/Page 不得直接写 `SystemConfig / ProviderConfig / ThemeConfig / IntakeNodePermissionOverride / AssistedAssemblyAiRender / Feedback / ActivityLog`，必须进入 service/repository 的规范化写入口；回收站产品/SKU 日志写入已改走统一 `logActivity`。
 - 代码巡检已继续扩展到核心主数据写入边界：`src/app` 下的 Route/Page 不得直接写 `Product / ProductSKU / ProductSkuAssetProfile / DraftGroup / PreSku / PreSkuBasicInfo / AssetFamily / AssetVariant / IntakeNonIntegratedProduct / IntakeNonIntegratedProductProfile / IntakeNonIntegratedSkuItem / ProductPatentRecord / SpuNumberCounter / IntakeReferenceLibraryItem`，防止页面接口绕开服务层的编码规范化、快照同步、质量状态和冲突检测；`src/server` 写入口会同时识别 Prisma client 别名和 relation 嵌套写入，子模型结构化副本不能藏在父模型 `create/update` 里绕过分类；资料库条目身份也禁止恢复 `id` 兜底 `itemKey`、直接 `itemKey: item.id`、`code || item.id` 或 `` `item:${item.id}` `` 的写法，有稳定编码的资料库必须用 `code` 作为条目身份，缺显式编码的资料库必须使用业务规格派生的稳定 key，避免浏览器临时 id 或数据库主键变成业务身份；草稿组编号禁止恢复纯 `Date.now()` 生成，服务层必须使用可读前缀和足够熵，数据库唯一索引只做最后兜底。
 - 文件系统输入也纳入代码巡检：`filesystem-master-data-source` 会识别读取 `public/uploads`、上传临时文件、ZIP 解包目录等文件来源后又写 `Product / ProductSKU / Panel / ProductHardware / Hardware` 的组合。只有登记过的旧上传/导入入口可保留，新增未登记入口会阻断，防止把素材目录或本地文件扫描当成第二主数据源。

furniture-3d-system/docs/架构设计/清货管理-20261020.md

@@ -1,207 +0,0 @@
-# 清货管理（2026-10-20）
-
-## 1. 页面与入口
-
-- 页面：`/supply-chain/management/clearance`
-- 菜单：供应链中心 > 经营管理 > 清货管理
-- 五个页签：清货池、清货任务、清货分数、清货复盘、清货配置
-
-## 2. 数据与边界
-
-页面和接口只读取本地 PostgreSQL 快照/业务表，不实时访问 SQL Server。
-
-| 数据 | 本地表 | 说明 |
-| --- | --- | --- |
-| 清货池 | `SupplyChainClearancePoolSnapshot` | 产品全量档案的月度快照；包含 `periodKey`、`generatedAt`；只有经管重新生成时才会更新 |
-| 清货池生成记录 | `SupplyChainClearancePoolGeneration` | 每个清货月份只有一条经管生成记录，保存生成时间、生成人和商品数 |
-| 清货任务 | `SupplyChainClearanceTask` | 按完整月份保存任务量、折扣、原因、审核状态；同月调整记录独立保留 |
-| 流转记录 | `SupplyChainClearanceTaskEvent` | 提交、通过、驳回、调整、运营确认移除 |
-| 复盘快照 | `SupplyChainClearanceReviewSnapshot` | 月度整体/运营中心/部门负责人/优先级/折扣维度 |
-| 销售出库进度 | `SupplyChainProductArchiveSalesPerformanceDaily` | 按条码汇总清货月份内 `shipQty`；页面对已确认任务实时覆盖进度，脚本持久化到任务 `clearedQty` |
-| 时间窗口 | `SupplyChainClearanceApplicationWindow` | 每个清货月份包含次月任务制定窗口和次月折扣调整窗口；清货周期始终为一个完整自然月 |
-| 清货池库存 | 聚水潭库存、PLM 清货表 | 经管生成时实时读取源表，计算结果落到清货池月度快照；页面不直接查询源表 |
-
-清货池月度生成：
-
-- 只有 `clearanceReview.edit` 权限的经管可以在「清货配置 > 时间窗口」中同时选择是否生成清货池。
-- 清货池页面标题说明会读取当前月份的生成记录，展示生成时间、生成人和生成方式；未通过配置生成或没有生成记录时不追加该说明。
-- 经管选择 `YYYY-MM` 清货月份后，系统按当前产品全量档案补充商品资料，并从聚水潭库存和 PLM 清货表重新计算库存。
-- 简尚总库存 = 大货仓实体库存 + 前置仓库存 + 专用仓库存；库存直接读取上游最新视图 `JianSun_Old.JianSun.dbo.jst_inventoryInfo_view`，四类仓库统一使用公有可用数 `qty - order_lock`。大货、前置、专用仓保留负数参与汇总，例如缺货仓的负库存会冲减大货仓；代发仓负数按 0。
-  - 大货仓：仓库类型为 `成品专用仓-真实库存` 或 `成品发货仓-真实库存`，剔除新外贸仓、张小飞代发仓、济南外贸仓、南昌樵舍仓和 `简尚-运营` 开头的专用仓。
-  - 前置仓：仓库名称包含 `南昌樵舍仓`。
-  - 专用仓：仓库名称以 `简尚-运营` 开头。
-  - 代发仓：仓库类型为 `成品代发仓-虚拟库存`，负数按 0，且结果小于 `77777`。
-- 供应商剩余库存读取 `rpt.plm_productDiscontinuation.remainingStock`，同一商品取 `state=2/3` 中 `updateTime, Id` 最新的一条。
-- 工厂总库存 = 供应商剩余库存 + 代发仓；已移除贴单发货仓。
-- 简尚 + 工厂总库存 = 简尚总库存 + 工厂总库存；清货池只写入和展示总库存大于 0 的商品。
-- 两清协议匹配最新 `rpt.ope_clear_pool` 中状态为停产、退市的商品编码；再检查该编码在 `rpt.plm_productDiscontinuation` 是否存在任意状态记录。命中两清协议但 PLM 完全无记录时显示「工厂库存未统计」，其他情况留空；销售商品不触发该标记。
-- 清货池「日销」列固定取产品全量档案的 `sales7d`（7 日销），不取采购日销 `dailySales`。
-- 清货池「停产时间」按商品编码关联 `rpt.plm_productDiscontinuationDetail_flow` 与 `rpt.plm_productDiscontinuation_flow`：仅取已完成的停产流程（`flowtype=14`、`flowStatus=1`）、有效停产明细（`prostatus=1`、`state=0`），以最新流程的 `applyTime` 填入年月日；销售状态为「销售」的商品无论是否存在历史停产流程都清空停产时间。
-- 清货池「利润中心」按产品档案的运营负责人 `opsHead`，在人员信息表 `SupplyChainManagementOwnerConfig.operationOwner` 中精确匹配后取 `profitCenter`；未匹配时留空。
-- 清货组合匹配只处理产品全量档案的单双包字段原本为「双包」或「三包」且有库存的商品；「非双包」和空值即使出现在组合明细中，也不改写包型，清货商品编码直接填当前商品编码。
-- 组合读取启用的 `jst_comboProductInfo` 和 `jst_comboProductItem`，并严格按档案包型匹配：双包只取 2 个不同商品编码的组合，三包只取 3 个不同商品编码的组合；1 个、4 个及以上或其他包型组合不参与。
-- 同一商品编码命中多个组合时只选择一个，且组合编码必须以 `ZH-` 开头并直接包含当前商品编码；`运营组合套装xxx`、`MKH-运营组合套装xxx` 等无法从编码识别组成的组合不使用。具体组合中优先选择所有组成商品数量均为 1 的组合，其次选择总数量更小、存在 A/B 对应件、无异常且编码稳定的组合。例如同时存在 `ZH-...A-2-...B-2` 和 `ZH-...A-1-...B-1` 时，必须选择后者。
-- 原有单商品明细行不新增、不拆分，`清货商品编码` 只填写选中的完整具体组合编码；不是 `ZH-` 开头或找不到具体组合时，填当前商品编码。
-- 对选中的组合递归检查组成商品：任一组件状态为停产或退市且总库存小于等于 0 时，组合状态标记「多包异常」，并记录首个异常原因；同月二次折扣调整不清空或重算这些组合字段。
-- 组合清货总量取所有组成商品「简尚+工厂总库存」的最小值；非组合商品取自身简尚+工厂总库存。组合所有组成商品的简尚库存都大于 0 但数值不一致时标记「多包库存不等」。
-- 可用天数按 `清货总量 / 日销` 向下取整；日销为 0 时显示「无销量」，日销为空时留空。
-- 清货池页面和导出中的日销最多保留两位小数；整数不补小数位，可用天数仍使用原始日销精度计算。
-- 「多包异常」商品禁止填写任务、申请折扣、推送草稿或由经管调整后通过；「多包库存不等」允许填写任务和申请折扣，但任务量上限仍使用组合最小清货总量。
-- 常规生成完成后，向钉钉个人通知发送一条汇总提醒，只说明「多包异常」和「多包库存不等」已生成及各自数量，不推送商品编码或组合明细；收件人从在职员工目录按姓名匹配，默认「卷帘大将」，可通过 `SUPPLY_CHAIN_CLEARANCE_COMBO_NOTIFICATION_RECIPIENT` 调整。二次折扣调整不重新打标，也不重复发送该通知。
-- 同一清货月份允许经管不限次数重新生成；再次生成时事务内覆盖该月生成记录和商品快照，未再次生成时数据保持不变。
-- 生成方式分为「常规生成」和「二次折扣调整」。常规生成重算完整商品池；二次折扣调整必须基于已生成月份，只更新现有商品的大货仓、前置仓、专用仓、代发仓、供应商剩余库存、简尚库存、工厂库存、总库存、日销（7 日销）和可用天数，商品集合、状态、负责人、利润中心、两清协议及其他字段保持不变。
-- 「清货配置」是紧邻「清货复盘」的独立页面，不再以清货池工具栏弹窗展示，且仅对具备 `clearanceReview.edit` 权限的经管显示；页面包含「时间窗口」「优先级规则」「固定任务规则」「折扣限制」四个子页签。优先级和固定任务规则由经管人工维护并持久化到 `SupplyChainClearanceConfig`，每条规则填写目标值、多个条件以及条件关系（同时满足 `ALL` / 满足任一 `ANY`）；条件关系通过点击条件之间的「且 / 或」切换。同一商品命中多条规则时采用序号最小的一条。
-- 「折扣限制」按商品编码或 SPU 人工维护禁止申请折扣清单，匹配不区分大小写，重复配置自动合并；命中后清货池折扣输入禁用，保存草稿、提交、审核、申请人确认及经管强制推送都会在服务端再次校验，不能通过接口绕过。
-- 优先级字段是人工自定义的优先级名称，不使用固定的高/中/低字典；规则值和兜底值都由经管自由命名。
-- 优先级规则可判断销售状态、商品状态、分类、品牌、供应商、单双包、合作状态、负责人、商品编码、货号、各类库存、日销、可用天数、成本价、清货商品编码、清货总量、多包标记、利润中心、两清协议、停产时间和入库天数；支持等于、不等于、包含、不包含、数值比较以及为空/不为空。
-- 有预设值的文本字段支持勾选多个值；等于和包含在任一选中值命中时成立，不等于和不包含在避开全部选中值时成立。数字字段及自由文本字段保持单值输入。
-- 优先级规则只在常规生成清货池时计算并写入 `extra.priority`，同时保留命中的规则 ID 和序号；二次折扣调整不重算优先级。未命中任何规则时优先级留空。
-- 固定任务规则使用安全算术公式，可引用简尚库存、工厂库存、总库存、日销、可用天数、清货总量、成本价、入库天数等数值字段，支持数字、括号和加减乘除；只解析受控字段和运算符，不执行任意代码。公式结果向下取整，字段无数值或计算无效时固定任务量留空。
-- 优先级和固定任务配置都支持选填兜底值：当所有规则均未命中时，使用人工填写的兜底优先级或兜底公式；留空时保持为空。
-- 常规生成清货池时把首个命中公式的结果写入 `extra.fixedTaskQty`，同时保留公式、规则 ID 和序号；二次折扣调整不重算。
-- 页面可通过「清货月份」切换已经生成的月度清货池。
-
-历史导入和诊断脚本：
-
-- 当前全量映射：`npm run import:clearance-pool-archive`
-  - 把产品全量档案全部行写入清货池，销售状态取 `productStatus`；
-  - 《10月清货池》38 个业务抬头覆盖到对应字段，其余抬头保存在 `extra` JSONB；
-  - 商品名称和品牌作为商品档案列保留，可在列设置中显示；
-  - 已有快照中的库存值优先保留，其余使用档案库存字段。
-- 停产/退市手工诊断同步：`npm run sync:clearance-pool:discontinued`。该命令会重写指定日期的清货池快照，只用于单独核对，不纳入清货池库存刷新流程。
-  - 使用 `rpt.jst_sku` 的实时停产/退市状态；
-  - 简尚库存取 `jst_inventoryInfo_view`，按现有规则排除专用仓并扣减虚拟云仓库存；
-  - 工厂库存取 `plm_productDiscontinuation` 中同一商品编码最新创建记录的 `remainingStock`；
-  - 只写入总库存 > 0 的款式。
-- 本机导入（已有合并表时）：`npm run import:clearance-pool -- --file=<csv> --date=YYYY-MM-DD`
-- 复盘快照导入：`npm run import:clearance-review`
-- 「清货配置 > 时间窗口」默认选中当前正在查看的清货月份，并提供「不生成」「常规生成或重新生成」「二次折扣调整生成」三个选项。
-- 当前正式生成只保留产品全量档案字段，以及重新计算的库存、7 日销、可用天数、利润中心和两清协议；清货商品编码、清货批次、优先级、固定任务量等清货专有字段继续留空，等待后续逻辑接入。
-- 档案基线重建：`npm run reset:clearance-pool:archive -- --date=YYYY-MM-DD --apply`；只更新现有快照字段，不新增或删除商品。
-- 已处理库存实验命令 `sync:clearance-stock:stock-monitor` 当前暂停，不作为清货池正式库存来源。
-
-## 3. 任务流转
-
-清货任务默认列按经管提供抬头展示：统计月、spu、清货商品编码、清货价、成本价、折扣预警、价格类型、运营负责人、部门负责人、利润中心、期初任务量、真实任务量、发货数量、任务清货进度、退款数量、简尚库存、工厂库存、总库存、日销、可用天数、全国运费、清货批次、优先级。任务页只展示经管已推送的 `APPROVED` 明细，因此不再展示任务审核状态；统计月固定为第一列。
-
-任务计算口径：
-
-- 清货商品编码映射当前任务月份清货池的 `extra.clearanceCode`。
-- 成本价取产品全量档案 `costPrice`；如果清货商品编码是组合款，则递归汇总组合明细中所有组成商品的产品档案成本，并按组成数量计算。
-- 清货价 = 成本价 × 申请折扣；折扣为空时直接展示成本价。
-- 折扣预警仅在存在折扣时计算：任务清货进度小于 50% 标记「异常」，大于等于 50% 标记「正常」。
-- 期初任务量取同一申请人该条任务最早一次草稿/提交记录中的任务量，不随审核调整覆盖。
-- 任务清货进度 = 发货数量 / 真实任务量。
-- 简尚库存、工厂库存、7 日销取每日更新的产品全量档案；总库存 = 简尚库存 + 工厂库存；可用天数 = 总库存 / 7 日销并向下取整，日销为 0 时显示「无销量」。
-- 运营负责人、部门负责人、利润中心、清货批次和优先级映射当月清货池数据；发货数量和退款数量来自销售出库日数据；清货价、价格类型和全国运费在接入各自数据源前按上述规则展示或保持为空。
-
-- 运营在清货池填写并保存任务申请，可以查看清货池全部商品；只有清货经管可以审核申请，审核权限走 `clearanceReview.edit`。申请人确认和正式任务推送分别校验操作/审核权限。
-- 同一商品、同一期次允许不同运营分别保存自己的任务申请；草稿按申请人隔离，互不覆盖。经管可查看该编码下全部申请；普通运营只能读取和看到本人申请、审核结果，不能看到其他人的申请内容、审核状态或状态计数。
-- 审核状态流转为 `DRAFT/PENDING 待审核` → `READY 已审核` → `APPROVED 已确认`。经管审核通过后，申请人只看到自己的“已审核”结果；点击“确认无误”后自动写入清货任务明细并切换到清货任务页，无需经管再次推送。未确认的 `READY` 申请仅经管有权限强制推送。任务仍按申请人拆分，`spu负责人` 显示实际申请人。
-- 清货任务页只做数据展示，不承载审核或调整操作。
-- 清货池展示任务流程和「全部任务 / 待审核 / 已通过 / 按调整后通过 / 已驳回」审核结果快捷按钮；经管看到全部申请统计，普通运营仅看到本人申请统计。点击后筛选清货池明细，导出时沿用同一结果。清货任务页不展示利润中心汇总、状态分段按钮、重复搜索框或记录类型切换；任务周期、筛选项、刷新、导出和列设置合并为同一行。任务明细每页 50 条，表格下方使用紧凑分页控件展示总条数、本页条数和上一页/下一页。没有任务时仍保留完整表头，只在表体显示原有空态提示。
-- 清货池任务流程和状态概览并入清货月份栏：任务流程压缩为单行步骤条，销售、退市、停产各自展示编码数量、简尚库存和总库存，长期滞销库存当前显示待配置；窄屏时状态卡片自动换行。指标按整个生成月份汇总，不随筛选条件变化，宽屏展示状态卡片后为筛选和明细释放纵向空间。
-- 清货池明细最右侧为“审核结果”列。待审核、已通过、按调整后通过、已驳回分别标识；已驳回结果附带驳回原因。经管可点击结果查看申请详情；申请人端仅显示本人结果，并在审核通过时突出显示“确认审核结果”。申请人确认后自动跳转清货任务页；强制推送和自动确认都会刷新清货池、审核计数与任务明细。
-- 审核弹窗顶部展示商品编码、清货商品编码、SPU、运营负责人、部门负责人、利润中心、清货批次、商品状态、优先级、简尚/工厂/总库存、清货总量、7 日销、可用天数、停产时间和入库天数，并展示同商品编码最近月份的任务量、折扣、完成量和完成率。每条申请可“通过原申请”“调整后通过”或“驳回”；调整后通过必须修改任务量或折扣，调整原因选填，驳回必须填写驳回原因。待审核弹窗不提供强制推送。
-- 经管强制推送只处理 `READY`（已审核未确认）记录，入口保留在清货池明细下方，一次推送当前月份和任务期次的全部未确认记录；申请人已确认的记录会自动进入清货任务，不在强制推送范围内。
-
-```text
-经管选择清货月份并确认次月任务制定、次月折扣调整时间（起止时间）
-  -> 只有在对应时间窗口内，运营才能填写任务量 + 折扣 + 原因
-  -> 三个字段完整后离开输入框自动保存为 DRAFT 草稿
-  -> DRAFT / PENDING 待审核
-  -> 经管审核通过 -> READY 已审核
-  -> 申请本人确认无误 -> APPROVED 已确认，自动进入清货任务
-  -> 或由经管强制推送未确认的 READY 申请 -> APPROVED 已确认
-  -> 经管驳回 -> REJECTED（必须填写原因，仅原申请人可见）
-       -> 运营确认移除：REMOVED
-       -> 经管调整任务量/折扣后重新审核
-```
-
-同一月份、同一商品、同一种记录类型只允许一条非 REMOVED 任务。调整窗口开放后，即使已有月初确认任务，也可以为同款创建独立的调整记录，初始任务不覆盖、不删除。
-
-分数和复盘按商品去重：同一商品存在初始任务和调整记录时，只取最新一期已确认记录参与任务量、完成量和维度汇总，历史记录继续保留用于追溯。
-
-销售状态商品不允许申请折扣：清货池折扣和折扣原因都固定为空，只允许填写任务量；草稿保存、批量推送、经管调整接口均强制校验，不能通过接口绕过。
-
-非销售状态商品申请折扣时必须先填写任务量，填写折扣时必须填写原因；没有折扣需求时折扣留空即可，可以只填写任务量。
-
-草稿单元格在输入过程中只更新本地引用，失焦时立即提交保存，避免逐字重绘整张 50 行明细；保存接口并行校验时间窗口和库存快照，并并行查询本人草稿及有效任务。折扣输入保留 200ms 防抖，保存期间继续修改会在首次保存完成后自动补存最新内容。
-
-时间窗口规则：
-
-- 只有 `clearanceReview.edit` 可以配置和确认时间窗口（「清货配置」页签只对经管显示）；选择生成时，窗口保存成功后再执行清货池生成。
-- 未配置、未开始或已结束时，清货池进入只读，运营不能保存草稿，经管不能推送正式任务；后端会强制校验。经管审核和申请人确认审核结果不受该限制。
-- 清货月份始终是完整自然月，任务和后续折扣调整都归属该清货月份。
-- 次月任务制定：目标清货月前一个月的最后 7 天。
-- 次月折扣调整：目标清货月第 8 天起的第一个工作日，自动跳过周末；法定节假日可由经管人工调整。
-- 「清货配置」页面会按上述规则自动填入建议时间，经管可修改后确认。
-
-执行进度：
-
-- 清货任务页实时读取本地销售出库日数据，口径为清货月份内 `shipQty` 合计，仅对 `APPROVED` 任务生效。
-- 每日销售出库同步完成后会自动回写上月和当月任务进度；也可单独执行 `npm run sync:clearance-progress -- --period=YYYY-MM`，不传月份时同步当月。
-- 回写内容为 `clearedQty`、`lastProgressAt`；销售源未覆盖目标月份时不覆盖上次进度。
-- 本地销售出库数据未覆盖目标月份时保留上次持久化进度，页面会显示覆盖到哪一天。
-
-草稿接口：
-
-- `POST /api/supply-chain/clearance/tasks/draft`：表内自动保存（同一商品同一记录类型重复保存会更新同一条草稿）。
-- `POST /api/supply-chain/clearance/tasks/push`：把勾选的 DRAFT 批量转为 PENDING，并写 SUBMIT 流转记录。
-- `GET/POST /api/supply-chain/clearance/window`：读取指定清货月份的次月任务制定/折扣调整时间；经管保存起止时间并确认。
-- `POST /api/supply-chain/clearance/tasks/:id/review`：直接通过或驳回。
-- `POST /api/supply-chain/clearance/tasks/:id/approve-adjust`：待审批任务调整任务量/折扣后通过。
-- `POST /api/supply-chain/clearance/tasks/:id/adjust`：经管调整已驳回任务后确认。
-- `POST /api/supply-chain/clearance/generate`：经管常规生成或重新生成清货池；二次折扣调整模式仅刷新库存、日销和可用天数。
-
-## 4. 三张明细表的通用能力
-
-清货池、清货任务、清货分数均支持：
-
-1. 右上角齿轮「显示设置」：与限价管理一致，统一提供紧凑展示、列设置、筛选设置三个入口。
-2. 个人列设置：搜索、勾选要显示的字段，上下移动字段顺序；列宽直接在明细表头右侧拖动手柄调整，松手后按用户保存到浏览器本地。
-3. 顶部筛选：在「显示设置 → 筛选设置」中选择要展示的筛选项后，字段以横向下拉框显示；候选值可搜索并直接点击多选，也可粘贴或输入空格、逗号、分号、顿号、换行分隔的批量值后回车应用。点击或批量输入均使用精确等于匹配，避免选择「双包」时误包含「非双包」。同一字段多值按 OR 组合，不同字段按 AND 组合，并以标签展示已选条件、逐项清除或清空全部。清货池筛选在服务端执行，覆盖普通字段、日期、数值和 `extra` JSONB 抬头；任务量、折扣、原因按当前清货月份的动态任务数据筛选，任意人工配置字段的候选值通过 `GET /api/supply-chain/clearance/options` 加载。
-4. 导出 Excel：清货池提供「导出明细」和「导出明细（含图片）」两个入口，统一放在筛选行右侧。普通明细移除图片列并生成 `清货池-明细` 文件；含图片导出会强制加入图片列、抓取商品图片，并生成 `清货池-含图片` 文件。两者都按当前列顺序、列宽和筛选结果导出，并按每页 5,000 条自动循环读取全部匹配记录，不再截断为首页。
-5. 横向滚动：明细底部固定显示可拖动的横向滚动条，位于分页操作区上方；同时保留触控板横向滚动。
-
-清货池默认展示《10月清货池》38 个抬头，任务量、折扣、原因、任务状态固定放在列顺序末尾；销售状态单独作为业务字段展示。
-清货池顶部不再重复提供商品搜索框，统一通过下方人工配置筛选项查询。
-
-## 5. 权限
-
-页面可见：`businessManagement.view`
-
-| 动作 | 权限节点 |
-| --- | --- |
-| 清货池定任务、提交折扣申请、运营确认移除 | `clearanceOperation.edit` |
-| 经管通过、驳回、调整任务 | `clearanceReview.edit` |
-| 经管生成或重新生成清货池 | `clearanceReview.edit` |
-| 查看清货池、任务、分数、复盘 | `businessManagement.view` |
-
-默认角色：
-
-- `operation` 角色默认获得清货运营操作权限；
-- `management` 角色默认获得清货经管审核权限；
-- 管理员默认拥有全部权限。
-
-## 6. 当前版本边界
-
-- 清货任务的 `clearedQty` 已接入本地销售出库汇总；页面实时展示，持久化由 `sync:clearance-progress` 完成，生产定时任务仍需按部署环境配置。
-- 所有旧导入、重置和库存同步脚本仍会拒绝直接修改已生成月份；更新必须通过经管「清货配置 > 时间窗口」中的生成选项执行。
-- 清货分数先使用示例权重：完成度 60 + 毛利率 25 + 货值回收 15；历史周期使用复盘快照计算，当月任务只有完成度可计算。
-- 清货复盘优先使用 `2026年4月清货复盘.xlsx` 导入的历史快照；没有快照的月份由最新一期已确认任务 + 本地销售出库进度自动生成。
-- 当月自动复盘暂不计算毛利率、结算毛利率和货值回收率，字段保持为空，待结算口径接入后再补齐。
-- 清货池导出单次最多 5,000 条，按当前筛选范围导出；超出时在「导出说明」中提示实际总数。
-- 本机已导入 2026-10-20 全量清货池快照（79,959 个产品，销售 51,619 / 停产 21,010 / 退市 3,548 / 未标记 3,782）。
-
-## 7. 验证命令
-
-```bash
-npm run type-check
-npm test -- src/server/services/__tests__/supply-chain-clearance.service.test.ts
-npm test -- src/server/services/__tests__/supply-chain-clearance-review.builder.test.ts
-npm test -- src/lib/clearance-filters.test.ts
-npm test -- src/lib/supply-chain-permission-settings.test.ts
-```
-
-全仓 `type-check` 当前存在与本次改动无关的历史错误（`node_modules.pnpm-mixed`、`src/hooks/usePerformance.ts` 等）；本次新增文件无 TypeScript 报错，ESLint 无 error。

furniture-3d-system/docs/架构设计/物流到货签收时长看板-订单明细快照.md

@@ -1,289 +0,0 @@
-# 物流到货签收时长看板 · 订单明细每日快照
-
-## 为什么要做
-
-看板的全部数据来自远端只读报表视图 `rpt.jst_order_express_details`（外加 `jst_qmcust_orderlist_item` 条码明细和 `SupplyChainProductArchive` 产品档案富化）。
-该视图是远端对象，一次扫描通常以分钟计，页面每次刷新、翻页、下钻、导出都要重新扫一遍，看板因此很难"高效运转"。
-
-做法：每天把看板口径的订单明细物化到本地 Postgres，看板优先读本地快照，只有快照覆盖不到时才回落实时数据源。
-
-## 数据与表
-
-### 条码/供应商/采购的匹配来源（两套互补的订单表）
-
-报表库把订单明细拆成了两套**互不重叠**的表，只看一套会漏掉近一半订单的条码：
-
-| 表 | 覆盖平台 | 规模（实测） |
-| --- | --- | --- |
-| `rpt.jst_qmcust_orderlist` / `rpt.jst_qmcust_orderlist_item` | 淘宝天猫、阿里巴巴(1688)、淘工厂、天猫供销 | 408 万 / 576 万行 |
-| `rpt.jst_Orders` / `rpt.jst_OrderItem` | 京东商城、京东厂家直送、拼多多、头条放心购(抖音)、得物、唯品会、线下、微信视频号、小红书 | 124 万 / 175 万行 |
-
-看板取条码时会**同时查两张明细表并用 `INNER_ORDER_ID`（即 `o_id`）合并**（`listItemRows`，两表按订单号各发一批查询后合并结果）。修复前只查 `jst_qmcust_orderlist_item`，导致京东/拼多多/抖音/得物/唯品会的订单条码全空；修复后新生成的快照条码匹配率为 **100%**（此前整体 52.3%）。
-
-> 注：`rpt.jst_salesOutboundInfo`（销售出库单头）可以读取，但只有 `o_id / so_id / l_id / shop_name / io_id / qty` 等出库单头字段，没有 SKU 列，不能单独提供条码。
-
-纯新增两张表（迁移 `prisma/migrations/20260928120000_add_logistics_arrival_signing_duration_snapshot`）：
-
-| 表 | 作用 |
-| --- | --- |
-| `LogisticsArrivalSigningDurationSnapshotRun` | 批次元数据：`snapshotDate`、`windowFrom`、`windowTo`、`status`(RUNNING/COMPLETED/FAILED)、`rowCount`、`message` |
-| `LogisticsArrivalSigningDurationSnapshot` | 明细行：与看板 09 订单明细一一对应，含条码/供应商/采购/`productItems` 等快照时点已固化的富化结果 |
-
-要点：
-
-- 只有 `status = COMPLETED` 的批次对读路径可见，写入中途或失败的批次不会被读到。
-- 行唯一键 `(snapshotDate, rowKey)`，`rowKey` 与下钻键一致（内部单号 + 线上订单号 + 物流单号 + 签收时间），重复执行用 `skipDuplicates` 幂等。
-- `(snapshotDate, signTime)` 有索引，按签收日期区间取数走索引。
-
-## 生成任务
-
-```bash
-# 默认：快照日期=当天（Asia/Shanghai），窗口=最近 62 天（覆盖本月与上月），保留最近 2 批
-npm run sync:logistics-arrival-signing-duration-snapshot -- \
-  --apply --confirm=sync-logistics-arrival-signing-duration-snapshot \
-  --expected-database-identity="<本地库身份>" \
-  --expected-source-database-identity="<远端报表身份>"
-```
-
-可调参数：`--snapshot-date=YYYY-MM-DD`、`--window-days`、`--chunk-days`（默认 7，按天分批抓取以控制内存）、`--batch-size`（默认 2000）、`--retention`、`--force`（当天批次已完成时强制重建）。
-
-编排逻辑在 `src/server/services/logistics-arrival-signing-duration-snapshot.service.ts`：
-
-1. 当天批次已 `COMPLETED` 且未 `--force` → 直接跳过；
-2. 标记 `RUNNING` 并清空当天旧行；
-3. 按 `chunk-days` 分片读远端并写入本地，同时记下真正抓到的最新签收时间 `dataThrough`；
-4. 全部成功才标记 `COMPLETED`（连同 `dataThrough`），随后按 `retention` 清理更早批次；任一分片失败则标记 `FAILED` 并保留错误信息，读路径会自动继续用上一批快照；
-5. 收尾关闭远端连接池（一次性任务必须关闭，否则进程挂在事件循环上）。
-
-生产定时（systemd timer，默认北京时间 03:00）：
-
-```bash
-sudo bash scripts/install-logistics-arrival-signing-duration-snapshot-timer.sh
-```
-
-首次安装会生成 `$BASE/shared/logistics-arrival-signing-duration-snapshot.env` 模板，需要填两个身份校验值（缺省为空会拒绝写入）。可用环境变量覆盖：`LOGISTICS_SNAPSHOT_CALENDAR`、`LOGISTICS_SNAPSHOT_WINDOW_DAYS`、`LOGISTICS_SNAPSHOT_RETENTION`。
-
-## 读路径规则
-
-`src/server/repositories/logistics-arrival-signing-duration.repository.ts` 的每个读方法都先判断快照是否可用：
-
-- 取最近一批 `COMPLETED` 快照；请求区间**完全落在快照的实际覆盖范围**内才读快照（否则回落实时视图，避免返回不完整结果）。覆盖上限 = `min(windowTo - 1, dataThrough 当天)`：
-  - `windowTo` 是跑批当天，当天还没签收完，所以只能信任到它前一天；
-  - 再用批次记录的 `dataThrough`（该批真实最大签收时间）兜底，避免数据源滞后时把不完整的一天当成完整。
-  - 例：一批 10-08 生成、数据只到 10-08 05:30 的快照，对 `10-01~10-08` 不再命中，看板/导出自动改用实时源，不会少算 10-08。
-- 命中快照时返回值带 `source: 'snapshot'` 与 `snapshotDate`，页面头部显示"快照数据 · 日期"；未命中为 `source: 'live'`，显示原来的"数据更新 · 时间"；
-- 快照表还没迁移或还没有任何批次时，`findLatestCompletedRun()` 返回 null（并吞掉异常），整条链路自动等价于改造前行为。
-
-因此在以下情况仍会走实时数据源（较慢，但结果正确）：请求区间超出窗口、任务当天尚未跑完或失败、本地还没生成过快照。
-
-## 指标口径（整区间精确 vs 样本）
-
-命中快照时，**整块看板都是整区间精确值**，与 2,000 条样本彻底解耦：
-
-| 看板块 | 精确口径实现 |
-| --- | --- |
-| 经营总览（6 个 KPI） | `aggregateDashboard()` 一次扫描聚合 |
-| 履约环节拆解（5 环节平均/中位/P90） | 同上，`percentile_cont` 直接给出分位数 |
-| 发货→签收时效分布 | 同上，4 个区间计数 |
-| 付款→签收 / 付款→发货 多维经营分析（01–08） | `aggregatePayToSignAnalysis()` / `aggregatePayToSendAnalysis()`，按签收日期 + 采购/供应商/条码（`jsonb_array_elements` 展开 `productItems`）+ 物流公司/发货仓/平台/店铺分组 |
-| 发货仓 / 物流公司 超时排名 | `aggregateThresholdRankings()` |
-| 09 订单明细下钻 | `listDrilldownRows()`：按维度条件下钻，**列出全量匹配订单**并给出真实总数与页数 |
-
-口径一致性由三点保证：筛选条件统一由 `snapshotFilterConditions()` 派生（Prisma 与原始 SQL 共用）；比率/取整统一走 lib 的 `buildLogisticsArrivalSigningDurationOverview`、`buildPayToSignMetrics`、`buildPayToSendMetrics`；排序统一走 `comparePayToSignGroups` / `comparePayToSendGroups` / `compareLogisticsArrivalSigningDurationThresholdRows`。每个聚合块都用"把整区间明细喂给样本路径同样函数"的方式做过逐字段比对（MATCH）。
-
-### 看板顺序与联动链路
-
-### 履约环节拆解：目标值与看板宽度
-
-### 经营总览：平均到货时长卡片与异常下钻
-
-- 签收订单后面新增 **付款→签收平均到货时长** 卡片：主值是该环节平均时长，附行给出 **本月目标**（上月平均 × 98%）与 **目标达成率**，与履约环节拆解同一套口径。
-- **缺少关键时间 / 时间异常** 两张卡片可点击：点击后用 `{ kind: 'anomaly', value: 'missing' | 'invalid' }` 条件下钻，09 订单明细列出对应订单；再点一次取消。判定口径与总览一致——缺少关键时间 = 四个时间任一为空；时间异常 = 四个时间齐全但至少一个环节时长算不出来（时间顺序异常）。
-- **自动滚动只保留给经营总览的异常卡片**（卡片上写着"点击看明细"）：点它们会把 09 订单明细滚到视口顶部（`detailBoardRef` + `scrollIntoView`，按"下钻签名"去重，不会在翻页时反复滚动）。**经营对象维度（平台/店铺/发货仓/物流/采购/供应商/商品/签收日期）的点选不再自动滚动**——那些看板是连着看的，一滚到底就没法接着看其他维度、还得手动往上拉；下钻筛选本身照常生效，09 明细就在原位置更新。
-- 为保证"卡片数字 = 点击后的明细条数"，**命中快照时经营总览始终按整区间精确统计**（`aggregateDashboard(..., includeStages=false)`，只算总览不算分位数）；超出精确上限的大区间里，只有履约环节拆解/时效分布/经营分析/超时排名退回样本，页面脚注会写明。
-
-### 经营总览视觉层次与看板工具条
-
-- 经营总览从"7 张卡一张网格"改为**两组网格**：5 张履约指标卡一排（`--sc-kpi-cols`，标准 5 / 紧凑 3 / 展开 2），2 张数据质量卡单独成排（`--sc-kpi-alert-cols`，标准 2 / 展开 1）。7 张卡在常见宽度下不再是 5+2、第二排右侧大片留白。
-- 卡片排版统一：标签 12px 用 `--sc-muted`，数值 24px 且 `font-variant-numeric: tabular-nums`，用 `margin-top: auto` 贴底、副标题保留 2 行最小高度（`min-height: 2.9em`）。同一行内标签换行不影响数值对齐，卡片等高、数字列对齐。
-- 绿色强调卡（付款→签收平均到货时长、付款→签收履约率）改为"浅绿底 + 左侧 2px 竖条"（`inset 2px 0 0`），不再整卡大面积着色；点击态的竖条与边框跟着状态色走。
-- 缺关键时间 / 时间异常改为横向"告警条"：左侧图标 + 名称/说明，数值贴右，用低饱和暖色表达"异常"语义；点击下钻、`is-active` 选中态、`aria-pressed` 与 `aria-label`（含条数）都保留。
-- 修复看板工具条（导出 / 尺寸切换）样式不生效的根因：`BoardTools` 是本文件内的**独立组件**，styled-jsx 按组件注入作用域类，主组件里的 `.sc-logistics-icon-button` / `.sc-logistics-board-tools` / `.sc-logistics-board-size-label` 规则永远匹配不到它的 DOM，四个看板右上角一直是"裸图标"。现在样式放进 `BoardTools` 自己的 `<style jsx>`（深色排名表头用 `:global(.sc-logistics-ranking-board-header)` 适配），并删除主样式块里的死规则。
-
-- 每个环节多出一列 **目标**：`本月目标 = 上月同环节平均时长 × 98%`（`LOGISTICS_ARRIVAL_SIGNING_DURATION_TARGET_IMPROVEMENT_RATIO`）。基准月取所选区间结束日期所在月的上一个月（跨年正确），基准值由 `aggregateStageAverages()` 用同一套筛选条件跑上个月区间得到；当前平均不高于目标时目标值标绿表示达标，鼠标悬停可看到"目标 = 上月平均 × 98%"的算式。
-- 目标后面还有 **目标达成率**：该环节时长不超过目标的订单占比。精确口径由 `aggregateStageTargetHits()` 按目标值统计命中订单数，样本口径由 `buildLogisticsArrivalSigningDurationStageAchievement()` 在样本上计算；无目标或无可计算订单时显示 `-`，鼠标悬停显示"命中 / 可计算"明细。环节行的平均/中位/P90/目标/达成率都只显示数值，单位（小时）只在表头语义里体现。
-- 环节行按 `128px / 弹性条 / 74 / 74 / 86 / 92` 收紧列宽，列表支持横向滚动，避免 P90、目标被截断。
-- 履约环节拆解与发货→签收时效分布之间加了**可拖动的分隔条**（`role="separator"`，支持左右方向键微调），比例默认 62% 并记在本地，可随时左右拖动调整两个看板的宽度。
-
-经营对象问题排名各看板按"上级 → 下级"顺序排列，并逐级联动：
-
-```
-01 签收日期维度 → 02 平台维度 → 03 店铺维度 → 04 发货仓维度 → 05 物流维度
-→ 06 采购维度 → 07 供应商维度 → 08 商品维度 → 09 订单明细
-```
-
-点击任意一级对象，都会保留更上级条件、丢弃更下级条件，并把这条链路作为筛选条件重新取数：
-
-- 整区间口径：链路以 `cascade`（JSON 数组，`LogisticsArrivalSigningDurationDrilldownFilter[]`）随 dashboard 请求下发，服务端在 `aggregatePayToSignAnalysis` / `aggregatePayToSendAnalysis` / `aggregateThresholdRankings` 的 WHERE 上追加 `cascadeSqlWhere`，因此下级看板与 09 明细都只展示对应数据；
-- 样本口径（实时源或超出精确上限）：前端用 `logisticsArrivalSigningDurationRowMatchesCascade` 收窄样本后重算；
-- 店铺维度分组键是"平台 + 店铺"，因此平台级联动能精确到该平台下的店铺；
-- 联动刷新是原位刷新（只有页面筛选变化才显示整块加载态），排名看板标题会显示当前链路与"联动加载中…"提示；
-- 经营总览、履约环节拆解、时效分布属于页级口径，不随联动链路变化。
-
-### 经营对象的目标与目标达成率
-
-02–08 经营对象表（平台 / 店铺 / 发货仓 / 物流 / 采购 / 供应商 / 商品）在原有指标后面追加 **目标** 与 **目标达成率** 两列；01 签收日期维度的「指标 × 日期」矩阵与总计不追加（按日算"上月同日目标"没有业务含义）。
-
-- **目标 = 该对象上月同环节平均时长 × 98%**，达成率 = `100% − (平均 − 目标) / 目标 × 100%`，与履约环节拆解同一套口径，只是精确到每个经营对象——所以每个对象的目标值不同（例如 08 月各采购平均不同，9 月目标 52.7 / 56.5 / 60.5 …），达成的判断是"相对自己上个月是否改善 2%"。
-- 数值口径与展示一致：平均、目标都按 1 位小数取值后再算达成率，便于和表里看到的数字对账；没有上月基线的对象（新采购、新店铺、当月新条码）显示 `-`。
-- 取数：`aggregateObjectBaselines()`（快照仓库）在上月区间一次扫描算出 7 个维度 × 付款→签收 / 付款→发货 两个环节的平均时长，随 dashboard 载荷以 `objectBaselines` 下发；前端用 `withObjectAnalysisTargets()` 按分组键（`JSON.stringify(keyParts)`，与样本路径同一套键）合并，样本口径与整区间口径共用。
-- 这条聚合约 2–4 秒，因此按「快照日期 + 基准月 + 关键词/排除词」在服务端缓存 10 分钟（这些平均值只在每日快照重建时变化），并与看板其余查询并行执行；查询失败只让这两列显示 `-`，不会把整块看板拖回实时源。
-- 「经营对象问题排名」导出的 CSV 同步带上这两列。
-
-### 看板分页
-
-> 页面顶部的「经营管理 / 物流时效 + 看板标题 + 物流签收明细口径 + 明细条数/更新时间」页头已去掉（用户口径：无需展示，标签页标题已经说明是哪个看板）；快照/缓存状态在数据源异常时的黄色提示条里仍会给出。
-
-### 批量关键词查询
-
-筛选区的「关键词」支持批量输入（与排除关键词同一套拆分规则）：
-
-- 按中文逗号 `，`、英文逗号 `,`、换行拆分，自动去空、去重，最多 100 个、单个最长 120 字符（原始输入上限 4000 字符）；
-- **多个关键词之间是"或"**：命中任一字段即算匹配。整区间（快照）口径覆盖：内部单号、线上订单号、物流单号、物流公司、店铺、平台、发货仓、收货地址，以及快照时点固化的**条码、商品名称、供应商、采购**（`KEYWORD_FIELDS`）——所以能直接按采购/供应商/条码检索；
-- 走实时源时（区间超出快照窗口）只覆盖前 8 个报表字段，条码/采购/供应商这三类需要本地快照支持，这是两套口径的已知差异；
-- 解析规则由 `splitSearchKeywords()` 统一提供，服务端缓存键按关键词集合（排序后）计算，输入顺序不同不会重复缓存。
-- 输入框与其它筛选控件**等高**（34px 单行高度，多行时框内滚动），"已识别 N 个关键词"显示在标签行右侧并在空间不足时省略，不再把这一格撑成两行高。
-
-筛选区的三个按钮各管一件事，点下去**立即按新条件查询**（互不重复）：
-
-| 按钮 | 签收日期 | 关键词 | 排除关键词 | 结果 |
-| --- | --- | --- | --- | --- |
-| **重置** | 清空（输入框留空） | 清空 | 清空 | 没有任何筛选条件；空日期由服务端兜底为本月 1 号~昨日（`dateRangeCleared` 让输入框保持空白，不被兜底值回填） |
-| **恢复默认** | 回到本月 1 号~昨日（显式填回输入框） | 保留 | 恢复系统默认配置（全部勾选） | 默认口径 |
-| **清空排除** | 回到本月 1 号~昨日（显式填回输入框） | 保留 | 置空 | 默认区间 + 不排除任何关键词 |
-
-三者过去都只是"改输入、等用户点查询"（重置只清日期与关键词、另两个只改排除词），结果看起来一样容易混；现在各自的语义、界面状态与结果都区分开了，按钮 hover 有对应说明，筛选栏底部也有一行图例。空日期提交时服务端仍按默认区间查询（跨天且当日快照未生成时可能落实时源，较慢但结果正确）。
-
-**默认签收日期区间是「本月 1 号 ~ 昨日」**（由 `normalizeLogisticsArrivalSigningDurationFilters()` 生成）：当日签收数据仍在滚动，且每日快照只覆盖到昨日，用"到昨日"作默认值可以让首屏直接命中快照（整区间精确 + 秒级），不再因为区间含当天而回落到实时源。每月 1 号时会自动退化为"昨日当天"（本月 1 号还没到昨日）。
-
-筛选控件（签收日期、关键词输入框，以及排除关键词选择器的摘要）都是**受控并与服务端下发的筛选条件同步**：从菜单重新进入（无参数 URL）、重置后查询、浏览器前进/后退时，控件会刷成当前真正生效的条件。这一点很重要——否则会出现"数据已经是默认区间，输入框还停在上次条件"的错觉。
-
-### 排除关键词选择器
-
-筛选区的「排除关键词」是**按字段分组**的勾选式选择器（`ExcludeKeywordPicker.tsx`）。关键词只能配置在它要匹配的那个字段上，**不跨字段混用**——这是这一版最重要的口径修正。
-
-**字段与匹配规则**
-
-| 字段（配置分组） | 数据列 | 匹配方式 |
-| --- | --- | --- |
-| 发货仓 | `warehouseName` | 该字段值包含关键词（不区分大小写），命中即排除 |
-| 物流公司 | `logisticCompanyName` | 同上 |
-| 订单标签 | `orderLabels`（JSON 数组文本） | 同上 |
-| 买家留言 | `buyerMessage` | 同上 |
-| 卖家备注 | `remark` | 同上 |
-
-配置与筛选都以「字段 → 关键词」存储（`LogisticsArrivalSigningDurationExcludeKeywords`）。SQL 侧对每个关键词只生成一条 `NOT (该字段 ILIKE '%词%')`；旧版"命中 5 个字段里任意一个就排除"的口径已废弃——那正是「物流」会连带命中订单标签里的 `商家指定物流`、`物流探查` 和买家留言里"物流单号"的根因。
-
-**选择器交互**
-
-- **按字段分组**：发货仓 / 物流公司 / 订单标签 / 买家留言 / 卖家备注，每组标题显示"共 N 项 · 已勾选 M 项"，右侧索引条按字段跳转（字段没有候选词时不显示该组）；
-- **默认全选**：候选词 = 该字段的默认排除词 ∪ 当前已排除词（旧链接里带的自定义词不会丢），进入看板时全部处于"排除"状态；取消勾选 = 本次不排除该项，确定后立即以当前表单条件重新查询（`requestSubmit()` 在受控值落到 DOM 后再触发）；一个都不勾时以 `excludeKeywordsMode=clear` 提交，避免回落到默认排除词；
-- 选择器内含：搜索、`全部 / 已选项(n)` 页签、`全选 / 反选 / 清空`（作用于当前可见列表，全选带半选态）、`紧凑模式`（四列更密）；
-- **新增候选词仅系统管理员可操作**：底部先选字段、再输入关键词（回车或点「添加」），新词并入**该字段**的默认排除词并立即落库（`PUT …/settings`，服务端 `assertCanManage` 同样校验管理员身份），提示"已保存到「物流公司」默认排除关键词：…"；非管理员只看到"需要新增请联系系统管理员"；
-- 页面原先独立的「默认排除关键词」设置卡片已删除，维护入口统一收敛到选择器；`清空排除`（不排除任何词）与 `恢复默认`（回到全部默认排除词）两个按钮保留，只改输入、点查询生效。
-
-**编码与兼容**
-
-- 筛选栏摘要按字段给数量（如"已排除 14 项：发货仓 3 · 物流公司 5 · 订单标签 2 · 买家留言 2 · 卖家备注 2"），URL 用 `excludeKeywords=字段:词,词;字段:词` 的紧凑写法；
-- **老链接的平铺写法按当前配置归位**：`excludeKeywords=词1,词2` 会被逐个对应到配置里它所属的字段（大小写不敏感，`bbff` 会归一到配置里的 `BBFF`），配置里已经没有的词说明它没有字段、直接忽略——**不会再把一个词摊到 5 个字段上**（那会让选择器每组都列出全部关键词）。只有当配置为空、任何词都对应不上时才退回旧口径，避免老链接突然变成"不排除任何词"。
-- 历史配置（数组）在 `normalizeExcludeKeywords()` 里仍按旧口径挂到全部 5 个字段（那是当年真实的匹配语义）；但配置一旦以新结构保存，后续解析都会走"按字段归位"。
-
-**当前初设配置**（2026-09-30 落库）：发货仓=`自动发货仓 / 常州简尚家居有限公司 / 京东云仓`；物流公司=`京喜 / 物流 / 安能 / 自提 / 中铁`；订单标签=`配件 / 1688一件代发`；买家留言=`BBFF / SSDD`；卖家备注=`BBFF / SSDD`。2026-09-01~09-02 实测：不排除 26,296 行 → 按字段排除后 17,506 行（旧口径同样 14 个词是 16,552 行，多出的 954 行正是"标签里带物流、物流公司里没有"的那些）。
-
-经营对象问题排名里的每个看板都有独立翻页，不再用"显示更多"或无限滚动，也不会因为对象太多被截断：
-
-- 01 签收日期维度：按日期列翻页（默认 10 列/页，可切 10/20/50/100）；
-- 02–08 采购/供应商/条码/物流公司/发货仓/平台/店铺：按对象行翻页（默认 20 行/页）；
-- 发货仓 / 物流公司 超时排名：按对象行翻页（默认 20 行/页）。
-- 09 订单明细：翻页控件就在看板内部（不再挂在页面底部）；未下钻时按 URL 的 `page/pageSize` 走服务端分页（每页 25/50/100/200，命中快照时显示真实总数"共 N 条筛选结果"），下钻时用本地分页翻全量匹配明细。
-
-分页条统一由 `BoardPagination.tsx` 渲染（含"共 N 条 · 第 x / y 页"、上/下一页与每页条数），行集合变化（例如切换采购后重新筛选供应商）时自动回到第 1 页。
-
-**每页条数切换的坑（已修）**：下拉框原先在 `onChange` 里同时调了 `onPageSizeChange(新值)` 和 `onPageChange(1)`。服务端分页（09 订单明细未下钻时）这两次都会触发 `router.push`，而后一次带着**旧的** `pageSize` 构造 URL 并覆盖前一次，表现为"订单明细每页条数选了没反应、又跳回 50"。现在 `BoardPagination` 只通知"每页条数变了"，回到第 1 页由调用方负责：服务端分页用 `href(1, { ...filters, pageSize })`，本地分页（各经营对象表、发货仓/物流公司排名、下钻后的 09 明细）在 `setState` 里带 `page: 1`。
-
-店铺维度表在"店铺"列前额外展示"平台"列：点击平台即把该表筛成该平台的店铺（标题变成"店铺维度 · 天猫"，再次点击取消），点击店铺名仍走 09 明细下钻。店铺分组的业务键是"平台 + 店铺"，避免同名店铺跨平台互相覆盖；平台列在样本路径（JS 归组）与整区间路径（SQL `GROUPING SETS ((platform, shop))`）都做了同样的处理，并逐字段比对过一致性。
-
-### 规模上限与样本回落
-
-SQL 聚合成本与区间行数近似线性（约 5 万行/秒）。当**区间原始行数超过 `LOGISTICS_ARRIVAL_SIGNING_DURATION_EXACT_SCOPE_MAX_ROWS`（11 万条，约 11 天）**时，`getDashboard` 会退回区间内均匀抽取的 2,000 条样本（`listDashboardSampleRows`，5 层并行、按签收时间分层，不再是"取最近一段"），并在底部注释写明原因与"缩小签收日期范围即可得到精确值"。
-
-返回值上的 `dataScope`（`exact` / `sample`）与 `dataScopeReason`（`live-source` / `range-too-large`）驱动卡片副标题、底部注释与 CSV 导出的口径说明。
-
-实测（663k 行快照，含 13 个默认排除关键词）：
-
-| 区间 | 原始行数 | 口径 | 首屏耗时 |
-| --- | --- | --- | --- |
-| 1 天 | 约 1.3 万 | 整区间精确 | 0.55s |
-| 2 天 | 约 2.6 万 | 整区间精确 | 1.7s |
-| 5 天 | 约 6.5 万 | 整区间精确 | 3.1s |
-| 本月 | 约 30 万 | 样本（超上限） | 3.8–5.0s |
-
-服务端 60s 内重复访问直接命中缓存。要把大区间也做成亚秒精确，方向是在快照写入时就把 4 个时间戳、5 个环节时长落成列，并把多维指标的计数改为位掩码 `GROUP BY`（一次扫描产出全部桶计数），现有文档结论不变、只替换实现。
-
-### 查询性能优化（2026-10）
-
-上线后"每次查询生成太慢"的根因有三个，都在快照读路径上：
-
-1. **整表顺序扫描**：聚合查询原先 `SELECT` 全列（`rowKey`、`productItems`、十几个文本列），
-   Postgres 只能对 900MB 的堆表做 `Seq Scan`（28 天区间实测 `read=106409` 页、6.3 秒）。
-   现在按用途收窄列集合——`FILTERED_TIMELINE_SELECT`（只取 4 个时间戳）用于整区间总览/环节目标，
-   `FILTERED_DIMENSION_SELECT`（时间戳 + 4 个维度列）用于签收日期/平台/店铺/发货仓/物流/超时排名——
-   并新增覆盖索引 `LogisticsArrivalSigningDurationSnapshot_cover_idx`
-   （`(snapshotDate, signTime) INCLUDE (payTime, sendTime, fetchTime, warehouseName, platformName, shopName, logisticCompanyName)`），
-   扫描变成 **Index Only Scan**（同样的 28 天区间 26ms、`Heap Fetches: 0`）。
-2. **有序集聚合把整行拖进排序**：`percentile_cont(0.5/0.9) WITHIN GROUP` 原先和十几个计数写在同一条语句里，
-   输入行 14 列宽，PG 18 会把它整行送进排序（两个分位数单独就占 4.3 秒，环节分位数叠在一起甚至到分钟级）。
-   现在分位数**按列拆成独立语句**、只投影一个浮点列，并与计数语句并行下发（`Promise.all`）。
-3. **CTE 表达式被重复内联**：`measured`/`durations` 的 `CASE + EXTRACT` 会在每一处引用被重新计算，
-   同一条聚合里重复十几次。改为 `AS MATERIALIZED` 后只算一次（计数语句从 2.3s 降到 ~0.5s）。
-
-另外把 **环节目标（上月平均 × 98%）** 也接入 10 分钟内存缓存（此前每次刷新都重跑上月聚合）。
-
-优化前后（本机 Postgres 18、快照 648,689 行、冷启动、无缓存）：
-
-| 场景 | 优化前 | 优化后 |
-| --- | --- | --- |
-| 仓库层 `getDashboard`（28 天，样本口径） | 7.3s | **2.3s** |
-| 仓库层 `getDashboard`（10 天） | 4.4s | **0.4s** |
-| 仓库层 `getDashboard`（2 天，精确口径） | 1.7s | **0.3s** |
-| 浏览器首屏出数（冷启动，含 5.6MB 载荷 + 渲染） | ~7–10s | **2.7s** |
-
-正确性用 2 天区间做过逐项对账：SQL 聚合与"取全量明细在 JS 里现算"在订单数、平均/中位/P90、
-异常计数、达成率、时效分布、5 个环节的 可计算单量/平均/中位/P90 上完全一致。
-
-时间戳在 SQL 里用 `NULLIF(BTRIM(col),'')::timestamp` 直接转型：快照写入的就是远端 `CONVERT(varchar(19), …, 120)` 结果，格式固定；早期版本用正则逐行校验，整区间聚合约慢一个数量级。
-
-## 运维排查
-
-```sql
--- 批次状态
-SELECT "snapshotDate", status, "windowFrom", "windowTo", "rowCount", message, "finishedAt"
-FROM "LogisticsArrivalSigningDurationSnapshotRun" ORDER BY "snapshotDate" DESC;
-
--- 当天行数
-SELECT count(*) FROM "LogisticsArrivalSigningDurationSnapshot" WHERE "snapshotDate" = CURRENT_DATE;
-```
-
-- 页面长时间显示"数据更新"而不是"快照数据" → 先看批次是不是 `FAILED`，或窗口是否覆盖了页面的签收日期区间。
-- 批次 `RUNNING` 卡住（进程被杀）→ 该批次不会发布；直接重跑或加 `--force` 即可（重跑会先清空当天行）。
-- 需要重建历史窗口 → `--window-days=` 调大 + `--force`。
-
-## 部署步骤（生产）
-
-1. 部署新版本代码；
-2. 执行迁移 `prisma/migrations/20260928120000_add_logistics_arrival_signing_duration_snapshot`（需按生产迁移流程授权、先备份）；
-3. 跑一次手工同步生成第一批快照（`--apply`），确认批次为 `COMPLETED`、行数与窗口符合预期；
-4. 安装 timer 并核对 `systemctl list-timers`；
-5. 打开看板确认头部显示"快照数据 · 日期"。
-
-注意：Prisma Client 重新生成过，运行中的 dev/prod 进程需要重启才能拿到新模型。

furniture-3d-system/docs/设计规范/苹果风格视觉标准.md

@@ -0,0 +1,207 @@
+# 苹果风格视觉设计标准 (Apple-Style Visual Design Standards)
+
+> **版本**: 2.0 (2026-01-29)
+> **状态**: 补充参考标准；当前新平台第一视觉标准以 `白曜石工坊统一视觉标准.md` 为准
+> **优先级**: 如本文件与白曜石工坊标准冲突，优先执行白曜石工坊标准
+> **目标**: 打造优雅、统一、沉浸式的用户体验，完全去除"模板化"和"AI味"，接近苹果官网的视觉水准。
+
+---
+
+## 目录
+
+1.  [核心设计哲学](#1-核心设计哲学)
+2.  [详细视觉规范](#2-详细视觉规范)
+    *   [色彩系统](#21-色彩系统)
+    *   [排版系统](#22-排版系统)
+    *   [布局与间距](#23-布局与间距)
+    *   [材质与光影](#24-材质与光影)
+3.  [交互与动画](#3-交互与动画)
+4.  [去AI味专项指南](#4-去ai味专项指南)
+5.  [技术架构与文件结构](#5-技术架构与文件结构)
+6.  [组件开发规范](#6-组件开发规范)
+
+---
+
+## 1. 核心设计哲学
+
+### 1.1 内容至上 (Content is King)
+*   **原则**：界面不仅是容器，更是内容的舞台。UI 应该"退后"，让 3D 模型、产品图片和关键数据"向前"。
+*   **执行**：
+    *   背景色主要使用白色或极淡的灰色；当前产品不再提供深浅色主题切换。
+    *   **拒绝**无意义的装饰性边框、分割线和阴影。只有在区分层级必要时才使用。
+    *   **拒绝**均等分割的网格布局（"AI味"典型特征）。使用非对称布局（如：左侧 2/3 展示 3D 模型，右侧 1/3 展示控制面板）。
+
+### 1.2 物理感与材质 (Materiality & Physics)
+*   **原则**：数字界面应模拟真实世界的物理属性。
+*   **执行**：
+    *   **Liquid Glass (毛玻璃)**：仅在覆盖内容时使用（如导航栏、侧边栏、浮动面板）。标准：`backdrop-filter: blur(20px) saturate(180%)`。
+    *   **Spring Animation (弹簧动画)**：交互元素（按钮按压、弹窗出现）必须使用弹簧物理模拟，而不是简单的线性过渡。
+    *   **光影**：光源应统一来自正上方。阴影应柔和、弥散，模拟环境光遮蔽 (Ambient Occlusion)。
+
+### 1.3 优雅的排版 (Elegant Typography)
+*   **原则**：排版是信息层级的核心。
+*   **执行**：
+    *   **动态字间距 (Dynamic Tracking)**：大标题收紧 (-0.4px)，正文标准，小字加宽 (+0.06px)。
+    *   **层次分明**：使用字重 (Weight) 和颜色 (Color) 区分层级，而不是单纯靠字号。
+
+---
+
+## 2. 详细视觉规范
+
+### 2.1 色彩系统
+
+**设计令牌位置**: `src/lib/design-tokens/colors.ts`
+
+不要使用纯灰 (`#808080`)，总是混入微量的蓝色或暖色调。
+
+| 用途 | Light Mode | Dark Mode | 说明 |
+| :--- | :--- | :--- | :--- |
+| **背景** | `#FFFFFF` | `#000000` | 纯净背景，最大化对比度 |
+| **次级背景** | `#F5F5F7` | `#1C1C1E` | 用于分组区块，**比系统灰(#F2F2F7)更淡、更优雅** |
+| **主文本** | `#1D1D1F` | `#F5F5F7` | 接近纯黑但不是纯黑 (Off-black) |
+| **次文本** | `#86868b` | `#86868b` | 经典的苹果灰，用于说明文字 |
+| **强调色** | `#008D74` | `#00B896` | 品牌绿，仅用于链接和主按钮 |
+| **分割线** | `rgba(0,0,0,0.1)` | `rgba(255,255,255,0.1)` | 极细，极淡 |
+
+### 2.2 排版系统
+
+**设计令牌位置**: `src/lib/design-tokens/typography.ts`
+
+我们使用**合法的开源/系统字体栈**，严格避免版权风险：
+*   **西文**: `-apple-system`, `BlinkMacSystemFont`, `Inter`, `Segoe UI`
+*   **中文**: `-apple-system`, `Noto Sans CJK SC`, `Source Han Sans SC` (思源黑体), `Microsoft YaHei`
+*   **代码**: `JetBrains Mono`, `Fira Code`
+
+| 样式 | 字号 (px) | 行高 (px) | 字间距 (px) | 用途 |
+| :--- | :--- | :--- | :--- | :--- |
+| **Large Title** | 34 | 41 | -0.4 | 页面主标题 |
+| **Title 1** | 28 | 34 | -0.36 | 章节标题 |
+| **Title 2** | 22 | 28 | -0.26 | 子章节标题 |
+| **Headline** | 17 | 22 | -0.41 | 强调文本 (Semibold) |
+| **Body** | 17 | 25 | -0.41 | 正文内容 |
+| **Caption 1** | 12 | 16 | 0 | 说明文字 |
+
+### 2.3 布局与间距
+
+**设计令牌位置**: `src/lib/design-tokens/spacing.ts`
+
+*   **基础网格**: 4px
+*   **大留白原则**:
+    *   模块间距至少 `48px` 或 `64px`。
+    *   卡片内部 Padding 至少 `24px`。
+*   **流体布局**:
+    *   容器宽度随视口变化，最大宽度限制 (Max-width: 1440px)。
+    *   **全宽突破**: Hero Banner 等关键元素应占据全宽。
+
+### 2.4 材质与光影
+
+*   **Liquid Glass**:
+    *   Light: `rgba(255, 255, 255, 0.72)` + Blur 20px
+    *   Dark: `rgba(22, 22, 23, 0.72)` + Blur 20px
+*   **阴影 (Shadows)**:
+    *   Subtle: `0 2px 8px rgba(0, 0, 0, 0.04)` (静态元素)
+    *   Standard: `0 4px 12px rgba(0, 0, 0, 0.08)` (悬浮/交互)
+    *   Elevated: `0 8px 24px rgba(0, 0, 0, 0.12)` (模态框)
+
+---
+
+## 3. 交互与动画
+
+**设计令牌位置**: `src/lib/design-tokens/animations.ts`
+
+所有交互必须有物理反馈。
+
+*   **按钮按压**: Scale 0.98, Duration 100ms
+*   **微交互 (Hover)**: Scale 1.02, Duration 200ms
+*   **页面过渡**: Duration 500ms, Curve `cubic-bezier(0.16, 1, 0.3, 1)`
+*   **Spring 参数**: 使用 `spring(mass: 1, stiffness: 100, damping: 15)` 模拟真实回弹。
+
+---
+
+## 4. 去AI味专项指南
+
+"AI味" = 死板、重复、缺乏人情味、过度依赖默认组件。
+
+### 4.1 拒绝"Lorem Ipsum"
+*   ❌ "Product Name 1", "This is a description."
+*   ✅ "Eames Lounge Chair", "由模压胶合板和皮革制成，经典的设计符号。"
+*   **要求**：所有占位文本必须是**真实场景数据**。
+
+### 4.2 拒绝"均等分布"
+*   ❌ 4个功能点，每个占 25% 宽度，图标+标题+描述，完全一样。
+*   ✅ 1个核心功能占 60% 宽度配大图，其余 3 个功能以列表形式在侧边展示。打破对称。
+
+### 4.3 拒绝"默认图标"
+*   ❌ 使用实心块状图标。
+*   ✅ 优先使用文字。如果必须用图标，使用细线条风格 (Stroke width 1.5px-2px)。
+
+### 4.4 拒绝"彩虹渐变"
+*   ❌ 高饱和度彩虹渐变背景。
+*   ✅ 纯色、微渐变或高质量实拍图/3D渲染图。
+
+---
+
+## 5. 技术架构与文件结构
+
+本项目基于 **Next.js 16 + Tailwind CSS + React 19** 构建。
+
+### 5.1 目录结构
+
+```
+src/
+├── lib/
+│   └── design-tokens/          # 核心视觉配置
+│       ├── typography.ts       # 字体定义
+│       ├── colors.ts           # 颜色定义
+│       ├── spacing.ts          # 间距定义
+│       └── animations.ts       # 动画定义
+├── components/
+│   └── ui/                     # 基础原子组件
+│       ├── Button.tsx          # 遵循规范的按钮
+│       ├── Card.tsx            # 遵循规范的卡片
+│       ├── Typography.tsx      # 文本组件封装
+│       └── ...
+└── app/
+    └── globals.css             # CSS 变量映射 (自动从 tokens 生成)
+```
+
+### 5.2 迁移指南
+
+如果你在代码中看到旧的 CSS 类（如 `text-gray-500`），请替换为语义化的设计令牌类：
+*   ❌ `text-gray-500` -> ✅ `text-(--color-label-secondary)` (或封装好的 Tailwind 类)
+*   ❌ `bg-white` -> ✅ `bg-(--color-background-primary)`
+*   ❌ `shadow-lg` -> ✅ `shadow-apple-lg`
+
+---
+
+## 6. 组件开发规范
+
+### 6.1 Button
+*   **形状**: 高度 36px/44px，Pill shape (999px) 或 Rounded (8px)。
+*   **质感**: Primary (纯色无边框), Secondary (浅灰背景)。禁止复杂渐变。
+
+### 6.2 Card
+*   **圆角**: 统一 `20px` 或 `24px`。
+*   **边框**: Light Mode 下通常无边框或极淡 `1px` 边框。
+*   **内容**: 内部 Padding 至少 `24px`。
+
+### 6.3 Input
+*   **样式**: 移除默认边框，使用浅灰背景 (`#F5F5F7`)，聚焦时出现 Focus Ring。
+*   **高度**: 至少 `44px`。
+
+### 6.4 Slider
+*   **组件来源**: 统一使用 `src/components/ui/Slider.tsx`，禁止直接使用原生 `input[type="range"]`。
+*   **轨道样式**: 高度 `6px`，圆角 `999px`，未填充色 `#D4DCE6`，填充色使用品牌色 `#008D74`（深色场景可切换 `#00B896`）。
+*   **滑块样式**: 尺寸 `16px`，白色描边 `2px`，投影 `0 1px 3px rgba(0, 0, 0, 0.25)`。
+*   **状态规范**: 禁用态降低不透明度并禁用交互光效；拖动态允许轻微放大（建议 `scale(1.08)`）。
+*   **可访问性**: 必须提供 `aria-label`，并保持键盘可调节。
+
+### 6.5 响应式
+*   使用 `useBreakpoint` 或 Tailwind 的响应式前缀 (`md:`, `lg:`)。
+*   支持 iPhone 刘海屏安全区域 (`safe-area-inset`).
+
+---
+*遵循此标准，我们将构建出一个不仅好用，而且令人愉悦的家具展示系统。*
+
+
+

furniture-3d-system/docs/限价与破价判定规则.md

@@ -1,124 +0,0 @@
-# 限价与破价判定规则（业务确认版）
-
-> 适用范围：限价管理 · 破价订单审核（`/supply-chain/management/custom-table` → 破价订单审核）
-> 本文件为业务口径的唯一来源；规则变更请改本文件并注明生效时间。
-
-## 一、限价与判定口径
-
-1. **判定基准**：以「商家实收」为准；`商家实收 < 限价 × 数量` 即判定破价。
-2. **实付款与平台承担**：实付款 + 平台承担（红包 / 消费券 / 平台券）= 商家实收；凭证必须同时包含「实付款」和「数量」。
-3. **出资方字典**
-   - 商家承担：店铺优惠（官方立减、单品直降、店铺券）、政府补贴
-   - 平台承担：红包、消费券、平台券、平台优惠、新品礼金
-   - 买家承担：淘金币
-   - 待定：首单礼金（等与运营确认后补录）
-4. **限价维度**：按**货号**限价——同一货号下所有规格/条码共用同一套限价。
-5. **限价时间版本**：按订单付款时点生效的限价判定（限价调整前后分别取当时版本），不做"用最新限价回算历史单"。
-6. **成本变动规则（限价维护侧）**：成本价上涨 5% 以内不动限价；成本价下调不变限价。
-7. **非负责人限价**：2026-10-07 00:00 前的 ID 价格不判定破价（此后按规则判定）。
-8. **老链接分界**：上架时间早于 2026-10-07 00:00 的链接（老链接）破价申诉通过；之后的按限价流程结束日期判定（上架时间需早于流程结束日期），并核对店铺款式编码 / 商品编码。
-9. **负责人触发规则**：非运营发起的流程，前两个月全公司运营同价（不归属个人）；两个月后按销量触发负责人（销量高者为负责人）。
-10. **数据快照**：破价单在生成时保存金额快照；退款/售后状态单独记录，退款不等于免责（仍需判断是否已调价）。
-11. **离职人员**：订单负责人已离职 → 自动标记「人员已离职」，不判定、不计乐捐。
-12. **是否有检测报告**：取素材平台「检测报告」接口（`/api/external/certificate-reports`，按 **SPU** 精确匹配，只认有报告文件的记录），进程内缓存 10 分钟；
-    接口未配置或读取失败时该列显示为空、筛选候选值为空。配置项：`MATERIAL_LIBRARY_CERTIFICATE_REPORT_API_BASE_URL/API_KEY`，
-    不填则复用素材平台 `MATERIAL_LIBRARY_WHITE_BACKGROUND_API_*`。
-13. **手工换货单**：聚水潭订单明细出现「被替换行（`item_status=Replaced`、数量归 0）」+「换入行（`item_ext_data` 含 `item_source=手工换货/手工添加`）」时按换货单处理：
-    - 判定按**换出行原编码**的限价执行（客户在平台上购买的那个编码）；
-    - 成交数量与商家实收取**换入行**（换货不改变订单成交金额）；换入行金额抓不到时回退订单主表商家实收 → 订单主表买家实付，都取不到才按 0（由运营申诉说明）；
-    - 换货行配对成功后按原编码生成一条，不再按换入编码单独生成，避免同一订单重复生成两条破价单；
-    - 配对优先按 `sku_uuid` 精确匹配，剩余行仅在一对一时顺序配对；复杂结构（多对多）暂不强行配对，相关行按各自编码现状处理。
-
-## 二、申诉与审核
-
-1. **申诉类型**（4 组）
-   - 链接时间：老链接，上架时间早于限价流程（凭证须含链接 ID + 创建时间）/ 京喜换主体 · 老店转新店
-   - 优惠 / 活动：平台优惠 · 红包 · 券（非商家承担）/ 参与秒杀 · 百补 · 大促等平台活动（凭证须含活动开始与截止时间，且活动价未破价）/ 拼多多多件折扣（99折）
-   - 流程申请：已走新品限价及限价调整（必填流程号，系统到「新品限价及限价调整」流程校验，查不到不允许提交）
-   - 其他原因（须在备注中详细说明）
-2. **申诉范围**：链接时间 / 流程申请类支持**链接级一次性申诉**（默认勾选，覆盖该链接下全部破价订单，后续新单自动继承）；优惠 / 活动类按订单申诉。
-3. **审核要点仅审核人可见**；申诉人只看到凭证要求与示例图。
-4. **凭证校验**：必填校验 + 识别提示（识别结果仅提示，人工一键打回）；后续增加图片查重（hash / 相似度）与关键字段（订单号、链接 ID）一致性校验。
-5. **乐捐**：驳回计 ¥10/单（离职不计）；配套审计链（数据快照 + 申诉材料 + 审核记录），扣款执行交财务确认，保留异议通道。
-6. **举证期限**：待与运营确认后设置（避免事后无法追溯凭证）。
-
-## 三、权限（由管理员统一管理）
-
-路径：用户管理后台 → 权限配置 → 经营管理。限价管理相关的查看 / 导出 / 申诉都由管理员在这里开通。
-
-| 能力 | 权限节点 | 动作 |
-| --- | --- | --- |
-| 页面与数据查看（限价明细、破价订单审核） | 限价管理 | 可见 |
-| 导出（导出明细 / 导出明细（含图片）/ 破价订单导出 / 乐捐明细） | 限价管理 | 下载 |
-| 申诉 · 审核 · 生成 · 导入 | 限价管理 | 操作 |
-| 规则配置（页面可见 + 保存参数） | 限价管理 · 规则配置 | 可见 / 操作 |
-
-- 没有「下载」权限时页面不展示导出入口，服务端导出接口同样鉴权（下载中心任务按「限价管理 · 下载」校验）。
-- 没有「操作」权限时：不显示申诉/审核按钮，服务端也会拒绝申诉、审核、生成、导入。
-- 申诉保留一条兜底：破价单的负责人本人，即使没有「操作」权限，也可以对本人负责的订单发起申诉（审核仍需「操作」）。
-- 没有「规则配置」权限时，规则配置页签不显示、接口不可调用。
-
-## 四、生成与运行
-
-1. **按天增量**：限价逻辑上线后，破价订单**按天增量生成**（每天只生成最新一天的破价单并入库），**历史数据不再重复回算**；破价订单审核页每天展示最新破价单。
-2. **数据来源**：聚水潭报表库（`jst_Orders` + `jst_OrderItem` / 天猫奇门 `jst_qmcust_orderlist` + `_item`），取 `seller_income_amount`、`buyer_paid_amount`、`qty`、`shop_i_id`、`shop_sku_id`、`pay_date`、退款状态，以及换货识别字段 `item_status`、`item_ext_data`（`item_source`、`sku_uuid`）。报表库查询较慢，逐日增量任务建议按天分片拉取。
-3. **限价来源**：钉钉流程（仅取**已完结**），共 4 个模板，同步脚本 `scripts/sync-limit-workflows.mjs`：
-   - 「新品限价及限价调整」→ 货号取「货号(非商品编码)」，限价取「期望日常限价」；
-     其中的「调整限价明细表」子表（申请类型=调整原货号限价）只填「调整后限价」，该列同样作为限价取值
-     （2026-10-16 修复，此前这类调价会被漏掉）；
-   - 「新品限价流程」→ 明细取系统产品限价页面（按流程链接 SPU 关联）。页面数据来自正式库
-     `external.product_catalog_wide_v1`（限价字段：`expected_daily_limit_price` / `non_spu_owner_limit_price`），
-     本地库该视图为空时退回本地 `IntakeNonIntegratedProduct(LimitRow)`；
-   - 「各中心特殊限价需求申请」→ 货号取「货号」，限价取「最低售价」；
-   - 「GB特殊限价需求申请」→ 货号取「货号」，限价取「期望日常限价」（2026-10-16 纳入）。
-   - 「产品限价页面」已确认（CONFIRMED）的限价全量纳入（2026-10-16）：来源正式库
-     `external.product_catalog_wide_v1`，给没有限价流程的货号兜底（如 CY012801=268.6）；
-     同货号与流程限价冲突时**以流程为准**，页面价只在流程没覆盖时生效。
-   - 「限价期初数据」（业务整理的存量限价 Excel，2026-10-16 纳入）：放在期初数据目录
-     （`LIMIT_SYNC_INITIAL_DIR`，默认 `<app>/期初数据`；目录为空时用仓库自带
-     `scripts/data/limit-sync/期初数据/限价期初数据*.xlsx`），取目录里最新一份，
-     按「货号 + 负责人限价 + 更新日期」写入，作为**最低优先级**兜底（如 MKHDNZ0409260600468=279）。
-
-    优先级：**限价流程 > 产品限价页面（已确认）> 限价期初数据**；低优先级只在货号没有更高优先级限价时生效。
-   **例外（2026-10-16 确认）**：期初数据的「更新日期」**晚于**流程完成时间时，以期初数据为准（谁新用谁）；
-   期初比流程旧则维持上面的优先级。
-    **非负责人限价一律按最新口径计算**（2026-10-16 确认）：负责人限价 × 1.05，且不低于 +10 元；
-    期初数据表 / 产品限价页面里的历史「非负责人限价」（倍数 1%～15% 不统一）不采用，
-    限价明细页、导出文件、破价判定三处都用同一公式。
-   写入规则：同货号多流程取**审核通过时间最新**的一条；限价为 0 或空的明细剔除；「申请与SPU负责人同价 / 活动限价」不覆盖负责人限价，只作为价格授权；流程「货号」列若填的是商品编码，用商品编码匹配产品档案换算为货号；无货号时同样用商品编码匹配。页面限价的时间按**北京时间墙钟**存（与流程完成时间一致）。
-
-4. **覆盖率**：暂不做未匹配清单与告警（后续优化）。
-
-5. **正式站同步（服务器端）**：`scripts/sync-limit-workflows.mjs` 已改成服务器可运行，连接信息全部取
-   服务器 `shared/.env` 里的既有变量（`DATABASE_URL` / `JST_REPORT_DB_*` / `PROD_ARCHIVE_DB_*`），
-   不再依赖 Mac 本地路径：
-
-   ```bash
-   # 手动跑一次（正式站目录下，root 或能读 shared/.env 的账号）
-   cd /opt/furniture-3d-system-prod/current/furniture-3d-system
-   sudo -E bash -lc 'set -a; . /opt/furniture-3d-system-prod/shared/.env; set +a; \
-     LIMIT_SYNC_OUT_DIR=/opt/furniture-3d-system-prod/shared/limit-workflow-sync/导出结果 \
-     LIMIT_SYNC_INITIAL_DIR=/opt/furniture-3d-system-prod/shared/limit-workflow-sync/期初数据 \
-     node scripts/run-limit-workflow-sync-production.cjs'
-
-   # 安装每日定时器（systemd，与营销日销同一套样板）：每天北京时间 07:30
-   sudo bash scripts/install-limit-workflow-sync-timer.sh
-   systemctl list-timers --all 'furniture-limit-workflow-sync*' --no-pager
-   journalctl -u furniture-limit-workflow-sync.service -n 200 --no-pager
-   ```
-
-   - 写库是**全量重建 + 单事务**：成功才提交；失败自动回滚，正式库保留上一版限价与授权。
-   - 输出目录 `LIMIT_SYNC_OUT_DIR`（默认 `<app>/导出结果`）里的 `限价流程_完整明细表.xlsx` 每日覆盖，
-     旧版本进 `历史版本/`，默认保留最近 20 份（`LIMIT_SYNC_HISTORY_KEEP`）。
-   - `--skip-excel` / `LIMIT_SYNC_SKIP_EXCEL=1` 可只写库不导 Excel。
-   - 期初数据更新：把新的 `限价期初数据*.xlsx` 放进 `shared/limit-workflow-sync/期初数据/` 即可，下次同步自动取最新。
-   - `SupplyChainBreachRuleConfig` 不需要灌数：接口读取时用代码内置默认值，首次在「规则配置」保存时落库。
-
-## 五、待办
-
-- [ ] 限价流程数据接入 + 筛选逻辑（生效时间版本、货号维度）
-- [ ] 非负责人限价 10-07 规则、负责人触发规则（前两个月同价 / 两个月后按销量）落到判定引擎
-- [ ] 按天增量任务（cron / worker）与失败告警
-- [ ] 凭证查重（hash / 相似度）、关键字段一致性校验
-- [ ] 举证期限、乐捐财务对接流程
-- [ ] 首单礼金 / 新品礼金出资方确认后补录出资方字典

furniture-3d-system/next.config.js

@@ -74,7 +74,6 @@ const contentSecurityPolicy = [
   "base-uri 'self'",
   "object-src 'none'",
   "frame-ancestors 'none'",
-  `frame-src 'self' ${lodopScriptSources.join(' ')}`,
   "form-action 'self'",
   "img-src 'self' data: blob: http: https:",
   "font-src 'self' data:",
@@ -86,13 +85,6 @@ const contentSecurityPolicy = [
   ...(isProduction ? ["upgrade-insecure-requests"] : []),
 ].join('; ')
 
-// 市场选款看板静态页（public/modules/selection-market/）由宿主页 /market-research/selection-market
-// 以同源 iframe 嵌入：在基础 CSP 上仅放开 frame-ancestors 为同源，其余指令不变。
-const boardContentSecurityPolicy = contentSecurityPolicy.replace(
-  "frame-ancestors 'none'",
-  "frame-ancestors 'self'"
-)
-
 const baseSecurityHeaders = [
   {
     key: 'X-Frame-Options',
@@ -202,43 +194,7 @@ for (const candidate of [
   }
 }
 
-function buildClientStorageEnv() {
-  return {
-    STORAGE_PROVIDER:
-      trimToNull(process.env.STORAGE_PROVIDER) ||
-      trimToNull(process.env.OBJECT_STORAGE_PROVIDER) ||
-      '',
-    OBJECT_STORAGE_PROVIDER:
-      trimToNull(process.env.OBJECT_STORAGE_PROVIDER) ||
-      trimToNull(process.env.STORAGE_PROVIDER) ||
-      '',
-    STORAGE_FILE_PATH:
-      trimToNull(process.env.STORAGE_FILE_PATH) ||
-      trimToNull(process.env.OBJECT_STORAGE_FILE_PATH) ||
-      '',
-    OBJECT_STORAGE_FILE_PATH:
-      trimToNull(process.env.OBJECT_STORAGE_FILE_PATH) ||
-      trimToNull(process.env.STORAGE_FILE_PATH) ||
-      '',
-    S3_FILE_PATH: trimToNull(process.env.S3_FILE_PATH) || '',
-    QINIU_FILE_PATH: trimToNull(process.env.QINIU_FILE_PATH) || '',
-    S3_PUBLIC_DOMAIN: trimToNull(process.env.S3_PUBLIC_DOMAIN) || '',
-    S3_PUBLIC_ENDPOINT: trimToNull(process.env.S3_PUBLIC_ENDPOINT) || '',
-    S3_PUBLIC_URL: trimToNull(process.env.S3_PUBLIC_URL) || '',
-    S3_ENDPOINT: trimToNull(process.env.S3_ENDPOINT) || '',
-    S3_BUCKET: trimToNull(process.env.S3_BUCKET) || '',
-    QINIU_PUBLIC_DOMAIN: trimToNull(process.env.QINIU_PUBLIC_DOMAIN) || '',
-    QINIU_PUBLIC_ENDPOINT: trimToNull(process.env.QINIU_PUBLIC_ENDPOINT) || '',
-    QINIU_PUBLIC_URL: trimToNull(process.env.QINIU_PUBLIC_URL) || '',
-    QINIU_USE_HTTPS: trimToNull(process.env.QINIU_USE_HTTPS) || '',
-  }
-}
-
-const clientStorageEnv = buildClientStorageEnv()
-
 const nextConfig = {
-  devIndicators: false,
-  distDir: process.env.NEXT_DIST_DIR || '.next',
   // 启用standalone输出，用于Docker部署
   output: 'standalone',
   
@@ -248,7 +204,7 @@ const nextConfig = {
   },
   
   // 服务器外部包配置（Next.js 16新配置）
-  serverExternalPackages: ['sharp', 'three', 'gsap', '@huggingface/transformers', 'onnxruntime-node', 'mssql', 'mysql2'],
+  serverExternalPackages: ['sharp', 'three', 'gsap'],
   
   // Turbopack配置（Next.js 16默认启用）
   turbopack: {},
@@ -352,7 +308,6 @@ const nextConfig = {
   // 环境变量配置
   env: {
     CUSTOM_KEY: process.env.CUSTOM_KEY,
-    ...clientStorageEnv,
   },
   
   // 重定向配置
@@ -391,21 +346,6 @@ const nextConfig = {
         source: '/(.*)',
         headers: baseSecurityHeaders,
       },
-      {
-        // 市场选款看板静态页需要被本平台宿主页同源 iframe 嵌入：
-        // 覆盖基础安全头的 X-Frame-Options DENY / frame-ancestors 'none'，仅此路径生效。
-        source: '/modules/selection-market/:path*',
-        headers: [
-          {
-            key: 'X-Frame-Options',
-            value: 'SAMEORIGIN'
-          },
-          {
-            key: 'Content-Security-Policy',
-            value: boardContentSecurityPolicy
-          }
-        ],
-      },
       {
         // Next 静态资源在生产环境可长期缓存；开发环境必须禁用缓存，否则浏览器会继续复用旧 bundle。
         source: '/_next/static/:path*',

furniture-3d-system/package-lock.json

@@ -13,7 +13,6 @@
         "@dnd-kit/sortable": "^10.0.0",
         "@dnd-kit/utilities": "^3.2.2",
         "@hookform/resolvers": "^5.2.2",
-        "@huggingface/transformers": "3.8.1",
         "@prisma/adapter-pg": "^7.3.0",
         "@prisma/client": "^7.3.0",
         "@react-three/drei": "^10.7.7",
@@ -26,7 +25,6 @@
         "bcryptjs": "^3.0.3",
         "class-variance-authority": "^0.7.1",
         "clsx": "^2.1.1",
-        "crypto-js": "^4.2.0",
         "date-fns": "^4.1.0",
         "dockerode": "^4.0.9",
         "exceljs": "^4.4.0",
@@ -43,7 +41,7 @@
         "next": "^16.1.6",
         "obj2gltf": "^3.2.0",
         "pg": "^8.17.2",
-        "pinyin-pro": "^3.29.5",
+        "pinyin-pro": "^3.28.1",
         "postcss": "^8.5.6",
         "print-js": "^1.6.0",
         "puppeteer": "^24.40.0",
@@ -53,12 +51,10 @@
         "react": "^19.2.4",
         "react-dom": "^19.2.4",
         "react-hook-form": "^7.54.2",
-        "server-only": "^0.0.1",
         "sharp": "^0.34.5",
         "ssh2": "^1.17.0",
         "tailwind-merge": "^3.4.0",
         "three": "^0.182.0",
-        "uuid": "^11.1.1",
         "xlsx": "^0.18.5",
         "zod": "^4.3.6",
         "zustand": "^5.0.2"
@@ -69,7 +65,6 @@
         "@testing-library/jest-dom": "^6.9.1",
         "@testing-library/react": "^16.3.2",
         "@testing-library/user-event": "^14.6.1",
-        "@types/crypto-js": "^4.2.2",
         "@types/dockerode": "^4.0.1",
         "@types/ioredis": "^4.28.10",
         "@types/jest": "^30.0.0",
@@ -2970,27 +2965,6 @@
         "react-hook-form": "^7.55.0"
       }
     },
-    "node_modules/@huggingface/jinja": {
-      "version": "0.5.9",
-      "resolved": "https://registry.npmjs.org/@huggingface/jinja/-/jinja-0.5.9.tgz",
-      "integrity": "sha512-uWTG+l3VJRsl7EXxYizuL3P+cCPoc3cRqbWWRcQN0FhejRfbdq0RNhCmbY/YDtnTcz9icdLYuLDjsnz4d8JMuw==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@huggingface/transformers": {
-      "version": "3.8.1",
-      "resolved": "https://registry.npmjs.org/@huggingface/transformers/-/transformers-3.8.1.tgz",
-      "integrity": "sha512-tsTk4zVjImqdqjS8/AOZg2yNLd1z9S5v+7oUPpXaasDRwEDhB+xnglK1k5cad26lL5/ZIaeREgWWy0bs9y9pPA==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@huggingface/jinja": "^0.5.3",
-        "onnxruntime-node": "1.21.0",
-        "onnxruntime-web": "1.22.0-dev.20250409-89f8206ba4",
-        "sharp": "^0.34.1"
-      }
-    },
     "node_modules/@humanfs/core": {
       "version": "0.19.1",
       "resolved": "https://registry.npmmirror.com/@humanfs/core/-/core-0.19.1.tgz",
@@ -3532,18 +3506,6 @@
         "node": ">=12"
       }
     },
-    "node_modules/@isaacs/fs-minipass": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/@isaacs/fs-minipass/-/fs-minipass-4.0.1.tgz",
-      "integrity": "sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w==",
-      "license": "ISC",
-      "dependencies": {
-        "minipass": "^7.0.4"
-      },
-      "engines": {
-        "node": ">=18.0.0"
-      }
-    },
     "node_modules/@istanbuljs/load-nyc-config": {
       "version": "1.1.0",
       "resolved": "https://registry.npmmirror.com/@istanbuljs/load-nyc-config/-/load-nyc-config-1.1.0.tgz",
@@ -5832,66 +5794,6 @@
         "node": ">=14.0.0"
       }
     },
-    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@emnapi/core": {
-      "version": "1.7.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "@emnapi/wasi-threads": "1.1.0",
-        "tslib": "^2.4.0"
-      }
-    },
-    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@emnapi/runtime": {
-      "version": "1.7.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "tslib": "^2.4.0"
-      }
-    },
-    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@emnapi/wasi-threads": {
-      "version": "1.1.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "tslib": "^2.4.0"
-      }
-    },
-    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@napi-rs/wasm-runtime": {
-      "version": "1.1.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "@emnapi/core": "^1.7.1",
-        "@emnapi/runtime": "^1.7.1",
-        "@tybys/wasm-util": "^0.10.1"
-      }
-    },
-    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@tybys/wasm-util": {
-      "version": "0.10.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "tslib": "^2.4.0"
-      }
-    },
-    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/tslib": {
-      "version": "2.8.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "0BSD",
-      "optional": true
-    },
     "node_modules/@tailwindcss/oxide-win32-arm64-msvc": {
       "version": "4.1.18",
       "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-arm64-msvc/-/oxide-win32-arm64-msvc-4.1.18.tgz",
@@ -6149,13 +6051,6 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/@types/crypto-js": {
-      "version": "4.2.2",
-      "resolved": "https://registry.npmjs.org/@types/crypto-js/-/crypto-js-4.2.2.tgz",
-      "integrity": "sha512-sDOLlVbHhXpAUAL0YHDUUwDZf3iN4Bwi4W6a0W0b+QcAezUbRtH4FVb+9J4h+XFPW7l/gQ9F8qC7P+Ec4k8QVQ==",
-      "dev": true,
-      "license": "MIT"
-    },
     "node_modules/@types/docker-modem": {
       "version": "3.0.6",
       "resolved": "https://registry.npmmirror.com/@types/docker-modem/-/docker-modem-3.0.6.tgz",
@@ -8064,13 +7959,6 @@
       "integrity": "sha512-XpNj6GDQzdfW+r2Wnn7xiSAd7TM3jzkxGXBGTtWKuSXv1xUV+azxAm8jdWZN06QTQk+2N2XB9jRDkvbmQmcRtg==",
       "license": "MIT"
     },
-    "node_modules/boolean": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/boolean/-/boolean-3.2.0.tgz",
-      "integrity": "sha512-d0II/GO9uf9lfUHH2BQsjxzRJZBdsjgsBiW4BvhWk/3qoKwQFjIDVN19PfX8F2D/r9PCMTtLWjYVCFrpeYUzsw==",
-      "deprecated": "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.",
-      "license": "MIT"
-    },
     "node_modules/bowser": {
       "version": "2.13.1",
       "resolved": "https://registry.npmjs.org/bowser/-/bowser-2.13.1.tgz",
@@ -8884,13 +8772,6 @@
         "node": ">= 8"
       }
     },
-    "node_modules/crypto-js": {
-      "version": "4.2.0",
-      "resolved": "https://registry.npmjs.org/crypto-js/-/crypto-js-4.2.0.tgz",
-      "integrity": "sha512-KALDyEYgpY+Rlob/iriUtjV6d5Eq+Y191A5g4UqLAi8CyGP9N1+FdVbkc1SxKc2r4YAYqG8JzO2KGL+AizD70Q==",
-      "deprecated": "Active development of CryptoJS has been discontinued. This library is no longer maintained.",
-      "license": "MIT"
-    },
     "node_modules/css-line-break": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/css-line-break/-/css-line-break-2.1.0.tgz",
@@ -9147,6 +9028,7 @@
       "version": "1.1.4",
       "resolved": "https://registry.npmmirror.com/define-data-property/-/define-data-property-1.1.4.tgz",
       "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
+      "dev": true,
       "license": "MIT",
       "dependencies": {
         "es-define-property": "^1.0.0",
@@ -9176,6 +9058,7 @@
       "version": "1.2.1",
       "resolved": "https://registry.npmmirror.com/define-properties/-/define-properties-1.2.1.tgz",
       "integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==",
+      "dev": true,
       "license": "MIT",
       "dependencies": {
         "define-data-property": "^1.0.1",
@@ -9284,12 +9167,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/detect-node": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/detect-node/-/detect-node-2.1.0.tgz",
-      "integrity": "sha512-T0NIuQpnTvFDATNuHN5roPwSBG83rFsuO+MXXH9/3N1eFbn4wcPjttvjMLEPWJ0RGUYgQE7cGgS3tNxbqCGM7g==",
-      "license": "MIT"
-    },
     "node_modules/devtools-protocol": {
       "version": "0.0.1581282",
       "resolved": "https://registry.npmmirror.com/devtools-protocol/-/devtools-protocol-0.0.1581282.tgz",
@@ -9355,20 +9232,6 @@
         "node": ">= 8.0"
       }
     },
-    "node_modules/dockerode/node_modules/uuid": {
-      "version": "10.0.0",
-      "resolved": "https://registry.npmjs.org/uuid/-/uuid-10.0.0.tgz",
-      "integrity": "sha512-8XkAphELsDnEGrDxUOHB3RGvXz6TeuYSGEZBOjtTtPm2lwhGBjLgOzLHB63IUWfBpNucQjND6d3AOudO+H3RWQ==",
-      "deprecated": "uuid@10 and below is no longer supported.  For ESM codebases, update to uuid@latest.  For CommonJS codebases, use uuid@11 (but be aware this version will likely be deprecated in 2028).",
-      "funding": [
-        "https://github.com/sponsors/broofa",
-        "https://github.com/sponsors/ctavan"
-      ],
-      "license": "MIT",
-      "bin": {
-        "uuid": "dist/bin/uuid"
-      }
-    },
     "node_modules/doctrine": {
       "version": "2.1.0",
       "resolved": "https://registry.npmmirror.com/doctrine/-/doctrine-2.1.0.tgz",
@@ -9828,12 +9691,6 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/es6-error": {
-      "version": "4.1.1",
-      "resolved": "https://registry.npmjs.org/es6-error/-/es6-error-4.1.1.tgz",
-      "integrity": "sha512-Um/+FxMr9CISWh0bi5Zv0iOD+4cFh5qLeks1qhAopKVAJw3drgKbKySikp7wGhDL0HPeaja0P5ULZrxLkniUVg==",
-      "license": "MIT"
-    },
     "node_modules/esbuild": {
       "version": "0.27.1",
       "resolved": "https://registry.npmmirror.com/esbuild/-/esbuild-0.27.1.tgz",
@@ -9895,6 +9752,7 @@
       "version": "4.0.0",
       "resolved": "https://registry.npmmirror.com/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
       "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
+      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=10"
@@ -10778,12 +10636,6 @@
         "node": ">=16"
       }
     },
-    "node_modules/flatbuffers": {
-      "version": "25.9.23",
-      "resolved": "https://registry.npmjs.org/flatbuffers/-/flatbuffers-25.9.23.tgz",
-      "integrity": "sha512-MI1qs7Lo4Syw0EOzUl0xjs2lsoeqFku44KpngfIduHBYvzm8h2+7K8YMQh1JtVVVrUvhLpNwqVi4DERegUJhPQ==",
-      "license": "Apache-2.0"
-    },
     "node_modules/flatted": {
       "version": "3.3.3",
       "resolved": "https://registry.npmmirror.com/flatted/-/flatted-3.3.3.tgz",
@@ -11245,35 +11097,6 @@
         "url": "https://github.com/sponsors/isaacs"
       }
     },
-    "node_modules/global-agent": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/global-agent/-/global-agent-3.0.0.tgz",
-      "integrity": "sha512-PT6XReJ+D07JvGoxQMkT6qji/jVNfX/h364XHZOWeRzy64sSFr+xJ5OX7LI3b4MPQzdL4H8Y8M0xzPpsVMwA8Q==",
-      "license": "BSD-3-Clause",
-      "dependencies": {
-        "boolean": "^3.0.1",
-        "es6-error": "^4.1.1",
-        "matcher": "^3.0.0",
-        "roarr": "^2.15.3",
-        "semver": "^7.3.2",
-        "serialize-error": "^7.0.1"
-      },
-      "engines": {
-        "node": ">=10.0"
-      }
-    },
-    "node_modules/global-agent/node_modules/semver": {
-      "version": "7.8.5",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
-      "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/globals": {
       "version": "14.0.0",
       "resolved": "https://registry.npmmirror.com/globals/-/globals-14.0.0.tgz",
@@ -11291,6 +11114,7 @@
       "version": "1.0.4",
       "resolved": "https://registry.npmmirror.com/globalthis/-/globalthis-1.0.4.tgz",
       "integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==",
+      "dev": true,
       "license": "MIT",
       "dependencies": {
         "define-properties": "^1.2.1",
@@ -11352,12 +11176,6 @@
       "integrity": "sha512-P8/mMxVLU7o4+55+1TCnQrPmgjPKnwkzkXOK1asnR9Jg2lna4tEY5qBJjMmAaOBDDZWtlRjBXjLa0w53G/uBLA==",
       "license": "Standard 'no charge' license: https://gsap.com/standard-license."
     },
-    "node_modules/guid-typescript": {
-      "version": "1.0.9",
-      "resolved": "https://registry.npmjs.org/guid-typescript/-/guid-typescript-1.0.9.tgz",
-      "integrity": "sha512-Y8T4vYhEfwJOTbouREvG+3XDsjr8E3kIr7uf+JZ0BYloFsttiHU0WfvANVsR7TxNUJa/WpCnw/Ino/p+DeBhBQ==",
-      "license": "ISC"
-    },
     "node_modules/has-bigints": {
       "version": "1.1.0",
       "resolved": "https://registry.npmmirror.com/has-bigints/-/has-bigints-1.1.0.tgz",
@@ -11385,6 +11203,7 @@
       "version": "1.0.2",
       "resolved": "https://registry.npmmirror.com/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
       "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
+      "dev": true,
       "license": "MIT",
       "dependencies": {
         "es-define-property": "^1.0.0"
@@ -13483,12 +13302,6 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/json-stringify-safe": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz",
-      "integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==",
-      "license": "ISC"
-    },
     "node_modules/json5": {
       "version": "2.2.3",
       "resolved": "https://registry.npmmirror.com/json5/-/json5-2.2.3.tgz",
@@ -14318,18 +14131,6 @@
         "tmpl": "1.0.5"
       }
     },
-    "node_modules/matcher": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/matcher/-/matcher-3.0.0.tgz",
-      "integrity": "sha512-OkeDaAZ/bQCxeFAozM55PKcKU0yJMPGifLwV4Qgjitu+5MoAfSQN4lsLJeXZ1b8w0x+/Emda6MZgXS1jvsapng==",
-      "license": "MIT",
-      "dependencies": {
-        "escape-string-regexp": "^4.0.0"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/math-intrinsics": {
       "version": "1.1.0",
       "resolved": "https://registry.npmmirror.com/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
@@ -14481,23 +14282,12 @@
       "version": "7.1.2",
       "resolved": "https://registry.npmmirror.com/minipass/-/minipass-7.1.2.tgz",
       "integrity": "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==",
+      "dev": true,
       "license": "ISC",
       "engines": {
         "node": ">=16 || 14 >=14.17"
       }
     },
-    "node_modules/minizlib": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/minizlib/-/minizlib-3.1.0.tgz",
-      "integrity": "sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw==",
-      "license": "MIT",
-      "dependencies": {
-        "minipass": "^7.1.2"
-      },
-      "engines": {
-        "node": ">= 18"
-      }
-    },
     "node_modules/mitt": {
       "version": "3.0.1",
       "resolved": "https://registry.npmmirror.com/mitt/-/mitt-3.0.1.tgz",
@@ -14945,6 +14735,7 @@
       "version": "1.1.1",
       "resolved": "https://registry.npmmirror.com/object-keys/-/object-keys-1.1.1.tgz",
       "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
+      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">= 0.4"
@@ -15072,49 +14863,6 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
-    "node_modules/onnxruntime-common": {
-      "version": "1.21.0",
-      "resolved": "https://registry.npmjs.org/onnxruntime-common/-/onnxruntime-common-1.21.0.tgz",
-      "integrity": "sha512-Q632iLLrtCAVOTO65dh2+mNbQir/QNTVBG3h/QdZBpns7mZ0RYbLRBgGABPbpU9351AgYy7SJf1WaeVwMrBFPQ==",
-      "license": "MIT"
-    },
-    "node_modules/onnxruntime-node": {
-      "version": "1.21.0",
-      "resolved": "https://registry.npmjs.org/onnxruntime-node/-/onnxruntime-node-1.21.0.tgz",
-      "integrity": "sha512-NeaCX6WW2L8cRCSqy3bInlo5ojjQqu2fD3D+9W5qb5irwxhEyWKXeH2vZ8W9r6VxaMPUan+4/7NDwZMtouZxEw==",
-      "hasInstallScript": true,
-      "license": "MIT",
-      "os": [
-        "win32",
-        "darwin",
-        "linux"
-      ],
-      "dependencies": {
-        "global-agent": "^3.0.0",
-        "onnxruntime-common": "1.21.0",
-        "tar": "^7.0.1"
-      }
-    },
-    "node_modules/onnxruntime-web": {
-      "version": "1.22.0-dev.20250409-89f8206ba4",
-      "resolved": "https://registry.npmjs.org/onnxruntime-web/-/onnxruntime-web-1.22.0-dev.20250409-89f8206ba4.tgz",
-      "integrity": "sha512-0uS76OPgH0hWCPrFKlL8kYVV7ckM7t/36HfbgoFw6Nd0CZVVbQC4PkrR8mBX8LtNUFZO25IQBqV2Hx2ho3FlbQ==",
-      "license": "MIT",
-      "dependencies": {
-        "flatbuffers": "^25.1.24",
-        "guid-typescript": "^1.0.9",
-        "long": "^5.2.3",
-        "onnxruntime-common": "1.22.0-dev.20250409-89f8206ba4",
-        "platform": "^1.3.6",
-        "protobufjs": "^7.2.4"
-      }
-    },
-    "node_modules/onnxruntime-web/node_modules/onnxruntime-common": {
-      "version": "1.22.0-dev.20250409-89f8206ba4",
-      "resolved": "https://registry.npmjs.org/onnxruntime-common/-/onnxruntime-common-1.22.0-dev.20250409-89f8206ba4.tgz",
-      "integrity": "sha512-vDJMkfCfb0b1A836rgHj+ORuZf4B4+cc2bASQtpeoJLueuFc5DuYwjIZUBrSvx/fO5IrLjLz+oTrB3pcGlhovQ==",
-      "license": "MIT"
-    },
     "node_modules/open": {
       "version": "10.2.0",
       "resolved": "https://registry.npmmirror.com/open/-/open-10.2.0.tgz",
@@ -15537,9 +15285,9 @@
       }
     },
     "node_modules/pinyin-pro": {
-      "version": "3.29.5",
-      "resolved": "https://registry.npmjs.org/pinyin-pro/-/pinyin-pro-3.29.5.tgz",
-      "integrity": "sha512-Fk5YoRmtdHqJWqAuzYVG/NzvzeCbaG+ZEwbY6Nbps3QAIrvQQEtcm49frcyCM8i2b5najnzPDtYqrHRYTTiuwQ==",
+      "version": "3.28.1",
+      "resolved": "https://registry.npmmirror.com/pinyin-pro/-/pinyin-pro-3.28.1.tgz",
+      "integrity": "sha512-oqz8ulwRgtUXRi0vbqEfGNly19zpyCxYrjhkk5TibGcgSW6eNwS5woajCXRwqURi8Ehc2yOFTiB4uNoZ+NJOnA==",
       "license": "MIT"
     },
     "node_modules/pirates": {
@@ -15633,12 +15381,6 @@
         "pathe": "^2.0.3"
       }
     },
-    "node_modules/platform": {
-      "version": "1.3.6",
-      "resolved": "https://registry.npmjs.org/platform/-/platform-1.3.6.tgz",
-      "integrity": "sha512-fnWVljUchTro6RiCFvCXBbNhJc2NijN7oIQxbwsyL0buWJPG85v81ehlHI9fXrJsMNgTofEoWIQeClKpgxFLrg==",
-      "license": "MIT"
-    },
     "node_modules/playwright": {
       "version": "1.59.1",
       "resolved": "https://registry.npmmirror.com/playwright/-/playwright-1.59.1.tgz",
@@ -16739,29 +16481,6 @@
         "url": "https://github.com/sponsors/isaacs"
       }
     },
-    "node_modules/roarr": {
-      "version": "2.15.4",
-      "resolved": "https://registry.npmjs.org/roarr/-/roarr-2.15.4.tgz",
-      "integrity": "sha512-CHhPh+UNHD2GTXNYhPWLnU8ONHdI+5DI+4EYIAOaiD63rHeYlZvyh8P+in5999TTSFgUYuKUAjzRI4mdh/p+2A==",
-      "license": "BSD-3-Clause",
-      "dependencies": {
-        "boolean": "^3.0.1",
-        "detect-node": "^2.0.4",
-        "globalthis": "^1.0.1",
-        "json-stringify-safe": "^5.0.1",
-        "semver-compare": "^1.0.0",
-        "sprintf-js": "^1.1.2"
-      },
-      "engines": {
-        "node": ">=8.0"
-      }
-    },
-    "node_modules/roarr/node_modules/sprintf-js": {
-      "version": "1.1.3",
-      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.1.3.tgz",
-      "integrity": "sha512-Oo+0REFV59/rz3gfJNKQiBlwfHaSESl1pcGyABQsnnIfWOFt6JNj5gCog2U6MLZ//IGYD+nA8nI+mTShREReaA==",
-      "license": "BSD-3-Clause"
-    },
     "node_modules/rrweb-cssom": {
       "version": "0.8.0",
       "resolved": "https://registry.npmmirror.com/rrweb-cssom/-/rrweb-cssom-0.8.0.tgz",
@@ -16915,50 +16634,11 @@
         "semver": "bin/semver.js"
       }
     },
-    "node_modules/semver-compare": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/semver-compare/-/semver-compare-1.0.0.tgz",
-      "integrity": "sha512-YM3/ITh2MJ5MtzaM429anh+x2jiLVjqILF4m4oyQB18W7Ggea7BfqdH/wGMK7dDiMghv/6WG7znWMwUDzJiXow==",
-      "license": "MIT"
-    },
     "node_modules/seq-queue": {
       "version": "0.0.5",
       "resolved": "https://registry.npmjs.org/seq-queue/-/seq-queue-0.0.5.tgz",
       "integrity": "sha512-hr3Wtp/GZIc/6DAGPDcV4/9WoZhjrkXsi5B/07QgX8tsdc6ilr7BFM6PM6rbdAX1kFSDYeZGLipIZZKyQP0O5Q=="
     },
-    "node_modules/serialize-error": {
-      "version": "7.0.1",
-      "resolved": "https://registry.npmjs.org/serialize-error/-/serialize-error-7.0.1.tgz",
-      "integrity": "sha512-8I8TjW5KMOKsZQTvoxjuSIa7foAwPWGOts+6o7sgjz41/qMD9VQHEDxi6PBvK2l0MXUmqZyNpUK+T2tQaaElvw==",
-      "license": "MIT",
-      "dependencies": {
-        "type-fest": "^0.13.1"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/serialize-error/node_modules/type-fest": {
-      "version": "0.13.1",
-      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.13.1.tgz",
-      "integrity": "sha512-34R7HTnG0XIJcBSn5XhDd7nNFPRcXYRZrBB2O2jdKqYODldSzBAqzsWoZYYvduky73toYS/ESqxPvkDf/F0XMg==",
-      "license": "(MIT OR CC0-1.0)",
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/server-only": {
-      "version": "0.0.1",
-      "resolved": "https://registry.npmjs.org/server-only/-/server-only-0.0.1.tgz",
-      "integrity": "sha512-qepMx2JxAa5jjfzxG79yPPq+8BuFToHd1hm7kI+Z4zAq1ftQiP7HcxMhDDItrbtwVeLg/cY2JnKnrcFkmiswNA==",
-      "license": "MIT"
-    },
     "node_modules/set-blocking": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/set-blocking/-/set-blocking-2.0.0.tgz",
@@ -17875,22 +17555,6 @@
         "url": "https://opencollective.com/webpack"
       }
     },
-    "node_modules/tar": {
-      "version": "7.5.22",
-      "resolved": "https://registry.npmjs.org/tar/-/tar-7.5.22.tgz",
-      "integrity": "sha512-MFO/QzvtAOmJbkhOaCTvbGcFN9L9b+JunIsDwaKljSOdcLMea3NJ1k9Usz/rjdfSXTq4dfzfeS7W4p4YOAAHeA==",
-      "license": "BlueOak-1.0.0",
-      "dependencies": {
-        "@isaacs/fs-minipass": "^4.0.0",
-        "chownr": "^3.0.0",
-        "minipass": "^7.1.2",
-        "minizlib": "^3.1.0",
-        "yallist": "^5.0.0"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
     "node_modules/tar-fs": {
       "version": "2.1.4",
       "resolved": "https://registry.npmmirror.com/tar-fs/-/tar-fs-2.1.4.tgz",
@@ -17919,24 +17583,6 @@
         "node": ">=6"
       }
     },
-    "node_modules/tar/node_modules/chownr": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/chownr/-/chownr-3.0.0.tgz",
-      "integrity": "sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g==",
-      "license": "BlueOak-1.0.0",
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/tar/node_modules/yallist": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/yallist/-/yallist-5.0.0.tgz",
-      "integrity": "sha512-YgvUTfwqyc7UXVMrB+SImsVYSmTS8X/tSrtdNZMImM+n7+QTriRXyXim0mBrTXNeqzVF0KWGgHPeiyViFFrNDw==",
-      "license": "BlueOak-1.0.0",
-      "engines": {
-        "node": ">=18"
-      }
-    },
     "node_modules/tarn": {
       "version": "3.0.2",
       "resolved": "https://registry.npmmirror.com/tarn/-/tarn-3.0.2.tgz",
@@ -18870,16 +18516,16 @@
       }
     },
     "node_modules/uuid": {
-      "version": "11.1.1",
-      "resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.1.tgz",
-      "integrity": "sha512-vIYxrBCC/N/K+Js3qSN88go7kIfNPssr/hHCesKCQNAjmgvYS2oqr69kIufEG+O4+PfezOH4EbIeHCfFov8ZgQ==",
+      "version": "10.0.0",
+      "resolved": "https://registry.npmmirror.com/uuid/-/uuid-10.0.0.tgz",
+      "integrity": "sha512-8XkAphELsDnEGrDxUOHB3RGvXz6TeuYSGEZBOjtTtPm2lwhGBjLgOzLHB63IUWfBpNucQjND6d3AOudO+H3RWQ==",
       "funding": [
         "https://github.com/sponsors/broofa",
         "https://github.com/sponsors/ctavan"
       ],
       "license": "MIT",
       "bin": {
-        "uuid": "dist/esm/bin/uuid"
+        "uuid": "dist/bin/uuid"
       }
     },
     "node_modules/v8-to-istanbul": {

furniture-3d-system/package.json

@@ -3,9 +3,8 @@
   "version": "0.1.0",
   "private": true,
   "scripts": {
-    "worker:ai-image": "node scripts/run-ai-image-worker.mjs",
     "predev": "npm run prisma:check-client-sync",
-    "dev": "next dev --webpack",
+    "dev": "next dev",
     "build": "prisma generate && next build",
     "start": "next start",
     "lint": "eslint",
@@ -17,31 +16,6 @@
     "prisma:check-client-sync": "node scripts/check-prisma-client-sync.js",
     "prisma:push": "node scripts/prisma-db-push-local.js",
     "prisma:studio": "prisma studio",
-    "sync:supply-chain-product-archive": "tsx scripts/sync-supply-chain-product-archive.ts",
-    "sync:supply-chain-product-archive-daily": "tsx scripts/sync-supply-chain-product-archive-sales-performance-daily.ts",
-    "generate:modular-processing-daily-snapshot": "tsx scripts/generate-modular-processing-daily-snapshot.ts",
-    "sync:supply-chain-product-archive-enrichment": "tsx scripts/sync-supply-chain-product-archive-enrichment.ts",
-    "sync:distribution-listings": "tsx scripts/sync-distribution-listings.ts",
-    "backfill:product-archive-designer": "tsx scripts/backfill-product-archive-designer-from-jst-sku-info-manage.ts",
-    "backfill:product-archive-designer:apply": "tsx scripts/backfill-product-archive-designer-from-jst-sku-info-manage.ts --apply",
-    "backfill:product-archive-opshead": "tsx scripts/backfill-product-archive-opshead-from-jst-sku-info-manage.ts --mode=regular",
-    "backfill:product-archive-opshead:apply": "tsx scripts/backfill-product-archive-opshead-from-jst-sku-info-manage.ts --mode=regular --apply",
-    "backfill:product-archive-opshead:regular": "tsx scripts/backfill-product-archive-opshead-from-jst-sku-info-manage.ts --mode=regular",
-    "backfill:product-archive-opshead:regular:apply": "tsx scripts/backfill-product-archive-opshead-from-jst-sku-info-manage.ts --mode=regular --apply",
-    "backfill:product-archive-production-type": "tsx scripts/backfill-product-archive-production-type.ts",
-    "backfill:product-archive-production-type:apply": "tsx scripts/backfill-product-archive-production-type.ts --apply",
-    "sync:supply-chain-product-archive-sales-performance": "tsx scripts/sync-supply-chain-product-archive-sales-performance.ts",
-    "run:product-sabc": "tsx scripts/run-product-sabc.ts",
-    "compare:product-sabc-xlsx": "tsx scripts/compare-product-sabc-xlsx.ts",
-    "seed:local-product-sabc-xlsx": "tsx scripts/seed-local-product-sabc-xlsx.ts",
-    "sync:jst-sku-product-archive": "tsx scripts/sync-jst-sku-product-archive.ts",
-    "sync:bom-cost-reference": "tsx scripts/sync-bom-cost-reference.ts",
-    "backtest:bom-cost-reference": "tsx scripts/backtest-bom-cost-reference.ts",
-    "report:bom-cost-shadow-divergence": "tsx scripts/report-bom-cost-shadow-divergence.ts",
-    "report:bom-agent-baseline": "tsx scripts/report-bom-agent-baseline.ts",
-    "trial:bom-costing-agent": "tsx scripts/run-bom-costing-agent-trial.ts",
-    "import:yunshan-created-at": "tsx scripts/import-yunshan-product-created-at.ts",
-    "import:product-archive-drawing-media": "tsx scripts/import-product-archive-drawing-media.ts",
     "db:verify-master-data": "node scripts/verify-master-data-foundation.js",
     "db:verify-master-data:audit": "node scripts/verify-master-data-foundation.js --output .master-data-audits/foundation-hard-ready-gate-current.json --summary-output .master-data-audits/foundation-hard-ready-gate-current.summary.json --summary-stdout",
     "db:verify-master-data:strict": "node scripts/verify-master-data-foundation.js --require-applied",
@@ -49,8 +23,6 @@
     "db:verify-master-data:production-readonly": "node scripts/verify-master-data-foundation.js --read-only-quality --summary-output .master-data-audits/foundation-production-readonly-current.summary.json --summary-stdout",
     "db:cleanup-master-data": "node scripts/apply-master-data-cleanup-plan.js",
     "db:cleanup-master-data:validate": "node scripts/apply-master-data-cleanup-plan.js --validate-plan",
-    "db:cleanup-operation-logs": "tsx scripts/cleanup-operation-logs.ts",
-    "db:cleanup-operation-logs:apply": "tsx scripts/cleanup-operation-logs.ts --apply --confirm=cleanup-operation-logs",
     "db:export-product-category-review": "node scripts/export-non-integrated-product-category-review.js",
     "db:build-product-category-cleanup-plan": "node scripts/build-non-integrated-product-category-cleanup-plan.js",
     "db:match-jst-product-category-cleanup-plan": "node scripts/match-jst-product-category-cleanup-plan.js",
@@ -77,34 +49,13 @@
     "materials:sync-standard": "tsx scripts/sync-standard-finishes.ts",
     "materials:sync-standard:apply": "tsx scripts/sync-standard-finishes.ts --apply",
     "sync:jst-sku-stock": "tsx scripts/sync-jst-sku-stock-products.ts",
-    "sync:product-inventory-snapshot": "tsx scripts/sync-product-inventory-snapshot.ts",
-    "image-search:model:prepare": "tsx scripts/prepare-product-archive-image-search-model.ts",
-    "image-search:index": "tsx scripts/index-product-archive-images.ts",
-    "repair:barcode-print:historical": "tsx scripts/repair-barcode-print-source-rows.ts",
     "sync:oa-board": "tsx scripts/sync-oa-board.ts",
     "sync:oa-board:apply": "tsx scripts/sync-oa-board.ts --apply",
-    "sync:oa-brand-planning": "tsx scripts/sync-oa-brand-planning-board.ts",
-    "sync:oa-brand-planning:apply": "tsx scripts/sync-oa-brand-planning-board.ts --apply",
-    "sync:oa-video-flow": "tsx scripts/sync-oa-video-flow-board.ts",
-    "sync:oa-video-flow:apply": "tsx scripts/sync-oa-video-flow-board.ts --apply",
-    "sync:oa-art-flow-raw": "tsx scripts/sync-oa-art-flow-raw.ts",
-    "sync:oa-art-flow-raw:apply": "tsx scripts/sync-oa-art-flow-raw.ts --apply",
-    "import:clearance-pool": "tsx scripts/import-clearance-pool-snapshot.ts",
-    "import:clearance-pool-archive": "tsx scripts/import-clearance-pool-archive.ts",
-    "reset:clearance-pool:archive": "tsx scripts/reset-clearance-pool-to-archive.ts",
-    "sync:clearance-pool:discontinued": "tsx scripts/sync-clearance-pool-snapshot.ts",
-    "sync:clearance-stock:stock-monitor": "tsx scripts/sync-clearance-stock-from-stock-monitor.ts",
-    "sync:clearance-progress": "tsx scripts/sync-clearance-progress.ts",
-    "import:clearance-review": "tsx scripts/import-clearance-review-snapshots.ts",
-    "cache:oa-board:local": "tsx scripts/cache-oa-board-local-preview.ts",
     "import:oa-board-activity-mappings": "tsx scripts/import-oa-board-activity-mappings.ts",
     "import:oa-board-node-rules": "tsx scripts/import-oa-board-node-rules.ts",
     "report:oa-board-activities": "tsx scripts/report-oa-board-activities.ts",
     "sync:employee-directory": "tsx scripts/sync-employee-directory.ts",
     "sync:employee-directory:apply": "tsx scripts/sync-employee-directory.ts --apply",
-    "sync:dingtalk-directory:apply": "tsx scripts/sync-dingtalk-directory.ts --apply",
-    "sync:external-jsreport": "tsx scripts/sync-external-readonly-to-jsreport.ts",
-    "sync:external-jsreport:apply": "tsx scripts/sync-external-readonly-to-jsreport.ts --apply",
     "db:verify-master-data:truth": "node scripts/verify-master-data-truth-sources.js",
     "db:verify-master-data:code": "node scripts/verify-master-data-code-boundaries.js",
     "db:verify-master-data:all": "npm run db:verify-master-data:truth && npm run db:verify-master-data:code && npm run db:verify-master-data:migration-status && npm run db:verify-master-data",
@@ -142,7 +93,6 @@
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
     "@hookform/resolvers": "^5.2.2",
-    "@huggingface/transformers": "3.8.1",
     "@prisma/adapter-pg": "^7.3.0",
     "@prisma/client": "^7.3.0",
     "@react-three/drei": "^10.7.7",
@@ -155,7 +105,6 @@
     "bcryptjs": "^3.0.3",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "crypto-js": "^4.2.0",
     "date-fns": "^4.1.0",
     "dockerode": "^4.0.9",
     "exceljs": "^4.4.0",
@@ -172,7 +121,7 @@
     "next": "^16.1.6",
     "obj2gltf": "^3.2.0",
     "pg": "^8.17.2",
-    "pinyin-pro": "^3.29.5",
+    "pinyin-pro": "^3.28.1",
     "postcss": "^8.5.6",
     "print-js": "^1.6.0",
     "puppeteer": "^24.40.0",
@@ -182,12 +131,10 @@
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "react-hook-form": "^7.54.2",
-    "server-only": "^0.0.1",
     "sharp": "^0.34.5",
     "ssh2": "^1.17.0",
     "tailwind-merge": "^3.4.0",
     "three": "^0.182.0",
-    "uuid": "^11.1.1",
     "xlsx": "^0.18.5",
     "zod": "^4.3.6",
     "zustand": "^5.0.2"
@@ -221,7 +168,6 @@
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
-    "@types/crypto-js": "^4.2.2",
     "@types/dockerode": "^4.0.1",
     "@types/ioredis": "^4.28.10",
     "@types/jest": "^30.0.0",
@@ -244,20 +190,5 @@
     "tailwindcss": "^4.1.18",
     "tsx": "^4.21.0",
     "typescript": "^5"
-  },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "@parcel/watcher",
-      "@prisma/engines",
-      "cpu-features",
-      "esbuild",
-      "onnxruntime-node",
-      "prisma",
-      "protobufjs",
-      "puppeteer",
-      "sharp",
-      "ssh2",
-      "unrs-resolver"
-    ]
   }
 }

furniture-3d-system/prisma/migrations/20260626104500_align_asset_sku_group_replay_to_schema/migration.sql

@@ -1,84 +0,0 @@
--- 20260613151000 temporarily restored AssetSkuGroup for legacy-data recovery.
--- The current schema deliberately keeps this grouping as JSON compatibility data,
--- so replaying the migration chain must retire the transient relational shape again.
-
-DO $$
-BEGIN
-  IF to_regclass('public."AssetSkuGroup"') IS NOT NULL
-    AND EXISTS (
-      SELECT 1
-      FROM information_schema.columns
-      WHERE table_schema = 'public'
-        AND table_name = 'AssetVariant'
-        AND column_name = 'skuGroupId'
-    )
-  THEN
-    EXECUTE $SQL$
-      UPDATE "AssetVariant" AS variant
-      SET "businessData" = jsonb_set(
-        CASE
-          WHEN variant."businessData" IS NULL OR jsonb_typeof(variant."businessData") <> 'object'
-            THEN '{}'::jsonb
-          ELSE variant."businessData"
-        END,
-        '{legacySkuGroup}',
-        jsonb_build_object(
-          'id', sku_group.id,
-          'code', sku_group.code,
-          'name', sku_group.name,
-          'description', sku_group.description,
-          'sortOrder', sku_group."sortOrder",
-          'metadata', sku_group.metadata,
-          'assetFamilyId', sku_group."assetFamilyId",
-          'source', 'AssetSkuGroup.replay-aligned'
-        ),
-        true
-      )
-      FROM "AssetSkuGroup" AS sku_group
-      WHERE variant."skuGroupId" = sku_group.id
-    $SQL$;
-
-    EXECUTE $SQL$
-      UPDATE "AssetFamily" AS family
-      SET metadata = jsonb_set(
-        CASE
-          WHEN family.metadata IS NULL OR jsonb_typeof(family.metadata) <> 'object'
-            THEN '{}'::jsonb
-          ELSE family.metadata
-        END,
-        '{legacySkuGroups}',
-        grouped.groups,
-        true
-      )
-      FROM (
-        SELECT
-          "assetFamilyId",
-          jsonb_agg(
-            jsonb_build_object(
-              'id', id,
-              'code', code,
-              'name', name,
-              'description', description,
-              'sortOrder', "sortOrder",
-              'metadata', metadata,
-              'source', 'AssetSkuGroup.replay-aligned'
-            )
-            ORDER BY "sortOrder", code
-          ) AS groups
-        FROM "AssetSkuGroup"
-        GROUP BY "assetFamilyId"
-      ) AS grouped
-      WHERE family.id = grouped."assetFamilyId"
-    $SQL$;
-  END IF;
-END $$;
-
-ALTER TABLE "AssetVariant"
-  DROP CONSTRAINT IF EXISTS "AssetVariant_skuGroupId_fkey";
-
-DROP INDEX IF EXISTS "AssetVariant_skuGroupId_idx";
-
-ALTER TABLE "AssetVariant"
-  DROP COLUMN IF EXISTS "skuGroupId";
-
-DROP TABLE IF EXISTS "AssetSkuGroup";

furniture-3d-system/prisma/migrations/20260629120000_enforce_external_catalog_wide_one_barcode_per_row/migration.sql

@@ -1,445 +0,0 @@
--- 把宽表 product_catalog_wide_v1 的口径从"一 SKU 一行"明确保护成"一条码一行"。
--- 原视图 FROM sku_source 的行粒度是 SKU，barcode 只是字段；当前 43261 行 barcode 全唯一是数据巧合，
--- 一旦出现"一条码多 SKU"（正式 ProductSKU 落库 + intake ready 同条码 / intake 内部同条码多行），
--- 宽表就会重复，污染外部系统的 barcode 主同步键。
--- 修复：复用项目已有的 DISTINCT ON(barcode_business_key) 模式（latest_quality / limit_by_barcode CTE），
--- 把原主查询整体包成 catalog_by_sku CTE，外层加 DISTINCT ON (barcode_business_key)。
--- 优先级：FORMAL（正式商品）> INTAKE_READY（开发阶段），同源内 updated_at 最新 > created_at 最新。
--- 用 CREATE OR REPLACE VIEW（不用 DROP），保留 external_reader 已有的 GRANT SELECT 权限。
-
--- Expand the external product catalog wide view so external systems can
--- consume ready non-integrated SKU rows before formal Product / ProductSKU
--- records are materialized.
-
-CREATE OR REPLACE VIEW external.product_catalog_wide_v1 AS
-WITH formal_sku_source AS (
-  SELECT
-    sku.product_id,
-    sku.product_model_number,
-    sku.product_name,
-    sku.product_description,
-    sku.product_category_id,
-    sku.product_category_name,
-    sku.product_thumbnail_url,
-    sku.product_model_url,
-    sku.sku_id,
-    sku.sku_code,
-    sku.sku_name,
-    sku.price,
-    sku.cost_price,
-    sku.stock,
-    sku.is_active,
-    sku.record_status,
-    sku.model_url,
-    sku.image_url,
-    sku.image_urls,
-    sku.source_pre_sku_id,
-    sku.source_asset_variant_id,
-    sku.source_asset_variant_ids,
-    sku.asset_family_code,
-    sku.asset_family_name,
-    sku.spec_code,
-    sku.spec_name,
-    sku.barcode,
-    sku.size_json,
-    sku.color,
-    sku.material,
-    sku.source_status,
-    sku.synced_at,
-    sku.warehouse_location_id,
-    sku.warehouse_location_code,
-    sku.warehouse_location_name,
-    sku.created_at,
-    sku.updated_at,
-    sku.product_business_key,
-    sku.sku_business_key,
-    sku.barcode_business_key,
-    'FORMAL'::text AS catalog_source
-  FROM external.product_skus_v1 sku
-),
-formal_identity_map AS (
-  SELECT
-    barcode_business_key,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku_code, '')), '') IS NOT NULL
-      THEN upper(btrim(sku_code))
-      ELSE NULL
-    END AS normalized_sku_code
-  FROM formal_sku_source
-),
-intake_ready_sku_source AS (
-  SELECT
-    product.intake_product_id AS product_id,
-    NULLIF(btrim(COALESCE(product.spu, '')), '') AS product_model_number,
-    NULLIF(btrim(COALESCE(product.product_name, '')), '') AS product_name,
-    NULL::text AS product_description,
-    NULL::text AS product_category_id,
-    NULLIF(btrim(COALESCE(product.product_category, '')), '') AS product_category_name,
-    COALESCE(
-      NULLIF(btrim(COALESCE(product.product_image_url, '')), ''),
-      NULLIF(btrim(COALESCE(sku.image_url, '')), '')
-    ) AS product_thumbnail_url,
-    NULL::text AS product_model_url,
-    sku.intake_sku_item_id AS sku_id,
-    NULLIF(btrim(COALESCE(sku.sku_code, '')), '') AS sku_code,
-    COALESCE(
-      NULLIF(btrim(COALESCE(sku.spec_name, '')), ''),
-      NULLIF(btrim(COALESCE(sku.sku_code, '')), '')
-    ) AS sku_name,
-    NULL::numeric(10,2) AS price,
-    NULL::numeric(10,2) AS cost_price,
-    0::integer AS stock,
-    true AS is_active,
-    'ACTIVE'::text AS record_status,
-    NULLIF(btrim(COALESCE(sku.model_3d_url, '')), '') AS model_url,
-    COALESCE(
-      NULLIF(btrim(COALESCE(sku.image_url, '')), ''),
-      NULLIF(btrim(COALESCE(product.product_image_url, '')), '')
-    ) AS image_url,
-    CASE
-      WHEN COALESCE(
-        NULLIF(btrim(COALESCE(sku.image_url, '')), ''),
-        NULLIF(btrim(COALESCE(product.product_image_url, '')), '')
-      ) IS NOT NULL
-      THEN ARRAY[
-        COALESCE(
-          NULLIF(btrim(COALESCE(sku.image_url, '')), ''),
-          NULLIF(btrim(COALESCE(product.product_image_url, '')), '')
-        )
-      ]
-      ELSE ARRAY[]::text[]
-    END AS image_urls,
-    NULL::text AS source_pre_sku_id,
-    NULL::text AS source_asset_variant_id,
-    ARRAY[]::text[] AS source_asset_variant_ids,
-    NULLIF(btrim(COALESCE(sku.model, '')), '') AS asset_family_code,
-    NULL::text AS asset_family_name,
-    NULLIF(btrim(COALESCE(sku.attribute_code, '')), '') AS spec_code,
-    NULLIF(btrim(COALESCE(sku.spec_name, '')), '') AS spec_name,
-    NULLIF(btrim(COALESCE(sku.barcode, '')), '') AS barcode,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku.size, '')), '') IS NOT NULL
-      THEN jsonb_build_object('label', btrim(sku.size))
-      ELSE NULL::jsonb
-    END AS size_json,
-    NULLIF(btrim(COALESCE(sku.color, '')), '') AS color,
-    NULLIF(btrim(COALESCE(sku.material, '')), '') AS material,
-    NULL::text AS source_status,
-    NULL::text AS synced_at,
-    NULL::text AS warehouse_location_id,
-    NULL::text AS warehouse_location_code,
-    NULL::text AS warehouse_location_name,
-    product.created_at AS created_at,
-    product.updated_at AS updated_at,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(product.spu, '')), '') IS NOT NULL
-      THEN upper(btrim(product.spu))
-      ELSE NULL
-    END AS product_business_key,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku.sku_code, '')), '') IS NOT NULL
-      THEN upper(btrim(sku.sku_code))
-      ELSE NULL
-    END AS sku_business_key,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku.barcode, '')), '') IS NOT NULL
-      THEN upper(btrim(sku.barcode))
-      ELSE NULL
-    END AS barcode_business_key,
-    'INTAKE_READY'::text AS catalog_source
-  FROM external.intake_sku_items_ready_v1 sku
-  JOIN external.intake_products_ready_v1 product
-    ON product.intake_product_id = sku.intake_product_id
-  WHERE NOT EXISTS (
-    SELECT 1
-    FROM formal_identity_map formal
-    WHERE (
-      NULLIF(btrim(COALESCE(sku.barcode, '')), '') IS NOT NULL
-      AND formal.barcode_business_key = upper(btrim(sku.barcode))
-    )
-    OR (
-      NULLIF(btrim(COALESCE(sku.barcode, '')), '') IS NULL
-      AND NULLIF(btrim(COALESCE(sku.sku_code, '')), '') IS NOT NULL
-      AND formal.normalized_sku_code = upper(btrim(sku.sku_code))
-    )
-  )
-),
-sku_source AS (
-  SELECT * FROM formal_sku_source
-  UNION ALL
-  SELECT * FROM intake_ready_sku_source
-),
-asset_summary AS (
-  SELECT
-    product_business_key,
-    sku_business_key,
-    COUNT(*) FILTER (WHERE asset_type = 'SKU_IMAGE')::integer AS image_asset_count,
-    COUNT(*) FILTER (WHERE asset_type = 'SKU_MODEL')::integer AS model_asset_count,
-    COUNT(*) FILTER (WHERE asset_type = 'SKU_THUMBNAIL')::integer AS thumbnail_asset_count,
-    MIN(asset_url) FILTER (WHERE asset_type = 'SKU_MODEL') AS first_model_asset_url,
-    MIN(asset_url) FILTER (WHERE asset_type = 'SKU_THUMBNAIL') AS first_thumbnail_asset_url
-  FROM external.product_assets_v1
-  GROUP BY product_business_key, sku_business_key
-),
-packaged_summary AS (
-  SELECT
-    barcode_business_key,
-    COUNT(*)::integer AS packaged_item_count,
-    COALESCE(SUM(stock_quantity), 0)::integer AS packaged_stock_quantity
-  FROM external.packaged_items_v1
-  WHERE NULLIF(barcode_business_key, '') IS NOT NULL
-  GROUP BY barcode_business_key
-),
-quality_summary AS (
-  SELECT
-    barcode_business_key,
-    COUNT(*)::integer AS quality_record_count,
-    COUNT(*) FILTER (WHERE source_type = 'WAREHOUSE')::integer AS warehouse_quality_record_count,
-    COUNT(*) FILTER (WHERE source_type = 'FIRST_BATCH')::integer AS first_batch_quality_record_count
-  FROM external.sku_quality_inspections_v1
-  WHERE NULLIF(barcode_business_key, '') IS NOT NULL
-  GROUP BY barcode_business_key
-),
-latest_quality AS (
-  SELECT DISTINCT ON (barcode_business_key)
-    barcode_business_key,
-    record_key AS latest_quality_record_key,
-    source_type AS latest_quality_source_type,
-    batch_no AS latest_quality_batch_no,
-    inspected_at AS latest_quality_inspected_at,
-    conclusion AS latest_quality_conclusion,
-    status AS latest_quality_status
-  FROM external.sku_quality_inspections_v1
-  WHERE NULLIF(barcode_business_key, '') IS NOT NULL
-  ORDER BY barcode_business_key, COALESCE(inspected_at, updated_at, created_at) DESC, created_at DESC
-),
-limit_by_barcode AS (
-  SELECT DISTINCT ON (identity_value)
-    identity_value,
-    product_business_key AS limit_source_product_business_key,
-    sku_business_key AS limit_source_sku_business_key,
-    limit_price_applicable,
-    limit_price_confirmed,
-    limit_price_status,
-    expected_daily_limit_price,
-    expected_limit_gross_margin_rate,
-    non_spu_owner_limit_price,
-    limit_confirmed_at
-  FROM (
-    SELECT
-      upper(btrim(barcode)) AS identity_value,
-      product_business_key,
-      sku_business_key,
-      limit_price_applicable,
-      limit_price_confirmed,
-      limit_price_status,
-      expected_daily_limit_price,
-      expected_limit_gross_margin_rate,
-      non_spu_owner_limit_price,
-      limit_confirmed_at,
-      updated_at
-    FROM external.intake_product_limits_v1
-    WHERE NULLIF(btrim(COALESCE(barcode, '')), '') IS NOT NULL
-  ) limit_rows
-  WHERE NULLIF(identity_value, '') IS NOT NULL
-  ORDER BY
-    identity_value,
-    limit_price_applicable DESC,
-    limit_price_confirmed DESC,
-    limit_confirmed_at DESC NULLS LAST,
-    updated_at DESC
-),
-limit_by_sku AS (
-  SELECT DISTINCT ON (identity_value)
-    identity_value,
-    product_business_key AS limit_source_product_business_key,
-    sku_business_key AS limit_source_sku_business_key,
-    limit_price_applicable,
-    limit_price_confirmed,
-    limit_price_status,
-    expected_daily_limit_price,
-    expected_limit_gross_margin_rate,
-    non_spu_owner_limit_price,
-    limit_confirmed_at
-  FROM (
-    SELECT
-      upper(btrim(sku_code)) AS identity_value,
-      product_business_key,
-      sku_business_key,
-      limit_price_applicable,
-      limit_price_confirmed,
-      limit_price_status,
-      expected_daily_limit_price,
-      expected_limit_gross_margin_rate,
-      non_spu_owner_limit_price,
-      limit_confirmed_at,
-      updated_at
-    FROM external.intake_product_limits_v1
-    WHERE NULLIF(btrim(COALESCE(sku_code, '')), '') IS NOT NULL
-  ) limit_rows
-  WHERE NULLIF(identity_value, '') IS NOT NULL
-  ORDER BY
-    identity_value,
-    limit_price_applicable DESC,
-    limit_price_confirmed DESC,
-    limit_confirmed_at DESC NULLS LAST,
-    updated_at DESC
-),
-catalog_by_sku AS (
-SELECT
-  sku.product_id,
-  sku.product_model_number,
-  sku.product_business_key,
-  sku.product_name,
-  sku.product_description,
-  sku.product_category_id,
-  sku.product_category_name,
-  sku.product_thumbnail_url,
-  sku.product_model_url,
-  sku.sku_id,
-  sku.sku_code,
-  sku.sku_business_key,
-  sku.sku_name,
-  sku.price,
-  sku.cost_price,
-  sku.stock,
-  sku.is_active,
-  sku.record_status,
-  sku.model_url,
-  sku.image_url,
-  sku.image_urls,
-  sku.source_pre_sku_id,
-  sku.source_asset_variant_id,
-  sku.source_asset_variant_ids,
-  sku.asset_family_code,
-  sku.asset_family_name,
-  sku.spec_code,
-  sku.spec_name,
-  sku.barcode,
-  sku.barcode_business_key,
-  sku.size_json,
-  sku.color,
-  sku.material,
-  sku.source_status,
-  sku.synced_at,
-  sku.warehouse_location_id,
-  sku.warehouse_location_code,
-  sku.warehouse_location_name,
-  stock.warehouse_zone,
-  stock.warehouse_aisle,
-  stock.warehouse_shelf,
-  stock.warehouse_bin,
-  stock.warehouse_location_is_active,
-  stock.warehouse_location_status,
-  COALESCE(limit_by_barcode.limit_price_applicable, limit_by_sku.limit_price_applicable, false) AS limit_price_applicable,
-  COALESCE(limit_by_barcode.limit_price_confirmed, limit_by_sku.limit_price_confirmed, false) AS limit_price_confirmed,
-  COALESCE(limit_by_barcode.limit_price_status, limit_by_sku.limit_price_status, 'NOT_APPLICABLE') AS limit_price_status,
-  COALESCE(limit_by_barcode.expected_daily_limit_price, limit_by_sku.expected_daily_limit_price) AS expected_daily_limit_price,
-  COALESCE(limit_by_barcode.expected_limit_gross_margin_rate, limit_by_sku.expected_limit_gross_margin_rate) AS expected_limit_gross_margin_rate,
-  COALESCE(limit_by_barcode.non_spu_owner_limit_price, limit_by_sku.non_spu_owner_limit_price) AS non_spu_owner_limit_price,
-  COALESCE(limit_by_barcode.limit_confirmed_at, limit_by_sku.limit_confirmed_at) AS limit_confirmed_at,
-  COALESCE(limit_by_barcode.limit_source_product_business_key, limit_by_sku.limit_source_product_business_key) AS limit_source_product_business_key,
-  COALESCE(limit_by_barcode.limit_source_sku_business_key, limit_by_sku.limit_source_sku_business_key) AS limit_source_sku_business_key,
-  CASE
-    WHEN sku.catalog_source = 'INTAKE_READY'
-    THEN CASE WHEN NULLIF(btrim(COALESCE(sku.image_url, '')), '') IS NOT NULL THEN 1 ELSE 0 END
-    ELSE COALESCE(asset_summary.image_asset_count, 0)
-  END AS image_asset_count,
-  CASE
-    WHEN sku.catalog_source = 'INTAKE_READY'
-    THEN CASE WHEN NULLIF(btrim(COALESCE(sku.model_url, '')), '') IS NOT NULL THEN 1 ELSE 0 END
-    ELSE COALESCE(asset_summary.model_asset_count, 0)
-  END AS model_asset_count,
-  CASE
-    WHEN sku.catalog_source = 'INTAKE_READY'
-    THEN CASE
-      WHEN COALESCE(
-        NULLIF(btrim(COALESCE(sku.product_thumbnail_url, '')), ''),
-        NULLIF(btrim(COALESCE(sku.image_url, '')), '')
-      ) IS NOT NULL
-      THEN 1
-      ELSE 0
-    END
-    ELSE COALESCE(asset_summary.thumbnail_asset_count, 0)
-  END AS thumbnail_asset_count,
-  COALESCE(
-    asset_summary.first_model_asset_url,
-    CASE
-      WHEN sku.catalog_source = 'INTAKE_READY'
-      THEN NULLIF(btrim(COALESCE(sku.model_url, '')), '')
-      ELSE NULL
-    END
-  ) AS first_model_asset_url,
-  COALESCE(
-    asset_summary.first_thumbnail_asset_url,
-    CASE
-      WHEN sku.catalog_source = 'INTAKE_READY'
-      THEN COALESCE(
-        NULLIF(btrim(COALESCE(sku.product_thumbnail_url, '')), ''),
-        NULLIF(btrim(COALESCE(sku.image_url, '')), '')
-      )
-      ELSE NULL
-    END
-  ) AS first_thumbnail_asset_url,
-  COALESCE(bom_summary.bom_item_count, 0) AS bom_item_count,
-  COALESCE(bom_summary.panel_item_count, 0) AS panel_item_count,
-  COALESCE(bom_summary.hardware_item_count, 0) AS hardware_item_count,
-  COALESCE(bom_summary.material_codes, ARRAY[]::text[]) AS material_codes,
-  COALESCE(bom_summary.material_names, ARRAY[]::text[]) AS material_names,
-  COALESCE(packaged_summary.packaged_item_count, 0) AS packaged_item_count,
-  COALESCE(packaged_summary.packaged_stock_quantity, 0) AS packaged_stock_quantity,
-  COALESCE(quality_summary.quality_record_count, 0) AS quality_record_count,
-  COALESCE(quality_summary.warehouse_quality_record_count, 0) AS warehouse_quality_record_count,
-  COALESCE(quality_summary.first_batch_quality_record_count, 0) AS first_batch_quality_record_count,
-  latest_quality.latest_quality_record_key,
-  latest_quality.latest_quality_source_type,
-  latest_quality.latest_quality_batch_no,
-  latest_quality.latest_quality_inspected_at,
-  latest_quality.latest_quality_conclusion,
-  latest_quality.latest_quality_status,
-  sku.created_at,
-  sku.updated_at,
-  sku.catalog_source
-FROM sku_source sku
-LEFT JOIN external.sku_warehouse_stock_v1 stock
-  ON stock.barcode_business_key = sku.barcode_business_key
-LEFT JOIN limit_by_sku
-  ON limit_by_sku.identity_value = upper(btrim(COALESCE(sku.sku_code, '')))
-LEFT JOIN limit_by_barcode
-  ON limit_by_barcode.identity_value = sku.barcode_business_key
-LEFT JOIN asset_summary
-  ON asset_summary.product_business_key = sku.product_business_key
- AND asset_summary.sku_business_key = sku.sku_business_key
-LEFT JOIN LATERAL (
-  SELECT
-    COUNT(*)::integer AS bom_item_count,
-    COUNT(*) FILTER (WHERE item_type = 'PANEL')::integer AS panel_item_count,
-    COUNT(*) FILTER (WHERE item_type = 'HARDWARE')::integer AS hardware_item_count,
-    array_remove(array_agg(DISTINCT material_code ORDER BY material_code), NULL) AS material_codes,
-    array_remove(array_agg(DISTINCT material_name ORDER BY material_name), NULL) AS material_names
-  FROM external.product_bom_v1 bom
-  WHERE bom.product_business_key = sku.product_business_key
-    AND (
-      bom.sku_business_key = sku.sku_business_key
-      OR bom.sku_business_key IS NULL
-    )
-) bom_summary ON true
-LEFT JOIN packaged_summary
-  ON packaged_summary.barcode_business_key = sku.barcode_business_key
-LEFT JOIN quality_summary
-  ON quality_summary.barcode_business_key = sku.barcode_business_key
-LEFT JOIN latest_quality
-  ON latest_quality.barcode_business_key = sku.barcode_business_key
-)
-SELECT DISTINCT ON (catalog_by_sku.barcode_business_key)
-  catalog_by_sku.*
-FROM catalog_by_sku
-WHERE catalog_by_sku.barcode_business_key IS NOT NULL
-  AND btrim(catalog_by_sku.barcode_business_key) <> ''
-ORDER BY
-  catalog_by_sku.barcode_business_key,
-  CASE WHEN catalog_by_sku.catalog_source IS NULL THEN 1
-       WHEN catalog_by_sku.catalog_source = 'FORMAL' THEN 0
-       ELSE 1 END,
-  catalog_by_sku.updated_at DESC NULLS LAST,
-  catalog_by_sku.created_at DESC;

furniture-3d-system/prisma/migrations/20260702143000_normalize_external_readonly_asset_urls/migration.sql

@@ -1,390 +0,0 @@
--- Normalize asset URLs exposed by external read-only views.
---
--- Business tables still store stable in-app object routes such as
--- /api/storage/object?key=... . External database consumers need complete
--- URLs, so the external contract layer prefixes relative application routes
--- with the current production site origin. The routes remain application
--- controlled; this migration does not expose private bucket objects directly.
-
-CREATE OR REPLACE FUNCTION external.to_external_asset_url(raw_value text)
-RETURNS text
-LANGUAGE sql
-STABLE
-AS $$
-WITH normalized AS (
-  SELECT NULLIF(btrim(raw_value), '') AS value
-),
-base_url AS (
-  SELECT COALESCE(
-    NULLIF(btrim(current_setting('app.external_asset_base_url', true)), ''),
-    NULLIF(btrim(current_setting('app.public_base_url', true)), ''),
-    'https://cp.jiansun.vip'
-  ) AS value
-)
-SELECT
-  CASE
-    WHEN normalized.value IS NULL THEN NULL
-    WHEN normalized.value ~* '^https?://(localhost|127\.0\.0\.1|\[::1\])(:[0-9]+)?/' THEN
-      regexp_replace(base_url.value, '/+$', '') ||
-      regexp_replace(
-        normalized.value,
-        '^https?://(localhost|127\.0\.0\.1|\[::1\])(:[0-9]+)?',
-        '',
-        'i'
-      )
-    WHEN normalized.value LIKE '/%' THEN regexp_replace(base_url.value, '/+$', '') || normalized.value
-    ELSE normalized.value
-  END
-FROM normalized, base_url;
-$$;
-
-CREATE OR REPLACE VIEW external.materials_v1 AS
-SELECT
-  m."id" AS material_id,
-  m."code" AS material_code,
-  m."name" AS material_name,
-  c."name" AS category_name,
-  external.to_external_asset_url(m."thumbnailUrl") AS thumbnail_url,
-  external.to_external_asset_url(m."textureUrl") AS texture_url,
-  external.to_external_asset_url(m."normalMapUrl") AS normal_map_url,
-  m."color" AS base_color,
-  m."metalness" AS metalness,
-  m."roughness" AS roughness,
-  m."opacity" AS opacity,
-  CASE WHEN m."isActive" THEN 'ACTIVE' ELSE 'INACTIVE' END AS record_status
-FROM "Material" m
-JOIN "MaterialCategory" c ON c."id" = m."categoryId";
-
-CREATE OR REPLACE VIEW external.asset_variants_v1 AS
-SELECT
-  v."id" AS asset_variant_id,
-  v."code" AS spec_code,
-  v."name" AS spec_name,
-  v."assetType"::text AS asset_type,
-  v."status"::text AS asset_status,
-  f."id" AS asset_family_id,
-  f."code" AS asset_family_code,
-  f."name" AS asset_family_name,
-  s."id" AS asset_series_id,
-  s."code" AS asset_series_code,
-  s."name" AS asset_series_name,
-  pc."id" AS product_category_id,
-  pc."name" AS product_category_name,
-  v."sizeLabel" AS size_label,
-  v."dimensions" AS dimensions,
-  external.to_external_asset_url(v."modelUrl") AS model_url,
-  external.to_external_asset_url(v."thumbnailUrl") AS thumbnail_url,
-  v."barcode" AS barcode,
-  v."supplierName" AS supplier_name,
-  v."supplierCode" AS supplier_code,
-  v."versionNo" AS version_no,
-  sub."id" AS substrate_id,
-  sub."name" AS substrate_name,
-  finish."id" AS finish_id,
-  finish."code" AS finish_code,
-  finish."name" AS finish_name,
-  CASE
-    WHEN sub."name" IS NOT NULL AND finish."name" IS NOT NULL THEN sub."name" || ' + ' || finish."name"
-    ELSE COALESCE(sub."name", finish."name")
-  END AS material_label,
-  v."weightKg" AS weight_kg,
-  v."costPrice" AS cost_price,
-  v."estimatedCostPrice" AS estimated_cost_price,
-  v."createdAt" AS created_at,
-  v."updatedAt" AS updated_at
-FROM "AssetVariant" v
-JOIN "AssetFamily" f ON f."id" = v."assetFamilyId"
-LEFT JOIN "AssetSeries" s ON s."id" = f."assetSeriesId"
-LEFT JOIN "ProductCategory" pc ON pc."id" = f."productCategoryId"
-LEFT JOIN "Substrate" sub ON sub."id" = v."substrateId"
-LEFT JOIN "Material" finish ON finish."id" = v."finishId"
-WHERE v."deletedAt" IS NULL;
-
-CREATE OR REPLACE VIEW external.product_skus_v1 AS
-SELECT
-  p."id" AS product_id,
-  p."modelNumber" AS product_model_number,
-  p."name" AS product_name,
-  p."description" AS product_description,
-  pc."id" AS product_category_id,
-  pc."name" AS product_category_name,
-  external.to_external_asset_url(p."thumbnailUrl") AS product_thumbnail_url,
-  external.to_external_asset_url(p."modelUrl") AS product_model_url,
-  sku."id" AS sku_id,
-  sku."skuCode" AS sku_code,
-  COALESCE(
-    NULLIF(sku."name", ''),
-    NULLIF(profile."specName", ''),
-    sku."skuCode"
-  ) AS sku_name,
-  sku."price" AS price,
-  sku."costPrice" AS cost_price,
-  sku."stock" AS stock,
-  sku."isActive" AS is_active,
-  CASE WHEN sku."isActive" THEN 'ACTIVE' ELSE 'INACTIVE' END AS record_status,
-  external.to_external_asset_url(
-    COALESCE(NULLIF(sku."modelUrl", ''), NULLIF(p."modelUrl", ''))
-  ) AS model_url,
-  external.to_external_asset_url(
-    COALESCE(
-      NULLIF(profile."imageUrl", ''),
-      sku."images"[1],
-      NULLIF(p."thumbnailUrl", '')
-    )
-  ) AS image_url,
-  ARRAY(
-    SELECT external.to_external_asset_url(image_item.image_url)
-    FROM unnest(sku."images") AS image_item(image_url)
-    WHERE NULLIF(btrim(image_item.image_url), '') IS NOT NULL
-  ) AS image_urls,
-  sku."sourcePreSkuId" AS source_pre_sku_id,
-  sku."sourceAssetVariantId" AS source_asset_variant_id,
-  sku."sourceAssetVariantIds" AS source_asset_variant_ids,
-  profile."model" AS asset_family_code,
-  profile."modelName" AS asset_family_name,
-  profile."specCode" AS spec_code,
-  profile."specName" AS spec_name,
-  profile."barcode" AS barcode,
-  profile."size" AS size_json,
-  profile."color" AS color,
-  profile."material" AS material,
-  profile."sourceStatus"::text AS source_status,
-  profile."syncedAt"::text AS synced_at,
-  wh."id" AS warehouse_location_id,
-  wh."code" AS warehouse_location_code,
-  wh."name" AS warehouse_location_name,
-  sku."createdAt" AS created_at,
-  sku."updatedAt" AS updated_at,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(p."modelNumber", '')), '') IS NOT NULL
-    THEN upper(btrim(p."modelNumber"))
-    ELSE NULL
-  END AS product_business_key,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(sku."skuCode", '')), '') IS NOT NULL
-    THEN upper(btrim(sku."skuCode"))
-    ELSE NULL
-  END AS sku_business_key,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(profile."barcode", '')), '') IS NOT NULL
-    THEN upper(btrim(profile."barcode"))
-    ELSE NULL
-  END AS barcode_business_key
-FROM "ProductSKU" sku
-JOIN "Product" p ON p."id" = sku."productId"
-LEFT JOIN "ProductSkuAssetProfile" profile ON profile."skuId" = sku."id"
-LEFT JOIN "ProductCategory" pc ON pc."id" = p."categoryId"
-LEFT JOIN "WarehouseLocation" wh ON wh."id" = sku."warehouseLocationId"
-WHERE p."deletedAt" IS NULL
-  AND sku."deletedAt" IS NULL;
-
-CREATE OR REPLACE VIEW external.product_assets_v1 AS
-WITH image_assets AS (
-  SELECT
-    sku."id" AS sku_id,
-    sku."productId" AS product_id,
-    p."modelNumber" AS product_model_number,
-    sku."skuCode" AS sku_code,
-    profile."barcode" AS barcode,
-    image_item.image_url,
-    image_item.sort_order
-  FROM "ProductSKU" sku
-  JOIN "Product" p ON p."id" = sku."productId"
-  LEFT JOIN "ProductSkuAssetProfile" profile ON profile."skuId" = sku."id"
-  CROSS JOIN LATERAL unnest(sku."images") WITH ORDINALITY AS image_item(image_url, sort_order)
-  WHERE p."deletedAt" IS NULL
-    AND sku."deletedAt" IS NULL
-),
-model_assets AS (
-  SELECT
-    sku."id" AS sku_id,
-    sku."productId" AS product_id,
-    p."modelNumber" AS product_model_number,
-    sku."skuCode" AS sku_code,
-    profile."barcode" AS barcode,
-    COALESCE(NULLIF(sku."modelUrl", ''), NULLIF(p."modelUrl", '')) AS model_url
-  FROM "ProductSKU" sku
-  JOIN "Product" p ON p."id" = sku."productId"
-  LEFT JOIN "ProductSkuAssetProfile" profile ON profile."skuId" = sku."id"
-  WHERE p."deletedAt" IS NULL
-    AND sku."deletedAt" IS NULL
-),
-thumbnail_assets AS (
-  SELECT
-    sku."id" AS sku_id,
-    sku."productId" AS product_id,
-    p."modelNumber" AS product_model_number,
-    sku."skuCode" AS sku_code,
-    profile."barcode" AS barcode,
-    COALESCE(
-      NULLIF(profile."imageUrl", ''),
-      NULLIF(p."thumbnailUrl", '')
-    ) AS thumbnail_url
-  FROM "ProductSKU" sku
-  JOIN "Product" p ON p."id" = sku."productId"
-  LEFT JOIN "ProductSkuAssetProfile" profile ON profile."skuId" = sku."id"
-  WHERE p."deletedAt" IS NULL
-    AND sku."deletedAt" IS NULL
-)
-SELECT
-  'SKU_IMAGE' AS asset_type,
-  product_id,
-  sku_id,
-  external.to_external_asset_url(image_url) AS asset_url,
-  NULL::text AS file_name,
-  NULL::text AS mime_type,
-  sort_order::integer AS sort_order,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(product_model_number, '')), '') IS NOT NULL
-    THEN upper(btrim(product_model_number))
-    ELSE NULL
-  END AS product_business_key,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(sku_code, '')), '') IS NOT NULL
-    THEN upper(btrim(sku_code))
-    ELSE NULL
-  END AS sku_business_key,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(barcode, '')), '') IS NOT NULL
-    THEN upper(btrim(barcode))
-    ELSE NULL
-  END AS barcode_business_key
-FROM image_assets
-WHERE NULLIF(image_url, '') IS NOT NULL
-UNION ALL
-SELECT
-  'SKU_MODEL' AS asset_type,
-  product_id,
-  sku_id,
-  external.to_external_asset_url(model_url) AS asset_url,
-  NULL::text AS file_name,
-  NULL::text AS mime_type,
-  0 AS sort_order,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(product_model_number, '')), '') IS NOT NULL
-    THEN upper(btrim(product_model_number))
-    ELSE NULL
-  END AS product_business_key,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(sku_code, '')), '') IS NOT NULL
-    THEN upper(btrim(sku_code))
-    ELSE NULL
-  END AS sku_business_key,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(barcode, '')), '') IS NOT NULL
-    THEN upper(btrim(barcode))
-    ELSE NULL
-  END AS barcode_business_key
-FROM model_assets
-WHERE NULLIF(model_url, '') IS NOT NULL
-UNION ALL
-SELECT
-  'SKU_THUMBNAIL' AS asset_type,
-  product_id,
-  sku_id,
-  external.to_external_asset_url(thumbnail_url) AS asset_url,
-  NULL::text AS file_name,
-  NULL::text AS mime_type,
-  0 AS sort_order,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(product_model_number, '')), '') IS NOT NULL
-    THEN upper(btrim(product_model_number))
-    ELSE NULL
-  END AS product_business_key,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(sku_code, '')), '') IS NOT NULL
-    THEN upper(btrim(sku_code))
-    ELSE NULL
-  END AS sku_business_key,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(barcode, '')), '') IS NOT NULL
-    THEN upper(btrim(barcode))
-    ELSE NULL
-  END AS barcode_business_key
-FROM thumbnail_assets
-WHERE NULLIF(thumbnail_url, '') IS NOT NULL;
-
-CREATE OR REPLACE VIEW external.intake_products_v1 AS
-SELECT
-  product."id" AS intake_product_id,
-  product."spu" AS spu,
-  product."spuBase" AS spu_base,
-  product."brand" AS brand,
-  profile."productName" AS product_name,
-  external.to_external_asset_url(profile."productImageUrl") AS product_image_url,
-  profile."productCategory" AS product_category,
-  profile."salesCategory" AS sales_category,
-  profile."productYear" AS product_year,
-  profile."productStatus" AS product_status,
-  COALESCE(NULLIF(profile."structureDesigner", ''), NULLIF(product."designer", '')) AS designer,
-  COALESCE(NULLIF(profile."productPlanning", ''), NULLIF(product."operator", '')) AS operator,
-  COALESCE(NULLIF(profile."purchaseOwner", ''), NULLIF(product."purchaser", '')) AS purchaser,
-  profile."productDevelopmentKind" AS product_development_kind,
-  profile."goodsType" AS goods_type,
-  profile."materialType" AS material_type,
-  profile."productionType" AS production_type,
-  product."createdAt" AS created_at,
-  product."updatedAt" AS updated_at,
-  profile."productPlanning" AS product_planning,
-  profile."visualPlanning" AS visual_planning,
-  profile."structureDesigner" AS structure_designer,
-  profile."purchaseOwner" AS purchase_owner,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(product."brand", '')), '') IS NOT NULL
-      AND NULLIF(btrim(COALESCE(product."spu", '')), '') IS NOT NULL
-    THEN upper(btrim(product."brand")) || ':' || upper(btrim(product."spu"))
-    ELSE NULL
-  END AS product_business_key
-FROM "IntakeNonIntegratedProduct" product
-LEFT JOIN "IntakeNonIntegratedProductProfile" profile ON profile."productId" = product."id"
-WHERE product."deletedAt" IS NULL;
-
-CREATE OR REPLACE VIEW external.intake_sku_items_v1 AS
-SELECT
-  product."id" AS intake_product_id,
-  product."spu" AS spu,
-  product."brand" AS brand,
-  sku."skuItemId" AS intake_sku_item_id,
-  sku."skuSequence" AS sku_sequence,
-  sku."batchNo" AS batch_no,
-  external.to_external_asset_url(sku."image") AS image_url,
-  sku."imageName" AS image_name,
-  sku."model" AS model,
-  sku."skuCode" AS sku_code,
-  sku."specName" AS spec_name,
-  sku."barcode" AS barcode,
-  sku."size" AS size,
-  sku."color" AS color,
-  sku."material" AS material,
-  sku."versionNo" AS version_no,
-  sku."attributeCode" AS attribute_code,
-  sku."drawingId" AS drawing_id,
-  sku."installMethod" AS install_method,
-  sku."executeStandard" AS execute_standard,
-  sku."manufacturer" AS manufacturer,
-  sku."manufacturerCode" AS manufacturer_code,
-  sku."salesStatus" AS sales_status,
-  external.to_external_asset_url(sku."model3dDataUrl") AS model_3d_url,
-  sku."source" AS source,
-  sku."sourceTable" AS source_table,
-  sku."sourceSkuId" AS source_sku_id,
-  sku."missingRequiredFields" AS missing_required_fields,
-  sku."dataQualityStatus"::text AS data_quality_status,
-  sku."contentLocked" AS content_locked,
-  sku."sortOrder" AS sort_order,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(product."brand", '')), '') IS NOT NULL
-      AND NULLIF(btrim(COALESCE(product."spu", '')), '') IS NOT NULL
-    THEN upper(btrim(product."brand")) || ':' || upper(btrim(product."spu"))
-    ELSE NULL
-  END AS product_business_key,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(product."brand", '')), '') IS NOT NULL
-      AND NULLIF(btrim(COALESCE(product."spu", '')), '') IS NOT NULL
-      AND NULLIF(btrim(COALESCE(sku."skuCode", '')), '') IS NOT NULL
-    THEN upper(btrim(product."brand")) || ':' || upper(btrim(product."spu")) || ':' || upper(btrim(sku."skuCode"))
-    ELSE NULL
-  END AS sku_business_key
-FROM "IntakeNonIntegratedSkuItem" sku
-JOIN "IntakeNonIntegratedProduct" product ON product."id" = sku."productId"
-WHERE product."deletedAt" IS NULL;

furniture-3d-system/prisma/migrations/20260703110000_add_development_people_to_external_catalog_wide/migration.sql

@@ -1,510 +0,0 @@
--- Add explicit development-owner columns to the external catalog wide view.
---
--- The external main entry remains external.product_catalog_wide_v1. The new
--- columns mirror the product-development list people fields and are appended to
--- the existing wide view so current consumers keep their column order.
-
-CREATE OR REPLACE VIEW external.intake_products_v1 AS
-SELECT
-  product."id" AS intake_product_id,
-  product."spu" AS spu,
-  product."spuBase" AS spu_base,
-  product."brand" AS brand,
-  profile."productName" AS product_name,
-  external.to_external_asset_url(profile."productImageUrl") AS product_image_url,
-  profile."productCategory" AS product_category,
-  profile."salesCategory" AS sales_category,
-  profile."productYear" AS product_year,
-  profile."productStatus" AS product_status,
-  COALESCE(NULLIF(profile."structureDesigner", ''), NULLIF(product."designer", '')) AS designer,
-  COALESCE(NULLIF(profile."productPlanning", ''), NULLIF(product."operator", '')) AS operator,
-  COALESCE(NULLIF(profile."purchaseOwner", ''), NULLIF(product."purchaser", '')) AS purchaser,
-  profile."productDevelopmentKind" AS product_development_kind,
-  profile."goodsType" AS goods_type,
-  profile."materialType" AS material_type,
-  profile."productionType" AS production_type,
-  product."createdAt" AS created_at,
-  product."updatedAt" AS updated_at,
-  profile."productPlanning" AS product_planning,
-  profile."visualPlanning" AS visual_planning,
-  profile."structureDesigner" AS structure_designer,
-  profile."purchaseOwner" AS purchase_owner,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(product."brand", '')), '') IS NOT NULL
-      AND NULLIF(btrim(COALESCE(product."spu", '')), '') IS NOT NULL
-    THEN upper(btrim(product."brand")) || ':' || upper(btrim(product."spu"))
-    ELSE NULL
-  END AS product_business_key,
-  NULLIF(btrim(COALESCE(product."designer", '')), '') AS appearance_designer,
-  COALESCE(
-    NULLIF(btrim(COALESCE(profile."spuOwner", '')), ''),
-    NULLIF(btrim(COALESCE(product."operator", '')), ''),
-    NULLIF(btrim(COALESCE(profile."operationsOwner", '')), '')
-  ) AS spu_owner,
-  NULLIF(btrim(COALESCE(profile."productPlanning", '')), '') AS planning_owner,
-  COALESCE(
-    NULLIF(btrim(COALESCE(profile."visualPlanning", '')), ''),
-    NULLIF(btrim(COALESCE(profile."visualDirector", '')), '')
-  ) AS space_designer
-FROM "IntakeNonIntegratedProduct" product
-LEFT JOIN "IntakeNonIntegratedProductProfile" profile ON profile."productId" = product."id"
-WHERE product."deletedAt" IS NULL;
-
-CREATE OR REPLACE VIEW external.intake_products_ready_v1 AS
-SELECT *
-FROM external.intake_products_v1
-WHERE NULLIF(btrim(COALESCE(product_name, '')), '') IS NOT NULL
-  AND NULLIF(btrim(COALESCE(product_category, '')), '') IS NOT NULL
-  AND NULLIF(btrim(COALESCE(product_development_kind, '')), '') IS NOT NULL
-  AND NULLIF(btrim(COALESCE(product_business_key, '')), '') IS NOT NULL;
-
-CREATE OR REPLACE VIEW external.product_catalog_wide_v1 AS
-WITH formal_sku_source AS (
-  SELECT
-    sku.product_id,
-    sku.product_model_number,
-    sku.product_name,
-    sku.product_description,
-    sku.product_category_id,
-    sku.product_category_name,
-    sku.product_thumbnail_url,
-    sku.product_model_url,
-    sku.sku_id,
-    sku.sku_code,
-    sku.sku_name,
-    sku.price,
-    sku.cost_price,
-    sku.stock,
-    sku.is_active,
-    sku.record_status,
-    sku.model_url,
-    sku.image_url,
-    sku.image_urls,
-    sku.source_pre_sku_id,
-    sku.source_asset_variant_id,
-    sku.source_asset_variant_ids,
-    sku.asset_family_code,
-    sku.asset_family_name,
-    sku.spec_code,
-    sku.spec_name,
-    sku.barcode,
-    sku.size_json,
-    sku.color,
-    sku.material,
-    sku.source_status,
-    sku.synced_at,
-    sku.warehouse_location_id,
-    sku.warehouse_location_code,
-    sku.warehouse_location_name,
-    sku.created_at,
-    sku.updated_at,
-    sku.product_business_key,
-    sku.sku_business_key,
-    sku.barcode_business_key,
-    'FORMAL'::text AS catalog_source,
-    NULL::text AS appearance_designer,
-    NULL::text AS structure_designer,
-    NULL::text AS spu_owner,
-    NULL::text AS planning_owner,
-    NULL::text AS space_designer,
-    NULL::text AS purchase_owner
-  FROM external.product_skus_v1 sku
-),
-formal_identity_map AS (
-  SELECT
-    barcode_business_key,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku_code, '')), '') IS NOT NULL
-      THEN upper(btrim(sku_code))
-      ELSE NULL
-    END AS normalized_sku_code
-  FROM formal_sku_source
-),
-intake_ready_sku_source AS (
-  SELECT
-    product.intake_product_id AS product_id,
-    NULLIF(btrim(COALESCE(product.spu, '')), '') AS product_model_number,
-    NULLIF(btrim(COALESCE(product.product_name, '')), '') AS product_name,
-    NULL::text AS product_description,
-    NULL::text AS product_category_id,
-    NULLIF(btrim(COALESCE(product.product_category, '')), '') AS product_category_name,
-    COALESCE(
-      NULLIF(btrim(COALESCE(product.product_image_url, '')), ''),
-      NULLIF(btrim(COALESCE(sku.image_url, '')), '')
-    ) AS product_thumbnail_url,
-    NULL::text AS product_model_url,
-    sku.intake_sku_item_id AS sku_id,
-    NULLIF(btrim(COALESCE(sku.sku_code, '')), '') AS sku_code,
-    COALESCE(
-      NULLIF(btrim(COALESCE(sku.spec_name, '')), ''),
-      NULLIF(btrim(COALESCE(sku.sku_code, '')), '')
-    ) AS sku_name,
-    NULL::numeric(10,2) AS price,
-    NULL::numeric(10,2) AS cost_price,
-    0::integer AS stock,
-    true AS is_active,
-    'ACTIVE'::text AS record_status,
-    NULLIF(btrim(COALESCE(sku.model_3d_url, '')), '') AS model_url,
-    COALESCE(
-      NULLIF(btrim(COALESCE(sku.image_url, '')), ''),
-      NULLIF(btrim(COALESCE(product.product_image_url, '')), '')
-    ) AS image_url,
-    CASE
-      WHEN COALESCE(
-        NULLIF(btrim(COALESCE(sku.image_url, '')), ''),
-        NULLIF(btrim(COALESCE(product.product_image_url, '')), '')
-      ) IS NOT NULL
-      THEN ARRAY[
-        COALESCE(
-          NULLIF(btrim(COALESCE(sku.image_url, '')), ''),
-          NULLIF(btrim(COALESCE(product.product_image_url, '')), '')
-        )
-      ]
-      ELSE ARRAY[]::text[]
-    END AS image_urls,
-    NULL::text AS source_pre_sku_id,
-    NULL::text AS source_asset_variant_id,
-    ARRAY[]::text[] AS source_asset_variant_ids,
-    NULLIF(btrim(COALESCE(sku.model, '')), '') AS asset_family_code,
-    NULL::text AS asset_family_name,
-    NULLIF(btrim(COALESCE(sku.attribute_code, '')), '') AS spec_code,
-    NULLIF(btrim(COALESCE(sku.spec_name, '')), '') AS spec_name,
-    NULLIF(btrim(COALESCE(sku.barcode, '')), '') AS barcode,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku.size, '')), '') IS NOT NULL
-      THEN jsonb_build_object('label', btrim(sku.size))
-      ELSE NULL::jsonb
-    END AS size_json,
-    NULLIF(btrim(COALESCE(sku.color, '')), '') AS color,
-    NULLIF(btrim(COALESCE(sku.material, '')), '') AS material,
-    NULL::text AS source_status,
-    NULL::text AS synced_at,
-    NULL::text AS warehouse_location_id,
-    NULL::text AS warehouse_location_code,
-    NULL::text AS warehouse_location_name,
-    product.created_at AS created_at,
-    product.updated_at AS updated_at,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(product.spu, '')), '') IS NOT NULL
-      THEN upper(btrim(product.spu))
-      ELSE NULL
-    END AS product_business_key,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku.sku_code, '')), '') IS NOT NULL
-      THEN upper(btrim(sku.sku_code))
-      ELSE NULL
-    END AS sku_business_key,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku.barcode, '')), '') IS NOT NULL
-      THEN upper(btrim(sku.barcode))
-      ELSE NULL
-    END AS barcode_business_key,
-    'INTAKE_READY'::text AS catalog_source,
-    product.appearance_designer,
-    product.structure_designer,
-    product.spu_owner,
-    product.planning_owner,
-    product.space_designer,
-    product.purchase_owner
-  FROM external.intake_sku_items_ready_v1 sku
-  JOIN external.intake_products_ready_v1 product
-    ON product.intake_product_id = sku.intake_product_id
-  WHERE NOT EXISTS (
-    SELECT 1
-    FROM formal_identity_map formal
-    WHERE (
-      NULLIF(btrim(COALESCE(sku.barcode, '')), '') IS NOT NULL
-      AND formal.barcode_business_key = upper(btrim(sku.barcode))
-    )
-    OR (
-      NULLIF(btrim(COALESCE(sku.barcode, '')), '') IS NULL
-      AND NULLIF(btrim(COALESCE(sku.sku_code, '')), '') IS NOT NULL
-      AND formal.normalized_sku_code = upper(btrim(sku.sku_code))
-    )
-  )
-),
-sku_source AS (
-  SELECT * FROM formal_sku_source
-  UNION ALL
-  SELECT * FROM intake_ready_sku_source
-),
-asset_summary AS (
-  SELECT
-    product_business_key,
-    sku_business_key,
-    COUNT(*) FILTER (WHERE asset_type = 'SKU_IMAGE')::integer AS image_asset_count,
-    COUNT(*) FILTER (WHERE asset_type = 'SKU_MODEL')::integer AS model_asset_count,
-    COUNT(*) FILTER (WHERE asset_type = 'SKU_THUMBNAIL')::integer AS thumbnail_asset_count,
-    MIN(asset_url) FILTER (WHERE asset_type = 'SKU_MODEL') AS first_model_asset_url,
-    MIN(asset_url) FILTER (WHERE asset_type = 'SKU_THUMBNAIL') AS first_thumbnail_asset_url
-  FROM external.product_assets_v1
-  GROUP BY product_business_key, sku_business_key
-),
-packaged_summary AS (
-  SELECT
-    barcode_business_key,
-    COUNT(*)::integer AS packaged_item_count,
-    COALESCE(SUM(stock_quantity), 0)::integer AS packaged_stock_quantity
-  FROM external.packaged_items_v1
-  WHERE NULLIF(barcode_business_key, '') IS NOT NULL
-  GROUP BY barcode_business_key
-),
-quality_summary AS (
-  SELECT
-    barcode_business_key,
-    COUNT(*)::integer AS quality_record_count,
-    COUNT(*) FILTER (WHERE source_type = 'WAREHOUSE')::integer AS warehouse_quality_record_count,
-    COUNT(*) FILTER (WHERE source_type = 'FIRST_BATCH')::integer AS first_batch_quality_record_count
-  FROM external.sku_quality_inspections_v1
-  WHERE NULLIF(barcode_business_key, '') IS NOT NULL
-  GROUP BY barcode_business_key
-),
-latest_quality AS (
-  SELECT DISTINCT ON (barcode_business_key)
-    barcode_business_key,
-    record_key AS latest_quality_record_key,
-    source_type AS latest_quality_source_type,
-    batch_no AS latest_quality_batch_no,
-    inspected_at AS latest_quality_inspected_at,
-    conclusion AS latest_quality_conclusion,
-    status AS latest_quality_status
-  FROM external.sku_quality_inspections_v1
-  WHERE NULLIF(barcode_business_key, '') IS NOT NULL
-  ORDER BY barcode_business_key, COALESCE(inspected_at, updated_at, created_at) DESC, created_at DESC
-),
-limit_by_barcode AS (
-  SELECT DISTINCT ON (identity_value)
-    identity_value,
-    product_business_key AS limit_source_product_business_key,
-    sku_business_key AS limit_source_sku_business_key,
-    limit_price_applicable,
-    limit_price_confirmed,
-    limit_price_status,
-    expected_daily_limit_price,
-    expected_limit_gross_margin_rate,
-    non_spu_owner_limit_price,
-    limit_confirmed_at
-  FROM (
-    SELECT
-      upper(btrim(barcode)) AS identity_value,
-      product_business_key,
-      sku_business_key,
-      limit_price_applicable,
-      limit_price_confirmed,
-      limit_price_status,
-      expected_daily_limit_price,
-      expected_limit_gross_margin_rate,
-      non_spu_owner_limit_price,
-      limit_confirmed_at,
-      updated_at
-    FROM external.intake_product_limits_v1
-    WHERE NULLIF(btrim(COALESCE(barcode, '')), '') IS NOT NULL
-  ) limit_rows
-  WHERE NULLIF(identity_value, '') IS NOT NULL
-  ORDER BY
-    identity_value,
-    limit_price_applicable DESC,
-    limit_price_confirmed DESC,
-    limit_confirmed_at DESC NULLS LAST,
-    updated_at DESC
-),
-limit_by_sku AS (
-  SELECT DISTINCT ON (identity_value)
-    identity_value,
-    product_business_key AS limit_source_product_business_key,
-    sku_business_key AS limit_source_sku_business_key,
-    limit_price_applicable,
-    limit_price_confirmed,
-    limit_price_status,
-    expected_daily_limit_price,
-    expected_limit_gross_margin_rate,
-    non_spu_owner_limit_price,
-    limit_confirmed_at
-  FROM (
-    SELECT
-      upper(btrim(sku_code)) AS identity_value,
-      product_business_key,
-      sku_business_key,
-      limit_price_applicable,
-      limit_price_confirmed,
-      limit_price_status,
-      expected_daily_limit_price,
-      expected_limit_gross_margin_rate,
-      non_spu_owner_limit_price,
-      limit_confirmed_at,
-      updated_at
-    FROM external.intake_product_limits_v1
-    WHERE NULLIF(btrim(COALESCE(sku_code, '')), '') IS NOT NULL
-  ) limit_rows
-  WHERE NULLIF(identity_value, '') IS NOT NULL
-  ORDER BY
-    identity_value,
-    limit_price_applicable DESC,
-    limit_price_confirmed DESC,
-    limit_confirmed_at DESC NULLS LAST,
-    updated_at DESC
-),
-catalog_by_sku AS (
-SELECT
-  sku.product_id,
-  sku.product_model_number,
-  sku.product_business_key,
-  sku.product_name,
-  sku.product_description,
-  sku.product_category_id,
-  sku.product_category_name,
-  sku.product_thumbnail_url,
-  sku.product_model_url,
-  sku.sku_id,
-  sku.sku_code,
-  sku.sku_business_key,
-  sku.sku_name,
-  sku.price,
-  sku.cost_price,
-  sku.stock,
-  sku.is_active,
-  sku.record_status,
-  sku.model_url,
-  sku.image_url,
-  sku.image_urls,
-  sku.source_pre_sku_id,
-  sku.source_asset_variant_id,
-  sku.source_asset_variant_ids,
-  sku.asset_family_code,
-  sku.asset_family_name,
-  sku.spec_code,
-  sku.spec_name,
-  sku.barcode,
-  sku.barcode_business_key,
-  sku.size_json,
-  sku.color,
-  sku.material,
-  sku.source_status,
-  sku.synced_at,
-  sku.warehouse_location_id,
-  sku.warehouse_location_code,
-  sku.warehouse_location_name,
-  stock.warehouse_zone,
-  stock.warehouse_aisle,
-  stock.warehouse_shelf,
-  stock.warehouse_bin,
-  stock.warehouse_location_is_active,
-  stock.warehouse_location_status,
-  COALESCE(limit_by_barcode.limit_price_applicable, limit_by_sku.limit_price_applicable, false) AS limit_price_applicable,
-  COALESCE(limit_by_barcode.limit_price_confirmed, limit_by_sku.limit_price_confirmed, false) AS limit_price_confirmed,
-  COALESCE(limit_by_barcode.limit_price_status, limit_by_sku.limit_price_status, 'NOT_APPLICABLE') AS limit_price_status,
-  COALESCE(limit_by_barcode.expected_daily_limit_price, limit_by_sku.expected_daily_limit_price) AS expected_daily_limit_price,
-  COALESCE(limit_by_barcode.expected_limit_gross_margin_rate, limit_by_sku.expected_limit_gross_margin_rate) AS expected_limit_gross_margin_rate,
-  COALESCE(limit_by_barcode.non_spu_owner_limit_price, limit_by_sku.non_spu_owner_limit_price) AS non_spu_owner_limit_price,
-  COALESCE(limit_by_barcode.limit_confirmed_at, limit_by_sku.limit_confirmed_at) AS limit_confirmed_at,
-  COALESCE(limit_by_barcode.limit_source_product_business_key, limit_by_sku.limit_source_product_business_key) AS limit_source_product_business_key,
-  COALESCE(limit_by_barcode.limit_source_sku_business_key, limit_by_sku.limit_source_sku_business_key) AS limit_source_sku_business_key,
-  CASE
-    WHEN sku.catalog_source = 'INTAKE_READY'
-    THEN CASE WHEN NULLIF(btrim(COALESCE(sku.image_url, '')), '') IS NOT NULL THEN 1 ELSE 0 END
-    ELSE COALESCE(asset_summary.image_asset_count, 0)
-  END AS image_asset_count,
-  CASE
-    WHEN sku.catalog_source = 'INTAKE_READY'
-    THEN CASE WHEN NULLIF(btrim(COALESCE(sku.model_url, '')), '') IS NOT NULL THEN 1 ELSE 0 END
-    ELSE COALESCE(asset_summary.model_asset_count, 0)
-  END AS model_asset_count,
-  CASE
-    WHEN sku.catalog_source = 'INTAKE_READY'
-    THEN CASE
-      WHEN COALESCE(
-        NULLIF(btrim(COALESCE(sku.product_thumbnail_url, '')), ''),
-        NULLIF(btrim(COALESCE(sku.image_url, '')), '')
-      ) IS NOT NULL
-      THEN 1
-      ELSE 0
-    END
-    ELSE COALESCE(asset_summary.thumbnail_asset_count, 0)
-  END AS thumbnail_asset_count,
-  COALESCE(
-    asset_summary.first_model_asset_url,
-    CASE
-      WHEN sku.catalog_source = 'INTAKE_READY'
-      THEN NULLIF(btrim(COALESCE(sku.model_url, '')), '')
-      ELSE NULL
-    END
-  ) AS first_model_asset_url,
-  COALESCE(
-    asset_summary.first_thumbnail_asset_url,
-    CASE
-      WHEN sku.catalog_source = 'INTAKE_READY'
-      THEN COALESCE(
-        NULLIF(btrim(COALESCE(sku.product_thumbnail_url, '')), ''),
-        NULLIF(btrim(COALESCE(sku.image_url, '')), '')
-      )
-      ELSE NULL
-    END
-  ) AS first_thumbnail_asset_url,
-  COALESCE(bom_summary.bom_item_count, 0) AS bom_item_count,
-  COALESCE(bom_summary.panel_item_count, 0) AS panel_item_count,
-  COALESCE(bom_summary.hardware_item_count, 0) AS hardware_item_count,
-  COALESCE(bom_summary.material_codes, ARRAY[]::text[]) AS material_codes,
-  COALESCE(bom_summary.material_names, ARRAY[]::text[]) AS material_names,
-  COALESCE(packaged_summary.packaged_item_count, 0) AS packaged_item_count,
-  COALESCE(packaged_summary.packaged_stock_quantity, 0) AS packaged_stock_quantity,
-  COALESCE(quality_summary.quality_record_count, 0) AS quality_record_count,
-  COALESCE(quality_summary.warehouse_quality_record_count, 0) AS warehouse_quality_record_count,
-  COALESCE(quality_summary.first_batch_quality_record_count, 0) AS first_batch_quality_record_count,
-  latest_quality.latest_quality_record_key,
-  latest_quality.latest_quality_source_type,
-  latest_quality.latest_quality_batch_no,
-  latest_quality.latest_quality_inspected_at,
-  latest_quality.latest_quality_conclusion,
-  latest_quality.latest_quality_status,
-  sku.created_at,
-  sku.updated_at,
-  sku.catalog_source,
-  sku.appearance_designer,
-  sku.structure_designer,
-  sku.spu_owner,
-  sku.planning_owner,
-  sku.space_designer,
-  sku.purchase_owner
-FROM sku_source sku
-LEFT JOIN external.sku_warehouse_stock_v1 stock
-  ON stock.barcode_business_key = sku.barcode_business_key
-LEFT JOIN limit_by_sku
-  ON limit_by_sku.identity_value = upper(btrim(COALESCE(sku.sku_code, '')))
-LEFT JOIN limit_by_barcode
-  ON limit_by_barcode.identity_value = sku.barcode_business_key
-LEFT JOIN asset_summary
-  ON asset_summary.product_business_key = sku.product_business_key
- AND asset_summary.sku_business_key = sku.sku_business_key
-LEFT JOIN LATERAL (
-  SELECT
-    COUNT(*)::integer AS bom_item_count,
-    COUNT(*) FILTER (WHERE item_type = 'PANEL')::integer AS panel_item_count,
-    COUNT(*) FILTER (WHERE item_type = 'HARDWARE')::integer AS hardware_item_count,
-    array_remove(array_agg(DISTINCT material_code ORDER BY material_code), NULL) AS material_codes,
-    array_remove(array_agg(DISTINCT material_name ORDER BY material_name), NULL) AS material_names
-  FROM external.product_bom_v1 bom
-  WHERE bom.product_business_key = sku.product_business_key
-    AND (
-      bom.sku_business_key = sku.sku_business_key
-      OR bom.sku_business_key IS NULL
-    )
-) bom_summary ON true
-LEFT JOIN packaged_summary
-  ON packaged_summary.barcode_business_key = sku.barcode_business_key
-LEFT JOIN quality_summary
-  ON quality_summary.barcode_business_key = sku.barcode_business_key
-LEFT JOIN latest_quality
-  ON latest_quality.barcode_business_key = sku.barcode_business_key
-)
-SELECT DISTINCT ON (catalog_by_sku.barcode_business_key)
-  catalog_by_sku.*
-FROM catalog_by_sku
-WHERE catalog_by_sku.barcode_business_key IS NOT NULL
-  AND btrim(catalog_by_sku.barcode_business_key) <> ''
-ORDER BY
-  catalog_by_sku.barcode_business_key,
-  CASE WHEN catalog_by_sku.catalog_source IS NULL THEN 1
-       WHEN catalog_by_sku.catalog_source = 'FORMAL' THEN 0
-       ELSE 1 END,
-  catalog_by_sku.updated_at DESC NULLS LAST,
-  catalog_by_sku.created_at DESC;

furniture-3d-system/prisma/migrations/20260710025000_add_installation_demo_config/migration.sql

@@ -1,16 +0,0 @@
-CREATE TABLE "InstallationDemoConfig" (
-  "id" TEXT NOT NULL,
-  "drawingId" TEXT NOT NULL,
-  "parts" JSONB NOT NULL,
-  "steps" JSONB NOT NULL,
-  "numbering" JSONB,
-  "uploadedModel" JSONB,
-  "explodeTemplate" JSONB,
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-
-  CONSTRAINT "InstallationDemoConfig_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "InstallationDemoConfig_drawingId_key"
-  ON "InstallationDemoConfig"("drawingId");

furniture-3d-system/prisma/migrations/20260710100000_add_intake_sku_flow_owner/migration.sql

@@ -1,26 +0,0 @@
-ALTER TABLE "IntakeNonIntegratedSkuItem"
-ADD COLUMN "demandFlowNo" TEXT NOT NULL DEFAULT '',
-ADD COLUMN "purchaseOwner" TEXT NOT NULL DEFAULT '';
-
-UPDATE "IntakeNonIntegratedSkuItem" AS sku
-SET
-  "demandFlowNo" = COALESCE(
-    NULLIF(BTRIM(product."payload" -> 'skuBatchFlowNos' ->> sku."batchNo"::text), ''),
-    NULLIF(BTRIM(profile."demandFlowNo"), ''),
-    ''
-  ),
-  "purchaseOwner" = COALESCE(
-    NULLIF(BTRIM(profile."purchaseOwner"), ''),
-    NULLIF(BTRIM(product."purchaser"), ''),
-    ''
-  )
-FROM "IntakeNonIntegratedProduct" AS product
-LEFT JOIN "IntakeNonIntegratedProductProfile" AS profile
-  ON profile."productId" = product."id"
-WHERE sku."productId" = product."id";
-
-CREATE INDEX "IntakeNonIntegratedSkuItem_productId_purchaseOwner_idx"
-ON "IntakeNonIntegratedSkuItem"("productId", "purchaseOwner");
-
-CREATE INDEX "IntakeNonIntegratedSkuItem_demandFlowNo_idx"
-ON "IntakeNonIntegratedSkuItem"("demandFlowNo");

furniture-3d-system/prisma/migrations/20260710101500_align_replay_updated_at_defaults/migration.sql

@@ -1,12 +0,0 @@
--- Prisma @updatedAt columns are maintained by application writes, not by a
--- database default. Align fresh migration replay with the current schema and
--- the existing local database.
-
-ALTER TABLE "AiRenderWorkbenchSku"
-  ALTER COLUMN "updatedAt" DROP DEFAULT;
-
-ALTER TABLE "AiRenderWorkbenchSpu"
-  ALTER COLUMN "updatedAt" DROP DEFAULT;
-
-ALTER TABLE "BarcodePrintImportRecord"
-  ALTER COLUMN "updatedAt" DROP DEFAULT;

furniture-3d-system/prisma/migrations/20260713120000_add_operations_business_account_type/migration.sql

@@ -1 +0,0 @@
-ALTER TYPE "BusinessAccountType" ADD VALUE IF NOT EXISTS 'OPERATIONS';

furniture-3d-system/prisma/migrations/20260713120100_backfill_operations_business_roles/migration.sql

@@ -1,6 +0,0 @@
-UPDATE "User" AS u
-SET "businessRoles" = ARRAY['OPERATIONS'::"BusinessAccountType"]
-FROM "Department" AS d
-WHERE u."departmentId" = d."id"
-  AND cardinality(u."businessRoles") = 0
-  AND regexp_replace(d."fullPath", '^\s*[^>]+>\s*', '') LIKE '运营中心%';

furniture-3d-system/prisma/migrations/20260713121500_append_missing_operations_business_roles/migration.sql

@@ -1,9 +0,0 @@
-UPDATE "User" AS u
-SET "businessRoles" = CASE
-  WHEN cardinality(u."businessRoles") = 0 THEN ARRAY['OPERATIONS'::"BusinessAccountType"]
-  ELSE array_append(u."businessRoles", 'OPERATIONS'::"BusinessAccountType")
-END
-FROM "Department" AS d
-WHERE u."departmentId" = d."id"
-  AND split_part(d."fullPath", ' > ', 2) LIKE '运营中心%'
-  AND NOT ('OPERATIONS'::"BusinessAccountType" = ANY(u."businessRoles"));

furniture-3d-system/prisma/migrations/20260713143000_add_general_and_strategy_business_account_types/migration.sql

@@ -1,2 +0,0 @@
-ALTER TYPE "BusinessAccountType" ADD VALUE IF NOT EXISTS 'GENERAL';
-ALTER TYPE "BusinessAccountType" ADD VALUE IF NOT EXISTS 'STRATEGY';

furniture-3d-system/prisma/migrations/20260713143100_backfill_strategy_and_general_business_roles/migration.sql

@@ -1,30 +0,0 @@
-UPDATE "User" AS u
-SET "businessRoles" = CASE
-  WHEN cardinality(array_remove(u."businessRoles", 'GENERAL'::"BusinessAccountType")) = 0 THEN ARRAY['PLANNING'::"BusinessAccountType"]
-  ELSE array_append(array_remove(u."businessRoles", 'GENERAL'::"BusinessAccountType"), 'PLANNING'::"BusinessAccountType")
-END
-FROM "Department" AS d
-WHERE u."departmentId" = d."id"
-  AND split_part(d."fullPath", ' > ', 2) = '品牌中心'
-  AND (
-    d."fullPath" LIKE '% > 空间视觉部%'
-    OR d."fullPath" LIKE '% > 商品企划部%'
-  )
-  AND NOT ('PLANNING'::"BusinessAccountType" = ANY(u."businessRoles"));
-
-UPDATE "User" AS u
-SET "businessRoles" = CASE
-  WHEN cardinality(array_remove(u."businessRoles", 'GENERAL'::"BusinessAccountType")) = 0 THEN ARRAY['STRATEGY'::"BusinessAccountType"]
-  ELSE array_append(array_remove(u."businessRoles", 'GENERAL'::"BusinessAccountType"), 'STRATEGY'::"BusinessAccountType")
-END
-FROM "Department" AS d
-WHERE u."departmentId" = d."id"
-  AND split_part(d."fullPath", ' > ', 2) = '品牌中心'
-  AND d."fullPath" NOT LIKE '% > 空间视觉部%'
-  AND d."fullPath" NOT LIKE '% > 商品企划部%'
-  AND NOT ('STRATEGY'::"BusinessAccountType" = ANY(u."businessRoles"));
-
-UPDATE "User"
-SET "businessRoles" = ARRAY['GENERAL'::"BusinessAccountType"]
-WHERE cardinality("businessRoles") = 0
-  AND (NULLIF(BTRIM(COALESCE("supplierCode", '')), '') IS NULL);

furniture-3d-system/prisma/migrations/20260713153000_add_customer_service_business_account_type/migration.sql

@@ -1 +0,0 @@
-ALTER TYPE "BusinessAccountType" ADD VALUE IF NOT EXISTS 'CUSTOMER_SERVICE';

furniture-3d-system/prisma/migrations/20260713153100_backfill_customer_service_business_roles/migration.sql

@@ -1,20 +0,0 @@
-WITH customer_service_department AS (
-  SELECT U&'\5BA2\670D\4E2D\5FC3'::text AS name
-)
-UPDATE "User" AS u
-SET "businessRoles" = CASE
-  WHEN cardinality(array_remove(COALESCE(u."businessRoles", ARRAY[]::"BusinessAccountType"[]), 'GENERAL'::"BusinessAccountType")) = 0
-    THEN ARRAY['CUSTOMER_SERVICE'::"BusinessAccountType"]
-  ELSE array_append(
-    array_remove(COALESCE(u."businessRoles", ARRAY[]::"BusinessAccountType"[]), 'GENERAL'::"BusinessAccountType"),
-    'CUSTOMER_SERVICE'::"BusinessAccountType"
-  )
-END
-FROM "Department" AS d, customer_service_department AS cs
-WHERE u."departmentId" = d."id"
-  AND (
-    d."fullPath" = cs.name
-    OR split_part(d."fullPath", ' > ', 2) = cs.name
-    OR d."fullPath" LIKE ('% > ' || cs.name || '%')
-  )
-  AND NOT ('CUSTOMER_SERVICE'::"BusinessAccountType" = ANY(COALESCE(u."businessRoles", ARRAY[]::"BusinessAccountType"[])));

furniture-3d-system/prisma/migrations/20260722093000_add_intake_virtual_inventory_retry_fields/migration.sql

@@ -1,13 +0,0 @@
-ALTER TABLE "IntakeNonIntegratedPricingRow"
-  ADD COLUMN "jstVirtualInventoryRetryCount" INTEGER NOT NULL DEFAULT 0,
-  ADD COLUMN "jstVirtualInventoryLastAttemptAt" TIMESTAMP(3);
-
-ALTER TABLE "IntakeNonIntegratedPricingRow"
-  ADD CONSTRAINT "IntakeNonIntegratedPricingRow_virtual_inventory_retry_count_valid"
-  CHECK ("jstVirtualInventoryRetryCount" >= 0);
-
-CREATE INDEX "IntakeNonIntegratedPricingRow_virtual_inventory_due_idx"
-  ON "IntakeNonIntegratedPricingRow" (
-    "jstVirtualInventoryStatus",
-    "jstVirtualInventoryScheduledAt"
-  );

furniture-3d-system/prisma/migrations/20260722114000_add_operation_logs/migration.sql

@@ -1,38 +0,0 @@
-CREATE TYPE "OperationLogAction" AS ENUM (
-  'INTAKE_PRODUCT_WRITE',
-  'JUSHUITAN_PRODUCT_PUSH',
-  'JUSHUITAN_VIRTUAL_INVENTORY_PUSH'
-);
-
-CREATE TYPE "OperationLogStatus" AS ENUM ('SUCCESS', 'FAILED', 'RETRY');
-
-CREATE TYPE "OperationLogSource" AS ENUM ('USER', 'SYSTEM');
-
-CREATE TABLE "OperationLog" (
-  "id" TEXT NOT NULL,
-  "action" "OperationLogAction" NOT NULL,
-  "status" "OperationLogStatus" NOT NULL,
-  "source" "OperationLogSource" NOT NULL DEFAULT 'USER',
-  "actorId" TEXT,
-  "actorName" TEXT NOT NULL,
-  "productId" TEXT,
-  "productSpu" TEXT,
-  "skuId" TEXT,
-  "skuCode" TEXT,
-  "workspaceCategory" TEXT,
-  "errorCode" TEXT,
-  "message" TEXT NOT NULL,
-  "requestId" TEXT,
-  "details" JSONB,
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-
-  CONSTRAINT "OperationLog_pkey" PRIMARY KEY ("id"),
-  CONSTRAINT "OperationLog_actorId_fkey"
-    FOREIGN KEY ("actorId") REFERENCES "User"("id") ON DELETE SET NULL ON UPDATE CASCADE
-);
-
-CREATE INDEX "OperationLog_status_createdAt_idx" ON "OperationLog"("status", "createdAt");
-CREATE INDEX "OperationLog_action_createdAt_idx" ON "OperationLog"("action", "createdAt");
-CREATE INDEX "OperationLog_actorId_createdAt_idx" ON "OperationLog"("actorId", "createdAt");
-CREATE INDEX "OperationLog_productSpu_createdAt_idx" ON "OperationLog"("productSpu", "createdAt");
-CREATE INDEX "OperationLog_productId_createdAt_idx" ON "OperationLog"("productId", "createdAt");

furniture-3d-system/prisma/migrations/20260722133000_structure_intake_factory_fields_and_expand_external_catalog/migration.sql

@@ -1,659 +0,0 @@
--- Move product-factory fields out of the compatibility payload and into the
--- structured non-integrated SKU truth. The payload is used only for this
--- one-time backfill; runtime reads and the external contract use columns.
-
-ALTER TABLE "IntakeNonIntegratedSkuItem"
-  ADD COLUMN IF NOT EXISTS "factoryWarehouse" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN IF NOT EXISTS "shippingMethod" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN IF NOT EXISTS "minimumOrderQuantity" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN IF NOT EXISTS "taxIncludedUnitPrice" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN IF NOT EXISTS "leadTime" TEXT NOT NULL DEFAULT '';
-
-WITH factory_rows AS (
-  SELECT DISTINCT ON (product."id", factory_row.item ->> 'skuId')
-    product."id" AS product_id,
-    factory_row.item ->> 'skuId' AS sku_item_id,
-    factory_row.item
-  FROM "IntakeNonIntegratedProduct" product
-  CROSS JOIN LATERAL jsonb_array_elements(
-    CASE
-      WHEN jsonb_typeof(product."payload" -> 'factoryRows') = 'array'
-      THEN product."payload" -> 'factoryRows'
-      ELSE '[]'::jsonb
-    END
-  ) WITH ORDINALITY AS factory_row(item, ordinal_position)
-  WHERE NULLIF(btrim(COALESCE(factory_row.item ->> 'skuId', '')), '') IS NOT NULL
-  ORDER BY product."id", factory_row.item ->> 'skuId', factory_row.ordinal_position DESC
-)
-UPDATE "IntakeNonIntegratedSkuItem" sku
-SET
-  "manufacturer" = COALESCE(
-    NULLIF(btrim(sku."manufacturer"), ''),
-    btrim(COALESCE(factory.item ->> 'supplierName', ''))
-  ),
-  "manufacturerCode" = COALESCE(
-    NULLIF(btrim(sku."manufacturerCode"), ''),
-    upper(btrim(COALESCE(factory.item ->> 'supplierCode', '')))
-  ),
-  "installMethod" = COALESCE(
-    NULLIF(btrim(sku."installMethod"), ''),
-    btrim(COALESCE(factory.item ->> 'installMethod', ''))
-  ),
-  "factoryWarehouse" = COALESCE(
-    NULLIF(btrim(sku."factoryWarehouse"), ''),
-    btrim(COALESCE(factory.item ->> 'warehouse', ''))
-  ),
-  "shippingMethod" = COALESCE(
-    NULLIF(btrim(sku."shippingMethod"), ''),
-    btrim(COALESCE(factory.item ->> 'shippingMethod', ''))
-  ),
-  "minimumOrderQuantity" = COALESCE(
-    NULLIF(btrim(sku."minimumOrderQuantity"), ''),
-    btrim(COALESCE(factory.item ->> 'minimumOrderQuantity', ''))
-  ),
-  "taxIncludedUnitPrice" = COALESCE(
-    NULLIF(btrim(sku."taxIncludedUnitPrice"), ''),
-    btrim(COALESCE(factory.item ->> 'taxIncludedUnitPrice', ''))
-  ),
-  "leadTime" = COALESCE(
-    NULLIF(btrim(sku."leadTime"), ''),
-    btrim(COALESCE(factory.item ->> 'leadTime', ''))
-  )
-FROM factory_rows factory
-WHERE sku."productId" = factory.product_id
-  AND sku."skuItemId" = factory.sku_item_id;
-
-COMMENT ON COLUMN "IntakeNonIntegratedSkuItem"."factoryWarehouse" IS
-  'Product-factory shipping warehouse; not the inventory warehouse location.';
-
-CREATE OR REPLACE VIEW external.intake_sku_items_v1 AS
-SELECT
-  product."id" AS intake_product_id,
-  product."spu" AS spu,
-  product."brand" AS brand,
-  sku."skuItemId" AS intake_sku_item_id,
-  sku."skuSequence" AS sku_sequence,
-  sku."batchNo" AS batch_no,
-  external.to_external_asset_url(sku."image") AS image_url,
-  sku."imageName" AS image_name,
-  sku."model" AS model,
-  sku."skuCode" AS sku_code,
-  sku."specName" AS spec_name,
-  sku."barcode" AS barcode,
-  sku."size" AS size,
-  sku."color" AS color,
-  sku."material" AS material,
-  sku."versionNo" AS version_no,
-  sku."attributeCode" AS attribute_code,
-  sku."drawingId" AS drawing_id,
-  sku."installMethod" AS install_method,
-  sku."executeStandard" AS execute_standard,
-  sku."manufacturer" AS manufacturer,
-  sku."manufacturerCode" AS manufacturer_code,
-  sku."salesStatus" AS sales_status,
-  external.to_external_asset_url(sku."model3dDataUrl") AS model_3d_url,
-  sku."source" AS source,
-  sku."sourceTable" AS source_table,
-  sku."sourceSkuId" AS source_sku_id,
-  sku."missingRequiredFields" AS missing_required_fields,
-  sku."dataQualityStatus"::text AS data_quality_status,
-  sku."contentLocked" AS content_locked,
-  sku."sortOrder" AS sort_order,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(product."brand", '')), '') IS NOT NULL
-      AND NULLIF(btrim(COALESCE(product."spu", '')), '') IS NOT NULL
-    THEN upper(btrim(product."brand")) || ':' || upper(btrim(product."spu"))
-    ELSE NULL
-  END AS product_business_key,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(product."brand", '')), '') IS NOT NULL
-      AND NULLIF(btrim(COALESCE(product."spu", '')), '') IS NOT NULL
-      AND NULLIF(btrim(COALESCE(sku."skuCode", '')), '') IS NOT NULL
-    THEN upper(btrim(product."brand")) || ':' || upper(btrim(product."spu")) || ':' || upper(btrim(sku."skuCode"))
-    ELSE NULL
-  END AS sku_business_key,
-  sku."factoryWarehouse" AS factory_warehouse,
-  sku."shippingMethod" AS shipping_method,
-  sku."minimumOrderQuantity" AS minimum_order_quantity,
-  sku."taxIncludedUnitPrice" AS tax_included_unit_price,
-  sku."leadTime" AS lead_time
-FROM "IntakeNonIntegratedSkuItem" sku
-JOIN "IntakeNonIntegratedProduct" product ON product."id" = sku."productId"
-WHERE product."deletedAt" IS NULL;
-
-CREATE OR REPLACE VIEW external.intake_sku_items_ready_v1 AS
-SELECT sku.*
-FROM external.intake_sku_items_v1 sku
-JOIN external.intake_products_ready_v1 product
-  ON product.intake_product_id = sku.intake_product_id
-WHERE sku.data_quality_status = 'READY'
-  AND NULLIF(btrim(COALESCE(sku.sku_business_key, '')), '') IS NOT NULL;
-
-CREATE OR REPLACE VIEW external.intake_products_v1 AS
-SELECT
-  product."id" AS intake_product_id,
-  product."spu" AS spu,
-  product."spuBase" AS spu_base,
-  product."brand" AS brand,
-  profile."productName" AS product_name,
-  external.to_external_asset_url(profile."productImageUrl") AS product_image_url,
-  profile."productCategory" AS product_category,
-  profile."salesCategory" AS sales_category,
-  profile."productYear" AS product_year,
-  profile."productStatus" AS product_status,
-  COALESCE(NULLIF(profile."structureDesigner", ''), NULLIF(product."designer", '')) AS designer,
-  COALESCE(NULLIF(profile."productPlanning", ''), NULLIF(product."operator", '')) AS operator,
-  COALESCE(NULLIF(profile."purchaseOwner", ''), NULLIF(product."purchaser", '')) AS purchaser,
-  profile."productDevelopmentKind" AS product_development_kind,
-  profile."goodsType" AS goods_type,
-  profile."materialType" AS material_type,
-  profile."productionType" AS production_type,
-  product."createdAt" AS created_at,
-  product."updatedAt" AS updated_at,
-  profile."productPlanning" AS product_planning,
-  profile."visualPlanning" AS visual_planning,
-  profile."structureDesigner" AS structure_designer,
-  profile."purchaseOwner" AS purchase_owner,
-  CASE
-    WHEN NULLIF(btrim(COALESCE(product."brand", '')), '') IS NOT NULL
-      AND NULLIF(btrim(COALESCE(product."spu", '')), '') IS NOT NULL
-    THEN upper(btrim(product."brand")) || ':' || upper(btrim(product."spu"))
-    ELSE NULL
-  END AS product_business_key,
-  NULLIF(btrim(COALESCE(product."designer", '')), '') AS appearance_designer,
-  COALESCE(
-    NULLIF(btrim(COALESCE(profile."spuOwner", '')), ''),
-    NULLIF(btrim(COALESCE(product."operator", '')), ''),
-    NULLIF(btrim(COALESCE(profile."operationsOwner", '')), '')
-  ) AS spu_owner,
-  NULLIF(btrim(COALESCE(profile."productPlanning", '')), '') AS planning_owner,
-  COALESCE(
-    NULLIF(btrim(COALESCE(profile."visualPlanning", '')), ''),
-    NULLIF(btrim(COALESCE(profile."visualDirector", '')), '')
-  ) AS space_designer
-FROM "IntakeNonIntegratedProduct" product
-LEFT JOIN "IntakeNonIntegratedProductProfile" profile ON profile."productId" = product."id"
-WHERE product."deletedAt" IS NULL;
-
-CREATE OR REPLACE VIEW external.intake_products_ready_v1 AS
-SELECT *
-FROM external.intake_products_v1
-WHERE NULLIF(btrim(COALESCE(product_name, '')), '') IS NOT NULL
-  AND NULLIF(btrim(COALESCE(product_category, '')), '') IS NOT NULL
-  AND NULLIF(btrim(COALESCE(product_development_kind, '')), '') IS NOT NULL
-  AND NULLIF(btrim(COALESCE(product_business_key, '')), '') IS NOT NULL;
-
-CREATE OR REPLACE VIEW external.product_catalog_wide_v1 AS
-WITH formal_sku_source AS (
-  SELECT
-    sku.product_id,
-    sku.product_model_number,
-    sku.product_name,
-    sku.product_description,
-    sku.product_category_id,
-    sku.product_category_name,
-    sku.product_thumbnail_url,
-    sku.product_model_url,
-    sku.sku_id,
-    sku.sku_code,
-    sku.sku_name,
-    sku.price,
-    sku.cost_price,
-    sku.stock,
-    sku.is_active,
-    sku.record_status,
-    sku.model_url,
-    sku.image_url,
-    sku.image_urls,
-    sku.source_pre_sku_id,
-    sku.source_asset_variant_id,
-    sku.source_asset_variant_ids,
-    sku.asset_family_code,
-    sku.asset_family_name,
-    sku.spec_code,
-    sku.spec_name,
-    sku.barcode,
-    sku.size_json,
-    sku.color,
-    sku.material,
-    sku.source_status,
-    sku.synced_at,
-    sku.warehouse_location_id,
-    sku.warehouse_location_code,
-    sku.warehouse_location_name,
-    sku.created_at,
-    sku.updated_at,
-    sku.product_business_key,
-    sku.sku_business_key,
-    sku.barcode_business_key,
-    'FORMAL'::text AS catalog_source,
-    NULL::text AS appearance_designer,
-    NULL::text AS structure_designer,
-    NULL::text AS spu_owner,
-    NULL::text AS planning_owner,
-    NULL::text AS space_designer,
-    NULL::text AS purchase_owner,
-    NULL::text AS supplier_name,
-    NULL::text AS supplier_code,
-    NULL::text AS factory_warehouse,
-    NULL::text AS shipping_method,
-    NULL::text AS minimum_order_quantity,
-    NULL::text AS tax_included_unit_price,
-    NULL::text AS lead_time,
-    NULL::text AS install_method
-  FROM external.product_skus_v1 sku
-),
-formal_identity_map AS (
-  SELECT
-    barcode_business_key,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku_code, '')), '') IS NOT NULL
-      THEN upper(btrim(sku_code))
-      ELSE NULL
-    END AS normalized_sku_code
-  FROM formal_sku_source
-),
-intake_ready_sku_source AS (
-  SELECT
-    product.intake_product_id AS product_id,
-    NULLIF(btrim(COALESCE(product.spu, '')), '') AS product_model_number,
-    NULLIF(btrim(COALESCE(product.product_name, '')), '') AS product_name,
-    NULL::text AS product_description,
-    NULL::text AS product_category_id,
-    NULLIF(btrim(COALESCE(product.product_category, '')), '') AS product_category_name,
-    COALESCE(
-      NULLIF(btrim(COALESCE(product.product_image_url, '')), ''),
-      NULLIF(btrim(COALESCE(sku.image_url, '')), '')
-    ) AS product_thumbnail_url,
-    NULL::text AS product_model_url,
-    sku.intake_sku_item_id AS sku_id,
-    NULLIF(btrim(COALESCE(sku.sku_code, '')), '') AS sku_code,
-    COALESCE(
-      NULLIF(btrim(COALESCE(sku.spec_name, '')), ''),
-      NULLIF(btrim(COALESCE(sku.sku_code, '')), '')
-    ) AS sku_name,
-    NULL::numeric(10,2) AS price,
-    NULL::numeric(10,2) AS cost_price,
-    0::integer AS stock,
-    true AS is_active,
-    'ACTIVE'::text AS record_status,
-    NULLIF(btrim(COALESCE(sku.model_3d_url, '')), '') AS model_url,
-    COALESCE(
-      NULLIF(btrim(COALESCE(sku.image_url, '')), ''),
-      NULLIF(btrim(COALESCE(product.product_image_url, '')), '')
-    ) AS image_url,
-    CASE
-      WHEN COALESCE(
-        NULLIF(btrim(COALESCE(sku.image_url, '')), ''),
-        NULLIF(btrim(COALESCE(product.product_image_url, '')), '')
-      ) IS NOT NULL
-      THEN ARRAY[
-        COALESCE(
-          NULLIF(btrim(COALESCE(sku.image_url, '')), ''),
-          NULLIF(btrim(COALESCE(product.product_image_url, '')), '')
-        )
-      ]
-      ELSE ARRAY[]::text[]
-    END AS image_urls,
-    NULL::text AS source_pre_sku_id,
-    NULL::text AS source_asset_variant_id,
-    ARRAY[]::text[] AS source_asset_variant_ids,
-    NULLIF(btrim(COALESCE(sku.model, '')), '') AS asset_family_code,
-    NULL::text AS asset_family_name,
-    NULLIF(btrim(COALESCE(sku.attribute_code, '')), '') AS spec_code,
-    NULLIF(btrim(COALESCE(sku.spec_name, '')), '') AS spec_name,
-    NULLIF(btrim(COALESCE(sku.barcode, '')), '') AS barcode,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku.size, '')), '') IS NOT NULL
-      THEN jsonb_build_object('label', btrim(sku.size))
-      ELSE NULL::jsonb
-    END AS size_json,
-    NULLIF(btrim(COALESCE(sku.color, '')), '') AS color,
-    NULLIF(btrim(COALESCE(sku.material, '')), '') AS material,
-    NULL::text AS source_status,
-    NULL::text AS synced_at,
-    NULL::text AS warehouse_location_id,
-    NULL::text AS warehouse_location_code,
-    NULL::text AS warehouse_location_name,
-    product.created_at AS created_at,
-    product.updated_at AS updated_at,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(product.spu, '')), '') IS NOT NULL
-      THEN upper(btrim(product.spu))
-      ELSE NULL
-    END AS product_business_key,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku.sku_code, '')), '') IS NOT NULL
-      THEN upper(btrim(sku.sku_code))
-      ELSE NULL
-    END AS sku_business_key,
-    CASE
-      WHEN NULLIF(btrim(COALESCE(sku.barcode, '')), '') IS NOT NULL
-      THEN upper(btrim(sku.barcode))
-      ELSE NULL
-    END AS barcode_business_key,
-    'INTAKE_READY'::text AS catalog_source,
-    product.appearance_designer,
-    product.structure_designer,
-    product.spu_owner,
-    product.planning_owner,
-    product.space_designer,
-    product.purchase_owner,
-    NULLIF(btrim(COALESCE(sku.manufacturer, '')), '') AS supplier_name,
-    NULLIF(btrim(COALESCE(sku.manufacturer_code, '')), '') AS supplier_code,
-    NULLIF(btrim(COALESCE(sku.factory_warehouse, '')), '') AS factory_warehouse,
-    NULLIF(btrim(COALESCE(sku.shipping_method, '')), '') AS shipping_method,
-    NULLIF(btrim(COALESCE(sku.minimum_order_quantity, '')), '') AS minimum_order_quantity,
-    NULLIF(btrim(COALESCE(sku.tax_included_unit_price, '')), '') AS tax_included_unit_price,
-    NULLIF(btrim(COALESCE(sku.lead_time, '')), '') AS lead_time,
-    NULLIF(btrim(COALESCE(sku.install_method, '')), '') AS install_method
-  FROM external.intake_sku_items_ready_v1 sku
-  JOIN external.intake_products_ready_v1 product
-    ON product.intake_product_id = sku.intake_product_id
-  WHERE NOT EXISTS (
-    SELECT 1
-    FROM formal_identity_map formal
-    WHERE (
-      NULLIF(btrim(COALESCE(sku.barcode, '')), '') IS NOT NULL
-      AND formal.barcode_business_key = upper(btrim(sku.barcode))
-    )
-    OR (
-      NULLIF(btrim(COALESCE(sku.barcode, '')), '') IS NULL
-      AND NULLIF(btrim(COALESCE(sku.sku_code, '')), '') IS NOT NULL
-      AND formal.normalized_sku_code = upper(btrim(sku.sku_code))
-    )
-  )
-),
-sku_source AS (
-  SELECT * FROM formal_sku_source
-  UNION ALL
-  SELECT * FROM intake_ready_sku_source
-),
-asset_summary AS (
-  SELECT
-    product_business_key,
-    sku_business_key,
-    COUNT(*) FILTER (WHERE asset_type = 'SKU_IMAGE')::integer AS image_asset_count,
-    COUNT(*) FILTER (WHERE asset_type = 'SKU_MODEL')::integer AS model_asset_count,
-    COUNT(*) FILTER (WHERE asset_type = 'SKU_THUMBNAIL')::integer AS thumbnail_asset_count,
-    MIN(asset_url) FILTER (WHERE asset_type = 'SKU_MODEL') AS first_model_asset_url,
-    MIN(asset_url) FILTER (WHERE asset_type = 'SKU_THUMBNAIL') AS first_thumbnail_asset_url
-  FROM external.product_assets_v1
-  GROUP BY product_business_key, sku_business_key
-),
-packaged_summary AS (
-  SELECT
-    barcode_business_key,
-    COUNT(*)::integer AS packaged_item_count,
-    COALESCE(SUM(stock_quantity), 0)::integer AS packaged_stock_quantity
-  FROM external.packaged_items_v1
-  WHERE NULLIF(barcode_business_key, '') IS NOT NULL
-  GROUP BY barcode_business_key
-),
-quality_summary AS (
-  SELECT
-    barcode_business_key,
-    COUNT(*)::integer AS quality_record_count,
-    COUNT(*) FILTER (WHERE source_type = 'WAREHOUSE')::integer AS warehouse_quality_record_count,
-    COUNT(*) FILTER (WHERE source_type = 'FIRST_BATCH')::integer AS first_batch_quality_record_count
-  FROM external.sku_quality_inspections_v1
-  WHERE NULLIF(barcode_business_key, '') IS NOT NULL
-  GROUP BY barcode_business_key
-),
-latest_quality AS (
-  SELECT DISTINCT ON (barcode_business_key)
-    barcode_business_key,
-    record_key AS latest_quality_record_key,
-    source_type AS latest_quality_source_type,
-    batch_no AS latest_quality_batch_no,
-    inspected_at AS latest_quality_inspected_at,
-    conclusion AS latest_quality_conclusion,
-    status AS latest_quality_status
-  FROM external.sku_quality_inspections_v1
-  WHERE NULLIF(barcode_business_key, '') IS NOT NULL
-  ORDER BY barcode_business_key, COALESCE(inspected_at, updated_at, created_at) DESC, created_at DESC
-),
-limit_by_barcode AS (
-  SELECT DISTINCT ON (identity_value)
-    identity_value,
-    product_business_key AS limit_source_product_business_key,
-    sku_business_key AS limit_source_sku_business_key,
-    limit_price_applicable,
-    limit_price_confirmed,
-    limit_price_status,
-    expected_daily_limit_price,
-    expected_limit_gross_margin_rate,
-    non_spu_owner_limit_price,
-    limit_confirmed_at
-  FROM (
-    SELECT
-      upper(btrim(barcode)) AS identity_value,
-      product_business_key,
-      sku_business_key,
-      limit_price_applicable,
-      limit_price_confirmed,
-      limit_price_status,
-      expected_daily_limit_price,
-      expected_limit_gross_margin_rate,
-      non_spu_owner_limit_price,
-      limit_confirmed_at,
-      updated_at
-    FROM external.intake_product_limits_v1
-    WHERE NULLIF(btrim(COALESCE(barcode, '')), '') IS NOT NULL
-  ) limit_rows
-  WHERE NULLIF(identity_value, '') IS NOT NULL
-  ORDER BY
-    identity_value,
-    limit_price_applicable DESC,
-    limit_price_confirmed DESC,
-    limit_confirmed_at DESC NULLS LAST,
-    updated_at DESC
-),
-limit_by_sku AS (
-  SELECT DISTINCT ON (identity_value)
-    identity_value,
-    product_business_key AS limit_source_product_business_key,
-    sku_business_key AS limit_source_sku_business_key,
-    limit_price_applicable,
-    limit_price_confirmed,
-    limit_price_status,
-    expected_daily_limit_price,
-    expected_limit_gross_margin_rate,
-    non_spu_owner_limit_price,
-    limit_confirmed_at
-  FROM (
-    SELECT
-      upper(btrim(sku_code)) AS identity_value,
-      product_business_key,
-      sku_business_key,
-      limit_price_applicable,
-      limit_price_confirmed,
-      limit_price_status,
-      expected_daily_limit_price,
-      expected_limit_gross_margin_rate,
-      non_spu_owner_limit_price,
-      limit_confirmed_at,
-      updated_at
-    FROM external.intake_product_limits_v1
-    WHERE NULLIF(btrim(COALESCE(sku_code, '')), '') IS NOT NULL
-  ) limit_rows
-  WHERE NULLIF(identity_value, '') IS NOT NULL
-  ORDER BY
-    identity_value,
-    limit_price_applicable DESC,
-    limit_price_confirmed DESC,
-    limit_confirmed_at DESC NULLS LAST,
-    updated_at DESC
-),
-catalog_by_sku AS (
-SELECT
-  sku.product_id,
-  sku.product_model_number,
-  sku.product_business_key,
-  sku.product_name,
-  sku.product_description,
-  sku.product_category_id,
-  sku.product_category_name,
-  sku.product_thumbnail_url,
-  sku.product_model_url,
-  sku.sku_id,
-  sku.sku_code,
-  sku.sku_business_key,
-  sku.sku_name,
-  sku.price,
-  sku.cost_price,
-  sku.stock,
-  sku.is_active,
-  sku.record_status,
-  sku.model_url,
-  sku.image_url,
-  sku.image_urls,
-  sku.source_pre_sku_id,
-  sku.source_asset_variant_id,
-  sku.source_asset_variant_ids,
-  sku.asset_family_code,
-  sku.asset_family_name,
-  sku.spec_code,
-  sku.spec_name,
-  sku.barcode,
-  sku.barcode_business_key,
-  sku.size_json,
-  sku.color,
-  sku.material,
-  sku.source_status,
-  sku.synced_at,
-  sku.warehouse_location_id,
-  sku.warehouse_location_code,
-  sku.warehouse_location_name,
-  stock.warehouse_zone,
-  stock.warehouse_aisle,
-  stock.warehouse_shelf,
-  stock.warehouse_bin,
-  stock.warehouse_location_is_active,
-  stock.warehouse_location_status,
-  COALESCE(limit_by_barcode.limit_price_applicable, limit_by_sku.limit_price_applicable, false) AS limit_price_applicable,
-  COALESCE(limit_by_barcode.limit_price_confirmed, limit_by_sku.limit_price_confirmed, false) AS limit_price_confirmed,
-  COALESCE(limit_by_barcode.limit_price_status, limit_by_sku.limit_price_status, 'NOT_APPLICABLE') AS limit_price_status,
-  COALESCE(limit_by_barcode.expected_daily_limit_price, limit_by_sku.expected_daily_limit_price) AS expected_daily_limit_price,
-  COALESCE(limit_by_barcode.expected_limit_gross_margin_rate, limit_by_sku.expected_limit_gross_margin_rate) AS expected_limit_gross_margin_rate,
-  COALESCE(limit_by_barcode.non_spu_owner_limit_price, limit_by_sku.non_spu_owner_limit_price) AS non_spu_owner_limit_price,
-  COALESCE(limit_by_barcode.limit_confirmed_at, limit_by_sku.limit_confirmed_at) AS limit_confirmed_at,
-  COALESCE(limit_by_barcode.limit_source_product_business_key, limit_by_sku.limit_source_product_business_key) AS limit_source_product_business_key,
-  COALESCE(limit_by_barcode.limit_source_sku_business_key, limit_by_sku.limit_source_sku_business_key) AS limit_source_sku_business_key,
-  CASE
-    WHEN sku.catalog_source = 'INTAKE_READY'
-    THEN CASE WHEN NULLIF(btrim(COALESCE(sku.image_url, '')), '') IS NOT NULL THEN 1 ELSE 0 END
-    ELSE COALESCE(asset_summary.image_asset_count, 0)
-  END AS image_asset_count,
-  CASE
-    WHEN sku.catalog_source = 'INTAKE_READY'
-    THEN CASE WHEN NULLIF(btrim(COALESCE(sku.model_url, '')), '') IS NOT NULL THEN 1 ELSE 0 END
-    ELSE COALESCE(asset_summary.model_asset_count, 0)
-  END AS model_asset_count,
-  CASE
-    WHEN sku.catalog_source = 'INTAKE_READY'
-    THEN CASE
-      WHEN COALESCE(
-        NULLIF(btrim(COALESCE(sku.product_thumbnail_url, '')), ''),
-        NULLIF(btrim(COALESCE(sku.image_url, '')), '')
-      ) IS NOT NULL
-      THEN 1
-      ELSE 0
-    END
-    ELSE COALESCE(asset_summary.thumbnail_asset_count, 0)
-  END AS thumbnail_asset_count,
-  COALESCE(
-    asset_summary.first_model_asset_url,
-    CASE
-      WHEN sku.catalog_source = 'INTAKE_READY'
-      THEN NULLIF(btrim(COALESCE(sku.model_url, '')), '')
-      ELSE NULL
-    END
-  ) AS first_model_asset_url,
-  COALESCE(
-    asset_summary.first_thumbnail_asset_url,
-    CASE
-      WHEN sku.catalog_source = 'INTAKE_READY'
-      THEN COALESCE(
-        NULLIF(btrim(COALESCE(sku.product_thumbnail_url, '')), ''),
-        NULLIF(btrim(COALESCE(sku.image_url, '')), '')
-      )
-      ELSE NULL
-    END
-  ) AS first_thumbnail_asset_url,
-  COALESCE(bom_summary.bom_item_count, 0) AS bom_item_count,
-  COALESCE(bom_summary.panel_item_count, 0) AS panel_item_count,
-  COALESCE(bom_summary.hardware_item_count, 0) AS hardware_item_count,
-  COALESCE(bom_summary.material_codes, ARRAY[]::text[]) AS material_codes,
-  COALESCE(bom_summary.material_names, ARRAY[]::text[]) AS material_names,
-  COALESCE(packaged_summary.packaged_item_count, 0) AS packaged_item_count,
-  COALESCE(packaged_summary.packaged_stock_quantity, 0) AS packaged_stock_quantity,
-  COALESCE(quality_summary.quality_record_count, 0) AS quality_record_count,
-  COALESCE(quality_summary.warehouse_quality_record_count, 0) AS warehouse_quality_record_count,
-  COALESCE(quality_summary.first_batch_quality_record_count, 0) AS first_batch_quality_record_count,
-  latest_quality.latest_quality_record_key,
-  latest_quality.latest_quality_source_type,
-  latest_quality.latest_quality_batch_no,
-  latest_quality.latest_quality_inspected_at,
-  latest_quality.latest_quality_conclusion,
-  latest_quality.latest_quality_status,
-  sku.created_at,
-  sku.updated_at,
-  sku.catalog_source,
-  sku.appearance_designer,
-  sku.structure_designer,
-  sku.spu_owner,
-  sku.planning_owner,
-  sku.space_designer,
-  sku.purchase_owner,
-  sku.supplier_name,
-  sku.supplier_code,
-  sku.factory_warehouse,
-  sku.shipping_method,
-  sku.minimum_order_quantity,
-  sku.tax_included_unit_price,
-  sku.lead_time,
-  sku.install_method
-FROM sku_source sku
-LEFT JOIN external.sku_warehouse_stock_v1 stock
-  ON stock.barcode_business_key = sku.barcode_business_key
-LEFT JOIN limit_by_sku
-  ON limit_by_sku.identity_value = upper(btrim(COALESCE(sku.sku_code, '')))
-LEFT JOIN limit_by_barcode
-  ON limit_by_barcode.identity_value = sku.barcode_business_key
-LEFT JOIN asset_summary
-  ON asset_summary.product_business_key = sku.product_business_key
- AND asset_summary.sku_business_key = sku.sku_business_key
-LEFT JOIN LATERAL (
-  SELECT
-    COUNT(*)::integer AS bom_item_count,
-    COUNT(*) FILTER (WHERE item_type = 'PANEL')::integer AS panel_item_count,
-    COUNT(*) FILTER (WHERE item_type = 'HARDWARE')::integer AS hardware_item_count,
-    array_remove(array_agg(DISTINCT material_code ORDER BY material_code), NULL) AS material_codes,
-    array_remove(array_agg(DISTINCT material_name ORDER BY material_name), NULL) AS material_names
-  FROM external.product_bom_v1 bom
-  WHERE bom.product_business_key = sku.product_business_key
-    AND (
-      bom.sku_business_key = sku.sku_business_key
-      OR bom.sku_business_key IS NULL
-    )
-) bom_summary ON true
-LEFT JOIN packaged_summary
-  ON packaged_summary.barcode_business_key = sku.barcode_business_key
-LEFT JOIN quality_summary
-  ON quality_summary.barcode_business_key = sku.barcode_business_key
-LEFT JOIN latest_quality
-  ON latest_quality.barcode_business_key = sku.barcode_business_key
-)
-SELECT DISTINCT ON (catalog_by_sku.barcode_business_key)
-  catalog_by_sku.*
-FROM catalog_by_sku
-WHERE catalog_by_sku.barcode_business_key IS NOT NULL
-  AND btrim(catalog_by_sku.barcode_business_key) <> ''
-ORDER BY
-  catalog_by_sku.barcode_business_key,
-  CASE WHEN catalog_by_sku.catalog_source IS NULL THEN 1
-       WHEN catalog_by_sku.catalog_source = 'FORMAL' THEN 0
-       ELSE 1 END,
-  catalog_by_sku.updated_at DESC NULLS LAST,
-  catalog_by_sku.created_at DESC;

furniture-3d-system/prisma/migrations/20260722153000_add_installation_demo_toolbox/migration.sql

@@ -1,18 +0,0 @@
-ALTER TABLE "InstallationDemoConfig"
-ADD COLUMN IF NOT EXISTS "toolIds" JSONB;
-
-CREATE TABLE IF NOT EXISTS "InstallationDemoTool" (
-  "id" TEXT NOT NULL,
-  "toolCode" TEXT NOT NULL,
-  "name" TEXT NOT NULL,
-  "modelUrl" TEXT NOT NULL,
-  "fileName" TEXT NOT NULL,
-  "mountOffset" JSONB,
-  "mountRotation" JSONB,
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-  CONSTRAINT "InstallationDemoTool_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX IF NOT EXISTS "InstallationDemoTool_toolCode_key"
-ON "InstallationDemoTool"("toolCode");

furniture-3d-system/prisma/migrations/20260723101500_expand_operation_log_intake_actions/migration.sql

@@ -1,4 +0,0 @@
-ALTER TYPE "OperationLogAction" ADD VALUE IF NOT EXISTS 'INTAKE_PRODUCT_CREATE';
-ALTER TYPE "OperationLogAction" ADD VALUE IF NOT EXISTS 'INTAKE_PRODUCT_DELETE';
-ALTER TYPE "OperationLogAction" ADD VALUE IF NOT EXISTS 'INTAKE_FILE_UPLOAD';
-ALTER TYPE "OperationLogAction" ADD VALUE IF NOT EXISTS 'INTAKE_WORKSPACE_CONFIRMATION';

furniture-3d-system/prisma/migrations/20260723143000_add_bom_costing_workbench/migration.sql

@@ -1,180 +0,0 @@
-CREATE TYPE "BomCostingCaseStatus" AS ENUM (
-  'DRAFT',
-  'QUEUED',
-  'ANALYZING',
-  'READY',
-  'FAILED'
-);
-
-CREATE TYPE "BomCostingLineCategory" AS ENUM (
-  'BOARD',
-  'STEEL',
-  'ACCESSORY',
-  'PACKAGING',
-  'PROCESSING',
-  'LABOR'
-);
-
-CREATE TYPE "BomCostingMatchStatus" AS ENUM (
-  'UNMATCHED',
-  'MATCHED',
-  'NEEDS_CONFIRMATION'
-);
-
-CREATE TABLE "BomCostingCase" (
-  "id" TEXT NOT NULL,
-  "sourceUrl" TEXT NOT NULL,
-  "sourceHost" TEXT NOT NULL,
-  "title" TEXT NOT NULL DEFAULT '',
-  "providerCode" TEXT NOT NULL DEFAULT '',
-  "providerTaskId" TEXT NOT NULL DEFAULT '',
-  "analysisSchemaVersion" TEXT NOT NULL DEFAULT 'competitor-analysis/v1',
-  "status" "BomCostingCaseStatus" NOT NULL DEFAULT 'DRAFT',
-  "progress" INTEGER NOT NULL DEFAULT 0,
-  "statusMessage" TEXT NOT NULL DEFAULT '',
-  "targetErrorPercent" DECIMAL(5,2) NOT NULL DEFAULT 10,
-  "currency" TEXT NOT NULL DEFAULT 'CNY',
-  "rawAnalysisSnapshot" JSONB,
-  "createdById" TEXT NOT NULL,
-  "deletedAt" TIMESTAMP(3),
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-  CONSTRAINT "BomCostingCase_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "BomCostingSku" (
-  "id" TEXT NOT NULL,
-  "caseId" TEXT NOT NULL,
-  "externalSkuId" TEXT NOT NULL,
-  "name" TEXT NOT NULL DEFAULT '',
-  "structureGroupKey" TEXT NOT NULL DEFAULT '',
-  "imageUrl" TEXT,
-  "attributes" JSONB,
-  "lengthMm" DECIMAL(12,3),
-  "widthMm" DECIMAL(12,3),
-  "heightMm" DECIMAL(12,3),
-  "weightKg" DECIMAL(12,3),
-  "packageLengthMm" DECIMAL(12,3),
-  "packageWidthMm" DECIMAL(12,3),
-  "packageHeightMm" DECIMAL(12,3),
-  "packageWeightKg" DECIMAL(12,3),
-  "estimatedCost" DECIMAL(12,2),
-  "costCalculatedAt" TIMESTAMP(3),
-  "sortOrder" INTEGER NOT NULL DEFAULT 0,
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-  CONSTRAINT "BomCostingSku_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "BomCostingLine" (
-  "id" TEXT NOT NULL,
-  "skuId" TEXT NOT NULL,
-  "externalLineId" TEXT NOT NULL,
-  "category" "BomCostingLineCategory" NOT NULL,
-  "partName" TEXT NOT NULL,
-  "materialCode" TEXT NOT NULL DEFAULT '',
-  "materialName" TEXT NOT NULL DEFAULT '',
-  "materialSpec" TEXT NOT NULL DEFAULT '',
-  "processName" TEXT NOT NULL DEFAULT '',
-  "packagingKind" TEXT NOT NULL DEFAULT '',
-  "lengthMm" DECIMAL(12,3),
-  "widthMm" DECIMAL(12,3),
-  "heightMm" DECIMAL(12,3),
-  "quantity" DECIMAL(12,4) NOT NULL DEFAULT 1,
-  "unit" TEXT NOT NULL DEFAULT '',
-  "weightKg" DECIMAL(12,4),
-  "lossFactor" DECIMAL(8,4) NOT NULL DEFAULT 1,
-  "sourceConfidence" DECIMAL(5,4),
-  "evidence" JSONB,
-  "matchStatus" "BomCostingMatchStatus" NOT NULL DEFAULT 'UNMATCHED',
-  "matchedLibraryType" TEXT NOT NULL DEFAULT '',
-  "matchedLibraryRecordId" TEXT NOT NULL DEFAULT '',
-  "matchedLibraryName" TEXT NOT NULL DEFAULT '',
-  "matchedLibrarySpec" TEXT NOT NULL DEFAULT '',
-  "resolvedUnitPrice" DECIMAL(12,4),
-  "calculatedQuantity" DECIMAL(14,6),
-  "subtotal" DECIMAL(12,2),
-  "sortOrder" INTEGER NOT NULL DEFAULT 0,
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-  CONSTRAINT "BomCostingLine_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "BomCostingPriceSnapshot" (
-  "id" TEXT NOT NULL,
-  "lineId" TEXT NOT NULL,
-  "sourceType" TEXT NOT NULL,
-  "sourceRecordId" TEXT NOT NULL,
-  "sourceName" TEXT NOT NULL,
-  "sourceSpec" TEXT NOT NULL DEFAULT '',
-  "unitPrice" DECIMAL(12,4) NOT NULL,
-  "unit" TEXT NOT NULL,
-  "currency" TEXT NOT NULL DEFAULT 'CNY',
-  "lossFactor" DECIMAL(8,4) NOT NULL DEFAULT 1,
-  "isCurrent" BOOLEAN NOT NULL DEFAULT true,
-  "matchedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  CONSTRAINT "BomCostingPriceSnapshot_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "BomCostingTaskEvent" (
-  "id" TEXT NOT NULL,
-  "caseId" TEXT NOT NULL,
-  "eventType" TEXT NOT NULL,
-  "status" TEXT NOT NULL,
-  "progress" INTEGER NOT NULL DEFAULT 0,
-  "message" TEXT NOT NULL DEFAULT '',
-  "providerTaskId" TEXT NOT NULL DEFAULT '',
-  "payload" JSONB,
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  CONSTRAINT "BomCostingTaskEvent_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "BomCostingSku_caseId_externalSkuId_key"
-  ON "BomCostingSku"("caseId", "externalSkuId");
-CREATE UNIQUE INDEX "BomCostingLine_skuId_externalLineId_key"
-  ON "BomCostingLine"("skuId", "externalLineId");
-CREATE INDEX "BomCostingCase_createdById_deletedAt_createdAt_idx"
-  ON "BomCostingCase"("createdById", "deletedAt", "createdAt");
-CREATE INDEX "BomCostingCase_status_deletedAt_idx"
-  ON "BomCostingCase"("status", "deletedAt");
-CREATE INDEX "BomCostingCase_providerTaskId_idx"
-  ON "BomCostingCase"("providerTaskId");
-CREATE INDEX "BomCostingSku_caseId_sortOrder_idx"
-  ON "BomCostingSku"("caseId", "sortOrder");
-CREATE INDEX "BomCostingSku_structureGroupKey_idx"
-  ON "BomCostingSku"("structureGroupKey");
-CREATE INDEX "BomCostingLine_skuId_sortOrder_idx"
-  ON "BomCostingLine"("skuId", "sortOrder");
-CREATE INDEX "BomCostingLine_category_matchStatus_idx"
-  ON "BomCostingLine"("category", "matchStatus");
-CREATE INDEX "BomCostingLine_matchedLibraryType_matchedLibraryRecordId_idx"
-  ON "BomCostingLine"("matchedLibraryType", "matchedLibraryRecordId");
-CREATE INDEX "BomCostingPriceSnapshot_lineId_isCurrent_idx"
-  ON "BomCostingPriceSnapshot"("lineId", "isCurrent");
-CREATE INDEX "BomCostingPriceSnapshot_sourceType_sourceRecordId_idx"
-  ON "BomCostingPriceSnapshot"("sourceType", "sourceRecordId");
-CREATE INDEX "BomCostingTaskEvent_caseId_createdAt_idx"
-  ON "BomCostingTaskEvent"("caseId", "createdAt");
-CREATE INDEX "BomCostingTaskEvent_providerTaskId_idx"
-  ON "BomCostingTaskEvent"("providerTaskId");
-
-ALTER TABLE "BomCostingCase"
-  ADD CONSTRAINT "BomCostingCase_createdById_fkey"
-  FOREIGN KEY ("createdById") REFERENCES "User"("id")
-  ON DELETE RESTRICT ON UPDATE CASCADE;
-ALTER TABLE "BomCostingSku"
-  ADD CONSTRAINT "BomCostingSku_caseId_fkey"
-  FOREIGN KEY ("caseId") REFERENCES "BomCostingCase"("id")
-  ON DELETE CASCADE ON UPDATE CASCADE;
-ALTER TABLE "BomCostingLine"
-  ADD CONSTRAINT "BomCostingLine_skuId_fkey"
-  FOREIGN KEY ("skuId") REFERENCES "BomCostingSku"("id")
-  ON DELETE CASCADE ON UPDATE CASCADE;
-ALTER TABLE "BomCostingPriceSnapshot"
-  ADD CONSTRAINT "BomCostingPriceSnapshot_lineId_fkey"
-  FOREIGN KEY ("lineId") REFERENCES "BomCostingLine"("id")
-  ON DELETE CASCADE ON UPDATE CASCADE;
-ALTER TABLE "BomCostingTaskEvent"
-  ADD CONSTRAINT "BomCostingTaskEvent_caseId_fkey"
-  FOREIGN KEY ("caseId") REFERENCES "BomCostingCase"("id")
-  ON DELETE CASCADE ON UPDATE CASCADE;

furniture-3d-system/prisma/migrations/20260723170000_add_work_records/migration.sql

@@ -1,84 +0,0 @@
--- CreateTable
-CREATE TABLE "WorkRecordScoreRule" (
-    "id" TEXT NOT NULL,
-    "primary" TEXT NOT NULL,
-    "secondary" TEXT NOT NULL DEFAULT '',
-    "unitScore" DECIMAL(12,4),
-    "sortOrder" INTEGER NOT NULL DEFAULT 0,
-    "isActive" BOOLEAN NOT NULL DEFAULT true,
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-
-    CONSTRAINT "WorkRecordScoreRule_pkey" PRIMARY KEY ("id")
-);
-
--- CreateTable
-CREATE TABLE "WorkRecord" (
-    "id" TEXT NOT NULL,
-    "workDate" DATE NOT NULL,
-    "designerId" TEXT NOT NULL,
-    "designerName" TEXT NOT NULL,
-    "primary" TEXT NOT NULL,
-    "secondary" TEXT NOT NULL DEFAULT '',
-    "scoreRuleId" TEXT,
-    "approvalOrTask" TEXT NOT NULL DEFAULT '',
-    "spu" TEXT NOT NULL DEFAULT '',
-    "quantity" DECIMAL(12,2) NOT NULL DEFAULT 1,
-    "unitScore" DECIMAL(12,4),
-    "taskTotal" DECIMAL(14,4),
-    "fileStoragePath" TEXT NOT NULL DEFAULT '',
-    "createdById" TEXT NOT NULL,
-    "updatedById" TEXT NOT NULL,
-    "deletedAt" TIMESTAMP(3),
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-
-    CONSTRAINT "WorkRecord_pkey" PRIMARY KEY ("id")
-);
-
--- CreateTable
-CREATE TABLE "WorkRecordMonthlyArchive" (
-    "id" TEXT NOT NULL,
-    "monthKey" TEXT NOT NULL,
-    "periodStart" DATE NOT NULL,
-    "periodEnd" DATE NOT NULL,
-    "fileName" TEXT NOT NULL,
-    "summary" JSONB NOT NULL,
-    "records" JSONB NOT NULL,
-    "recordCount" INTEGER NOT NULL,
-    "generatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-
-    CONSTRAINT "WorkRecordMonthlyArchive_pkey" PRIMARY KEY ("id")
-);
-
--- CreateIndex
-CREATE INDEX "WorkRecordScoreRule_primary_sortOrder_idx" ON "WorkRecordScoreRule"("primary", "sortOrder");
-
--- CreateIndex
-CREATE INDEX "WorkRecordScoreRule_isActive_sortOrder_idx" ON "WorkRecordScoreRule"("isActive", "sortOrder");
-
--- CreateIndex
-CREATE INDEX "WorkRecord_workDate_deletedAt_idx" ON "WorkRecord"("workDate", "deletedAt");
-
--- CreateIndex
-CREATE INDEX "WorkRecord_designerId_workDate_idx" ON "WorkRecord"("designerId", "workDate");
-
--- CreateIndex
-CREATE INDEX "WorkRecord_primary_workDate_idx" ON "WorkRecord"("primary", "workDate");
-
--- CreateIndex
-CREATE INDEX "WorkRecord_scoreRuleId_idx" ON "WorkRecord"("scoreRuleId");
-
--- CreateIndex
-CREATE UNIQUE INDEX "WorkRecordMonthlyArchive_monthKey_key" ON "WorkRecordMonthlyArchive"("monthKey");
-
--- CreateIndex
-CREATE INDEX "WorkRecordMonthlyArchive_periodStart_idx" ON "WorkRecordMonthlyArchive"("periodStart");
-
--- AddForeignKey
-ALTER TABLE "WorkRecord" ADD CONSTRAINT "WorkRecord_designerId_fkey" FOREIGN KEY ("designerId") REFERENCES "User"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
-
--- AddForeignKey
-ALTER TABLE "WorkRecord" ADD CONSTRAINT "WorkRecord_scoreRuleId_fkey" FOREIGN KEY ("scoreRuleId") REFERENCES "WorkRecordScoreRule"("id") ON DELETE SET NULL ON UPDATE CASCADE;

furniture-3d-system/prisma/migrations/20260724110000_normalize_work_record_upload_drawing_label/migration.sql

@@ -1,7 +0,0 @@
-UPDATE "WorkRecordScoreRule"
-SET
-  "secondary" = '将图纸上传图纸系统并生成对应二维码需存入对应SPU文件夹',
-  "updatedAt" = CURRENT_TIMESTAMP
-WHERE
-  "primary" = '上传图纸+制作二维码'
-  AND "secondary" = '将图纸上传图纸系统并生成对应二维码 / 需存入对应SPU文件夹';

furniture-3d-system/prisma/migrations/20260728093000_add_release_notes/migration.sql

@@ -1,36 +0,0 @@
-CREATE TYPE "ReleaseNoteStatus" AS ENUM ('DRAFT', 'PUBLISHED', 'ARCHIVED');
-
-CREATE TABLE "ReleaseNote" (
-  "id" TEXT NOT NULL,
-  "title" TEXT NOT NULL,
-  "summary" TEXT NOT NULL,
-  "content" JSONB NOT NULL,
-  "targetBusinessRoles" "BusinessAccountType"[] NOT NULL DEFAULT ARRAY[]::"BusinessAccountType"[],
-  "status" "ReleaseNoteStatus" NOT NULL DEFAULT 'DRAFT',
-  "publishedAt" TIMESTAMP(3),
-  "createdById" TEXT,
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-
-  CONSTRAINT "ReleaseNote_pkey" PRIMARY KEY ("id"),
-  CONSTRAINT "ReleaseNote_createdById_fkey"
-    FOREIGN KEY ("createdById") REFERENCES "User"("id") ON DELETE SET NULL ON UPDATE CASCADE
-);
-
-CREATE TABLE "ReleaseNoteAcknowledgement" (
-  "id" TEXT NOT NULL,
-  "releaseNoteId" TEXT NOT NULL,
-  "readerId" TEXT NOT NULL,
-  "readAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-
-  CONSTRAINT "ReleaseNoteAcknowledgement_pkey" PRIMARY KEY ("id"),
-  CONSTRAINT "ReleaseNoteAcknowledgement_releaseNoteId_fkey"
-    FOREIGN KEY ("releaseNoteId") REFERENCES "ReleaseNote"("id") ON DELETE CASCADE ON UPDATE CASCADE,
-  CONSTRAINT "ReleaseNoteAcknowledgement_readerId_fkey"
-    FOREIGN KEY ("readerId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE
-);
-
-CREATE INDEX "ReleaseNote_status_publishedAt_idx" ON "ReleaseNote"("status", "publishedAt");
-CREATE INDEX "ReleaseNote_createdById_idx" ON "ReleaseNote"("createdById");
-CREATE UNIQUE INDEX "ReleaseNoteAcknowledgement_releaseNoteId_readerId_key" ON "ReleaseNoteAcknowledgement"("releaseNoteId", "readerId");
-CREATE INDEX "ReleaseNoteAcknowledgement_readerId_readAt_idx" ON "ReleaseNoteAcknowledgement"("readerId", "readAt");

furniture-3d-system/prisma/migrations/20260728190000_add_bom_costing_async_source_cache/migration.sql

@@ -1,91 +0,0 @@
-CREATE TYPE "BomCostingSourceStatus" AS ENUM (
-  'PENDING',
-  'FETCHING',
-  'ARCHIVING',
-  'READY',
-  'FAILED'
-);
-
-CREATE TYPE "BomCostingSourceAssetKind" AS ENUM (
-  'MAIN',
-  'DETAIL',
-  'SKU'
-);
-
-CREATE TYPE "BomCostingSourceAssetStatus" AS ENUM (
-  'PENDING',
-  'STORED',
-  'FAILED'
-);
-
-CREATE TABLE "BomCostingSourceSnapshot" (
-  "id" TEXT NOT NULL,
-  "sourceKey" TEXT NOT NULL,
-  "sourceUrl" TEXT NOT NULL,
-  "sourceHost" TEXT NOT NULL,
-  "channel" TEXT NOT NULL,
-  "externalItemId" TEXT NOT NULL,
-  "title" TEXT NOT NULL DEFAULT '',
-  "shopName" TEXT NOT NULL DEFAULT '',
-  "detailUrl" TEXT,
-  "status" "BomCostingSourceStatus" NOT NULL DEFAULT 'PENDING',
-  "skuCount" INTEGER NOT NULL DEFAULT 0,
-  "imageCount" INTEGER NOT NULL DEFAULT 0,
-  "storedImageCount" INTEGER NOT NULL DEFAULT 0,
-  "failedImageCount" INTEGER NOT NULL DEFAULT 0,
-  "rawSnapshot" JSONB,
-  "errorMessage" TEXT NOT NULL DEFAULT '',
-  "fetchedAt" TIMESTAMP(3),
-  "completedAt" TIMESTAMP(3),
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-  CONSTRAINT "BomCostingSourceSnapshot_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "BomCostingSourceAsset" (
-  "id" TEXT NOT NULL,
-  "sourceSnapshotId" TEXT NOT NULL,
-  "assetKey" TEXT NOT NULL,
-  "kind" "BomCostingSourceAssetKind" NOT NULL,
-  "status" "BomCostingSourceAssetStatus" NOT NULL DEFAULT 'PENDING',
-  "originalUrl" TEXT NOT NULL,
-  "storedUrl" TEXT NOT NULL DEFAULT '',
-  "storageKey" TEXT NOT NULL DEFAULT '',
-  "contentType" TEXT NOT NULL DEFAULT '',
-  "byteSize" INTEGER,
-  "externalSkuIds" JSONB NOT NULL DEFAULT '[]',
-  "sortOrder" INTEGER NOT NULL DEFAULT 0,
-  "errorMessage" TEXT NOT NULL DEFAULT '',
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-  CONSTRAINT "BomCostingSourceAsset_pkey" PRIMARY KEY ("id")
-);
-
-ALTER TABLE "BomCostingCase"
-  ADD COLUMN "sourceSnapshotId" TEXT,
-  ADD COLUMN "sourceCacheHit" BOOLEAN NOT NULL DEFAULT false,
-  ADD COLUMN "processingStartedAt" TIMESTAMP(3),
-  ADD COLUMN "processingFinishedAt" TIMESTAMP(3);
-
-CREATE UNIQUE INDEX "BomCostingSourceSnapshot_sourceKey_key"
-  ON "BomCostingSourceSnapshot"("sourceKey");
-CREATE INDEX "BomCostingSourceSnapshot_status_updatedAt_idx"
-  ON "BomCostingSourceSnapshot"("status", "updatedAt");
-CREATE INDEX "BomCostingSourceSnapshot_channel_externalItemId_idx"
-  ON "BomCostingSourceSnapshot"("channel", "externalItemId");
-CREATE UNIQUE INDEX "BomCostingSourceAsset_sourceSnapshotId_assetKey_key"
-  ON "BomCostingSourceAsset"("sourceSnapshotId", "assetKey");
-CREATE INDEX "BomCostingSourceAsset_sourceSnapshotId_status_sortOrder_idx"
-  ON "BomCostingSourceAsset"("sourceSnapshotId", "status", "sortOrder");
-CREATE INDEX "BomCostingCase_sourceSnapshotId_idx"
-  ON "BomCostingCase"("sourceSnapshotId");
-
-ALTER TABLE "BomCostingCase"
-  ADD CONSTRAINT "BomCostingCase_sourceSnapshotId_fkey"
-  FOREIGN KEY ("sourceSnapshotId") REFERENCES "BomCostingSourceSnapshot"("id")
-  ON DELETE SET NULL ON UPDATE CASCADE;
-
-ALTER TABLE "BomCostingSourceAsset"
-  ADD CONSTRAINT "BomCostingSourceAsset_sourceSnapshotId_fkey"
-  FOREIGN KEY ("sourceSnapshotId") REFERENCES "BomCostingSourceSnapshot"("id")
-  ON DELETE CASCADE ON UPDATE CASCADE;

furniture-3d-system/prisma/migrations/20260729143000_link_intake_ai_render_assets/migration.sql

@@ -1,188 +0,0 @@
-CREATE TYPE "IntakeAiRenderOutputMode" AS ENUM ('WHITE_BACKGROUND', 'EIGHT_VIEW', 'SCENE');
-CREATE TYPE "IntakeAiRenderStorageClass" AS ENUM ('TEMPORARY', 'PERMANENT');
-
-CREATE TABLE "IntakeProductModelAsset" (
-    "id" TEXT NOT NULL,
-    "productId" TEXT NOT NULL,
-    "modelKey" TEXT NOT NULL,
-    "displayName" TEXT NOT NULL DEFAULT '',
-    "createdBy" TEXT NOT NULL,
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-    CONSTRAINT "IntakeProductModelAsset_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "IntakeProductModelVersion" (
-    "id" TEXT NOT NULL,
-    "assetId" TEXT NOT NULL,
-    "versionNo" INTEGER NOT NULL,
-    "originalFileName" TEXT NOT NULL,
-    "mimeType" TEXT NOT NULL,
-    "fileSize" INTEGER NOT NULL,
-    "checksumSha256" TEXT NOT NULL DEFAULT '',
-    "sourceStorageKey" TEXT NOT NULL,
-    "sourceUrl" TEXT NOT NULL,
-    "previewStorageKey" TEXT,
-    "previewUrl" TEXT,
-    "createdBy" TEXT NOT NULL,
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    CONSTRAINT "IntakeProductModelVersion_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "IntakeSkuAiProfile" (
-    "id" TEXT NOT NULL,
-    "skuItemId" TEXT NOT NULL,
-    "currentModelVersionId" TEXT,
-    "currentMaterialVersionId" TEXT,
-    "createdBy" TEXT NOT NULL,
-    "updatedBy" TEXT,
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-    CONSTRAINT "IntakeSkuAiProfile_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "IntakeSkuAiMaterialVersion" (
-    "id" TEXT NOT NULL,
-    "profileId" TEXT NOT NULL,
-    "versionNo" INTEGER NOT NULL,
-    "materialColor" TEXT NOT NULL DEFAULT '#d8c6ad',
-    "textureStorageKey" TEXT,
-    "textureUrl" TEXT,
-    "nodeMaterials" JSONB,
-    "uvConfig" JSONB,
-    "createdBy" TEXT NOT NULL,
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    CONSTRAINT "IntakeSkuAiMaterialVersion_pkey" PRIMARY KEY ("id")
-);
-
-ALTER TABLE "AssistedAssemblyAiRender"
-ADD COLUMN "intakeSkuItemId" TEXT,
-ADD COLUMN "modelVersionId" TEXT,
-ADD COLUMN "materialVersionId" TEXT,
-ADD COLUMN "outputMode" "IntakeAiRenderOutputMode",
-ADD COLUMN "batchId" TEXT,
-ADD COLUMN "viewName" TEXT,
-ADD COLUMN "viewIndex" INTEGER,
-ADD COLUMN "storageClass" "IntakeAiRenderStorageClass" NOT NULL DEFAULT 'TEMPORARY';
-
-CREATE UNIQUE INDEX "IntakeProductModelAsset_productId_modelKey_key"
-ON "IntakeProductModelAsset"("productId", "modelKey");
-CREATE INDEX "IntakeProductModelAsset_productId_createdAt_idx"
-ON "IntakeProductModelAsset"("productId", "createdAt");
-CREATE INDEX "IntakeProductModelAsset_createdBy_idx"
-ON "IntakeProductModelAsset"("createdBy");
-
-CREATE UNIQUE INDEX "IntakeProductModelVersion_assetId_versionNo_key"
-ON "IntakeProductModelVersion"("assetId", "versionNo");
-CREATE INDEX "IntakeProductModelVersion_assetId_createdAt_idx"
-ON "IntakeProductModelVersion"("assetId", "createdAt");
-CREATE INDEX "IntakeProductModelVersion_checksumSha256_idx"
-ON "IntakeProductModelVersion"("checksumSha256");
-CREATE INDEX "IntakeProductModelVersion_createdBy_idx"
-ON "IntakeProductModelVersion"("createdBy");
-
-CREATE UNIQUE INDEX "IntakeSkuAiProfile_skuItemId_key"
-ON "IntakeSkuAiProfile"("skuItemId");
-CREATE UNIQUE INDEX "IntakeSkuAiProfile_currentMaterialVersionId_key"
-ON "IntakeSkuAiProfile"("currentMaterialVersionId");
-CREATE INDEX "IntakeSkuAiProfile_currentModelVersionId_idx"
-ON "IntakeSkuAiProfile"("currentModelVersionId");
-CREATE INDEX "IntakeSkuAiProfile_createdBy_idx"
-ON "IntakeSkuAiProfile"("createdBy");
-
-CREATE UNIQUE INDEX "IntakeSkuAiMaterialVersion_profileId_versionNo_key"
-ON "IntakeSkuAiMaterialVersion"("profileId", "versionNo");
-CREATE INDEX "IntakeSkuAiMaterialVersion_profileId_createdAt_idx"
-ON "IntakeSkuAiMaterialVersion"("profileId", "createdAt");
-CREATE INDEX "IntakeSkuAiMaterialVersion_createdBy_idx"
-ON "IntakeSkuAiMaterialVersion"("createdBy");
-
-CREATE INDEX "AssistedAssemblyAiRender_intakeSkuItemId_createdAt_idx"
-ON "AssistedAssemblyAiRender"("intakeSkuItemId", "createdAt");
-CREATE INDEX "AssistedAssemblyAiRender_intakeSkuItemId_outputMode_createdAt_idx"
-ON "AssistedAssemblyAiRender"("intakeSkuItemId", "outputMode", "createdAt");
-CREATE INDEX "AssistedAssemblyAiRender_modelVersionId_idx"
-ON "AssistedAssemblyAiRender"("modelVersionId");
-CREATE INDEX "AssistedAssemblyAiRender_materialVersionId_idx"
-ON "AssistedAssemblyAiRender"("materialVersionId");
-CREATE INDEX "AssistedAssemblyAiRender_storageClass_createdAt_idx"
-ON "AssistedAssemblyAiRender"("storageClass", "createdAt");
-
-ALTER TABLE "IntakeProductModelAsset"
-ADD CONSTRAINT "IntakeProductModelAsset_productId_fkey"
-FOREIGN KEY ("productId") REFERENCES "IntakeNonIntegratedProduct"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-ALTER TABLE "IntakeProductModelAsset"
-ADD CONSTRAINT "IntakeProductModelAsset_createdBy_fkey"
-FOREIGN KEY ("createdBy") REFERENCES "User"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
-
-ALTER TABLE "IntakeProductModelVersion"
-ADD CONSTRAINT "IntakeProductModelVersion_assetId_fkey"
-FOREIGN KEY ("assetId") REFERENCES "IntakeProductModelAsset"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-ALTER TABLE "IntakeProductModelVersion"
-ADD CONSTRAINT "IntakeProductModelVersion_createdBy_fkey"
-FOREIGN KEY ("createdBy") REFERENCES "User"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
-
-ALTER TABLE "IntakeSkuAiProfile"
-ADD CONSTRAINT "IntakeSkuAiProfile_skuItemId_fkey"
-FOREIGN KEY ("skuItemId") REFERENCES "IntakeNonIntegratedSkuItem"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-ALTER TABLE "IntakeSkuAiProfile"
-ADD CONSTRAINT "IntakeSkuAiProfile_currentModelVersionId_fkey"
-FOREIGN KEY ("currentModelVersionId") REFERENCES "IntakeProductModelVersion"("id") ON DELETE SET NULL ON UPDATE CASCADE;
-ALTER TABLE "IntakeSkuAiProfile"
-ADD CONSTRAINT "IntakeSkuAiProfile_createdBy_fkey"
-FOREIGN KEY ("createdBy") REFERENCES "User"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
-
-ALTER TABLE "IntakeSkuAiMaterialVersion"
-ADD CONSTRAINT "IntakeSkuAiMaterialVersion_profileId_fkey"
-FOREIGN KEY ("profileId") REFERENCES "IntakeSkuAiProfile"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-ALTER TABLE "IntakeSkuAiMaterialVersion"
-ADD CONSTRAINT "IntakeSkuAiMaterialVersion_createdBy_fkey"
-FOREIGN KEY ("createdBy") REFERENCES "User"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
-
-ALTER TABLE "IntakeSkuAiProfile"
-ADD CONSTRAINT "IntakeSkuAiProfile_currentMaterialVersionId_fkey"
-FOREIGN KEY ("currentMaterialVersionId") REFERENCES "IntakeSkuAiMaterialVersion"("id") ON DELETE SET NULL ON UPDATE CASCADE;
-
-ALTER TABLE "AssistedAssemblyAiRender"
-ADD CONSTRAINT "AssistedAssemblyAiRender_intakeSkuItemId_fkey"
-FOREIGN KEY ("intakeSkuItemId") REFERENCES "IntakeNonIntegratedSkuItem"("id") ON DELETE SET NULL ON UPDATE CASCADE;
-ALTER TABLE "AssistedAssemblyAiRender"
-ADD CONSTRAINT "AssistedAssemblyAiRender_modelVersionId_fkey"
-FOREIGN KEY ("modelVersionId") REFERENCES "IntakeProductModelVersion"("id") ON DELETE SET NULL ON UPDATE CASCADE;
-ALTER TABLE "AssistedAssemblyAiRender"
-ADD CONSTRAINT "AssistedAssemblyAiRender_materialVersionId_fkey"
-FOREIGN KEY ("materialVersionId") REFERENCES "IntakeSkuAiMaterialVersion"("id") ON DELETE SET NULL ON UPDATE CASCADE;
-
-UPDATE "AssistedAssemblyAiRender"
-SET
-  "outputMode" = CASE
-    WHEN "params"->>'mode' = 'white-background' THEN 'WHITE_BACKGROUND'::"IntakeAiRenderOutputMode"
-    WHEN "params"->>'mode' = 'eight-view' THEN 'EIGHT_VIEW'::"IntakeAiRenderOutputMode"
-    WHEN "params"->>'mode' = 'scene' THEN 'SCENE'::"IntakeAiRenderOutputMode"
-    ELSE NULL
-  END,
-  "batchId" = NULLIF("params"->>'batchId', ''),
-  "viewName" = NULLIF("params"->>'viewName', ''),
-  "viewIndex" = CASE
-    WHEN ("params"->>'viewIndex') ~ '^[0-9]+$' THEN ("params"->>'viewIndex')::INTEGER
-    ELSE NULL
-  END;
-
-WITH exact_matches AS (
-  SELECT render."id" AS "renderId", MIN(item."id") AS "skuItemId"
-  FROM "AssistedAssemblyAiRender" render
-  JOIN "AiRenderWorkbenchSku" workbench_sku ON workbench_sku."id" = render."workbenchSkuId"
-  JOIN "AiRenderWorkbenchSpu" workbench_spu ON workbench_spu."id" = workbench_sku."spuId"
-  JOIN "IntakeNonIntegratedSkuItem" item
-    ON UPPER(BTRIM(item."barcode")) = UPPER(BTRIM(workbench_sku."name"))
-  JOIN "IntakeNonIntegratedProduct" product
-    ON product."id" = item."productId"
-   AND UPPER(BTRIM(product."spu")) = UPPER(BTRIM(workbench_spu."name"))
-  WHERE BTRIM(item."barcode") <> ''
-  GROUP BY render."id"
-  HAVING COUNT(*) = 1
-)
-UPDATE "AssistedAssemblyAiRender" render
-SET "intakeSkuItemId" = exact_matches."skuItemId"
-FROM exact_matches
-WHERE render."id" = exact_matches."renderId";

furniture-3d-system/prisma/migrations/20260730150000_add_bom_costing_source_fact_analysis/migration.sql

@@ -1,49 +0,0 @@
--- CreateEnum
-CREATE TYPE "BomCostingFactAnalysisStatus" AS ENUM (
-    'PENDING',
-    'PROCESSING',
-    'READY',
-    'FAILED'
-);
-
--- CreateTable
-CREATE TABLE "BomCostingSourceFactAnalysis" (
-    "id" TEXT NOT NULL,
-    "sourceSnapshotId" TEXT NOT NULL,
-    "schemaVersion" TEXT NOT NULL,
-    "assetFingerprint" TEXT NOT NULL,
-    "status" "BomCostingFactAnalysisStatus" NOT NULL DEFAULT 'PENDING',
-    "model" TEXT NOT NULL DEFAULT '',
-    "factSnapshot" JSONB,
-    "analyzedImageCount" INTEGER NOT NULL DEFAULT 0,
-    "totalImageCount" INTEGER NOT NULL DEFAULT 0,
-    "batchCount" INTEGER NOT NULL DEFAULT 0,
-    "promptTokens" INTEGER NOT NULL DEFAULT 0,
-    "completionTokens" INTEGER NOT NULL DEFAULT 0,
-    "durationMs" INTEGER NOT NULL DEFAULT 0,
-    "errorMessage" TEXT NOT NULL DEFAULT '',
-    "startedAt" TIMESTAMP(3),
-    "completedAt" TIMESTAMP(3),
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-
-    CONSTRAINT "BomCostingSourceFactAnalysis_pkey" PRIMARY KEY ("id")
-);
-
--- CreateIndex
-CREATE UNIQUE INDEX "BomCostingSourceFactAnalysis_sourceSnapshotId_schemaVersion_key"
-ON "BomCostingSourceFactAnalysis"("sourceSnapshotId", "schemaVersion");
-
--- CreateIndex
-CREATE INDEX "BomCostingSourceFactAnalysis_sourceSnapshotId_status_idx"
-ON "BomCostingSourceFactAnalysis"("sourceSnapshotId", "status");
-
--- CreateIndex
-CREATE INDEX "BomCostingSourceFactAnalysis_status_updatedAt_idx"
-ON "BomCostingSourceFactAnalysis"("status", "updatedAt");
-
--- AddForeignKey
-ALTER TABLE "BomCostingSourceFactAnalysis"
-ADD CONSTRAINT "BomCostingSourceFactAnalysis_sourceSnapshotId_fkey"
-FOREIGN KEY ("sourceSnapshotId") REFERENCES "BomCostingSourceSnapshot"("id")
-ON DELETE CASCADE ON UPDATE CASCADE;

furniture-3d-system/prisma/migrations/20260730150000_barcode_print_append_only/migration.sql

@@ -1,27 +0,0 @@
--- Barcode imports are append-only business records. Rows with the same SKU,
--- barcode, or supplier must remain independently printable.
-ALTER TABLE "BarcodePrintImportRecord"
-  ADD COLUMN "normalizedSupplierName" TEXT NOT NULL DEFAULT '';
-
-WITH supplier_names AS (
-  SELECT
-    "id",
-    btrim(
-      CASE
-        WHEN btrim("supplierName") <> '' THEN "supplierName"
-        ELSE COALESCE("updates" ->> 'supplierName', '')
-      END
-    ) AS "supplierName"
-  FROM "BarcodePrintImportRecord"
-)
-UPDATE "BarcodePrintImportRecord" AS records
-SET
-  "supplierName" = supplier_names."supplierName",
-  "normalizedSupplierName" = lower(supplier_names."supplierName")
-FROM supplier_names
-WHERE records."id" = supplier_names."id";
-
-DROP INDEX "BarcodePrintImportRecord_kind_normalizedSku_supplierCode_key";
-
-CREATE INDEX "BarcodePrintImportRecord_normalizedSupplierName_idx"
-  ON "BarcodePrintImportRecord"("normalizedSupplierName");

furniture-3d-system/prisma/migrations/20260730193000_add_bom_costing_recalculation_runs/migration.sql

@@ -1,140 +0,0 @@
-CREATE TYPE "BomCostingFactAnalysisOrigin" AS ENUM (
-  'INITIAL',
-  'SELECTED_REANALYSIS',
-  'FULL_REANALYSIS'
-);
-
-CREATE TYPE "BomCostingAnalysisRunMode" AS ENUM (
-  'INITIAL',
-  'REUSE_FACTS',
-  'REANALYZE_SELECTED',
-  'REANALYZE_ALL'
-);
-
-CREATE TYPE "BomCostingAnalysisRunStatus" AS ENUM (
-  'PENDING',
-  'PROCESSING',
-  'READY',
-  'FAILED'
-);
-
-ALTER TABLE "BomCostingSourceFactAnalysis"
-  ADD COLUMN "revision" INTEGER NOT NULL DEFAULT 1,
-  ADD COLUMN "origin" "BomCostingFactAnalysisOrigin" NOT NULL DEFAULT 'INITIAL',
-  ADD COLUMN "baseAnalysisId" TEXT,
-  ADD COLUMN "selectedAssetIds" JSONB NOT NULL DEFAULT '[]';
-
-DROP INDEX "BomCostingSourceFactAnalysis_sourceSnapshotId_schemaVersion_key";
-
-CREATE UNIQUE INDEX "BomCostingSourceFactAnalysis_sourceSnapshotId_schemaVersion_revision_key"
-ON "BomCostingSourceFactAnalysis"("sourceSnapshotId", "schemaVersion", "revision");
-
-CREATE INDEX "BomCostingSourceFactAnalysis_baseAnalysisId_idx"
-ON "BomCostingSourceFactAnalysis"("baseAnalysisId");
-
-ALTER TABLE "BomCostingSourceFactAnalysis"
-ADD CONSTRAINT "BomCostingSourceFactAnalysis_baseAnalysisId_fkey"
-FOREIGN KEY ("baseAnalysisId") REFERENCES "BomCostingSourceFactAnalysis"("id")
-ON DELETE SET NULL ON UPDATE CASCADE;
-
-CREATE TABLE "BomCostingAnalysisRun" (
-  "id" TEXT NOT NULL,
-  "caseId" TEXT NOT NULL,
-  "revision" INTEGER NOT NULL,
-  "mode" "BomCostingAnalysisRunMode" NOT NULL,
-  "status" "BomCostingAnalysisRunStatus" NOT NULL DEFAULT 'PENDING',
-  "factAnalysisId" TEXT,
-  "selectedAssetIds" JSONB NOT NULL DEFAULT '[]',
-  "instruction" TEXT NOT NULL DEFAULT '',
-  "resultSnapshot" JSONB,
-  "model" TEXT NOT NULL DEFAULT '',
-  "callId" TEXT NOT NULL DEFAULT '',
-  "promptTokens" INTEGER NOT NULL DEFAULT 0,
-  "completionTokens" INTEGER NOT NULL DEFAULT 0,
-  "durationMs" INTEGER NOT NULL DEFAULT 0,
-  "errorMessage" TEXT NOT NULL DEFAULT '',
-  "createdById" TEXT,
-  "startedAt" TIMESTAMP(3),
-  "completedAt" TIMESTAMP(3),
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-
-  CONSTRAINT "BomCostingAnalysisRun_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "BomCostingAnalysisRun_caseId_revision_key"
-ON "BomCostingAnalysisRun"("caseId", "revision");
-
-CREATE INDEX "BomCostingAnalysisRun_caseId_status_idx"
-ON "BomCostingAnalysisRun"("caseId", "status");
-
-CREATE INDEX "BomCostingAnalysisRun_factAnalysisId_idx"
-ON "BomCostingAnalysisRun"("factAnalysisId");
-
-CREATE INDEX "BomCostingAnalysisRun_status_updatedAt_idx"
-ON "BomCostingAnalysisRun"("status", "updatedAt");
-
-CREATE INDEX "BomCostingAnalysisRun_createdById_idx"
-ON "BomCostingAnalysisRun"("createdById");
-
-ALTER TABLE "BomCostingAnalysisRun"
-ADD CONSTRAINT "BomCostingAnalysisRun_caseId_fkey"
-FOREIGN KEY ("caseId") REFERENCES "BomCostingCase"("id")
-ON DELETE CASCADE ON UPDATE CASCADE;
-
-ALTER TABLE "BomCostingAnalysisRun"
-ADD CONSTRAINT "BomCostingAnalysisRun_factAnalysisId_fkey"
-FOREIGN KEY ("factAnalysisId") REFERENCES "BomCostingSourceFactAnalysis"("id")
-ON DELETE SET NULL ON UPDATE CASCADE;
-
-ALTER TABLE "BomCostingAnalysisRun"
-ADD CONSTRAINT "BomCostingAnalysisRun_createdById_fkey"
-FOREIGN KEY ("createdById") REFERENCES "User"("id")
-ON DELETE SET NULL ON UPDATE CASCADE;
-
-INSERT INTO "BomCostingAnalysisRun" (
-  "id",
-  "caseId",
-  "revision",
-  "mode",
-  "status",
-  "factAnalysisId",
-  "resultSnapshot",
-  "model",
-  "callId",
-  "errorMessage",
-  "createdById",
-  "startedAt",
-  "completedAt",
-  "createdAt",
-  "updatedAt"
-)
-SELECT
-  'legacy-' || c."id",
-  c."id",
-  1,
-  'INITIAL'::"BomCostingAnalysisRunMode",
-  CASE c."status"
-    WHEN 'ANALYZING' THEN 'PROCESSING'::"BomCostingAnalysisRunStatus"
-    WHEN 'READY' THEN 'READY'::"BomCostingAnalysisRunStatus"
-    WHEN 'FAILED' THEN 'FAILED'::"BomCostingAnalysisRunStatus"
-    ELSE 'PENDING'::"BomCostingAnalysisRunStatus"
-  END,
-  (
-    SELECT f."id"
-    FROM "BomCostingSourceFactAnalysis" f
-    WHERE f."sourceSnapshotId" = c."sourceSnapshotId"
-      AND f."schemaVersion" = 'competitor-facts/v1'
-    ORDER BY f."revision" DESC
-    LIMIT 1
-  ),
-  c."rawAnalysisSnapshot",
-  '',
-  c."providerTaskId",
-  CASE WHEN c."status" = 'FAILED' THEN c."statusMessage" ELSE '' END,
-  c."createdById",
-  c."processingStartedAt",
-  c."processingFinishedAt",
-  c."createdAt",
-  c."updatedAt"
-FROM "BomCostingCase" c;

furniture-3d-system/prisma/migrations/20260731100000_add_bom_costing_review_inputs/migration.sql

@@ -1,39 +0,0 @@
--- CreateEnum
-CREATE TYPE "BomCostingReviewInputSource" AS ENUM ('MANUAL', 'LIBRARY_MATCH');
-
--- CreateTable
-CREATE TABLE "BomCostingReviewInput" (
-    "id" TEXT NOT NULL,
-    "caseId" TEXT NOT NULL,
-    "skuId" TEXT NOT NULL,
-    "lineId" TEXT NOT NULL,
-    "createdById" TEXT,
-    "source" "BomCostingReviewInputSource" NOT NULL DEFAULT 'MANUAL',
-    "lengthMm" DECIMAL(12,3),
-    "widthMm" DECIMAL(12,3),
-    "heightMm" DECIMAL(12,3),
-    "quantity" DECIMAL(12,4),
-    "materialCode" TEXT NOT NULL DEFAULT '',
-    "materialName" TEXT NOT NULL DEFAULT '',
-    "materialSpec" TEXT NOT NULL DEFAULT '',
-    "unitPrice" DECIMAL(12,4),
-    "priceUnit" TEXT NOT NULL DEFAULT '',
-    "currency" TEXT NOT NULL DEFAULT 'CNY',
-    "lossFactor" DECIMAL(8,4),
-    "subtotal" DECIMAL(12,2),
-    "note" TEXT NOT NULL DEFAULT '',
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-
-    CONSTRAINT "BomCostingReviewInput_pkey" PRIMARY KEY ("id")
-);
-
--- CreateIndex
-CREATE INDEX "BomCostingReviewInput_caseId_createdAt_idx" ON "BomCostingReviewInput"("caseId", "createdAt");
-CREATE INDEX "BomCostingReviewInput_lineId_createdAt_idx" ON "BomCostingReviewInput"("lineId", "createdAt");
-CREATE INDEX "BomCostingReviewInput_createdById_createdAt_idx" ON "BomCostingReviewInput"("createdById", "createdAt");
-
--- AddForeignKey
-ALTER TABLE "BomCostingReviewInput" ADD CONSTRAINT "BomCostingReviewInput_caseId_fkey" FOREIGN KEY ("caseId") REFERENCES "BomCostingCase"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-ALTER TABLE "BomCostingReviewInput" ADD CONSTRAINT "BomCostingReviewInput_skuId_fkey" FOREIGN KEY ("skuId") REFERENCES "BomCostingSku"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-ALTER TABLE "BomCostingReviewInput" ADD CONSTRAINT "BomCostingReviewInput_lineId_fkey" FOREIGN KEY ("lineId") REFERENCES "BomCostingLine"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-ALTER TABLE "BomCostingReviewInput" ADD CONSTRAINT "BomCostingReviewInput_createdById_fkey" FOREIGN KEY ("createdById") REFERENCES "User"("id") ON DELETE SET NULL ON UPDATE CASCADE;

furniture-3d-system/prisma/migrations/20260731103000_preserve_bom_costing_review_history/migration.sql

@@ -1,23 +0,0 @@
--- Keep manual review history when a recalculation replaces the current SKU/BOM rows.
-ALTER TABLE "BomCostingReviewInput"
-    ADD COLUMN "skuExternalId" TEXT NOT NULL DEFAULT '',
-    ADD COLUMN "lineExternalId" TEXT NOT NULL DEFAULT '',
-    ADD COLUMN "skuName" TEXT NOT NULL DEFAULT '',
-    ADD COLUMN "partName" TEXT NOT NULL DEFAULT '';
-
-ALTER TABLE "BomCostingReviewInput"
-    ALTER COLUMN "skuId" DROP NOT NULL,
-    ALTER COLUMN "lineId" DROP NOT NULL;
-
-ALTER TABLE "BomCostingReviewInput"
-    DROP CONSTRAINT "BomCostingReviewInput_skuId_fkey",
-    DROP CONSTRAINT "BomCostingReviewInput_lineId_fkey";
-
-ALTER TABLE "BomCostingReviewInput"
-    ADD CONSTRAINT "BomCostingReviewInput_skuId_fkey"
-      FOREIGN KEY ("skuId") REFERENCES "BomCostingSku"("id") ON DELETE SET NULL ON UPDATE CASCADE,
-    ADD CONSTRAINT "BomCostingReviewInput_lineId_fkey"
-      FOREIGN KEY ("lineId") REFERENCES "BomCostingLine"("id") ON DELETE SET NULL ON UPDATE CASCADE;
-
-CREATE INDEX "BomCostingReviewInput_caseId_skuExternalId_lineExternalId_createdAt_idx"
-  ON "BomCostingReviewInput"("caseId", "skuExternalId", "lineExternalId", "createdAt");

furniture-3d-system/prisma/migrations/20260731113000_barcode_print_page_query_indexes/migration.sql

@@ -1,15 +0,0 @@
--- Keep barcode printing page reads on indexed orderings instead of scanning imports.
-CREATE INDEX "BarcodePrintImportRecord_kind_createdAt_id_idx"
-  ON "BarcodePrintImportRecord"("kind", "createdAt", "id");
-
-CREATE INDEX "BarcodePrintImportRecord_kind_normalizedSupplierName_createdAt_id_idx"
-  ON "BarcodePrintImportRecord"("kind", "normalizedSupplierName", "createdAt", "id");
-
-CREATE INDEX "BarcodePrintImportRecord_kind_supplierCode_createdAt_id_idx"
-  ON "BarcodePrintImportRecord"("kind", "supplierCode", "createdAt", "id");
-
-CREATE INDEX "BarcodePrintImportRecord_kind_normalizedSku_createdAt_id_idx"
-  ON "BarcodePrintImportRecord"("kind", "normalizedSku", "createdAt", "id");
-
-CREATE INDEX "IntakeNonIntegratedPricingRow_systemEnteredAt_productId_idx"
-  ON "IntakeNonIntegratedPricingRow"("systemEnteredAt", "productId");

furniture-3d-system/prisma/migrations/20260731153000_barcode_print_system_source/migration.sql

@@ -1,173 +0,0 @@
--- Keep the barcode-print list in one append-only primary-record table.
--- Imported rows keep sourcePricingRowId NULL, so this does not introduce an
--- Excel import de-duplication rule.
-ALTER TABLE "BarcodePrintImportRecord"
-  ADD COLUMN "sourcePricingRowId" TEXT;
-
-CREATE UNIQUE INDEX "BarcodePrintImportRecord_sourcePricingRowId_key"
-  ON "BarcodePrintImportRecord"("sourcePricingRowId");
-
-CREATE OR REPLACE FUNCTION "sync_barcode_print_system_pricing_row"()
-RETURNS trigger
-LANGUAGE plpgsql
-AS $$
-DECLARE
-  resolved_sku_code TEXT;
-BEGIN
-  IF TG_OP = 'DELETE' THEN
-    DELETE FROM "BarcodePrintImportRecord"
-    WHERE "sourcePricingRowId" = OLD."id";
-    RETURN OLD;
-  END IF;
-
-  SELECT COALESCE(NULLIF(BTRIM(NEW."skuCode"), ''), NULLIF(BTRIM(s."skuCode"), ''))
-  INTO resolved_sku_code
-  FROM "IntakeNonIntegratedSkuItem" s
-  WHERE s."productId" = NEW."productId"
-    AND s."skuItemId" = NEW."skuItemId";
-
-  IF NEW."systemEnteredAt" IS NULL OR resolved_sku_code IS NULL THEN
-    DELETE FROM "BarcodePrintImportRecord"
-    WHERE "sourcePricingRowId" = NEW."id";
-    RETURN NEW;
-  END IF;
-
-  INSERT INTO "BarcodePrintImportRecord" (
-    "id", "kind", "sourcePricingRowId", "skuCode", "normalizedSku",
-    "supplierCode", "supplierName", "normalizedSupplierName",
-    "sourceFileName", "rowNumber", "importedAt", "updates", "createdBy",
-    "createdAt", "updatedAt"
-  )
-  SELECT
-    'barcode-print-system-' || NEW."id",
-    'barcode',
-    NEW."id",
-    resolved_sku_code,
-    UPPER(BTRIM(resolved_sku_code)),
-    COALESCE(s."manufacturerCode", ''),
-    COALESCE(s."manufacturer", ''),
-    LOWER(BTRIM(COALESCE(s."manufacturer", ''))),
-    '系统自动进入',
-    0,
-    NEW."systemEnteredAt",
-    jsonb_build_object(
-      'spu', product."spu",
-      'model', s."model",
-      'skuCode', resolved_sku_code,
-      'barcode', COALESCE(NULLIF(NEW."barcode", ''), s."barcode", ''),
-      'barcodeSpecName', s."specName",
-      'attributeCode', s."attributeCode",
-      'drawingId', s."drawingId",
-      'productCategory', COALESCE(profile."productCategory", ''),
-      'salesCategory', COALESCE(profile."salesCategory", ''),
-      'materialType', COALESCE(profile."materialType", s."boardMaterialType", ''),
-      'size', COALESCE(NULLIF(s."size", ''), profile."size", ''),
-      'color', COALESCE(NULLIF(s."color", ''), profile."color", ''),
-      'material', s."material",
-      'executeStandard', s."executeStandard",
-      'tagMaterial', COALESCE(NULLIF(profile."tagMaterial", ''), s."material", ''),
-      'supplierCode', s."manufacturerCode",
-      'supplierName', s."manufacturer",
-      'costPrice', COALESCE(NEW."costPrice"::TEXT, ''),
-      'productPlanning', COALESCE(profile."productPlanning", ''),
-      'visualPlanning', COALESCE(profile."visualPlanning", ''),
-      'spuOwner', COALESCE(profile."spuOwner", ''),
-      'operationsOwner', COALESCE(profile."operationsOwner", product."operator", ''),
-      'purchaseOwner', COALESCE(profile."purchaseOwner", product."purchaser", ''),
-      'productionType', COALESCE(profile."productionType", ''),
-      'assemblyDetail', s."installMethod",
-      'createdAt', TO_CHAR(NEW."systemEnteredAt", 'YYYY-MM-DD'),
-      'dataSource', '流程'
-    ),
-    product."createdBy",
-    NEW."systemEnteredAt",
-    NOW()
-  FROM "IntakeNonIntegratedSkuItem" s
-  INNER JOIN "IntakeNonIntegratedProduct" product
-    ON product."id" = NEW."productId"
-  LEFT JOIN "IntakeNonIntegratedProductProfile" profile
-    ON profile."productId" = product."id"
-  WHERE s."productId" = NEW."productId"
-    AND s."skuItemId" = NEW."skuItemId"
-  ON CONFLICT ("sourcePricingRowId") DO UPDATE
-  SET
-    "skuCode" = EXCLUDED."skuCode",
-    "normalizedSku" = EXCLUDED."normalizedSku",
-    "supplierCode" = EXCLUDED."supplierCode",
-    "supplierName" = EXCLUDED."supplierName",
-    "normalizedSupplierName" = EXCLUDED."normalizedSupplierName",
-    "updates" = EXCLUDED."updates",
-    "updatedAt" = EXCLUDED."updatedAt";
-
-  RETURN NEW;
-END;
-$$;
-
-CREATE TRIGGER "sync_barcode_print_system_pricing_row_trigger"
-AFTER INSERT OR UPDATE OR DELETE ON "IntakeNonIntegratedPricingRow"
-FOR EACH ROW
-EXECUTE FUNCTION "sync_barcode_print_system_pricing_row"();
-
--- Existing system-entered SKUs need the same primary records before the list
--- switches to this table. The conflict target makes the backfill idempotent.
-INSERT INTO "BarcodePrintImportRecord" (
-  "id", "kind", "sourcePricingRowId", "skuCode", "normalizedSku",
-  "supplierCode", "supplierName", "normalizedSupplierName",
-  "sourceFileName", "rowNumber", "importedAt", "updates", "createdBy",
-  "createdAt", "updatedAt"
-)
-SELECT
-  'barcode-print-system-' || pricing."id",
-  'barcode',
-  pricing."id",
-  COALESCE(NULLIF(BTRIM(pricing."skuCode"), ''), s."skuCode"),
-  UPPER(BTRIM(COALESCE(NULLIF(pricing."skuCode", ''), s."skuCode"))),
-  COALESCE(s."manufacturerCode", ''),
-  COALESCE(s."manufacturer", ''),
-  LOWER(BTRIM(COALESCE(s."manufacturer", ''))),
-  '系统自动进入',
-  0,
-  pricing."systemEnteredAt",
-  jsonb_build_object(
-    'spu', product."spu",
-    'model', s."model",
-    'skuCode', COALESCE(NULLIF(BTRIM(pricing."skuCode"), ''), s."skuCode"),
-    'barcode', COALESCE(NULLIF(pricing."barcode", ''), s."barcode", ''),
-    'barcodeSpecName', s."specName",
-    'attributeCode', s."attributeCode",
-    'drawingId', s."drawingId",
-    'productCategory', COALESCE(profile."productCategory", ''),
-    'salesCategory', COALESCE(profile."salesCategory", ''),
-    'materialType', COALESCE(profile."materialType", s."boardMaterialType", ''),
-    'size', COALESCE(NULLIF(s."size", ''), profile."size", ''),
-    'color', COALESCE(NULLIF(s."color", ''), profile."color", ''),
-    'material', s."material",
-    'executeStandard', s."executeStandard",
-    'tagMaterial', COALESCE(NULLIF(profile."tagMaterial", ''), s."material", ''),
-    'supplierCode', s."manufacturerCode",
-    'supplierName', s."manufacturer",
-    'costPrice', COALESCE(pricing."costPrice"::TEXT, ''),
-    'productPlanning', COALESCE(profile."productPlanning", ''),
-    'visualPlanning', COALESCE(profile."visualPlanning", ''),
-    'spuOwner', COALESCE(profile."spuOwner", ''),
-    'operationsOwner', COALESCE(profile."operationsOwner", product."operator", ''),
-    'purchaseOwner', COALESCE(profile."purchaseOwner", product."purchaser", ''),
-    'productionType', COALESCE(profile."productionType", ''),
-    'assemblyDetail', s."installMethod",
-    'createdAt', TO_CHAR(pricing."systemEnteredAt", 'YYYY-MM-DD'),
-    'dataSource', '流程'
-  ),
-  product."createdBy",
-  pricing."systemEnteredAt",
-  NOW()
-FROM "IntakeNonIntegratedPricingRow" pricing
-INNER JOIN "IntakeNonIntegratedSkuItem" s
-  ON s."productId" = pricing."productId"
-  AND s."skuItemId" = pricing."skuItemId"
-INNER JOIN "IntakeNonIntegratedProduct" product
-  ON product."id" = pricing."productId"
-LEFT JOIN "IntakeNonIntegratedProductProfile" profile
-  ON profile."productId" = product."id"
-WHERE pricing."systemEnteredAt" IS NOT NULL
-  AND BTRIM(COALESCE(NULLIF(pricing."skuCode", ''), s."skuCode")) <> ''
-ON CONFLICT ("sourcePricingRowId") DO NOTHING;

furniture-3d-system/prisma/migrations/20260803183000_add_jst_sku_archive_source_fields/migration.sql

@@ -1,5 +0,0 @@
-ALTER TABLE "IntakeNonIntegratedSkuItem"
-  ADD COLUMN IF NOT EXISTS "sourceWeight" DECIMAL(18, 3),
-  ADD COLUMN IF NOT EXISTS "sourceBrand" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN IF NOT EXISTS "sourceCreatedAt" TIMESTAMP(3),
-  ADD COLUMN IF NOT EXISTS "sourceUpdatedAt" TIMESTAMP(3);

furniture-3d-system/prisma/migrations/20260804114000_allow_duplicate_intake_sku_codes/migration.sql

@@ -1,3 +0,0 @@
--- Product archive rows use barcode as the unique item identity. SKU codes may
--- repeat across different barcodes and therefore remain searchable, not unique.
-DROP INDEX IF EXISTS "IntakeNonIntegratedSkuItem_skuCode_non_empty_key";

furniture-3d-system/prisma/migrations/20260804144500_add_supply_chain_product_archive/migration.sql

@@ -1,85 +0,0 @@
-CREATE TABLE "SupplyChainProductArchive" (
-    "id" TEXT NOT NULL,
-    "barcode" TEXT NOT NULL,
-    "spu" TEXT NOT NULL DEFAULT '',
-    "sku" TEXT NOT NULL DEFAULT '',
-    "image" TEXT,
-    "businessCreatedAt" TIMESTAMP(3) NOT NULL,
-    "categoryL1" TEXT NOT NULL DEFAULT '',
-    "categoryL2" TEXT NOT NULL DEFAULT '',
-    "productName" TEXT NOT NULL DEFAULT '',
-    "designer" TEXT NOT NULL DEFAULT '',
-    "productStatus" TEXT NOT NULL DEFAULT '',
-    "material" TEXT NOT NULL DEFAULT '',
-    "color" TEXT NOT NULL DEFAULT '',
-    "weight" DECIMAL(18,3),
-    "length" DECIMAL(18,3),
-    "width" DECIMAL(18,3),
-    "height" DECIMAL(18,3),
-    "volume" DECIMAL(24,3),
-    "packType" TEXT NOT NULL DEFAULT '',
-    "productTag" TEXT NOT NULL DEFAULT '',
-    "installDocId" TEXT NOT NULL DEFAULT '',
-    "spec" TEXT NOT NULL DEFAULT '',
-    "brand" TEXT NOT NULL DEFAULT '',
-    "orderType" TEXT NOT NULL DEFAULT '',
-    "storageType" TEXT NOT NULL DEFAULT '',
-    "isSeasonal" TEXT NOT NULL DEFAULT '',
-    "replaceCount" TEXT NOT NULL DEFAULT '',
-    "firstSourceCode" TEXT NOT NULL DEFAULT 'PRODUCT_DEVELOPMENT',
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-
-    CONSTRAINT "SupplyChainProductArchive_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "SupplyChainProductArchiveSource" (
-    "id" TEXT NOT NULL,
-    "archiveId" TEXT NOT NULL,
-    "sourceCode" TEXT NOT NULL,
-    "entryMode" TEXT NOT NULL DEFAULT 'AUTO',
-    "sourceRecordId" TEXT NOT NULL,
-    "sourceProductId" TEXT NOT NULL DEFAULT '',
-    "sourceSkuItemId" TEXT NOT NULL DEFAULT '',
-    "sourceCreatedAt" TIMESTAMP(3),
-    "lastSyncedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-
-    CONSTRAINT "SupplyChainProductArchiveSource_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "SupplyChainProductArchive_barcode_key"
-  ON "SupplyChainProductArchive"("barcode");
-CREATE INDEX "SupplyChainProductArchive_spu_idx"
-  ON "SupplyChainProductArchive"("spu");
-CREATE INDEX "SupplyChainProductArchive_sku_idx"
-  ON "SupplyChainProductArchive"("sku");
-CREATE INDEX "SupplyChainProductArchive_businessCreatedAt_idx"
-  ON "SupplyChainProductArchive"("businessCreatedAt");
-CREATE INDEX "SupplyChainProductArchive_categoryL1_idx"
-  ON "SupplyChainProductArchive"("categoryL1");
-CREATE INDEX "SupplyChainProductArchive_categoryL2_idx"
-  ON "SupplyChainProductArchive"("categoryL2");
-CREATE INDEX "SupplyChainProductArchive_productStatus_idx"
-  ON "SupplyChainProductArchive"("productStatus");
-CREATE INDEX "SupplyChainProductArchive_firstSourceCode_createdAt_idx"
-  ON "SupplyChainProductArchive"("firstSourceCode", "createdAt");
-
-CREATE UNIQUE INDEX "SupplyChainProductArchiveSource_sourceCode_sourceRecordId_key"
-  ON "SupplyChainProductArchiveSource"("sourceCode", "sourceRecordId");
-CREATE INDEX "SupplyChainProductArchiveSource_archiveId_sourceCode_idx"
-  ON "SupplyChainProductArchiveSource"("archiveId", "sourceCode");
-CREATE INDEX "SupplyChainProductArchiveSource_sourceProductId_idx"
-  ON "SupplyChainProductArchiveSource"("sourceProductId");
-CREATE INDEX "SupplyChainProductArchiveSource_sourceSkuItemId_idx"
-  ON "SupplyChainProductArchiveSource"("sourceSkuItemId");
-
-ALTER TABLE "SupplyChainProductArchiveSource"
-  ADD CONSTRAINT "SupplyChainProductArchiveSource_archiveId_fkey"
-  FOREIGN KEY ("archiveId") REFERENCES "SupplyChainProductArchive"("id")
-  ON DELETE CASCADE ON UPDATE CASCADE;
-
-ALTER TABLE "SupplyChainProductArchive"
-  ADD CONSTRAINT "SupplyChainProductArchive_barcode_not_blank_check"
-  CHECK (btrim("barcode") <> '');

furniture-3d-system/prisma/migrations/20260804150000_add_product_archive_image_embeddings/migration.sql

@@ -1,28 +0,0 @@
-CREATE TABLE "ProductArchiveImageEmbedding" (
-    "id" TEXT NOT NULL,
-    "archiveId" TEXT NOT NULL,
-    "imageUrl" TEXT NOT NULL,
-    "imageHash" VARCHAR(64) NOT NULL,
-    "embedding" BYTEA NOT NULL,
-    "dimensions" INTEGER NOT NULL,
-    "modelVersion" VARCHAR(120) NOT NULL,
-    "status" VARCHAR(24) NOT NULL DEFAULT 'READY',
-    "errorMessage" TEXT,
-    "indexedAt" TIMESTAMP(3),
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-
-    CONSTRAINT "ProductArchiveImageEmbedding_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "ProductArchiveImageEmbedding_archiveId_key"
-  ON "ProductArchiveImageEmbedding"("archiveId");
-CREATE INDEX "ProductArchiveImageEmbedding_status_idx"
-  ON "ProductArchiveImageEmbedding"("status");
-CREATE INDEX "ProductArchiveImageEmbedding_imageHash_idx"
-  ON "ProductArchiveImageEmbedding"("imageHash");
-
-ALTER TABLE "ProductArchiveImageEmbedding"
-  ADD CONSTRAINT "ProductArchiveImageEmbedding_archiveId_fkey"
-  FOREIGN KEY ("archiveId") REFERENCES "SupplyChainProductArchive"("id")
-  ON DELETE CASCADE ON UPDATE CASCADE;

furniture-3d-system/prisma/migrations/20260804163000_add_supply_chain_archive_procurement_fields/migration.sql

@@ -1,4 +0,0 @@
-ALTER TABLE "SupplyChainProductArchive"
-  ADD COLUMN "supplierName" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "purchaseOwner" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "minimumOrderQuantity" TEXT NOT NULL DEFAULT '';

furniture-3d-system/prisma/migrations/20260805093000_add_management_business_account_type/migration.sql

@@ -1 +0,0 @@
-ALTER TYPE "BusinessAccountType" ADD VALUE IF NOT EXISTS 'MANAGEMENT';

furniture-3d-system/prisma/migrations/20260805150000_add_installation_tool_motion/migration.sql

@@ -1,6 +0,0 @@
-ALTER TABLE "InstallationDemoTool"
-ADD COLUMN IF NOT EXISTS "motionType" TEXT NOT NULL DEFAULT 'spin',
-ADD COLUMN IF NOT EXISTS "motionPivot" JSONB,
-ADD COLUMN IF NOT EXISTS "motionAxis" JSONB,
-ADD COLUMN IF NOT EXISTS "spinTurns" DOUBLE PRECISION NOT NULL DEFAULT 3,
-ADD COLUMN IF NOT EXISTS "strikeDistanceRatio" DOUBLE PRECISION NOT NULL DEFAULT 0.2;

furniture-3d-system/prisma/migrations/20260806090000_structure_intake_sku_measurement_fields/migration.sql

@@ -1,177 +0,0 @@
--- Promote sample-package measurements and purchase fields from the compatibility
--- payload into the structured non-integrated SKU record. The payload is used
--- only for this one-time backfill; runtime reads use these columns.
-
-ALTER TABLE "IntakeNonIntegratedSkuItem"
-  ADD COLUMN IF NOT EXISTS "setCount" TEXT NOT NULL DEFAULT '1',
-  ADD COLUMN IF NOT EXISTS "purchaseOrderMethod" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN IF NOT EXISTS "sampleWeightKg" DECIMAL(18, 3),
-  ADD COLUMN IF NOT EXISTS "sampleLengthCm" DECIMAL(18, 3),
-  ADD COLUMN IF NOT EXISTS "sampleWidthCm" DECIMAL(18, 3),
-  ADD COLUMN IF NOT EXISTS "sampleHeightCm" DECIMAL(18, 3);
-
-WITH measurement_rows AS (
-  SELECT DISTINCT ON (product."id", COALESCE(row.item ->> 'skuId', row.item ->> 'id'))
-    product."id" AS product_id,
-    COALESCE(row.item ->> 'skuId', row.item ->> 'id') AS sku_item_id,
-    row.item
-  FROM "IntakeNonIntegratedProduct" product
-  CROSS JOIN LATERAL jsonb_array_elements(
-    CASE
-      WHEN jsonb_typeof(product."payload" -> 'sampleMeasurementRows') = 'array'
-      THEN product."payload" -> 'sampleMeasurementRows'
-      ELSE '[]'::jsonb
-    END
-  ) WITH ORDINALITY AS row(item, ordinal_position)
-  WHERE NULLIF(btrim(COALESCE(row.item ->> 'skuId', row.item ->> 'id', '')), '') IS NOT NULL
-  ORDER BY product."id", COALESCE(row.item ->> 'skuId', row.item ->> 'id'), row.ordinal_position DESC
-),
-factory_rows AS (
-  SELECT DISTINCT ON (product."id", COALESCE(row.item ->> 'skuId', row.item ->> 'id'))
-    product."id" AS product_id,
-    COALESCE(row.item ->> 'skuId', row.item ->> 'id') AS sku_item_id,
-    row.item
-  FROM "IntakeNonIntegratedProduct" product
-  CROSS JOIN LATERAL jsonb_array_elements(
-    CASE
-      WHEN jsonb_typeof(product."payload" -> 'factoryRows') = 'array'
-      THEN product."payload" -> 'factoryRows'
-      ELSE '[]'::jsonb
-    END
-  ) WITH ORDINALITY AS row(item, ordinal_position)
-  WHERE NULLIF(btrim(COALESCE(row.item ->> 'skuId', row.item ->> 'id', '')), '') IS NOT NULL
-  ORDER BY product."id", COALESCE(row.item ->> 'skuId', row.item ->> 'id'), row.ordinal_position DESC
-),
-sku_rows AS (
-  SELECT DISTINCT ON (product."id", COALESCE(row.item ->> 'id', row.item ->> 'skuId'))
-    product."id" AS product_id,
-    COALESCE(row.item ->> 'id', row.item ->> 'skuId') AS sku_item_id,
-    row.item
-  FROM "IntakeNonIntegratedProduct" product
-  CROSS JOIN LATERAL jsonb_array_elements(
-    CASE
-      WHEN jsonb_typeof(product."payload" -> 'skuItems') = 'array'
-      THEN product."payload" -> 'skuItems'
-      ELSE '[]'::jsonb
-    END
-  ) WITH ORDINALITY AS row(item, ordinal_position)
-  WHERE NULLIF(btrim(COALESCE(row.item ->> 'id', row.item ->> 'skuId', '')), '') IS NOT NULL
-  ORDER BY product."id", COALESCE(row.item ->> 'id', row.item ->> 'skuId'), row.ordinal_position DESC
-)
-UPDATE "IntakeNonIntegratedSkuItem" sku
-SET
-  "setCount" = COALESCE(
-    NULLIF(btrim(COALESCE(factory.item ->> 'setCount', '')), ''),
-    NULLIF(btrim(COALESCE(sku_row.item ->> 'setCount', '')), ''),
-    '1'
-  ),
-  "purchaseOrderMethod" = btrim(COALESCE(factory.item ->> 'purchaseOrderMethod', '')),
-  "sampleWeightKg" = CASE
-    WHEN COALESCE(measurement.item ->> 'weightKg', '') ~ '^[-+]?[0-9]+([.][0-9]+)?$'
-    THEN (measurement.item ->> 'weightKg')::numeric
-    ELSE NULL
-  END,
-  "sampleLengthCm" = CASE
-    WHEN COALESCE(measurement.item ->> 'lengthCm', '') ~ '^[-+]?[0-9]+([.][0-9]+)?$'
-    THEN (measurement.item ->> 'lengthCm')::numeric
-    ELSE NULL
-  END,
-  "sampleWidthCm" = CASE
-    WHEN COALESCE(measurement.item ->> 'widthCm', '') ~ '^[-+]?[0-9]+([.][0-9]+)?$'
-    THEN (measurement.item ->> 'widthCm')::numeric
-    ELSE NULL
-  END,
-  "sampleHeightCm" = CASE
-    WHEN COALESCE(measurement.item ->> 'heightCm', '') ~ '^[-+]?[0-9]+([.][0-9]+)?$'
-    THEN (measurement.item ->> 'heightCm')::numeric
-    ELSE NULL
-  END
-FROM measurement_rows measurement
-LEFT JOIN factory_rows factory
-  ON factory.product_id = measurement.product_id
- AND factory.sku_item_id = measurement.sku_item_id
-LEFT JOIN sku_rows sku_row
-  ON sku_row.product_id = measurement.product_id
- AND sku_row.sku_item_id = measurement.sku_item_id
-WHERE sku."productId" = measurement.product_id
-  AND measurement.sku_item_id IN (sku."skuItemId", sku."id");
-
-WITH factory_rows AS (
-  SELECT DISTINCT ON (product."id", COALESCE(row.item ->> 'skuId', row.item ->> 'id'))
-    product."id" AS product_id,
-    COALESCE(row.item ->> 'skuId', row.item ->> 'id') AS sku_item_id,
-    row.item
-  FROM "IntakeNonIntegratedProduct" product
-  CROSS JOIN LATERAL jsonb_array_elements(
-    CASE
-      WHEN jsonb_typeof(product."payload" -> 'factoryRows') = 'array'
-      THEN product."payload" -> 'factoryRows'
-      ELSE '[]'::jsonb
-    END
-  ) WITH ORDINALITY AS row(item, ordinal_position)
-  WHERE NULLIF(btrim(COALESCE(row.item ->> 'skuId', row.item ->> 'id', '')), '') IS NOT NULL
-  ORDER BY product."id", COALESCE(row.item ->> 'skuId', row.item ->> 'id'), row.ordinal_position DESC
-)
-UPDATE "IntakeNonIntegratedSkuItem" sku
-SET
-  "setCount" = COALESCE(NULLIF(btrim(COALESCE(factory.item ->> 'setCount', '')), ''), sku."setCount"),
-  "purchaseOrderMethod" = btrim(COALESCE(factory.item ->> 'purchaseOrderMethod', ''))
-FROM factory_rows factory
-WHERE sku."productId" = factory.product_id
-  AND factory.sku_item_id IN (sku."skuItemId", sku."id");
-
-WITH sku_rows AS (
-  SELECT DISTINCT ON (product."id", COALESCE(row.item ->> 'id', row.item ->> 'skuId'))
-    product."id" AS product_id,
-    COALESCE(row.item ->> 'id', row.item ->> 'skuId') AS sku_item_id,
-    row.item
-  FROM "IntakeNonIntegratedProduct" product
-  CROSS JOIN LATERAL jsonb_array_elements(
-    CASE
-      WHEN jsonb_typeof(product."payload" -> 'skuItems') = 'array'
-      THEN product."payload" -> 'skuItems'
-      ELSE '[]'::jsonb
-    END
-  ) WITH ORDINALITY AS row(item, ordinal_position)
-  WHERE NULLIF(btrim(COALESCE(row.item ->> 'id', row.item ->> 'skuId', '')), '') IS NOT NULL
-  ORDER BY product."id", COALESCE(row.item ->> 'id', row.item ->> 'skuId'), row.ordinal_position DESC
-),
-factory_keys AS (
-  SELECT DISTINCT
-    product."id" AS product_id,
-    COALESCE(row.item ->> 'skuId', row.item ->> 'id') AS sku_item_id
-  FROM "IntakeNonIntegratedProduct" product
-  CROSS JOIN LATERAL jsonb_array_elements(
-    CASE
-      WHEN jsonb_typeof(product."payload" -> 'factoryRows') = 'array'
-      THEN product."payload" -> 'factoryRows'
-      ELSE '[]'::jsonb
-    END
-  ) WITH ORDINALITY AS row(item, ordinal_position)
-  WHERE NULLIF(btrim(COALESCE(row.item ->> 'skuId', row.item ->> 'id', '')), '') IS NOT NULL
-    AND NULLIF(btrim(COALESCE(row.item ->> 'setCount', '')), '') IS NOT NULL
-)
-UPDATE "IntakeNonIntegratedSkuItem" sku
-SET "setCount" = COALESCE(NULLIF(btrim(COALESCE(sku_row.item ->> 'setCount', '')), ''), sku."setCount")
-FROM sku_rows sku_row
-WHERE sku."productId" = sku_row.product_id
-  AND sku_row.sku_item_id IN (sku."skuItemId", sku."id")
-  AND NOT EXISTS (
-    SELECT 1
-    FROM factory_keys factory
-    WHERE factory.product_id = sku_row.product_id
-      AND factory.sku_item_id = sku_row.sku_item_id
-  );
-
-COMMENT ON COLUMN "IntakeNonIntegratedSkuItem"."setCount" IS
-  'Sample-package kit count; 1 means non-double package, 2 means double package.';
-COMMENT ON COLUMN "IntakeNonIntegratedSkuItem"."purchaseOrderMethod" IS
-  'Product-factory purchase method from the product development workflow.';
-COMMENT ON COLUMN "IntakeNonIntegratedSkuItem"."sampleWeightKg" IS
-  'Sample-package measured weight in kilograms.';
-COMMENT ON COLUMN "IntakeNonIntegratedSkuItem"."sampleLengthCm" IS
-  'Sample-package measured length in centimeters.';
-COMMENT ON COLUMN "IntakeNonIntegratedSkuItem"."sampleWidthCm" IS
-  'Sample-package measured width in centimeters.';
-COMMENT ON COLUMN "IntakeNonIntegratedSkuItem"."sampleHeightCm" IS
-  'Sample-package measured height in centimeters.';

furniture-3d-system/prisma/migrations/20260806100000_expand_product_catalog_wide_for_supply_chain_archive/migration.sql

@@ -1,127 +0,0 @@
-ALTER VIEW external.product_catalog_wide_v1
-  RENAME TO product_catalog_wide_base_v1;
-
-CREATE VIEW external.product_catalog_wide_v1 AS
-WITH product_development_rows AS (
-  SELECT DISTINCT ON (upper(btrim(COALESCE(pricing."barcode", sku."barcode", ''))))
-    upper(btrim(COALESCE(pricing."barcode", sku."barcode", ''))) AS barcode_business_key,
-    pricing."id" AS source_pricing_row_id,
-    product."id" AS source_product_id,
-    sku."id" AS source_sku_item_id,
-    pricing."systemEnteredAt" AS jst_product_pushed_at,
-    pricing."systemEnteredAt" AS source_created_at,
-    product."createdAt" AS product_development_created_at,
-    product."updatedAt" AS product_development_updated_at,
-    product."spu" AS archive_spu,
-    product."brand" AS brand_name,
-    product."designer" AS archive_designer,
-    profile."salesCategory" AS sales_category_name,
-    profile."productCategory" AS archive_product_category_name,
-    sku."skuCode" AS archive_sku,
-    sku."specName" AS archive_product_name,
-    sku."image" AS archive_image,
-    sku."salesStatus" AS sku_sales_status,
-    sku."material" AS archive_material,
-    sku."color" AS archive_color,
-    sku."drawingId" AS drawing_id,
-    sku."size" AS archive_spec,
-    sku."manufacturer" AS archive_supplier_name,
-    profile."purchaseOwner" AS archive_purchase_owner,
-    sku."minimumOrderQuantity" AS archive_minimum_order_quantity,
-    pricing."productTag" AS product_tag,
-    sku."sampleWeightKg" AS sample_weight_kg,
-    sku."sampleLengthCm" AS package_length_cm,
-    sku."sampleWidthCm" AS package_width_cm,
-    sku."sampleHeightCm" AS package_height_cm,
-    CASE
-      WHEN sku."sampleLengthCm" IS NOT NULL
-       AND sku."sampleWidthCm" IS NOT NULL
-       AND sku."sampleHeightCm" IS NOT NULL
-      THEN sku."sampleLengthCm"
-         * sku."sampleWidthCm"
-         * sku."sampleHeightCm"
-      ELSE NULL
-    END AS package_volume_cm3,
-    sku."setCount" AS package_set_count,
-    sku."purchaseOrderMethod" AS purchase_order_method,
-    sku."shippingMethod" AS archive_shipping_method,
-    NOT ('EXTERNAL_INTAKE'::"BusinessAccountType" = ANY(COALESCE(creator."businessRoles", ARRAY[]::"BusinessAccountType"[]))) AS supply_chain_archive_eligible,
-    'EXTERNAL_INTAKE'::"BusinessAccountType" = ANY(COALESCE(creator."businessRoles", ARRAY[]::"BusinessAccountType"[])) AS is_external_intake
-  FROM "IntakeNonIntegratedPricingRow" pricing
-  JOIN "IntakeNonIntegratedProduct" product
-    ON product."id" = pricing."productId"
-   AND product."deletedAt" IS NULL
-  JOIN "IntakeNonIntegratedSkuItem" sku
-    ON sku."productId" = pricing."productId"
-   AND sku."skuItemId" = pricing."skuItemId"
-  LEFT JOIN "IntakeNonIntegratedProductProfile" profile
-    ON profile."productId" = product."id"
-  LEFT JOIN "User" creator
-    ON creator."id" = product."createdBy"
-  WHERE pricing."systemEnteredAt" IS NOT NULL
-    AND NULLIF(btrim(COALESCE(pricing."barcode", sku."barcode", '')), '') IS NOT NULL
-  ORDER BY
-    upper(btrim(COALESCE(pricing."barcode", sku."barcode", ''))),
-    pricing."systemEnteredAt" ASC,
-    pricing."id" ASC
-)
-SELECT
-  base.*,
-  source.jst_product_pushed_at,
-  source.is_external_intake,
-  COALESCE(source.supply_chain_archive_eligible, false) AS supply_chain_archive_eligible,
-  source.source_pricing_row_id,
-  source.source_product_id,
-  source.source_sku_item_id,
-  source.source_created_at,
-  source.product_development_created_at,
-  source.product_development_updated_at,
-  source.archive_spu,
-  source.archive_sku,
-  source.archive_product_name,
-  source.archive_image,
-  source.archive_designer,
-  source.sales_category_name,
-  source.archive_product_category_name,
-  source.sku_sales_status,
-  source.archive_material,
-  source.archive_color,
-  source.drawing_id,
-  source.archive_spec,
-  source.brand_name,
-  source.archive_supplier_name,
-  source.archive_purchase_owner,
-  source.archive_minimum_order_quantity,
-  source.product_tag,
-  source.sample_weight_kg,
-  source.package_length_cm,
-  source.package_width_cm,
-  source.package_height_cm,
-  source.package_volume_cm3,
-  source.package_set_count,
-  source.purchase_order_method,
-  source.archive_shipping_method
-FROM external.product_catalog_wide_base_v1 base
-LEFT JOIN product_development_rows source
-  ON source.barcode_business_key = base.barcode_business_key;
-
-DO $$
-BEGIN
-  IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'external_reader') THEN
-    GRANT USAGE ON SCHEMA external TO external_reader;
-    GRANT SELECT ON external.product_catalog_wide_v1 TO external_reader;
-  END IF;
-  IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'external_core_reader') THEN
-    GRANT USAGE ON SCHEMA external TO external_core_reader;
-    GRANT SELECT ON external.product_catalog_wide_v1 TO external_core_reader;
-  END IF;
-END
-$$;
-
-ALTER TABLE "SupplyChainProductArchiveSource"
-  ADD COLUMN "sourceSystem" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "sourceSchema" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "sourceObject" TEXT NOT NULL DEFAULT '';
-
-CREATE INDEX "SupplyChainProductArchiveSource_sourceSystem_sourceSchema_sourceObject_idx"
-  ON "SupplyChainProductArchiveSource"("sourceSystem", "sourceSchema", "sourceObject");

furniture-3d-system/prisma/migrations/20260806143000_add_intake_sku_source_fields/migration.sql

@@ -1,8 +0,0 @@
--- Keep the structured SKU table aligned with the source metadata fields in
--- IntakeNonIntegratedSkuItem. Historical SKU payloads do not carry values for
--- these fields, so no data backfill is required.
-ALTER TABLE "IntakeNonIntegratedSkuItem"
-  ADD COLUMN IF NOT EXISTS "sourceWeight" DECIMAL(18, 3),
-  ADD COLUMN IF NOT EXISTS "sourceBrand" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN IF NOT EXISTS "sourceCreatedAt" TIMESTAMP(3),
-  ADD COLUMN IF NOT EXISTS "sourceUpdatedAt" TIMESTAMP(3);

furniture-3d-system/prisma/migrations/20260806173000_add_product_archive_field_source_map/migration.sql

@@ -1,2 +0,0 @@
-ALTER TABLE "SupplyChainProductArchive"
-ADD COLUMN "fieldSourceMap" JSONB NOT NULL DEFAULT '{}'::jsonb;

furniture-3d-system/prisma/migrations/20260807090000_add_supply_chain_product_archive_category_config/migration.sql

@@ -1,99 +0,0 @@
-CREATE TABLE "SupplyChainProductArchiveCategoryConfig" (
-    "id" TEXT NOT NULL,
-    "categoryL2" TEXT NOT NULL,
-    "categoryL1" TEXT NOT NULL,
-    "status" TEXT NOT NULL DEFAULT 'ACTIVE',
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-
-    CONSTRAINT "SupplyChainProductArchiveCategoryConfig_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "SupplyChainProductArchiveCategoryConfig_categoryL2_key"
-  ON "SupplyChainProductArchiveCategoryConfig"("categoryL2");
-CREATE INDEX "SupplyChainProductArchiveCategoryConfig_categoryL1_idx"
-  ON "SupplyChainProductArchiveCategoryConfig"("categoryL1");
-CREATE INDEX "SupplyChainProductArchiveCategoryConfig_status_idx"
-  ON "SupplyChainProductArchiveCategoryConfig"("status");
-
-INSERT INTO "SupplyChainProductArchiveCategoryConfig"
-  ("id", "categoryL2", "categoryL1", "status", "createdAt", "updatedAt")
-VALUES
-    ('category-config-001', '住宅家具 - 书桌', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-002', '住宅家具 - 鞋柜', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-003', '住宅家具 - 门厅/玄关柜/玄关架', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-004', '住宅家具 - 餐边柜', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-005', '住宅家具 - 电视柜', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-006', '住宅家具 - 角柜', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-007', '住宅家具 - 书架', '架类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-008', '住宅家具 - 书柜', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-009', '住宅家具 - 厨房置物架/角架', '架类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-010', '住宅家具 - 床头柜', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-011', '住宅家具 - 电脑桌', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-012', '住宅家具 - 梳妆台/桌', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-013', '商业/办公家具 - 演讲台', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-014', '住宅家具 - 折叠桌', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-015', '住宅家具 - 餐桌', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-016', '住宅家具 - 电脑椅', '坐具类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-017', '住宅家具 - 餐椅', '坐具类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-018', '住宅家具 - 梳妆凳', '坐具类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-019', '住宅家具 - 衣帽架', '架类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-020', '住宅家具 - 化妆镜', '镜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-021', '住宅家具 - 花架/花几', '架类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-022', '住宅家具 - 搁板/置物架', '架类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-023', '住宅家具 - 书桌收纳置物架', '收纳类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-024', '住宅家具 - 厨房储物架/厨房置物架', '架类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-025', '住宅家具 - 角几/边几', '几类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-026', '住宅家具 - 茶几', '几类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-027', '住宅家具 - 办公升降台/升降桌', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-028', '商业/办公家具 - 文具边柜', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-029', '住宅家具 - 斗柜', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-030', '住宅家具 - 穿衣镜', '镜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-031', '住宅家具 - 矮凳', '坐具类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-032', '住宅家具 - 其它凳子', '坐具类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-033', '住宅家具 - 布艺沙发', '沙发类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-034', '住宅家具 - 床垫类', '床类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-035', '住宅家具 - 平板手推车/工具车', '收纳类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-036', '住宅家具 - 炕几', '几类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-037', '住宅家具 - 换鞋凳', '坐具类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-038', '住宅家具 - 懒人沙发', '沙发类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-039', '住宅家具 - 家居收纳产品', '收纳类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-040', '住宅家具 - 其它家具配件', '第三方配件', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-041', '住宅家具 - 休闲椅', '坐具类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-042', '住宅家具 - 折叠床', '床类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-043', '住宅家具 - 窝/屋/帐篷', '户外类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-044', '商业/办公家具 - 会议桌', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-045', '住宅家具 - 收纳洞洞板', '收纳类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-046', '住宅家具 - 洞洞板', '收纳类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-047', '住宅家具 - 功能沙发', '沙发类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-048', '住宅家具 - 沙发床', '沙发类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-049', '住宅家具 - 收纳柜', '收纳类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-050', '住宅家具 - 收纳筐', '收纳类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-051', '住宅家具 - 鞋架', '架类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-052', '住宅家具 - 儿童学习桌', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-053', '住宅家具 - 衣柜', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-054', '住宅家具 - 折叠床/午休床', '床类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-055', '住宅家具 - 折叠椅/躺椅', '户外类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-056', '住宅家具 - 儿童餐椅', '坐具类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-057', '商业/办公家具 - 组合/屏风工作位', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-058', '其他 - 配件', '其他', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-059', '住宅家具 - 衣物洗/晒/护理用具', '架类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-060', '住宅家具 - 实木床', '床类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-061', '住宅家具 - 卫浴/置物用具', '收纳类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-062', '住宅家具 - 儿童学习椅', '坐具类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-063', '住宅家具 - 板木结合床', '床类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-064', '住宅家具 - 家用梯', '其他', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-065', '其他 - 赠品', '其他', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-066', '住宅家具 - 电竞椅', '坐具类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-067', '住宅家具 - 酒吧椅', '坐具类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-068', '住宅家具 - 飘窗柜', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-069', '其他 - 福利品', '其他', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-070', '住宅家具 - 电动升降桌', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-071', '住宅家具 - 办公桌', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-072', '其他 - 虚拟产品', '其他', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-073', '住宅家具 - 功能床', '床类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-074', '住宅家具 - 皮艺沙发', '沙发类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-075', '住宅家具 - 皮艺床', '床类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-076', '商业/办公家具 - 前台/接待台（新增）', '桌类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-077', '住宅家具 - 吊柜/壁柜', '柜类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP),
-    ('category-config-078', '住宅家具 - 主机箱托架', '架类', 'ACTIVE', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP);

furniture-3d-system/prisma/migrations/20260807110000_add_product_archive_drawing_media/migration.sql

@@ -1,44 +0,0 @@
-ALTER TABLE "SupplyChainProductArchive"
-  ADD COLUMN "hasDrawing" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "hasVideo" TEXT NOT NULL DEFAULT '';
-
-CREATE TABLE "SupplyChainProductArchiveDrawingMedia" (
-    "id" TEXT NOT NULL,
-    "barcode" TEXT NOT NULL,
-    "drawingId" TEXT NOT NULL DEFAULT '',
-    "skuModel" TEXT NOT NULL DEFAULT '',
-    "factoryModel" TEXT NOT NULL DEFAULT '',
-    "completedAt" TIMESTAMP(3),
-    "externalLink" TEXT,
-    "lineDrawingStatus" TEXT NOT NULL DEFAULT '',
-    "explodedDrawingStatus" TEXT NOT NULL DEFAULT '',
-    "installationDrawingStatus" TEXT NOT NULL DEFAULT '',
-    "installationVideoStatus" TEXT NOT NULL DEFAULT '',
-    "sourceFileName" TEXT NOT NULL DEFAULT '',
-    "sourceRowNumber" INTEGER,
-    "sourceUpdatedAt" TIMESTAMP(3),
-    "lastSyncedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-
-    CONSTRAINT "SupplyChainProductArchiveDrawingMedia_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "SupplyChainProductArchiveDrawingMedia_barcode_key"
-  ON "SupplyChainProductArchiveDrawingMedia"("barcode");
-CREATE INDEX "SupplyChainProductArchiveDrawingMedia_drawingId_idx"
-  ON "SupplyChainProductArchiveDrawingMedia"("drawingId");
-CREATE INDEX "SupplyChainProductArchiveDrawingMedia_completedAt_idx"
-  ON "SupplyChainProductArchiveDrawingMedia"("completedAt");
-CREATE INDEX "SupplyChainProductArchiveDrawingMedia_sourceFileName_sourceRowNumber_idx"
-  ON "SupplyChainProductArchiveDrawingMedia"("sourceFileName", "sourceRowNumber");
-
-ALTER TABLE "SupplyChainProductArchive"
-  ADD CONSTRAINT "SupplyChainProductArchive_hasDrawing_check"
-  CHECK ("hasDrawing" IN ('', '有', '无'));
-ALTER TABLE "SupplyChainProductArchive"
-  ADD CONSTRAINT "SupplyChainProductArchive_hasVideo_check"
-  CHECK ("hasVideo" IN ('', '有', '无'));
-ALTER TABLE "SupplyChainProductArchiveDrawingMedia"
-  ADD CONSTRAINT "SupplyChainProductArchiveDrawingMedia_barcode_not_blank_check"
-  CHECK (btrim("barcode") <> '');

furniture-3d-system/prisma/migrations/20260807143000_add_bom_cost_reference_and_scenarios/migration.sql

@@ -1,239 +0,0 @@
-DO $$ BEGIN
-  CREATE TYPE "BomCostingReferenceSyncStatus" AS ENUM ('RUNNING', 'SUCCEEDED', 'FAILED');
-EXCEPTION
-  WHEN duplicate_object THEN NULL;
-END $$;
-
-DO $$ BEGIN
-  CREATE TYPE "BomCostingScenarioKind" AS ENUM ('SAME_MATERIAL', 'MATERIAL_SUBSTITUTION');
-EXCEPTION
-  WHEN duplicate_object THEN NULL;
-END $$;
-
-DO $$ BEGIN
-  CREATE TYPE "BomCostingScenarioStatus" AS ENUM ('FINAL', 'PROVISIONAL', 'INSUFFICIENT_DATA', 'STALE');
-EXCEPTION
-  WHEN duplicate_object THEN NULL;
-END $$;
-
-CREATE TABLE "BomCostingReferenceSyncRun" (
-  "id" TEXT NOT NULL,
-  "sourceSystem" TEXT NOT NULL DEFAULT 'JSReportReplica',
-  "sourceDatabase" TEXT NOT NULL DEFAULT '',
-  "sourceSchema" TEXT NOT NULL DEFAULT 'rpt',
-  "sourceObject" TEXT NOT NULL DEFAULT 'pm_bomBaseInfo',
-  "status" "BomCostingReferenceSyncStatus" NOT NULL DEFAULT 'RUNNING',
-  "batchKey" TEXT NOT NULL DEFAULT '',
-  "configFingerprint" VARCHAR(64) NOT NULL DEFAULT '',
-  "cursorStart" TEXT NOT NULL DEFAULT '',
-  "cursorEnd" TEXT NOT NULL DEFAULT '',
-  "rowsRead" INTEGER NOT NULL DEFAULT 0,
-  "rowsWritten" INTEGER NOT NULL DEFAULT 0,
-  "rowsCreated" INTEGER NOT NULL DEFAULT 0,
-  "rowsUpdated" INTEGER NOT NULL DEFAULT 0,
-  "rowsUnchanged" INTEGER NOT NULL DEFAULT 0,
-  "rowsSkipped" INTEGER NOT NULL DEFAULT 0,
-  "errorCount" INTEGER NOT NULL DEFAULT 0,
-  "errorMessage" TEXT NOT NULL DEFAULT '',
-  "durationMs" INTEGER NOT NULL DEFAULT 0,
-  "startedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "completedAt" TIMESTAMP(3),
-  "sourceAsOf" TIMESTAMP(3),
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-  CONSTRAINT "BomCostingReferenceSyncRun_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "BomCostingReferenceRow" (
-  "id" TEXT NOT NULL,
-  "sourceRowId" TEXT NOT NULL,
-  "sourceSku" TEXT NOT NULL DEFAULT '',
-  "bomVersionKey" TEXT NOT NULL DEFAULT '',
-  "category" TEXT NOT NULL DEFAULT '',
-  "categoryCode" TEXT NOT NULL DEFAULT '',
-  "partNumber" TEXT NOT NULL DEFAULT '',
-  "partName" TEXT NOT NULL DEFAULT '',
-  "side" TEXT NOT NULL DEFAULT '',
-  "materialName" TEXT NOT NULL DEFAULT '',
-  "materialCode" TEXT NOT NULL DEFAULT '',
-  "materialSpec" TEXT NOT NULL DEFAULT '',
-  "processName" TEXT NOT NULL DEFAULT '',
-  "unit" TEXT NOT NULL DEFAULT '',
-  "rawLength" TEXT NOT NULL DEFAULT '',
-  "rawWidth" TEXT NOT NULL DEFAULT '',
-  "rawLongEdge" TEXT NOT NULL DEFAULT '',
-  "rawShortEdge" TEXT NOT NULL DEFAULT '',
-  "rawQuantity" TEXT NOT NULL DEFAULT '',
-  "rawCoefficient" TEXT NOT NULL DEFAULT '',
-  "rawArea" TEXT NOT NULL DEFAULT '',
-  "rawEdgeLength" TEXT NOT NULL DEFAULT '',
-  "rawUnitPrice" TEXT NOT NULL DEFAULT '',
-  "rawAmount" TEXT NOT NULL DEFAULT '',
-  "rawNote" TEXT NOT NULL DEFAULT '',
-  "rawCreatedAt" TEXT NOT NULL DEFAULT '',
-  "lengthMm" DECIMAL(18, 6),
-  "widthMm" DECIMAL(18, 6),
-  "longEdgeMm" DECIMAL(18, 6),
-  "shortEdgeMm" DECIMAL(18, 6),
-  "quantity" DECIMAL(18, 6),
-  "coefficient" DECIMAL(18, 6),
-  "areaSqm" DECIMAL(18, 6),
-  "edgeLengthM" DECIMAL(18, 6),
-  "unitPrice" DECIMAL(18, 6),
-  "amount" DECIMAL(18, 6),
-  "sourceCreatedAt" TIMESTAMP(3),
-  "sourceFingerprint" VARCHAR(64) NOT NULL,
-  "isSummaryRow" BOOLEAN NOT NULL DEFAULT false,
-  "syncRunId" TEXT NOT NULL,
-  "syncedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  CONSTRAINT "BomCostingReferenceRow_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "BomCostingMaterialOption" (
-  "id" TEXT NOT NULL,
-  "code" TEXT NOT NULL,
-  "name" TEXT NOT NULL,
-  "normalizedName" TEXT NOT NULL,
-  "category" TEXT NOT NULL DEFAULT 'BOARD',
-  "aliases" JSONB NOT NULL DEFAULT '[]',
-  "enabled" BOOLEAN NOT NULL DEFAULT true,
-  "sortOrder" INTEGER NOT NULL DEFAULT 0,
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-  CONSTRAINT "BomCostingMaterialOption_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "BomCostingScenario" (
-  "id" TEXT NOT NULL,
-  "caseId" TEXT NOT NULL,
-  "skuId" TEXT NOT NULL,
-  "kind" "BomCostingScenarioKind" NOT NULL,
-  "scenarioKey" TEXT NOT NULL DEFAULT '',
-  "revision" INTEGER NOT NULL DEFAULT 1,
-  "isCurrent" BOOLEAN NOT NULL DEFAULT true,
-  "targetMaterialId" TEXT,
-  "targetMaterialName" TEXT NOT NULL DEFAULT '',
-  "status" "BomCostingScenarioStatus" NOT NULL DEFAULT 'PROVISIONAL',
-  "totalCost" DECIMAL(18, 2),
-  "knownCost" DECIMAL(18, 2),
-  "materialCost" DECIMAL(18, 2),
-  "processingCost" DECIMAL(18, 2),
-  "laborCost" DECIMAL(18, 2),
-  "packagingCost" DECIMAL(18, 2),
-  "lossCost" DECIMAL(18, 2),
-  "competitorPrice" DECIMAL(18, 2),
-  "priceDelta" DECIMAL(18, 2),
-  "confidence" DECIMAL(5, 4),
-  "warning" TEXT NOT NULL DEFAULT '',
-  "unresolvedCount" INTEGER NOT NULL DEFAULT 0,
-  "dataAsOf" TIMESTAMP(3),
-  "syncRunId" TEXT,
-  "rulesetVersion" TEXT NOT NULL DEFAULT 'dynamic-bom-cost/v2',
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-  CONSTRAINT "BomCostingScenario_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "BomCostingScenarioLine" (
-  "id" TEXT NOT NULL,
-  "scenarioId" TEXT NOT NULL,
-  "sourceLineId" TEXT,
-  "sourceRowId" TEXT NOT NULL DEFAULT '',
-  "category" TEXT NOT NULL DEFAULT '',
-  "partName" TEXT NOT NULL DEFAULT '',
-  "originalMaterial" TEXT NOT NULL DEFAULT '',
-  "appliedMaterial" TEXT NOT NULL DEFAULT '',
-  "materialSpec" TEXT NOT NULL DEFAULT '',
-  "unit" TEXT NOT NULL DEFAULT '',
-  "quantity" DECIMAL(18, 6),
-  "coefficient" DECIMAL(18, 6),
-  "pricingQuantity" DECIMAL(18, 6),
-  "unitPrice" DECIMAL(18, 6),
-  "subtotal" DECIMAL(18, 2),
-  "priceSource" TEXT NOT NULL DEFAULT '',
-  "sourceSku" TEXT NOT NULL DEFAULT '',
-  "referenceSkus" JSONB NOT NULL DEFAULT '[]',
-  "referenceRowIds" JSONB NOT NULL DEFAULT '[]',
-  "sourceFingerprint" VARCHAR(64) NOT NULL DEFAULT '',
-  "sourceCreatedAt" TIMESTAMP(3),
-  "sourceSyncedAt" TIMESTAMP(3),
-  "calculationRule" TEXT NOT NULL DEFAULT '',
-  "confidence" DECIMAL(5, 4),
-  "status" "BomCostingScenarioStatus" NOT NULL DEFAULT 'PROVISIONAL',
-  "warning" TEXT NOT NULL DEFAULT '',
-  "rawSnapshot" JSONB,
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  CONSTRAINT "BomCostingScenarioLine_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "BomCostingReferenceRow_source_key" ON "BomCostingReferenceRow"("syncRunId", "sourceRowId", "sourceSku", "bomVersionKey");
-CREATE INDEX "BomCostingReferenceSyncRun_status_startedAt_idx" ON "BomCostingReferenceSyncRun"("status", "startedAt");
-CREATE INDEX "BomCostingReferenceSyncRun_status_completedAt_idx" ON "BomCostingReferenceSyncRun"("status", "completedAt");
-CREATE INDEX "BomCostingReferenceSyncRun_completedAt_idx" ON "BomCostingReferenceSyncRun"("completedAt");
-CREATE INDEX "BomCostingReferenceSyncRun_batchKey_idx" ON "BomCostingReferenceSyncRun"("batchKey");
-CREATE INDEX "BomCostingReferenceRow_sku_category_material_idx" ON "BomCostingReferenceRow"("sourceSku", "categoryCode", "materialName");
-CREATE INDEX "BomCostingReferenceRow_material_spec_unit_idx" ON "BomCostingReferenceRow"("materialName", "materialSpec", "unit");
-CREATE INDEX "BomCostingReferenceRow_syncRunId_sku_category_material_idx" ON "BomCostingReferenceRow"("syncRunId", "sourceSku", "categoryCode", "materialName");
-CREATE INDEX "BomCostingReferenceRow_syncRunId_material_spec_unit_idx" ON "BomCostingReferenceRow"("syncRunId", "materialName", "materialSpec", "unit");
-CREATE INDEX "BomCostingReferenceRow_syncRunId_category_part_number_idx" ON "BomCostingReferenceRow"("syncRunId", "categoryCode", "partNumber");
-CREATE INDEX "BomCostingReferenceRow_syncRunId_category_dimensions_idx" ON "BomCostingReferenceRow"("syncRunId", "categoryCode", "lengthMm", "widthMm");
-CREATE INDEX "BomCostingReferenceRow_syncRunId_idx" ON "BomCostingReferenceRow"("syncRunId");
-CREATE INDEX "BomCostingReferenceRow_syncRunId_summary_category_idx" ON "BomCostingReferenceRow"("syncRunId", "isSummaryRow", "categoryCode");
-CREATE INDEX "BomCostingReferenceRow_sourceCreatedAt_idx" ON "BomCostingReferenceRow"("sourceCreatedAt");
-CREATE UNIQUE INDEX "BomCostingMaterialOption_code_key" ON "BomCostingMaterialOption"("code");
-CREATE INDEX "BomCostingMaterialOption_enabled_sortOrder_idx" ON "BomCostingMaterialOption"("enabled", "sortOrder");
-CREATE INDEX "BomCostingMaterialOption_normalizedName_idx" ON "BomCostingMaterialOption"("normalizedName");
-CREATE UNIQUE INDEX "BomCostingScenario_sku_kind_scenarioKey_revision_key" ON "BomCostingScenario"("skuId", "kind", "scenarioKey", "revision");
-CREATE INDEX "BomCostingScenario_caseId_kind_idx" ON "BomCostingScenario"("caseId", "kind");
-CREATE INDEX "BomCostingScenario_skuId_isCurrent_updatedAt_idx" ON "BomCostingScenario"("skuId", "isCurrent", "updatedAt");
-CREATE INDEX "BomCostingScenario_status_dataAsOf_idx" ON "BomCostingScenario"("status", "dataAsOf");
-CREATE INDEX "BomCostingScenario_syncRunId_idx" ON "BomCostingScenario"("syncRunId");
-CREATE INDEX "BomCostingScenarioLine_scenarioId_category_idx" ON "BomCostingScenarioLine"("scenarioId", "category");
-CREATE INDEX "BomCostingScenarioLine_sourceRowId_idx" ON "BomCostingScenarioLine"("sourceRowId");
-CREATE INDEX "BomCostingScenarioLine_status_idx" ON "BomCostingScenarioLine"("status");
-
--- Material choices are a read-only projection of the company's enabled
--- substrate dictionary.  The scheduled mirror refresh keeps this projection
--- current; this initial insert prevents a newly migrated environment from
--- exposing an empty selector when the master data already exists.
-INSERT INTO "BomCostingMaterialOption" (
-  "id", "code", "name", "normalizedName", "category", "aliases", "enabled", "sortOrder", "updatedAt"
-)
-SELECT
-  'bom-material-' || "id",
-  'SUBSTRATE_SYSTEM_NAME:' || "id",
-  "name",
-  lower(regexp_replace("name", '\s+', '', 'g')),
-  'BOARD',
-  jsonb_build_array("name"),
-  "isActive",
-  "sortOrder",
-  CURRENT_TIMESTAMP
-FROM "SubstrateSystemNameOption"
-ON CONFLICT ("code") DO UPDATE SET
-  "name" = EXCLUDED."name",
-  "normalizedName" = EXCLUDED."normalizedName",
-  "aliases" = EXCLUDED."aliases",
-  "enabled" = EXCLUDED."enabled",
-  "sortOrder" = EXCLUDED."sortOrder",
-  "updatedAt" = CURRENT_TIMESTAMP;
-
-ALTER TABLE "BomCostingReferenceRow"
-  ADD CONSTRAINT "BomCostingReferenceRow_syncRunId_fkey"
-  FOREIGN KEY ("syncRunId") REFERENCES "BomCostingReferenceSyncRun"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
-ALTER TABLE "BomCostingScenario"
-  ADD CONSTRAINT "BomCostingScenario_caseId_fkey"
-  FOREIGN KEY ("caseId") REFERENCES "BomCostingCase"("id") ON DELETE CASCADE ON UPDATE CASCADE,
-  ADD CONSTRAINT "BomCostingScenario_skuId_fkey"
-  FOREIGN KEY ("skuId") REFERENCES "BomCostingSku"("id") ON DELETE CASCADE ON UPDATE CASCADE,
-  ADD CONSTRAINT "BomCostingScenario_targetMaterialId_fkey"
-  FOREIGN KEY ("targetMaterialId") REFERENCES "BomCostingMaterialOption"("id") ON DELETE SET NULL ON UPDATE CASCADE,
-  ADD CONSTRAINT "BomCostingScenario_syncRunId_fkey"
-  FOREIGN KEY ("syncRunId") REFERENCES "BomCostingReferenceSyncRun"("id") ON DELETE SET NULL ON UPDATE CASCADE;
-
-ALTER TABLE "BomCostingScenarioLine"
-  ADD CONSTRAINT "BomCostingScenarioLine_scenarioId_fkey"
-  FOREIGN KEY ("scenarioId") REFERENCES "BomCostingScenario"("id") ON DELETE CASCADE ON UPDATE CASCADE,
-  ADD CONSTRAINT "BomCostingScenarioLine_sourceLineId_fkey"
-  FOREIGN KEY ("sourceLineId") REFERENCES "BomCostingLine"("id") ON DELETE SET NULL ON UPDATE CASCADE;

furniture-3d-system/prisma/migrations/20260809160000_update_bom_cost_ruleset_default/migration.sql

@@ -1,2 +0,0 @@
-ALTER TABLE "BomCostingScenario"
-  ALTER COLUMN "rulesetVersion" SET DEFAULT 'dynamic-bom-cost/v3';

furniture-3d-system/prisma/migrations/20260810100000_add_supply_chain_product_archive_warehouse_config/migration.sql

@@ -1,22 +0,0 @@
-ALTER TABLE "SupplyChainProductArchive"
-  ADD COLUMN "inOutWarehouse" TEXT NOT NULL DEFAULT '';
-
-CREATE INDEX "SupplyChainProductArchive_inOutWarehouse_idx"
-  ON "SupplyChainProductArchive"("inOutWarehouse");
-
-CREATE TABLE "SupplyChainProductArchiveWarehouseConfig" (
-  "id" TEXT NOT NULL,
-  "warehouseName" TEXT NOT NULL,
-  "storageType" TEXT NOT NULL,
-  "status" TEXT NOT NULL DEFAULT 'ACTIVE',
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-  CONSTRAINT "SupplyChainProductArchiveWarehouseConfig_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "SupplyChainProductArchiveWarehouseConfig_warehouseName_key"
-  ON "SupplyChainProductArchiveWarehouseConfig"("warehouseName");
-CREATE INDEX "SupplyChainProductArchiveWarehouseConfig_storageType_idx"
-  ON "SupplyChainProductArchiveWarehouseConfig"("storageType");
-CREATE INDEX "SupplyChainProductArchiveWarehouseConfig_status_idx"
-  ON "SupplyChainProductArchiveWarehouseConfig"("status");

furniture-3d-system/prisma/migrations/20260810120000_update_bom_cost_ruleset_v4/migration.sql

@@ -1,2 +0,0 @@
-ALTER TABLE "BomCostingScenario"
-  ALTER COLUMN "rulesetVersion" SET DEFAULT 'dynamic-bom-cost/v4';

furniture-3d-system/prisma/migrations/20260810143000_add_jushuitan_fixed_virtual_inventory_tasks/migration.sql

@@ -1,31 +0,0 @@
-CREATE TABLE "IntakeJushuitanFixedVirtualInventoryTask" (
-  "id" TEXT NOT NULL,
-  "productId" TEXT NOT NULL,
-  "productSpu" TEXT NOT NULL DEFAULT '',
-  "skuItemId" TEXT NOT NULL,
-  "skuCode" TEXT NOT NULL DEFAULT '',
-  "barcode" TEXT NOT NULL DEFAULT '',
-  "status" TEXT NOT NULL DEFAULT 'pending',
-  "scheduledAt" TIMESTAMP(3) NOT NULL,
-  "retryCount" INTEGER NOT NULL DEFAULT 0,
-  "lastAttemptAt" TIMESTAMP(3),
-  "pushedAt" TIMESTAMP(3),
-  "error" TEXT NOT NULL DEFAULT '',
-  "requestId" TEXT NOT NULL DEFAULT '',
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-
-  CONSTRAINT "IntakeJushuitanFixedVirtualInventoryTask_pkey" PRIMARY KEY ("id"),
-  CONSTRAINT "IntakeJushuitanFixedVirtualInventoryTask_productId_fkey"
-    FOREIGN KEY ("productId") REFERENCES "IntakeNonIntegratedProduct"("id")
-    ON DELETE CASCADE ON UPDATE CASCADE
-);
-
-CREATE UNIQUE INDEX "IntakeJushuitanFixedVirtualInventoryTask_productId_skuItemId_key"
-  ON "IntakeJushuitanFixedVirtualInventoryTask"("productId", "skuItemId");
-
-CREATE INDEX "IntakeJushuitanFixedVirtualInventoryTask_status_scheduledAt_idx"
-  ON "IntakeJushuitanFixedVirtualInventoryTask"("status", "scheduledAt");
-
-CREATE INDEX "IntakeJushuitanFixedVirtualInventoryTask_productId_idx"
-  ON "IntakeJushuitanFixedVirtualInventoryTask"("productId");

furniture-3d-system/prisma/migrations/20260810143000_add_sample_progress_board/migration.sql

@@ -1,57 +0,0 @@
-CREATE TABLE "SampleProgressItem" (
-  "id" TEXT NOT NULL,
-  "orderDate" DATE NOT NULL,
-  "imageUrl" TEXT,
-  "openingCode" TEXT NOT NULL,
-  "productSize" TEXT NOT NULL,
-  "color" TEXT NOT NULL,
-  "material" TEXT NOT NULL,
-  "sampleQuantity" INTEGER NOT NULL,
-  "brand" TEXT NOT NULL,
-  "sampleDueDate" DATE NOT NULL,
-  "oaReachedAt" TIMESTAMP(3),
-  "supplier" TEXT NOT NULL,
-  "finalSampleFactory" TEXT,
-  "status" TEXT NOT NULL,
-  "designer" TEXT NOT NULL,
-  "purchaseOwner" TEXT,
-  "merchandiserOwner" TEXT,
-  "progressDescription" TEXT,
-  "requestedCost" DECIMAL(12,2),
-  "actualCost" DECIMAL(12,2),
-  "followUpOwner" TEXT,
-  "createdBy" TEXT,
-  "updatedBy" TEXT,
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  CONSTRAINT "SampleProgressItem_pkey" PRIMARY KEY ("id"),
-  CONSTRAINT "SampleProgressItem_quantity_positive" CHECK ("sampleQuantity" > 0),
-  CONSTRAINT "SampleProgressItem_status_allowed" CHECK ("status" IN ('BARE_WOOD', 'BARE_WOOD_REVIEW', 'PAINT', 'VIDEO_REVIEW', 'SAMPLE_SHIPPING', 'PHYSICAL_REVIEW', 'COMPLETED')),
-  CONSTRAINT "SampleProgressItem_cost_non_negative" CHECK (
-    ("requestedCost" IS NULL OR "requestedCost" >= 0) AND
-    ("actualCost" IS NULL OR "actualCost" >= 0)
-  )
-);
-
-CREATE UNIQUE INDEX "SampleProgressItem_openingCode_key" ON "SampleProgressItem"("openingCode");
-CREATE INDEX "SampleProgressItem_status_idx" ON "SampleProgressItem"("status");
-CREATE INDEX "SampleProgressItem_brand_idx" ON "SampleProgressItem"("brand");
-CREATE INDEX "SampleProgressItem_sampleDueDate_idx" ON "SampleProgressItem"("sampleDueDate");
-CREATE INDEX "SampleProgressItem_oaReachedAt_idx" ON "SampleProgressItem"("oaReachedAt");
-CREATE INDEX "SampleProgressItem_designer_idx" ON "SampleProgressItem"("designer");
-
-CREATE TABLE "SampleProgressChangeLog" (
-  "id" TEXT NOT NULL,
-  "itemId" TEXT NOT NULL,
-  "changedFields" JSONB NOT NULL,
-  "beforeSnapshot" JSONB NOT NULL,
-  "afterSnapshot" JSONB NOT NULL,
-  "changeReason" TEXT,
-  "changedById" TEXT,
-  "changedByName" TEXT NOT NULL,
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  CONSTRAINT "SampleProgressChangeLog_pkey" PRIMARY KEY ("id")
-);
-
-CREATE INDEX "SampleProgressChangeLog_itemId_createdAt_idx" ON "SampleProgressChangeLog"("itemId", "createdAt");
-ALTER TABLE "SampleProgressChangeLog" ADD CONSTRAINT "SampleProgressChangeLog_itemId_fkey" FOREIGN KEY ("itemId") REFERENCES "SampleProgressItem"("id") ON DELETE CASCADE ON UPDATE CASCADE;

furniture-3d-system/prisma/migrations/20260810153000_add_bom_cost_estimate_ranges/migration.sql

@@ -1,13 +0,0 @@
-ALTER TABLE "BomCostingScenario"
-  ADD COLUMN "estimateLow" DECIMAL(18, 2),
-  ADD COLUMN "estimateHigh" DECIMAL(18, 2),
-  ADD COLUMN "estimateBasis" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "sampleCount" INTEGER NOT NULL DEFAULT 0,
-  ADD COLUMN "estimatedLineCount" INTEGER NOT NULL DEFAULT 0,
-  ALTER COLUMN "rulesetVersion" SET DEFAULT 'dynamic-bom-cost/v5';
-
-ALTER TABLE "BomCostingScenarioLine"
-  ADD COLUMN "estimateLow" DECIMAL(18, 2),
-  ADD COLUMN "estimateHigh" DECIMAL(18, 2),
-  ADD COLUMN "estimateBasis" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "sampleCount" INTEGER NOT NULL DEFAULT 0;

furniture-3d-system/prisma/migrations/20260810160000_add_supply_chain_warehouse_head/migration.sql

@@ -1,2 +0,0 @@
-ALTER TABLE "SupplyChainProductArchiveWarehouseConfig"
-  ADD COLUMN "warehouseHead" TEXT NOT NULL DEFAULT '';

furniture-3d-system/prisma/migrations/20260810173000_persist_supply_chain_archive_enrichment/migration.sql

@@ -1,17 +0,0 @@
-ALTER TABLE "SupplyChainProductArchive"
-  ADD COLUMN "supplierType" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "supplierStatus" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "settlementMethod" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "boardProvider" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "penaltyStatus" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "warehouseType" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "warehouseHead" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "firstLeadTime" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "palletSpec" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "dailySales" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "sales3d" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "sales7d" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "sales15d" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "purchasePrice" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "costPrice" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "costPriceSecondary" TEXT NOT NULL DEFAULT '';

furniture-3d-system/prisma/migrations/20260811100000_add_supply_chain_product_archive_image_cache/migration.sql

@@ -1,35 +0,0 @@
-CREATE TABLE "SupplyChainProductArchiveImageCache" (
-    "id" TEXT NOT NULL,
-    "archiveId" TEXT NOT NULL,
-    "barcode" TEXT NOT NULL DEFAULT '',
-    "spu" TEXT NOT NULL DEFAULT '',
-    "sku" TEXT NOT NULL DEFAULT '',
-    "previewUrl" TEXT,
-    "source" TEXT NOT NULL DEFAULT '',
-    "viewKey" TEXT NOT NULL DEFAULT '',
-    "viewLabel" TEXT NOT NULL DEFAULT '',
-    "status" TEXT NOT NULL DEFAULT 'NOT_FOUND',
-    "checkedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "error" TEXT NOT NULL DEFAULT '',
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "updatedAt" TIMESTAMP(3) NOT NULL,
-
-    CONSTRAINT "SupplyChainProductArchiveImageCache_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "SupplyChainProductArchiveImageCache_archiveId_key"
-ON "SupplyChainProductArchiveImageCache"("archiveId");
-
-CREATE INDEX "SupplyChainProductArchiveImageCache_barcode_idx"
-ON "SupplyChainProductArchiveImageCache"("barcode");
-
-CREATE INDEX "SupplyChainProductArchiveImageCache_spu_sku_idx"
-ON "SupplyChainProductArchiveImageCache"("spu", "sku");
-
-CREATE INDEX "SupplyChainProductArchiveImageCache_status_checkedAt_idx"
-ON "SupplyChainProductArchiveImageCache"("status", "checkedAt");
-
-ALTER TABLE "SupplyChainProductArchiveImageCache"
-ADD CONSTRAINT "SupplyChainProductArchiveImageCache_archiveId_fkey"
-FOREIGN KEY ("archiveId") REFERENCES "SupplyChainProductArchive"("id")
-ON DELETE CASCADE ON UPDATE CASCADE;

furniture-3d-system/prisma/migrations/20260811160000_sync_intake_product_tags/migration.sql

@@ -1,9 +0,0 @@
-UPDATE "IntakeNonIntegratedPricingRow" AS pricing
-SET
-  "productTag" = btrim(product."payload"::jsonb ->> 'productTag'),
-  "updatedAt" = CURRENT_TIMESTAMP
-FROM "IntakeNonIntegratedProduct" AS product
-WHERE pricing."productId" = product."id"
-  AND product."deletedAt" IS NULL
-  AND btrim(pricing."productTag") = ''
-  AND NULLIF(btrim(product."payload"::jsonb ->> 'productTag'), '') IS NOT NULL;

furniture-3d-system/prisma/migrations/20260811170000_add_sample_progress_product_development_flow_url/migration.sql

@@ -1,2 +0,0 @@
-ALTER TABLE "SampleProgressItem"
-ADD COLUMN "productDevelopmentFlowUrl" TEXT;

furniture-3d-system/prisma/migrations/20260811174500_mark_auto_generated_sample_progress/migration.sql

@@ -1,7 +0,0 @@
-ALTER TABLE "SampleProgressItem"
-  ADD COLUMN "autoGenerated" BOOLEAN NOT NULL DEFAULT false;
-
-UPDATE "SampleProgressItem"
-SET "autoGenerated" = true
-WHERE "progressDescription" = 'OA 自动生成，待补充打样信息'
-  AND "createdBy" IS NULL;

furniture-3d-system/prisma/migrations/20260811183000_add_bom_category_skill_v7/migration.sql

@@ -1,11 +0,0 @@
-ALTER TABLE "BomCostingAnalysisRun"
-  ADD COLUMN "requestedCategorySkillId" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "resolvedCategorySkillId" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "resolvedCategorySkillVersion" TEXT NOT NULL DEFAULT '',
-  ADD COLUMN "categorySkillSelection" JSONB;
-
-ALTER TABLE "BomCostingSku"
-  ADD COLUMN "costFamilyKey" TEXT NOT NULL DEFAULT '';
-
-CREATE INDEX "BomCostingSku_costFamilyKey_idx"
-  ON "BomCostingSku"("costFamilyKey");

furniture-3d-system/prisma/migrations/20260811190000_add_supply_chain_product_archive_region/migration.sql

@@ -1,2 +0,0 @@
-ALTER TABLE "SupplyChainProductArchive"
-  ADD COLUMN "region" TEXT NOT NULL DEFAULT '';

furniture-3d-system/prisma/migrations/20260812093000_add_sample_progress_flow_status/migration.sql

@@ -1,7 +0,0 @@
-ALTER TABLE "SampleProgressItem"
-  ADD COLUMN "flowStatus" TEXT NOT NULL DEFAULT '';
-
-UPDATE "SampleProgressItem"
-SET "progressDescription" = NULL
-WHERE "autoGenerated" = true
-  AND "progressDescription" = 'OA 自动生成，待补充打样信息';

furniture-3d-system/prisma/migrations/20260812163000_add_actual_sample_completed_at/migration.sql

@@ -1,5 +0,0 @@
-ALTER TABLE "SampleProgressItem"
-  ADD COLUMN "actualSampleCompletedAt" TIMESTAMP(3);
-
-CREATE INDEX "SampleProgressItem_actualSampleCompletedAt_idx"
-  ON "SampleProgressItem"("actualSampleCompletedAt");