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>
55 lines
2.2 KiB
Markdown
55 lines
2.2 KiB
Markdown
# 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
|