停用 stop/info 旧接口,统一详情入参为 stopId
Some checks failed
CI / verify (push) Has been cancelled

- 详情页路由入参统一为 stopId,废弃 targetType/targetId
- ExplainDetailEntryRequest 与 GlobalAudioSource 移除 targetType/targetId 字段
- 播放器源匹配仅按 stopId 判定,移除 targetType 兜底
- 删除 explainDetailTarget 死代码
- 清理 guideStopInfoAdapter 中 stop/info、play-info、text-info 旧契约类型与转换函数
- 补充测试服务器 Nginx SSL 部署手册
- 同步更新单测与 e2e 用例

Made-with: Proma
This commit is contained in:
lyf
2026-09-17 11:30:32 +08:00
parent bb6be9a04f
commit 337446f33c
10 changed files with 1173 additions and 385 deletions

View File

@@ -150,7 +150,7 @@ describe('讲解详情音频优先布局', () => {
global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
})
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', targetType: 'STOP', targetId: 'stop-1' })
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', stopId: 'stop-1' })
await flushPromises()
expect(wrapper.get('.detail-title').text()).toBe('Classical Astrolabe')
@@ -174,7 +174,7 @@ describe('讲解详情音频优先布局', () => {
global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
})
await mocks.onLoadHandler?.({ id: exhibit.id, targetType: 'STOP', targetId: 'stop-1' })
await mocks.onLoadHandler?.({ id: exhibit.id, stopId: 'stop-1' })
await flushPromises()
const state = wrapper.get('[data-testid="exhibit-detail-state"]')
@@ -197,7 +197,7 @@ describe('讲解详情音频优先布局', () => {
global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
})
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'zh-CN', targetType: 'STOP', targetId: 'stop-1' })
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'zh-CN', stopId: 'stop-1' })
await flushPromises()
const labels = wrapper.findAll('.language-option-text').map((node) => node.text())
@@ -214,7 +214,7 @@ describe('讲解详情音频优先布局', () => {
global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
})
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'zh-CN', targetType: 'STOP', targetId: 'stop-1' })
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'zh-CN', stopId: 'stop-1' })
await flushPromises()
expect(wrapper.find('.detail-language-bar').exists()).toBe(false)
@@ -231,7 +231,7 @@ describe('讲解详情音频优先布局', () => {
global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
})
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', targetType: 'STOP', targetId: 'stop-1' })
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', stopId: 'stop-1' })
await flushPromises()
expect(mocks.enterExplainDetail).toHaveBeenNthCalledWith(1, expect.objectContaining({ lang: 'en-US' }))
@@ -246,7 +246,7 @@ describe('讲解详情音频优先布局', () => {
global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
})
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', targetType: 'STOP', targetId: 'stop-1' })
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', stopId: 'stop-1' })
await flushPromises()
await wrapper.get('.detail-audio-play').trigger('tap')
@@ -258,13 +258,13 @@ describe('讲解详情音频优先布局', () => {
it('加载中使用同一高度底栏和不确定进度', async () => {
audioState.currentAudio.value = { id: 'audio-1' }
audioState.currentSource.value = { targetType: 'STOP', targetId: 'stop-1', lang: 'en-US' }
audioState.currentSource.value = { stopId: 'stop-1', lang: 'en-US' }
audioState.loading.value = true
const wrapper = mount(ExhibitDetail, {
global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
})
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', targetType: 'STOP', targetId: 'stop-1' })
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', stopId: 'stop-1' })
await flushPromises()
expect(wrapper.get('.detail-audio-dock').classes()).toContain('is-loading')
@@ -287,7 +287,7 @@ describe('讲解详情音频优先布局', () => {
global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
})
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'yue-HK', targetType: 'STOP', targetId: 'stop-1' })
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'yue-HK', stopId: 'stop-1' })
await flushPromises()
expect(wrapper.get('.detail-audio-dock').classes()).toContain('is-unavailable')
@@ -297,7 +297,7 @@ describe('讲解详情音频优先布局', () => {
it('播放失败显示错误并从当前详情音轨重试', async () => {
audioState.currentAudio.value = { id: 'audio-1', audioUrl: exhibit.audioUrl }
audioState.currentSource.value = { targetType: 'STOP', targetId: 'stop-1', lang: 'en-US' }
audioState.currentSource.value = { stopId: 'stop-1', lang: 'en-US' }
audioState.error.value = '音频暂时无法播放'
mocks.selectAudioForExplainDetail.mockResolvedValue({
playable: true,
@@ -309,7 +309,7 @@ describe('讲解详情音频优先布局', () => {
global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
})
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', targetType: 'STOP', targetId: 'stop-1' })
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', stopId: 'stop-1' })
await flushPromises()
expect(wrapper.get('.detail-audio-dock').classes()).toContain('is-failed')
expect(wrapper.find('.detail-audio-retry').exists()).toBe(false)
@@ -348,7 +348,7 @@ describe('讲解详情音频优先布局', () => {
global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
})
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', targetType: 'STOP', targetId: 'stop-1' })
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', stopId: 'stop-1' })
await flushPromises()
expect(wrapper.get('.detail-audio-speed').text()).toBe('1.0')
@@ -380,12 +380,12 @@ describe('讲解详情音频优先布局', () => {
it('离开详情页时立即关闭当前讲解播放器', async () => {
audioState.currentAudio.value = { id: 'audio-1', audioUrl: exhibit.audioUrl }
audioState.currentSource.value = { targetType: 'STOP', targetId: 'stop-1', lang: 'en-US' }
audioState.currentSource.value = { stopId: 'stop-1', lang: 'en-US' }
const wrapper = mount(ExhibitDetail, {
global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
})
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', targetType: 'STOP', targetId: 'stop-1' })
await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', stopId: 'stop-1' })
await flushPromises()
mocks.onHideHandler?.()
@@ -403,8 +403,7 @@ describe('讲解详情音频优先布局', () => {
await mocks.onLoadHandler?.({
id: exhibit.id,
lang: 'en-US',
targetType: 'STOP',
targetId: 'stop-1',
stopId: 'stop-1',
hallId: 'hall-1',
hallName: '%2525E6%252581%252590%2525E9%2525BE%252599%2525E5%25258E%252585'
})