AzuTear
137 lines
4.6 KiB
Markdown
137 lines
4.6 KiB
Markdown
# End-To-End Smoke Standard
|
|
|
|
This checklist defines the repeatable smoke path for the core awards workflow.
|
|
It complements the build checks in `docs/workflow.md` and should be used after
|
|
changes to nominations, categories, candidates, voting, winners, permissions,
|
|
or public landing-page workflow.
|
|
|
|
## Scope
|
|
|
|
Core workflow:
|
|
|
|
```text
|
|
Nomination -> Admin preparation -> Candidate -> Voting -> Winner preparation -> Winner/archive
|
|
```
|
|
|
|
Public nomination is grouped by main category (`Category.GroupName`). Voting and
|
|
winners stay on concrete subcategory `Category` rows.
|
|
|
|
## Automated Local Smoke
|
|
|
|
Run this against a local backend. If an admin session token is available, the
|
|
script also checks admin endpoints.
|
|
|
|
```bash
|
|
scripts/smoke-local.sh
|
|
ADMIN_SESSION_TOKEN=<token> scripts/smoke-local.sh
|
|
```
|
|
|
|
Expected local defaults:
|
|
|
|
- Backend: `http://127.0.0.1:5084`
|
|
- Frontend: `http://127.0.0.1:5173`
|
|
- Database: PostgreSQL on `localhost:5433`
|
|
|
|
The script checks:
|
|
|
|
- `/api/health`
|
|
- `/api/health/database`
|
|
- `/api/public/overview`
|
|
- current-season category structure
|
|
- legacy parent labels are not exposed by the public category endpoint
|
|
- optional admin season/team endpoints when `ADMIN_SESSION_TOKEN` is set
|
|
|
|
## Manual Browser Smoke
|
|
|
|
Use the local frontend with backend running as a pair.
|
|
|
|
### Public Nomination
|
|
|
|
- Open the public landing page.
|
|
- Start nomination.
|
|
- Confirm only main categories are selectable.
|
|
- Submit 1, 2, and 3 links in one main category.
|
|
- Confirm duplicate links in the same main category are blocked.
|
|
- Confirm empty categories can be skipped.
|
|
- Confirm Twitch links get tracker status when possible.
|
|
- Confirm non-Twitch links are accepted and need manual tier choice.
|
|
|
|
### Admin Review And Candidate Preparation
|
|
|
|
- Open `/admin/nominations`.
|
|
- Confirm nominations are grouped by main category and streamer identity.
|
|
- Confirm the tracker tier suggestion is visible when available.
|
|
- Promote a Twitch nomination using the suggested tier.
|
|
- Promote a non-Twitch nomination with manual tier override.
|
|
- Confirm candidate `NominationTally` reflects grouped nominations.
|
|
- Confirm candidate clip metadata requires a link when winner clip is mandatory.
|
|
|
|
### Voting
|
|
|
|
- Open the public voting modal.
|
|
- Confirm categories show as main category with subcategories.
|
|
- Switch category and subcategory without the modal jumping or resizing.
|
|
- Vote in at least one subcategory.
|
|
- Save vote again and confirm this is treated as vote editing.
|
|
- Confirm missing-vote warning appears before completion when applicable.
|
|
|
|
### Admin Voting Workspace
|
|
|
|
- Open `/admin/voting`.
|
|
- Confirm the page appears only for roles with `voting`, `analytics`, or
|
|
`winners` effective access.
|
|
- Confirm the tree groups by main category, with subcategories as children.
|
|
- Confirm leaderboard order defaults to most votes first.
|
|
- Confirm vote count, candidate count, open reviews, clip status, readiness,
|
|
ties or close races, and soft "few nominators" warnings are visible.
|
|
- Use quick links to candidates, nominations/review, and winners.
|
|
|
|
### Winners And Archive
|
|
|
|
- Open `/admin/winners`.
|
|
- Confirm it focuses on final winner assignment and landing-page release readiness.
|
|
- Set or clear a winner in a subcategory.
|
|
- Confirm `max. 1x winner` identity guard is visible/enforced.
|
|
- Confirm missing winner clip blocks or warns according to workflow settings.
|
|
- Confirm publishing is blocked while winners, reviews, or blocking workflow
|
|
rules are incomplete.
|
|
- Publish the year and confirm current winners appear on the landing page while
|
|
the previous landing-page winner year moves into the archive list.
|
|
- Confirm current landing-page winners are not listed as an archive year at the
|
|
same time.
|
|
- Open the public archive modal and confirm winner clip/video embeds render.
|
|
|
|
### Permissions
|
|
|
|
- Open `/admin/team`.
|
|
- Confirm permission catalog includes current admin pages:
|
|
Dashboard, Jahre, Nominierungen, Kategorien, Kandidaten, Clips, Landingpage,
|
|
Risiko, Audit-Log, Analytics, Voting, Gewinner, Einstellungen, Team.
|
|
- Confirm roles with `analytics` or `winners` still get effective `voting`
|
|
access for navigation and route guards.
|
|
- Confirm write actions still fail for read-only organization-team access.
|
|
|
|
### Responsive Checks
|
|
|
|
Check public voting, admin voting, admin winners, and admin categories at:
|
|
|
|
- `360px`
|
|
- `390px`
|
|
- `768px`
|
|
- desktop
|
|
|
|
In the browser console:
|
|
|
|
```js
|
|
document.documentElement.scrollWidth <= window.innerWidth
|
|
```
|
|
|
|
The expression must be `true` unless a deliberate horizontal data table is in a
|
|
contained scroll area.
|
|
|
|
## Cleanup
|
|
|
|
Temporary local nominations, candidates, votes, clips, and winners may be
|
|
created for smoke validation. Remove test artifacts before finishing if they
|
|
would pollute future manual checks.
|