Knowledge Portal · engineering documentation

Skip to content

Tutorial: Create Architecture Tests

Audience: All engineers
Time: ~30 minutes
Last updated: 2026-07-05


Outcome

PHPUnit architecture tests enforcing module and platform boundaries.

Steps

  1. Add tests under tests/Architecture/ in product repo
  2. Test forbidden namespace imports between modules
  3. Test frozen path policies where applicable
  4. Run: php artisan test --testsuite=Architecture

Platform validation: vendor/zaixos/engineering-platform/validation/tests

See TESTING/architecture-tests.md.

Breadcrumbs: Home → Tutorials → Architecture Tests

ZAIXOS Knowledge Portal — public engineering docs at /docs · Staff operations at /admin