Evaluation — Knowledge Base (Django + Templates)

Stack: Django + Django Templates (HTML/CSS/JS)

Evaluator: ___________

Submission Date: ___________

Pass Threshold: 90%

How to Mark

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

1. Django — `Category` Model

workspace FK → Workspace, ON DELETE CASCADE, related_name='categories'
name CharField, max_length=100
slug SlugField, max_length=110
description TextField, blank=True, default=''
created_at DateTimeField, auto_now_add=True
Meta ordering: ['name']
UniqueConstraint on (workspace, slug) with a constraint name
save() overridden to auto-generate slug from name if not set
Migration generated and committed

2. Django — `Article` Model

workspace FK → Workspace, ON DELETE CASCADE, related_name='articles'
category FK → Category, ON DELETE SET_NULL, null=True, blank=True, related_name='articles'
author FK → settings.AUTH_USER_MODEL, ON DELETE SET_NULL, null=True, related_name='authored_articles'
title CharField, max_length=200
slug SlugField, max_length=220
excerpt CharField, max_length=300, blank=True, default=''
body TextField
status CharField using Status TextChoices: draft, published; default=draft
created_at DateTimeField, auto_now_add=True
updated_at DateTimeField, auto_now=True
published_at DateTimeField, null=True, blank=True
Meta ordering: ['-created_at']
UniqueConstraint on (workspace, slug)
Index on (workspace, status, -created_at)
Index on (workspace, category, status)
Migration generated and committed

3. Django — `ArticleForm` and `CategoryForm`

ArticleForm:

fields = ['title', 'category', 'excerpt', 'body', 'status'] — not '__all__'
excerpt widget: Textarea with rows=3 and maxlength=300
body widget: Textarea with larger rows
__init__ accepts workspace kwarg and filters category queryset to that workspace
category field: required=False
clean_title(): raises ValidationError if title is blank
clean_body(): raises ValidationError if body is blank

CategoryForm:

fields = ['name', 'description']
clean_name(): strips whitespace, raises ValidationError if blank after strip

4. Django — `ArticleService`

create_article(workspace, author, title, body, category=None, excerpt='', status='draft') method
create_article: validates title and body are not empty
create_article: generates slug from title using slugify
create_article: calls _unique_slug() helper to ensure slug uniqueness — appends -2, -3, etc. on collision
create_article: sets published_at = now() if status is 'published'
update_article(article, editor, title, body, ...) method
update_article: re-generates slug only if title changed AND new slug would collide with another article (not always re-slugs)
update_article: sets published_at = now() when status changes to 'published' and was previously not published
delete_article(article, actor) method
delete_article: raises PermissionDenied if actor does not have admin/owner role
_unique_slug(workspace, base_slug, exclude_id=None) static method exists and works correctly
All methods are @staticmethod

5. Django — Views

ArticleListView at GET /workspace/{id}/kb/
Members see published articles only; editors/admins see published + their own drafts (filter in queryset — not template)
?search= param filters title OR excerpt contains — DB query, not client-side
?category= param filters by category slug
Paginated: 12 per page
Template: article_list.html
ArticleDetailView at GET /workspace/{id}/kb/<slug:slug>/
Returns 404 if article is a draft AND requester is a member who is not the author
Template: article_detail.html
ArticleCreateView at GET+POST /workspace/{id}/kb/new/
Returns 403 if user has member role
GET: renders empty ArticleForm(workspace=self.workspace)
POST: validates form → calls ArticleService.create_article() → redirects to article detail
Template: article_form.html
ArticleEditView at GET+POST /workspace/{id}/kb/<slug:slug>/edit/
Returns 403 if user has member role
GET: renders ArticleForm prefilled with article values
POST: validates form → calls ArticleService.update_article() → redirects to article detail
Template: article_form.html (same template as create)
ArticleDeleteView at POST /workspace/{id}/kb/<slug:slug>/delete/
Returns 403 if user has editor or member role (admin/owner only)
Calls ArticleService.delete_article()
Redirects to article list with success message
CategoryListView at GET /workspace/{id}/kb/categories/
Returns 403 for non-admin/owner
Supports ?search= filter
Template: category_list.html
CategoryCreateView at GET+POST /workspace/{id}/kb/categories/new/
Returns 403 for non-admin/owner
Duplicate slug handled gracefully — shown as form error, not a 500
Template: category_form.html

6. Django — URL Configuration

URL patterns registered in correct order: new/ and categories/ BEFORE <slug:slug>/
URL names use kebab-case: article-list, article-detail, article-create, article-edit, article-delete, category-list, category-create
workspace_id captured as <int:workspace_id>
Article slug captured as <slug:slug>

7. Templates

General — all templates:

All templates extend base.html
{% load static %} present in all templates
No <style> blocks in any template
No <script> blocks with logic in any template
CSS linked via {% static 'css/kb.css' %}
JS linked via {% static 'js/kb.js' %}

article_list.html:

Search + category filter form uses GET method
Active filter chips shown when search or category filter is active
Filter chip removes filter on click
"New Article" button visible to editor/admin only — hidden from members
Article cards show: title, excerpt, category badge, status badge, author, date
Status badge uses correct CSS class (.badge-draft, .badge-published)
Empty state: "No articles found." message shown
Pagination links rendered

article_detail.html:

Breadcrumb shown: Knowledge Base / Category / Title (or equivalent path)
Draft status warning shown to editors/admins when viewing a draft
Article body rendered (not escaped as plain text)
Edit button visible to editor/admin only
Delete button visible to admin/owner only — wrapped in POST form with CSRF

article_form.html:

Heading changes between "New Article" and "Edit Article" based on context
Each field rendered individually (not {{ form.as_p }})
Field errors shown below each field
Non-field errors shown at top of form
Excerpt field: character counter shown (via data-* attribute and JS)
Submit button has data-loading-text attribute for JS loading state
Cancel link present

category_list.html:

"New Category" button visible (admin/owner context)
Search bar form uses GET method
Table shows: Name | Description | Article Count | Actions
Delete button uses data-* attributes for confirmation — no inline JS

8. CSS — `static/css/kb.css`

.badge-draft defined using --color-warning variable
.badge-published defined using --color-success variable
Article card styles: grid layout, hover shadow
Search bar and filter chip styles
Article body typography: headings, paragraphs, lists, code blocks
Breadcrumb styles
Table styles for category list
Empty state styles
Responsive: card grid collapses to 1 column on mobile
CSS variables used (--color-success, --color-warning, --color-danger) — no hardcoded hex

9. JS — `static/js/kb.js`

Delete confirmation uses data-article-title and data-form-id attributes — no string interpolation in JS
document.querySelectorAll('.btn-delete-article') used for event delegation
confirm() message reads from btn.dataset.articleTitle
Form submitted via document.getElementById(btn.dataset.formId).submit()
Excerpt character counter reads data-max-length from HTML attribute — not hardcoded in JS
Counter updates on input event and on page load (to handle prefilled values in edit form)
Submit button loading state reads data-loading-text from HTML attribute — not hardcoded text in JS

10. Standards Compliance

Draft visibility filtered in the queryset — not in the template using {% if %}
Business logic (slug generation, published_at, permission check) in ArticleService — not in views
All POST views use POST→redirect→GET pattern
Django messages framework used for success/error feedback after redirect
No inline styles in any template
No inline scripts in any template
CSRF token present on every POST form (delete, category create)
Admin/editor gating enforced server-side — not just hidden in template
Mobile responsive at 375px and 768px

Score Summary

Section	Total Items	✓ Pass	~ Partial	✗ Fail
1. Category Model	9
2. Article Model	14
3. Forms	10
4. Service	11
5. Views	21
6. URL Config	6
7. Templates	25
8. CSS	10
9. JS	7
10. Standards	9
Total	122

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

Evaluator Notes

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