Evaluation — Announcement Board (React + Django)

Project Spec: 01-announcement-board.md

Stack: React (TypeScript) + Django REST Framework

Evaluator: ___________

Submission Date: ___________

Pass Threshold: 90%

How to Mark

[✓] Fully correct
[~] Partial — note the gap below the item
[✗] Missing or wrong

1. Django — `Announcement` Model

workspace FK → Workspace, ON DELETE CASCADE, related_name='announcements'
author FK → settings.AUTH_USER_MODEL, ON DELETE SET_NULL, null=True, related_name='announcements'
title CharField, max_length=200, NOT blank
body TextField
is_pinned BooleanField, default=False
expires_at DateTimeField, null=True, blank=True
created_at DateTimeField, auto_now_add=True
Meta ordering: ['-is_pinned', '-created_at'] — pinned announcements appear first, then newest
__str__ returns meaningful representation (e.g. title)
Migration generated and committed

2. Django — `AnnouncementService`

create_announcement(workspace, author, title, body, is_pinned=False, expires_at=None) method exists
create_announcement: validates title is not blank
create_announcement: validates expires_at is in the future if provided
toggle_pin(announcement, actor) method exists
toggle_pin: checks actor has admin/owner role — raises PermissionDenied if not
toggle_pin: flips is_pinned and saves
delete_announcement(announcement, actor) method exists
delete_announcement: checks actor has admin/owner role — raises PermissionDenied if not
All service methods are @staticmethod — no business logic in views

3. Django — Serializers

AnnouncementReadSerializer exists with correct read fields
is_expired field is a SerializerMethodField — computed from expires_at < now(), not a DB column
author field returns author name/email (not just foreign key ID)
AnnouncementWriteSerializer exists for create/edit input
expires_at validated: must be in the future if provided — validation error returned if past date
fields = '__all__' is NOT used — fields explicitly listed
read_only_fields includes: id, created_at, author, workspace
write_only fields (if any sensitive input) marked correctly

4. Django — `IsWorkspaceMember` Permission Class

Custom permission class in permissions.py (not defined inside the view file)
Queries DB for workspace membership — does not rely on JWT claims alone
Returns False (403) if user is not an active member of the workspace
workspace_id extracted from URL kwargs (workspace_id)
Works correctly for all views that use it

5. Django — Views

AnnouncementListCreateView at GET+POST /workspace/{id}/announcements/
List: returns announcements ordered by -is_pinned, then -created_at
List: excludes expired announcements for member role (expired shown to admin/owner only is acceptable too — evaluate per spec)
Create: uses AnnouncementWriteSerializer for input validation
Create: calls AnnouncementService.create_announcement() — no ORM calls in the view body
AnnouncementDetailView at GET+PUT+PATCH+DELETE /workspace/{id}/announcements/{id}/
Detail GET: returns single announcement with read serializer
PUT/PATCH: editor/admin only — 403 for member role attempting edit
DELETE: calls AnnouncementService.delete_announcement() — 403 for non-admin
AnnouncementPinView at POST /workspace/{id}/announcements/{id}/pin/
Pin toggle: calls AnnouncementService.toggle_pin() — 403 for non-admin
All views use IsWorkspaceMember permission
All views return correct HTTP status codes (200, 201, 204, 400, 403, 404)
Error responses follow the format: { "error": "ERROR_CODE", "message": "..." }

6. React — Announcement List Page

Custom hook useAnnouncements(workspaceId) returns { data, isLoading, error, refetch }
No any types used in TypeScript — proper interfaces defined
Announcement interface defined: id, title, body, is_pinned, is_expired, author, created_at, expires_at
Pinned announcements visually distinguished (different card style, pin icon)
Expired announcements shown differently (greyed out or "Expired" badge) for admin/owner
Loading state: skeleton cards shown
Empty state: "No announcements yet." with visual message
Error state: "Could not load announcements." + retry button shown
"New Announcement" button: visible to admin/owner only (hidden for member role)
Edit/Pin/Delete actions: visible to admin/owner only

7. React — Announcement Modal

AnnouncementModal component accepts props: announcement (optional, for edit) + onSuccess callback
Same component used for both create and edit (not two separate components)
Edit: pre-fills title, body, is_pinned, expires_at with existing values
title: required — shows error if blank
body: required — shows error if blank
expires_at: optional date-time picker — shows error if a past date is selected
is_pinned: checkbox (admin/owner only)
Submit button shows loading state
Submit button disabled while loading
On success: modal closes, list refreshes via refetch(), "Announcement created/updated." toast shown
Validation errors from API shown per field — not as generic toast

8. React — Pin Toggle

Pin toggle button on each announcement card
Clicking calls the pin API endpoint (POST .../pin/)
Optimistic UI: is_pinned toggles immediately in the UI before the API responds
On API error: is_pinned reverts to original value, error shown
Pinned announcements move to top of list on successful toggle (or list refreshes)
Loading indicator shown on the pin button during the API call

9. Django — URL Configuration

urlpatterns includes all three view URLs
URL names are kebab-case (e.g. announcement-list, announcement-detail, announcement-pin)
workspace_id captured as <int:workspace_id> in the URL pattern

10. Standards Compliance

No business logic (ORM calls, conditional checks) inside view methods — all in service
serializer.is_valid(raise_exception=True) used — not manual if serializer.is_valid():
React hook for each data fetch — no fetch logic inside component body directly
No any TypeScript types
All API errors handled and shown in UI
No silent failures in React error handling (no empty catch blocks)
Mobile responsive at 375px and 768px

Score Summary

Section	Total Items	✓ Pass	~ Partial	✗ Fail
1. Model	9
2. Service	9
3. Serializers	8
4. Permission Class	5
5. Views	14
6. List Page	10
7. Modal	11
8. Pin Toggle	6
9. URL Config	3
10. Standards	7
Total	82

Score: ___ / 82 (___%) — Pass / Conditional / Fail

Evaluator Notes

_Record specific failures, partial items, or other observations here._