Add a sequence diagram for the audit request lifecycle

[mikewheeleer]

Diagram audit

Description

audit's request lifecycle (middleware -> handler -> service -> repo) isn't visualized. This issue adds a diagram.

Requirements and context

• Repository scope: Talenttrust/Talenttrust-Backend only.
• Add a docs section with a sequence diagram of the audit request lifecycle.
• Keep it accurate to the code.
• Link from the docs index.

Suggested execution

• Fork the repo and create a branch
• git checkout -b docs/audit-61-seqdiagram
• Implement changes
  • Write code in: the relevant module.
  • Write comprehensive tests in: cover the new behaviour and edge cases.
• Test and commit

Test and commit

• Run npm run lint, npm test, and npm run build.
• Cover edge cases: n/a — verify against code.
• Include the full test output in the PR description.

Example commit message

docs(audit): add sequence diagram

Guidelines

• Minimum 95 percent test coverage for impacted modules.
• Clear, reviewer-focused documentation.
• Timeframe: 96 hours.

Community & contribution rewards

• 💬 Join the TalentTrust community on Discord: https://discord.gg/WqnGpcPx
• ⭐ This is a GrantFox OSS / Official Campaign task and may be rewarded. When your PR is merged you'll be prompted to rate the project — a 5-star rating is much appreciated.

[drips-wave]

@mikewheeleer This issue could not be added to the Stellar Wave Program because the per-repo points budget would be exceeded (25000 / 25000 points already used). The label has been automatically removed.

The budget resets at the end of each Wave. You can review the remaining budget for your repos on the Orgs & Repos page.

ℹ️ Learn more about points budgets