LifeRPG_v2.0/modern/docs/admin-ops.md
Copilot 90750ee8df
Strip emoji from docs, fix XSS/hashing vulnerabilities, remediate all failing CI checks (#1)
* Initial plan

* Fix security vulnerabilities: MD5→SHA-256, XSS via dangerouslySetInnerHTML/innerHTML, insecure randomness, CodeQL config

Co-authored-by: TLimoges33 <125313326+TLimoges33@users.noreply.github.com>

* Clean up README: remove decorative emojis for a professional tone

Remove all emojis from section headers, list item prefixes, and
decorative positions. Replace  phase status markers with '(Complete)'
text. Keep the  in the final call-to-action line. No changes to
links, badges, code blocks, or technical content.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: remove emoji characters from CONTRIBUTING.md

Remove all emoji from section headers and closing line while
preserving links, code blocks, and technical content.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: remove emoji characters from documentation files

Remove all emoji characters from 8 documentation files in docs/.
Replace status-marker checkmarks () with '(Done)' text.
Remove decorative emojis from headers and body text entirely.
Preserve emojis inside code blocks unchanged.
Clean up trailing whitespace introduced by removals.

Files modified:
- DEPLOYMENT_GUIDE.md
- IMPLEMENTATION_PLAN.md
- MILESTONE_6_SUMMARY.md
- PRODUCTION_ROADMAP.md
- PROJECT_STATUS.md
- REPOSITORY_ENHANCEMENT.md
- ROADMAP.md
- SECURITY_AUDIT_ROADMAP.md

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: remove emoji characters from documentation files

Remove all emoji characters from 9 markdown files while preserving
code block content (box-drawing characters, indentation). Emojis
removed from headers, list items, and body text across READMEs,
issue templates, PR template, runbook, and mobile docs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Remove excessive emoji from all documentation for professional presentation

Co-authored-by: TLimoges33 <125313326+TLimoges33@users.noreply.github.com>

* Fix PluginWidget initial state and remove || true from security audit steps

Co-authored-by: TLimoges33 <125313326+TLimoges33@users.noreply.github.com>

* Remediate all failing CI checks: update deprecated actions, fix npm vulnerabilities, fix migrations YAML

Co-authored-by: SynOSdev <257853113+SynOSdev@users.noreply.github.com>

* Fix all remaining CI failures: Node 18→20, fix test API contract, fix pytest version, fix Postgres health checks

Co-authored-by: SynOSdev <257853113+SynOSdev@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: TLimoges33 <125313326+TLimoges33@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: SynOSdev <257853113+SynOSdev@users.noreply.github.com>
2026-03-14 08:59:37 -04:00

1.4 KiB

Admin operations guide

This page summarizes admin/ops capabilities and where to find them.

API endpoints (all under /api/v1):

  • GET /admin/orchestration — current in-flight counts, queue depths, effective provider caps, and RQ queue length.
  • GET/POST /admin/provider_caps — view/update per-provider concurrency caps (persisted); reflected in metrics and enqueue logic.
  • GET /admin/hooks/schema — JSON schema and examples for hooks configuration to aid validation.
  • POST /admin/hooks/validate — validate a hooks object server-side before saving.
  • GET /admin/email/health — show email transport config and attempt an SMTP handshake when enabled.
  • POST /admin/email/test — send a test email to verify delivery.

Frontend UI:

  • Integrations page includes:
  • Provider caps editor (view/edit) and orchestration summary with manual refresh, auto-refresh, sorting, and cap utilization badges.
  • Hooks editor with example prefill and server-side validation, showing inline errors.
  • Admin settings controls for integration close mode and default sync interval.

Metrics to watch (Prometheus):

  • sync_inflight, sync_queue_depth, sync_provider_cap, rq_queue_length
  • sync_enqueue_skips_total{reason}
  • sync_job_duration_seconds (histogram by provider,result)

Alerts (Prometheus examples in ops/prometheus-alerts.yaml):

  • Provider at cap for sustained periods
  • Queue depth increasing
  • RQ queue backlog sustained
  • Slow syncs (p95 duration) exceeding threshold