Fretboard Lab QA Checklist
Use this checklist for each release candidate before publishing downloads or website copy.
Run Metadata
- Product version:
- Build artifact:
- OS and architecture:
- License state tested:
- Tester:
- Date:
File And Path Handling
- Short file: import or open a small chord/progression fixture if supported; the app loads it and exports diagrams without state loss.
- Long file: import or paste a long progression with at least 200 chord symbols; search, filtering, and export remain responsive.
- Chinese path: export PNG, PDF, Markdown, and JSON to a path such as
测试素材/指板图/Cmaj7.pdf; filenames and links remain valid. - Damaged file: open a malformed progression, JSON, or preset file; the app reports the line or field problem without crashing.
- Huge file: try a progression or batch input near the documented size limit; the app rejects or processes it with visible progress.
- Unsupported file: drop an audio file or random binary file into any import path; the app rejects it without showing audio-specific controls.
Audio/Sample-Rate Guard
- Confirm Fretboard Lab does not require audio sampling rate settings for normal chord lookup and diagram export.
- If an audio or MIDI preview path exists, verify 44.1 kHz and 48 kHz playback/export settings do not affect chord spelling or fingering results.
- Importing files with audio-only metadata must not create a fake chord chart or silently discard errors.
Core Workflow
- Enter common chord symbols: C, Cmaj7, Am7, Dm7b5, G7b9, F#dim, and slash chords.
- Enter roman numeral progressions and confirm key changes update chord names correctly.
- Browse generated fingerings by position, span, open strings, and difficulty.
- Change tuning from standard to Drop D, DADGAD, Open G, Open D, and Half Step Down; diagrams update without stale fret positions.
- Export selected diagrams only, then reopen the exported files in external viewers.
- Bulk export a progression and confirm order, chord labels, tuning, and diagram count are stable.
License And Offline
- No license: community chord lookup and basic export work; professional bulk export shows the correct locked state.
- Valid online license: larger bulk export workflows and checkout license-key activation are available.
- Activated license state: app launches with no network and preserves professional features.
- Tampered or wrong-product license: app rejects the license without deleting local presets or exports.
- No network: chord parsing, fingering generation, named tunings, and export all work.
Regression Signoff
- No console panic or unhandled promise rejection during chord entry -> fingering browse -> tuning change -> export.
- Release notes mention any remaining chord parser ambiguity or export limitation.
- Screenshots and help copy match the current UI labels.