/* === cy-client-context.js · v1.0 (2026-07-18) === * * Benchmark Wealth · 客户上下文总线(SSOT 封装层) * * 职责:让"当前客户/画像上下文"在 案例学堂 → IC → CRS → 信托 → 身份规划 * 之间无损流动。localStorage 为主真相源(全量结构化上下文) + URL 作引导信号 * (portrait / clientId 一次性覆盖)。混合模式 C(见《模块打通架构规划 v1.0》§5)。 * * API(挂 window.CYClientContext): * · load() 读:URL 引导信号优先浅覆盖,否则读 localStorage 全量 * · patch(partial) 写:工具算完结果浅合并回写(IC 写 insurance,CRS 写 crs...) * · jumpTo(key, seed) 跳:先 patch(seed) 再跳 CY_PAGES[key],URL 带 portrait 引导 * · clear() 清:重置会话(换客户 / resetDemo 用) * · get(path) 读单字段(点路径,如 'insurance.gap') * * 设计约束: * - 最小实现(YAGNI · 规划 §7 反对 2),不预造用不上的能力 * - 是 calc-seed-bridge.js 的超集升级,迁移期并存(Strangler) * - 教育层测评页独立分发时不引用本文件(保持单文件自包含) * * 错题本关联: * #11 跨文件共享代码先查已有共享 JS — 本模块是四模块打通的统一入口 * #9 双源数据矛盾 — 所有工具只经本总线读写,消灭多份上下文副本 * #10 拼接雷区 — 复杂上下文走 localStorage 结构化存储,URL 只带引导 key */ (function () { 'use strict'; var KEY = 'cy_client_session'; var SCHEMA_VERSION = '1.0'; // 安全读 localStorage 会话对象(脏数据 / 隐身模式 → 空对象) function readStore() { try { return JSON.parse(localStorage.getItem(KEY) || '{}') || {}; } catch (e) { console.warn('[cy-client-context] readStore parse failed, reset', e); return {}; } } function writeStore(obj) { try { localStorage.setItem(KEY, JSON.stringify(obj)); return true; } catch (e) { console.error('[cy-client-context] writeStore failed', e); return false; } } // <> // load · URL 引导信号优先(一次性浅覆盖),否则读 localStorage 全量 function load() { var stored = readStore(); try { var url = new URLSearchParams(window.location.search); var p = url.get('portrait'); var c = url.get('clientId'); if (p) stored.portrait = p; if (c) stored.clientId = c; } catch (e) { /* URLSearchParams 不可用时静默走 localStorage */ } return stored; } // patch · 工具算完结果浅合并回写(顶层 key 覆盖:identity/crs/insurance/trust) function patch(partial) { if (!partial || typeof partial !== 'object') return readStore(); var cur = readStore(); for (var k in partial) { if (Object.prototype.hasOwnProperty.call(partial, k)) cur[k] = partial[k]; } cur._meta = { schema_version: SCHEMA_VERSION, updatedAt: Date.now() }; writeStore(cur); return cur; } // jumpTo · 先 patch(seed) 再跳 CY_PAGES[key];URL 带 portrait 引导(跨域降级用) function jumpTo(pageKey, seed) { if (seed) patch(seed); var pages = window.CY_PAGES || {}; var url = pages[pageKey]; if (!url) { console.error('[cy-client-context] jumpTo: unknown CY_PAGES key "' + pageKey + '"'); return false; } var portrait = load().portrait || ''; var sep = url.indexOf('?') >= 0 ? '&' : '?'; window.location.href = url + (portrait ? sep + 'portrait=' + encodeURIComponent(portrait) : ''); return true; } // clear · 重置会话(换客户 / resetDemo) function clear() { try { localStorage.removeItem(KEY); } catch (e) { /* ignore */ } } // get · 点路径读单字段(如 'insurance.gap');缺失返回 undefined function get(path) { if (!path) return load(); var cur = load(); var parts = String(path).split('.'); for (var i = 0; i < parts.length; i++) { if (cur == null) return undefined; cur = cur[parts[i]]; } return cur; } window.CYClientContext = { version: SCHEMA_VERSION, KEY: KEY, load: load, patch: patch, jumpTo: jumpTo, clear: clear, get: get }; console.log('[cy-client-context] v' + SCHEMA_VERSION + ' loaded · API:', Object.keys(window.CYClientContext)); })();