mm_datas 0.0.0-stage → 5.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/example/custom_demo.js +237 -0
  2. package/example/model/item_model.json +46 -0
  3. package/example/model/map_model.json +53 -0
  4. package/example/model/player_model.json +65 -0
  5. package/example/model/role_model.json +61 -0
  6. package/example/model/skill_model.json +60 -0
  7. package/example/preset_demo.js +44 -0
  8. package/example/rpg_cache.js +179 -0
  9. package/example/rpg_crud.js +170 -0
  10. package/example/rpg_demo.js +61 -0
  11. package/example/rpg_model/bag_model.json +74 -0
  12. package/example/rpg_model/character_model.json +165 -0
  13. package/example/rpg_model/character_skill_model.json +61 -0
  14. package/example/rpg_model/drop_model.json +103 -0
  15. package/example/rpg_model/item_model.json +189 -0
  16. package/example/rpg_model/job_model.json +96 -0
  17. package/example/rpg_model/level_exp_model.json +111 -0
  18. package/example/rpg_model/map_model.json +166 -0
  19. package/example/rpg_model/map_state_model.json +63 -0
  20. package/example/rpg_model/monster_model.json +115 -0
  21. package/example/rpg_model/npc_model.json +103 -0
  22. package/example/rpg_model/quest_model.json +106 -0
  23. package/example/rpg_model/quest_progress_model.json +61 -0
  24. package/example/rpg_model/save_model.json +42 -0
  25. package/example/rpg_model/skill_model.json +124 -0
  26. package/example/rpg_persistence.js +151 -0
  27. package/example/rpg_relations.js +196 -0
  28. package/example/rpg_world.js +149 -0
  29. package/example/storage_demo.js +194 -0
  30. package/index.js +122 -0
  31. package/lib/backend.js +597 -0
  32. package/lib/errors.js +35 -0
  33. package/lib/manager.js +717 -0
  34. package/lib/model.js +540 -0
  35. package/lib/pool.js +277 -0
  36. package/lib/relation.js +175 -0
  37. package/lib/store.js +430 -0
  38. package/package.json +64 -5
  39. package/test.js +748 -0
  40. package/tool/data/index.js +107 -0
  41. package/tool/data/tool.json +211 -0
  42. package/README.md +0 -3
@@ -0,0 +1,179 @@
1
+ 'use strict';
2
+ /**
3
+ * 第 3 章:缓存(游戏里的高频读怎么压到最低)
4
+ *
5
+ * 运行:node example/rpg_cache.js
6
+ *
7
+ * 本章覆盖 6 层缓存策略,全部只用 mm_data 的公共 API + 示例层的一小段缓存代码:
8
+ * ① 静态配置常驻内存:kind:'static' → readonly,配置表天然是缓存层
9
+ * ② 预取 + 本地索引:一次 all() 建 Map,后续按 id 取 0 次后端调用
10
+ * ③ 查询结果缓存:TTL + 写失效(示例层 QueryCache,不改 mm_data 核心)
11
+ * ④ 版本化缓存键:cfg_ver / item.version 换版 → key 自动变化,天然失效
12
+ * ⑤ 写时快照冗余:item_name / skill_name 已由 mm_data 自动写入,读时无需 join
13
+ * ⑥ 池隔离:配置池与玩家池互不污染,dataAdmin.use() 切换
14
+ * 最后给出缓存一致性检查:reverse() 判断能否删配置、verify() 全库体检。
15
+ */
16
+ const mm = require('../index.js');
17
+ const W = require('./rpg_world.js');
18
+
19
+ /** 示例层的结果缓存:TTL + 前缀失效 + 命中统计(不属于 mm_data 核心) */
20
+ class QueryCache {
21
+ constructor(ttl) {
22
+ this.ttl = ttl || 60000;
23
+ this.map = new Map();
24
+ this.hits = 0;
25
+ this.misses = 0;
26
+ }
27
+ key(prefix, id) { return prefix + ':' + id; }
28
+ clone(v) { return JSON.parse(JSON.stringify(v)); }
29
+ get(key, loader) {
30
+ const e = this.map.get(key);
31
+ if (e && e.expireAt > Date.now()) { this.hits++; return this.clone(e.value); }
32
+ this.misses++;
33
+ const value = loader();
34
+ this.map.set(key, { value: this.clone(value), expireAt: Date.now() + this.ttl });
35
+ return this.clone(value);
36
+ }
37
+ /** 手动让某条过期(演示 TTL 语义,免去 sleep) */
38
+ expire(key) { const e = this.map.get(key); if (e) e.expireAt = 0; }
39
+ /** 写操作后按前缀批量失效,避免脏读 */
40
+ invalidate(prefix) {
41
+ let n = 0;
42
+ for (const k of this.map.keys()) if (k.indexOf(prefix) === 0) { this.map.delete(k); n++; }
43
+ return n;
44
+ }
45
+ stats() { return { hits: this.hits, misses: this.misses, keys: this.map.size }; }
46
+ }
47
+
48
+ async function run() {
49
+ W.title('第 3 章 / 缓存:静态配置、结果缓存、版本钉扎与一致性');
50
+ const w = W.open('rpg_cache');
51
+ const c = w.c;
52
+ const reg = w.reg;
53
+ const h = w.heroes;
54
+ const store = c.character.store;
55
+
56
+ // ---------- ① 静态配置常驻内存 ----------
57
+ W.title('3.1 第一层:静态配置表就是缓存层');
58
+ W.show('9 张静态表常驻内存、默认只读', reg.models().filter(function (m) { return m.kind === 'static'; })
59
+ .map(function (m) { return m.name + '(' + (reg.has(m.name) ? m.kind : '?') + ')'; }).join(' '));
60
+ W.show('item 是只读集合', c.item.readonly + ' / ' + c.item.kind + ' / v' + c.item.version);
61
+ try { c.item.add({ item_id: 9999, name: '运行时道具', type: 'weapon' }); }
62
+ catch (e) { W.show('运行时直接写静态表被拒', e.code + '(GM 工具可传 { force:true })'); }
63
+ W.show('动态表可正常写', c.character.size + ' 个角色 / ' + c.bag.size + ' 条背包');
64
+
65
+ // ---------- ② 预取 + 本地索引 ----------
66
+ W.title('3.2 第二层:整表预取 + 本地 Map 索引');
67
+ store.calls.list = 0;
68
+ const itemById = new Map(c.item.all().map(function (r) { return [r.item_id, r]; }));
69
+ const skillById = new Map(c.skill.all().map(function (r) { return [r.skill_id, r]; }));
70
+ const mapById = new Map(c.map.all().map(function (r) { return [r.map_id, r]; }));
71
+ const prefetchCalls = store.calls.list;
72
+ const lookups = [];
73
+ for (let i = 0; i < 1000; i++) {
74
+ const it = itemById.get(1001);
75
+ const sk = skillById.get(101);
76
+ const mp = mapById.get(1001);
77
+ if (i === 0) lookups.push(it.name + ' / ' + sk.name + ' / ' + mp.name);
78
+ }
79
+ W.show('预取 3 张配置表的后端调用', prefetchCalls + ' 次');
80
+ W.show('之后 1000 次按 id 取名字', lookups[0] + ' → 后端新增调用 ' + (store.calls.list - prefetchCalls) + ' 次');
81
+
82
+ // ---------- ③ 查询结果缓存 ----------
83
+ W.title('3.3 第三层:热查询结果缓存(TTL + 写失效)');
84
+ const cache = new QueryCache(60000);
85
+ const onlineKey = cache.key('online', 'list');
86
+ store.calls.list = 0;
87
+ const loader = function () { return c.character.list({ online: true }, { order: 'level desc', limit: -1 }).list; };
88
+ const a = cache.get(onlineKey, loader);
89
+ const b = cache.get(onlineKey, loader);
90
+ W.show('在线角色(首次 miss / 二次 hit)', a.length + ' 人 / ' + b.length + ' 人,后端只查了 ' + store.calls.list + ' 次');
91
+ const profileKey = cache.key('profile', h.arthur);
92
+ store.calls.list = 0;
93
+ const pa = cache.get(profileKey, function () {
94
+ return c.character.get(h.arthur, { with: ['job', 'map', 'items', 'skills'] });
95
+ });
96
+ const profileCalls = store.calls.list;
97
+ cache.get(profileKey, function () { throw new Error('不应再调用 loader'); });
98
+ W.show('角色档案缓存', pa.name + ' / ' + pa.job.name + ' / 背包 ' + pa.items.length +
99
+ ' 件;首次展开 4 个关联共 ' + profileCalls + ' 次后端查询,二次命中 ' + (store.calls.list - profileCalls) + ' 次');
100
+ W.show('缓存统计', cache.stats());
101
+
102
+ // 写入后失效,避免脏读
103
+ const fresh = c.character.add({
104
+ player_id: 3001, name: '新上线玩家', job_id: 4, map_id: 1001, online: true, level: 5
105
+ });
106
+ const callsBeforeWrite = store.calls.list;
107
+ cache.invalidate('online:');
108
+ const after = cache.get(onlineKey, loader);
109
+ W.show('新增在线角色后主动失效', '在线人数 ' + a.length + ' → ' + after.length +
110
+ '(新角色 #' + fresh.id + '),失效后重查 ' + (store.calls.list - callsBeforeWrite) + ' 次后端查询');
111
+ // TTL 过期
112
+ cache.expire(profileKey);
113
+ cache.get(profileKey, function () { return c.character.get(h.arthur); });
114
+ W.show('TTL 过期后自动重取', cache.stats());
115
+
116
+ // ---------- ④ 版本化缓存键 + ⑤ 快照 ----------
117
+ W.title('3.4 第四层:配置版本钉扎(cfg_ver)让缓存键天然失效');
118
+ const verBefore = c.item.version;
119
+ const before = c.bag.add({ character_id: fresh.id, item_id: 1001, quantity: 1 });
120
+ const old = c.bag.get(before.id);
121
+ W.show('v' + verBefore + ' 时写入的背包', old.item_name + ' / cfg_ver=' + old.cfg_ver);
122
+ const nextCfg = c.item.all().map(function (r) {
123
+ if (r.item_id === 1001) { r.name = '精铁剑·改'; r.atk = 22; }
124
+ return r;
125
+ });
126
+ c.item.reload(nextCfg, { version: 14 });
127
+ const after2 = c.bag.add({ character_id: fresh.id, item_id: 1001, quantity: 2 });
128
+ const now = c.bag.get(after2.id);
129
+ W.show('v' + c.item.version + ' 时写入的背包', now.item_name + ' / cfg_ver=' + now.cfg_ver);
130
+ W.show('历史记录不受换版影响', old.item_name + ' vs ' + now.item_name);
131
+
132
+ const vkey = function (id) { return 'item:v' + c.item.version + ':' + id; };
133
+ W.show('换版前的缓存键', 'item:v' + verBefore + ':1001');
134
+ W.show('换版后的缓存键', vkey(1001) + '(key 变了,旧缓存自动不再命中)');
135
+
136
+ W.title('3.5 第五层:写时快照冗余,读时不必 join');
137
+ store.calls.list = 0;
138
+ const withJoin = c.bag.first({ item_id: 1001 }, { with: ['item'] });
139
+ const afterJoin = store.calls.list;
140
+ const noJoin = c.bag.first({ item_id: 1001 });
141
+ W.show('with 实时展开', '需要 ' + afterJoin + ' 次后端查询 → ' + withJoin.item.name);
142
+ W.show('只读快照字段', '只查 ' + (store.calls.list - afterJoin) + ' 次(省掉配置表那 1 次)→ ' + noJoin.item_name +
143
+ ';结算 / 背包列表等高频路径推荐用快照');
144
+ W.show('技能名同样冗余', c.character_skill.first({ skill_id: 101 }).skill_name);
145
+
146
+ // ---------- ⑥ 池隔离 ----------
147
+ W.title('3.6 第六层:配置池 / 玩家池隔离,缓存互不污染');
148
+ const cfgPool = W.createWorld('rpg_cache_cfg');
149
+ const playerPool = W.createWorld('rpg_cache_player');
150
+ W.show('两个池的 item 行数', cfgPool.data('item').size + ' / ' + playerPool.data('item').size);
151
+ playerPool.data('item').add({ item_id: 7777, name: '仅玩家池可见', type: 'material' }, { force: true });
152
+ W.show('只往玩家池加一件道具', cfgPool.data('item').size + ' / ' + playerPool.data('item').size);
153
+ const prevPool = mm.dataAdmin.pool();
154
+ mm.dataAdmin.use(playerPool);
155
+ W.show('dataAdmin.use(玩家池) 后', mm.dataAdmin('item').get(7777).name);
156
+ mm.dataAdmin.use(prevPool);
157
+ W.show('恢复默认池后', mm.dataAdmin('item').get(7777) === null ? '看不到玩家池数据(隔离生效)' : '隔离失效');
158
+
159
+ // ---------- 一致性 ----------
160
+ W.title('3.7 缓存一致性:删配置前反查,换版后体检');
161
+ W.show('能否删道具 3001', '有 ' + c.item.reverse(3001).count + ' 条引用 → 不建议删;' +
162
+ '若要删,先清理引用或整表 reload');
163
+ W.show('换版不破坏引用', reg.verify());
164
+ W.show('缓存命中汇总', cache.stats());
165
+ W.show('全库行数', reg.stats().total);
166
+
167
+ W.title('第 3 章完成');
168
+ return { cache: cache.stats(), verify: reg.verify().ok };
169
+ }
170
+
171
+ if (require.main === module) {
172
+ run().catch(function (e) {
173
+ console.error('演示失败: ' + (e.code || 'ERROR') + ' - ' + e.message);
174
+ console.error(e.stack);
175
+ process.exitCode = 1;
176
+ });
177
+ }
178
+
179
+ module.exports = { run: run };
@@ -0,0 +1,170 @@
1
+ 'use strict';
2
+ /**
3
+ * 第 1 章:RPG 数据的增删改查 + 一个游戏里常见的各种「拿数据」姿势
4
+ *
5
+ * 运行:node example/rpg_crud.js
6
+ * 依赖:rpg_world.js(建池 + 造初始数据)、rpg_model/*.json(调用方提供的模型定义)
7
+ *
8
+ * 本章覆盖:
9
+ * - 角色 / 职业 / 技能 / 地图 / 道具 五类集合的读
10
+ * - 13 种取数方式:主键、条件、first、比较/$in/$like/$or、投影、排序、分页、游标、遍历、反查、工具面
11
+ * - 写:add / addMany / upsert / set / patch / generate,以及 schema / ref / readonly 三层拦截
12
+ * - 删:删除前的引用反查、静态配置的误删与恢复
13
+ * - 静态配置表的正确改版姿势:reload 整表换版,而不是逐条 add/set
14
+ */
15
+ const mm = require('../index.js');
16
+ const tool = require('../tool/data/index.js');
17
+ const W = require('./rpg_world.js');
18
+
19
+ function names(rows, field) {
20
+ return rows.map(function (r) { return r[field || 'name']; }).join('、');
21
+ }
22
+
23
+ async function run() {
24
+ W.title('第 1 章 / RPG 增删改查与多种取数姿势');
25
+ const w = W.open('rpg_crud');
26
+ const pool = w.pool;
27
+ const reg = w.reg;
28
+ const c = w.c;
29
+ const h = w.heroes;
30
+
31
+ W.show('集合清单(15 个,静态/动态/中间表)', reg.models().map(function (m) {
32
+ return m.name + '(' + m.kind + ')';
33
+ }).join(' '));
34
+ W.show('写入前引用完整性', reg.verify());
35
+
36
+ // ---------- 1. 配置表怎么拿 ----------
37
+ W.title('1.1 静态配置:职业 / 技能 / 地图 / 道具');
38
+ W.show('职业', names(c.job.all()));
39
+ W.show('法师可用技能', names(c.skill.where({ job_id: 2 })));
40
+ W.show('地图', names(c.map.all()));
41
+ W.show('地图 1001 的传送点', names(c.map.get(1001).portals, 'label'));
42
+ W.show('道具共 ' + c.item.count({}) + ' 件,武器', names(c.item.where({ type: 'weapon' })));
43
+ W.show('主城 NPC / 低级可接任务', names(c.npc.where({ map_id: 1001 })) + ' / ' +
44
+ names(c.quest.where({ level_req: { $lte: 5 } })));
45
+ W.show('Lv.10 升级所需经验', c.level_exp.get(10).exp_need);
46
+ W.show('红龙掉落', c.drop.where({ monster_id: 99 }).map(function (d) {
47
+ return c.item.get(d.item_id).name + '(' + (d.rate * 100) + '%)';
48
+ }).join('、'));
49
+
50
+ // ---------- 2. 十几种取数姿势 ----------
51
+ W.title('1.2 一个游戏里的 13 种取数方式');
52
+ W.show('① 主键直查 get(id)', c.character.get(h.arthur).name);
53
+ W.show('② 条件取单条 get({...})', c.character.get({ name: '梅林' }).job_id);
54
+ W.show('③ first 取第一条', c.character.first({ online: true }).name);
55
+ W.show('④ 多条件 list', names(c.character.list({ job_id: 1, online: true }).list));
56
+ W.show('⑤ 范围 $gte/$lt', names(c.character.list({ level: { $gte: 20, $lt: 30 }, gold: { $gte: 1000 } }).list));
57
+ W.show('⑥ 枚举 $in', names(c.item.list({ type: { $in: ['weapon', 'armor'] } }).list));
58
+ W.show('⑦ 模糊 $like + $or', names(c.character.list({
59
+ $or: [{ name: { $like: '冒险' } }, { job_id: 2 }]
60
+ }, { limit: 6 }).list));
61
+ W.show('⑧ 字段投影 fields', c.character.list({}, { fields: ['name', 'level'], limit: 3 }).list);
62
+ W.show('⑨ 排序 order', names(c.character.list({}, { order: 'level desc', limit: 5 }).list));
63
+ const p1 = c.character.list({}, { limit: 5, order: 'id' });
64
+ const p2 = c.character.list({}, { limit: 5, offset: 5, order: 'id' });
65
+ W.show('⑩ 分页 offset/limit', '总数=' + p1.count + ',第1页=' + names(p1.list) + ',第2页=' + names(p2.list));
66
+ const p3 = c.character.list({}, { limit: 5, order: 'id', cursor: p1.next_cursor });
67
+ W.show('⑪ 游标翻页 cursor', 'next_cursor=' + p1.next_cursor + ',下一页=' + names(p3.list));
68
+ W.show('⑫ 遍历 API', 'count=' + c.character.count({}) + ',where=' + c.character.where({ online: true }).length +
69
+ ',map=' + c.character.map(function (r) { return r.level; }).slice(0, 5).join(',') +
70
+ ',for-of 前 3 个=' + (function () { const out = []; for (const r of c.character) { out.push(r.name); if (out.length === 3) break; } return out.join('、'); })());
71
+ W.show('⑬ 反查 reverse(谁引用了小红药水 3001)', c.item.reverse(3001).count + ' 条记录');
72
+
73
+ // ---------- 3. 写 ----------
74
+ W.title('1.3 写数据:角色 / 背包 / 任务进度');
75
+ const newbie = c.character.add({
76
+ player_id: 2001, name: '新手剑士', job_id: 1, map_id: 1001, level: 1, hp: 180, mp: 20
77
+ });
78
+ W.show('add 新角色', '#' + newbie.id + ' ' + newbie.obj.name + ' / 默认值 hp=' + newbie.obj.hp);
79
+ const batch = c.bag.addMany([
80
+ { character_id: newbie.id, item_id: 1001, quantity: 1 },
81
+ { character_id: newbie.id, item_id: 3001, quantity: 5 }
82
+ ]);
83
+ W.show('addMany 背包', batch.affected + ' 条,ids=' + batch.ids.join(','));
84
+ const up1 = c.quest_progress.upsert(
85
+ { character_id: newbie.id, quest_id: 1 },
86
+ { status: 'active', progress: 0, custom_data: { kills: 0 } }
87
+ );
88
+ const up2 = c.quest_progress.upsert(
89
+ { character_id: newbie.id, quest_id: 1 },
90
+ { status: 'done', progress: 10 }
91
+ );
92
+ W.show('upsert 两次(先插后改)', up1.msg + ' → ' + up2.msg + ',任务数=' +
93
+ c.quest_progress.count({ character_id: newbie.id }));
94
+ c.character.set(newbie.id, { map_id: 1002, x: 1580, y: 600, online: true });
95
+ c.character.patch(newbie.id, { $inc: { gold: 250, exp: 120 }, $set: { level: 2 } });
96
+ W.show('set + patch 结算后', c.character.get(newbie.id));
97
+ c.character.generate(3, {
98
+ player_id: '{{ $index }}', name: '模板冒险者{{ $index }}',
99
+ job_id: '{{ ref:job.job_id }}', map_id: '{{ ref:map.map_id }}',
100
+ level: '{{ random(1, 10) }}', created_at: '造数-{{ $index }}'
101
+ });
102
+ W.show('generate 模板造数后角色总数', c.character.size);
103
+
104
+ W.title('1.4 三层写入拦截(全部抛错,不落盘)');
105
+ const rejects = [
106
+ ['schema 范围', function () { c.character.add({ player_id: 1, name: '越界', job_id: 1, map_id: 1001, level: 0 }); }],
107
+ ['schema 类型', function () { c.character.add({ player_id: 1, name: '类型错', job_id: 1, map_id: 1001, level: '高' }); }],
108
+ ['必填缺失', function () { c.character.add({ name: '缺字段' }); }],
109
+ ['悬空引用 ref', function () { c.bag.add({ character_id: 999999, item_id: 1001 }); }],
110
+ ['静态只读', function () { c.item.add({ item_id: 9001, name: '临时道具', type: 'weapon' }); }]
111
+ ];
112
+ rejects.forEach(function (item) {
113
+ try { item[1](); W.show(item[0], '未拦截(异常!)'); }
114
+ catch (e) { W.show(item[0], e.code + ' / ' + e.message.split('; ')[0].slice(0, 60)); }
115
+ });
116
+ W.show('校验器', mm.validator().package + ' v' + mm.validator().version +
117
+ ',累计调用 ' + mm.validator().calls + ' 次');
118
+ W.show('被拒写入未消耗主键(下一个 id 应为 20)', c.character.add({
119
+ player_id: 2002, name: '序列检查', job_id: 3, map_id: 1001
120
+ }).id);
121
+
122
+ // ---------- 4. 删 ----------
123
+ W.title('1.5 删除与引用完整性');
124
+ const refs = c.item.reverse(1001);
125
+ W.show('删道具 1001 之前先反查', refs.count + ' 条引用,来自 ' +
126
+ Array.from(new Set(refs.list.map(function (r) { return r.collection; }))).join(','));
127
+ const snapshot = c.item.all().map(function (r) { return Object.assign({}, r); });
128
+ c.item.del(1001, { force: true }); // 静态表 force 属于 GM 临时操作,正常应走 reload
129
+ W.show('强删后 verify()', reg.verify());
130
+ c.item.reload(snapshot, { version: 12 });
131
+ W.show('整表恢复后 verify()', reg.verify());
132
+ const removed = c.bag.del({ character_id: newbie.id, item_id: 3001 });
133
+ W.show('del 动态背包记录', removed.affected + ' 条(带条件,不允许全表删)');
134
+ try { c.bag.del({}); } catch (e) { W.show('无条件下删被拒', e.code); }
135
+
136
+ // ---------- 5. 静态配置换版 ----------
137
+ W.title('1.6 静态配置的正确改法:reload 整表换版');
138
+ const nextCfg = c.item.all().map(function (r) {
139
+ if (r.item_id === 1001) { r.name = '精铁剑'; r.atk = 18; r.price = 200; }
140
+ return r;
141
+ });
142
+ c.item.reload(nextCfg, { version: 13 });
143
+ W.show('换版结果', 'v' + c.item.version + ' / ' + c.item.get(1001).name + ' / atk=' + c.item.get(1001).atk);
144
+ W.show('历史背包快照仍是旧名', c.bag.first({ item_id: 1001 }).item_name);
145
+ W.show('换版后 verify()', reg.verify().ok);
146
+
147
+ // ---------- 6. 工具面 ----------
148
+ W.title('1.7 AI / 工作流工具面同一种取数');
149
+ const out = await tool.main({
150
+ action: 'list', model: 'character', query: { online: true },
151
+ options: { fields: ['name', 'level'], order: 'level desc', limit: 3 }, admin: pool
152
+ }, {});
153
+ W.show('tool.data / list', out.list);
154
+ W.show('LLM 工具参数契约', Object.keys(mm.getFunctionTool('data').function.parameters.properties).join(',') +
155
+ ' / required=' + mm.getFunctionTool('data').function.parameters.required.join(','));
156
+
157
+ W.title('第 1 章完成');
158
+ W.show('最终统计', reg.stats());
159
+ return { characters: c.character.size, verify: reg.verify().ok };
160
+ }
161
+
162
+ if (require.main === module) {
163
+ run().catch(function (e) {
164
+ console.error('演示失败: ' + (e.code || 'ERROR') + ' - ' + e.message);
165
+ console.error(e.stack);
166
+ process.exitCode = 1;
167
+ });
168
+ }
169
+
170
+ module.exports = { run: run };
@@ -0,0 +1,61 @@
1
+ 'use strict';
2
+ /**
3
+ * mm_data RPG 完整示例总入口
4
+ *
5
+ * node example/rpg_demo.js
6
+ *
7
+ * 依次演示 4 个章节,每章用独立的 mm_admin 命名空间,互不污染:
8
+ * 第 1 章 rpg_crud.js 增删改查 + 13 种取数姿势 + 三层写入拦截
9
+ * 第 2 章 rpg_relations.js 多对一 / 一对多 / 多对多 / 运行时声明关联 / 无 N+1 / 反查
10
+ * 第 3 章 rpg_cache.js 静态配置缓存 / 预取索引 / 结果缓存 / cfg_ver 换版 / 快照 / 池隔离
11
+ * 第 4 章 rpg_persistence.js json store / autoSave / 重启恢复 / dump 存档 / 配置与玩家数据分工
12
+ *
13
+ * 共用底座:
14
+ * rpg_world.js 建池 + 造初始数据
15
+ * rpg_model/*.json 15 份「调用方提供的模型定义」(标准 JSON Schema,禁用 int/integer)
16
+ *
17
+ * 单独跑某一章:
18
+ * node example/rpg_crud.js
19
+ * node example/rpg_relations.js
20
+ * node example/rpg_cache.js
21
+ * node example/rpg_persistence.js
22
+ */
23
+ const W = require('./rpg_world.js');
24
+ const chapters = [
25
+ { name: 'CRUD / 取数', mod: require('./rpg_crud.js') },
26
+ { name: '关联', mod: require('./rpg_relations.js') },
27
+ { name: '缓存', mod: require('./rpg_cache.js') },
28
+ { name: '持久化', mod: require('./rpg_persistence.js') }
29
+ ];
30
+
31
+ async function run() {
32
+ console.log('mm_data / RPG 数据管理完整示例');
33
+ console.log('模型目录: ' + W.MODEL_DIR);
34
+ console.log('章节: ' + chapters.map(function (c) { return c.name; }).join(' → '));
35
+
36
+ const results = [];
37
+ for (let i = 0; i < chapters.length; i++) {
38
+ const ch = chapters[i];
39
+ const res = await ch.mod.run();
40
+ results.push({ chapter: ch.name, result: res });
41
+ }
42
+
43
+ W.title('全部章节完成 / 汇总');
44
+ results.forEach(function (r, i) {
45
+ W.show('第 ' + (i + 1) + ' 章 ' + r.chapter, r.result);
46
+ });
47
+ W.show('模型定义', '15 个 JSON,均为标准 JSON Schema(draft-07 子集),整数一律 number');
48
+ W.show('校验器', require('../index.js').validator().package + ' v' + require('../index.js').validator().version);
49
+ W.show('单独运行', 'node example/rpg_crud.js | rpg_relations.js | rpg_cache.js | rpg_persistence.js');
50
+ return results;
51
+ }
52
+
53
+ if (require.main === module) {
54
+ run().catch(function (e) {
55
+ console.error('演示失败: ' + (e.code || 'ERROR') + ' - ' + e.message);
56
+ console.error(e.stack);
57
+ process.exitCode = 1;
58
+ });
59
+ }
60
+
61
+ module.exports = { run: run };
@@ -0,0 +1,74 @@
1
+ {
2
+ "name": "bag",
3
+ "kind": "dynamic",
4
+ "description": "角色背包(动态数据,item_id 关联静态道具模板)",
5
+ "key": "id",
6
+ "store": {
7
+ "db": "mysql",
8
+ "table": "game_bag",
9
+ "shard": {
10
+ "by": "character_id",
11
+ "rule": "mod",
12
+ "count": 16
13
+ },
14
+ "indexes": [
15
+ [
16
+ "character_id",
17
+ "item_id"
18
+ ],
19
+ [
20
+ "character_id",
21
+ "equipped"
22
+ ]
23
+ ]
24
+ },
25
+ "schema": {
26
+ "$schema": "http://json-schema.org/draft-07/schema#",
27
+ "type": "object",
28
+ "properties": {
29
+ "id": {
30
+ "type": "number",
31
+ "primary": true,
32
+ "auto": true
33
+ },
34
+ "character_id": {
35
+ "type": "number",
36
+ "ref": "character"
37
+ },
38
+ "item_id": {
39
+ "type": "number",
40
+ "ref": {
41
+ "model": "item",
42
+ "as": "item",
43
+ "mode": "live",
44
+ "onMissing": "error"
45
+ }
46
+ },
47
+ "item_name": {
48
+ "type": "string",
49
+ "snapshot": "item.name",
50
+ "default": "",
51
+ "description": "配置快照,改版不影响历史"
52
+ },
53
+ "cfg_ver": {
54
+ "type": "number",
55
+ "default": 0,
56
+ "description": "静态表版本钉扎"
57
+ },
58
+ "quantity": {
59
+ "type": "number",
60
+ "default": 1,
61
+ "minimum": 1
62
+ },
63
+ "equipped": {
64
+ "type": "boolean",
65
+ "default": false
66
+ }
67
+ },
68
+ "required": [
69
+ "character_id",
70
+ "item_id"
71
+ ],
72
+ "additionalProperties": false
73
+ }
74
+ }
@@ -0,0 +1,165 @@
1
+ {
2
+ "name": "character",
3
+ "kind": "dynamic",
4
+ "description": "玩家角色(动态数据)",
5
+ "key": "id",
6
+ "store": {
7
+ "db": "mysql",
8
+ "table": "game_character",
9
+ "shard": {
10
+ "by": "player_id",
11
+ "rule": "mod",
12
+ "count": 16
13
+ },
14
+ "indexes": [
15
+ [
16
+ "player_id"
17
+ ],
18
+ [
19
+ "player_id",
20
+ "map_id"
21
+ ]
22
+ ]
23
+ },
24
+ "schema": {
25
+ "$schema": "http://json-schema.org/draft-07/schema#",
26
+ "type": "object",
27
+ "properties": {
28
+ "id": {
29
+ "type": "number",
30
+ "primary": true,
31
+ "auto": true
32
+ },
33
+ "player_id": {
34
+ "type": "number",
35
+ "index": true
36
+ },
37
+ "name": {
38
+ "type": "string"
39
+ },
40
+ "job_id": {
41
+ "type": "number",
42
+ "ref": {
43
+ "model": "job",
44
+ "as": "job",
45
+ "mode": "live"
46
+ }
47
+ },
48
+ "level": {
49
+ "type": "number",
50
+ "default": 1,
51
+ "minimum": 1
52
+ },
53
+ "exp": {
54
+ "type": "number",
55
+ "default": 0
56
+ },
57
+ "hp": {
58
+ "type": "number",
59
+ "default": 100
60
+ },
61
+ "mp": {
62
+ "type": "number",
63
+ "default": 30
64
+ },
65
+ "attack": {
66
+ "type": "number",
67
+ "default": 10
68
+ },
69
+ "defense": {
70
+ "type": "number",
71
+ "default": 5
72
+ },
73
+ "gold": {
74
+ "type": "number",
75
+ "default": 0
76
+ },
77
+ "map_id": {
78
+ "type": "number",
79
+ "ref": {
80
+ "model": "map",
81
+ "as": "map",
82
+ "mode": "live"
83
+ }
84
+ },
85
+ "x": {
86
+ "type": "number",
87
+ "default": 0
88
+ },
89
+ "y": {
90
+ "type": "number",
91
+ "default": 0
92
+ },
93
+ "portal_index": {
94
+ "type": "number",
95
+ "default": 0
96
+ },
97
+ "online": {
98
+ "type": "boolean",
99
+ "default": false
100
+ },
101
+ "created_at": {
102
+ "type": "string",
103
+ "default": ""
104
+ }
105
+ },
106
+ "required": [
107
+ "player_id",
108
+ "name",
109
+ "job_id",
110
+ "map_id"
111
+ ],
112
+ "additionalProperties": false
113
+ },
114
+ "relations": [
115
+ {
116
+ "name": "items",
117
+ "model": "bag",
118
+ "via": "character_id",
119
+ "type": "one-to-many",
120
+ "as": "items",
121
+ "select": [
122
+ "item_id",
123
+ "item_name",
124
+ "quantity",
125
+ "equipped"
126
+ ]
127
+ },
128
+ {
129
+ "name": "skills",
130
+ "model": "character_skill",
131
+ "via": "character_id",
132
+ "type": "one-to-many",
133
+ "as": "skills",
134
+ "select": [
135
+ "skill_id",
136
+ "skill_name",
137
+ "level"
138
+ ]
139
+ },
140
+ {
141
+ "name": "quests",
142
+ "model": "quest_progress",
143
+ "via": "character_id",
144
+ "type": "one-to-many",
145
+ "as": "quests",
146
+ "select": [
147
+ "quest_id",
148
+ "status",
149
+ "progress"
150
+ ]
151
+ }
152
+ ],
153
+ "generate": {
154
+ "count": 5,
155
+ "template": {
156
+ "player_id": "{{ $index }}",
157
+ "name": "冒险者{{ $index }}",
158
+ "job_id": "{{ ref:job.job_id }}",
159
+ "level": "{{ random(1, 10) }}",
160
+ "hp": "{{ random(100, 500) }}",
161
+ "gold": "{{ random(0, 999) }}",
162
+ "map_id": "{{ ref:map.map_id }}"
163
+ }
164
+ }
165
+ }