74 lines
2.6 KiB
JavaScript
74 lines
2.6 KiB
JavaScript
'use strict';
|
||
|
||
/**
|
||
* 从库表重建 methods/system.json(原子写入,docs 页面仍读该文件)。
|
||
*
|
||
* 用法:
|
||
* node script/method-doc-export.cjs [--env production] [--doc system] [--file methods/system.json]
|
||
*/
|
||
|
||
const fs = require('node:fs');
|
||
const {
|
||
resolveEnv, createConnection, parseArgs, parseJsonColumn, formatDate, fail,
|
||
} = require('./method-doc-common.cjs');
|
||
|
||
(async () => {
|
||
const args = parseArgs();
|
||
const env = resolveEnv();
|
||
const docName = args.get('doc') || 'system';
|
||
const file = args.get('file') || `methods/${docName}.json`;
|
||
|
||
const conn = await createConnection(env);
|
||
const [ metaRows ] = await conn.query(
|
||
'SELECT * FROM wms_method_doc_meta WHERE doc_name=? ORDER BY id ASC LIMIT 1',
|
||
[ docName ]
|
||
);
|
||
const [ rows ] = await conn.query(
|
||
'SELECT * FROM wms_api_method_doc WHERE status=1 ORDER BY group_sort ASC, item_sort ASC, id ASC'
|
||
);
|
||
await conn.end();
|
||
|
||
const meta = metaRows[0];
|
||
|
||
// 按 (group_sort, module, group_name) 重建分组
|
||
const groups = [];
|
||
const groupIndex = new Map();
|
||
for (const row of rows) {
|
||
const key = `${row.group_sort}\u0000${row.module}\u0000${row.group_name}`;
|
||
let group = groupIndex.get(key);
|
||
if (!group) {
|
||
group = { groupName: row.group_name || '', module: row.module || '', list: [] };
|
||
groupIndex.set(key, group);
|
||
groups.push(group);
|
||
}
|
||
// 优先用 payload 原文(含 status/notes/requestBody 等扩展字段,无损往返);
|
||
// 无 payload(老数据/脚本创建未带)时按结构化列组装
|
||
const parsedPayload = row.payload ? parseJsonColumn(row.payload) : null;
|
||
group.list.push(parsedPayload || {
|
||
method: row.method,
|
||
description: row.description || '',
|
||
isNeedAuth: !!row.is_need_auth,
|
||
isNeedLogin: !!row.is_need_login,
|
||
headers: parseJsonColumn(row.headers) || [],
|
||
params: parseJsonColumn(row.params) || [],
|
||
response: parseJsonColumn(row.response) || [],
|
||
errors: parseJsonColumn(row.errors) || [],
|
||
});
|
||
}
|
||
|
||
const doc = {
|
||
module: (meta && meta.module) || docName,
|
||
description: (meta && meta.description) || '',
|
||
version: (meta && meta.version) || '0.3.0',
|
||
updatedAt: meta ? formatDate(meta.updated_at) : new Date().toISOString().slice(0, 10),
|
||
headers: parseJsonColumn(meta && meta.headers) || [],
|
||
methods: { groups },
|
||
};
|
||
|
||
const tmp = `${file}.tmp`;
|
||
fs.writeFileSync(tmp, JSON.stringify(doc, null, 4) + '\n', 'utf8');
|
||
fs.renameSync(tmp, file);
|
||
|
||
console.log(`[method-doc] 导出完成:file=${file} version=${doc.version} updatedAt=${doc.updatedAt} groups=${groups.length} methods=${rows.length}(env=${env})`);
|
||
})().catch(e => fail(e.message));
|