inkreachhub/inkreach-official-website
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
194 Commits 9 Branches 1 Tag
6f4a5677fd5cf47932e7e8f0d5d6c9abf13c6c3b
Commit Graph
40 Commits
Author SHA1 Message Date
yeuimu 2d2aeb655a docs(perf): P0 生产部署结果回填——备份存档、23s 切换、缓存/gzip/限流/PG 参数实测数据 2026-09-03 08:44:57 +08:00
yeuimu 027ef2b296 docs: 性能整改落地文档——structs 补缓存层与部署参数说明、报告标注 P0 实施进度、AGENTS 沉淀切片缓存陷阱与 bullseye 跑测经验 2026-09-03 03:40:33 +08:00
yeuimu ca38476047 docs(perf): public 端口 1w 瞬时并发审查报告与整改计划——逐层瓶颈证据、P0/P1/P2 分级、全局约束（DB 变更先备份/写路径必失效缓存） 2026-09-03 03:40:12 +08:00
yeuimu dd6a540bf3 fix(product-families): 不打印链接移出族（纯数据修复）——矩阵不再计算不打印工艺，BRTF004 恢复烫画×单面 
- 生产数据操作（未改源代码）：11 条光板/不打印链接 family_id 置空（族 1/2/63/135/148），
  名下 3 商品脱族，族 148 主链接 964→965、族 135 主链接置空
- 容器内直调已部署 FamilyRecomputeService 重算 5 族：全库矩阵不再含「不打印」，
  族 148 = 烫画×单面印花×不包邮（min 19），public 端口验证通过
- 回滚存档：deploy/backups/20260903-noprint-removal/（全库 dump + 受影响行 CSV + RESTORE.md）
- 文档：product-center/structs 记录数据约定与回流风险（organize/autoGroup/人工改标签会回挂散链接）；
  AGENTS.md 沉淀 占位借词表值/物化JSON需显式重算/数据修复三件套 三条经验
 2026-09-03 02:53:10 +08:00
yeuimu 0d2a954153 deploy(single-stack): 单栈收敛——v2 并入 deploy compose，v1 退役 
- docker-compose.yml 重写为单栈 4 容器（admin 边缘 + v2-api/v2-admin/v2-postgres），
  v2 数据卷 deploy-v2_pgdata/uploads 以 external 引用，数据零迁移
- nginx：/uploads/ /assets/ 上游改 v2-api（product-center 覆盖块随之冗余移除），
  / 跳转 /v2/admin/；docker-compose.v2.yml 删除（血统已并入 develop）
- v1 api+postgres 已停用未删，终档/快照/回滚手册见 deploy/backups/consolidation-*/
- 切换验证：v2 库切换前后行数完全一致；/v2-api /public /v2/admin /v2/h5
  /assets 全路由冒烟 + 公网端到端通过
 2026-09-03 02:09:24 +08:00
yeuimu 5e69397adc merge: refactor/v2 完全并入 develop（v2 为准，v2 血统 20+ 提交收敛为主干） 2026-09-03 01:54:32 +08:00
yeuimu 37353470e7 fix(categories): 分类名去括号——同步入库整段删除括号段 
左侧分类树/官网分类名的括号段（型号限定词（JSA002）与内容性括号
（黑+卡其）/（短裤 & 长裤））整段删除。分类名每小时被 SDS 同步覆盖，
清洗落在 syncCategories 入库路径（cleanCategoryDisplayName，款号 token
保留，剥空守卫），另附幂等存量脚本 fix:category-names。

已执行：V1/V2 各 33 条分类名去括号，复跑幂等 0。注意 api 容器重建
部署前旧镜像的下一轮同步会把名称写回原文，部署后自动恢复干净。

Tests: api 23 suites/206 passed（含新增 category-name.spec 7 例），tsc clean
 2026-09-03 01:27:38 +08:00
yeuimu 9eafac7204 fix(goods): 商品展示名统一「品名 SKU」——剥 ASCII 型号限定词、纯款号补描述 
左栏商品名显示成光款号（如 PLTK016）的根因是双层解析不一致：api 写路径按
首括号对解析产出「童装…（DTG180） PLTK016」，admin 展示解析按末括号取品名
误显示成 PLTK016。

- admin parseLinkName 对齐 api 首括号对解析 + 无 SKU 段中文品名守卫，
  cleanLinkName 剥离 ASCII 型号限定词（中文括号内容保留）
- api 新增 cleanGoodDisplayName/describePureSkuGoodName，接入 create/update/
  batchCreate（batchCreate 补上缺失的 normalize）；纯款号按 SDS 分类名补描述
- 新增幂等存量修复脚本 fix:good-names（默认 dry-run，--apply 写库）
- 已执行：V2 栈 34 条限定词名、V1 栈 213 条原始链接名规范化，复跑幂等 0

Tests: api 22 suites/199 passed, admin 27 passed, tsc clean
 2026-09-03 01:27:26 +08:00
yeuimu 814f45c5a3 fix(categories): 分类名去括号——同步入库整段删除括号段 
左侧分类树/官网分类名的括号段（型号限定词（JSA002）与内容性括号
（黑+卡其）/（短裤 & 长裤））整段删除。分类名每小时被 SDS 同步覆盖，
清洗落在 syncCategories 入库路径（cleanCategoryDisplayName，款号 token
保留，剥空守卫），另附幂等存量脚本 fix:category-names。

已执行：V1/V2 各 33 条分类名去括号，复跑幂等 0。注意 api 容器重建
部署前旧镜像的下一轮同步会把名称写回原文，部署后自动恢复干净。

Tests: api 23 suites/206 passed（含新增 category-name.spec 7 例），tsc clean
 2026-09-03 01:20:17 +08:00
yeuimu c3be8ab979 fix(goods): 商品展示名统一「品名 SKU」——剥 ASCII 型号限定词、纯款号补描述 
左栏商品名显示成光款号（如 PLTK016）的根因是双层解析不一致：api 写路径按
首括号对解析产出「童装…（DTG180） PLTK016」，admin 展示解析按末括号取品名
误显示成 PLTK016。

- admin parseLinkName 对齐 api 首括号对解析 + 无 SKU 段中文品名守卫，
  cleanLinkName 剥离 ASCII 型号限定词（中文括号内容保留）
- api 新增 cleanGoodDisplayName/describePureSkuGoodName，接入 create/update/
  batchCreate（batchCreate 补上缺失的 normalize）；纯款号按 SDS 分类名补描述
- 新增幂等存量修复脚本 fix:good-names（默认 dry-run，--apply 写库）
- 已执行：V2 栈 34 条限定词名、V1 栈 213 条原始链接名规范化，复跑幂等 0

Tests: api 22 suites/199 passed, admin 27 passed, tsc clean
 2026-09-03 01:04:22 +08:00
yeuimu f1e81872e7 fix(product-family): auto-merge SKUs after manual tag edits; fix session cookie path 
问题2（SKU 无法自动合并，GBIU017 案例）四处叠加根因修复：
- 人工标签旧词「热转印」被封闭词表静默踢出合并矩阵 → CRAFT_TAG_ALIASES
  别名归一为「烫画」（矩阵归因与 CUSTOM 标签同路径生效）
- updateTags 缺任一定价维度组即整链掉出矩阵且人工接管后永不恢复 →
  缺啥补啥（按链接名派生补齐，人工勾选值不动，响应带 filledDimensionTags）
- autoGroup 只建新族从不并入已有族（产生 USIU005-2 类碎片）→ 并入已有
  autoManaged 同款族优先，无匹配才新建；同款仅人工锁定族则跳过并报告
- 名称回退分组键含物流备注，包邮/不包邮永不同组 → 新增族语义键
  familyNameKey（国家+品名+SKU），api/admin 两侧同构，合并默认勾选随之修复

附加：
- updateTags 后未归族链接自动并入匹配族（attachToMatchingFamily，响应带
  attachedFamilyId）
- 整理新增碎片族合并 consolidateFragments：纯碎片族并入带商品族并删除
  （保公开 goodId=族ID 稳定），带商品/覆盖价/人工锁定进人工复审报告
- admin：保存标签提示补齐明细，整理完成消息含并入/碎片合并/待人工数

问题1（后台频繁 Unauthorized 掉线）：
- refresh cookie path '/auth' 与代理前缀（/api、/v2-api）不匹配导致浏览器
  永远带不上 refresh cookie → 两 cookie path 统一为 '/'
- v2 构建基址带尾斜杠 + 手工拼接产生 /v2-api//auth/refresh 双斜杠 404 →
  request.ts 规范拼接

测试：api jest 187/187、admin vitest 22/22、双侧 tsc 0 错误；
public.service 夹具改为自包含（不依赖共享库既有数据）。
 2026-09-02 18:39:35 +08:00
yeuimu 76eb849b49 docs: record style-order semantics, container-run pitfalls and lessons 2026-09-02 10:33:54 +08:00
yeuimu 674d38a9a7 fix(api,admin): stop test fixture junk leaking to shared dev DB; badge text x个配置 
清理标签筛选里的「Upd {ts}-v2」空分组与原产品库树里的
「Tree Cat {ts}」垃圾分类——两者均为集成测试夹具残留：
- tag-groups spec「改名」用例把分组改成 -v2 后缀，afterAll 按原名
  删除永远漏掉它（累积 31 个空分组）；修复：改名前把 v2 名一并登记
- origin-goods spec getTree 用例的 finally 先删 good，被
  goodOriginGood 外键限制挡住且错误被 .catch 吞掉，分类/商品/国家/
  链接全部残留；修复：先删引用行再删 good
- 已清库：31 个 Upd 空分组、Tree Cat 分类 + Tree Good 商品 +
  Tree Country 国家 + 2 条 tree-a/b 链接；复跑两 spec 复核零残留

左树一族一行徽标文案按用户反馈去掉「N 条链接」，仅显示「M 个配置」
（memberCount 字段保留在 DTO，悬浮弹层行为不变）

验证：tag-groups + origin-goods spec 13/13 绿且零残留；admin
vue-tsc 干净 + vitest 22/22
 2026-08-30 03:15:18 +08:00
yeuimu a756c8c3c8 fix(admin,api): always show family composition badge N条链接·M个配置 
按用户反馈（PLTM006 明明能查到配置数却不显示）：左树徽标此前只在
同分类内 ≥2 个配置时才出现，单配置族一行上什么都不显示，而右树同族
链接都挂着绿色已配置徽标，两边数字对不上，反复造成「配置数没显示」
的误解。

- goods API：GOOD_INCLUDE 的 family 带 _count.originGoods，
  GoodDto.originGood.family 增加 memberCount（族成员链接数）
- admin：distinctByFamily 记录 linkCount；一族一行的徽标常显
  「N 条链接 · M 个配置」（链接数=族成员数，配置数=该族官网商品数），
  悬浮仍列出全部配置可打开
- 文档同步徽标语义

效果：PLTM006 行显示「4 条链接 · 1 个配置」（真值：4 条链接仅配了
1 个官网商品）；PLTF026 的「4 条链接 · 4 个配置」同屏可对比，其中
4 个配置为历史同国家重复配置，建议另行清理。

验证：admin vue-tsc 干净 + vitest 22/22；api goods spec 18/18；
Prisma _count 查询实测返回 originGoods=4
 2026-08-30 03:07:16 +08:00
yeuimu 49d28c8d4f fix(admin): block re-config for family-configured links 
按用户反馈：族已配置后不允许再配置（撤回上一轮的「再配置」入口）：
- 「配置」按钮仅在本链接及其同款族均未配置时显示（configuredCount
  与 familyConfiguredCount 均为 0），族已配置的链接只显示「同款已配置」徽标
- openConfigModal 增加统一拦截（按钮与右树拖拽两条路径都覆盖）：
  已配置/族已配置的链接弹出警告并阻止打开配置弹窗，避免产生官网
  不可见的冗余商品
- 文档同步：撤回「再配置」语义，恢复拦截说明

已核实 PLTF004（族 786）实际仅 1 个官网商品，「四个配置」是右树
族聚合徽标造成的观感误解；149 个族无一跨分类，左树一族一行计数无误。

验证：admin vue-tsc 干净 + vitest 22/22 绿
 2026-08-30 02:55:28 +08:00
yeuimu fa4a95af98 fix(admin): relabel family-configured badge to 同款已配置; button 再配置 
按用户反馈修正右树「已配置徽标 + 配置按钮」并存的矛盾观感：
- 徽标改为链接级真值：本链接未单独建商品但所属族已配置时显示
  「同款已配置」（此前沿用拦截时代的「已配置」文案，与恢复出的
  配置入口语义打架）
- 该场景下按钮文案改为「再配置」，悬浮说明指向调整归族/加配国家；
  本链接自身已配置时按钮照旧隐藏，行为不变
- 文档撤回过时的「族已配置后配置入口会被拦截」说法（6f2d836 已
  撤回拦截，徽标文案此番补齐）

验证：admin vue-tsc 干净 + vitest 22/22 绿
 2026-08-30 02:40:39 +08:00
yeuimu 93ac525c55 refactor(api): parsing out of runtime — pure-mirror sync, explicit organize, auto aggregate recompute 
解析去运行时化（三层架构，plans/refactor/organize-script-refactor.md）：
- 同步 = 纯镜像：upsertOriginGood 不再写解析列、不再自动挂族；详情同步仍触发重算
- 整理 = 显式人工动作（OrganizeService）：解析列回填 → 派生标签（人工接管永不
  覆盖）→ auto-group 建族 → 全量重算；入口 CLI（pnpm --filter @inkreach/api
  organize）+ POST /product-families/organize + 后台「整理」按钮
- 重算 = 纯结构化聚合：不再按名称重派生标签（防上游改名倒灌，回归测试覆盖）；
  矩阵维度只认标签/CUSTOM 显式标签，未整理成员不进矩阵；工艺=不打印时
  印花数量以单面占位（纯结构化规则）；「恢复自动」走整理的单链接派生
- 派生默认补齐（脚本层假设）：名称无单/双面且工艺非不打印 → 印花数量单面印花
- goods 服务建品/更新后仅镜像标签+重算（不派生）；含商品名入库规范化
  （normalizeGoodName，管理员输入边界质检）
- organize.service.spec 由 tag-sync spec 迁移 + 防倒灌回归；sync/recompute/
  public/families spec 全部适配；API 173/173，admin typecheck+22/22
 2026-08-30 01:27:01 +08:00
yeuimu d625b40873 fix(admin): merge-candidates by SKU/family; config dialog merge block always shown; cfg badge adjacency 
- 修正合并同名候选匹配：此前用名称 3 段组键（含工艺段），工艺写法不同的
  同款（如 光板不打印 vs 单面印花（前印））全部漏配导致候选为空、合并同名
  区块被 v-if 隐藏 —— 用户看到的"checkbox 和搜索框被吞"即此因。
  改为 族归属精确匹配 或 款号（名称第 2 段，如 BRTF004）一致，全局跨分类；
  区块常显，无候选时空态提示
- 修左树「N 个配置」徽标错位：good-name-col 改 flex 布局，徽标紧贴名称
- 验证：admin typecheck + 22/22 + 构建绿；DB 实测 BRTF004 光板链接候选池
  恢复（单面印花（前印），同族 857）
 2026-08-29 02:16:35 +08:00
yeuimu 6f2d836ef5 fix(admin): one row per family on left tree; restore right-tree config entry 
按用户反馈调整上一批优化：
- 左树撤回族组展开层（虚线层+重复名称行）：改为一族只显示一行（排序最前的
  代表商品），行内「N 个配置」徽标悬浮列出该族全部配置（名称/国家·分类/打开
  按钮），不再有额外层级与重复名称
- 右树恢复配置入口：撤回「族已配置拦截」，本链接未单独建商品即显示「配置」
  按钮（含族已配置情形，供调整归族/重新配置），拖拽路径同步解除拦截
- 国家模式拖拽排序回退为分组内简单排序（族组节点已不存在）
- 文档同步更新徽标/入口语义

验证：admin typecheck + 22/22 + 构建绿；浏览器实测美国分组 25 行一族一行、
「8 个配置」徽标悬浮列表可打开、国内工厂深层成族链接显示「配置」按钮
 2026-08-29 01:53:09 +08:00
yeuimu fdfe435ecd fix(admin): config dialog merge candidates search globally by name group 
合并同名候选不再局限于当前分类节点：collectSiblings 改为按名称 3 段组键
（sameOriginGroup）遍历整棵右树收集同款链接（含已配置，勾选归族幂等），
跨分类的同款链接（如 BRTF004 分布在多个分类组）也能勾选归族
 2026-08-28 20:04:29 +08:00
yeuimu 1e07c62fc8 feat(admin): country drag-sort + always-available member detail sync 
- Country 加 sort_order（默认 0 保持 id 序）；PATCH /countries/sort 批量保存
  顺序（对齐 /tags/sort 模式）；findAll 与公开 /public/countries 均按
  sortOrder 排序
- CountriesView 表格改为可拖拽行列表：拖动松开即全量保存新顺序，失败回滚
- 商品编辑弹窗成员展开面板：同步详情按钮常驻（已同步显示 重新同步详情），
  不再只在未同步态出现
- goods.service.spec 的 FamilyRecomputeService mock 补齐 syncFamilyTags 等
  方法（全量并行时其他套件的扫名归族会把本套件夹具收进族，create/update
  会调用到，mock 缺方法导致偶发 TypeError）
- api 164/164、admin typecheck+22/22+构建全绿
 2026-08-28 20:00:56 +08:00
yeuimu fe6ab3825d fix(admin): family-aware right-tree badges; flatten union size-chart cells 
- 右树徽标/定位/配置按钮改按族语义：族内任一链接已配置 → 全族显示绿色
  已配置（本链接未单独建商品时标题注明并入该款），配置入口在全族未配置时
  才出现；拖拽已配置族链接配置时拦截提示（公开契约一族一款，重复商品官网
  不可见）；分组头计数与仅未配置筛选同步族感知（AUTM003/DG120 场景）
- 编辑弹窗族级尺码表把 measurements 数组摊平成列键（与成员级渲染一致），
  修复列头在、格子全空的问题
 2026-08-28 19:16:15 +08:00
yeuimu 8a052773cd feat(public): family-first contract — goodId=familyId, strict 5-dim price matrix 
公开契约族化（前端只需知道款号/族）：
- GET /public/goods 一族一条（goodId=族ID，price=族起价，分页作用于分组后）；
  无族商品（自定义）不进任何公开端点（列表/首页/分类树/标签统计）
- GET /public/goods/:goodId 仅认族 ID；公共字段取代表 Good，变体=全体成员并集，
  尺码表/包装规格=族物化并集；旧 SDS 链接 ID 寻址 404
- priceMatrix 严格五维：尺码×颜色×印花数量×工艺×物流；维度来源改为链接级
  标签（人工接管按人工标签），弃用原始 craftLabel；CUSTOM 成员尊重显式标签
- 名称派生补裸「单面/双面」写法（直喷双面→双面印花+直喷，18 条存量链接修复）
- family_price_overrides 加 print_count 列（五键唯一），PUT/DELETE/校验五键化
- admin 编辑弹窗矩阵消费适配（SKU 列直读 printCount，成员格子三维匹配，
  改价 payload 带 printCount）
- 存量 339 族已全量重算；api 162/162、admin 22/22、双端构建绿
 2026-08-28 18:43:30 +08:00
yeuimu 6054cb556a docs: family union tabs and searchable merge list 2026-08-28 17:27:53 +08:00
yeuimu f280b1daf5 docs: reflect simplified member price table 2026-08-28 17:03:12 +08:00
yeuimu f28f51155f feat(goods): per-member detail tabs in edit dialog; revert right-tree to raw names; split configured/family badges; add GET /origin-goods/:id 2026-08-28 16:55:07 +08:00
yeuimu 10197c47a8 refactor(admin): split GoodsView into dialog components; fix(GoodsView): raw member names, no primary badges, member price grid; feat(tag): 光板 maps to 不打印 2026-08-28 16:40:48 +08:00
yeuimu 6f22a6fd1f feat(admin): expandable family members with per-link tag config + SKU pricing dims columns 2026-08-28 16:00:46 +08:00
yeuimu 1128167aef feat(admin): family-aware goods view - auto tags readonly, clean link names, config badges, locate highlight 2026-08-28 15:33:11 +08:00
yeuimu eedfbb344e feat(product-family): auto-derive logistics/craft tags from family members 2026-08-28 14:57:25 +08:00
yeuimu 353e51e871 revert(admin): restore original layout, replace primary/secondary source UI with family members 2026-08-28 14:35:34 +08:00
yeuimu 4eadb67c36 feat(product-family): replace legacy good merge with family mechanism in config view and public detail 2026-08-28 14:14:58 +08:00
yeuimu 6418aa7302 feat(api): public good detail family block behind gray-release flag 2026-08-28 13:40:19 +08:00
yeuimu d70a03f6fa docs: admin product family references 2026-08-28 13:30:37 +08:00
yeuimu 502b7eba6e docs: update references for product families; fix controller import and test isolation 2026-08-28 12:50:42 +08:00
yeuimu 4bebb9e4b2 docs: document merged origin goods feature 2026-08-27 18:49:17 +08:00
yeuimu 6c61a4e871 feat(deploy): production deployment setup and fixes 
- Debian-based api image (bookworm-slim), docker/debian mirrors, prisma
  binaryTargets for openssl 3.0
- nginx: admin SPA under /admin, TLS via acme.sh (ZeroSSL) + auto-renewal
  cron, http->https redirect
- prisma: add origin_goods.delisted migration, sync missing schema
  (good_image/tag_font_color/good_tags), fix users.createdAt Timestamptz
- api: CORS wildcard reflection, helmet CORP cross-origin, price
  backfill in persistProductDetail, categoryIcon ancestor fallback,
  mediaByColor per-color gallery in public goods detail
- admin: /admin base path (vite + router)
- import-data.mjs: udt_name casting, serial sequence advance fix
 2026-08-26 14:23:09 +08:00
yeuimu 79fabd85f7 feat(product-center): implement Figma-designed UI, upload module, and website tests 
- Redesign website homepage & product-center per Figma (fonts, logos, hero/footer/customer cases)
- Add API upload module (multer) with static serving for uploads/public assets
- Add OriginGood.delisted flag and SDS request retry logic
- Add admin ImageUpload component and goods import/upload flows
- Add vitest suite for website components and composables (32 tests)
- Add skills, docs, plans and PRODUCT.md
 2026-08-20 14:32:03 +08:00
yeuimu 7e04877bb6 chore: migrate to pnpm workspaces monorepo with Turborepo 
- Restructure directories: apps/api, apps/admin, apps/website
- Add root pnpm-workspace.yaml, turbo.json, .prettierrc, .gitignore
- Rename packages to @inkreach/api, @inkreach/admin, @inkreach/website
- Add shared packages: packages/tsconfig, packages/shared-types
- Add pnpm.onlyBuiltDependencies for native builds
- Update docs: README.md, structs.md
- All three projects build successfully
 2026-07-11 16:54:05 +08:00
yeuimu c3472a449b feat(product-center): implement full product center with NestJS backend, Vue3 admin, and Nuxt4 website page 
- NestJS backend: Prisma + PostgreSQL, JWT auth, CRUD for goods/categories/countries/tags/positions, SDS sync with cron, public API, Swagger docs
- Vue3 Admin: Element Plus, goods/categories/countries/tags/positions/sync management pages, batch operations, login with JWT
- Nuxt4 Website: product-center page with sidebar navigation, country filter, search, product grid, pagination, skeleton loading
- Nitro proxy routes for backend API
- 54 backend tests passing
- Updated docs and README
 2026-06-15 10:09:42 +08:00