Project: Platform Playbook
Vision
The repeatable pipeline from idea to production on the pal-e platform. A prescriptive playbook covering web, iOS, and Android — Rails, Keycloak, Postmark, Turbo Native. Both SOP documentation and a living project tracker with scorecards for each app (ISS, Landscaping, WKQ).
User Stories
| Key | Role | Goal | Success metric |
|---|---|---|---|
| playbook-docs | Platform operator | Prescriptive docs with mermaid diagrams covering the full pipeline from DNS to DORA | 12 docs under docs/ — each with architecture diagrams, code templates, and ISS as reference implementation |
| logo-branding | Platform operator | Generate and manage brand assets through Claude Code MCP tools | Logo pipeline from Recraft generation through MinIO storage working end-to-end via MCP |
| ios-iac | Platform operator | IaC coverage for App Store Connect — from app creation through beta to App Store submission | 16 ASC resources declared in appstoreconnect-tofu, landscaping-assistant fully imported, chapters 13+14 document IaC/readiness/SOP workflow |
| app-store-submission | Platform operator | Get landscaping-assistant through App Store review — landing page, auth domain, Keycloak config | App accepted in App Store, public auth flow working end-to-end, login/registration functional from public network |
Architecture
Pure documentation repo — no app code. 12 playbook docs under
docs/, 3 scorecard directories under scorecards/. Docs reference but do not modify source repos: pal-e-platform, pal-e-services, pal-e-deployments, intelligentstaffingsystems, landscaping-assistant, westside-basketball.Board
Status
- README and directory structure merged (issue #1)
- Scorecards merged for ISS (#7), Landscaping (#6), WKQ (#5)
- Infrastructure pipeline docs merged — #8 (PR #14): dns-domain, platform-provisioning, services-wiring, deployment-overlays
- App layer docs merged — #9 (PR #16): rails-app, auth-login, ci-cd
- Platform services docs merged — #10 (PR #15): mobile, observability, dora-metrics
- Overview + checklist merged — #11 (PR #17): overview, checklist, README update
- Playbook complete. All 12 docs and 3 scorecards shipped. M4 achieved.
- Logo & Branding chapter merged — #25 (PR #26): optional chapter A, reference doc, Recraft + MinIO workflow
- iOS IaC story started — appstoreconnect-tofu provider built (#4), ASC API scope doc added (#30), 16 IaC resources identified from API ground truth
Milestones
- M1: Scorecards merged (complete)
- M2: Infrastructure pipeline docs (complete — PR #14)
- M3: App layer + platform services docs (complete — PRs #15, #16)
- M4: Overview + checklist (complete — PR #17) — playbook complete
Repos
| Repo | Platform | Role | Status |
|---|---|---|---|
| ldraney/platform-playbook | Forgejo | Playbook docs and scorecards | Active |
| ldraney/appstoreconnect-tofu | Forgejo | OpenTofu provider for App Store Connect API | Active |
| ldraney/recraft-sdk | Forgejo | Pytest SDK proving Recraft API | Active |
| ldraney/minio-mcp | Forgejo | MCP server wrapping minio-sdk | Active |
| ldraney/recraft-mcp | Forgejo | MCP server wrapping recraft-sdk | Active |