feat: 个人轻量看板工具 MVP
从零实现一个 local-first 的个人任务看板,数据只存在浏览器本地,不依赖后端。 功能 - 固定三列看板(待办 / 进行中 / 已完成),支持拖拽改状态与列内排序 - 快速新增、详情编辑、删除撤销、已完成归档 - 搜索与筛选(关键词 / 优先级 / 标签 / 今日到期 / 逾期) - 今日视图:按紧急度分组(逾期 > 今天到期 > 进行中)+ 统计卡片 - 导出导入 JSON;启动时自动留快照,保留最近 3 份 - 键盘快捷键(N / 「/」/ ? / Esc) - PWA:可安装、离线可用、更新提示 技术要点 - 持久化采用 TaskRepository 端口 + 整份快照读写,schemaVersion 迁移表 显式登记升级规则(当前 v2,v1 -> v2 为归档功能补 archivedAt) - 同列排序用相邻中点插入,间距不足时按列 normalize,避免浮点精度耗尽 - 拖拽只消费 Sortable 的事件,store 保持唯一数据源,不接管数据 - 数据损坏时先备份到 *.corrupt.<时间戳> 再报错,不覆盖用户数据 - 引入 vue-router 拆分看板与今日两个视图(见 docs/adr.md ADR-005) 验证 - 单元测试 437 个(33 个文件),行覆盖率 96.8% - 端到端测试 23 个(Playwright),含真实拖拽与断网离线场景 - npm run build 通过,产物可静态托管 注:部署时需配置 SPA 回落,否则直接访问 /today 会 404(详见 README)。
This commit is contained in:
@@ -0,0 +1,79 @@
|
||||
import { mount } from '@vue/test-utils'
|
||||
import type { Ref } from 'vue'
|
||||
import { beforeEach, describe, expect, it, vi } from 'vitest'
|
||||
|
||||
import PwaUpdatePrompt from './PwaUpdatePrompt.vue'
|
||||
|
||||
/** 用 hoisted 持有引用,让测试可以驱动 needRefresh / offlineReady */
|
||||
const stub = vi.hoisted(() => ({
|
||||
needRefresh: null as unknown as Ref<boolean>,
|
||||
offlineReady: null as unknown as Ref<boolean>,
|
||||
updateServiceWorker: null as unknown as ReturnType<typeof vi.fn>,
|
||||
}))
|
||||
|
||||
vi.mock('virtual:pwa-register/vue', async () => {
|
||||
const { ref } = await import('vue')
|
||||
stub.needRefresh = ref(false)
|
||||
stub.offlineReady = ref(false)
|
||||
stub.updateServiceWorker = vi.fn()
|
||||
return { useRegisterSW: () => stub }
|
||||
})
|
||||
|
||||
function mountPrompt() {
|
||||
return mount(PwaUpdatePrompt, { attachTo: document.body })
|
||||
}
|
||||
|
||||
describe('PwaUpdatePrompt', () => {
|
||||
beforeEach(() => {
|
||||
stub.needRefresh.value = false
|
||||
stub.offlineReady.value = false
|
||||
stub.updateServiceWorker.mockClear()
|
||||
})
|
||||
|
||||
it('无状态时不渲染', () => {
|
||||
const wrapper = mountPrompt()
|
||||
expect(wrapper.find('[role="status"]').exists()).toBe(false)
|
||||
})
|
||||
|
||||
it('有新版本时提示并可立即更新', async () => {
|
||||
stub.needRefresh.value = true
|
||||
const wrapper = mountPrompt()
|
||||
await wrapper.vm.$nextTick()
|
||||
|
||||
expect(wrapper.text()).toContain('有新版本可用')
|
||||
|
||||
const updateButton = wrapper.findAll('button').find((node) => node.text() === '立即更新')
|
||||
await updateButton?.trigger('click')
|
||||
|
||||
// 传 true 表示更新后立即刷新页面
|
||||
expect(stub.updateServiceWorker).toHaveBeenCalledWith(true)
|
||||
})
|
||||
|
||||
it('已可离线使用时提示,但不显示更新按钮', async () => {
|
||||
stub.offlineReady.value = true
|
||||
const wrapper = mountPrompt()
|
||||
await wrapper.vm.$nextTick()
|
||||
|
||||
expect(wrapper.text()).toContain('已缓存,可离线使用')
|
||||
expect(wrapper.findAll('button').map((node) => node.text())).not.toContain('立即更新')
|
||||
})
|
||||
|
||||
it('点击关闭后提示消失', async () => {
|
||||
stub.needRefresh.value = true
|
||||
const wrapper = mountPrompt()
|
||||
await wrapper.vm.$nextTick()
|
||||
|
||||
await wrapper.find('button[aria-label="关闭提示"]').trigger('click')
|
||||
await wrapper.vm.$nextTick()
|
||||
|
||||
expect(stub.needRefresh.value).toBe(false)
|
||||
expect(wrapper.find('[role="status"]').exists()).toBe(false)
|
||||
})
|
||||
|
||||
it('带 role=status 便于读屏播报', async () => {
|
||||
stub.offlineReady.value = true
|
||||
const wrapper = mountPrompt()
|
||||
await wrapper.vm.$nextTick()
|
||||
expect(wrapper.find('[role="status"]').exists()).toBe(true)
|
||||
})
|
||||
})
|
||||
Reference in New Issue
Block a user