Betygsregistrering - Test Cases

Version: 3.0
Created: 2025-11-18
Status: Active
Purpose: Manual testing scenarios for Betygsregistrering multi-role mockup

Introduction

This document contains comprehensive test cases for the Betygsregistrering (Grade Registration) function. Test cases cover all three user roles: Teacher, Student, and Custodian. Tests are designed for manual execution in a web browser.

Scope

• Teacher view: Full grade registration and management functionality
• Student view: Read-only view of own published grades
• Custodian view: Read-only view of child's published grades

Test Environment

• Base URL: http://localhost:8888/Mockups/Functions/Betygsregistrering/3/
• Views:
  • Landing page: index.html
  • Teacher: teacher.html
  • Student: student.html
  • Custodian: custodian.html

Personas Used

• Teacher: Kerstin Berg (T5004-002) - Ämneslärare SV, Proximaskolan, Class 9A
• Student: Anna Andersson (S5004-701) - Elev åk 9, Proximaskolan, Class 9A
• Custodian: Eva Andersson (C5004-701A) - Vårdnadshavare to Anna Andersson

---

Test Cases - Landing Page

LP-01: Landing page loads correctly

Preconditions: Navigate to http://localhost:8888/Mockups/Functions/Betygsregistrering/3/index.html

Steps:

1. Verify page loads without errors
2. Check that heading displays "Betygsregistrering"
3. Verify version badge shows "Version 3"
4. Confirm three view cards are visible: Lärarvyn, Elevvyn, Vårdnadshavarvyn

Expected Result: Landing page displays correctly with all elements visible

LP-02: View card links work

Steps:

1. Click on "Lärarvyn" card
2. Verify teacher.html loads
3. Go back to landing page
4. Click on "Elevvyn" card
5. Verify student.html loads
6. Go back to landing page
7. Click on "Vårdnadshavarvyn" card
8. Verify custodian.html loads

Expected Result: All view links navigate to correct pages

LP-03: Documentation links work

Steps:

1. Click on "Förstudie" link
2. Verify pre-study.md opens
3. Click on "Specifikation" link
4. Verify specification.md opens
5. Click on "Testfall" link
6. Verify test-cases.md opens
7. Click on "Supportartikel" link
8. Verify support-article.md opens

Expected Result: All documentation links work correctly

LP-04: Responsive design

Steps:

1. Resize browser to mobile width (< 768px)
2. Verify cards stack vertically
3. Verify text remains readable
4. Resize to tablet width (768-1024px)
5. Verify responsive grid adapts
6. Resize to desktop width (> 1024px)
7. Verify optimal layout

Expected Result: Page adapts to all screen sizes correctly

---

Test Cases - Teacher View

TC-T-01: Teacher view loads correctly

Preconditions: Navigate to http://localhost:8888/Mockups/Functions/Betygsregistrering/3/teacher.html

Steps:

1. Verify page loads without JavaScript errors (check console)
2. Check that user is "Kerstin Berg" in top-right
3. Verify navigation menu shows teacher menu items
4. Confirm "BEDÖMNING" menu is expanded with Betygsregistrering active
5. Verify page title is "Betygsregistrering"

Expected Result: Teacher page loads correctly with proper persona and menu

TC-T-02: Register term grades in primary school (LGR22)

Based on: specification.md [01]

Steps:

1. Select curriculum: "Grundskola (LGR22)"
2. Select class: "Klass 9A"
3. Verify grade table shows students from 9A
4. Select student "Anna Andersson"
5. Find subject "Svenska"
6. Click grade dropdown
7. Select grade "A" from A-F scale
8. Verify grade saves automatically
9. Verify grade is marked as "Utkast" (draft)

Expected Result: Grade is registered correctly with LGR22 scale (A-F)

TC-T-03: Register course grades in gymnasium (LGY11, LGY25)

Based on: specification.md [02]

Steps:

1. Select curriculum: "Gymnasium kursbetyg (LGY11)"
2. Select appropriate class
3. Register grade for a student
4. Verify grade scale is A-F
5. Switch to "Gymnasium ämnesbetyg (LGY25)"
6. Verify grade scale remains A-F
7. Verify subject/course codes are validated

Expected Result: Gymnasium grades use correct A-F scale for both LGY11 and LGY25

TC-T-04: Register grades in adapted primary school (LGRA22)

Based on: specification.md [04]

Steps:

1. Select curriculum: "Anpassad grundskola (LGRA22)"
2. Find integrated student "Erik Svensson"
3. Verify grade scale shows A-E, -, 1
4. Select grade "C"
5. Verify grade saves
6. Test "1" (deltagit) option is available

Expected Result: Adapted school scale (A-E, -, 1) is available for integrated students

TC-T-05: Mark grade as definitive

Based on: specification.md [01] - Acceptanskriterier

Steps:

1. Register a grade for a student (e.g., "B" in Svenska)
2. Check the "Definitiv" checkbox for that grade
3. Verify confirmation dialog appears
4. Enter publish date (e.g., "2025-12-15")
5. Check confirmation checkbox
6. Click "Markera som definitiva"
7. Verify grade status changes to "Definitiv"
8. Verify publish date is displayed
9. Verify grade cannot be edited anymore (should be locked logic)

Expected Result: Grade is marked as definitive with publish date set

TC-T-06: Obligatory notes for F or - grades

Based on: specification.md [01] - Acceptanskriterier

Steps:

1. Select a student
2. Set grade to "F" for any subject
3. Verify note dialog appears automatically
4. Try to save without entering note
5. Verify validation error occurs
6. Enter note: "MA: Eleven har inte nått kunskapskraven pga hög frånvaro"
7. Save note
8. Verify note is attached to grade
9. Repeat for "-" grade
10. Verify note is also required for "-"

Expected Result: F and - grades require obligatory notes

TC-T-07: Final grade marking (Slutbetyg)

Based on: specification.md [01] - Acceptanskriterier

Steps:

1. Select class 9A (år skurs 9)
2. Verify "Slutbetyg" checkbox is available
3. Check "Slutbetyg" for a grade
4. Verify checkbox saves
5. Select a student in year 7
6. Verify "Slutbetyg" checkbox is NOT available (only yr 9)
7. For gymnasium year 3, verify "Slutbetyg" IS available

Expected Result: Final grade checkbox only available in final year (9, 10, or gymnasium year 3)

TC-T-08: Course code validation

Based on: specification.md [01] - Acceptanskriterier

Steps:

1. Enter an invalid course code
2. Verify error message appears: "Ämneskoden du har angivit är inte giltig enligt Skolverkets register"
3. Enter a valid course code (e.g., "MA", "SV", "EN")
4. Verify grade can be registered

Expected Result: Invalid course codes are rejected with proper error message

TC-T-09: Bulk actions - Mark multiple as definitive

Steps:

1. Select multiple students using checkboxes
2. Verify bulk actions bar appears at bottom
3. Verify selected count is correct
4. Click "Markera som definitiva"
5. Set publish date
6. Confirm action
7. Verify all selected grades are marked as definitive
8. Click "Avmarkera alla"
9. Verify all checkboxes are cleared

Expected Result: Bulk actions work for multiple students

TC-T-10: Student detail modal

Steps:

1. Click on a student row or "view details" icon
2. Verify student detail dialog opens
3. Check student information: Name, Personal number, Class, Curriculum
4. Verify grade history table shows all grades for that student
5. Verify data is correctly populated
6. Close dialog

Expected Result: Student details display correctly with grade history

TC-T-11: Filter functionality

Steps:

1. Test curriculum filter: Select different curricula
2. Verify grade table updates to show only matching students
3. Test class filter: Select different classes
4. Verify students from selected class are shown
5. Test subject filter: Select specific subject
6. Verify only grades for that subject are shown
7. Test period filter: Select different terms
8. Verify grades from selected term are shown
9. Click "Återställ filter"
10. Verify all filters are reset

Expected Result: All filters work correctly and can be reset

TC-T-12: Search students

Steps:

1. Enter student name in search field: "Anna"
2. Verify table filters to show matching students
3. Enter partial name: "And"
4. Verify matching results
5. Clear search
6. Verify all students are shown again

Expected Result: Student search filters table correctly

TC-T-13: Status cards update

Steps:

1. Note initial status card values (Utkast, Definitiva, Väntar publicering, Låsta)
2. Register new grade
3. Verify "Utkast" count increases
4. Mark grade as definitive
5. Verify "Definitiva" count increases
6. Set future publish date
7. Verify "Väntar publicering" count increases

Expected Result: Status cards update in real-time

TC-T-14: FAB (Floating Action Button) quick actions

Steps:

1. Click FAB button (bottom-right)
2. Verify menu appears with quick actions
3. Click "MARKERA ALLA DEFINITIVA"
4. Verify appropriate action triggers
5. Test other FAB actions

Expected Result: FAB provides quick access to common actions

TC-T-15: Dark mode functionality

Steps:

1. Click user avatar/name in top-right
2. Click "Mörkt läge"
3. Verify page switches to dark theme
4. Verify all colors are appropriately inverted
5. Verify text remains readable
6. Toggle back to light mode
7. Verify theme switches correctly

Expected Result: Dark mode works without visual issues

TC-T-16: Language switching (Svenska/English)

Steps:

1. Click user menu
2. Click "Byt till engelska"
3. Verify UI text translates to English:
   • Menu items (Profile, Settings, etc.)
   • Page headings (Grade Registration → Grade Registration)
   • Button labels (Spara → Save, Avbryt → Cancel)
4. Verify student names remain in Swedish (data-user-content)
5. Switch back to Swedish
6. Verify all text returns to Swedish

Expected Result: Language toggle works, UI translates but user content remains Swedish

TC-T-17: Responsive design (Desktop/Tablet)

Steps:

1. View on desktop (> 1024px)
2. Verify table displays correctly with all columns
3. Resize to tablet (768-1024px)
4. Verify responsive behavior
5. Verify menu can collapse
6. Test collapsed menu functionality

Expected Result: Teacher view is usable on desktop and tablet devices

---

Test Cases - Student View

TC-S-01: Student view loads correctly

Preconditions: Navigate to http://localhost:8888/Mockups/Functions/Betygsregistrering/3/student.html

Steps:

1. Verify page loads without JavaScript errors
2. Check user is "Anna Andersson"
3. Verify student navigation menu is shown
4. Verify "MINA BETYG" is highlighted/active
5. Verify page title is "Mina betyg"

Expected Result: Student page loads with Anna Andersson persona

TC-S-02: Only published grades are visible

Steps:

1. Check grades displayed on page
2. Verify only grades with:
   • publishDate <= today
   • showToStudent = true
   • definitive = true
3. Count visible grades
4. Compare with data.js - verify unpublished grades (MU, SH) are hidden
5. Verify published grades (MA, EN, SV, BI, HI, IDH) are shown

Expected Result: Only 6 published grades visible, 2 unpublished grades hidden

TC-S-03: Grade cards display correctly

Steps:

1. Verify each grade is shown as a card
2. Check card includes: Subject name, Current grade, Teacher name, Publish date
3. Verify grade color coding (A=green, B=green, C=yellow, etc.)
4. Verify readable text and icons

Expected Result: Grade cards display all required information clearly

TC-S-04: View grade details

Steps:

1. Click on a grade card (e.g., "Matematik - A")
2. Verify detail dialog opens
3. Check dialog shows: Subject, Grade, Term, Publish date, Teacher name
4. If grade has note, verify it's displayed
5. Verify grade history table shows previous grades for that subject
6. Close dialog

Expected Result: Grade details display correctly with history

TC-S-05: No editing capabilities

Steps:

1. Look for edit buttons, dropdowns, or input fields
2. Verify NO editing controls are present
3. Verify NO "Definitiv" checkbox
4. Verify NO bulk actions bar
5. Verify NO FAB button
6. Confirm view is completely read-only

Expected Result: Student cannot edit or modify any grades

TC-S-06: Filter by term

Steps:

1. Select "Hösttermin 2024 (20251)" filter
2. Verify only grades from period 20251 are shown
3. Select "Vårtermin 2025 (20252)"
4. Verify only grades from period 20252 are shown (should be empty or limited)
5. Select "Alla terminer"
6. Verify all published grades are shown

Expected Result: Term filter works correctly

TC-S-07: Filter by subject

Steps:

1. Select specific subject from dropdown (e.g., "Matematik")
2. Verify only Matematik grade is shown
3. Select different subject
4. Verify filter updates correctly
5. Select "Alla ämnen"
6. Verify all grades are shown

Expected Result: Subject filter works correctly

TC-S-08: Empty state display

Steps:

1. Modify data.js temporarily to make no grades published
2. Reload page
3. Verify empty state shows: "Inga betyg publicerade än"
4. Verify message explains that grades will appear when published
5. Restore data.js

Expected Result: Empty state displays correctly when no published grades

TC-S-09: Grade statistics cards

Steps:

1. Verify status cards at top show:
   • "Ämnen": Count of subjects with published grades
   • "Publicerade betyg": Count of published grades
   • "Medelbetyg": Average grade (A, B, C, etc.)
2. Verify counts are correct

Expected Result: Statistics cards show accurate information

TC-S-10: Information panel

Steps:

1. Scroll to bottom
2. Verify "Information om betyg" section is present
3. Verify grade scale explanations (A-F meanings)
4. Verify "Frågor om betyg?" help message

Expected Result: Helpful information is displayed

TC-S-11: Dark mode (Student)

Steps:

1. Toggle dark mode from user menu
2. Verify page switches to dark theme
3. Verify grade cards remain readable
4. Verify color coding still works in dark mode
5. Toggle back to light mode

Expected Result: Dark mode works correctly for student view

TC-S-12: Language switching (Student)

Steps:

1. Switch to English
2. Verify UI text translates
3. Verify Anna Andersson's name stays in Swedish
4. Verify subject names translate if in glossary
5. Switch back to Swedish

Expected Result: Language toggle works correctly

TC-S-13: Mobile responsive design

Steps:

1. View on mobile screen (< 768px)
2. Verify grade cards stack vertically
3. Verify touch targets are large enough (min 44px)
4. Test menu toggle works on mobile
5. Verify filters are accessible
6. Test dialog opens and is usable on mobile

Expected Result: Student view is fully functional on mobile devices

---

Test Cases - Custodian View

TC-C-01: Custodian view loads correctly

Preconditions: Navigate to http://localhost:8888/Mockups/Functions/Betygsregistrering/3/custodian.html

Steps:

1. Verify page loads without errors
2. Check user is "Eva Andersson"
3. Verify simplified custodian menu is shown
4. Verify "RESULTAT" is active
5. Verify page title shows "Annas betyg"

Expected Result: Custodian page loads with Eva Andersson viewing Anna's grades

TC-C-02: Only child's published grades visible

Steps:

1. Verify only Anna Andersson's grades are shown
2. Confirm no other students' grades are visible
3. Verify same published/unpublished logic as student view
4. Count grades: should match Anna's published grades from student view

Expected Result: Only Anna's published grades (6 subjects) are visible

TC-C-03: Grade scale help section

Steps:

1. Locate "Vad betyder betygen?" section
2. Verify all grade levels are explained:
   • A: Mycket hög kunskapsnivå
   • B: Hög kunskapsnivå
   • C: God kunskapsnivå
   • D: Tillfredställande kunskapsnivå
   • E: Godkänd kunskapsnivå
   • F: Ej godkänd
   • -: Betyg saknas
3. Verify color badges match grade levels

Expected Result: Grade scale explanations are clear and visible

TC-C-04: Simple grade card layout

Steps:

1. Verify grades are displayed as simple cards (not complex table)
2. Each card should show: Subject, Grade (large), Teacher, Last updated
3. Verify cards have clear visual hierarchy
4. Verify grade is prominently displayed

Expected Result: Cards are simple and mobile-friendly

TC-C-05: Contact teacher button

Steps:

1. Locate "Kontakta lärare" button
2. Verify button is prominent (full-width, large)
3. Verify button has icon and text label
4. Click button
5. Verify appropriate action occurs (or placeholder message)

Expected Result: Contact teacher button is easily accessible

TC-C-06: View grade details

Steps:

1. Click on a grade card
2. Verify detail dialog opens
3. Check information displayed:
   • Subject (large, clear)
   • Grade (very large, 3rem font)
   • Term
   • Publish date
   • Teacher name (in Swedish, data-user-content)
4. If note exists, verify it's shown
5. Verify "Tidigare betyg" (grade history) section
6. Close dialog

Expected Result: Grade details are very clear and simple for parents

TC-C-07: No editing capabilities

Steps:

1. Verify no edit buttons anywhere
2. Verify no grade dropdowns
3. Verify no checkboxes
4. Verify completely read-only
5. Verify no bulk actions
6. Verify no FAB

Expected Result: Custodian cannot edit anything

TC-C-08: Dark mode (Custodian)

Steps:

1. Toggle dark mode
2. Verify high contrast is maintained
3. Verify grade cards remain readable
4. Verify grade scale help section works in dark mode
5. Toggle back to light mode

Expected Result: Dark mode works with high contrast

TC-C-09: Language switching (Custodian)

Steps:

1. Switch to English
2. Verify UI translates
3. Verify "Annas betyg" → "Anna's grades" (or similar)
4. Verify teacher names stay in Swedish
5. Switch back to Swedish

Expected Result: Language toggle works appropriately

TC-C-10: Mobile-first design (Smartphone)

Steps:

1. View on smartphone screen (< 480px)
2. Verify touch targets are 48px minimum
3. Verify text is large and readable
4. Verify grade cards stack nicely
5. Test menu navigation
6. Test dialog usability
7. Verify no horizontal scrolling
8. Test pinch-to-zoom is enabled (user-scalable=yes)

Expected Result: Custodian view is optimized for smartphone use

TC-C-11: Grade card interaction

Steps:

1. Tap on a grade card
2. Verify visual feedback (hover/active state)
3. Verify card expands or opens dialog smoothly
4. Verify back button returns to list
5. Test multiple cards in sequence

Expected Result: Card interactions are smooth and intuitive

---

Cross-Role Test Cases

TC-X-01: Data consistency across views

Steps:

1. Open teacher view, note a specific published grade (e.g., Anna's Math = A)
2. Open student view
3. Verify same grade appears with same value
4. Open custodian view
5. Verify same grade appears with same value
6. Verify all three views show consistent data

Expected Result: Published grades are consistent across all views

TC-X-02: Unpublished grades visibility

Steps:

1. In teacher view, identify an unpublished grade (not marked definitive)
2. Note the student and subject
3. Switch to student view (same student)
4. Verify unpublished grade is NOT visible
5. Switch to custodian view
6. Verify unpublished grade is NOT visible

Expected Result: Only teacher sees unpublished/draft grades

TC-X-03: Publish workflow verification

Steps:

1. Teacher view: Create new grade for Anna (e.g., "Kemi = B")
2. Verify grade is "Utkast"
3. Check student view: verify grade is NOT visible yet
4. Back to teacher: Mark grade as definitive with past publish date
5. Refresh student view: verify grade NOW appears
6. Check custodian view: verify grade also appears

Expected Result: Publishing workflow works correctly across roles

TC-X-04: Navigation from landing page

Steps:

1. Start at landing page
2. Navigate to each view in sequence
3. Use browser back button
4. Verify landing page is accessible
5. Test all three view cards
6. Verify smooth navigation

Expected Result: Navigation between views is seamless

TC-X-05: Grade period filtering cross-view

Steps:

1. Teacher view: Note which grades are in period 20251 vs 20252
2. Student view: Filter by "Hösttermin 2024 (20251)"
3. Verify only period 20251 published grades show
4. Verify count matches expectation
5. Custodian view: (No period filter, but verify only relevant grades)

Expected Result: Period filtering is consistent with data

---

Accessibility Test Cases

TC-A-01: Keyboard navigation

Steps:

1. Use only keyboard (Tab, Enter, Escape)
2. Navigate through all views
3. Verify all interactive elements are reachable
4. Verify focus indicators are visible
5. Test skip links (Tab on page load)
6. Verify skip to navigation and skip to content work

Expected Result: All functionality is keyboard accessible

TC-A-02: Screen reader compatibility

Steps:

1. Enable screen reader (VoiceOver on Mac, NVDA on Windows)
2. Navigate landing page
3. Verify all cards are announced correctly
4. Navigate teacher view
5. Verify table headers are announced
6. Verify aria-labels are present and correct
7. Test student and custodian views

Expected Result: Screen readers can navigate and understand all content

TC-A-03: Color contrast

Steps:

1. Verify all text meets WCAG AA standards (4.5:1 for normal text, 3:1 for large text)
2. Check grade badges have sufficient contrast
3. Verify links are distinguishable
4. Test in dark mode as well

Expected Result: All text meets accessibility contrast requirements

---

Error Handling Test Cases

TC-E-01: Network error handling

Steps:

1. Simulate network failure (disable internet or block requests)
2. Try to load page
3. Verify graceful degradation
4. Verify error messages are user-friendly

Expected Result: Errors are handled gracefully with helpful messages

TC-E-02: Missing data handling

Steps:

1. Modify data.js to remove mockGrades array
2. Reload teacher view
3. Verify empty state shows correctly
4. Verify no JavaScript errors
5. Restore data

Expected Result: Missing data is handled without crashes

TC-E-03: Invalid grade entry

Steps:

1. Teacher view: Try to enter invalid grade
2. Verify validation prevents invalid entry
3. Verify error message explains issue

Expected Result: Invalid data is rejected with helpful feedback

---

Performance Test Cases

TC-P-01: Page load time

Steps:

1. Open browser dev tools → Network tab
2. Clear cache
3. Load each view
4. Verify load time < 3 seconds on good connection
5. Check number of requests
6. Verify no unnecessary data loading

Expected Result: Pages load quickly and efficiently

TC-P-02: Large data set handling

Steps:

1. Modify data.js to include 100+ students
2. Load teacher view
3. Verify table renders smoothly
4. Test scrolling performance
5. Test filter performance
6. Restore data

Expected Result: Application handles larger data sets reasonably

---

Browser Compatibility Test Cases

TC-B-01: Chrome/Edge compatibility

Steps:

1. Test all views in Chrome
2. Verify full functionality
3. Test in Edge
4. Verify consistency

Expected Result: Works perfectly in Chrome/Edge

TC-B-02: Firefox compatibility

Steps:

1. Test all views in Firefox
2. Check for layout differences
3. Test all interactive features
4. Verify no Firefox-specific issues

Expected Result: Works correctly in Firefox

TC-B-03: Safari compatibility

Steps:

1. Test all views in Safari (Mac/iOS)
2. Check for WebKit-specific rendering issues
3. Test on iPhone/iPad
4. Verify mobile functionality

Expected Result: Works correctly in Safari

---

Summary

Total Test Cases: 51

• Landing Page: 4 tests
• Teacher View: 17 tests
• Student View: 13 tests
• Custodian View: 11 tests
• Cross-Role: 5 tests
• Accessibility: 3 tests
• Error Handling: 3 tests
• Performance: 2 tests
• Browser Compatibility: 3 tests

Critical Tests

Priority 1 (Must Pass):

• TC-T-02: Register grades correctly
• TC-T-06: Obligatory notes for F/-
• TC-S-02: Only published grades visible
• TC-C-02: Only child's grades visible
• TC-X-02: Unpublished grades hidden from student/custodian
• TC-X-03: Publish workflow

Priority 2 (Should Pass):

• All language switching tests
• All dark mode tests
• All responsive design tests
• All accessibility tests

Priority 3 (Nice to Have):

• Performance tests
• Cross-browser tests

---

Test Execution Log

Test Session: [Date]

Tester: [Name]
Browser: [Browser + Version]
OS: [Operating System]

Test ID	Status	Notes
LP-01
LP-02
TC-T-01
...

Status Legend:

• ✅ Pass
• ❌ Fail
• ⚠️ Partial
• ⏭️ Skipped
• 🔄 Retest needed

---

Known Limitations (Mock Environment)

1. No real API: All data changes are client-side only (lost on refresh)
2. No authentication: User roles are simulated via URL/script
3. Auto-locking: 20-day lock not implemented (would require backend)
4. Course code validation: Limited to mock registry
5. Export functionality: Placeholder only
6. Email/notifications: Simulated, not real

These limitations are expected for a mockup and don't affect testing of UI/UX.

---

Revision History

Version	Date	Changes
3.0	2025-11-18	Initial test cases for multi-role implementation