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>

.paul/codebase/overview.md

@@ -0,0 +1,54 @@
+# 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