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:
+122
@@ -0,0 +1,122 @@
|
||||
import { expect, test } from '@playwright/test'
|
||||
|
||||
/**
|
||||
* PWA 端到端验证。
|
||||
*
|
||||
* 这些用例跑在 preview(生产构建)上,因为 Service Worker 只在构建产物中生成。
|
||||
* 每个用例拥有独立的浏览器上下文,因此 Service Worker 也是各自安装的。
|
||||
*/
|
||||
|
||||
/** 等待 Service Worker 激活并接管当前页面 */
|
||||
async function waitForServiceWorker(page: import('@playwright/test').Page): Promise<void> {
|
||||
await page.waitForFunction(
|
||||
async () => {
|
||||
const registration = await navigator.serviceWorker.ready
|
||||
return registration.active?.state === 'activated' && navigator.serviceWorker.controller !== null
|
||||
},
|
||||
undefined,
|
||||
{ timeout: 30_000 },
|
||||
)
|
||||
}
|
||||
|
||||
test('manifest 被链接且包含安装所需字段', async ({ page, request }) => {
|
||||
await page.goto('/')
|
||||
|
||||
await expect(page.locator('link[rel="manifest"]')).toHaveAttribute('href', '/manifest.webmanifest')
|
||||
|
||||
const response = await request.get('/manifest.webmanifest')
|
||||
expect(response.status()).toBe(200)
|
||||
|
||||
const manifest = (await response.json()) as {
|
||||
name: string
|
||||
short_name: string
|
||||
start_url: string
|
||||
display: string
|
||||
theme_color: string
|
||||
icons: Array<{ sizes: string; purpose?: string }>
|
||||
shortcuts?: Array<{ url: string }>
|
||||
}
|
||||
|
||||
expect(manifest.name).toBe('看板 · 个人任务管理')
|
||||
expect(manifest.display).toBe('standalone')
|
||||
expect(manifest.start_url).toBe('/')
|
||||
expect(manifest.theme_color).toBe('#0284c7')
|
||||
|
||||
const sizes = manifest.icons.map((icon) => icon.sizes)
|
||||
expect(sizes).toContain('192x192')
|
||||
expect(sizes).toContain('512x512')
|
||||
expect(manifest.icons.some((icon) => icon.purpose === 'maskable')).toBe(true)
|
||||
|
||||
// PWA 快捷方式指向今日视图
|
||||
expect(manifest.shortcuts?.some((shortcut) => shortcut.url === '/today')).toBe(true)
|
||||
})
|
||||
|
||||
test('图标资源均可访问', async ({ request }) => {
|
||||
const icons = [
|
||||
'/pwa-192x192.png',
|
||||
'/pwa-512x512.png',
|
||||
'/maskable-512x512.png',
|
||||
'/apple-touch-icon.png',
|
||||
'/favicon.svg',
|
||||
]
|
||||
|
||||
for (const path of icons) {
|
||||
const response = await request.get(path)
|
||||
expect(response.status(), `${path} 应可访问`).toBe(200)
|
||||
}
|
||||
})
|
||||
|
||||
test('Service Worker 注册并激活', async ({ page }) => {
|
||||
await page.goto('/')
|
||||
await waitForServiceWorker(page)
|
||||
|
||||
const state = await page.evaluate(async () => {
|
||||
const registration = await navigator.serviceWorker.ready
|
||||
return registration.active?.state ?? null
|
||||
})
|
||||
|
||||
expect(state).toBe('activated')
|
||||
})
|
||||
|
||||
test('离线后仍可打开看板,且本地数据完好', async ({ page, context }) => {
|
||||
await page.goto('/')
|
||||
await waitForServiceWorker(page)
|
||||
|
||||
const input = page.getByLabel('添加任务').first()
|
||||
await input.fill('离线也要看到我')
|
||||
await input.press('Enter')
|
||||
await expect(page.locator('article')).toHaveCount(1)
|
||||
|
||||
// 断网后刷新:页面与数据都必须还在
|
||||
await context.setOffline(true)
|
||||
await page.reload()
|
||||
|
||||
await expect(page.getByText('共 1 个任务')).toBeVisible()
|
||||
await expect(page.locator('article').filter({ hasText: '离线也要看到我' })).toBeVisible()
|
||||
|
||||
// 恢复网络,避免影响后续用例
|
||||
await context.setOffline(false)
|
||||
})
|
||||
|
||||
test('离线时深链 /today 也能打开(navigateFallback 生效)', async ({ page, context }) => {
|
||||
await page.goto('/')
|
||||
await waitForServiceWorker(page)
|
||||
|
||||
await context.setOffline(true)
|
||||
await page.goto('/today')
|
||||
|
||||
await expect(page.getByRole('heading', { name: '今日' })).toBeVisible()
|
||||
await expect(page.getByText('今日待办')).toBeVisible()
|
||||
|
||||
await context.setOffline(false)
|
||||
})
|
||||
|
||||
test('静态资源被预缓存(sw.js 含 precache 清单)', async ({ request }) => {
|
||||
const response = await request.get('/sw.js')
|
||||
expect(response.status()).toBe(200)
|
||||
|
||||
const source = await response.text()
|
||||
// workbox 生成的是压缩过的清单,这里只确认关键资源确实进了预缓存
|
||||
expect(source).toContain('index.html')
|
||||
expect(source).toContain('manifest.webmanifest')
|
||||
})
|
||||
Reference in New Issue
Block a user