const fs = require('fs');
const path = require('path');

const repoRoot = process.cwd();
const projectRoot = path.join(repoRoot, 'MES_Manage_View_V20');
const viewsRoot = path.join(projectRoot, 'src', 'views');
const manualPath = path.join(projectRoot, '元利项目详细用户使用说明书.md');

function readText(file) {
  const buf = fs.readFileSync(file);
  if (buf.length >= 3 && buf[0] === 0xef && buf[1] === 0xbb && buf[2] === 0xbf) {
    return buf.slice(3).toString('utf8');
  }
  if (buf.length >= 2 && buf[0] === 0xff && buf[1] === 0xfe) {
    return buf.slice(2).toString('utf16le');
  }
  return buf.toString('utf8');
}

function writeText(file, text) {
  fs.writeFileSync(file, text, 'utf8');
}

function walk(dir, out = []) {
  if (!fs.existsSync(dir)) return out;
  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
    const full = path.join(dir, entry.name);
    if (entry.isDirectory()) walk(full, out);
    else if (/\.(vue|js)$/i.test(entry.name)) out.push(full);
  }
  return out;
}

function rel(file) {
  return path.relative(projectRoot, file).replace(/\\/g, '/');
}

function clean(value) {
  return (value || '')
    .replace(/<!--[\s\S]*?-->/g, ' ')
    .replace(/<[^>]+>/g, ' ')
    .replace(/\{\{[\s\S]*?\}\}/g, ' ')
    .replace(/&nbsp;/g, ' ')
    .replace(/\s+/g, ' ')
    .trim();
}

function uniq(values) {
  const seen = new Set();
  const out = [];
  for (const value of values) {
    const v = String(value || '').trim();
    if (!v || seen.has(v)) continue;
    seen.add(v);
    out.push(v);
  }
  return out;
}

function stripNoise(values) {
  return uniq(values)
    .filter(x => x.length <= 42)
    .filter(x => !/[{};]/.test(x))
    .filter(x => !/^(scope|row|item|index|true|false|null|undefined)$/i.test(x))
    .filter(x => !/^\d+$/.test(x));
}

function extractAll(re, text, map) {
  const out = [];
  let match;
  while ((match = re.exec(text))) out.push(map(match));
  return out;
}

function attr(attrs, name) {
  const m = new RegExp(`${name}="([^"]*)"`).exec(attrs);
  return m ? clean(m[1]) : '';
}

function extractTemplate(text) {
  const start = text.search(/<template\b[^>]*>/i);
  if (start < 0) return text;
  const open = /<template\b[^>]*>/i.exec(text.slice(start));
  if (!open) return text;
  const contentStart = start + open.index + open[0].length;
  const scriptStart = text.search(/<script\b/i);
  const searchEnd = scriptStart >= 0 ? scriptStart : text.length;
  const close = text.lastIndexOf('</template>', searchEnd);
  if (close > contentStart) return text.slice(contentStart, close);
  return text.slice(contentStart, searchEnd);
}

function extractScript(text) {
  const m = /<script\b[^>]*>([\s\S]*?)<\/script>/i.exec(text);
  return m ? m[1] : text;
}

function extractPage(file) {
  const text = readText(file);
  const template = extractTemplate(text);
  const script = extractScript(text);
  const relative = rel(file);
  const parts = relative.split('/');
  const module = parts[2] || '根页面';
  const name = path.basename(file) === 'index.vue'
    ? parts[parts.length - 2]
    : path.basename(file);

  const labels = extractAll(/\blabel="([^"]+)"/g, template, m => clean(m[1]));
  const placeholders = extractAll(/\bplaceholder="([^"]+)"/g, template, m => clean(m[1]));
  const titles = extractAll(/\btitle="([^"]+)"/g, template, m => clean(m[1]));
  const formLabels = extractAll(/<el-form-item\b([^>]*)>/g, template, m => attr(m[1], 'label'));
  const tabLabels = extractAll(/<el-tab-pane\b([^>]*)>/g, template, m => attr(m[1], 'label'));
  const options = extractAll(/<el-option\b([^>]*)>/g, template, m => attr(m[1], 'label'));
  const buttons = extractAll(/<el-button\b([^>]*)>([\s\S]*?)<\/el-button>/g, template, m => {
    const textValue = clean(m[2]) || attr(m[1], 'title') || attr(m[1], 'aria-label');
    const click = attr(m[1], '@click') || attr(m[1], 'v-on:click');
    return textValue ? { text: textValue, click } : null;
  })
    .filter(Boolean)
    .filter(b => b.text.length <= 42)
    .filter(b => !/[{};]/.test(b.text));
  const tableColumns = extractAll(/<el-table-column\b([^>]*)>/g, template, m => {
    const label = attr(m[1], 'label');
    const prop = attr(m[1], 'prop');
    const type = attr(m[1], 'type');
    return label || prop || type ? { label, prop, type } : null;
  }).filter(Boolean);
  const vModels = extractAll(/\bv-model(?:\.[\w-]+)?="([^"]+)"/g, template, m => clean(m[1]));
  const params = extractAll(/\.(?:push|unshift)\s*\(\s*\[\s*['"]([^'"]+)['"]\s*,\s*([^\]\n]+)\]/g, script, m => ({
    name: clean(m[1]),
    expr: clean(m[2])
  }));
  const procs = extractAll(/CreateData\s*\(\s*['"]([^'"]+)['"]\s*,\s*['"]([^'"]+)['"]/g, script, m => ({
    type: m[1],
    name: clean(m[2])
  }));
  const sapCalls = extractAll(/\b(getB1|postB1|patchB1|posttm)\s*\(\s*([`'"])([\s\S]*?)\2/g, script, m => ({
    method: m[1],
    url: clean(m[3]).slice(0, 90)
  }));
  const dialogs = extractAll(/<el-dialog\b([\s\S]*?)>/g, template, m => {
    const title = attr(m[1], 'title') || clean((/:title="([^"]+)"/.exec(m[1]) || [])[1]);
    return title;
  });
  const methods = extractAll(/^\s*([A-Za-z_$\u4e00-\u9fa5][\w$\u4e00-\u9fa5]*)\s*\([^)]*\)\s*\{/gm, script, m => m[1]);
  const hasCalendar = /FullCalendar|@fullcalendar|eventDrop|eventResize/.test(text);
  const hasPagination = /el-pagination|pageSize|pageCurrent/.test(text);
  const hasUpload = /el-upload|上传|upload/i.test(text);
  const hasTree = /el-tree|treeData|Tree/.test(text);

  return {
    file,
    relative,
    module,
    name,
    text,
    labels: stripNoise(labels),
    placeholders: stripNoise(placeholders),
    titles: stripNoise(titles),
    formLabels: stripNoise(formLabels),
    tabLabels: stripNoise(tabLabels),
    options: stripNoise(options),
    buttons,
    tableColumns,
    vModels: stripNoise(vModels),
    params,
    procs,
    sapCalls,
    dialogs: stripNoise(dialogs),
    methods: stripNoise(methods),
    hasCalendar,
    hasPagination,
    hasUpload,
    hasTree
  };
}

function roleFor(page) {
  if (/SystemMaintenance|layout|login|dashboard|404/.test(page.relative)) return '系统管理员/相关用户';
  if (/QualityManagement/.test(page.relative)) return '质检员/质量主管';
  if (/PlanManagement/.test(page.relative)) return '计划员/生产主管';
  if (/ProductionManagement/.test(page.relative)) return '操作工/班组长/生产主管';
  if (/ProcessManagement|CraftManagement/.test(page.relative)) return '工艺员/技术人员';
  if (/DeviceManagement/.test(page.relative)) return '设备管理员/生产主管';
  if (/SaleManagement/.test(page.relative)) return '销售/计划/生产跟单人员';
  if (/AnomalousManagement/.test(page.relative)) return '班组长/生产主管/计划员';
  return '相关业务人员';
}

function moduleName(page) {
  const map = {
    AnomalousManagement: '异常管理',
    CraftManagement: '产品结构维护',
    DeviceManagement: '设备管理',
    PlanManagement: '计划排产',
    ProcessManagement: '工艺与图纸管理',
    ProductionManagement: '生产执行管理',
    QualityManagement: '质量管理',
    SaleManagement: '销售与交付查询',
    SystemMaintenance: '系统维护',
    dashboard: '首页与看板',
    layout: '布局与导航',
    login: '登录',
  };
  if (page.relative === 'src/views/404.vue') return '错误页';
  return map[page.module] || page.module;
}

function purpose(page) {
  const p = page.relative;
  const rules = [
    [/404\.vue$/, '该页面用于路由不存在或无效地址访问时展示 404 提示，帮助用户返回首页或重新选择菜单。'],
    [/login/, '该页面是系统登录入口，用户输入工号、密码并选择角色后进入 MES；同时提供修改密码功能。'],
    [/dashboard/, '该页面是系统首页/看板入口，用户登录后查看系统概览或进入各业务模块。'],
    [/PunctualWork/, '该页面用于查看未及时开工、待执行、可执行、已开工和已完成任务，帮助班组长或计划员催办生产开工。'],
    [/CraftMaintain/, '该页面用于维护产品结构树，支持新增、编辑、删除产品结构节点，为工艺、BOM 和生产任务提供层级基础资料。'],
    [/DeviceDataHistory/, '该页面用于查询设备历史采集数据，按工位、设备、参数和时间追溯设备运行记录。'],
    [/DeviceInformation/, '该页面用于维护设备台账、设备属性、维修/工时/点检相关信息。'],
    [/DeviceRealData|Devicedata/, '该页面用于查看设备实时数据或采集缓存数据，判断设备当前运行、报警和参数状态。'],
    [/SelfMakePlandone[\\/]/, '该页面用于机加/自制件已排产任务查看和调整，支持计划时间、指派对象、指派数量、最晚开始、二次派工和备注维护。'],
    [/SelfMakePlando[\\/]/, '该页面用于机加/自制件待排产任务处理，支持表单排产、日程拖拽调整、部分派工、批量排产、二次派工、原料状态和图纸查看。'],
    [/SelfMakePlan[\\/]/, '该页面用于机加/自制件排产前准备，查询生产订单工序任务并维护计划、工位、数量和说明后确认排产。'],
    [/InstallMakePlanDo|InstallMakePlan/, '该页面用于装配件排产，维护装配工位、人员、计划开始/完成、优先级、说明，并在排产完成时同步 SAP 或生成相关请求。'],
    [/PlanShell/, '该页面用于计划外壳和计划跟踪，集中查看订单计划、齐套、缺料、发货或关闭相关信息。'],
    [/PlannOrderClose/, '该页面用于关闭生产订单，用户查询待关闭订单后执行 MES/SAP 关闭动作。'],
    [/priorityinstall/, '该页面用于装配计划优先级和日程调整，支持表单和日程方式查看重点任务。'],
    [/ProductionOrder/, '该页面用于查询和同步生产订单，把 SAP/ERP 生产订单转成 MES 生产计划与工序任务。'],
    [/PartDrawing/, '该页面用于维护零件图纸，支持按物料查询、查看、上传/验证和删除图纸。'],
    [/PartDrawlook|ProcurementDrawlook/, '该页面用于按物料查看零件图纸，供生产、采购、外协或质检快速查阅技术文件。'],
    [/ProcessDrawing/, '该页面用于维护工艺图纸，支持查询、查看、上传/验证和删除工艺图纸。'],
    [/ProcedureManagement/, '该页面用于维护工序/路线阶段主数据，并与 SAP B1 RouteStages 保持一致。'],
    [/ProcessInquiry/, '该页面用于查询标准工艺或生产工艺，供排产、生产、质检核对工序路线。'],
    [/ProcessProduct|ProcessesDevelop/, '该页面用于维护产品工艺资料、工序路线、参数和图纸关系。'],
    [/MachiningCenter/, '该页面是机加生产执行主界面，操作工按工位执行收料、开工、暂停、报工、检验、退库、发料和图纸查看。'],
    [/AssemblyCenter/, '该页面是装配生产执行主界面，装配人员按工位执行开工、报工、送检、退库、缺料查询和图纸查看。'],
    [/ProductionTaskManage|AssembleTaskManage/, '该页面用于生产/装配任务管理，查询任务、查看工时、维护派工和任务说明。'],
    [/ProductionTasksSum|AssembleTasksSum/, '该页面用于生产/装配任务汇总，按订单、人员、工位、状态和时间统计任务执行情况。'],
    [/ProductionPlanTrack|AssemblePlanTrack/, '该页面用于跟踪生产/装配计划执行进度，查看计划、完成、延期和异常情况。'],
    [/AssembleStatus|DeviceStatus/, '该页面用于查看现场状态，关注工位、设备、任务是否开工、进行中或完成。'],
    [/OutsourceMange|SaleOutsourceMange/, '该页面用于外协任务管理，处理外协派工、供应商、发料、收料、质检记录和 SAP 采购请求。'],
    [/OutsourceSheet/, '该页面用于外协报表查询和导出，跟踪外协订单、供应商、数量、质检和结算状态。'],
    [/PickingTask/, '该页面用于生产领料/拣配任务查询与处理，核对订单物料和库存任务。'],
    [/PersonnelBinding/, '该页面用于维护人员与工位绑定关系，控制或提示人员可操作的工位。'],
    [/ShiftManagement/, '该页面用于维护班次、班次人员和排班基础数据。'],
    [/Timesheet|Workhours$/, '该页面用于查询工时记录，按人员、设备、任务、订单和日期统计工时。'],
    [/WorkhoursEdit/, '该页面用于修正或补录工时/报工记录，处理异常工时。'],
    [/WorkHoursCheck/, '该页面用于工时校验和 SAP 提交，用户核对报工记录后批量或单条校验并上传相关单据。'],
    [/Urgent/, '该页面用于维护加急任务，跟踪加急订单、加急数量和完成情况。'],
    [/AbnormalControl/, '该页面用于生产异常管理，查询异常、处理异常、转办、查看进度和关闭异常。'],
    [/QualityCenter/, '该页面是质量综合处理中心，集中处理待检、收检、检测明细、不合格和 SAP/WMS 联动。'],
    [/QualityDetails/, '该页面用于查询质检明细，按订单、物料、检验类型和时间追溯检测记录。'],
    [/QualityStandardQuery/, '该页面用于查询或维护质量检验标准、检测项目、上下限和启用状态。'],
    [/Unqualified/, '该页面用于不合格品处理，记录处置方式、责任、原因和处理结果。'],
    [/CheckTask[\\/].*purchaseIncoming/, '该页面用于采购/来料检验，质检人员录入来料检验数量、合格数、不合格数和检测明细。'],
    [/CheckTask[\\/].*processReceive/, '该页面用于工序收检/序检收检，质检人员接收工序检验任务并录入检验结果。'],
    [/CheckTask[\\/].*firstSpecial/, '该页面用于首检或特殊首件检验，录入首件检测结果。'],
    [/CheckTask[\\/].*final/, '该页面用于终检任务处理，录入最终检验结果。'],
    [/CheckTask[\\/].*materialReturn/, '该页面用于材料退库检验，核对退库物料并录入检验结论。'],
    [/CheckTask[\\/].*salesReturn/, '该页面用于销售退货检验，录入退货质检结果。'],
    [/CheckTask[\\/].*OtherInbound/, '该页面用于其他入库检验，录入其他入库质检结果。'],
    [/CheckTask[\\/].*processSpecial/, '该页面用于过程特殊检验，录入特殊检验项目和结果。'],
    [/saleorderstatus/, '该页面用于查询销售订单状态，跟踪销售订单在生产、交付和关闭过程中的状态。'],
    [/MenuManagement/, '该页面用于维护系统菜单、按钮权限和路由配置。'],
    [/OperationLog/, '该页面用于查询操作日志，追溯用户操作、报工或业务变更记录。'],
    [/OrgManagement/, '该页面用于维护组织、部门或组织树基础资料。'],
    [/PersonnelManagement/, '该页面用于维护人员账号、部门、角色和启用状态。'],
    [/SystemRrolemaintenance/, '该页面用于维护系统角色和角色权限。'],
    [/WorkstationManagement/, '该页面用于维护工位/资源主数据，并同步 SAP B1 Resources。'],
    [/layout|Sidebar|Navbar|TagsView|AppMain|ResizeHandler/, '该文件属于系统布局和导航组件，用户通过它切换菜单、标签页、折叠菜单或退出登录，不维护具体业务单据。'],
  ];
  const found = rules.find(([re]) => re.test(p));
  if (found) return found[1];
  return '该页面为业务页面，用户按查询条件筛选数据，在列表或弹窗中查看明细，并按页面按钮完成维护、提交或状态更新。';
}

function actionVerb(button) {
  const text = button.text;
  if (/查询|搜索|全部|待执行|可执行|已开工|已完成|未完成/.test(text)) return '查询/筛选';
  if (/新增|添加|新建|创建/.test(text)) return '新增';
  if (/编辑|修改|保存|确定|确 定/.test(text)) return '编辑/保存';
  if (/删除|移除/.test(text)) return '删除';
  if (/导出|打印/.test(text)) return '导出/打印';
  if (/查看|详情|图纸|明细|进度/.test(text)) return '查看';
  if (/排产|派工|开工|报工|送检|收料|发料|退库|关闭|提交|处理|转办|完结|校验|上传/.test(text)) return '业务提交';
  if (/取消|关闭|返回/.test(text)) return '取消/关闭';
  return '操作';
}

function fieldName(value) {
  return value
    .replace(/^.*\./, '')
    .replace(/\[[^\]]+\]/g, '')
    .replace(/Form$/, '')
    .replace(/Time$/, '时间')
    .replace(/No$/, '编号');
}

function queryItems(page) {
  const fromParams = page.params
    .filter(p => !/任务列表|操作人|最后编辑人|editstr|personnel|TaskAID/.test(p.name))
    .map(p => p.name);
  const fromModels = page.vModels
    .filter(v => !/^scope\.row|^item\.|^row\.|multipleSelection|loading|dialog|Visible|activeTab/.test(v))
    .map(fieldName);
  const fromPlaceholders = page.placeholders
    .map(x => x.replace(/^请输入/, '').replace(/^请选择/, '').replace(/起始|结束/g, '').trim())
    .filter(Boolean);
  return stripNoise([...fromParams, ...fromModels, ...fromPlaceholders]).slice(0, 22);
}

function tableItems(page) {
  return stripNoise(page.tableColumns.map(c => c.label || c.prop || c.type)).slice(0, 34);
}

function buttonItems(page) {
  return stripNoise(page.buttons.map(b => b.text)).slice(0, 30);
}

function procItems(page) {
  return uniq(page.procs.map(p => p.name)).slice(0, 20);
}

function sapItems(page) {
  return uniq(page.sapCalls.map(s => `${s.method} ${s.url}`)).slice(0, 12);
}

function lineList(values, fallback) {
  if (!values.length) return `- ${fallback}`;
  return values.map(v => `- \`${v}\``).join('\n');
}

function detailedSteps(page) {
  const steps = [];
  const queries = queryItems(page);
  const tabs = page.tabLabels;
  const columns = tableItems(page);
  const buttons = page.buttons.slice(0, 24);
  const dialogs = page.dialogs;
  const forms = page.formLabels;
  const procs = procItems(page);
  const pathText = page.relative;

  steps.push(`从左侧菜单进入该页，确认页面标题、当前账号和业务角色正确。`);
  if (tabs.length) {
    steps.push(`先查看页签：${tabs.map(x => `\`${x}\``).join('、')}；需要表格处理时进入表单/列表页签，需要看时间排布时进入日程/看板页签。`);
  }
  if (queries.length) {
    steps.push(`在查询区按需要填写筛选条件：${queries.slice(0, 12).map(x => `\`${x}\``).join('、')}。`);
    if (queries.length > 12) steps.push(`如果仍查不到数据，继续补充条件：${queries.slice(12, 22).map(x => `\`${x}\``).join('、')}，或清空过窄条件后重新查询。`);
  } else {
    steps.push(`该页没有识别到固定查询区，按页面提示直接查看信息或使用菜单/按钮进入下一步。`);
  }
  const queryButtons = buttons.filter(b => actionVerb(b) === '查询/筛选');
  if (queryButtons.length) {
    steps.push(`点击 ${stripNoise(queryButtons.map(b => b.text)).slice(0, 8).map(x => `\`${x}\``).join('、')} 刷新列表；状态按钮会切换任务范围。`);
  } else if (buttons.length) {
    steps.push(`点击页面上的查询或刷新类按钮获取最新数据；如果页面自动加载，则先核对默认列表是否符合当前业务范围。`);
  }
  if (page.hasPagination) {
    steps.push(`列表较多时使用分页区切换页码或调整每页条数，避免只检查第一页。`);
  }
  if (columns.length) {
    steps.push(`查询后先核对关键列：${columns.slice(0, 12).map(x => `\`${x}\``).join('、')}。`);
    if (columns.length > 12) steps.push(`继续横向滚动或展开表格，核对：${columns.slice(12, 26).map(x => `\`${x}\``).join('、')}。`);
  }
  if (page.hasTree) {
    steps.push(`如果页面左侧或上方有树形结构，先选中组织、物料、菜单或产品节点，再查看右侧列表；新增子节点前确认父节点选中正确。`);
  }
  const nonQueryButtons = buttons.filter(b => !['查询/筛选', '取消/关闭'].includes(actionVerb(b)));
  for (const button of nonQueryButtons.slice(0, 10)) {
    const verb = actionVerb(button);
    if (verb === '新增') steps.push(`需要新增时点击 \`${button.text}\`，在弹窗中逐项填写必填字段，确认编码、名称、状态等基础信息后保存。`);
    else if (verb === '编辑/保存') steps.push(`需要维护已有记录时先选中目标行，再点击或触发表格内 \`${button.text}\`，修改字段后保存并等待成功提示。`);
    else if (verb === '删除') steps.push(`需要删除时先确认该记录没有正在使用的业务数据，再点击 \`${button.text}\`，按确认提示执行。`);
    else if (verb === '导出/打印') steps.push(`需要留存或流转时点击 \`${button.text}\`，导出/打印前确认当前查询条件和选中记录正确。`);
    else if (verb === '查看') steps.push(`需要查看明细时点击 \`${button.text}\`，在弹窗或新区域核对图纸、明细、进度、记录或关联单据。`);
    else if (verb === '业务提交') steps.push(`需要推进业务时先选中目标行并核对数量、时间、人员、工位、物料和备注，再点击 \`${button.text}\` 提交。`);
    else steps.push(`按业务需要点击 \`${button.text}\`，操作前先确认选中行和输入内容。`);
  }
  if (dialogs.length) {
    steps.push(`出现弹窗时按弹窗标题处理：${dialogs.slice(0, 8).map(x => `\`${x}\``).join('、')}；弹窗关闭前确认必填项已保存。`);
  }
  if (forms.length) {
    steps.push(`弹窗或表单内重点填写：${forms.slice(0, 14).map(x => `\`${x}\``).join('、')}，提交前逐项核对。`);
  }
  if (page.hasUpload) {
    steps.push(`涉及上传时先选择正确文件，再点击上传/保存；上传后重新查询，确认文件名、版本、上传时间或预览内容已显示。`);
  }
  if (page.hasCalendar) {
    steps.push(`进入日程页后，单击任务查看详情；拖拽任务可调整计划开始时间，拉伸任务可调整计划完成时间，系统提示确认后才会保存。`);
    steps.push(`日程保存失败或取消时任务会恢复原日期；保存成功后回到表单页重新查询，核对计划开始和计划完成是否同步。`);
  }
  if (procs.length) {
    steps.push(`保存或提交成功后重新点击查询，确认页面数据已通过 ${procs.slice(0, 5).map(x => `\`${x}\``).join('、')} 等后台过程更新。`);
  }
  if (page.sapCalls.length) {
    steps.push(`涉及 SAP/WMS 接口时，必须查看页面成功或失败提示；失败时先记录错误信息，不要连续重复提交同一单据。`);
  }

  if (/SelfMakePlando[\\/]/.test(pathText)) {
    steps.push(`在 \`指派数量\` 中输入小于计划数的数量时，表示本次只派出部分数量，剩余数量需要继续跟踪和后续派工。`);
    steps.push(`点击 \`批量排产\` 前应选择同一生产订单的多道工序，系统会按订单行号排序并继承上一道工序的部分计划信息。`);
    steps.push(`点击 \`排产完成\` 后，系统校验指派对象、指派数量、计划开始、计划完成，并同步生产订单最早开始和最晚完成。`);
  }
  if (/SelfMakePlandone[\\/]/.test(pathText)) {
    steps.push(`已排产列表中仍可调整指派对象、指派数量、计划开始、计划完成、外协分组、最晚开始和二次派工；调整后要重新查询确认。`);
  }
  if (/MachiningCenter|AssemblyCenter/.test(pathText)) {
    steps.push(`现场执行类操作必须按实际顺序处理：先确认任务和工位，再收料/开工，完成加工或装配后再报工/送检。`);
  }
  if (/QualityManagement/.test(pathText)) {
    steps.push(`录入检验结果时先核对检验类型、订单、物料、批次/工序，再填写合格数、不合格数和检测明细，避免检验记录挂错任务。`);
  }
  if (/WorkHoursCheck/.test(pathText)) {
    steps.push(`工时校验前先比对 MES 报工、设备工时和 SAP 工序资源；只对核对无误的记录执行提交。`);
  }
  if (/WorkstationManagement/.test(pathText)) {
    steps.push(`工位新增或修改会影响 SAP 资源、派工、报工和看板，保存后要用排产或生产执行页面验证工位是否可选。`);
  }
  if (/MenuManagement|SystemRrolemaintenance|PersonnelManagement/.test(pathText)) {
    steps.push(`权限类修改保存后，需要让相关用户重新登录或刷新权限，再验证菜单、按钮和数据范围是否生效。`);
  }

  return steps.map((s, i) => `${i + 1}. ${s}`).join('\n');
}

function notes(page) {
  const values = [];
  if (/PlanManagement/.test(page.relative)) values.push('排产、派工和计划时间会影响生产看板、及时开工统计和 SAP 生产订单日期，提交前必须核对。');
  if (/ProductionManagement/.test(page.relative)) values.push('生产执行页面的数据会直接影响报工、工时、质检和库存任务，现场操作必须与实际加工进度一致。');
  if (/QualityManagement/.test(page.relative)) values.push('质检结果保存后会影响合格入库、不合格处理和后续工序，提交前必须核对数量。');
  if (/ProcessManagement|CraftManagement/.test(page.relative)) values.push('工艺、图纸和结构资料会被排产、生产、质检引用，版本错误会直接影响现场执行。');
  if (/DeviceManagement/.test(page.relative)) values.push('设备和采集数据用于看板、OEE 和报工分析，发现异常时应先确认设备编码和采集点位。');
  if (/SystemMaintenance/.test(page.relative)) values.push('系统维护类数据会影响登录、权限、菜单和业务可选项，修改后需要验证。');
  if (page.sapCalls.length) values.push('该页存在 SAP/WMS 调用，失败时应记录返回提示并确认是否已经生成外部单据。');
  if (page.hasCalendar) values.push('日程拖拽属于直接改计划时间的操作，拖拽前应确认任务未被现场执行锁定。');
  if (!values.length) values.push('操作后建议重新查询页面，确认列表、状态和明细已经刷新。');
  return values.map(v => `- ${v}`).join('\n');
}

function section(page, index) {
  const query = queryItems(page);
  const columns = tableItems(page);
  const buttons = buttonItems(page);
  const procs = procItems(page);
  const sap = sapItems(page);

  return `### 21.${index} ${page.name}

页面路径：\`${page.relative}\`
所属模块：${moduleName(page)}
建议使用人员：${roleFor(page)}

页面用途：${purpose(page)}

**具体操作步骤**
${detailedSteps(page)}

**查询条件/输入项**
${lineList(query, '未识别到固定输入项，按现场页面提示操作。')}

**结果表重点列**
${lineList(columns, '未识别到固定表格列，以页面实际显示为准。')}

**页面按钮/状态/页签**
${lineList([...buttons, ...page.tabLabels].slice(0, 36), '未识别到明确按钮，以页面实际显示为准。')}

**弹窗/表单重点项**
${lineList([...page.dialogs, ...page.formLabels].slice(0, 30), '未识别到固定弹窗或表单项。')}

**后台处理/外部接口**
${lineList([...procs.map(x => `存储过程：${x}`), ...sap.map(x => `接口：${x}`)].slice(0, 30), '未发现页面级后台提交动作。')}

**操作注意事项**
${notes(page)}
`;
}

function moduleOrder(page) {
  const order = [
    '404.vue',
    'AnomalousManagement',
    'CraftManagement',
    'DeviceManagement',
    'PlanManagement',
    'ProcessManagement',
    'ProductionManagement',
    'QualityManagement',
    'SaleManagement',
    'SystemMaintenance',
    'dashboard',
    'layout',
    'login'
  ];
  const key = page.relative === 'src/views/404.vue' ? '404.vue' : page.module;
  const idx = order.indexOf(key);
  return idx >= 0 ? idx : 99;
}

function moduleHeading(page) {
  const key = page.relative === 'src/views/404.vue' ? '404.vue' : page.module;
  const headings = {
    '404.vue': '错误页',
    AnomalousManagement: '异常管理',
    CraftManagement: '产品结构维护',
    DeviceManagement: '设备管理',
    PlanManagement: '计划排产',
    ProcessManagement: '工艺与图纸管理',
    ProductionManagement: '生产执行管理',
    QualityManagement: '质量管理',
    SaleManagement: '销售与交付查询',
    SystemMaintenance: '系统维护',
    dashboard: '首页与看板',
    layout: '布局与导航',
    login: '登录'
  };
  return headings[key] || key;
}

function buildChapter(pages) {
  const sorted = pages.sort((a, b) => {
    const m = moduleOrder(a) - moduleOrder(b);
    if (m !== 0) return m;
    return a.relative.localeCompare(b.relative, 'zh-Hans-CN');
  });

  const lines = [];
  lines.push('## 二十一、逐页详细操作说明（按 src/views 页面）');
  lines.push('');
  lines.push('本章按源码页面逐页编写。每个页面都从实际 `v-model`、表格列、按钮、弹窗、页签、存储过程和 SAP/WMS 调用中提取操作线索，转换成用户可执行的步骤。');
  lines.push('');
  lines.push('通用阅读方法：');
  lines.push('- `查询条件/输入项` 是用户进入页面后可以填写、选择或用于筛选的字段。');
  lines.push('- `结果表重点列` 是查询后需要核对的表格列，表格可横向滚动时应继续向右查看。');
  lines.push('- `页面按钮/状态/页签` 是页面上能触发查询、查看、编辑、提交、导出、状态切换或页面切换的入口。');
  lines.push('- `后台处理/外部接口` 用于说明保存后可能调用的存储过程、SAP 或 WMS 接口，业务人员主要关注成功/失败提示。');
  lines.push('- 涉及排产、报工、质检、外协、SAP/WMS 的操作，提交前必须核对订单、物料、数量、人员、工位和日期。');
  lines.push('');

  let current = '';
  let moduleIndex = 0;
  sorted.forEach((page, i) => {
    const heading = moduleHeading(page);
    if (heading !== current) {
      moduleIndex += 1;
      current = heading;
      lines.push(`## 21-${moduleIndex} ${heading}`);
      lines.push('');
    }
    lines.push(section(page, i + 1).trimEnd());
    lines.push('');
  });
  return lines.join('\n').trimEnd() + '\n';
}

function main() {
  const pages = walk(viewsRoot)
    .filter(file => !/node_modules/.test(file))
    .map(extractPage);
  const chapter = buildChapter(pages);
  const manual = readText(manualPath);
  const marker = '## 二十一、逐页详细操作说明（按 src/views 页面）';
  const idx = manual.indexOf(marker);
  if (idx < 0) throw new Error(`找不到章节标记：${marker}`);
  const nextChapter = manual.slice(idx + marker.length).search(/\n## 二十二、/);
  const head = manual.slice(0, idx).trimEnd() + '\n\n';
  const tail = nextChapter >= 0 ? manual.slice(idx + marker.length + nextChapter) : '';
  writeText(manualPath, head + chapter + (tail ? '\n' + tail.trimStart() : ''));
  console.log(`rewrote chapter 21 for ${pages.length} pages`);
}

main();