cmsPRO/.paul/phases/04-domain-authors-newsletter/04-01-SUMMARY.md at 8f6d084b4d8ab90c03b33ce18df23fffe1f64cd0

Files

Jacek Pyziak ffe661b4d2 feat(domain): Domain\Authors + Domain\Newsletter repositories z wrapper delegation

Phase 4 complete:
- AuthorsRepository: simpleList, authorDetails, authorSave, authorDelete, authorByLang
- NewsletterRepository: 14 methods — subscriber lifecycle, templates, sending
- 4 legacy factories converted to thin wrappers
- Globals ($settings, $lang) passed as explicit params to repo methods

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-04 18:21:32 +02:00

3.8 KiB

Raw Blame History

phase, plan, subsystem, tags, requires, provides, affects, tech-stack, key-files, key-decisions, patterns-established, duration, started, completed

phase

plan

subsystem

tags

requires

provides

affects

tech-stack

key-files

key-decisions

patterns-established

duration

started

completed

04-domain-authors-newsletter

domain

medoo

repository

authors

newsletter

wrapper-delegation

phase	provides
01-infrastructure	PSR-4 autoloader for Domain\ namespace

Domain\Authors\AuthorsRepository

Domain\Newsletter\NewsletterRepository

phase-10-admin-banners-authors-scontainers

phase-11-admin-newsletter-emails-seoadditional

added

patterns

wrapper-delegation

globals-to-parameters

created

modified

autoload/Domain/Authors/AuthorsRepository.php

autoload/Domain/Newsletter/NewsletterRepository.php

autoload/admin/factory/class.Authors.php

autoload/admin/factory/class.Newsletter.php

autoload/front/factory/class.Authors.php

autoload/front/factory/class.Newsletter.php

Newsletter methods using global $settings/$lang now take them as explicit parameters

authorByLang cache key preserved from original (no langId in key)

Globals-to-parameters: when repo method needs $settings or $lang, wrapper passes them explicitly

~2min

2026-04-04T00:00:00Z

Domain repositories for Authors (5 methods) and Newsletter (14 methods) with wrapper delegation and globals-to-parameters pattern.

Performance

Metric	Value
Duration	~2min
Tasks	2 completed (delegated)
Files created	2
Files modified	4

Acceptance Criteria Results

Criterion	Status	Notes
AC-1: AuthorsRepository exists with all methods	Pass	5 methods, 156 lines
AC-2: NewsletterRepository exists with all methods	Pass	14 methods, 281 lines
AC-3: Legacy admin factories delegate to repositories	Pass	11 static methods → wrappers
AC-4: Legacy front factories delegate to repositories	Pass	8 static methods → wrappers, globals passed as params

Accomplishments

Created AuthorsRepository with simpleList, authorDetails, authorSave, authorDelete, authorByLang
Created NewsletterRepository with full subscriber lifecycle + template CRUD + sending
Established globals-to-parameters pattern for methods needing $settings/$lang

Files Created/Modified

File	Change	Purpose
`autoload/Domain/Authors/AuthorsRepository.php`	Created	Domain repository for authors CRUD + cached front read
`autoload/Domain/Newsletter/NewsletterRepository.php`	Created	Domain repository for newsletter subscriber lifecycle, templates, sending
`autoload/admin/factory/class.Authors.php`	Modified	Wrapper: 4 methods delegate to AuthorsRepository
`autoload/admin/factory/class.Newsletter.php`	Modified	Wrapper: 7 methods delegate to NewsletterRepository
`autoload/front/factory/class.Authors.php`	Modified	Wrapper: 1 method delegates
`autoload/front/factory/class.Newsletter.php`	Modified	Wrapper: 7 methods delegate, passing $settings/$lang

Decisions Made

Decision	Rationale	Impact
Globals as parameters for newsletterSend/signin	Repos should not depend on globals	Front wrappers pass $settings, $lang explicitly
Preserve original cache key for authorByLang	Backward compatibility with existing cache	Cache key "get_single_author:$id" without langId

Deviations from Plan

None — plan executed exactly as written.

Issues Encountered

None.

Next Phase Readiness

Ready:

Domain\Authors and Domain\Newsletter available for Admin controllers (Phases 10, 11)
All Domain repos for phases 3-4 complete

Concerns:

None

Blockers:

None

Phase: 04-domain-authors-newsletter, Plan: 01 Completed: 2026-04-04

3.8 KiB Raw Blame History

Phase 4 Plan 01: Authors + Newsletter Repositories Summary