Community Operations Platform Showcase

This repository is being refactored from a single showcase app into a curated showcase hub.

The goal is to make this repository the single source of truth for portfolio-ready project extracts, evidence, architecture notes, and runnable showcase assets around the broader community-operations-platform work.

The canonical project entrypoint is now projects/community-operations-platform.

Current state

The repository root is now primarily for:

• repository identity
• reviewer navigation
• method and planning documentation
• portfolio positioning
• project routing

The project-specific implementation assets now live inside projects/community-operations-platform.

New canonical structure

The target structure for the refactor starts at the repository root:

• docs/bootstrap: project brief, scope boundaries, milestones
• docs/architecture: showcase information architecture and repo rules
• portfolio: cross-project positioning and curation guidance
• projects: curated project folders
• projects/community-operations-platform: canonical folder for this project's curated materials

Planning baseline

This repository now follows a DAD-M-inspired bootstrap flow:

1. Define the project brief.
2. Define safety boundaries.
3. Define milestones.
4. Keep planning artifacts explicit.
5. Refactor the structure milestone by milestone instead of doing a blind big-bang move.

See:

• docs/bootstrap/project-brief.md
• docs/bootstrap/safety-boundaries.md
• docs/bootstrap/milestones.md
• docs/architecture/showcase-information-architecture.md

Reviewer start point

The preferred reviewer path is now:

1. this root README
2. projects/community-operations-platform
3. one of overview, extracts, evidence, or roadmap

Run

cd projects/community-operations-platform
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python -m app.main

Tests:

cd projects/community-operations-platform
QT_QPA_PLATFORM=offscreen .venv/bin/python -m pytest tests