cy-client-context.js 4.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123
  1. /* === cy-client-context.js · v1.0 (2026-07-18) ===
  2. *
  3. * Benchmark Wealth · 客户上下文总线(SSOT 封装层)
  4. *
  5. * 职责:让"当前客户/画像上下文"在 案例学堂 → IC → CRS → 信托 → 身份规划
  6. * 之间无损流动。localStorage 为主真相源(全量结构化上下文) + URL 作引导信号
  7. * (portrait / clientId 一次性覆盖)。混合模式 C(见《模块打通架构规划 v1.0》§5)。
  8. *
  9. * API(挂 window.CYClientContext):
  10. * · load() 读:URL 引导信号优先浅覆盖,否则读 localStorage 全量
  11. * · patch(partial) 写:工具算完结果浅合并回写(IC 写 insurance,CRS 写 crs...)
  12. * · jumpTo(key, seed) 跳:先 patch(seed) 再跳 CY_PAGES[key],URL 带 portrait 引导
  13. * · clear() 清:重置会话(换客户 / resetDemo 用)
  14. * · get(path) 读单字段(点路径,如 'insurance.gap')
  15. *
  16. * 设计约束:
  17. * - 最小实现(YAGNI · 规划 §7 反对 2),不预造用不上的能力
  18. * - 是 calc-seed-bridge.js 的超集升级,迁移期并存(Strangler)
  19. * - 教育层测评页独立分发时不引用本文件(保持单文件自包含)
  20. *
  21. * 错题本关联:
  22. * #11 跨文件共享代码先查已有共享 JS — 本模块是四模块打通的统一入口
  23. * #9 双源数据矛盾 — 所有工具只经本总线读写,消灭多份上下文副本
  24. * #10 拼接雷区 — 复杂上下文走 localStorage 结构化存储,URL 只带引导 key
  25. */
  26. (function () {
  27. 'use strict';
  28. var KEY = 'cy_client_session';
  29. var SCHEMA_VERSION = '1.0';
  30. // 安全读 localStorage 会话对象(脏数据 / 隐身模式 → 空对象)
  31. function readStore() {
  32. try {
  33. return JSON.parse(localStorage.getItem(KEY) || '{}') || {};
  34. } catch (e) {
  35. console.warn('[cy-client-context] readStore parse failed, reset', e);
  36. return {};
  37. }
  38. }
  39. function writeStore(obj) {
  40. try {
  41. localStorage.setItem(KEY, JSON.stringify(obj));
  42. return true;
  43. } catch (e) {
  44. console.error('[cy-client-context] writeStore failed', e);
  45. return false;
  46. }
  47. }
  48. // <<APPEND_METHODS>>
  49. // load · URL 引导信号优先(一次性浅覆盖),否则读 localStorage 全量
  50. function load() {
  51. var stored = readStore();
  52. try {
  53. var url = new URLSearchParams(window.location.search);
  54. var p = url.get('portrait');
  55. var c = url.get('clientId');
  56. if (p) stored.portrait = p;
  57. if (c) stored.clientId = c;
  58. } catch (e) { /* URLSearchParams 不可用时静默走 localStorage */ }
  59. return stored;
  60. }
  61. // patch · 工具算完结果浅合并回写(顶层 key 覆盖:identity/crs/insurance/trust)
  62. function patch(partial) {
  63. if (!partial || typeof partial !== 'object') return readStore();
  64. var cur = readStore();
  65. for (var k in partial) {
  66. if (Object.prototype.hasOwnProperty.call(partial, k)) cur[k] = partial[k];
  67. }
  68. cur._meta = { schema_version: SCHEMA_VERSION, updatedAt: Date.now() };
  69. writeStore(cur);
  70. return cur;
  71. }
  72. // jumpTo · 先 patch(seed) 再跳 CY_PAGES[key];URL 带 portrait 引导(跨域降级用)
  73. function jumpTo(pageKey, seed) {
  74. if (seed) patch(seed);
  75. var pages = window.CY_PAGES || {};
  76. var url = pages[pageKey];
  77. if (!url) {
  78. console.error('[cy-client-context] jumpTo: unknown CY_PAGES key "' + pageKey + '"');
  79. return false;
  80. }
  81. var portrait = load().portrait || '';
  82. var sep = url.indexOf('?') >= 0 ? '&' : '?';
  83. window.location.href = url + (portrait ? sep + 'portrait=' + encodeURIComponent(portrait) : '');
  84. return true;
  85. }
  86. // clear · 重置会话(换客户 / resetDemo)
  87. function clear() {
  88. try { localStorage.removeItem(KEY); } catch (e) { /* ignore */ }
  89. }
  90. // get · 点路径读单字段(如 'insurance.gap');缺失返回 undefined
  91. function get(path) {
  92. if (!path) return load();
  93. var cur = load();
  94. var parts = String(path).split('.');
  95. for (var i = 0; i < parts.length; i++) {
  96. if (cur == null) return undefined;
  97. cur = cur[parts[i]];
  98. }
  99. return cur;
  100. }
  101. window.CYClientContext = {
  102. version: SCHEMA_VERSION,
  103. KEY: KEY,
  104. load: load,
  105. patch: patch,
  106. jumpTo: jumpTo,
  107. clear: clear,
  108. get: get
  109. };
  110. console.log('[cy-client-context] v' + SCHEMA_VERSION + ' loaded · API:', Object.keys(window.CYClientContext));
  111. })();