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 <noreply@anthropic.com>
This commit is contained in:
2026-01-14 18:44:16 +09:00
parent 4d462c60b1
commit 806c329345
2 changed files with 173 additions and 0 deletions

116
.planning/ROADMAP.md Normal file
View File

@@ -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 | - |

57
.planning/STATE.md Normal file
View File

@@ -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