| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123 |
- /* === 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;
- }
- }
- // <<APPEND_METHODS>>
- // 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));
- })();
|