feat(docs): update documentation for final MVP verification and deployment processes

Author: AAdewunmi

Makefile

@@ -31,6 +31,7 @@ help:
 	@echo "  make format        Format with Black and Ruff"
 	@echo "  make format-check  Check formatting"
 	@echo "  make migrations-check Check for missing migrations"
+	@echo "  make deploy-check  Run Django production deploy check"
 	@echo "  make check         Run lint, format-check, migrations check, deploy check, and tests"
 	@echo "  make clean         Remove Python and test cache files"
 

RUNBOOK.md

@@ -190,18 +190,19 @@ make nltk-data
 ## Sprint Verification
 
 The executable scripts under `docs/sprint-runbook/` capture incremental sprint
-checkpoints. Use the Sprint 3 Day 5 script as the current Sprint 3 completion
-check:
+checkpoints. Use the Sprint 4 Day 5 script as the current final MVP
+verification check:
 
 ```bash
-./docs/sprint-runbook/sprint-3/sprint-3-day-5.sh
+./docs/sprint-runbook/sprint-4/sprint-4-day-5.sh
 ```
 
 It verifies the Docker Compose project name, the web container, PostgreSQL,
-migrations, insight browser routes, secured insight API routes, authentication
-and ownership boundaries, NLTK preprocessing, TF-IDF cosine scoring,
-explainability fields, idempotency, formatting, linting, focused insight tests,
-and the full regression suite.
+migrations, documentation coverage, deterministic seed data, production deploy
+settings, collectstatic, health checks, browser and API smoke paths,
+authentication and ownership boundaries, NLTK preprocessing, TF-IDF cosine
+scoring, explainability fields, idempotency, formatting, linting, focused
+release tests, and the full regression suite.
 
 See `docs/sprint-runbook/README.md` before running an earlier checkpoint script.
 

apps/insights/migrations/0001_initial.py

@@ -1,3 +1,5 @@
+"""Create the target role profile and job insight tables."""
+
 # Generated by Django 5.1.15 on 2026-06-08 11:38
 
 import django.core.validators

apps/insights/migrations/0002_jobinsight_weighted_evidence.py

@@ -1,3 +1,5 @@
+"""Add weighted evidence storage to generated job insights."""
+
 from django.db import migrations, models
 
 

apps/insights/migrations/__init__.py

@@ -0,0 +1 @@
+"""Migration package for the insights app."""

apps/jobs/migrations/0001_initial.py

@@ -1,3 +1,5 @@
+"""Create the initial jobs domain tables."""
+
 # Generated by Django 5.1.15 on 2026-05-28 10:44
 
 import django.db.models.deletion

apps/jobs/migrations/__init__.py

@@ -0,0 +1 @@
+"""Migration package for the jobs app."""

apps/roles/migrations/0001_initial.py

@@ -1,3 +1,5 @@
+"""Create the initial roles table."""
+
 # Generated by Django 5.1.15 on 2026-04-30 09:13
 
 from django.db import migrations, models

apps/roles/migrations/0002_role_code_alter_role_options_and_more.py

@@ -1,3 +1,5 @@
+"""Add stable role codes and update role metadata."""
+
 # Generated by Django 5.1.15 on 2026-05-26 09:45
 
 import re

apps/roles/migrations/__init__.py

@@ -0,0 +1 @@
+"""Migration package for the roles app."""