$ErrorActionPreference = 'Stop'

$root = Split-Path -Parent $PSScriptRoot
$pagesPath = Join-Path $root 'pages.json'
$mappingPath = Join-Path $root 'docs/接口与页面映射总表.md'

if (-not (Test-Path -LiteralPath $mappingPath -PathType Leaf)) {
  throw '缺少页面与接口关系的唯一总表：docs/接口与页面映射总表.md'
}

$pagesDocument = Get-Content -Raw -Encoding UTF8 -LiteralPath $pagesPath | ConvertFrom-Json
$registeredRoutes = @($pagesDocument.pages | ForEach-Object { $_.path })
$mappingLines = @(Get-Content -Encoding UTF8 -LiteralPath $mappingPath)
$mappingText = $mappingLines -join "`n"

# 第一步：只解析以正式页面编号开头的表格行，避免把正文中的示例路由误算成页面映射。
$routeRows = @(
  foreach ($line in $mappingLines) {
    if ($line -match '^\|\s*(?<code>[AGTFRNM]\d{2})\s*\|\s*[^|]+\|\s*`(?<route>pages/[^`]+)`\s*\|') {
      $columns = @($line.Trim('|').Split('|') | ForEach-Object { $_.Trim() })
      [pscustomobject]@{
        Code = $Matches.code
        Route = $Matches.route
        Line = $line
        Columns = $columns
      }
    }
  }
)

if ($routeRows.Count -ne $registeredRoutes.Count) {
  throw "页面映射行数与 pages.json 不一致：映射=$($routeRows.Count)，注册=$($registeredRoutes.Count)"
}

# 第二步：每个活动页面必须完整填写业务目标、入口、流程结果、状态和接口业务域；只列编号和路由不算完成迁移。
foreach ($row in $routeRows) {
  if ($row.Columns.Count -ne 9) {
    throw "页面映射列数错误：$($row.Code) 应为 9 列，实际为 $($row.Columns.Count)"
  }
  foreach ($columnIndex in 1..7) {
    if ([string]::IsNullOrWhiteSpace($row.Columns[$columnIndex])) {
      throw "页面映射存在空业务列：$($row.Code) 第 $($columnIndex + 1) 列"
    }
  }
}

# 第三步：页面编号和路由都必须唯一；重复行会制造两个互相冲突的当前合同。
$duplicateCodes = @($routeRows | Group-Object Code | Where-Object Count -gt 1)
if ($duplicateCodes.Count -gt 0) {
  throw "页面映射存在重复编号：$($duplicateCodes.Name -join ', ')"
}

$duplicateRoutes = @($routeRows | Group-Object Route | Where-Object Count -gt 1)
if ($duplicateRoutes.Count -gt 0) {
  throw "页面映射存在重复路由：$($duplicateRoutes.Name -join ', ')"
}

# 页面编号必须由实际文件名语义得出，不能把正确路径和另一个页面编号错误拼接。
foreach ($row in $routeRows) {
  if ($row.Route -notmatch '/(?<routeCode>[a-z]\d{2})-[^/]+$') {
    throw "页面映射路由缺少文件名语义编号：$($row.Route)"
  }
  if ($Matches.routeCode.ToUpperInvariant() -ne $row.Code) {
    throw "页面映射编号与路由不一致：编号=$($row.Code)，路由=$($row.Route)"
  }
}

# 第四步：总表顺序和路由集合必须与 pages.json 精确一致，新增或删除页面时必须同轮更新唯一总表。
$mappedRoutes = @($routeRows | ForEach-Object Route)
$missingRoutes = @($registeredRoutes | Where-Object { $_ -notin $mappedRoutes })
$staleRoutes = @($mappedRoutes | Where-Object { $_ -notin $registeredRoutes })
if ($missingRoutes.Count -gt 0 -or $staleRoutes.Count -gt 0) {
  throw "页面映射与 pages.json 不相等：缺失=[$($missingRoutes -join ', ')]；陈旧=[$($staleRoutes -join ', ')]"
}

for ($index = 0; $index -lt $registeredRoutes.Count; $index += 1) {
  if ($mappedRoutes[$index] -ne $registeredRoutes[$index]) {
    throw "页面映射顺序错误：第 $($index + 1) 行应为 $($registeredRoutes[$index])，实际为 $($mappedRoutes[$index])"
  }
}

# 第五步：A04、G 系列第一轮、F 系列当前写边界和 T01 允许登记已有专项证据；
# 其余页面不能提前冒充完成 OpenAPI 审查。F 系列每页必须同时写出已核对事实和仍未启用的边界。
$authSeriesReviewPatterns = @{
  A01 = '密码登录线上 wire.*默认 mock.*`validToken` 未由登录接口消费.*`API-AUTH-TAC-001`.*见 2\.10'
  A04 = '`APP_REGISTER`、4 位码、`RAppLoginVo → AppLoginVo\.access_token` 客户端链已落地.*真实 challenge.*红灯.*见 2\.10'
  A05 = '`APP_FORGOT_PASSWORD` 客户端链已落地.*真实后端、Android 可访问替代与 MuMu 仍红灯.*见 2\.10'
}
$gSeriesWorkspacePatterns = @{
  G01 = 'Task26 工作区红灯已建立.*`/mine`.*尚未接远端.*Task29 unread-count 红灯.*M01.*见 2\.13/5\.6'
  G03 = 'Task35 已建立 atomic bootstrap、无 PII operation-status、统一 accessPreset、APP 可信地区与词法 ID 的后端/客户端双红灯.*见 2\.8/5\.12'
  G05 = 'Task26 选定 `/overview` 为唯一 owner.*对象级授权和错误语义未关闭.*见 2\.8/5\.3'
  G11 = 'Task38 已建立唯一 merge PUT、settingsVersion/If-Match、409 three-way、待审串行化与 unknown 红灯.*见 2\.16/5\.15'
  G12 = 'Task39 已建立唯一 GET/PUT、poemSetVersion/If-Match、完整候选集合、unknown 与 CORS owner 红灯.*页面尚未接远端.*见 2\.17/5\.16'
}
$gSeriesJoinPatterns = @{
  G06 = 'Task36 搜索.*见 2\.14/5\.13.*Task37 六 operation 邀请红灯.*见 2\.15/5\.14'
  G08 = 'Task36 后端红灯.*见 2\.14/5\.13.*Task37 明确邀请不得进入 G08'
  G09 = 'mine 四状态、拒绝原因和撤回 CAS.*消息中心承诺待接线时删除'
  G10 = 'Task36 固定 APPROVE/REJECT、PENDING CAS.*手机号节点待接线时原子删除'
}
$fSeriesReviewPatterns = @{
  F01 = 'Task40 已建立唯一 cursor GET、无 PII 投影、逐页鉴权与非泄露 404 红灯.*后端绿前保持 fixture.*见 2\.18/5\.17'
  F02 = '线上写请求要求 `feedContent`.*minLength=1.*`feedType/mediaOssIds/sortOrder/status`.*`WRITE_UNAVAILABLE`'
  F03 = 'Task40 已拆分详情与一级评论 cursor owner.*评论写仍只做未提交预览.*见 2\.18/5\.17'
  F04 = '任务 7 已核对线上列表及写接口.*唯一只读 owner'
  F05 = '线上未证明收藏合同.*`articleTitle/articleContent`.*minLength=1'
  F06 = '线上 POST/PUT 已存在.*`categoryId/coverOssId` 为 int64.*真实调用未'
  F07 = '线上创建要求 `albumName`.*不伪增列表或计数'
  F08 = '任务 7 已核对.*复合身份.*跨谱'
  F09 = '旧 `/files/upload` 已下线.*resumable init/chunk/complete.*complete 返回.*`ossId` 为 string.*照片创建要求 int64.*后端消除类型冲突前不得转换或提交'
  F10 = '任务 7 未发现.*保持关闭'
}
$rSeriesReviewPatterns = @{
  R01 = '任务 8 已核对.*lineage/persons/page.*词法字符串'
  R02 = '任务 8 已核对.*AppLineagePersonBody.*`name` 必填.*真实写入未启用'
  R03 = '任务 8 已核对.*relative-records.*不是.*ceremony gifts.*方向语义'
  R04 = '任务 8 已核对.*`relativeId`.*`relativeName` 必填.*本地预览'
  R05 = '任务 8 已核对.*ceremonies.*`ceremonyTitle/ceremonyType` 必填.*无正式枚举'
  R06 = '任务 8 已核对.*invitations.*成员选项.*参与者'
  R07 = '任务 8 已核对.*`ceremonyId`.*真实写入未启用'
  R08 = '任务 8 已核对.*growth-records.*`lineagePersonId`.*`recordType` 无枚举'
  R09 = '任务 8 已核对.*没有独立人生事件接口.*硬关闭'
  R10 = '任务 8 已核对.*memos.*`memoTitle` 必填.*`completed` 无枚举'
  R11 = '任务 8 已核对.*merit-records.*`donorName/meritTitle` 必填.*无枚举'
}
$nmSeriesReviewPatterns = @{
  N01 = 'Task29 读取红灯已建立.*完整活动集合.*纯文本.*计数同域.*见 2\.13/5\.6.*Task30 前不得本地伪写'
  N02 = 'Task29 选定 list-owned snapshot.*删除目标 CTA.*Task30.*私有字符串 ID.*见 2\.13/5\.6/5\.7'
  M01 = 'Task28 profile GET 红灯.*身份失败不锁菜单.*见 2\.13/5\.5.*Task29 unread-count 红灯.*fixture 伪数.*见 2\.13/5\.6'
  M02 = 'Task28 读取红灯仍是前置.*Task31 已建立 PUT merge.*If-Match.*typed response.*409 红灯.*头像不混入.*见 2\.13/5\.5/5\.8'
  M03 = 'Task28 已建立 profile GET 红灯.*普通读取失败不得阻断密码入口.*设备状态仍无合同.*见 2\.13/5\.5'
  M04 = 'Task33 已建立 raw writeOnly、ALL 会话撤销、typed 错误与 session marker 红灯.*四条密码 wire 必须同批迁移.*见 2\.13/5\.10'
  M05 = 'Task34 已建立专用 SaToken 发码、全活动六位码、ALL 会话撤销、outbox 与 credential marker 红灯.*依赖 M04 raw wire.*见 2\.13/5\.11'
  M06 = 'Task27 选定列表唯一 owner 并建立红灯.*专用 required、纯文本、仅发布、顺序和认证语义待后端关闭.*见 2\.13/5\.4'
  M07 = 'Task25 已接 `POST /genealogy/app/feedback` 严格客户端.*remote 实测与 MuMu 待认证门禁关闭.*见 2\.13'
  M08 = 'Task37 六 operation 邀请红灯.*见 2\.15/5\.14.*通过前保持不可用且不展示假码'
  M09 = '套餐/订单端点存在但支付闭环未定义.*删除查询参数演示订单.*见 2\.13'
  M10 = 'Task9 已完成本机清理基线.*Task32 已建立当前凭证族、幂等 200、logoutCoordinator、required RVoid 与部署复用红灯.*见 2\.13/5\.9'
}
$prematureRows = @(
  $routeRows | Where-Object {
    if ($authSeriesReviewPatterns.ContainsKey($_.Code)) { return $_.Line -notmatch $authSeriesReviewPatterns[$_.Code] }
    if ($_.Code -eq 'T01') { return $_.Line -notmatch '专项已核对：现有递归 `LineagePersonTreeView` 不满足' }
    if ($gSeriesWorkspacePatterns.ContainsKey($_.Code)) { return $_.Line -notmatch $gSeriesWorkspacePatterns[$_.Code] }
    if ($gSeriesJoinPatterns.ContainsKey($_.Code)) { return $_.Line -notmatch $gSeriesJoinPatterns[$_.Code] }
    if ($fSeriesReviewPatterns.ContainsKey($_.Code)) { return $_.Line -notmatch $fSeriesReviewPatterns[$_.Code] }
    if ($rSeriesReviewPatterns.ContainsKey($_.Code)) { return $_.Line -notmatch $rSeriesReviewPatterns[$_.Code] }
    if ($nmSeriesReviewPatterns.ContainsKey($_.Code)) { return $_.Line -notmatch $nmSeriesReviewPatterns[$_.Code] }
    return $_.Line -notmatch '待对应业务阶段 OpenAPI 审查'
  }
)
if ($prematureRows.Count -gt 0) {
  throw "存在没有准确表达接口审查状态的活动页面：$($prematureRows.Code -join ', ')"
}

foreach ($heading in @(
  '## 一、权威边界',
  '## 二、全局业务与交互合同',
  '## 三、52 个活动页面映射',
  '## 四、封存与已移除页面',
  '## 五、后续接口审查填充规则'
)) {
  if (-not $mappingText.Contains($heading)) {
    throw "接口与页面映射总表缺少章节：$heading"
  }
}

# 第六步：锁定旧资料中仍然有效的关键业务事实，避免未来把表格保留却悄悄清空真正的产品合同。
foreach ($requiredFact in @(
  '15—64 Unicode code point',
  '无组成规则',
  'SmsCodeSecret',
  '恰好 6 位 ASCII 数字',
  '/genealogy/app/auth/phone/sms/code',
  'PHONE-CHANGE-OPENAPI-CONTRACT BLOCKED',
  'API-PHONE-001',
  'STEP_UP_UNAVAILABLE',
  'AppGenealogyBootstrapBody',
  'GenealogyBootstrapOperationKey',
  'GenealogyAccessPreset',
  'GenealogyRegionCode',
  'FAILED_NO_COMMIT',
  'G03-BOOTSTRAP-OPENAPI-CONTRACT BLOCKED',
  'G03-BOOTSTRAP-CLIENT-RELEASE BLOCKED',
  '/genealogy/app/region/search',
  'GET 必须纯读',
  'receipt→mine cache→context→G05',
  'API-G03-001',
  'API-G03-005',
  'AppGenealogySettingsUpdateBody',
  'GenealogySettingsVersion',
  'G11-SETTINGS-OPENAPI-CONTRACT BLOCKED',
  'API-SETTINGS-001',
  'API-SETTINGS-006',
  'ACTIVE_PENDING_APPLICATIONS',
  'ATOMIC_SINGLE_WINNER',
  'NON_DISCLOSING_GENEALOGY_NOT_AVAILABLE',
  'OMIT_ONLY_AFTER_CONFIRMED_ACCESS_LOSS',
  'canonical 设置实际变化',
  '内部 LF',
  '控制字符',
  'exact local',
  '旁路详情',
  'nullable',
  '真实 JSON 数组',
  '允许非语义 tracing header',
  '禁止 ETag',
  'traceparent/tracestate/x-request-id/x-correlation-id',
  '内联 Header Object',
  '非 null 的 string schema',
  'readOnly/writeOnly',
  'allOf',
  '根层',
  'PUBLIC_APPLY→MEMBER_ONLY',
  'AppGenerationPoemSetUpdateBody',
  'GenerationPoemSetSnapshot',
  'GenerationPoemSetVersion',
  'G12-GENERATION-POEM-OPENAPI-CONTRACT BLOCKED',
  'API-POEM-001',
  'API-POEM-006',
  'APP_GATEWAY_PREFLIGHT',
  'VALIDATE_FINAL_ACTIVE_CAPACITY',
  'FRESH_GET_THREE_WAY_NO_AUTO_PUT',
  'FAMILY-FEED-READ-OPENAPI-CONTRACT BLOCKED',
  'FAMILY-FEED-READ-OPENAPI-ADVERSARIAL-CONTRACT PASS MUTANTS=58',
  'API-FEED-READ-001',
  'API-FEED-READ-006',
  'appListFamilyFeeds',
  'appGetFamilyFeed',
  'appListFamilyFeedRootComments',
  'AppFamilyFeedReadItem',
  'AppFamilyFeedRootCommentReadItem',
  'UPPER_BOUND_KEYSET_LATEST_VISIBLE',
  'FAMILY_FEED_NOT_AVAILABLE',
  'hasMedia',
  'A01、A04、A05 已接入同一个 `TacVerification`',
  '`APP_SMS_LOGIN`',
  '`APP_REGISTER`',
  '`APP_FORGOT_PASSWORD`',
  '开发/联调 wire 已按线上',
  '`validToken` 未进入或被服务端消费',
  '不能把本地滑动成功冒充服务端验证',
  '聚焦密码框',
  '审核中记录只展示进度和“撤回申请”',
  '被拒绝记录展示原因和“修改后重新提交”',
  '仅成员可见',
  '公开可申请',
  'LineageGraphWindow',
  'EMPTY/POPULATED',
  'entryPersonIds',
  'genealogyRootPersonIds',
  'redactedGenealogyRootCount',
  'rootVisibility',
  'pathCompleteness',
  'ancestorPathSegments',
  'anchorPersonId',
  'schemaVersion',
  'returnedNodeCount',
  'partnerRelationship',
  'relationshipKind',
  'parentRole',
  'LINEAGE_QUERY_INVALID',
  'LINEAGE_FOCUS_NOT_AVAILABLE',
  'RELATIONSHIP_PATCH_EMPTY',
  'sceneVersion',
  '/genealogy/app/v2/',
  'API-T01-001',
  '单个原生页面实例',
  '注册成功响应为 `RAppLoginVo`',
  '`AppLoginVo.access_token`',
  'aria-describedby',
  '邀请码直接加入且不生成审核记录',
  'appApi',
  '500',
  '20',
  '100ms',
  '44dp',
  '导航栈语义统一',
  '跨页面领域数据持久化',
  '全局文字层级和无障碍第二轮',
  'A02 账号登录',
  'A06 登录状态',
  'G02',
  'G04',
  'G07',
  'T02'
)) {
  if (-not $mappingText.Contains($requiredFact)) {
    throw "接口与页面映射总表缺少关键业务事实：$requiredFact"
  }
}

if ($mappingText -match '汤正华堂侄') {
  throw '当前产品文档不得使用具体姓名示例，应改为“某某某堂侄”等通用占位表达'
}

$localRouteBoundary = [regex]::Match(
  $mappingText,
  '(?s)### 2\.6 当前本地数据与路由参数边界.*?(?=### 2\.7)'
).Value
$localRouteTable = [regex]::Match($localRouteBoundary, '(?s)\| 页面 \|.*?\n\n').Value
foreach ($retiredRParameter in @('`count`', '`saveResult`', '`giftId`', '`ritualId`', '`personName`')) {
  if ($localRouteTable.Contains($retiredRParameter)) {
    throw "R 系列本地路由边界仍登记已退役参数：$retiredRParameter"
  }
}
foreach ($currentRContract in @(
  '| R01 | `genealogyId`、`state` |',
  '| R04 | `genealogyId`、`mode`、`relativeId`、`state` |',
  '| R07 | `genealogyId`、`mode`、`ceremonyId`、`state` |',
  '| R08、R09 | `genealogyId`、`personId`、`state` |',
  '| R10、R11 | `genealogyId`、`state` |'
)) {
  if (-not $localRouteTable.Contains($currentRContract)) {
    throw "R 系列本地路由边界缺少当前复合身份合同：$currentRContract"
  }
}

Write-Output "INTERFACE-PAGE-MAPPING-CONTRACT PASS ROUTES=$($routeRows.Count)"