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:
54
.paul/codebase/testing.md
Normal file
54
.paul/codebase/testing.md
Normal 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
|
||||
Reference in New Issue
Block a user