f1fdf27012
- Repo scaffolding: .gitignore, .env.example, Makefile, docker-compose.yml, README.md, CHANGELOG.md, pre-commit config. - Three-service stack: api (Flask 3), db (postgres:16-alpine), front (nginx serving the Vite bundle). Named volumes metamorph_db + metamorph_evidence. - Backend skeleton: Flask app factory, JSON structured logging on stdout, GET /api/v1/health, multi-stage Dockerfile, pyproject.toml driven by uv, Pydantic Settings with secret guard rails (refuses to boot in non-dev with placeholders), APP_ENV gating. - Frontend skeleton: Vite + React 18 + TypeScript strict + TailwindCSS, RTOps design tokens from tasks/design.md, self-hosted JetBrains Mono / IBM Plex Sans via @fontsource, base UI primitives (Card/Tag/SectionHeader/FlowNode/ Button), home page wired to /api/v1/health. - Engine-agnostic Makefile: auto-detects docker or podman, picks the matching compose driver. Targets: up/down/build/rebuild/dev/lint/fmt/test/migrate/ seed-mitre/print-install-token/e2e/inspect-health. - Playwright suite: e2e/tests/m0-smoke.spec.ts (8 tests) + HTML + JUnit reports + traces on retry. - Docs: tasks/spec.md (finalized after Q&A), tasks/design.md, tasks/todo.md (14 milestones), tasks/testing-m0.md, tasks/lessons.md. DoD: make up + make health + make e2e all pass on podman 5.x (Fedora) and docker. TLS terminated by external reverse proxy (spec §6 NF-network). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
67 lines
1.8 KiB
Markdown
67 lines
1.8 KiB
Markdown
# Metamorph e2e
|
|
|
|
End-to-end tests powered by [Playwright](https://playwright.dev/). Each milestone in `tasks/todo.md` should add at least one spec file (`tests/m<N>-*.spec.ts`).
|
|
|
|
## One-time setup
|
|
|
|
```bash
|
|
cd e2e
|
|
npm install
|
|
npm run install-browsers # downloads chromium (uses sudo for system deps)
|
|
```
|
|
|
|
## Running against a live stack
|
|
|
|
```bash
|
|
# 1. Bring the stack up from the repo root:
|
|
cd .. && make up
|
|
|
|
# 2. Run the tests:
|
|
cd e2e && npm test
|
|
|
|
# 3. Open the HTML report:
|
|
npm run report # opens playwright-report/index.html in your browser
|
|
```
|
|
|
|
Or from the repo root:
|
|
|
|
```bash
|
|
make e2e # runs against the already-up stack
|
|
make e2e-report # opens the HTML report
|
|
make e2e-up # one-shot: make up + wait healthy + run tests
|
|
```
|
|
|
|
## Auto-spawn mode
|
|
|
|
Set `PW_AUTOSTART=1` to let Playwright spawn `make up` itself before the run:
|
|
|
|
```bash
|
|
PW_AUTOSTART=1 npm test
|
|
```
|
|
|
|
## Configuration
|
|
|
|
| Env var | Default | Purpose |
|
|
|--------------|--------------------------|-----------------------------------------------|
|
|
| `BASE_URL` | `http://localhost:8080` | The front nginx URL (which proxies `/api/*`) |
|
|
| `PW_AUTOSTART` | `0` | If `1`, spawn `make up` before the tests |
|
|
| `CI` | unset | When set, retries=2 and parallel workers=2 |
|
|
|
|
## Reports
|
|
|
|
- **HTML** : `e2e/playwright-report/index.html`
|
|
- **JUnit** : `e2e/playwright-report/junit.xml` (CI ingestion)
|
|
- **Trace** : kept on first retry, opened with `npx playwright show-trace …`
|
|
|
|
## Layout
|
|
|
|
```
|
|
e2e/
|
|
├── tests/
|
|
│ └── m0-smoke.spec.ts # bootstrap milestone (current)
|
|
│ └── m<N>-*.spec.ts # one spec per milestone, added as features land
|
|
├── playwright.config.ts
|
|
├── tsconfig.json
|
|
└── package.json
|
|
```
|