docs: map existing codebase

.paul/codebase/stack.md

@@ -0,0 +1,86 @@
+# Technology Stack
+
+**Analysis Date:** 2026-05-07
+
+## Languages
+
+**Primary:**
+- PHP - WordPress core, theme, plugins, and MU plugin code. Examples: `wp-settings.php`, `wp-content/themes/hello-elementor/functions.php`, `wp-content/mu-plugins/cookie-notice-pro/cookie-notice-pro.php`.
+
+**Secondary:**
+- JavaScript - frontend/admin assets in WordPress, Elementor, Lordicon, and the cookie notice MU plugin. Examples: `wp-content/mu-plugins/cookie-notice-pro/assets/cookienoticepro.script.js`, `wp-content/plugins/lordicon/dist/block.js`.
+- CSS/SCSS - theme and plugin styling. Examples: `wp-content/themes/hello-elementor/assets/css/custom.scss`, `wp-content/themes/hello-elementor/assets/css/custom.css`, `wp-content/plugins/svg-support/scss/`.
+- Twig - detected in vendor/plugin code.
+
+## Runtime
+
+**Environment:**
+- WordPress 6.9.4 - detected in `wp-includes/version.php`.
+- Required PHP version from WordPress core: 7.2.24 - `wp-includes/version.php`.
+- Required MySQL version from WordPress core: 5.5.5 - `wp-includes/version.php`.
+- Database configured through constants in `wp-config.php`; secret values are intentionally not documented.
+
+**Package Manager:**
+- No root `composer.json` detected.
+- No root `package.json` detected.
+- Plugin/theme-local manifests exist but are not a project-level dependency contract: `wp-content/plugins/svg-support/composer.json`, `wp-content/themes/twentytwentyfive/package.json`, `wp-content/themes/twentytwentyfive/package-lock.json`.
+- Composer lockfile: not detected.
+- Yarn/pnpm lockfiles: not detected.
+
+## Frameworks
+
+**Core:**
+- WordPress - CMS/application runtime in `wp-admin/`, `wp-includes/`, `wp-content/`.
+- Hello Elementor 3.4.7 - installed theme in `wp-content/themes/hello-elementor/style.css`.
+- Elementor 3.35.9 - page builder plugin in `wp-content/plugins/elementor/elementor.php`.
+- Elementor Pro 3.35.1 - forms, theme builder, popups, and Pro modules in `wp-content/plugins/elementor-pro/elementor-pro.php`.
+
+**Testing:**
+- Not detected at project level.
+
+**Build/Dev:**
+- Twenty Twenty-Five has npm/PostCSS/cssnano scripts in `wp-content/themes/twentytwentyfive/package.json`, but this applies to the bundled default theme.
+- No project-owned build pipeline detected for the Hello Elementor customizations.
+
+## Key Dependencies
+
+**Critical:**
+- Elementor 3.35.9 - primary page-building layer, `wp-content/plugins/elementor/elementor.php`.
+- Elementor Pro 3.35.1 - forms and lead capture features, `wp-content/plugins/elementor-pro/elementor-pro.php`.
+- Cookie Notice Pro MU plugin 1.0.0 - consent/GTM behavior, `wp-content/mu-plugins/cookie-notice-pro/cookie-notice-pro.php`.
+- Hello Elementor 3.4.7 - active/customized theme candidate, `wp-content/themes/hello-elementor/style.css`.
+
+**Infrastructure:**
+- Duplicator Pro 4.5.16.2 - backup/migration tooling, `wp-content/plugins/duplicator-pro-v4.5.16.2/duplicator-pro.php`.
+- Akismet Anti-spam 5.6 - spam protection, `wp-content/plugins/akismet/akismet.php`.
+- Copy & Delete Posts 1.5.3 - content duplication, `wp-content/plugins/copy-delete-posts/copy-delete-posts.php`.
+- Lordicon 1.0 - icon/media integration, `wp-content/plugins/lordicon/lordicon.php`.
+- SVG Support 2.5.14 - SVG upload/render support, `wp-content/plugins/svg-support/svg-support.php`.
+
+## Configuration
+
+**Environment:**
+- Primary configuration is in `wp-config.php`.
+- `wp-config.php` contains DB constants, salts, table prefix, `WP_DEBUG`, and a Duplicator auth key. Do not copy secret values into documentation.
+- `.env` files: not detected.
+- Root environment example/config manifest: not detected.
+
+**Build:**
+- No root build config detected.
+- Custom theme CSS source exists at `wp-content/themes/hello-elementor/assets/css/custom.scss` and compiled CSS at `wp-content/themes/hello-elementor/assets/css/custom.css`.
+
+## Platform Requirements
+
+**Development:**
+- PHP + MySQL/MariaDB environment capable of running WordPress.
+- Database/content is required for the actual Elementor landing page; page layouts are not fully represented by files alone.
+
+**Production:**
+- WordPress hosting with PHP and MySQL/MariaDB.
+- Deployment process not documented in the repository.
+- Backup artifacts are present in `project_backup_2026-03-26_13-38-53.zip` and `wp-content/backups-dup-pro/`.
+
+---
+
+*Stack analysis: 2026-05-07*
+*Update after major dependency changes*