Project-Pro/cmsPRO
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
47abff255088dcd7628f3c33eab282049ff58bb5
cmsPRO/.paul/ROADMAP.md
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

9.3 KiB
Raw Blame History

Roadmap: cmsPRO

Overview

Pełna refaktoryzacja cmsPRO do architektury DDD wzorowanej na shopPRO. Wzorzec: wrapper delegation — stare klasy delegują do nowych, zero regresji. Referencja: C:\visual studio code\projekty\shopPRO. PHP < 8.0 (produkcja).

Current Milestone

v0.1 Refaktoryzacja (v0.1.0) Status: In progress Phases: 4 of 19 complete

Already Completed (before PAUL)

  • Domain (6 repos): Articles, Languages, Layouts, Pages, Settings, User
  • Shared (5 modules): Cache, Helpers, Html, Image, Tpl
  • Form Edit System: Universal form handling framework (FormEditViewModel, multi-tab, validation)
  • PHPUnit base: Bootstrap, 3 test files (Languages, Settings, User)

Phases

Phase Name Plans Status Completed
1 Infrastructure & Autoloader 1 Complete 2026-04-04
2 Shared: Email + Security 1 Complete 2026-04-04
3 Domain: Scontainers + Banners 1 Complete 2026-04-04
4 Domain: Authors + Newsletter 1 Complete 2026-04-04
5 Domain: SeoAdditional + Cron + Releases 1 Not started -
6 Admin: Base Infrastructure 1 Not started -
7 Admin: Articles + ArticlesArchive 1 Not started -
8 Admin: Pages + Layouts 1 Not started -
9 Admin: Languages + Settings 1 Not started -
10 Admin: Banners + Authors + Scontainers 1 Not started -
11 Admin: Newsletter + Emails + SeoAdditional 1 Not started -
12 Admin: Users + Backups + Filemanager 1 Not started -
13 Admin: Releases + Update 1 Not started -
14 Front: Site + Articles 1 Not started -
15 Front: Pages + Menu + Banners + Scontainers 1 Not started -
16 Front: Remaining modules 1-2 Not started -
17 Users & Security: HMAC-SHA256 1 Not started -
18 Tests 1-2 Not started -
19 Legacy Cleanup 1 Not started -

Phase Details

Phase 1: Infrastructure & Autoloader

Goal: Centralny autoloader (PSR-4 + legacy), composer.json z mapowaniem, usunięcie duplikatów z entry pointów. Depends on: Nothing (first phase) Research: Unlikely

Scope:

  • autoload/autoloader.php (hybrydowy)
  • composer.json PSR-4: Domain, Shared, Admin, Frontend\
  • Migracja 6 entry pointów (index.php, admin/index.php, ajax.php, api.php, cron.php, download.php)

Plans:

  • 01-01: PSR-4 autoloader setup i composer.json

Phase 2: Shared: Email + Security

Goal: Dodać brakujące moduły Shared — Email (migracja z legacy) i Security (CsrfToken, wzór shopPRO). Depends on: Phase 1 (autoloader) Research: Unlikely

Scope:

  • Shared\Email\Email — migracja z legacy
  • Shared\Security\CsrfToken — nowy moduł (wzór shopPRO)
  • Wrapper w starym class.Email.php (jeśli istnieje)

Plans:

  • 02-01: Email + Security modules

Phase 3: Domain: Scontainers + Banners

Goal: Repository dla Scontainers i Banners — przeniesienie logiki z factory do Domain. Depends on: Phase 1 (autoloader) Research: Unlikely (wzorzec ustalony)

Scope:

  • Domain\Scontainers\ScontainersRepository
  • Domain\Banners\BannersRepository
  • Wrappery w starych factory (delegacja)

Plans:

  • 03-01: Scontainers + Banners repositories

Phase 4: Domain: Authors + Newsletter

Goal: Repository dla Authors i Newsletter. Depends on: Phase 1 Research: Unlikely

Scope:

  • Domain\Authors\AuthorsRepository
  • Domain\Newsletter\NewsletterRepository

Plans:

  • 04-01: Authors + Newsletter repositories

Phase 5: Domain: SeoAdditional + Cron + Releases

Goal: Repository dla SEO, Cron, i systemu Releases/Update. Depends on: Phase 1 Research: Unlikely

Scope:

  • Domain\SeoAdditional\SeoAdditionalRepository
  • Domain\Cron\CronRepository
  • Domain\Releases\ReleasesRepository (lub Update)

Plans:

  • 05-01: SeoAdditional + Cron + Releases repositories

Phase 6: Admin: Base Infrastructure

Goal: Bazowe klasy Admin\ — kontrolery bazowe, TableListRequestFactory, FormValidator (wzór shopPRO). Depends on: Phase 1 (autoloader), Form Edit System (already done) Research: Likely (analiza shopPRO Admin base classes)

Scope:

  • Admin\Base\BaseController (lub abstrakcyjna klasa bazowa)
  • Admin\Support\TableListRequestFactory
  • Admin\Support\FormValidator
  • Integracja z istniejącym FormEditViewModel

Plans:

  • 06-01: Admin base infrastructure

Phase 7: Admin: Articles + ArticlesArchive

Goal: Migracja kontrolerów Articles i ArticlesArchive do Admin\ z DI. Depends on: Phase 6 (Admin base), Phase 1 (Domain\Articles already exists) Research: Unlikely

Scope:

  • Admin\Articles\ArticlesController
  • Admin\Articles\ArticlesArchiveController
  • Wrapper w starym controls/class.Articles.php

Plans:

  • 07-01: Articles admin controllers

Phase 8: Admin: Pages + Layouts

Goal: Migracja kontrolerów Pages i Layouts do Admin. Depends on: Phase 6 Research: Unlikely

Scope:

  • Admin\Pages\PagesController
  • Admin\Layouts\LayoutsController

Plans:

  • 08-01: Pages + Layouts admin controllers

Phase 9: Admin: Languages + Settings

Goal: Migracja kontrolerów Languages i Settings do Admin. Depends on: Phase 6 Research: Unlikely

Scope:

  • Admin\Languages\LanguagesController
  • Admin\Settings\SettingsController

Plans:

  • 09-01: Languages + Settings admin controllers

Phase 10: Admin: Banners + Authors + Scontainers

Goal: Migracja kontrolerów Banners, Authors, Scontainers do Admin. Depends on: Phase 6, Phase 3 (Domain repos), Phase 4 (Domain repos) Research: Unlikely

Scope:

  • Admin\Banners\BannersController
  • Admin\Authors\AuthorsController
  • Admin\Scontainers\ScontainersController

Plans:

  • 10-01: Banners + Authors + Scontainers admin controllers

Phase 11: Admin: Newsletter + Emails + SeoAdditional

Goal: Migracja kontrolerów Newsletter, Emails, SeoAdditional do Admin. Depends on: Phase 6, Phase 4, Phase 5 Research: Unlikely

Scope:

  • Admin\Newsletter\NewsletterController
  • Admin\Emails\EmailsController
  • Admin\SeoAdditional\SeoAdditionalController

Plans:

  • 11-01: Newsletter + Emails + SeoAdditional admin controllers

Phase 12: Admin: Users + Backups + Filemanager

Goal: Migracja kontrolerów Users, Backups, Filemanager do Admin. Depends on: Phase 6 Research: Unlikely

Scope:

  • Admin\Users\UsersController
  • Admin\Backups\BackupsController
  • Admin\Filemanager\FilemanagerController

Plans:

  • 12-01: Users + Backups + Filemanager admin controllers

Phase 13: Admin: Releases + Update

Goal: Migracja kontrolerów Releases i Update do Admin. Depends on: Phase 6, Phase 5 (Domain repos) Research: Unlikely

Scope:

  • Admin\Releases\ReleasesController
  • Admin\Update\UpdateController

Plans:

  • 13-01: Releases + Update admin controllers

Phase 14: Front: Site + Articles

Goal: Migracja głównych kontrolerów front — Site i Articles do Frontend. Depends on: Phase 1 (autoloader), Domain repos Research: Unlikely

Scope:

  • Frontend\Site\SiteController (lub controls + factory + view)
  • Frontend\Articles\ArticlesController
  • LayoutEngine (jeśli potrzebny, wzór shopPRO)

Plans:

  • 14-01: Site + Articles frontend controllers

Phase 15: Front: Pages + Menu + Banners + Scontainers

Goal: Migracja front kontrolerów Pages, Menu, Banners, Scontainers. Depends on: Phase 14 (Front base) Research: Unlikely

Scope:

  • Frontend\Pages, Frontend\Menu, Frontend\Banners, Frontend\Scontainers

Plans:

  • 15-01: Pages + Menu + Banners + Scontainers frontend

Phase 16: Front: Remaining modules

Goal: Migracja pozostałych front modułów — Authors, Languages, Newsletter, Search, AuditSEO, SeoAdditional, Layouts, Settings. Depends on: Phase 14 Research: Unlikely

Scope:

  • Wszystkie pozostałe front factories/controls/views

Plans:

  • 16-01: Remaining frontend modules (batch 1)
  • 16-02: Remaining frontend modules (batch 2, if needed)

Phase 17: Users & Security: HMAC-SHA256

Goal: Wymiana insecure remember-me cookies (hash w JSON) na HMAC-SHA256 signed tokens. Depends on: Phase 2 (Shared\Security), Phase 12 (Admin\Users) Research: Likely (strategia migracji istniejących cookies, backward compat)

Scope:

  • Nowy system remember-me z HMAC-SHA256
  • Migracja istniejących sesji/cookies
  • Security hardening w UserRepository

Plans:

  • 17-01: HMAC-SHA256 cookie system

Phase 18: Tests

Goal: Rozbudowa PHPUnit testów dla nowych Domain repositories i Admin controllers. Depends on: Phase 5 (all Domain repos), Phase 13 (all Admin controllers) Research: Unlikely

Scope:

  • Testy dla nowych Domain repositories
  • Testy dla Admin controllers (unit)
  • Rozbudowa test bootstrap

Plans:

  • 18-01: Domain repository tests
  • 18-02: Admin controller tests

Phase 19: Legacy Cleanup

Goal: Usunięcie legacy wrapperów i starych class.*.php po weryfikacji że cały kod używa nowych klas. Depends on: All prior phases Research: Unlikely

Scope:

  • Usunięcie wrapperów z class.*.php
  • Usunięcie starych controls/factory/view plików
  • Finalna weryfikacja i cleanup

Plans:

  • 19-01: Legacy wrapper removal and cleanup

Roadmap created: 2026-04-04 Last updated: 2026-04-04

Reference in New Issue View Git Blame Copy Permalink