Add end-to-end tests for task modification and assignment features
All checks were successful
Chore App Build, Test, and Push Docker Images / build-and-push (push) Successful in 3m33s

- Implemented tests for editing penalty points and reward costs in `penalty-edit-points.spec.ts` and `reward-edit-cost.spec.ts`.
- Created detailed plans for task activation and assignment scenarios in `task-activated.plan.md` and `task-assignment.plan.md`.
- Added comprehensive test cases for modifying tasks, including editing points for chores, kindness acts, penalties, and rewards in `task-modified.plan.md`.
- Ensured all tests are isolated and run in serial mode to maintain state integrity.
This commit is contained in:
2026-03-17 22:46:27 -04:00
parent b2115ceb57
commit a9131242a7
28 changed files with 3724 additions and 106 deletions

View File

@@ -0,0 +1,168 @@
// spec: e2e/plans/task-activated.plan.md
import { test, expect, type APIRequestContext, type Locator, type Page } from '@playwright/test'
const CHILD_NAME = 'ActivateChoreChild'
const CHORE_NAME = 'TriggerTestChore'
const KIND_NAME = 'TriggerChoreHelperKindness'
const CHORE_POINTS = 10
async function createChild(request: APIRequestContext, name: string): Promise<string> {
const pre = await request.get('/api/child/list')
for (const c of (await pre.json()).children ?? []) {
if (c.name === name) await request.delete(`/api/child/${c.id}`)
}
await request.put('/api/child/add', { data: { name, age: 8 } })
const list = await request.get('/api/child/list')
return (await list.json()).children?.find((c: any) => c.name === name)?.id ?? ''
}
async function createTask(
request: APIRequestContext,
name: string,
type: 'chore' | 'kindness' | 'penalty',
points: number,
): Promise<string> {
const pre = await request.get('/api/task/list')
for (const t of (await pre.json()).tasks ?? []) {
if (t.name === name) await request.delete(`/api/task/${t.id}`)
}
await request.put('/api/task/add', { data: { name, points, type } })
const list = await request.get('/api/task/list')
return (await list.json()).tasks?.find((t: any) => t.name === name)?.id ?? ''
}
async function getPoints(page: Page): Promise<number> {
const text = await page.locator('.points .value').textContent()
return parseInt(text?.trim() ?? '0', 10)
}
async function activateItem(itemCard: Locator): Promise<void> {
await itemCard.click()
await expect(itemCard).toHaveClass(/item-ready/, { timeout: 3000 })
await itemCard.click()
}
function choreSection(page: Page): Locator {
return page.locator('.child-list-container').filter({
has: page.locator('h3', { hasText: 'Chores' }),
})
}
function kindnessSection(page: Page): Locator {
return page.locator('.child-list-container').filter({
has: page.locator('h3', { hasText: 'Kindness Acts' }),
})
}
test.describe('Chore activation', () => {
test.describe.configure({ mode: 'serial' })
let childId = ''
let choreId = ''
let kindId = ''
test.beforeAll(async ({ request }) => {
childId = await createChild(request, CHILD_NAME)
choreId = await createTask(request, CHORE_NAME, 'chore', CHORE_POINTS)
kindId = await createTask(request, KIND_NAME, 'kindness', 5)
// assign chore
await request.put(`/api/child/${childId}/set-tasks`, {
data: { task_ids: [choreId], type: 'chore' },
})
// assign kindness (set-tasks preserves other types)
await request.put(`/api/child/${childId}/set-tasks`, {
data: { task_ids: [kindId], type: 'kindness' },
})
})
test.afterAll(async ({ request }) => {
if (childId) await request.delete(`/api/child/${childId}`)
if (choreId) await request.delete(`/api/task/${choreId}`)
if (kindId) await request.delete(`/api/task/${kindId}`)
})
test('Kebab button appears after first chore click', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = choreSection(page).locator('.item-card').filter({ hasText: CHORE_NAME })
await card.waitFor({ state: 'visible' })
// Initially hidden
await expect(card.getByRole('button', { name: 'Options' })).not.toBeVisible()
// First click: item enters ready state, kebab becomes visible
await card.click()
await expect(card).toHaveClass(/item-ready/, { timeout: 3000 })
await expect(card.getByRole('button', { name: 'Options' })).toBeVisible()
})
test('Kebab button disappears when clicking a non-chore item', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = choreSection(page).locator('.item-card').filter({ hasText: CHORE_NAME })
const kindCard = kindnessSection(page).locator('.item-card').filter({ hasText: KIND_NAME })
await card.waitFor({ state: 'visible' })
await kindCard.waitFor({ state: 'visible' })
// Click chore — kebab appears
await card.click()
await expect(card).toHaveClass(/item-ready/, { timeout: 3000 })
await expect(card.getByRole('button', { name: 'Options' })).toBeVisible()
// Click a kindness item — selectedChoreId resets to null, kebab gone
await kindCard.click()
await expect(card.getByRole('button', { name: 'Options' })).not.toBeVisible()
})
test('Cancel chore confirmation — no points awarded', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = choreSection(page).locator('.item-card').filter({ hasText: CHORE_NAME })
await card.waitFor({ state: 'visible' })
const before = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'Yes' })).toBeVisible()
await page.getByRole('button', { name: 'Cancel' }).click()
await expect(page.getByRole('button', { name: 'Yes' })).not.toBeVisible()
await expect(page.locator('.points .value')).toHaveText(String(before))
})
test('Confirm chore activation — points awarded', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = choreSection(page).locator('.item-card').filter({ hasText: CHORE_NAME })
await card.waitFor({ state: 'visible' })
const before = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'Yes' })).toBeVisible()
await page.getByRole('button', { name: 'Yes' }).click()
await expect(page.locator('.points .value')).toHaveText(String(before + CHORE_POINTS))
})
test('Confirmed chore shows COMPLETED stamp', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = choreSection(page).locator('.item-card').filter({ hasText: CHORE_NAME })
await card.waitFor({ state: 'visible' })
await expect(card.getByText('COMPLETED')).toBeVisible()
})
test('Clicking a completed chore does not open confirmation', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = choreSection(page).locator('.item-card').filter({ hasText: CHORE_NAME })
await card.waitFor({ state: 'visible' })
const before = await getPoints(page)
// Two-click completed chore
await card.click()
await expect(card).toHaveClass(/item-ready/, { timeout: 3000 })
await card.click()
// No confirmation dialog should appear; points must remain unchanged
await expect(page.locator('.points .value')).toHaveText(String(before))
await expect(page.getByRole('button', { name: 'Yes' })).not.toBeVisible()
})
})

View File

@@ -0,0 +1,149 @@
// spec: e2e/plans/task-activated.plan.md
import { test, expect, type APIRequestContext, type Locator, type Page } from '@playwright/test'
const CHILD_NAME = 'ActivateKindnessChild'
const KIND_NAME = 'TriggerTestKindness'
const KIND_HELPER_NAME = 'TriggerKindnessHelper'
const KIND_POINTS = 5
async function createChild(request: APIRequestContext, name: string): Promise<string> {
const pre = await request.get('/api/child/list')
for (const c of (await pre.json()).children ?? []) {
if (c.name === name) await request.delete(`/api/child/${c.id}`)
}
await request.put('/api/child/add', { data: { name, age: 8 } })
const list = await request.get('/api/child/list')
return (await list.json()).children?.find((c: any) => c.name === name)?.id ?? ''
}
async function createTask(
request: APIRequestContext,
name: string,
type: 'chore' | 'kindness' | 'penalty',
points: number,
): Promise<string> {
const pre = await request.get('/api/task/list')
for (const t of (await pre.json()).tasks ?? []) {
if (t.name === name) await request.delete(`/api/task/${t.id}`)
}
await request.put('/api/task/add', { data: { name, points, type } })
const list = await request.get('/api/task/list')
return (await list.json()).tasks?.find((t: any) => t.name === name)?.id ?? ''
}
async function getPoints(page: Page): Promise<number> {
const text = await page.locator('.points .value').textContent()
return parseInt(text?.trim() ?? '0', 10)
}
async function activateItem(itemCard: Locator): Promise<void> {
await itemCard.click()
await expect(itemCard).toHaveClass(/item-ready/, { timeout: 3000 })
await itemCard.click()
}
function kindnessSection(page: Page): Locator {
return page.locator('.child-list-container').filter({
has: page.locator('h3', { hasText: 'Kindness Acts' }),
})
}
test.describe('Kindness act activation', () => {
test.describe.configure({ mode: 'serial' })
let childId = ''
let kindId = ''
let kindHelperId = ''
test.beforeAll(async ({ request }) => {
childId = await createChild(request, CHILD_NAME)
kindId = await createTask(request, KIND_NAME, 'kindness', KIND_POINTS)
kindHelperId = await createTask(request, KIND_HELPER_NAME, 'kindness', KIND_POINTS)
await request.put(`/api/child/${childId}/set-tasks`, {
data: { task_ids: [kindId, kindHelperId], type: 'kindness' },
})
})
test.afterAll(async ({ request }) => {
if (childId) await request.delete(`/api/child/${childId}`)
if (kindId) await request.delete(`/api/task/${kindId}`)
if (kindHelperId) await request.delete(`/api/task/${kindHelperId}`)
})
test('Edit button appears on first kindness act click', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = kindnessSection(page).locator('.item-card').filter({ hasText: KIND_NAME })
await card.waitFor({ state: 'visible' })
// Initially hidden
await expect(card.getByTitle('Edit custom value')).not.toBeVisible()
// First click: item enters ready state, edit button becomes visible
await card.click()
await expect(card).toHaveClass(/item-ready/, { timeout: 3000 })
await expect(card.getByTitle('Edit custom value')).toBeVisible()
})
test('Edit button disappears when clicking a different kindness card', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const section = kindnessSection(page)
const card = section.locator('.item-card').filter({ hasText: KIND_NAME })
const helperCard = section.locator('.item-card').filter({ hasText: KIND_HELPER_NAME })
await card.waitFor({ state: 'visible' })
await helperCard.waitFor({ state: 'visible' })
// First click on target card — edit button appears
await card.click()
await expect(card).toHaveClass(/item-ready/, { timeout: 3000 })
await expect(card.getByTitle('Edit custom value')).toBeVisible()
// Click on a different card — target's edit button disappears
await helperCard.click()
await expect(card.getByTitle('Edit custom value')).not.toBeVisible()
})
test('Cancel kindness act confirmation — no points awarded', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = kindnessSection(page).locator('.item-card').filter({ hasText: KIND_NAME })
await card.waitFor({ state: 'visible' })
const before = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'Yes' })).toBeVisible()
await page.getByRole('button', { name: 'Cancel' }).click()
await expect(page.getByRole('button', { name: 'Yes' })).not.toBeVisible()
await expect(page.locator('.points .value')).toHaveText(String(before))
})
test('Confirm kindness act activation — points awarded', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = kindnessSection(page).locator('.item-card').filter({ hasText: KIND_NAME })
await card.waitFor({ state: 'visible' })
const before = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'Yes' })).toBeVisible()
await page.getByRole('button', { name: 'Yes' }).click()
await expect(page.locator('.points .value')).toHaveText(String(before + KIND_POINTS))
})
test('Kindness act can be activated a second time — points awarded again', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = kindnessSection(page).locator('.item-card').filter({ hasText: KIND_NAME })
await card.waitFor({ state: 'visible' })
const before = await getPoints(page)
// Second activation of the same kindness act
await activateItem(card)
await expect(page.getByRole('button', { name: 'Yes' })).toBeVisible()
await page.getByRole('button', { name: 'Yes' }).click()
await expect(page.locator('.points .value')).toHaveText(String(before + KIND_POINTS))
})
})

View File

@@ -0,0 +1,173 @@
// spec: e2e/plans/task-activated.plan.md
import { test, expect, type APIRequestContext, type Locator, type Page } from '@playwright/test'
const CHILD_NAME = 'ActivatePenaltyChild'
const PEN_NAME = 'TriggerTestPenalty'
const PEN_HELPER_NAME = 'TriggerPenaltyHelper'
const PEN_POINTS = 20
const INITIAL_POINTS = 50
async function createChild(
request: APIRequestContext,
name: string,
points: number,
): Promise<string> {
const pre = await request.get('/api/child/list')
for (const c of (await pre.json()).children ?? []) {
if (c.name === name) await request.delete(`/api/child/${c.id}`)
}
await request.put('/api/child/add', { data: { name, age: 8 } })
const list = await request.get('/api/child/list')
const id = (await list.json()).children?.find((c: any) => c.name === name)?.id ?? ''
if (points > 0) await request.put(`/api/child/${id}/edit`, { data: { points } })
return id
}
async function createTask(
request: APIRequestContext,
name: string,
type: 'chore' | 'kindness' | 'penalty',
points: number,
): Promise<string> {
const pre = await request.get('/api/task/list')
for (const t of (await pre.json()).tasks ?? []) {
if (t.name === name) await request.delete(`/api/task/${t.id}`)
}
await request.put('/api/task/add', { data: { name, points, type } })
const list = await request.get('/api/task/list')
return (await list.json()).tasks?.find((t: any) => t.name === name)?.id ?? ''
}
async function getPoints(page: Page): Promise<number> {
const text = await page.locator('.points .value').textContent()
return parseInt(text?.trim() ?? '0', 10)
}
async function activateItem(itemCard: Locator): Promise<void> {
await itemCard.click()
await expect(itemCard).toHaveClass(/item-ready/, { timeout: 3000 })
await itemCard.click()
}
function penaltySection(page: Page): Locator {
return page.locator('.child-list-container').filter({
has: page.locator('h3', { hasText: 'Penalties' }),
})
}
test.describe('Penalty activation', () => {
test.describe.configure({ mode: 'serial' })
let childId = ''
let penId = ''
let penHelperId = ''
test.beforeAll(async ({ request }) => {
childId = await createChild(request, CHILD_NAME, INITIAL_POINTS)
penId = await createTask(request, PEN_NAME, 'penalty', PEN_POINTS)
penHelperId = await createTask(request, PEN_HELPER_NAME, 'penalty', PEN_POINTS)
await request.put(`/api/child/${childId}/set-tasks`, {
data: { task_ids: [penId, penHelperId], type: 'penalty' },
})
})
test.afterAll(async ({ request }) => {
if (childId) await request.delete(`/api/child/${childId}`)
if (penId) await request.delete(`/api/task/${penId}`)
if (penHelperId) await request.delete(`/api/task/${penHelperId}`)
})
test('Edit button appears on first penalty click', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = penaltySection(page).locator('.item-card').filter({ hasText: PEN_NAME })
await card.waitFor({ state: 'visible' })
// Initially hidden
await expect(card.getByTitle('Edit custom value')).not.toBeVisible()
// First click: item enters ready state, edit button becomes visible
await card.click()
await expect(card).toHaveClass(/item-ready/, { timeout: 3000 })
await expect(card.getByTitle('Edit custom value')).toBeVisible()
})
test('Edit button disappears when clicking a different penalty card', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const section = penaltySection(page)
const card = section.locator('.item-card').filter({ hasText: PEN_NAME })
const helperCard = section.locator('.item-card').filter({ hasText: PEN_HELPER_NAME })
await card.waitFor({ state: 'visible' })
await helperCard.waitFor({ state: 'visible' })
// First click on target card — edit button appears
await card.click()
await expect(card).toHaveClass(/item-ready/, { timeout: 3000 })
await expect(card.getByTitle('Edit custom value')).toBeVisible()
// Click on a different card — target's edit button disappears
await helperCard.click()
await expect(card.getByTitle('Edit custom value')).not.toBeVisible()
})
test('Cancel penalty confirmation — no points deducted', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = penaltySection(page).locator('.item-card').filter({ hasText: PEN_NAME })
await card.waitFor({ state: 'visible' })
const before = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'Yes' })).toBeVisible()
await page.getByRole('button', { name: 'Cancel' }).click()
await expect(page.getByRole('button', { name: 'Yes' })).not.toBeVisible()
await expect(page.locator('.points .value')).toHaveText(String(before))
})
test('Confirm penalty activation — points deducted', async ({ page }) => {
// Starts at INITIAL_POINTS (50)
await page.goto(`/parent/${childId}`)
const card = penaltySection(page).locator('.item-card').filter({ hasText: PEN_NAME })
await card.waitFor({ state: 'visible' })
const before = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'Yes' })).toBeVisible()
await page.getByRole('button', { name: 'Yes' }).click()
// 50 - 20 = 30
await expect(page.locator('.points .value')).toHaveText(String(before - PEN_POINTS))
})
test('Penalty can be activated multiple times — points deducted again', async ({ page }) => {
// Starts at 30 after previous test
await page.goto(`/parent/${childId}`)
const card = penaltySection(page).locator('.item-card').filter({ hasText: PEN_NAME })
await card.waitFor({ state: 'visible' })
const before = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'Yes' })).toBeVisible()
await page.getByRole('button', { name: 'Yes' }).click()
// 30 - 20 = 10
await expect(page.locator('.points .value')).toHaveText(String(before - PEN_POINTS))
})
test('Points floor at 0 — penalty cannot make points negative', async ({ page }) => {
// Starts at 10 after previous test; penalty is 20 pts
await page.goto(`/parent/${childId}`)
const card = penaltySection(page).locator('.item-card').filter({ hasText: PEN_NAME })
await card.waitFor({ state: 'visible' })
await activateItem(card)
await expect(page.getByRole('button', { name: 'Yes' })).toBeVisible()
await page.getByRole('button', { name: 'Yes' }).click()
// 10 - 20 would be -10; app floors at 0
await expect(page.locator('.points .value')).toHaveText('0')
})
})

View File

@@ -0,0 +1,359 @@
// spec: e2e/plans/task-activated.plan.md
// Tests for the "pending reward warning" dialog that appears when the parent tries to
// activate a chore, kindness act, penalty, or a different reward while one of the child's
// reward requests is in a pending state.
import { test, expect, type APIRequestContext, type Locator, type Page } from '@playwright/test'
const CHILD_NAME = 'PendingRewardWarnChild'
const CHORE_NAME = 'PendingWarnChore'
const KIND_NAME = 'PendingWarnKindness'
const PEN_NAME = 'PendingWarnPenalty'
const PENDING_REWARD_NAME = 'PendingWarnReward'
const OTHER_REWARD_NAME = 'PendingWarnOtherReward'
const REWARD_COST = 10
const CHORE_POINTS = 5
const KIND_POINTS = 5
const PEN_POINTS = 5
const INITIAL_POINTS = 30 // must be >= REWARD_COST so the request-reward call succeeds
// ── helpers ───────────────────────────────────────────────────────────────────
async function createChild(
request: APIRequestContext,
name: string,
points: number,
): Promise<string> {
const pre = await request.get('/api/child/list')
for (const c of (await pre.json()).children ?? []) {
if (c.name === name) await request.delete(`/api/child/${c.id}`)
}
await request.put('/api/child/add', { data: { name, age: 8 } })
const list = await request.get('/api/child/list')
const id = (await list.json()).children?.find((c: any) => c.name === name)?.id ?? ''
if (points > 0) await request.put(`/api/child/${id}/edit`, { data: { points } })
return id
}
async function createTask(
request: APIRequestContext,
name: string,
type: 'chore' | 'kindness' | 'penalty',
points: number,
): Promise<string> {
const pre = await request.get('/api/task/list')
for (const t of (await pre.json()).tasks ?? []) {
if (t.name === name) await request.delete(`/api/task/${t.id}`)
}
await request.put('/api/task/add', { data: { name, points, type } })
const list = await request.get('/api/task/list')
return (await list.json()).tasks?.find((t: any) => t.name === name)?.id ?? ''
}
async function createReward(
request: APIRequestContext,
name: string,
cost: number,
): Promise<string> {
const pre = await request.get('/api/reward/list')
for (const r of (await pre.json()).rewards ?? []) {
if (r.name === name) await request.delete(`/api/reward/${r.id}`)
}
await request.put('/api/reward/add', { data: { name, description: 'E2E pending-warn test', cost } })
const list = await request.get('/api/reward/list')
return (await list.json()).rewards?.find((r: any) => r.name === name)?.id ?? ''
}
async function getPoints(page: Page): Promise<number> {
const text = await page.locator('.points .value').textContent()
return parseInt(text?.trim() ?? '0', 10)
}
async function activateItem(itemCard: Locator): Promise<void> {
await itemCard.click()
await expect(itemCard).toHaveClass(/item-ready/, { timeout: 3000 })
await itemCard.click()
}
function choreSection(page: Page): Locator {
return page.locator('.child-list-container').filter({
has: page.locator('h3', { hasText: 'Chores' }),
})
}
function kindnessSection(page: Page): Locator {
return page.locator('.child-list-container').filter({
has: page.locator('h3', { hasText: 'Kindness Acts' }),
})
}
function penaltySection(page: Page): Locator {
return page.locator('.child-list-container').filter({
has: page.locator('h3', { hasText: 'Penalties' }),
})
}
function rewardSection(page: Page): Locator {
return page.locator('.child-list-container').filter({
has: page.locator('h3', { hasText: 'Rewards' }),
})
}
// ── suite ─────────────────────────────────────────────────────────────────────
test.describe('Pending reward warning dialog', () => {
test.describe.configure({ mode: 'serial' })
let childId = ''
let choreId = ''
let kindId = ''
let penId = ''
let pendingRewardId = ''
let otherRewardId = ''
test.beforeAll(async ({ request }) => {
childId = await createChild(request, CHILD_NAME, INITIAL_POINTS)
choreId = await createTask(request, CHORE_NAME, 'chore', CHORE_POINTS)
kindId = await createTask(request, KIND_NAME, 'kindness', KIND_POINTS)
penId = await createTask(request, PEN_NAME, 'penalty', PEN_POINTS)
pendingRewardId = await createReward(request, PENDING_REWARD_NAME, REWARD_COST)
otherRewardId = await createReward(request, OTHER_REWARD_NAME, REWARD_COST)
await request.put(`/api/child/${childId}/set-tasks`, {
data: { task_ids: [choreId], type: 'chore' },
})
await request.put(`/api/child/${childId}/set-tasks`, {
data: { task_ids: [kindId], type: 'kindness' },
})
await request.put(`/api/child/${childId}/set-tasks`, {
data: { task_ids: [penId], type: 'penalty' },
})
await request.put(`/api/child/${childId}/set-rewards`, {
data: { reward_ids: [pendingRewardId, otherRewardId] },
})
})
test.afterAll(async ({ request }) => {
if (childId) await request.delete(`/api/child/${childId}`)
if (choreId) await request.delete(`/api/task/${choreId}`)
if (kindId) await request.delete(`/api/task/${kindId}`)
if (penId) await request.delete(`/api/task/${penId}`)
if (pendingRewardId) await request.delete(`/api/reward/${pendingRewardId}`)
if (otherRewardId) await request.delete(`/api/reward/${otherRewardId}`)
})
// Ensure each test starts with the pending reward freshly requested
test.beforeEach(async ({ request }) => {
// Reset child points so the request-reward call always succeeds
await request.put(`/api/child/${childId}/edit`, { data: { points: INITIAL_POINTS } })
// Cancel any leftover request (404 if none — ignored)
await request.post(`/api/child/${childId}/cancel-request-reward`, {
data: { reward_id: pendingRewardId },
})
// Place a fresh pending request
await request.post(`/api/child/${childId}/request-reward`, {
data: { reward_id: pendingRewardId },
})
})
// ── banner ────────────────────────────────────────────────────────────────
test('Pending reward card shows PENDING banner', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = rewardSection(page)
.locator('.item-card')
.filter({ hasText: PENDING_REWARD_NAME })
await card.waitFor({ state: 'visible' })
await expect(card.locator('.pending')).toHaveText('PENDING')
})
// ── chore ─────────────────────────────────────────────────────────────────
test('Chore activation — Cancel on pending dialog leaves state unchanged', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = choreSection(page).locator('.item-card').filter({ hasText: CHORE_NAME })
await card.waitFor({ state: 'visible' })
const pointsBefore = await getPoints(page)
await activateItem(card)
// Pending reward warning dialog appears (has a "No" button)
await expect(page.getByRole('button', { name: 'No', exact: true })).toBeVisible()
await page.getByRole('button', { name: 'No', exact: true }).click()
// Dialog dismissed; task confirmation dialog must NOT have appeared
await expect(page.getByRole('button', { name: 'No', exact: true })).not.toBeVisible()
await expect(page.getByRole('button', { name: 'Cancel' })).not.toBeVisible()
// Points unchanged
await expect(page.locator('.points .value')).toHaveText(String(pointsBefore))
// PENDING banner still visible on the reward card
const rewardCard = rewardSection(page)
.locator('.item-card')
.filter({ hasText: PENDING_REWARD_NAME })
await expect(rewardCard.locator('.pending')).toHaveText('PENDING')
})
test('Chore activation — Confirm on pending dialog cancels pending reward and triggers chore', async ({
page,
}) => {
await page.goto(`/parent/${childId}`)
const card = choreSection(page).locator('.item-card').filter({ hasText: CHORE_NAME })
await card.waitFor({ state: 'visible' })
const pointsBefore = await getPoints(page)
await activateItem(card)
// Pending reward warning dialog
await expect(page.getByRole('button', { name: 'No', exact: true })).toBeVisible()
await page.getByRole('button', { name: 'Yes' }).click()
// After confirming, the task confirmation dialog appears (has "Cancel" button)
await expect(page.getByRole('button', { name: 'Cancel' })).toBeVisible({ timeout: 3000 })
await page.getByRole('button', { name: 'Yes' }).click()
// Chore points awarded — points changed from initial value
await expect(page.locator('.points .value')).not.toHaveText(String(pointsBefore), {
timeout: 3000,
})
})
// ── kindness ──────────────────────────────────────────────────────────────
test('Kindness activation — Cancel on pending dialog leaves state unchanged', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = kindnessSection(page).locator('.item-card').filter({ hasText: KIND_NAME })
await card.waitFor({ state: 'visible' })
const pointsBefore = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'No', exact: true })).toBeVisible()
await page.getByRole('button', { name: 'No', exact: true }).click()
await expect(page.getByRole('button', { name: 'No', exact: true })).not.toBeVisible()
await expect(page.getByRole('button', { name: 'Cancel' })).not.toBeVisible()
await expect(page.locator('.points .value')).toHaveText(String(pointsBefore))
})
test('Kindness activation — Confirm on pending dialog cancels pending reward and triggers kindness', async ({
page,
}) => {
await page.goto(`/parent/${childId}`)
const card = kindnessSection(page).locator('.item-card').filter({ hasText: KIND_NAME })
await card.waitFor({ state: 'visible' })
const pointsBefore = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'No', exact: true })).toBeVisible()
await page.getByRole('button', { name: 'Yes' }).click()
await expect(page.getByRole('button', { name: 'Cancel' })).toBeVisible({ timeout: 3000 })
await page.getByRole('button', { name: 'Yes' }).click()
await expect(page.locator('.points .value')).not.toHaveText(String(pointsBefore), {
timeout: 3000,
})
})
// ── penalty ───────────────────────────────────────────────────────────────
test('Penalty activation — Cancel on pending dialog leaves state unchanged', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = penaltySection(page).locator('.item-card').filter({ hasText: PEN_NAME })
await card.waitFor({ state: 'visible' })
const pointsBefore = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'No', exact: true })).toBeVisible()
await page.getByRole('button', { name: 'No', exact: true }).click()
await expect(page.getByRole('button', { name: 'No', exact: true })).not.toBeVisible()
await expect(page.getByRole('button', { name: 'Cancel' })).not.toBeVisible()
await expect(page.locator('.points .value')).toHaveText(String(pointsBefore))
})
test('Penalty activation — Confirm on pending dialog cancels pending reward and triggers penalty', async ({
page,
}) => {
await page.goto(`/parent/${childId}`)
const card = penaltySection(page).locator('.item-card').filter({ hasText: PEN_NAME })
await card.waitFor({ state: 'visible' })
const pointsBefore = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'No', exact: true })).toBeVisible()
await page.getByRole('button', { name: 'Yes' }).click()
await expect(page.getByRole('button', { name: 'Cancel' })).toBeVisible({ timeout: 3000 })
await page.getByRole('button', { name: 'Yes' }).click()
// Penalty deducted points
await expect(page.locator('.points .value')).not.toHaveText(String(pointsBefore), {
timeout: 3000,
})
})
// ── other reward ──────────────────────────────────────────────────────────
test('Other reward activation — Cancel on pending dialog leaves state unchanged', async ({
page,
}) => {
await page.goto(`/parent/${childId}`)
// Both rewards should be ready (INITIAL_POINTS >= REWARD_COST)
const pendingCard = rewardSection(page)
.locator('.item-card')
.filter({ hasText: PENDING_REWARD_NAME })
const otherCard = rewardSection(page)
.locator('.item-card')
.filter({ hasText: OTHER_REWARD_NAME })
await pendingCard.waitFor({ state: 'visible' })
await otherCard.waitFor({ state: 'visible' })
await expect(pendingCard.locator('.pending')).toHaveText('PENDING')
await expect(otherCard.getByText('REWARD READY')).toBeVisible()
const pointsBefore = await getPoints(page)
await activateItem(otherCard)
// Pending reward warning dialog appears when another reward has a pending request
await expect(page.getByRole('button', { name: 'No', exact: true })).toBeVisible()
await page.getByRole('button', { name: 'No', exact: true }).click()
await expect(page.getByRole('button', { name: 'No', exact: true })).not.toBeVisible()
await expect(page.getByRole('button', { name: 'Cancel' })).not.toBeVisible()
await expect(page.locator('.points .value')).toHaveText(String(pointsBefore))
// PENDING banner still visible — reward request was not cancelled
await expect(pendingCard.locator('.pending')).toHaveText('PENDING')
})
test('Other reward activation — Confirm on pending dialog cancels the pending reward', async ({
page,
}) => {
await page.goto(`/parent/${childId}`)
const pendingCard = rewardSection(page)
.locator('.item-card')
.filter({ hasText: PENDING_REWARD_NAME })
const otherCard = rewardSection(page)
.locator('.item-card')
.filter({ hasText: OTHER_REWARD_NAME })
await pendingCard.waitFor({ state: 'visible' })
await otherCard.waitFor({ state: 'visible' })
await activateItem(otherCard)
await expect(page.getByRole('button', { name: 'No', exact: true })).toBeVisible()
await page.getByRole('button', { name: 'Yes' }).click()
// Pending dialog closes; reward confirm does NOT auto-open (other reward must be re-clicked)
await expect(page.getByRole('button', { name: 'No', exact: true })).not.toBeVisible()
await expect(page.getByRole('button', { name: 'Cancel' })).not.toBeVisible()
// The pending reward request was cancelled — PENDING banner should disappear
await expect(pendingCard.locator('.pending')).not.toBeVisible({ timeout: 5000 })
})
})

View File

@@ -0,0 +1,181 @@
// spec: e2e/plans/task-activated.plan.md
import { test, expect, type APIRequestContext, type Locator, type Page } from '@playwright/test'
const CHILD_NAME = 'ActivateRewardChild'
const REWARD_NAME = 'TriggerTestReward'
const REWARD_HELPER_NAME = 'TriggerRewardHelper'
const REWARD_COST = 20
async function createChild(request: APIRequestContext, name: string): Promise<string> {
const pre = await request.get('/api/child/list')
for (const c of (await pre.json()).children ?? []) {
if (c.name === name) await request.delete(`/api/child/${c.id}`)
}
await request.put('/api/child/add', { data: { name, age: 8 } })
const list = await request.get('/api/child/list')
return (await list.json()).children?.find((c: any) => c.name === name)?.id ?? ''
}
async function createReward(
request: APIRequestContext,
name: string,
cost: number,
): Promise<string> {
const pre = await request.get('/api/reward/list')
for (const r of (await pre.json()).rewards ?? []) {
if (r.name === name) await request.delete(`/api/reward/${r.id}`)
}
await request.put('/api/reward/add', { data: { name, description: 'E2E test reward', cost } })
const list = await request.get('/api/reward/list')
return (await list.json()).rewards?.find((r: any) => r.name === name)?.id ?? ''
}
async function getPoints(page: Page): Promise<number> {
const text = await page.locator('.points .value').textContent()
return parseInt(text?.trim() ?? '0', 10)
}
async function activateItem(itemCard: Locator): Promise<void> {
await itemCard.click()
await expect(itemCard).toHaveClass(/item-ready/, { timeout: 3000 })
await itemCard.click()
}
function rewardSection(page: Page): Locator {
return page.locator('.child-list-container').filter({
has: page.locator('h3', { hasText: 'Rewards' }),
})
}
test.describe('Reward redemption', () => {
test.describe.configure({ mode: 'serial' })
let childId = ''
let rewardId = ''
let rewardHelperId = ''
test.beforeAll(async ({ request }) => {
childId = await createChild(request, CHILD_NAME)
rewardId = await createReward(request, REWARD_NAME, REWARD_COST)
rewardHelperId = await createReward(request, REWARD_HELPER_NAME, REWARD_COST)
await request.put(`/api/child/${childId}/set-rewards`, {
data: { reward_ids: [rewardId, rewardHelperId] },
})
})
test.afterAll(async ({ request }) => {
if (childId) await request.delete(`/api/child/${childId}`)
if (rewardId) await request.delete(`/api/reward/${rewardId}`)
if (rewardHelperId) await request.delete(`/api/reward/${rewardHelperId}`)
})
test('Locked reward shows correct points needed text', async ({ page }) => {
// Child starts at 0 pts; reward costs 20 → "20 more points"
await page.goto(`/parent/${childId}`)
const card = rewardSection(page).locator('.item-card').filter({ hasText: REWARD_NAME })
await card.waitFor({ state: 'visible' })
await expect(card.getByText(`${REWARD_COST} more points`)).toBeVisible()
await expect(card.getByText('REWARD READY')).not.toBeVisible()
})
test('Clicking a locked reward does not open confirmation dialog', async ({ page }) => {
await page.goto(`/parent/${childId}`)
const card = rewardSection(page).locator('.item-card').filter({ hasText: REWARD_NAME })
await card.waitFor({ state: 'visible' })
// Two-click on locked reward
await card.click()
await expect(card).toHaveClass(/item-ready/, { timeout: 3000 })
await card.click()
// triggerReward returns early when points_needed > 0 — no dialog
await expect(page.locator('.points .value')).toHaveText('0')
await expect(page.getByRole('button', { name: 'Yes' })).not.toBeVisible()
})
test('Reward shows REWARD READY when child has sufficient points', async ({ page, request }) => {
// Set child points to match reward cost
await request.put(`/api/child/${childId}/edit`, { data: { points: REWARD_COST } })
await page.goto(`/parent/${childId}`)
const card = rewardSection(page).locator('.item-card').filter({ hasText: REWARD_NAME })
await card.waitFor({ state: 'visible' })
await expect(card.getByText('REWARD READY')).toBeVisible()
await expect(card.getByText(/more points/)).not.toBeVisible()
})
test('Edit button appears on first click of a ready reward', async ({ page }) => {
// Child has REWARD_COST pts (set in previous test)
await page.goto(`/parent/${childId}`)
const card = rewardSection(page).locator('.item-card').filter({ hasText: REWARD_NAME })
await card.waitFor({ state: 'visible' })
// Initially hidden
await expect(card.getByTitle('Edit custom value')).not.toBeVisible()
// First click: item enters ready state, edit button becomes visible
await card.click()
await expect(card).toHaveClass(/item-ready/, { timeout: 3000 })
await expect(card.getByTitle('Edit custom value')).toBeVisible()
})
test('Edit button disappears when clicking a different reward card', async ({ page }) => {
// Child has REWARD_COST pts (set in previous test); both rewards show REWARD READY
await page.goto(`/parent/${childId}`)
const section = rewardSection(page)
const card = section.locator('.item-card').filter({ hasText: REWARD_NAME })
const helperCard = section.locator('.item-card').filter({ hasText: REWARD_HELPER_NAME })
await card.waitFor({ state: 'visible' })
await helperCard.waitFor({ state: 'visible' })
// First click on target card — edit button appears
await card.click()
await expect(card).toHaveClass(/item-ready/, { timeout: 3000 })
await expect(card.getByTitle('Edit custom value')).toBeVisible()
// Click on a different reward card — target's edit button disappears
await helperCard.click()
await expect(card.getByTitle('Edit custom value')).not.toBeVisible()
})
test('Cancel reward redemption — points not deducted', async ({ page }) => {
// Child has REWARD_COST pts (from two tests ago; edit button test did not consume them)
await page.goto(`/parent/${childId}`)
const card = rewardSection(page).locator('.item-card').filter({ hasText: REWARD_NAME })
await card.waitFor({ state: 'visible' })
await expect(card.getByText('REWARD READY')).toBeVisible()
const before = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'Yes' })).toBeVisible()
await page.getByRole('button', { name: 'Cancel' }).click()
await expect(page.getByRole('button', { name: 'Yes' })).not.toBeVisible()
await expect(page.locator('.points .value')).toHaveText(String(before))
await expect(card.getByText('REWARD READY')).toBeVisible()
})
test('Confirm reward redemption — points deducted and reward locks again', async ({ page }) => {
// Child still has REWARD_COST pts after the cancelled redemption
await page.goto(`/parent/${childId}`)
const card = rewardSection(page).locator('.item-card').filter({ hasText: REWARD_NAME })
await card.waitFor({ state: 'visible' })
await expect(card.getByText('REWARD READY')).toBeVisible()
const before = await getPoints(page)
await activateItem(card)
await expect(page.getByRole('button', { name: 'Yes' })).toBeVisible()
await page.getByRole('button', { name: 'Yes' }).click()
// Points reduced by reward cost
await expect(page.locator('.points .value')).toHaveText(String(before - REWARD_COST))
// Reward is now locked again — shows points needed
await expect(card.getByText(`${REWARD_COST} more points`)).toBeVisible()
await expect(card.getByText('REWARD READY')).not.toBeVisible()
})
})

View File

@@ -0,0 +1,194 @@
// spec: e2e/plans/task-activated.plan.md
// Tests for scrollable list flow and first-click scroll-to-center behavior.
// 8 kindness items are assigned to a dedicated child so the list overflows
// a narrow (480 px) viewport, reliably exercising the horizontal scroll path.
import { test, expect, type APIRequestContext, type Locator } from '@playwright/test'
/**
* Returns true if the element's bounding rect overlaps the current page viewport.
* Uses getBoundingClientRect() — reliable across all Playwright versions and
* correctly handles elements clipped by overflow scroll containers.
*/
async function isInViewport(locator: Locator): Promise<boolean> {
return locator.evaluate((el) => {
const rect = el.getBoundingClientRect()
return (
rect.bottom > 0 &&
rect.right > 0 &&
rect.top < (window.innerHeight || document.documentElement.clientHeight) &&
rect.left < (window.innerWidth || document.documentElement.clientWidth)
)
})
}
const CHILD_NAME = 'ScrollFlowChild'
const ITEM_COUNT = 8
const ITEM_NAMES = Array.from({ length: ITEM_COUNT }, (_, i) => `ScrollTestKindness${i + 1}`)
const NARROW_VIEWPORT = { width: 480, height: 800 }
// ── helpers ───────────────────────────────────────────────────────────────────
async function createChild(request: APIRequestContext, name: string): Promise<string> {
const pre = await request.get('/api/child/list')
for (const c of (await pre.json()).children ?? []) {
if (c.name === name) await request.delete(`/api/child/${c.id}`)
}
await request.put('/api/child/add', { data: { name, age: 8 } })
const list = await request.get('/api/child/list')
return (await list.json()).children?.find((c: any) => c.name === name)?.id ?? ''
}
async function createTask(request: APIRequestContext, name: string): Promise<string> {
const pre = await request.get('/api/task/list')
for (const t of (await pre.json()).tasks ?? []) {
if (t.name === name) await request.delete(`/api/task/${t.id}`)
}
await request.put('/api/task/add', { data: { name, points: 5, type: 'kindness' } })
const list = await request.get('/api/task/list')
return (await list.json()).tasks?.find((t: any) => t.name === name)?.id ?? ''
}
// ── tests ─────────────────────────────────────────────────────────────────────
test.describe('Scroll and flow', () => {
test.describe.configure({ mode: 'serial' })
let childId = ''
const taskIds: string[] = []
test.beforeAll(async ({ request }) => {
childId = await createChild(request, CHILD_NAME)
for (const name of ITEM_NAMES) {
taskIds.push(await createTask(request, name))
}
await request.put(`/api/child/${childId}/set-tasks`, {
data: { task_ids: taskIds, type: 'kindness' },
})
})
test.afterAll(async ({ request }) => {
if (childId) await request.delete(`/api/child/${childId}`)
for (const id of taskIds) await request.delete(`/api/task/${id}`)
taskIds.length = 0
})
test('Kindness list is horizontally scrollable when many items are assigned', async ({
page,
}) => {
await page.setViewportSize(NARROW_VIEWPORT)
await page.goto(`/parent/${childId}`)
const scrollWrapper = page
.locator('.child-list-container')
.filter({ has: page.locator('h3', { hasText: 'Kindness Acts' }) })
.locator('.scroll-wrapper')
await scrollWrapper.waitFor({ state: 'visible' })
// Total content width (8 × 140 px + 7 × 12 px gaps ≈ 1204 px) must exceed container width
const isOverflowing = await scrollWrapper.evaluate(
(el: HTMLElement) => el.scrollWidth > el.clientWidth,
)
expect(isOverflowing).toBe(true)
// The last card in DOM order is outside the 480 px viewport at scrollLeft=0
const section = page
.locator('.child-list-container')
.filter({ has: page.locator('h3', { hasText: 'Kindness Acts' }) })
const lastCard = section.locator('.item-card').last()
expect(await isInViewport(lastCard)).toBe(false)
})
test('Scrolling the list reveals hidden items', async ({ page }) => {
await page.setViewportSize(NARROW_VIEWPORT)
await page.goto(`/parent/${childId}`)
const section = page
.locator('.child-list-container')
.filter({ has: page.locator('h3', { hasText: 'Kindness Acts' }) })
const scrollWrapper = section.locator('.scroll-wrapper')
await scrollWrapper.waitFor({ state: 'visible' })
// Use DOM-order first/last — independent of API return order
const firstCard = section.locator('.item-card').first()
const lastCard = section.locator('.item-card').last()
// Initially: first item is in viewport, last item is scrolled off to the right
expect(await isInViewport(firstCard)).toBe(true)
expect(await isInViewport(lastCard)).toBe(false)
// Programmatically scroll to the end — override smooth-scroll so position is immediate
await scrollWrapper.evaluate((el: HTMLElement) => {
el.style.scrollBehavior = 'auto'
el.scrollLeft = el.scrollWidth
})
await page.waitForTimeout(100)
// Last item is now visible; first item has scrolled off to the left
expect(await isInViewport(lastCard)).toBe(true)
expect(await isInViewport(firstCard)).toBe(false)
})
test('First click on an off-screen item scrolls it into view and marks it ready', async ({
page,
}) => {
await page.setViewportSize(NARROW_VIEWPORT)
await page.goto(`/parent/${childId}`)
const section = page
.locator('.child-list-container')
.filter({ has: page.locator('h3', { hasText: 'Kindness Acts' }) })
const scrollWrapper = section.locator('.scroll-wrapper')
await scrollWrapper.waitFor({ state: 'visible' })
// The last item in DOM order is definitely off-screen at scrollLeft=0 on a 480 px viewport
const lastCard = section.locator('.item-card').last()
expect(await isInViewport(lastCard)).toBe(false)
// force: true is required because the element's bounding-box center is outside
// the page viewport — that is exactly the condition we are testing (scroll-to-center).
await lastCard.click({ force: true })
// The first-click handler runs centerItem() then emits item-ready
await expect(lastCard).toHaveClass(/item-ready/, { timeout: 5000 })
// Wait for the smooth-scroll animation to settle
await page.waitForTimeout(800)
// After centering, the item must be visible within the 480 px viewport
expect(await isInViewport(lastCard)).toBe(true)
})
test('Scrolling does not prevent first-click centering on a partially visible item', async ({
page,
}) => {
await page.setViewportSize(NARROW_VIEWPORT)
await page.goto(`/parent/${childId}`)
const section = page
.locator('.child-list-container')
.filter({ has: page.locator('h3', { hasText: 'Kindness Acts' }) })
const scrollWrapper = section.locator('.scroll-wrapper')
await scrollWrapper.waitFor({ state: 'visible' })
// Scroll to the middle — override smooth-scroll so position is immediate
await scrollWrapper.evaluate((el: HTMLElement) => {
el.style.scrollBehavior = 'auto'
el.scrollLeft = Math.floor(el.scrollWidth / 2)
})
await page.waitForTimeout(100)
// The first item in DOM order is now off-screen to the left after scrolling to the middle
const firstCard = section.locator('.item-card').first()
expect(await isInViewport(firstCard)).toBe(false)
// Click the first item (force: true because its center is left of the viewport)
await firstCard.click({ force: true })
await expect(firstCard).toHaveClass(/item-ready/, { timeout: 5000 })
await page.waitForTimeout(800)
// First item should now be centered and in the viewport
expect(await isInViewport(firstCard)).toBe(true)
})
})