feat: 增進 app-map

test/cli-e2e.test.js

@@ -23,6 +23,13 @@ test('CLI runs doctor and scan against one prototype', async () => {
       </form>
     </main>
   `)
+  await writeFile(join(cwd, 'packages/prototype/portal.md'), `
+    # Portal Guide
+
+    | 雛型檔 | 舊 JSP 來源 | 功能 |
+    | --- | --- | --- |
+    | [\`index.html\`](index.html) | \`legacy/index.jsp\` | Customer portal entry |
+  `)
 
   const doctor = await exec('node', [cli, 'doctor'], { cwd })
   await exec('node', [cli, 'scan'], { cwd })
@@ -45,6 +52,9 @@ test('CLI runs doctor and scan against one prototype', async () => {
   assert.equal(appMap.routes[0].prototype, 'index.html')
   assert.equal(appMap.routes[0].kind, 'feature-page')
   assert.equal(appMap.routes[0].layout, 'template-app')
+  assert.equal(appMap.routes[0].guide.legacyJsp, 'legacy/index.jsp')
+  assert.equal(appMap.routes[0].guide.description, 'Customer portal entry')
+  assert.equal(appMap.guideSources[0].source, 'portal.md')
 })
 
 test('CLI help only exposes MVP commands', async () => {

test/html.test.js

@@ -1,6 +1,6 @@
 import test from 'node:test'
 import assert from 'node:assert/strict'
-import { buildAppMap, buildPageContract, extractRegions, inferRegionSpec, summarizeHtml, validatePageContract } from '../src/lib/html.js'
+import { buildAppMap, buildAppMapWithGuides, buildPageContract, extractRegions, inferRegionSpec, parsePrototypeGuide, summarizeHtml, validatePageContract } from '../src/lib/html.js'
 
 test('summarizeHtml extracts user-visible contract evidence', () => {
   const summary = summarizeHtml(`
@@ -97,6 +97,27 @@ test('buildAppMap classifies auth, shell references, and feature pages', () => {
   assert.equal(appMap.modules.find((module) => module.name === 'venue').kind, 'feature-module')
 })
 
+test('buildAppMap enriches routes with prototype markdown guide entries', () => {
+  const prototypeDir = '/repo/prototype'
+  const guide = parsePrototypeGuide('venue.md', `
+    # Venue 雛型導覽
+
+    | 雛型檔 | 舊 JSP 來源 | 舊 PB NVO 來源 | 對應 Vue view（M9） |
+    | --- | --- | --- | --- |
+    | [\`query-room.html\`](venue/query-room.html) | \`zte_pro/zte451_02.jsp\` + \`zte451_02_1.jsp\` | \`n_zte451.of_zte451_02\` / \`of_zte451_02_1\` | \`RoomQueryView.vue\` |
+  `)
+  const appMap = buildAppMapWithGuides([
+    buildSpec('/repo/prototype/venue/query-room.html', '<main><h1>全校場地查詢</h1><button>查詢</button></main>')
+  ], prototypeDir, [guide])
+  const route = appMap.routes[0]
+
+  assert.equal(appMap.guideSources[0].source, 'venue.md')
+  assert.equal(route.evidence.prototypeGuide, 'venue.md')
+  assert.equal(route.guide.legacyJsp, 'zte_pro/zte451_02.jsp + zte451_02_1.jsp')
+  assert.equal(route.guide.legacyPb, 'n_zte451.of_zte451_02 / of_zte451_02_1')
+  assert.equal(route.guide.targetView, 'RoomQueryView.vue')
+})
+
 function buildSpec(source, html) {
   const regions = extractRegions(html)
   const domSummary = summarizeHtml(html)