docs(codebase): add codebase map — stack, architecture, structure, schema, conventions, testing, integrations, concerns

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.paul/codebase/stack.md

@@ -0,0 +1,74 @@
+# Technology Stack
+
+**Analysis Date:** 2026-04-27
+
+## Languages
+
+**Primary:**
+- PHP 5.x — all server-side application code
+- SQL — database schema and migrations in `_rejestracja/sql/`
+
+**Secondary:**
+- JavaScript/jQuery 1.x — frontend interactions, form validation
+- Smarty template language — HTML generation (`_rejestracja/template/`)
+
+## Runtime
+
+**Environment:**
+- PHP 5.x (shared hosting, mediaflex.pl / ceti.pl)
+- Apache (inferred from .htaccess routing)
+- No CLI build step; all runtime is PHP-on-request
+
+**Package Manager:**
+- None — no Composer, no npm
+- All dependencies bundled in `_rejestracja/core/lib/` and `_rejestracja/Static/`
+
+## Frameworks
+
+**Core:**
+- Custom PHP MVC — hand-rolled Front Controller, Router, Controller base, DAL
+- Smarty 3.x — templating engine (loaded from `_rejestracja/core/lib/Smarty/`)
+
+**Testing:**
+- None — no test framework detected anywhere in codebase
+
+**Build/Dev:**
+- None — no build pipeline; PHP files deployed directly to shared hosting via FTP
+
+## Key Dependencies
+
+**Critical:**
+- Smarty 3.x — template rendering; bundled in `_rejestracja/core/lib/Smarty/`
+- PHPMailer — SMTP email via mediaflex.pl; bundled in `_rejestracja/core/lib/`
+- jQuery 1.x — frontend JS; bundled in `_rejestracja/Static/js/`
+- Google reCAPTCHA v2 — spam protection on public registration form
+
+**Infrastructure:**
+- MySQL (mysql7.ceti.pl) — primary data store, accessed via custom DAL wrapping mysqli
+- Google Fonts / CDN — font loading in templates
+
+## Configuration
+
+**Environment:**
+- INI config files (not .env): `_rejestracja/core/config/db.config.ini` (DB credentials), `smtp.config.ini` (email)
+- No environment variable system — values hardcoded in config files committed to repo
+
+**Build:**
+- No build config files
+
+## Platform Requirements
+
+**Development:**
+- PHP 5.x compatible environment
+- MySQL server
+- FTP access for deployment (`.vscode/ftp-kr.sync.cache.json` indicates VS Code FTP sync)
+
+**Production:**
+- Shared hosting: mediaflex.pl / ceti.pl
+- PHP 5.x, MySQL (mysql7.ceti.pl)
+- Direct FTP upload, no CI/CD
+
+---
+
+*Stack analysis: 2026-04-27*
+*Update after major dependency changes*