# solution

**Repository Path**: secosun/solution

## Basic Information

- **Project Name**: solution
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-24
- **Last Updated**: 2026-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 动牛安装 · 项目文档中心（2026-09-09 整理）

> solution 仓库根目录只留 `CLAUDE.md`（本地开发环境速查，已精简）、子项目代码、`helm/`、`legacy/`；全部 Markdown 文档收敛于此。
> 检索顺序：`contract` → `product` → `design` → `archive`（越靠前越"当前有效"）。
> 🗄️ 根目录的 `legacy/` 是**退役物收容区**（旧 values / 终端记录 / 过期部署说明），已挪出工作路径但未删除 —— 见其 `README.md`。
> **运维速查**：启动/排障/windmill 部署/布局铁律的完整明细 → 本目录 `dev-runbook.md`（CLAUDE.md 下沉区）。
> **下一会话从这里接手**：`archive/归档-2026-09-25-剩余待办与工作计划.md`（2026-09-25 收盘整理：
> 「打坏也能用」三指标已达标 + **剩余待办 A/B/C/D/E 分组** + 建议顺序 + 今日坑清单）。
> 历史待办：`待办-2026-09-22-系统评价落地.md`（09-22 体检结论落成的可执行清单）。

## 目录结构

| 文件夹 | 定位 | 内容 |
|---|---|---|
| `contract/` | **当前权威契约/集成规范** | 小程序×H5 集成契约 v1.1、H5 登录路径说明 |
| `product/` | **PRD / 用户手册 / 对外交付物** | 首页 PRD、平台使用说明书、Demo 数据、客户可选服务清单 |
| `design/` | **现行业务/技术定稿（对应已落地实现）** | 业务角色分析、状态机矩阵、结算方案、服务命名规范、多角色改造、维修流程定稿、UI 设计规范 |
| `archive/` | **历史归档（已完成/被取代/阶段记录，仅追溯）** | 里程碑、事故记录、归档-*、验证计划、重构/部署/优化方案、AI 客服文档、ToB 设计溯源 |

## 各文件夹清单

### contract/（2）
- `小程序H5集成契约-v1.1.md` — 跨端集成**权威契约**（URL hash 传参 + wx.miniProgram 导航）
- `H5登录路径说明.md` — H5 端登录路径收敛说明

### product/（4）
- `PRD-首页&全品类选择弹窗-2026-09.md`
- `platform-user-manual.md` — 业主/商家/技师/管理员四类角色手册
- `demo-orders.md` — Demo 演示数据（8 单，含账号）
- `铝艺及门窗类安装测量服务（客户可选版）.md`

### design/（12）
- `多角色协作测试-设计-2026-09-22.md` — **测试架构定稿**：每角色一个进程（fork+IPC）、角色之间只经平台互相影响、按并发浏览器数调度（4 核 → ≤4）、对齐起跑代替人为延迟、失败取证（合并时间线/卡点）作为设计的一部分；含 31 个 spec 的去向与迁移五阶段验收
- `实时推送闭环与在线状态-设计-2026-09-18.md` — **跨仓库设计**：前端→Kafka→PowerJob→rpush 实时推送闭环、在线状态两处错配（白推/漏推）、方案 D（在线键收敛到 socket 生命周期）、跨仓库契约清单、跨仓级坑与暴露面边界
- `抢单可见性状态机-设计-2026-09-09.md` — 撮合域分层可见设计：好单特权时间窗逐级解锁/只推新层、差单直接全开、漏单客服记录转兜底师傅（结算 7:3 平台 70% 底线定稿）
- `business-process-roles-analysis.md` — 当前 B2B/B2C 业务流程与角色全貌
- `status-action-matrix.md` — 状态 × 角色 × 动作矩阵（重构阶段 2 交付物，对照 orderStatus.js/repair.js）
- `结算方案-2026-09-03-履约总包与技师转账设计.md`
- `服务名称规范-2026-09-02.md`
- `多角色同号改造-设计.md`
- `repair-flow-gap-and-plan.md` — 维修/报修子流程最终架构（已实施）
- `档位坐标-设计-2026-09-21.md` — 三档（dev/test/prod）坐标单一真源：入口/数据层/命名空间/Kafka 前缀/windmill workspace 的对应关系
- `dev-test环境升级-计划-2026-09-18.md` — dev/test 数据层容器化到 125 的计划
- `material.md` — UI 设计规范/素材库

### archive/（47）
- **会话纪要（全量开发史）**：`归档-2026-09-10-会话纪要-2026-08-solution主线`（08-06~09-02，15 会话/五阶段：定位选型→架构定调→流程引擎→业务规则→UAT）、`归档-2026-09-10-会话纪要-2026-09-小程序阶段`（09-02~09-10，23 会话/六阶段：网络基座→支付结算→壳冷启动→入驻状态机→实时同步→业务策略）；两份互链，含「勿回退决策」与遗留待办
- **战略/决策快照**：`归档-2026-09-09-商业模式与履约机制结论`（全国电商履约总包模型 + 供给可靠性机制 + **待办列表**；含【定案】/【评审结论】/【待拍板】标注）
- **架构快照**：`归档-2026-09-09-全系统架构梳理`（跨小程序壳+H5/服务端+中间件的一页式总览，权威细节见文末索引）
- **欠账核实**：`归档-2026-09-09-设计欠账核实评审`（代码实测盘点：真欠账/已做未更新/部分实现/有意搁置，附证据引用）
- **跨仓评审**：`归档-2026-09-11-壳H5测试质量与上线价值评审`（壳/H5 测试质量与覆盖率 + 上线业务价值；结论：受控试点可上、放量前 5 道硬门槛）
- **复评（最新）**：`归档-2026-09-22-系统评价（复评-当日改动后）`（**一天折腾完的再评估**：核心判断「风险重心已从『代码写得对不对』移到『改东西的方式对不对』」——当天两次事故都不是业务代码的错；含现状家底、P0=无 / P1 五条 / 新增「审一遍依赖型探针」待办、建议下一步）
- **当日收官**：`归档-2026-09-22-收官-三P0闭环与资源治理`（与下一份体检是**一对**：体检=发现什么，收官=做了什么/现在什么状态/还欠什么。含**这天抓到的两个真问题**：MongoDB 备份一直是空的、一次 helm upgrade 把推送链静默打断；§七 补录记了单号方案 B/C 与两次事故；当前状态一览表；复现脚本入口；六条变更纪律）
- **全系统体检**：`归档-2026-09-22-系统评价（当前状态体检）`（2026-09-22 实测体检：**三个新 P0 = Kafka 副本反复 OOMKilled / 每周恢复演练 3/4 红且无人知晓（根因=演练设计缺陷，非备份损坏）/ 零监控**；含 09-16 评审 P0 的闭环对照表 + 可复现命令 + **集群按 UTC 排班的时区坑**）
- **全系统评审**：`归档-2026-09-16-全系统介绍与评审`（壳+H5+中间件+编排+基础设施横向体检：8 条「做得对·勿回退」+ P0/P1/P2 欠账 + 建议推进顺序；**P0 = 轮换已入库凭据 / 数据层零备份 / 无 CI**；§⑧ 记了「`installment/helm/` 是停在生命周期加固之前的危险分叉，勿用」）
- **近期交接/验收**：`归档-2026-09-21-档位分离与实时推送事故`（三档坐标 + 125 定型为运行时 + 三端一致 14/14）、`归档-2026-09-20-prod灰度AB验收与上线检查清单`、`归档-2026-09-19-dev-test环境升级-P0收官与待办`、`交接-2026-09-21-重启前状态`
- **里程碑/事故**：`milestone-2026-09-08-全功能初步完成`、`milestone-2026-09-01-uat`、`incident-2026-08-25-dev-hang`、`archive-2026-08-27`、`status-archive`
- **阶段归档**：`归档-2026-09-02-小程序B2C联调开发`、`归档-2026-09-04-*`×2、`归档-2026-09-11-小程序壳测试全覆盖补测与死代码清理`（壳测试 68→96 断言 + 清死代码）、`技术归档-2026-09-03-*`、`真机验证计划-2026-09-03`
- **验证/测试**：`boundary-cases`、`b2b-acceptance-chain`、`launch-check-and-test-plan`、`b2c-b2b-progress-design`、`b2c-form-ux-plan`
- **方案/重构**：`refactor-plan-2026-08`、`flow-optimization-plan`、`repair-backlog-design`、`ui-form-refactor-plan`、`next-step-plan`、`dev-namespace-plan`、`selfuse-platform-upgrade`
- **部署/架构**：`deploy-125-full`、`architecture-evaluation-v2`
- **AI 客服**：`ai-test-cases`、`ai-chain-review`、`ai-architecture-analysis`、`ai-architecture-assessment`
- **业务设计溯源**：`design.md`（ToB 自营 UI 改版 v1.2，最全版）、`development-design-plan`、`market-competition-assessment`

> 同名/近义文档已合并：ToB v1.0 两份 + PDF、架构评估 v1、AI 运行碎片报告（report-*.md / test-report.md）已删除，历史可经 git 找回。