Tests, docs, dev runbook & CI

[mehalyna]

Task 10 — Tests, docs, dev runbook & CI

Title: qa+docs: tests, OpenAPI docs, dev runbook and CI integrations

Deliverables

• Unit tests for service layer (Task 3), Channels consumer tests (Task 4), REST endpoints (Task 5), notification hooks (Task 6), and moderation (Task 9).

• Integration tests simulating:

  • WebSocket two-client conversation exchange,
  • Delivery/read/ack flow,
  • Offline notification creation.

• Fixtures: fixtures/messaging/ with sample conversations/messages.

• OpenAPI additions for REST endpoints and example WebSocket messages (a short spec).

• Dev runbook docs/dev/messaging.md with:

  • how to run Redis+Mongo locally (docker-compose snippet),
  • how to run Channels worker,
  • how to test WebSocket flows (sample curl / wscat commands),
  • how to inspect Mongo data.

• Ensure tests run in CI and include a smoketest for messaging flows.

Acceptance

• Tests pass in CI.
• Doc committed and clear instructions to run locally.