feat: add event-linked Q&A

Closes #215

Author: alexeygrigorev

_docs/api/admin-openapi.json

@@ -23,6 +23,8 @@
 SPONSORS_READ = "core.read_sponsors"
 SPONSORS_WRITE = "core.change_sponsors"
 SPONSORS_EXPORT = "core.export_sponsors"
+EVENT_QNA_VIEW = "events.view_event_qna"
+EVENT_QNA_MANAGE = "events.manage_event_qna"
 
 _ROLE_PERMISSIONS: Mapping[str, frozenset[str]] = MappingProxyType(
     {
@@ -33,6 +35,8 @@
                 MANAGE_API_CREDENTIALS,
                 HISTORICAL_REGISTRATION_IMPORT_MANAGE,
                 HISTORICAL_REGISTRATION_MAPPING_MANAGE,
+                EVENT_QNA_VIEW,
+                EVENT_QNA_MANAGE,
                 COURSE_REGISTRATION_COUNT_BASELINE_MANAGE,
                 SITE_SETTINGS_READ,
                 SITE_SETTINGS_WRITE,
@@ -55,14 +59,14 @@
                 SPONSORS_EXPORT,
             }
         ),
-        "course_operator": frozenset(
-            {STUDIO_ACCESS, COURSE_REGISTRATION_COUNT_BASELINE_MANAGE}
-        ),
+        "course_operator": frozenset({STUDIO_ACCESS, COURSE_REGISTRATION_COUNT_BASELINE_MANAGE}),
         "event_operator": frozenset(
             {
                 STUDIO_ACCESS,
                 HISTORICAL_REGISTRATION_IMPORT_MANAGE,
                 HISTORICAL_REGISTRATION_MAPPING_MANAGE,
+                EVENT_QNA_VIEW,
+                EVENT_QNA_MANAGE,
             }
         ),
         "email_operator": frozenset({STUDIO_ACCESS}),

_docs/architecture/event-qna-integration.md

@@ -68,6 +68,8 @@ def test_create_and_reconcile_are_exact_idempotent_and_secret_safe(self) -> None
                 ("management_auth", "manage_api_credentials"),
                 ("events", "historical_registration_import_manage"),
                 ("events", "historical_registration_mapping_manage"),
+                ("events", "view_event_qna"),
+                ("events", "manage_event_qna"),
                 ("courses", "registration_count_baseline_manage"),
                 ("core", "read_operational_settings"),
                 ("core", "change_operational_settings"),

accounts/studio_roles.py

@@ -12,7 +12,14 @@ def run(selection_path: str) -> None:
     if selection["profile"] != "focused":
         raise ValueError("the focused runner requires profile=focused")
     subprocess.run(
-        [sys.executable, "manage.py", "test", *selection["test_labels"]],
+        [
+            sys.executable,
+            "manage.py",
+            "test",
+            "--parallel",
+            "--noinput",
+            *selection["test_labels"],
+        ],
         check=True,
     )
 

accounts/tests/test_development_owner.py

@@ -65,7 +65,7 @@
     {"id":"app.management_api","kind":"owner","prefixes":["management_api/"],"exact":[],"downstream":["django.api","django.management_api","django.studio"],"components":["container","django","playwright","quality"],"environment_dimensions":["architecture","database","django","operating_system","python","runner_image","uv"],"validity_class":"standard","risk_flags":[],"render_flags":[]},
     {"id":"app.management_auth","kind":"owner","prefixes":["management_auth/"],"exact":[],"downstream":["django.accounts","django.api","django.core","django.management_api","django.management_auth","django.studio"],"components":["container","django","playwright","quality"],"environment_dimensions":["architecture","database","django","operating_system","python","runner_image","uv"],"validity_class":"standard","risk_flags":[],"render_flags":[]},
     {"id":"app.review_import","kind":"owner","prefixes":["review_import/"],"exact":[],"downstream":["django.accounts","django.courses","django.review_import"],"components":["container","django","playwright","quality"],"environment_dimensions":["architecture","database","django","operating_system","python","runner_image","uv"],"validity_class":"standard","risk_flags":[],"render_flags":[]},
-    {"id":"app.studio","kind":"owner","prefixes":["studio/"],"exact":[],"downstream":["django.accounts","django.core","django.studio"],"components":["container","django","playwright","quality"],"environment_dimensions":["architecture","database","django","operating_system","python","runner_image","uv"],"validity_class":"standard","risk_flags":[],"render_flags":[]},
+    {"id":"app.studio","kind":"owner","prefixes":["studio/"],"exact":[],"downstream":["django.accounts","django.core","django.events","django.studio"],"components":["container","django","playwright","quality"],"environment_dimensions":["architecture","database","django","operating_system","python","runner_image","uv"],"validity_class":"standard","risk_flags":[],"render_flags":[]},
 
     {"id":"shared.accounts","kind":"owner","prefixes":["accounts/"],"exact":[],"downstream":[],"components":["container","django","playwright","quality"],"environment_dimensions":["architecture","database","django","operating_system","python","runner_image","uv"],"validity_class":"standard","risk_flags":["shared_runtime","auth_security_privacy"],"render_flags":[]},
     {"id":"shared.core","kind":"owner","prefixes":["core/"],"exact":[],"downstream":[],"components":["container","django","playwright","quality"],"environment_dimensions":["architecture","database","django","operating_system","python","runner_image","uv"],"validity_class":"standard","risk_flags":["shared_runtime"],"render_flags":[]},

ci/focused_tests.py

@@ -227,7 +227,9 @@ def test_json_and_summary_are_deterministic_and_do_not_include_filenames(tmp_pat
     assert json.loads(first.read_text(encoding="utf-8")) == selection
 
 
-def test_focused_runner_uses_one_process_and_only_validated_labels(tmp_path: Path) -> None:
+def test_focused_runner_uses_parallel_noninteractive_command_and_only_validated_labels(
+    tmp_path: Path,
+) -> None:
     selection = classify_records(
         (ChangeRecord("M", ("content/a.py",)),), event="push", base=BASE, head=HEAD
     )
@@ -242,6 +244,8 @@ def test_focused_runner_uses_one_process_and_only_validated_labels(tmp_path: Pat
             focused_tests.sys.executable,
             "manage.py",
             "test",
+            "--parallel",
+            "--noinput",
             "accounts",
             "content.tests",
             "content_sync",

ci/ownership.json

@@ -1,5 +1,7 @@
 from django.urls import path, re_path
 
+from events.qna import views as qna_views
+
 from . import legal_views, public_views
 
 urlpatterns = [
@@ -102,6 +104,49 @@
         public_views.event_legacy_redirect,
         name="public-event-legacy-trailing-slash",
     ),
+    # Event-linked Q&A routes must precede the generic event detail route.  The
+    # public numeric ID and current title slug remain the only Event lookup
+    # inputs; the slug is cosmetic and stale spellings redirect on HTML only.
+    re_path(
+        r"^events/(?P<event_id>[1-9][0-9]*)/(?P<slug>[-a-zA-Z0-9_]+)/qna/$",
+        qna_views.public_qna,
+        name="public-event-qna",
+    ),
+    re_path(
+        r"^events/(?P<event_id>[1-9][0-9]*)/(?P<slug>[-a-zA-Z0-9_]+)/qna/api/questions/$",
+        qna_views.qna_questions,
+        name="public-event-qna-questions",
+    ),
+    re_path(
+        r"^events/(?P<event_id>[1-9][0-9]*)/(?P<slug>[-a-zA-Z0-9_]+)/qna/api/questions/(?P<question_id>[-A-Za-z0-9_]+)/$",
+        qna_views.qna_question,
+        name="public-event-qna-question",
+    ),
+    re_path(
+        r"^events/(?P<event_id>[1-9][0-9]*)/(?P<slug>[-a-zA-Z0-9_]+)/qna/api/questions/(?P<question_id>[-A-Za-z0-9_]+)/vote/$",
+        qna_views.qna_vote,
+        name="public-event-qna-vote",
+    ),
+    re_path(
+        r"^events/(?P<event_id>[1-9][0-9]*)/(?P<slug>[-a-zA-Z0-9_]+)/qna/cohost/(?P<name>[a-zA-Z0-9-]+)/$",
+        qna_views.qna_cohost_gate,
+        name="public-event-qna-cohost",
+    ),
+    re_path(
+        r"^events/(?P<event_id>[1-9][0-9]*)/(?P<slug>[-a-zA-Z0-9_]+)/qna/host/$",
+        qna_views.qna_host,
+        name="public-event-qna-host",
+    ),
+    re_path(
+        r"^events/(?P<event_id>[1-9][0-9]*)/(?P<slug>[-a-zA-Z0-9_]+)/qna/present/$",
+        qna_views.qna_present,
+        name="public-event-qna-present",
+    ),
+    re_path(
+        r"^events/(?P<event_id>[1-9][0-9]*)/(?P<slug>[-a-zA-Z0-9_]+)/qna/qr\.(?P<kind>svg|png)$",
+        qna_views.qna_qr,
+        name="public-event-qna-qr",
+    ),
     re_path(
         r"^events/(?P<event_id>[1-9][0-9]*)/(?P<slug>[-a-zA-Z0-9_]+)$",
         public_views.event_detail,

ci/tests/test_selection.py

@@ -32,6 +32,7 @@
     resolve_public_id,
     resolve_uuid,
 )
+from events.models import EventQnaSession
 from events.services import public_registration_total
 
 from . import wiki_content
@@ -392,6 +393,13 @@ def event_detail(request: HttpRequest, event_id: str, slug: str) -> HttpResponse
     if event["ends_at"]:
         entity["endDate"] = event["ends_at"]
     registration_total = public_registration_total(event)
+    qna_url = ""
+    qna_session = EventQnaSession.objects.filter(event_id=identity.id).first()
+    if qna_session is not None and qna_session.state in {
+        EventQnaSession.State.OPEN,
+        EventQnaSession.State.CLOSED,
+    }:
+        qna_url = f"{event['public_path']}/qna/"
     response = _render(
         request,
         "public/event_detail.html",
@@ -402,6 +410,7 @@ def event_detail(request: HttpRequest, event_id: str, slug: str) -> HttpResponse
             "event": event,
             "event_state": event_state,
             "registration_total": registration_total,
+            "qna_url": qna_url,
             "og_type": "event",
             "structured_data": _json_ld(
                 entity,

content/public_urls.py

@@ -288,6 +288,7 @@ def template_readability_issues(source: str) -> list[str]:
     "templates/404.html": "public",
     "templates/core": "public",
     "templates/public": "public",
+    "templates/events": "public",
     "templates/review": "public-review",
     "templates/studio": "studio",
     "templates/registration": "account",