docs: add .paul/codebase/ codebase map (7 documents)

Stack, architecture, conventions, testing, integrations, db_schema, concerns.
Generated by PAUL /map-codebase workflow from codebase analysis.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-04-28 21:40:11 +02:00
parent a95acc355b
commit 78d5743c12
7 changed files with 758 additions and 0 deletions

54
.paul/codebase/testing.md Normal file
View File

@@ -0,0 +1,54 @@
# Testing — krolewskie-miody.pl
## Current Status
**No testing infrastructure is configured.**
CLAUDE.md acknowledges this: *"Testy — Uzupełnij jak uruchamiać testy"* (incomplete placeholder).
## What's Missing
- No `phpunit.xml` or `phpunit.xml.dist`
- No `tests/` directory
- No `.github/workflows/` CI/CD pipelines
- No PHPUnit dependency in any `composer.json`
- No JavaScript test runner (Jest, Mocha, etc.)
- No automated code quality checks on commit
## Recommended Setup
### PHPUnit (WordPress unit tests)
1. Install PHPUnit via Composer in a custom plugin or child theme:
```bash
composer require --dev phpunit/phpunit wp-phpunit/wp-phpunit
```
2. Create `phpunit.xml`:
```xml
<phpunit bootstrap="tests/bootstrap.php">
<testsuites>
<testsuite name="krolewskie-miody">
<directory>tests/</directory>
</testsuite>
</testsuites>
</phpunit>
```
3. Place test files in `tests/` with `Test` suffix: `tests/class-checkout-test.php`
### Manual Testing Checklist (current practice)
Since no automated tests exist, manual testing covers:
- Product listing and filtering
- Add to cart / cart updates
- Checkout flow (Przelewy24, PayU, PayPal)
- InPost locker selection
- Order confirmation emails (via Easy WP SMTP)
- Coupon application (flexible-coupons-pro)
- GDPR consent banner (Complianz)
## Notes
- WooCommerce 10.x ships with its own test utilities — can be leveraged for integration tests
- Code Snippets plugin stores custom PHP in DB — these snippets are not version-controlled or testable via standard tooling