UPDATE

.paul/codebase/README.md

@@ -0,0 +1,24 @@
+# Codebase Map — shopPRO
+
+Generated: 2026-03-12
+
+## Documents
+
+| File | Contents |
+|------|---------|
+| [overview.md](overview.md) | Project summary, size metrics, quick reference |
+| [stack.md](stack.md) | Technology stack, libraries, external integrations |
+| [architecture.md](architecture.md) | Directory structure, routing, DI, domain modules, request lifecycle |
+| [conventions.md](conventions.md) | Naming, Medoo patterns, cache patterns, security patterns |
+| [testing.md](testing.md) | PHPUnit setup, test patterns, mocking, coverage |
+| [concerns.md](concerns.md) | Security issues, technical debt, dead code, known bugs |
+| [dependencies.md](dependencies.md) | Composer, vendored libs, PHP extensions |
+
+## Quick Facts
+
+- **PHP 7.4 – <8.0** — no match, union types, str_contains etc.
+- **810 tests / 2264 assertions**
+- **29 Domain modules**, all with tests
+- **Medoo pitfall**: `delete()` takes 2 args, not 3
+- **Top concerns**: tpay.txt logging, path traversal in unlink, hardcoded payment seed
+- **Largest files**: `ProductRepository.php` (3583 lines), `IntegrationsRepository.php` (875 lines)