Files
cmsPRO/.paul/codebase/overview.md
Jacek Pyziak bf4b7c6429 docs(codebase): mapa kodu wygenerowana przez /paul:map-codebase
7 dokumentów w .paul/codebase/ — overview, stack, architecture,
conventions, testing, integrations, concerns (CRITICAL→LOW).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-26 00:46:01 +02:00

2.2 KiB

cmsPRO — Project Overview

Generated: 2026-04-26 | Milestone: v0.1 Refaktoryzacja

What is cmsPRO?

cmsPRO is a Polish-language PHP CMS with a hybrid transitional architecture. The codebase is actively being refactored from a legacy procedural/OOP mixed approach toward a clean Domain-Driven Design structure with Repository pattern.

Core Capabilities

Module Description
Articles CRUD, multi-language, versioning, scheduling, galleries, tags, SEO
Pages Static pages with layouts, caching, inline editing
Newsletter Subscription, templates, cron-based batch sending
Layouts HTML/CSS template system with Savant3 rendering
Users Admin users, privileges matrix, 2FA support
Languages Multi-language content, URL routing, session caching
Banners Homepage banners with multi-language support
Scontainers Reusable content blocks/widgets
Authors Author management for articles
SEO Meta tags, slugs, noindex, robots.txt, sitemap
File Manager Upload, browse, thumbnail generation
Settings DB-stored site config, WebP toggle, lazy loading
Updates Versioned ZIP updates with license validation
Backups DB backup/restore utilities

Entry Points

File Purpose
index.php Frontend entry point and router
admin/index.php Admin panel entry point
ajax.php Frontend AJAX handler
admin/ajax.php Admin AJAX handler (routes to admin/ajax/*.php)
api.php API endpoint
cron.php Scheduled tasks (newsletter batch sending)
download.php File download handler

Current Refactoring Status

The project is in Phase 5 of Milestone v0.1 Refaktoryzacja.

Migration pattern:

  • Done: Domain repositories created for all 10 main entities
  • Done: Factory classes converted to deprecated wrappers delegating to repositories
  • In progress: SeoAdditional, Cron, Releases domains
  • Pending: Remove factory layer, inject repositories directly into controls

Version

  • Current app version: 1.695
  • Update channel: stable/beta via updates/ ZIP packages
  • License validation via pp_update_licenses table