From 806c329345921b498c4d14d98fdc4b2b766ee9db Mon Sep 17 00:00:00 2001 From: Viktor Miller Date: Wed, 14 Jan 2026 18:44:16 +0900 Subject: [PATCH] docs: initialize ddhh-job-manager (7 phases) Closed job board for digital dabei Hamburg with provider self-registration, admin moderation, and mentor access. Phases: 1. Foundation & Setup: Plugin structure, CPT registration, custom role 2. Provider Registration & Auth: Registration form, login system, dashboard foundation 3. Job Management Core: Job submission, editing, moderation workflow 4. Job Deactivation System: Deactivation workflow with reason capture 5. Mentor Job Board: Protected archive, detail pages, apply system 6. Email Notifications: Admin alerts and mentor opt-in notifications 7. Testing & Polish: End-to-end testing, UI refinement, deployment prep Co-Authored-By: Claude Sonnet 4.5 --- .planning/ROADMAP.md | 116 +++++++++++++++++++++++++++++++++++++++++++ .planning/STATE.md | 57 +++++++++++++++++++++ 2 files changed, 173 insertions(+) create mode 100644 .planning/ROADMAP.md create mode 100644 .planning/STATE.md diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md new file mode 100644 index 0000000..8dce5ac --- /dev/null +++ b/.planning/ROADMAP.md @@ -0,0 +1,116 @@ +# Roadmap: Digital Dabei Job Manager + +## Overview + +Transform a WordPress site into a managed job board ecosystem. Providers self-register and submit job listings. Admins moderate every submission before publication. Mentors browse approved jobs and apply directly. The journey moves from foundation (plugin structure, roles) through provider workflows (registration, job management), mentor access (protected browsing, applications), and automation (email notifications) to a fully tested system ready for production. + +## Domain Expertise + +None + +## Phases + +- [ ] **Phase 1: Foundation & Setup** - Plugin structure, CPT registration, custom role +- [ ] **Phase 2: Provider Registration & Auth** - Registration form, login system, dashboard foundation +- [ ] **Phase 3: Job Management Core** - Job submission, editing, moderation workflow +- [ ] **Phase 4: Job Deactivation System** - Deactivation workflow with reason capture +- [ ] **Phase 5: Mentor Job Board** - Protected archive, detail pages, apply system +- [ ] **Phase 6: Email Notifications** - Admin alerts and mentor opt-in notifications +- [ ] **Phase 7: Testing & Polish** - End-to-end testing, UI refinement, deployment prep + +## Phase Details + +### Phase 1: Foundation & Setup +**Goal**: Plugin boilerplate, custom post type `job_offer`, custom role `ddhh_provider`, ACF field registration +**Depends on**: Nothing (first phase) +**Research**: Unlikely (WordPress plugin boilerplate, established patterns) +**Plans**: 3 plans + +Plans: +- [ ] 01-01: Plugin structure and activation hooks +- [ ] 01-02: Register `job_offer` CPT with capabilities +- [ ] 01-03: Register `ddhh_provider` role and ACF fields + +### Phase 2: Provider Registration & Auth +**Goal**: Formidable registration form with auto-login, login page, provider dashboard skeleton +**Depends on**: Phase 1 +**Research**: Likely (Formidable Forms integration) +**Research topics**: Formidable Registration Add-on setup, auto-login patterns, role assignment on registration +**Plans**: 4 plans + +Plans: +- [ ] 02-01: Formidable provider registration form (F1) +- [ ] 02-02: Login/registration page with combined view +- [ ] 02-03: Provider dashboard template (list own jobs) +- [ ] 02-04: Access control and redirects + +### Phase 3: Job Management Core +**Goal**: Job submission form, edit form, pending workflow, admin moderation, admin notification on submission +**Depends on**: Phase 2 +**Research**: Likely (Formidable Post Submission Add-on) +**Research topics**: Formidable post submission mapping to CPT, pending status workflow, ACF field integration +**Plans**: 4 plans + +Plans: +- [ ] 03-01: Job submission form (F2) with pending status +- [ ] 03-02: Job edit form (F3) with ownership validation +- [ ] 03-03: Admin notification hook on job submission +- [ ] 03-04: Admin moderation UI enhancements + +### Phase 4: Job Deactivation System +**Goal**: Deactivation form with reason capture, status update to draft, admin notification with reason +**Depends on**: Phase 3 +**Research**: Unlikely (internal workflow using established patterns from Phase 3) +**Plans**: 2 plans + +Plans: +- [ ] 04-01: Job deactivation form (F4) with reason field +- [ ] 04-02: Admin notification on deactivation with reason + +### Phase 5: Mentor Job Board +**Goal**: Protected job archive page, job detail page with logo, apply popup form, application email to provider +**Depends on**: Phase 3 +**Research**: Likely (Elementor integration) +**Research topics**: Elementor Loop Grid for CPT, custom query filters, popup form integration +**Plans**: 4 plans + +Plans: +- [ ] 05-01: Job archive Elementor template with access control +- [ ] 05-02: Job detail Elementor template with ACF fields +- [ ] 05-03: Apply popup form (F5) with email notification +- [ ] 05-04: Logo upload and auto-crop to 200x200px + +### Phase 6: Email Notifications +**Goal**: Mentor opt-in toggle, async email processing on job publish, notification to opted-in mentors +**Depends on**: Phase 5 +**Research**: Likely (async email processing) +**Research topics**: Action Scheduler setup, WP-Cron alternatives, bulk email patterns +**Plans**: 3 plans + +Plans: +- [ ] 06-01: Mentor notification opt-in user meta and toggle UI +- [ ] 06-02: Action Scheduler integration +- [ ] 06-03: Async email batch processing on job publish + +### Phase 7: Testing & Polish +**Goal**: End-to-end user flow testing, UI/UX refinement, production deployment checklist +**Depends on**: Phase 6 +**Research**: Unlikely (QA and refinement using existing code) +**Plans**: 3 plans + +Plans: +- [ ] 07-01: Provider flow end-to-end test (register → submit → deactivate) +- [ ] 07-02: Mentor flow end-to-end test (browse → apply) +- [ ] 07-03: Admin moderation flow test and deployment prep + +## Progress + +| Phase | Plans Complete | Status | Completed | +|-------|----------------|--------|-----------| +| 1. Foundation & Setup | 0/3 | Not started | - | +| 2. Provider Registration & Auth | 0/4 | Not started | - | +| 3. Job Management Core | 0/4 | Not started | - | +| 4. Job Deactivation System | 0/2 | Not started | - | +| 5. Mentor Job Board | 0/4 | Not started | - | +| 6. Email Notifications | 0/3 | Not started | - | +| 7. Testing & Polish | 0/3 | Not started | - | diff --git a/.planning/STATE.md b/.planning/STATE.md new file mode 100644 index 0000000..11e6db9 --- /dev/null +++ b/.planning/STATE.md @@ -0,0 +1,57 @@ +# Project State + +## Project Reference + +See: .planning/PROJECT.md (updated 2026-01-14) + +**Core value:** Every job goes through admin approval before mentors see it. The moderation flow is the trust layer that protects mentors from spam or inappropriate content. +**Current focus:** Phase 1 — Foundation & Setup + +## Current Position + +Phase: 1 of 7 (Foundation & Setup) +Plan: Not started +Status: Ready to plan +Last activity: 2026-01-14 — Project initialized + +Progress: ░░░░░░░░░░ 0% + +## Performance Metrics + +**Velocity:** +- Total plans completed: 0 +- Average duration: — +- Total execution time: 0 hours + +**By Phase:** + +| Phase | Plans | Total | Avg/Plan | +|-------|-------|-------|----------| +| — | — | — | — | + +**Recent Trend:** +- Last 5 plans: — +- Trend: — + +## Accumulated Context + +### Decisions + +Decisions are logged in PROJECT.md Key Decisions table. +Recent decisions affecting current work: + +(None yet) + +### Deferred Issues + +None yet. + +### Blockers/Concerns + +None yet. + +## Session Continuity + +Last session: 2026-01-14 +Stopped at: Roadmap created +Resume file: None