diff --git a/.agents/skills/test-agent-governance/SKILL.md b/.agents/skills/test-agent-governance/SKILL.md new file mode 100644 index 000000000..d492f07d9 --- /dev/null +++ b/.agents/skills/test-agent-governance/SKILL.md @@ -0,0 +1,22 @@ +--- +name: test-agent-governance +description: Use when the testing workflow itself needs knowledge-base maintenance, benchmark evaluation, controlled Skill optimization, or CI quality-gate design rather than ordinary feature testing. +--- + +# Test Agent Governance + +Operate the testing system's governance plane. This Skill is not a mandatory +tail of `test-agent-workflow` and does not design or execute feature Cases. + +Load exactly one reference matching the request: + +| Request | Reference | +| --- | --- | +| Build or refresh reusable project testing knowledge | [Quality KB Builder](references/quality-kb-builder.md) | +| Evaluate Skill or workflow quality against fixed scenarios | [Skill Benchmark](references/skill-benchmark.md) | +| Run a one-change-at-a-time optimization experiment | [Skill Self Optimization](references/skill-self-optimization.md) | +| Design PR, main, nightly, or release gates | [CI Quality Flow](references/ci-quality-flow.md) | + +Keep deterministic facts in scripts and project inventories. Keep semantic +judgment reviewable. Never edit product business behavior during governance +work, and never weaken benchmark scenarios to make a candidate pass. diff --git a/.agents/skills/test-agent-governance/agents/openai.yaml b/.agents/skills/test-agent-governance/agents/openai.yaml new file mode 100644 index 000000000..c62018c10 --- /dev/null +++ b/.agents/skills/test-agent-governance/agents/openai.yaml @@ -0,0 +1,6 @@ +interface: + display_name: "Test Agent Governance" + short_description: "Maintain and evaluate the testing workflow" + default_prompt: "Use $test-agent-governance for the requested KB, benchmark, optimization, or CI governance task." +policy: + allow_implicit_invocation: false diff --git a/.agents/skills/test-agent-governance/references/ci-quality-flow.md b/.agents/skills/test-agent-governance/references/ci-quality-flow.md new file mode 100644 index 000000000..6cde2edd6 --- /dev/null +++ b/.agents/skills/test-agent-governance/references/ci-quality-flow.md @@ -0,0 +1,69 @@ +# Test Agent CI Quality Flow + +Load only for CI gate placement, review flow, or release-quality decisions. + +## Purpose + +Turn AI Native testing evidence into CI gates, review flow, quality reports, and rollout decisions. This skill protects the team from expensive gates in the wrong place and from unreviewed skips. + +## Required Inputs + +Read: + +- Workflow Run output from `test-agent-workflow` +- Test Strategy from `test-strategy` +- Latest run logs for `fast`, `infra`, `e2e`, and targeted commands +- Quality Review findings and residual risk +- `test-index.yml` +- Existing CI stages and runtime constraints + +## Gate Model + +| gate | recommended scope | reason | +| --- | --- | --- | +| PR Fast | backend UT, contract, frontend UT, frontend IT | quick feedback and no container runtime dependency | +| PR Infra | targeted backend IT for DB, optimistic lock, stock/coupon, or transaction risks | real integration evidence before merge when risk demands it | +| Coverage Review | coverage report generation after functional layers pass | gap analysis without treating coverage percentage as behavior proof | +| Main Smoke | key E2E smoke | golden path confidence after merge | +| Nightly | full backend IT, extended E2E, flaky detection | slower regression and environment confidence | +| Release | selected high-risk workflows plus verification report | release sign-off and residual-risk acceptance | + +## Review Flow + +| review | required evidence | +| --- | --- | +| Story Review | Story, AC, assumptions, human-gate decisions | +| Test Case Review | approved `case_id` values, oracles, steps, data, and existing-case decisions | +| Strategy Review | `case_id`, stable `test_case_id`, run-specific `execution_id`, selected layer, distinct evidence claim, target, command, runtime, and residual risk | +| Script Review | generated or modified files, assertions, fixture determinism | +| Coverage Review | functional test evidence, JaCoCo/Vitest report path, gap explanation | +| Feature Review | selected/skipped commands, run evidence, residual risk | +| CI Review | gate placement, runtime cost, retry/flaky policy | + +## Output Format + +```markdown +## CI Gate Plan +| gate | command | trigger | required | skip_policy | +| --- | --- | --- | --- | --- | + +## Quality Report +| dimension | status | evidence | owner | +| --- | --- | --- | --- | + +## Review Checklist +| review | reviewer | evidence_link | decision | +| --- | --- | --- | --- | + +## Residual Risk Acceptance +| risk | reason | owner | expiration | +| --- | --- | --- | --- | +``` + +## Guardrails + +- Do not put every test in PR if the result makes developers bypass the gate. +- Do not skip `backend-it` for DB, optimistic lock, stock/coupon, or transaction side-effect changes without an explicit owner and follow-up gate. +- Do not use E2E for rule combinations that belong in UT or IT. +- Do not treat coverage percentage as behavior proof; coverage review needs functional layer evidence plus gap explanation. +- Do not accept an AI-generated case or script without Quality Review evidence. diff --git a/.agents/skills/test-agent-governance/references/quality-kb-builder.md b/.agents/skills/test-agent-governance/references/quality-kb-builder.md new file mode 100644 index 000000000..1ad2ee8c8 --- /dev/null +++ b/.agents/skills/test-agent-governance/references/quality-kb-builder.md @@ -0,0 +1,81 @@ +# Test Agent Quality KB Builder + +Load only for a testing knowledge-base build or refresh. + +## Purpose + +Build a deterministic project testing knowledge base from project artifacts, then let AI add semantic summaries only after the structural graph is valid. + +This skill follows a hybrid pattern: static extraction owns facts, AI owns interpretation. The goal is a KB that teaches the team how business chains, tests, risks, skills, and evidence fit together. + +## Required Context + +Read these when present: + +- Project `Tests/test-index.yml` +- `.agents/skills/test-agent-workflow/references/workflow-registry.yml` +- Project `Tests/README.md` +- `AI Native/workflows/*/workflow-pack.json` +- Project `Tests/ai-native-workflow/*/workflow-pack.md` +- Existing backend, frontend, contract, and E2E tests +- Product MD source paths listed in `test-index.yml` + +## Workflow + +1. Resolve the project-declared deterministic KB builder under + `AI Native/scripts/` or the project testing directory; do not assume a + generic filename exists. +2. Run that exact builder and inspect the output path it reports. +3. Check graph reviewer output: + - no duplicate node IDs + - no dangling edge references + - each core chain has risk tags, source docs, and at least one test/evidence link + - each Skill path in `workflow-registry.yml` exists + - each workflow pack validates and contributes workflow/story/AC/test case/review/repair nodes +4. Add AI semantic notes only as `semantic_notes` fields or a separate Markdown summary; do not overwrite extracted facts. +5. Commit or share the KB when it is green so teammates and future AI loops start from the same map. + +## Node Types + +| Node type | Meaning | +| --- | --- | +| `chain` | Business chain such as payment callback, mobile order API, stock compensation, coupon release, groupon status, refund lifecycle, or browser smoke | +| `risk` | Project risk tag used by planner and quality review | +| `skill` | AI Native skill and owned quality surface | +| `test` | Concrete backend UT, frontend UT, contract, frontend IT, backend IT, or E2E asset | +| `test_case_design` | Layer-neutral business Case with stable `case_id` | +| `executable_test` | Strategy-created stable `test_case_id` for one Case and layer | +| `execution_item` | Run-specific `execution_id`, action, target, command, and result | +| `workflow` | Canonical AI Native feature workflow pack | +| `story` | User story extracted from product or workshop prompt | +| `acceptance_criterion` | AC linked to one story and one or more test case designs | +| `evidence` | Observable evidence expected from tests | +| `doc` | Source MD or architecture/testing documentation | + +## Review Rules + +- Treat the project `Tests/test-index.yml` as the test asset and command source of truth. +- Prefer exact file paths and commands over generated descriptions. +- Keep generated facts reproducible; if an AI inference is needed, mark it as an inference. +- Regenerate the KB after changing skills, tests, product docs, or `test-index.yml`. + +## Output + +Produce a short report: + +```markdown +## Quality KB Build +- command: +- output: +- node_count: +- edge_count: +- reviewer_status: pass | needs-fix + +## Reviewer Issues +| severity | issue | fix | +| --- | --- | --- | + +## AI Semantic Additions +| node_id | note | confidence | +| --- | --- | --- | +``` diff --git a/.agents/skills/test-agent-governance/references/skill-benchmark.md b/.agents/skills/test-agent-governance/references/skill-benchmark.md new file mode 100644 index 000000000..05ced90e1 --- /dev/null +++ b/.agents/skills/test-agent-governance/references/skill-benchmark.md @@ -0,0 +1,82 @@ +# Test Agent Skill Benchmark + +Load only for a fixed-scenario Skill or workflow evaluation. + +## Purpose + +Benchmark the skills pipeline with fixed project scenarios, a fixed metric, and reviewable output. Use this before accepting changes to skills, prompts, benchmark data, or quality-review rules. + +## Required Context + +Read: + +- `AI Native/quality-benchmark/skill-benchmark.json` +- `AI Native/quality-kb/project-quality-kb.json` if present +- `.agents/skills/test-agent-workflow/references/workflow-registry.yml` +- `AI Native/workflows/*/workflow-pack.json` when a scenario references `workflow_pack` +- The candidate Story/AC/Test Case/Review/Strategy output being evaluated + +## Benchmark Contract + +Each scenario must define: + +- `chain` +- `story` +- `expected_risk_tags` +- `expected_layers` +- `acceptance_focus` +- `must_find` +- `min_quality_score` +- optional `workflow_pack`; when present, the pack must pass deterministic validation before the scenario can pass + +Keep benchmark scenarios stable. Add new scenarios when product risk expands; do not rewrite old ones to hide regressions. + +## Workflow + +1. Validate the workflow structure: + +```bash +ruby ".agents/skills/test-agent-workflow/scripts/validate-workflow.rb" +``` + +2. Resolve and run the project-declared KB builder and Skill benchmark under + `AI Native/scripts/`; use their actual filenames and reported output paths. +3. If scoring an AI output pack, compare it manually or with a scorer against: + - AC coverage + - risk tag recall + - layer fit + - evidence observability + - mock-boundary correctness + - duplication and shallow-case rate +4. Fail the change if workflow validation fails or any critical scenario + regresses. +5. Store the result in the benchmark's declared output path. + +## Scoring Model + +| Dimension | Points | Gate | +| --- | ---: | --- | +| Chain mapped in KB | 20 | Required | +| Expected risks known | 20 | Required for P0 | +| Expected layers available | 20 | Required | +| Must-find assets present | 20 | Required | +| Quality threshold valid | 20 | `min_quality_score >= 80` | + +## Output + +```markdown +## Skill Benchmark +- benchmark_file: +- kb_file: +- total_score: +- decision: pass | fail | needs-kb-refresh + +## Scenario Results +| scenario | score | missing | recommendation | +| --- | ---: | --- | --- | + +## Regression Decision +- accepted: +- reason: +- follow_up: +``` diff --git a/.agents/skills/test-agent-governance/references/skill-self-optimization.md b/.agents/skills/test-agent-governance/references/skill-self-optimization.md new file mode 100644 index 000000000..76584c465 --- /dev/null +++ b/.agents/skills/test-agent-governance/references/skill-self-optimization.md @@ -0,0 +1,71 @@ +# Test Agent Skill Self Optimization + +Load only for an explicit, benchmark-backed Skill optimization experiment. + +## Purpose + +Improve skills through a small, auditable loop: observe benchmark gaps, change one skill or resource, rerun the benchmark, accept only measurable improvement, and log the experiment. + +## Hard Boundaries + +- Do not modify backend or frontend business code during a skill optimization experiment. +- Do not edit benchmark scenarios to make a candidate pass. +- Do not accept a skill change that improves one scenario while regressing a P0 scenario. +- Do not delete user work or reset the repo automatically. If a change should be rejected, describe the revert patch or ask before destructive git operations. + +## Workflow + +1. Establish a structural and project benchmark baseline: + +```bash +ruby ".agents/skills/test-agent-workflow/scripts/validate-workflow.rb" +``` + +Then resolve and run the actual project-declared KB builder and benchmark; do +not assume generic script filenames exist. + +2. Read the benchmark output path reported by the runner, then identify the weakest scenario or missing asset. +3. Choose exactly one optimization target: + - skill trigger clarity + - quality rubric gap + - benchmark coverage gap + - KB extraction gap + - existing case discovery gap + - self-repair decision gap + - output handoff completeness +4. Make the smallest useful edit. +5. Rerun the same commands. +6. Accept only if: + - total score improves or a named gap closes + - no critical scenario regresses + - generated outputs remain traceable to Story/AC/Test Case/Review + - existing case reuse decisions do not hide uncovered P0/P1 risk + - self-repair changes do not alter business expectations without a human gate +7. Append the result to `quality-benchmark/skill-experiments.md`. + +## Experiment Log Format + +```markdown +## EXP-YYYYMMDD-NN +- hypothesis: +- changed_files: +- baseline_score: +- candidate_score: +- accepted: yes | no +- regression_check: +- reviewer_notes: +``` + +## Recommended Loop Cadence + +- During the two-day workshop: one guided optimization at the end of day 2. +- During normal delivery: run when quality review finds repeated shallow cases or planner handoffs miss the same risk twice. +- Before sharing the skills broadly: run the benchmark and freeze the baseline. + +## Review Checklist + +- The skill description still triggers on real user language. +- The body teaches a decision that an AI might otherwise get wrong. +- Scripted checks cover deterministic facts. +- AI judgment is reserved for semantic review and tradeoff decisions. +- Benchmark history explains why the change was accepted. diff --git a/.agents/skills/test-agent-workflow/SKILL.md b/.agents/skills/test-agent-workflow/SKILL.md new file mode 100644 index 000000000..06254460f --- /dev/null +++ b/.agents/skills/test-agent-workflow/SKILL.md @@ -0,0 +1,50 @@ +--- +name: test-agent-workflow +description: Use when a requirement or feature needs the complete testing lifecycle from acceptance analysis through test design, strategy, execution evidence, repair routing, and final reporting. +--- + +# Test Agent Workflow + +Coordinate the testing lifecycle and enforce artifact gates. Delegate design, +review, strategy, and execution decisions to their owning Skills; do not make +those decisions in the orchestrator. + +## Route + +1. If an approved requirement is absent, read + [User Story Intake](references/stages/01-user-story-intake.md). +2. If observable acceptance criteria are absent, read + [Acceptance Criteria](references/stages/02-acceptance-criteria.md). +3. Use `test-case-design` to produce layer-neutral business Cases. +4. Use `test-case-quality-review`; continue only for `PASS` or an explicitly + accepted `PASS_WITH_RESIDUAL_RISK` design version. +5. Use `test-strategy` to select cases, layers, actions, targets, commands, + runtimes, order, and gates. Continue only when the decision is `READY`. +6. Use `test-execution` to implement and run only the READY plan. +7. On failure, read [Failure Repair Loop](references/stages/07-failure-repair-loop.md) + and return the defect to its owning stage. +8. Aggregate AC-to-evidence traceability using + [Final Test Report](references/final-test-report.md). + +Read [Artifact Contracts](references/artifact-contracts.md) when validating a +handoff, and [Workflow Registry](references/workflow-registry.yml) when routing +or validating paths. For independent coverage analysis, Case review, or +evidence reproduction, delegate to the project custom agent `test_engineer` +defined in `.codex/agents/test-engineer.toml`; ordinary workflow runs do not +require a subagent. + +## Boundaries + +- Case Design owns obligations, existing-case decisions, techniques, Cases, + and oracles; it never selects a test layer. +- Quality Review approves or returns the design; it never rewrites Cases. +- Test Strategy is the sole owner of layer and execution planning. +- Test Execution follows project commands declared by `Tests/test-index.yml`; + it never invents a command or changes a Case oracle. +- Product-code changes require separate authorization. A product failure is a + reportable defect by default. +- Governance is optional. Use `test-agent-governance` only for KB, benchmark, + Skill optimization, or CI-quality-flow work. + +Run `ruby .agents/skills/test-agent-workflow/scripts/validate-workflow.rb` +after changing this workflow. diff --git a/.agents/skills/test-agent-workflow/agents/openai.yaml b/.agents/skills/test-agent-workflow/agents/openai.yaml new file mode 100644 index 000000000..b8aa2a595 --- /dev/null +++ b/.agents/skills/test-agent-workflow/agents/openai.yaml @@ -0,0 +1,4 @@ +interface: + display_name: "Test Agent Workflow" + short_description: "Run the complete requirement-to-test-evidence workflow" + default_prompt: "Use $test-agent-workflow to complete the testing lifecycle and produce an evidence-backed final report." diff --git a/.agents/skills/test-agent-workflow/references/artifact-contracts.md b/.agents/skills/test-agent-workflow/references/artifact-contracts.md new file mode 100644 index 000000000..267cac8d0 --- /dev/null +++ b/.agents/skills/test-agent-workflow/references/artifact-contracts.md @@ -0,0 +1,35 @@ +# Artifact Contracts + +Read this when validating a stage handoff or tracing a final result. + +| Producer | Required output | Consumer | +| --- | --- | --- | +| Requirement stages | Story, AC, rules, observable oracles, open decisions | Test Case Design | +| Test Case Design | versioned design, obligations, existing-case decisions, stable layer-neutral `case_id` values | Quality Review | +| Quality Review | decision, findings, approved design version and Case IDs | Test Strategy | +| Test Strategy | `execution_id`, `case_id`, layer-specific `test_case_id`, layer, action, target, command source, runtime, order, expected evidence | Test Execution | +| Test Execution | changed test assets, commands, runtime, result, oracle observation, evidence paths | Orchestrator | +| Orchestrator | AC-to-obligation-to-Case-to-execution traceability and residual risk | Human or CI gate | + +## Identity + +- `case_id` is a stable business Case and has no test layer. +- `test_case_id` is a stable executable Case for one `case_id` and one layer. +- `execution_id` identifies one planned run or implementation action. + +## Gates + +- Missing or contradictory product behavior blocks Case Design. +- Quality Review must approve the exact design version consumed by Strategy. +- Execution starts only from a `READY` Strategy. +- A result passes only when the intended current-source test ran and its + observation satisfies the approved oracle. + +## Repair Ownership + +| Defect | Return to | +| --- | --- | +| Missing Case, wrong data/action/oracle | Test Case Design, then Review | +| Wrong layer, target, command, runtime, order, or gate | Test Strategy | +| Test code, fixture, runner, or environment | Failure Repair and targeted Test Execution | +| Product implementation | Report by default; fix only with explicit authorization | diff --git a/.agents/skills/test-agent-workflow/references/final-test-report.md b/.agents/skills/test-agent-workflow/references/final-test-report.md new file mode 100644 index 000000000..7426680d8 --- /dev/null +++ b/.agents/skills/test-agent-workflow/references/final-test-report.md @@ -0,0 +1,92 @@ +# Final Test Report + +Read this only when the orchestrator aggregates completed workflow artifacts. + +```markdown +## Test Report +- workflow_id: +- requirement: +- design_id_and_version: +- strategy_id: +- overall_result: PASSED | FAILED | BLOCKED | PARTIALLY_PROVEN + +## Requirement Traceability +| ac_id | obligation_id | case_id | test_case_ids | execution_ids | result | evidence | +| --- | --- | --- | --- | --- | --- | --- | + +## Layer Results +| layer | new_tests | existing_regression | result | evidence | +| --- | ---: | ---: | --- | --- | + +## Test Changes +| execution_id | test_case_id | action | file | change | +| --- | --- | --- | --- | --- | + +## Unproven and Residual Risk +| ac_id_or_case_id | status | reason | owner | follow_up | +| --- | --- | --- | --- | --- | +``` + +Separate newly added tests from existing regression. Do not label all existing +regression as impact coverage. Never infer requirement success from a green +aggregate command alone; preserve blockers, skips, stale evidence, and +`NOT_PROVEN` boundaries. + +## HTML Review Template + +When the final report is rendered as HTML, use a review-first structure: + +1. Put the final result on the first visible line: + `PASS`, `BLOCK`, or `NEEDS_VERIFY`. +2. Render `01 · LAYER RESULTS`, `02 · STRATEGY TRACEABILITY`, + `03 · CASE REVIEW`, and `04 · REVIEW DECISION` as native disclosure + sections that are closed by default. Do not add an `open` attribute. Each + closed summary must show the section name plus a short summary of the + content inside it. +3. The `01` closed summary must show the layer count, total new-test count, + existing-regression status, and current-run status. Do not use a generic + “click to view details” sentence as the summary. +4. Inside the expanded layer section, show each layer's command, new tests, + existing regression, last evidence result, current run status, and coverage + judgment. +5. The `02` summary should expose the number of Cases and how many are + proven versus partial, while the expanded content shows the Test Strategy + to Test Case mapping before the detailed Case list. +6. The `03` summary should expose the Case count and result split. Render each + Case as a separate disclosure section, also closed by default. + The expanded content must include purpose, strategy layer, preconditions, + steps, oracle, evidence, and unresolved gap. +7. The `04` summary should expose the number of P1 risks and environment + verification items. Keep the review decision inside the expanded section, + while the first visible status line remains outside all disclosures. + +Canonical HTML shape: + +```html +
PASS | BLOCK | NEEDS_VERIFY
+
+ 01 · LAYER RESULTS · 分层测试执行结果 + +
+
+ 02 · STRATEGY TRACEABILITY · 8 cases · 6 proven · 2 partial + +
+
+ 03 · CASE REVIEW · 8 cases · 6 PASS · 2 PARTIAL + +
+
+ 04 · REVIEW DECISION · 2 P1 risks · 1 environment check + +
+
+ case_id · result · purpose + +
+
Residual risks and decision
+``` + +The report generator must preserve the distinction between historical +successful evidence and the current run. A blocked current run is +`NEEDS_VERIFY`, even when the previous evidence package was green. diff --git a/.agents/skills/test-agent-workflow/references/stages/01-user-story-intake.md b/.agents/skills/test-agent-workflow/references/stages/01-user-story-intake.md new file mode 100644 index 000000000..ead154df9 --- /dev/null +++ b/.agents/skills/test-agent-workflow/references/stages/01-user-story-intake.md @@ -0,0 +1,45 @@ +# User Story Intake + +Read this stage only when no approved Story Card or equivalent requirement +exists. + +## Purpose + +Structure an informal request without inventing business behavior. + +## Workflow + +1. Read the supplied requirement and authoritative product sources. +2. Identify actor, trigger, goal, value, scope, impacted objects, and known + business chain. +3. Record applicable risks from the feature rather than a fixed domain list. +4. Separate confirmed facts, assumptions, and open questions. +5. Stop when a missing rule would materially change intended behavior. + +Read project test inventories only when they help identify an impacted feature; +do not derive requirements from tests. + +## Output + +```markdown +## Story Card +- story_id: +- title: +- actor: +- trigger: +- user_story: As a ..., I want ..., so that ... +- business_value: +- in_scope: +- out_of_scope: +- source_evidence: +- impacted_objects: +- risk_tags: +- assumptions: +- open_questions: + +## Handoff +- next_stage: acceptance-criteria +``` + +A Story Card is ready only when its scope and source are clear enough to write +observable acceptance criteria without guessing hidden rules. diff --git a/.agents/skills/test-agent-workflow/references/stages/02-acceptance-criteria.md b/.agents/skills/test-agent-workflow/references/stages/02-acceptance-criteria.md new file mode 100644 index 000000000..521cd8a83 --- /dev/null +++ b/.agents/skills/test-agent-workflow/references/stages/02-acceptance-criteria.md @@ -0,0 +1,48 @@ +# Acceptance Criteria + +Read this stage only when the approved requirement lacks observable acceptance +criteria and business rules. + +## Purpose + +Define observable business behavior without prescribing test layers, +frameworks, files, or commands. + +## Required Context + +- Story Card or authoritative requirement +- Product rules and contracts cited by the requirement +- Relevant source only when needed to confirm an existing public behavior + +## Workflow + +1. Write the primary success behavior. +2. Add applicable negative, boundary, permission, duplicate/retry, state, + concurrency, and failure behavior. +3. State each criterion as Given/When/Then business behavior. +4. Define an observable oracle such as UI state, API response, persisted state, + event, payload, or log. Do not select the future evidence layer. +5. Put ambiguous or conflicting behavior in Open Decisions rather than turning + an assumption into an AC. + +## Output + +```markdown +## Acceptance Criteria +| ac_id | story_id | type | given | when | then | observable_oracle | source | +| --- | --- | --- | --- | --- | --- | --- | --- | + +## Business Rules +| rule_id | condition | expected_result | risk_tag | source | +| --- | --- | --- | --- | --- | + +## Open Decisions +| question | impact | owner | +| --- | --- | --- | + +## Handoff +- next_skill: test-case-design +``` + +Stop for product clarification when an unresolved rule changes expected +behavior or makes the oracle contradictory. diff --git a/.agents/skills/test-agent-workflow/references/stages/07-failure-repair-loop.md b/.agents/skills/test-agent-workflow/references/stages/07-failure-repair-loop.md new file mode 100644 index 000000000..e9002db0b --- /dev/null +++ b/.agents/skills/test-agent-workflow/references/stages/07-failure-repair-loop.md @@ -0,0 +1,58 @@ +# Failure Repair Loop + +Read this stage after a failed or invalid execution result. Classify before +editing and return the defect to the stage that owns the faulty decision. + +## Workflow + +1. Capture the first failing command, meaningful error, `execution_id`, + `case_id`, `test_case_id`, layer, runtime, and artifacts. +2. Classify the failure before editing: + +| Classification | Default action | +| --- | --- | +| `PRODUCT_DEFECT` | report; modify production only with explicit authorization | +| `DESIGN_DEFECT` | return to Case Design, Review, then Strategy | +| `STRATEGY_DEFECT` | return to Strategy for layer/target/command/runtime/order repair | +| `TEST_DEFECT` | repair the executable test without changing the oracle | +| `FIXTURE_DEFECT` | repair deterministic setup, data, reset, or mock boundary | +| `RUNNER_DEFECT` | repair selector, stale-source handling, exit status, or reporting | +| `ENVIRONMENT_DEFECT` | repair in-scope runtime or report `BLOCKED` | +| `REQUIREMENT_CONFLICT` | stop for product clarification | + +3. Make the smallest authorized change explaining the failure. +4. Rerun the focused execution item. +5. When green, rerun Strategy-declared adjacent or layer gates. +6. Confirm the intended current-source test ran and collect new evidence. + +## Output + +```markdown +## Failure Summary +- execution_id: +- case_id: +- test_case_id: +- command: +- first_error: +- classification: + +## Repair +- authorization: +- changed_files: +- design_or_strategy_changed: +- reasoning: + +## Verification +- commands: +- result: +- artifacts: + +## Residual Risk +- status: +- reason: +- owner: +``` + +Do not delete assertions, broaden mocks across the selected evidence boundary, +skip a selected layer because its runtime is inconvenient, or accept a green +run that did not execute the intended test. diff --git a/.agents/skills/test-agent-workflow/references/workflow-registry.yml b/.agents/skills/test-agent-workflow/references/workflow-registry.yml new file mode 100644 index 000000000..8a48e5421 --- /dev/null +++ b/.agents/skills/test-agent-workflow/references/workflow-registry.yml @@ -0,0 +1,43 @@ +version: 3 +entry_skill: test-agent-workflow + +custom_agents: + test_engineer: + path: .codex/agents/test-engineer.toml + activation: independent coverage analysis, Case review, or evidence reproduction + +public_skills: + test-agent-workflow: + path: .agents/skills/test-agent-workflow/SKILL.md + owns: [routing, lifecycle gates, repair routing, final report] + test-case-design: + path: .agents/skills/test-case-design/SKILL.md + owns: [test basis, obligations, existing-case decisions, layer-neutral cases] + test-case-quality-review: + path: .agents/skills/test-case-quality-review/SKILL.md + owns: [traceability, completeness, oracle quality, design approval] + test-strategy: + path: .agents/skills/test-strategy/SKILL.md + owns: [case selection, layers, actions, targets, commands, runtimes, order, gates] + test-execution: + path: .agents/skills/test-execution/SKILL.md + owns: [test implementation, project CLI execution, evidence] + test-agent-governance: + path: .agents/skills/test-agent-governance/SKILL.md + activation: explicit governance request + +internal_stages: + user-story-intake: references/stages/01-user-story-intake.md + acceptance-criteria: references/stages/02-acceptance-criteria.md + failure-repair-loop: references/stages/07-failure-repair-loop.md + final-test-report: references/final-test-report.md + +loading_policy: + - Load requirement stages only when approved equivalents are absent. + - Existing-case discovery is internal to Test Case Design. + - Test Strategy is the sole owner of layer selection. + - Test Execution loads only layer references named by the READY plan. + - Runtime references load only when the selected layer requires them. + - Governance is never a mandatory tail of the feature workflow. + - The test_engineer custom agent is optional and must not be spawned for every workflow run. + - Project commands come from Tests/test-index.yml, not from Skill defaults. diff --git a/.agents/skills/test-agent-workflow/scripts/validate-workflow.rb b/.agents/skills/test-agent-workflow/scripts/validate-workflow.rb new file mode 100644 index 000000000..3049b32e7 --- /dev/null +++ b/.agents/skills/test-agent-workflow/scripts/validate-workflow.rb @@ -0,0 +1,139 @@ +#!/usr/bin/env ruby +# frozen_string_literal: true + +require "yaml" + +workflow = File.expand_path("..", __dir__) +skills_root = File.expand_path("..", workflow) +repo = File.expand_path("../../..", workflow) +registry_path = File.join(workflow, "references/workflow-registry.yml") +errors = [] + +registry = YAML.load_file(registry_path) +public_skills = registry.fetch("public_skills") +expected_names = %w[ + test-agent-workflow + test-case-design + test-case-quality-review + test-strategy + test-execution + test-agent-governance +] + +errors << "public Skill set differs from target" unless public_skills.keys.sort == expected_names.sort + +public_skills.each do |name, entry| + path = File.join(repo, entry.fetch("path")) + unless File.file?(path) + errors << "missing public Skill: #{entry['path']}" + next + end + + text = File.read(path) + errors << "Skill name mismatch for #{name}" unless text.match?(/\A---\s*\n.*?^name:\s*#{Regexp.escape(name)}\s*$.*?^description:\s*\S/m) +end + +actual_skill_files = Dir[File.join(skills_root, "**/SKILL.md")].sort +errors << "expected 6 public SKILL.md files, found #{actual_skill_files.size}" unless actual_skill_files.size == 6 + +registry.fetch("internal_stages").each_value do |relative| + errors << "missing internal stage: #{relative}" unless File.file?(File.join(workflow, relative)) +end + +required_references = %w[ + test-agent-workflow/references/artifact-contracts.md + test-agent-workflow/references/final-test-report.md + test-case-design/references/existing-case-discovery.md + test-case-design/references/case-design-schema.md + test-case-design/references/test-design-techniques.md + test-case-design/references/cause-effect-graph.md + test-case-quality-review/references/review-rubric.md + test-strategy/references/layer-capabilities.md + test-strategy/references/test-pyramid.md + test-strategy/references/execution-plan-schema.md + test-execution/references/evidence-schema.md + test-execution/references/runtimes/colima.md + test-agent-governance/references/quality-kb-builder.md + test-agent-governance/references/skill-benchmark.md + test-agent-governance/references/skill-self-optimization.md + test-agent-governance/references/ci-quality-flow.md +] +required_references.each do |relative| + errors << "missing reference: #{relative}" unless File.file?(File.join(skills_root, relative)) +end + +layer_references = Dir[File.join(skills_root, "test-execution/references/layers/*.md")] +errors << "expected 6 execution layer references, found #{layer_references.size}" unless layer_references.size == 6 + +design = File.read(File.join(skills_root, "test-case-design/SKILL.md")) +review = File.read(File.join(skills_root, "test-case-quality-review/SKILL.md")) +strategy = File.read(File.join(skills_root, "test-strategy/SKILL.md")) + + File.read(File.join(skills_root, "test-strategy/references/execution-plan-schema.md")) +execution = File.read(File.join(skills_root, "test-execution/SKILL.md")) + + File.read(File.join(skills_root, "test-execution/references/evidence-schema.md")) + +%w[layer_reference command_source execution_profile].each do |term| + errors << "Test Case Design owns Strategy field: #{term}" if design.include?(term) +end +%w[layer_reference command_source].each do |term| + errors << "Quality Review owns Strategy field: #{term}" if review.include?(term) +end +%w[test_case_id execution_id layer_reference command_source runtime expected_evidence].each do |term| + errors << "Test Strategy misses execution field: #{term}" unless strategy.include?(term) +end +%w[test_case_id execution_id PASSED FAILED BLOCKED NOT_PROVEN INCOMPLETE].each do |term| + errors << "Test Execution misses evidence term: #{term}" unless execution.include?(term) +end + +governance_policy = YAML.load_file(File.join(skills_root, "test-agent-governance/agents/openai.yaml")) +unless governance_policy.dig("policy", "allow_implicit_invocation") == false + errors << "test-agent-governance must be explicit-only" +end + +custom_agents = registry.fetch("custom_agents") +test_engineer_path = File.join(repo, custom_agents.fetch("test_engineer").fetch("path")) +unless File.file?(test_engineer_path) + errors << "missing project custom agent: .codex/agents/test-engineer.toml" +else + agent = File.read(test_engineer_path) + %w[name description developer_instructions].each do |field| + errors << "test_engineer misses #{field}" unless agent.match?(/^#{field}\s*=/) + end +end + +legacy_persona_dir = File.join(workflow, "references", "personas") +errors << "legacy persona reference directory still exists" if Dir.exist?(legacy_persona_dir) + +Dir[File.join(skills_root, "**/*.{md,yml,yaml}")].each do |file| + text = File.read(file) + %w[layer_skill test-agent-orchestrator].each do |term| + errors << "stale term #{term.inspect} in #{file.delete_prefix(repo + '/')}" if text.include?(term) + end + errors << "project name leaked into #{file.delete_prefix(repo + '/')}" if text.match?(/lite.?mall/i) + errors << "Test Harness dependency leaked into #{file.delete_prefix(repo + '/')}" if text.match?(/test.?harness/i) + + text.scan(/\[[^\]]+\]\(([^)]+)\)/).flatten.each do |link| + next if link.match?(%r{\A(?:https?://|#)}) + target = link.split("#", 2).first + next if target.empty? + errors << "broken local link #{link} in #{file.delete_prefix(repo + '/')}" unless File.exist?(File.expand_path(target, File.dirname(file))) + end +end + +compatibility = File.join(repo, "skills") +unless File.symlink?(compatibility) && File.realpath(compatibility) == File.realpath(skills_root) + errors << "skills compatibility link must resolve to .agents/skills" +end + +legacy_root = File.join(repo, "AI Native/skills/test-agent-workflow") +errors << "legacy workflow implementation still exists" if File.exist?(legacy_root) + +if errors.empty? + puts "workflow validation passed" + puts "public_skills=#{actual_skill_files.size}" + puts "execution_layer_references=#{layer_references.size}" + exit 0 +end + +warn errors.uniq.join("\n") +exit 1 diff --git a/.agents/skills/test-case-design/SKILL.md b/.agents/skills/test-case-design/SKILL.md new file mode 100644 index 000000000..739c16909 --- /dev/null +++ b/.agents/skills/test-case-design/SKILL.md @@ -0,0 +1,82 @@ +--- +name: test-case-design +description: Use when approved requirements and acceptance criteria need traceable, layer-neutral business Test Case Design, including existing-case discovery, coverage obligations, oracles, and applicable design techniques. +--- + +# Test Case Design + +## Purpose + +Define **what must be tested** without deciding how or where it will run. +Produce business test cases that `test-case-quality-review` can approve and +`test-strategy` can later map to one or more evidence layers. + +Do not write test code, select Unit/Contract/Integration/E2E, resolve commands, +or define an execution profile. + +## Required Context + +- Story Card or authoritative requirement +- Approved Acceptance Criteria and Business Rule Table +- Relevant API, schema, event, state, and interface contracts +- Changed surface or stated feature scope +- Existing tests and `Tests/test-index.yml` when available + +If the requirement, rule, contract, or oracle conflicts, return `BLOCKED` with +the conflict and owner. Existing behavior is not an oracle unless it is an +approved requirement. + +## Workflow + +### 1. Establish the test basis + +Create coverage obligations from AC, business rules, contracts, invariants, +accepted incident evidence, and applicable risks. Give each obligation an +observable oracle and priority. + +### 2. Discover existing coverage + +Search by feature, AC terms, business objects, routes, state transitions, +events, fixtures, and changed modules. Inspect assertions rather than relying +on filenames. Read `references/existing-case-discovery.md` when the repository +is large, coverage is unclear, or reuse decisions are contested. + +Classify relevant existing cases as: + +| decision | meaning | +| --- | --- | +| `reuse` | already proves the same obligation, data condition, and oracle | +| `extend` | useful coverage exists but a case, boundary, or assertion is missing | +| `new` | no credible existing case proves the obligation | +| `repair` | the case is valuable but its setup or assertion is defective | +| `retire` | it proves obsolete behavior; human approval is required | +| `needs-clarification` | intended behavior conflicts or is undefined | + +Do not create a duplicate replacement when reuse or a small extension is +sufficient. + +### 3. Design cases + +Design the smallest complete business case set. Use a technique only when it +materially shapes case selection. Read at most the relevant references: + +- `references/test-design-techniques.md` for equivalence classes, boundaries, + decision tables, state transitions, pairwise, and related techniques +- `references/cause-effect-graph.md` for interacting rules and constraints + +Technique artifacts belong to Case Design because they explain how cases were +derived. Test layers and implementation patterns do not. + +### 4. Consolidate and specify + +Merge reused, extended, repaired, and new coverage into one case catalog. +Deduplicate by obligation + data condition + action + oracle. Preserve an +existing case identity when it still represents the approved business case. + +Each `case_id` is a stable, layer-neutral business identity. State purpose, +preconditions, data, action or ordered steps, expected result, oracle, +priority, and source. Do not create an execution or layer-specific ID here. + +Produce the versioned handoff defined by +[Case Design Schema](references/case-design-schema.md). Apply its completion +gate before sending the design to `test-case-quality-review`. diff --git a/.agents/skills/test-case-design/references/case-design-schema.md b/.agents/skills/test-case-design/references/case-design-schema.md new file mode 100644 index 000000000..cc900f779 --- /dev/null +++ b/.agents/skills/test-case-design/references/case-design-schema.md @@ -0,0 +1,42 @@ +# Case Design Schema + +Read this when producing or validating the Test Case Design handoff. + +```markdown +## Test Case Design +- design_id: +- design_version: +- feature_scope: + +## Coverage Obligations +| obligation_id | source | risk | oracle | priority | status | +| --- | --- | --- | --- | --- | --- | + +## Existing Case Decisions +| existing_case_id | obligation_id | decision | evidence_gap_or_reason | source | +| --- | --- | --- | --- | --- | + +## Test Cases +| case_id | obligation_id | origin | purpose | preconditions | test_data | actions | expected_result | oracle | priority | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | + +## Technique Artifacts +Include only artifacts for techniques that materially shaped the cases. + +## Gaps and Blockers +| obligation_id | status | reason | owner | next_action | +| --- | --- | --- | --- | --- | + +## Handoff +- next_skill: test-case-quality-review +``` + +## Completion Gate + +- Every P0/P1 obligation maps to a Case or explicit blocker. +- Every Case has a source and observable oracle. +- Every relevant existing Case has a decision. +- Actions, data, expected results, and cleanup are implementable without + repeating business analysis. +- No test layer, framework, command, runtime, target file, or execution profile + is selected. diff --git a/.agents/skills/test-case-design/references/cause-effect-graph.md b/.agents/skills/test-case-design/references/cause-effect-graph.md new file mode 100644 index 000000000..a63ce46a1 --- /dev/null +++ b/.agents/skills/test-case-design/references/cause-effect-graph.md @@ -0,0 +1,30 @@ +# Cause-Effect Graph Reference + +Use for business rules where several inputs, guards, or state facts combine to +produce an outcome, especially when a decision table would otherwise be +written informally. + +1. List atomic causes: input predicates, state predicates, permissions, and + external responses. +2. List observable effects: returned result, state change, emitted event, + persisted value, or user-visible outcome. +3. Connect causes to effects with explicit AND/OR/NOT logic. Record mutually + exclusive, requires, and masks constraints. +4. Convert the constrained graph into a decision table. Remove infeasible + rows and mark why each removed row is infeasible. +5. Select the smallest set of feasible rows that covers each required effect, + each important cause, and each constraint boundary. +6. Turn selected rows into Case Specifications with concrete data and an + oracle. The graph/table is the design evidence; the cases are the + executable intent. + +Minimum artifact: + +```text +Causes: C1, C2, ... +Effects: E1, E2, ... +Constraints: C1 requires C3; C2 and C4 are exclusive +Rules: E1 = C1 AND (C2 OR C3); E2 = NOT C5 +Selected rows: R01, R03, R07 +Oracle: observable result for each selected row +``` diff --git a/.agents/skills/test-case-design/references/existing-case-discovery.md b/.agents/skills/test-case-design/references/existing-case-discovery.md new file mode 100644 index 000000000..e8c76abcf --- /dev/null +++ b/.agents/skills/test-case-design/references/existing-case-discovery.md @@ -0,0 +1,35 @@ +# Existing Case Discovery + +Load this reference from `test-case-design` when existing coverage is unclear, +the repository is large, or reuse decisions need stronger evidence. + +## Procedure + +1. Build a feature fingerprint from AC terms, business objects, changed + modules, routes, state transitions, events, contracts, fixtures, and risks. +2. Search `Tests/test-index.yml`, test files, workflow packs, fixtures, runner + selectors, and a current code graph or quality KB when available. +3. Inspect each candidate's setup, action, assertion, data condition, and + observable business outcome. +4. Record the current file, test name, layer, command, mock/real boundary, and + source evidence as discovery facts. These facts describe existing coverage; + they do not select the future execution strategy. +5. Map candidates to coverage obligations and classify each as `reuse`, + `extend`, `new`, `repair`, `retire`, or `needs-clarification`. +6. Confirm `reuse` only when the obligation, data condition, action, and oracle + match. A passing test for obsolete behavior is not reusable coverage. + +## Discovery Output + +```markdown +## Existing Coverage Inventory +| existing_case_id | file | test_name | current_layer | current_command | business_assertion | source_evidence | +| --- | --- | --- | --- | --- | --- | --- | + +## Obligation Match +| obligation_id | existing_case_id | decision | evidence_gap_or_reason | +| --- | --- | --- | --- | +``` + +Merge these decisions into the parent Test Case Design. Do not emit a separate +lifecycle artifact and do not delete or retire tests without human approval. diff --git a/.agents/skills/test-case-design/references/test-design-techniques.md b/.agents/skills/test-case-design/references/test-design-techniques.md new file mode 100644 index 000000000..94e0df7ac --- /dev/null +++ b/.agents/skills/test-case-design/references/test-design-techniques.md @@ -0,0 +1,122 @@ +# Test Design Techniques + +Load only the technique that materially shapes business case selection. These +techniques belong to Test Case Design; evidence-layer selection belongs to +Test Strategy. + +## Selector + +| Obligation shape | Technique | Required artifact | +| --- | --- | --- | +| one explicit behavior or known defect | direct example or regression reproduction | source-to-case link | +| many values treated alike | equivalence classes | valid/invalid partition table | +| limits, thresholds, dates, lengths, ranges | boundary values | ordered boundary set | +| rules combine conditions | decision table | normalized condition/action table | +| combinations are too large | pairwise | parameter/value model and generated rows | +| behavior depends on state and event order | state transition | state/event/next-state table | +| interacting numeric ranges | domain analysis | domain matrix and boundaries | +| an actor completes a goal | use case | main and alternate flow cases | +| branch-heavy implementation must be audited | control flow | branch obligations linked to business sources | +| value lifecycle or cleanup matters | data flow | definition/use/cleanup obligations | +| requirements are weak or unknown risks dominate | exploratory charter | mission, scope, heuristics, and stop condition | + +## Equivalence Classes + +Partition inputs only when the system is expected to treat all members of a +partition equivalently. Include at least one representative per valid and +invalid class and split a class when rules or outcomes differ. + +```markdown +| partition | rule | representative | expected_result | +| --- | --- | --- | --- | +``` + +## Boundary Values + +For each ordered boundary `b`, consider the smallest meaningful set among +`b-1`, `b`, and `b+1`, adjusted for the domain. Include lower and upper bounds, +empty/zero when meaningful, and overflow or precision boundaries when relevant. + +```markdown +| boundary | below | at | above | expected_results | +| --- | --- | --- | --- | --- | +``` + +## Decision Tables + +Normalize conditions before generating rows. Mark impossible combinations and +constraints explicitly; do not create arbitrary Cartesian products. + +```markdown +| rule | condition_1 | condition_2 | action | expected_result | +| --- | --- | --- | --- | --- | +``` + +Each distinct feasible action/outcome row must map to a Case or documented +equivalence. + +## Pairwise + +Use pairwise only after defining parameters, values, exclusions, and seeds. +Preserve mandatory business combinations even when a generator would omit +them. Save the model and generated rows as the technique artifact. + +```markdown +| parameter | values | constraints | +| --- | --- | --- | +``` + +## State Transition + +List states, valid events, guards, next states, and invalid transitions. Cover +required valid paths plus high-risk invalid, duplicate, retry, and terminal +state transitions. + +```markdown +| current_state | event | guard | next_state | observable_result | +| --- | --- | --- | --- | --- | +``` + +## Domain Analysis + +Use when multiple numeric dimensions jointly define valid and invalid regions. +Identify on-points and adjacent off-points without exploding all combinations. + +```markdown +| domain | dimensions | on_point | off_points | expected_result | +| --- | --- | --- | --- | --- | +``` + +## Use Case + +Derive cases from the actor's main flow, alternate flows, exceptions, +preconditions, and postconditions. Keep implementation navigation out unless +it is part of the approved user-visible behavior. + +## Control and Data Flow + +Use white-box evidence only when the source or risk requires structural +coverage. Trace every structural obligation back to an approved business rule, +contract, or risk; implementation structure alone must not invent behavior. + +## Exploratory Charter + +Use exploration to discover questions and candidate cases, not as automatic +passing evidence. + +```markdown +- mission: +- scope: +- risks_and_heuristics: +- data_or_tools: +- timebox_or_stop_condition: +- observations_to_capture: +``` + +## Technique Rules + +- Start from coverage obligations, not a method checklist. +- Normally use no more than two formal techniques for one focused change. +- A technique name without its artifact does not justify the generated cases. +- Techniques generate layer-neutral business cases; do not add framework, + command, runtime, target file, or evidence-layer choices here. diff --git a/.agents/skills/test-case-quality-review/SKILL.md b/.agents/skills/test-case-quality-review/SKILL.md new file mode 100644 index 000000000..43343aa54 --- /dev/null +++ b/.agents/skills/test-case-quality-review/SKILL.md @@ -0,0 +1,91 @@ +--- +name: test-case-quality-review +description: Use when a layer-neutral Test Case Design needs an independent approval decision before Test Strategy, especially for traceability, completeness, oracle quality, reuse evidence, duplication, and residual risk. +--- + +# Test Case Quality Review + +## Purpose + +Act as the approval gate between `test-case-design` and `test-strategy`. +Review the designed business cases; do not choose test layers, commands, +runtimes, execution profiles, mock boundaries, or target files. + +Do not silently rewrite the design. Return findings to `test-case-design` when +a case must be added or changed. + +## Required Context + +- Requirement or Story Card +- Acceptance Criteria and Business Rule Table +- Test Case Design, including obligations, existing-case decisions, cases, + technique artifacts, and blockers +- Relevant existing tests when a reuse, duplication, or repair decision needs + confirmation + +Optional sources such as a quality KB or code graph support discovery but do +not override current requirements and contracts. + +## Review Checklist + +Read [Review Rubric](references/review-rubric.md) when recording formal findings +or when a `PASS_WITH_RESIDUAL_RISK` decision is considered. + +1. Verify every P0/P1 AC and obligation maps to a case or explicit blocker. +2. Verify every case cites a source and has an observable oracle. +3. Verify preconditions, data, actions, expected results, and cleanup are + concrete enough for later implementation. +4. Verify applicable happy, negative, boundary, state, retry, ownership, and + concurrency conditions are represented without applying a fixed checklist + to unrelated features. +5. Inspect assertions for cases marked `reuse`, `extend`, `repair`, or + `retire`; reject filename-only coverage claims. +6. Reject duplicate cases that prove the same obligation, data condition, + action, and oracle. +7. Require a technique artifact only when that technique shaped the cases. +8. Confirm the design does not select layers, frameworks, commands, runtimes, + target files, or execution profiles. + +## Decisions + +- `PASS`: the approved case set is ready for Test Strategy. +- `REVISE`: the design can be corrected without a product decision. +- `BLOCKED`: requirement, ownership, contract, or oracle clarification is + required. +- `PASS_WITH_RESIDUAL_RISK`: a bounded non-blocking gap has an owner and + follow-up trigger. + +The decision cannot pass when a P0 obligation has no case or accepted blocker, +a P0/P1 case has no oracle, actions or expected results are not implementable, +or an existing-case decision is unsupported. + +## Output + +```markdown +## Test Case Quality Review +- design_id: +- design_version: +- decision: PASS | REVISE | BLOCKED | PASS_WITH_RESIDUAL_RISK +- scope_basis: + +## Findings +| severity | case_id_or_obligation_id | issue | evidence | required_change | blocking | +| --- | --- | --- | --- | --- | --- | + +## Coverage Verdict +| obligation_id | case_ids | status | residual_risk | +| --- | --- | --- | --- | + +## Existing Case Verdict +| existing_case_id | decision | evidence | required_change | +| --- | --- | --- | --- | + +## Approval +- approved_case_ids: +- excluded_case_ids: +- residual_design_risks: +- next_skill: test-strategy +``` + +`test-strategy` consumes only a passing design version. It chooses the +execution scope and evidence layers without changing the business cases. diff --git a/.agents/skills/test-case-quality-review/references/review-rubric.md b/.agents/skills/test-case-quality-review/references/review-rubric.md new file mode 100644 index 000000000..ce2a0303a --- /dev/null +++ b/.agents/skills/test-case-quality-review/references/review-rubric.md @@ -0,0 +1,17 @@ +# Test Case Design Review Rubric + +Use this rubric for a formal review. It evaluates design quality, not test +layers, implementation files, commands, frameworks, or runtime readiness. + +| Dimension | Passing evidence | Blocking condition | +| --- | --- | --- | +| Traceability | Every P0/P1 obligation maps to a Case or accepted blocker | Unmapped P0 obligation | +| Oracle | Expected behavior is observable and source-backed | Missing or contradictory P0/P1 oracle | +| Case specification | Preconditions, data, action, expected result, and cleanup are implementable | Material behavior must be guessed | +| Existing coverage | Reuse/extend/repair decision is based on inspected assertions | Filename-only or stale coverage claim | +| Completeness | Applicable positive, negative, boundary, state, retry, ownership, and concurrency risks are addressed | Relevant high-risk condition omitted | +| Economy | Cases are deduplicated by obligation, condition, action, and oracle | Duplicate Cases inflate coverage | + +`PASS_WITH_RESIDUAL_RISK` requires a bounded non-P0 gap, named owner, and +follow-up trigger. Review findings return to Test Case Design; reviewers do not +silently rewrite Cases. diff --git a/.agents/skills/test-execution/SKILL.md b/.agents/skills/test-execution/SKILL.md new file mode 100644 index 000000000..2bf69845d --- /dev/null +++ b/.agents/skills/test-execution/SKILL.md @@ -0,0 +1,76 @@ +--- +name: test-execution +description: Use when a READY Test Strategy must be implemented and run through selected project test layers, producing current-source command evidence without redesigning Cases or changing layer choices. +--- + +# Test Execution + +## Purpose + +Consume a `READY` Test Strategy and turn its Execution Plan into test code, +commands, and evidence. Do not select layers, change an oracle, add business +Cases, or load unselected layer references. + +## Required Input + +- Approved Test Case Design and exact `design_version` +- `READY` Test Strategy +- Execution Plan rows containing `execution_id`, `case_id`, `test_case_id`, `layer`, + `layer_reference`, `action`, target, command, runtime, and expected evidence +- Project `Tests/test-index.yml`, test README, and runner + +Read [Execution Evidence Schema](references/evidence-schema.md) when recording +or validating results. + +## Selected Layer References + +Load only references named by the Execution Plan: + +| Strategy layer | Reference | +| --- | --- | +| `backend-ut` | `references/layers/backend-ut.md` | +| `frontend-ut` | `references/layers/frontend-ut.md` | +| `contract` | `references/layers/contract.md` | +| `frontend-it` | `references/layers/frontend-it.md` | +| `backend-it` | `references/layers/backend-it-testcontainers.md` | +| `e2e` | `references/layers/e2e.md` | + +The project CLI is the execution authority. A layer reference explains how to +implement and verify that layer; it does not replace `Tests/test-index.yml` or +invent commands. + +## Execution Workflow + +For each Execution Plan row in order: + +1. Verify the `case_id` exists in the approved design, `test_case_id` matches + the selected layer and project format, and the row has exactly one layer. +2. Load only the selected layer reference and inspect the target source, existing + tests, fixtures, and project runner entry. +3. Apply the planned action: + - `run-existing`: do not generate a duplicate test. + - `extend-existing`: make the smallest assertion, data, or case extension. + - `create-new`: create one focused executable test for the approved case. + - `repair-test`: repair setup or assertion without changing the oracle. + - `defer`: do not implement or run; preserve owner and residual risk. +4. For changed tests, run the narrowest available focused command first. +5. Run the Strategy command or declared layer gate. +6. Prove the intended current-source test ran; zero selected tests, stale + artifacts, swallowed setup failures, or undeclared skips are not passing. +7. Record runtime, fixture/reset state, exit status, report paths, and the + observation that satisfies or falsifies the approved oracle. + +Shared implementation rules: + +- Test observable behavior rather than private methods or incidental calls. +- Keep data deterministic and reset mutable state. +- Mock only outside the behavior the selected layer must prove. +- Fail loudly on missing dependencies, setup errors, and selector mismatch. +- Do not modify production behavior unless the user explicitly authorized an + implementation or defect fix. + +Produce the report defined by +[Execution Evidence Schema](references/evidence-schema.md). Send test, +fixture, runner, or environment failures to the workflow repair stage. Return +a wrong Case or oracle to Case Design review and a wrong layer, command, +target, runtime, or order to Test Strategy. diff --git a/.agents/skills/test-execution/references/evidence-schema.md b/.agents/skills/test-execution/references/evidence-schema.md new file mode 100644 index 000000000..b20159f36 --- /dev/null +++ b/.agents/skills/test-execution/references/evidence-schema.md @@ -0,0 +1,42 @@ +# Execution Evidence Schema + +Read this when recording or validating execution evidence. + +| Field | Required evidence | +| --- | --- | +| Identity | `execution_id`, `case_id`, `test_case_id`, and layer | +| Change | action, changed test file, and concise change reason | +| Command | exact command and declared command source | +| Runtime | framework/runtime versions and required service state | +| Selection proof | evidence that the intended current-source test ran | +| Oracle observation | actual observation satisfying or falsifying the approved oracle | +| Result | `PASSED`, `FAILED`, `BLOCKED`, `SKIPPED`, `NOT_PROVEN`, or `INCOMPLETE` | +| Artifacts | report, log, coverage, trace, screenshot, or video paths when produced | + +## Result Status + +| Status | Meaning | +| --- | --- | +| `PASSED` | intended current-source test ran and satisfied the oracle | +| `FAILED` | intended test ran and falsified the oracle | +| `BLOCKED` | requirement, dependency, runtime, or environment prevented evidence | +| `SKIPPED` | Strategy explicitly deferred or skipped the execution item | +| `NOT_PROVEN` | available evidence cannot prove the Case claim | +| `INCOMPLETE` | setup, selector, stale artifact, or partial run invalidated the result | + +A zero-test selector, stale report, swallowed setup failure, or undeclared skip +cannot produce `PASSED`. + +```markdown +## Test Execution Report +| execution_id | case_id | test_case_id | layer | action | test_file | command | runtime | result | oracle_observation | artifacts | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | + +## Changed Test Assets +| execution_id | file | change | reason | +| --- | --- | --- | --- | + +## Unproven or Deferred +| execution_id | case_id | test_case_id | status | reason | residual_risk | owner | +| --- | --- | --- | --- | --- | --- | --- | +``` diff --git a/.agents/skills/test-execution/references/layers/backend-it-testcontainers.md b/.agents/skills/test-execution/references/layers/backend-it-testcontainers.md new file mode 100644 index 000000000..238cb3648 --- /dev/null +++ b/.agents/skills/test-execution/references/layers/backend-it-testcontainers.md @@ -0,0 +1,29 @@ +# Backend Integration Test + +Load only when the READY Strategy selects `backend-it`. + +## Boundary + +Use backend integration assets, runtime, and command declared in +`Tests/test-index.yml` and `Tests/README.md`. This layer proves behavior across +the application and declared infrastructure substitutes. It does not prove a +browser journey or production topology. + +## Procedure + +1. Read the Execution Plan row, target service/controller/repository, indexed + integration tests, runtime requirements, and runner. +2. Confirm the required container or service runtime is available before + changing tests. Read `../runtimes/colima.md` only when a macOS Colima + runtime must be prepared or diagnosed. +3. Keep the infrastructure named by the Strategy real; do not mock persistence, + transactions, locking, or side effects the execution item must prove. +4. Apply only the planned action, create deterministic fixtures, isolate state, + and assert both the API/service observation and required persisted effects. +5. Run a focused integration selector when supported, then the exact Strategy + command. Record image/runtime and cleanup behavior. + +## Evidence + +Record the Case ID, test Case ID, execution ID, test asset, runtime and image, fixture/reset state, +tables or side effects observed, command, result, and artifacts. diff --git a/.agents/skills/test-execution/references/layers/backend-ut.md b/.agents/skills/test-execution/references/layers/backend-ut.md new file mode 100644 index 000000000..b9a877c35 --- /dev/null +++ b/.agents/skills/test-execution/references/layers/backend-ut.md @@ -0,0 +1,28 @@ +# Backend Unit Test + +Load only when the READY Strategy selects `backend-ut`. + +## Boundary + +Use the project's backend unit framework and assets declared under +`Tests/test-index.yml`. This layer proves isolated rules, calculations, +validation, and state decisions. It does not prove database transactions, +framework wiring, external services, or browser behavior. + +## Procedure + +1. Read the Execution Plan row, target source, indexed unit tests, and runner. +2. Keep the test outside real infrastructure; control external collaborators, + time, and generated identifiers. +3. Implement only the planned `run-existing`, `extend-existing`, `create-new`, + or `repair-test` action while preserving the Case oracle. +4. Assert business inputs, outputs, errors, and state transitions rather than + private methods or incidental interaction counts. +5. Run a focused project command when the runner supports one, then run the + exact backend-unit command from the Strategy. + +## Evidence + +Record the Case ID, test Case ID, execution ID, test class or file, focused and layer commands, +runtime, result, and oracle observation. Do not claim persistence or HTTP +wiring evidence from a controlled unit test. diff --git a/.agents/skills/test-execution/references/layers/contract.md b/.agents/skills/test-execution/references/layers/contract.md new file mode 100644 index 000000000..bc3e36c1e --- /dev/null +++ b/.agents/skills/test-execution/references/layers/contract.md @@ -0,0 +1,27 @@ +# Contract Test + +Load only when the READY Strategy selects `contract`. + +## Boundary + +Use contract assets and tests declared in `Tests/test-index.yml`. This layer +proves compatibility at a declared producer/consumer or external boundary. It +does not prove complete business behavior, persistence, or browser wiring. + +## Procedure + +1. Read the Execution Plan row, authoritative contract, producer and consumer + surfaces, indexed fixtures/tests, and runner. +2. Identify the exact compatibility claim: route, method, required field, + type, schema, event, XML, or serialization rule. +3. Apply only the planned action. Do not weaken required fields or validate a + self-authored fixture without connecting it to the declared boundary. +4. Record intentional breaking changes and affected consumers instead of + silently updating both sides. +5. Run the focused contract selector when available, then the Strategy command. + +## Evidence + +Record the Case ID, test Case ID, execution ID, contract and test assets, compatibility decision, +command, result, and validated boundary. Persistence and side effects require +a separate Strategy execution item. diff --git a/.agents/skills/test-execution/references/layers/e2e.md b/.agents/skills/test-execution/references/layers/e2e.md new file mode 100644 index 000000000..b8698386c --- /dev/null +++ b/.agents/skills/test-execution/references/layers/e2e.md @@ -0,0 +1,28 @@ +# E2E Smoke Test + +Load only when the READY Strategy selects `e2e`. + +## Boundary + +Use browser tests, fixtures, services, and commands declared in +`Tests/test-index.yml` and `Tests/README.md`. This layer proves a critical +user-visible journey in the declared environment. It does not prove exhaustive +business-rule combinations or an undeclared deployed topology. + +## Procedure + +1. Read the Execution Plan row, indexed browser tests and fixtures, application + startup contract, and runner. +2. Confirm prerequisite Strategy items are green or explicitly waived. +3. Apply only the planned action. Use stable role/label selectors, deterministic + accounts or seeded data, and observable user outcomes. +4. Keep the path small; do not duplicate matrices that lower layers already + prove. Label fixture-server evidence as local-runtime evidence. +5. Run the focused browser spec when supported, then the Strategy command. + Capture trace, screenshot, or video on failure when configured. + +## Evidence + +Record the Case ID, test Case ID, execution ID, browser path, environment, visible oracle observation, +command, result, and artifact paths. Natural-language UI exploration may inform +a script but is not deterministic passing evidence. diff --git a/.agents/skills/test-execution/references/layers/frontend-it.md b/.agents/skills/test-execution/references/layers/frontend-it.md new file mode 100644 index 000000000..36566706e --- /dev/null +++ b/.agents/skills/test-execution/references/layers/frontend-it.md @@ -0,0 +1,28 @@ +# Frontend Integration Test + +Load only when the READY Strategy selects `frontend-it`. + +## Boundary + +Use frontend integration assets and package scripts declared in +`Tests/test-index.yml`. This layer proves cooperation among frontend modules +and request construction against a controlled network boundary. It does not +prove server-side rules, persistence, or deployed browser behavior. + +## Procedure + +1. Read the Execution Plan row, page/client/store/router surfaces, indexed + tests, request-spy or mock-server support, and runner. +2. Keep internal frontend modules real; control the network only at the + declared boundary. +3. Apply only the planned action and preserve the Case action, data, and oracle. +4. Assert user-visible state and captured request path, query, body, or error + behavior required by the case. +5. Reset handlers and shared state per test, run a focused selector when + available, then run the Strategy command. + +## Evidence + +Record the Case ID, test Case ID, execution ID, test file, controlled boundary, request or visible +observation, command, runtime, and result. Do not report controlled responses +as backend correctness. diff --git a/.agents/skills/test-execution/references/layers/frontend-ut.md b/.agents/skills/test-execution/references/layers/frontend-ut.md new file mode 100644 index 000000000..c769a4d61 --- /dev/null +++ b/.agents/skills/test-execution/references/layers/frontend-ut.md @@ -0,0 +1,27 @@ +# Frontend Unit Test + +Load only when the READY Strategy selects `frontend-ut`. + +## Boundary + +Use the frontend unit framework and assets declared in `Tests/test-index.yml`. +This layer proves pure frontend module behavior. It does not prove rendered +page wiring, real HTTP, backend rules, or browser journeys. + +## Procedure + +1. Read the Execution Plan row, target module, indexed tests, package scripts, + and project runner. +2. Keep the test deterministic and independent of a real browser, network, or + backend. Control storage and time when the case requires them. +3. Apply only the planned action and preserve the Case inputs and oracle. +4. Assert returned values, state mappings, formatting, validation, or payload + construction rather than framework internals. +5. Run the narrowest matching test selector, then the exact frontend-unit + command from the Strategy. + +## Evidence + +Record the Case ID, test Case ID, execution ID, test file, focused and layer commands, runtime, +result, and oracle observation. Escalate page/client cooperation to Strategy +instead of silently broadening this layer. diff --git a/.agents/skills/test-execution/references/runtimes/colima.md b/.agents/skills/test-execution/references/runtimes/colima.md new file mode 100644 index 000000000..b4414b927 --- /dev/null +++ b/.agents/skills/test-execution/references/runtimes/colima.md @@ -0,0 +1,26 @@ +# Colima Runtime + +Load this reference only when a macOS backend-integration execution item needs +a Docker-compatible Colima runtime. + +1. Read `Tests/README.md` and the project runner before setting environment + variables; prefer the runner's automatic detection. +2. Check `colima status` and `docker info` without changing state. +3. Start Colima only when the user requested execution and the runtime is not + running: + +```bash +colima start --runtime docker +docker info +``` + +4. If the runner cannot detect the socket, use the project-documented values; + typical settings are: + +```bash +export DOCKER_HOST="unix://${HOME}/.colima/default/docker.sock" +export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/var/run/docker.sock +``` + +Report runtime failures as `BLOCKED`; do not skip the selected integration +item or claim unit-test evidence as a substitute. diff --git a/.agents/skills/test-strategy/SKILL.md b/.agents/skills/test-strategy/SKILL.md new file mode 100644 index 000000000..733aea026 --- /dev/null +++ b/.agents/skills/test-strategy/SKILL.md @@ -0,0 +1,56 @@ +--- +name: test-strategy +description: Use when an approved Test Case Design needs test-layer selection and an executable plan covering case scope, implementation action, targets, project commands, runtimes, order, gates, and residual risk. +--- + +# Test Strategy + +## Purpose + +Decide **how, where, and when approved business cases will be tested**. +This is the sole owner of test-layer selection and execution planning. + +Do not invent a business case, change an oracle, or add a test-design technique. +Return design gaps to `test-case-design` through quality review. + +## Required Context + +- Passing Test Case Quality Review +- Approved Test Case Design and `case_id` values +- Changed files or feature scope and affected contracts +- `Tests/test-index.yml`, `Tests/README.md`, and the project runner +- Available runtimes and requested delivery profile + +Read [Layer Capabilities](references/layer-capabilities.md) when selecting +evidence layers, [Test Pyramid](references/test-pyramid.md) when balancing the +portfolio, and [Execution Plan Schema](references/execution-plan-schema.md) +when producing the handoff. Read only project inventory and runner entries +relevant to candidate layers. + +## Strategy Workflow + +1. Confirm the exact approved `design_id` and `design_version`. +2. Select the smallest case set required by the requested profile and risks. +3. For each selected `case_id`, choose one or more evidence layers only when + each layer proves a distinct property. +4. Assign a stable, layer-specific `test_case_id` to every case-layer variant, + using the project format. Preserve an existing `test_case_id` when reusing + or extending the same executable test. +5. Assign an `execution_id` to every row in this Strategy run. The business + `case_id` and executable `test_case_id` remain distinct. +6. Choose one implementation action: + - `run-existing` + - `extend-existing` + - `create-new` + - `repair-test` + - `defer` +7. Resolve the layer reference, target asset, exact command, runtime, prerequisites, + and expected evidence from the project test inventory and runner. Never + infer a command from a layer name. +8. Order focused, deterministic checks before infrastructure and browser + checks while preserving real prerequisites. +9. Record gates, deferred cases, owners, and residual risk. + +Produce the handoff and apply the READY gate defined by +[Execution Plan Schema](references/execution-plan-schema.md). Send only a +`READY` plan to `test-execution`. diff --git a/.agents/skills/test-strategy/references/execution-plan-schema.md b/.agents/skills/test-strategy/references/execution-plan-schema.md new file mode 100644 index 000000000..9f5a02621 --- /dev/null +++ b/.agents/skills/test-strategy/references/execution-plan-schema.md @@ -0,0 +1,49 @@ +# Execution Plan Schema + +Every executable row must contain: + +| Field | Contract | +| --- | --- | +| `execution_id` | Unique to this planned run or implementation action | +| `case_id` | Approved layer-neutral business Case | +| `test_case_id` | Stable executable identity for one Case and one layer | +| `layer` | Exactly one supported project layer | +| `layer_reference` | Test Execution reference to load for that layer | +| `action` | `run-existing`, `extend-existing`, `create-new`, `repair-test`, or `defer` | +| `target` | Existing or planned test asset | +| `command` | Exact project command | +| `command_source` | Location in `Tests/test-index.yml`, README, or runner | +| `runtime` | Required execution environment | +| `expected_evidence` | Observation and artifact needed to prove the oracle | + +The plan is `READY` only when every non-deferred row is resolvable without +inventing a command, Case, oracle, target, or runtime. + +```markdown +## Test Strategy +- strategy_id: +- design_id: +- design_version: +- execution_profile: +- selection_basis: +- gates: + +## Execution Plan +| order | execution_id | case_id | test_case_id | layer | layer_reference | action | existing_test | target | command | command_source | runtime | expected_evidence | +| ---: | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | + +## Deferred Cases +| case_id | reason | residual_risk | owner | follow_up | +| --- | --- | --- | --- | --- | + +## Strategy Gate +- all_execution_items_reference_approved_cases: +- distinct_evidence_claim_per_added_layer: +- commands_resolved_from_project_sources: +- runtimes_available_or_explicitly_blocked: +- decision: READY | REVISE | BLOCKED +``` + +Every added layer must prove a distinct claim. Every deferment needs a reason, +owner, follow-up, and residual risk. The Strategy must not introduce a new +business Case or changed oracle. diff --git a/.agents/skills/test-strategy/references/layer-capabilities.md b/.agents/skills/test-strategy/references/layer-capabilities.md new file mode 100644 index 000000000..5bb16b410 --- /dev/null +++ b/.agents/skills/test-strategy/references/layer-capabilities.md @@ -0,0 +1,25 @@ +# Test Layer Capabilities + +Use this reference from `test-strategy` to select the lowest-cost evidence +layer that can prove each approved business case. Confirm available layers, +assets, commands, and runtimes in the project's `Tests/test-index.yml`. + +| Layer | Use when the oracle requires | Proves | Does not prove | Typical runtime | +| --- | --- | --- | --- | --- | +| Backend Unit | isolated backend rules, calculations, validation, or state decisions | deterministic behavior with controlled collaborators | persistence, transactions, deployed wiring, browser behavior | language test runner | +| Frontend Unit | pure presentation, formatting, state mapping, or payload helper logic | deterministic frontend module behavior | rendered page wiring, real HTTP, backend rules | Node test runner | +| Contract | route, method, request/response schema, event, or serialization compatibility | producer/consumer boundary compatibility | complete business behavior or persistence | schema or contract runner | +| Frontend Integration | page/client/store/router cooperation with a controlled network boundary | request construction and frontend states across modules | server rules or deployed-system behavior | DOM runtime and request spy/mock server | +| Backend Integration | database, transaction, cache, queue, filesystem, or framework wiring | real integration behavior inside the declared runtime | browser journey or production topology | service runtime and containers when required | +| E2E/System | a critical user journey through real application boundaries | browser-visible workflow in the declared environment | exhaustive rule combinations or undeclared deployment properties | browser and application services | + +## Selection Rules + +- Select layers after Case Design approval; do not push layer choices back into + business case identity. +- Add a second layer only for a distinct evidence claim, not for pyramid quotas. +- Prefer focused deterministic evidence before infrastructure or browser cost. +- Treat API endpoint behavior and consumer/provider compatibility as different + claims; do not hide them under a generic integration label. +- Record what the chosen layer cannot prove as residual risk or another + execution item. diff --git a/.agents/skills/test-strategy/references/test-pyramid.md b/.agents/skills/test-strategy/references/test-pyramid.md new file mode 100644 index 000000000..2c7e38214 --- /dev/null +++ b/.agents/skills/test-strategy/references/test-pyramid.md @@ -0,0 +1,14 @@ +# Test Pyramid + +Use this reference when the planned evidence is concentrated in expensive or +brittle layers. It is a portfolio heuristic, not a mandatory quota. + +| Layer group | Typical portfolio range | Best evidence | +| --- | ---: | --- | +| Unit | 60-75% | isolated rules, calculations, validation, state decisions | +| Integration and Contract | 20-30% | wiring, persistence, transactions, boundaries, compatibility | +| E2E | 5-10% | a small set of critical user journeys | + +Prefer the lowest layer that can credibly observe the approved oracle. Add a +higher layer only when it proves a distinct property. Risk, architecture, and +failure cost override the illustrative percentages. diff --git a/.codex/agents/test-engineer.toml b/.codex/agents/test-engineer.toml new file mode 100644 index 000000000..00a14c995 --- /dev/null +++ b/.codex/agents/test-engineer.toml @@ -0,0 +1,21 @@ +name = "test_engineer" +description = "Testing specialist for coverage analysis, Case Design review, Strategy verification, test execution, and evidence reproduction." +sandbox_mode = "workspace-write" + +developer_instructions = """ +Work as a specialist inside test-agent-workflow, not as its orchestrator. + +Use test-case-design for layer-neutral business Cases and existing-coverage analysis. +Use test-case-quality-review for independent design approval. +Use test-strategy for test-layer selection and executable planning. +Use test-execution only for a READY Strategy and preserve current-source evidence. + +Do not select test layers during Case Design. +Do not rewrite Cases during Quality Review. +Do not invent a Case or change its oracle during Strategy or Execution. +Do not claim a command ran unless it was executed and the intended current-source test is proven to have run. +In review-only mode, do not edit files. +Report product defects unless product-code changes were explicitly authorized. + +Return concise findings with Case, execution, command, result, and evidence identities preserved. +""" diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 000000000..b067f4e07 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,30 @@ +# Project Agent Skill Entrypoints + +Codex discovers this repository's testing Skills from `.agents/skills`. The +root `skills` path is a compatibility link to that canonical directory. + +## Public testing Skills + +| Intent | Skill | +| --- | --- | +| Complete testing lifecycle | `test-agent-workflow` | +| Layer-neutral Test Case Design | `test-case-design` | +| Independent Case Design approval | `test-case-quality-review` | +| Layer selection and execution planning | `test-strategy` | +| Test implementation, execution, and evidence | `test-execution` | +| KB, benchmark, Skill optimization, or CI governance | `test-agent-governance` | + +Normal workflow order is requirement and AC preparation when needed, Test Case +Design, Quality Review, Test Strategy, Test Execution, classified repair when +needed, and final reporting. `test-agent-governance` is explicit-only and not +part of every feature run. + +Internal stages and execution-layer instructions are references rather than +independently discoverable Skills. Test Strategy owns layer selection. Test +Execution resolves commands from `Tests/test-index.yml` and the project runner. +The workflow does not depend on Test Harness method or level routers. + +The optional project custom agent `test_engineer` is defined in +`.codex/agents/test-engineer.toml`. Use it for independent coverage analysis, +Case review, or evidence reproduction when isolation is useful. Ordinary +workflow runs do not require a subagent. diff --git a/Tests/.gitignore b/Tests/.gitignore new file mode 100644 index 000000000..78edbddc1 --- /dev/null +++ b/Tests/.gitignore @@ -0,0 +1,7 @@ +.DS_Store +backend/target/ +frontend/coverage/ +frontend/node_modules/ +e2e/node_modules/ +e2e/playwright-report/ +e2e/test-results/ diff --git a/Tests/README.md b/Tests/README.md new file mode 100644 index 000000000..73a35546e --- /dev/null +++ b/Tests/README.md @@ -0,0 +1,277 @@ +# litemall 分层自动化测试体系 + +本目录是为 `litemall` 建立的独立测试工程。所有新增测试代码、契约、mock/harness、运行脚本都放在 `Tests/` 下，原项目源码不做侵入式改造，适合培训、试点和后续迁移到 CI。 + +当前已实现测试以功能正确性为主，覆盖订单支付链路的业务规则、接口契约、真实持久化和浏览器主路径。完整测试体系还应继续补齐 performance 和 accessibility 两类非功能质量门禁。 + +新增的商品浏览训练切片覆盖“首页 -> 商品列表筛选 -> 商品详情 -> 相关推荐”的前后端协作，用于培训中展示支付之外的轻量业务模块如何分层测试。 + +## 质量维度 + +| 维度 | 当前状态 | 推荐技术选型 | 建议 Gate | +| --- | --- | --- | --- | +| Functional | 已实现 baseline | JUnit、Mockito、Spring Test、Testcontainers、Vitest、Playwright、Contract fixtures | PR Fast、PR Infra、Main Smoke | +| Coverage | 已实现报告生成 | JaCoCo、Vitest V8 coverage | PR Review、Training Review | +| Performance | Gate 配置已可校验，实测数据待接入 | Lighthouse CI、Core Web Vitals、Playwright trace、k6/JMeter、API p95 budget、bundle budget | PR Perf Check、Nightly Perf | +| Accessibility | 规划补齐 | axe-core、Playwright accessibility scan、键盘导航脚本、对比度检查、人工 screen reader 抽查 | PR A11y Check、Release A11y | + +## 测试分层 + +| 层级 | 路径 | 技术选型 | 主要验证点 | +| --- | --- | --- | --- | +| 后端 UT | `backend/src/test/java/.../unit` | JUnit 4, Mockito, Spring Test | 订单状态规则、支付回调分支、金额一致性、重复回调幂等、取消补偿、退款、团购状态 | +| 后端 IT | `backend/src/test/java/.../it` | Spring Boot Test, MyBatis, Testcontainers MySQL, Colima | MySQL mapper 行为、乐观锁、库存扣减/回补、优惠券回滚、团购记录过滤 | +| 契约测试 | `backend/src/test/java/.../contract`, `contracts/` | JUnit, JSON/XML fixtures | 前端 API 路径和后端 Controller mapping 对齐、微信支付回调 XML 字段稳定、订单生命周期接口稳定 | +| 前端 UT | `frontend/tests/unit` | Vitest, jsdom | 金额展示、localStorage checkout 信息保存、订单状态动作映射 | +| 前端 IT | `frontend/tests/it` | Vitest, request spy | 移动端下单/预支付/H5 支付/结算/取消/退款/确认/删除 API 请求结构 | +| Coverage | `backend/target/site/jacoco`, `frontend/coverage` | JaCoCo, Vitest V8 coverage | 后端生产模块覆盖率报告、前端训练切片覆盖率报告 | +| AI UI Agent（可选） | `ui-agent/` | Page Agent 1.11.0, Playwright handoff | 自然语言 UI 探索、选择器修复、候选 E2E 步骤生成；不作为 CI 强门禁 | +| 前端 E2E | `e2e/tests` | Playwright, Express harness | 浏览器支付主链路、重复支付回调只生效一次、取消订单释放库存和优惠券 | +| 脚本自检 | `scripts/` | Bash, mocked npm | 分层入口脚本、npm lockfile 变更检测、重复安装保护 | + +## 商品浏览切片 + +商品浏览模块适合做培训主模块，当前测试覆盖： + +- 首页聚合：banner、频道、新品、人气、品牌、专题、团购、楼层商品。 +- 商品列表：分类、品牌、关键词、新品/人气、分页、排序参数透传，登录搜索写入搜索历史。 +- 商品详情：商品基础信息、属性、规格、货品库存、品牌、评论、团购规则、收藏状态、分享图和登录足迹。 +- 相关推荐：详情页按同类目推荐商品，未知商品返回参数值错误。 + +新增关键文件： + +- `Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/WxProductBrowsingUnitTest.java` +- `Tests/backend/src/test/java/org/linlinjava/litemall/tests/contract/ProductBrowsingContractTest.java` +- `Tests/contracts/product-browsing-api.contract.json` +- `Tests/frontend/tests/it/mobile-product-browsing-api.it.test.ts` +- `Tests/e2e/tests/product-browsing-flow.spec.ts` + +商品发现专用命令只运行上述训练切片，适合课堂和最小证据反馈： + +| 命令 | 精确资产 | 证据边界 | +| --- | --- | --- | +| `./Tests/scripts/run-layered-tests.sh browse-backend-ut` | `WxProductBrowsingUnitTest` | Controller 受控依赖下的规则；不证明真实数据库或前端交互 | +| `./Tests/scripts/run-layered-tests.sh browse-contract` | `ProductBrowsingContractTest` | 前端路径、后端 mapping、HTTP method 与详情 `id`；不证明完整 response schema | +| `./Tests/scripts/run-layered-tests.sh browse-frontend-it` | `mobile-product-browsing-api.it.test.ts` | 前端 API client 的路径和 query；不证明页面状态或服务端规则 | +| `./Tests/scripts/run-layered-tests.sh browse-e2e` | `product-browsing-flow.spec.ts` | Express harness 中的浏览器 wiring；不代表部署态 litemall | +| `./Tests/scripts/run-layered-tests.sh browse-fast` | 前三项，不含 E2E | 快速商品发现反馈；不证明浏览器交互 | + +当前 E2E 能看到相关推荐文本，但没有点击推荐商品并进入新的详情页。当前详情资产能返回或显示规格和库存，但没有覆盖规格选择 UI 及零库存不可售状态。这两项应作为显式能力缺口，不得从现有绿色结果外推。 + +## 非功能测试规划 + +Performance 和 accessibility 不应挤进现有 functional baseline，也不应简单用 E2E happy path 代替。建议后续按独立 gate 补齐： + +| 层级 | 建议路径 | 建议命令 | 验证点 | +| --- | --- | --- | --- | +| Performance gate config | `performance/` | `./Tests/scripts/run-layered-tests.sh performance-gate` | 校验预算、Quick/Deep mode、metric honesty、CI artifacts 规则 | +| Performance smoke | `performance/` | future: `./Tests/scripts/run-layered-tests.sh performance` | 首页、订单列表、订单详情、支付页的 Lighthouse 分数、Core Web Vitals、bundle budget | +| Backend performance | `performance/backend` | `./Tests/scripts/run-layered-tests.sh backend-perf` | 提交订单、订单详情、支付回调等关键接口的 p95 响应时间和错误率 | +| Accessibility scan | `accessibility/` | `./Tests/scripts/run-layered-tests.sh accessibility` | axe 自动扫描、语义标签、表单 label、颜色对比度、ARIA 基础问题 | +| Accessibility keyboard | `accessibility/keyboard` | `./Tests/scripts/run-layered-tests.sh a11y-keyboard` | 仅用键盘完成登录、下单、支付、退款、订单详情查看 | + +建议初期将 performance/accessibility 作为 non-blocking gate 输出报告，等阈值和误报治理稳定后再提升为 blocking gate。 + +## 一键运行 + +```bash +cd /Users/summer/Work/Code/AI/training/litemall + +# 快速反馈：脚本自检 + 后端 UT + 契约 + 前端 UT + 前端 IT +./Tests/scripts/run-layered-tests.sh fast + +# 商品发现快速反馈：Backend UT + Contract + Frontend IT +./Tests/scripts/run-layered-tests.sh browse-fast + +# 商品发现浏览器 wiring（Express harness） +./Tests/scripts/run-layered-tests.sh browse-e2e + +# 后端集成测试：Testcontainers MySQL +./Tests/scripts/run-layered-tests.sh backend-it + +# 前端浏览器 E2E +./Tests/scripts/run-layered-tests.sh e2e + +# 性能门禁配置校验：不伪造 Lighthouse/CrUX/API 指标 +./Tests/scripts/run-layered-tests.sh performance-gate + +# 覆盖率报告：后端 JaCoCo + 前端 Vitest V8 +./Tests/scripts/run-layered-tests.sh coverage + +# 规划中的实测非功能门禁 +# ./Tests/scripts/run-layered-tests.sh performance +# ./Tests/scripts/run-layered-tests.sh accessibility + +# 全量验证 +./Tests/scripts/run-layered-tests.sh all +``` + +脚本会自动处理： + +- 首次运行时安装 `Tests/frontend` 和 `Tests/e2e` 的 npm 依赖。 +- 当 `package-lock.json` 变化时自动使用 `npm ci` 重装依赖，避免复用陈旧的 `node_modules`。 +- 每次后端测试命令开始时，将当前 litemall 后端模块安装到本地 Maven 仓库，避免测试依赖旧 jar；同一次 `all` 运行内只安装一次。 +- 如果检测到 `~/.colima/default/docker.sock`，自动为 Testcontainers 设置 `DOCKER_HOST`。 +- 在新 Docker/Colima 环境下使用 Testcontainers `1.21.4`，避免旧 Docker API 兼容问题。 + +## Coverage + +Coverage 用于培训评审和缺口分析，不替代分层测试本身。当前命令会生成两类报告： + +- 后端：`./Tests/scripts/run-layered-tests.sh backend-coverage` + - 运行 backend UT、contract、backend IT。 + - 使用 JaCoCo agent 收集执行数据。 + - 使用 JaCoCo CLI 对 `litemall-core`、`litemall-db`、`litemall-wx-api` 的生产类和源码生成报告。 + - 报告位置：`Tests/backend/target/site/jacoco/index.html`、`jacoco.xml`、`jacoco.csv`。 +- 前端：`./Tests/scripts/run-layered-tests.sh frontend-coverage` + - 运行 Vitest 全部前端 UT/IT。 + - 使用 V8 coverage 统计当前训练切片。 + - 报告位置：`Tests/frontend/coverage/index.html`、`lcov.info`、`coverage-summary.json`。 + +当前不设置全局 coverage 阈值。原因是训练工程只覆盖支付和商品浏览切片，直接把 litemall 全量模块纳入阈值会把大量未纳入训练范围的历史功能计为失败。推荐做法是先用报告识别缺口，再为进入训练范围的模块逐步增加模块级阈值。 + +## Performance Gate + +Performance gate 复用 `agent-skills` 的 measure-first 设计： + +```text +Measure -> Identify -> Fix -> Verify -> Guard +``` + +当前可运行的 `performance-gate` 只校验门禁配置，不声称已经测量性能： + +- Quick mode：没有 Lighthouse、CrUX、PageSpeed、DevTools trace 或 RUM artifact 时，只允许做源码级审计，所有指标必须标为 `not measured`。 +- Deep mode：有测量 artifact 时，LCP、INP、CLS、Lighthouse、API p95 等指标必须标注来源。 +- Metric honesty：禁止从源码推断 Core Web Vitals，禁止混用 lab 和 field 数据，禁止没有 artifact 就宣称通过。 + +关键文件： + +- `Tests/performance/performance-gate.yml` +- `Tests/performance/validate-performance-gate.rb` + +## Page Agent UI 层（可选） + +Page Agent 适合放在 UI 探索和脚本生成前置层：用自然语言驱动本地页面，收集 action history，再把稳定流程转成 Playwright。它依赖 LLM key、模型行为和浏览器内执行，因此默认不纳入 `fast` 或 `all`。 + +场景和证据格式见 `Tests/ui-agent/page-agent-scenarios.md`。推荐训练流程是： + +```text +Story/AC/Test Case ID + -> Page Agent 探索 UI 流程 + -> 保存 prompt + trace + 可见业务证据 + -> 质量评审 + -> 转成确定性 Playwright + -> 进入 E2E smoke +``` + +## Colima 准备 + +后端 IT 需要 Docker-compatible runtime。macOS 上推荐 Colima： + +```bash +colima start --runtime docker --network-address --cpu 4 --memory 6 --disk 60 +docker info +``` + +正常情况下无需手动导出环境变量，`run-layered-tests.sh` 会自动识别 Colima socket。如需手动指定： + +```bash +export DOCKER_HOST="unix://${HOME}/.colima/default/docker.sock" +export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/var/run/docker.sock +``` + +## 训练业务切片 + +当前测试体系围绕 litemall 的支付可靠性链路展开： + +```text +用户提交订单 + -> 扣减库存 + -> 发起支付 + -> 微信支付回调到达 + -> 校验回调金额和订单实付金额 + -> 重复回调幂等返回成功 + -> 订单标记为已支付 + -> 移除未支付超时补偿任务 +``` + +扩展后的关键业务点： + +```text +取消未支付订单 + -> 订单状态变为已取消 + -> 商品库存回补 + -> 已占用优惠券恢复为可用 + +团购订单支付成功 + -> 团购记录从未支付占位变为进行中 + -> 团长生成分享图 + -> 达到人数阈值时发起团和参团记录一起变为成团 + +退款申请 + -> 仅已付款未发货订单可申请 + -> 订单进入退款中 + -> 通知运营处理 +``` + +## Test Case ID + +- `MALL-PAY-AC01-BE-UT-001`: 支付成功回调将待支付订单更新为已支付。 +- `MALL-PAY-AC02-BE-UT-001`: 重复支付回调幂等返回成功，不重复更新订单。 +- `MALL-PAY-AC03-BE-UT-001`: 回调金额和订单金额不一致时拒绝更新。 +- `MALL-PAY-AC04-BE-UT-001`: 微信回调解析失败时不查询、不更新订单。 +- `MALL-PAY-AC04-BE-UT-002`: 回调订单号不存在时失败返回且不触发副作用。 +- `MALL-PAY-AC04-CONTRACT-001`: 微信支付回调 XML 必填字段保持稳定。 +- `MALL-PAY-AC04-CONTRACT-002`: 微信支付回调 XML 可装载为 SDK notify result 模型。 +- `MALL-PAY-AC00-CONTRACT-001`: 契约文件内 test case id 和 HTTP method 保持稳定格式。 +- `MALL-PAY-AC00-CONTRACT-002`: OpenAPI apispec 中的路径、方法、test case id 和必填字段与契约文件一致。 +- `MALL-PAY-AC05-BE-UT-001`: 乐观锁失败时停止通知和超时任务移除。 +- `MALL-PAY-AC05-BE-IT-001`: 订单乐观锁拒绝过期副本覆盖最新状态。 +- `MALL-PAY-AC06-BE-IT-001`: 库存不能扣成负数，取消/补偿可回补库存。 +- `MALL-PAY-AC01-BE-IT-001`: 已支付订单状态、支付流水号、支付时间真实持久化。 +- `MALL-PAY-AC07-FE-IT-001`: 移动端订单 API 发送符合契约的请求。 +- `MALL-PAY-AC08-E2E-001`: 浏览器支付主链路最终只进入一次 paid 状态。 +- `MALL-PAY-AC08-UIAGENT-001`: Page Agent 探索支付主路径并生成候选 Playwright 步骤。 +- `MALL-PAY-AC09-BE-UT-001`: 取消未支付订单恢复库存并释放优惠券。 +- `MALL-PAY-AC09-BE-UT-002`: 已付款订单不能走取消补偿路径。 +- `MALL-PAY-AC09-BE-IT-001`: 优惠券释放状态真实持久化。 +- `MALL-PAY-AC09-FE-IT-001`: 移动端发送取消订单请求。 +- `MALL-PAY-AC09-E2E-001`: 浏览器取消未支付订单后库存和优惠券恢复。 +- `MALL-PAY-AC09-UIAGENT-001`: Page Agent 探索取消未支付订单 UI 流程并记录 trace。 +- `MALL-PAY-AC10-BE-UT-001`: 参团支付达到人数阈值后团购成功。 +- `MALL-PAY-AC10-BE-UT-002`: 团长支付后生成团购分享图。 +- `MALL-PAY-AC10-BE-IT-001`: 团购查询忽略未支付占位和逻辑删除记录。 +- `MALL-PAY-AC11-FE-UT-001`: 前端订单状态和可用动作映射稳定。 +- `MALL-PAY-AC12-BE-UT-001`: 已付款订单申请退款进入退款中并通知运营。 +- `MALL-PAY-AC12-BE-UT-002`: 未付款订单不能申请退款。 +- `MALL-PAY-AC12-FE-IT-001`: 移动端发送退款申请请求。 +- `MALL-PAY-AC12-UIAGENT-001`: Page Agent 探索退款申请 UI 流程并生成候选 smoke 步骤。 +- `MALL-PAY-AC13-FE-IT-001`: 移动端发送确认收货请求。 +- `MALL-PAY-AC14-FE-IT-001`: 移动端发送删除订单请求。 +- `MALL-INFRA-AC01-SCRIPT-001`: 分层运行脚本在 npm lockfile 变化时使用 `npm ci`，未变化时不重复安装。 +- `MALL-INFRA-AC02-SCRIPT-001`: 分层运行脚本提供 coverage 入口并分发到后端 JaCoCo 和前端 Vitest coverage。 +- `MALL-BROWSE-AC01-BE-UT-001`: 首页接口聚合商品运营区块并按登录态选择优惠券来源。 +- `MALL-BROWSE-AC02-BE-UT-001`: 商品列表保留筛选、分页、排序参数并写入登录用户搜索历史。 +- `MALL-BROWSE-AC03-BE-UT-001`: 商品详情返回规格、货品、品牌、评论、收藏和分享信息，并记录用户足迹。 +- `MALL-BROWSE-AC04-BE-UT-001`: 相关推荐按同类目返回，未知商品返回参数值错误。 +- `MALL-BROWSE-AC05-BE-UT-001`: 一级分类进入商品分类页时自动选中第一个二级分类并返回兄弟分类。 +- `MALL-BROWSE-AC05-BE-UT-002`: 二级分类进入商品分类页时保留当前分类并返回父级兄弟分类。 +- `MALL-BROWSE-AC06-BE-UT-001`: 商品总数接口返回在售商品数量。 +- `MALL-BROWSE-AC00-CONTRACT-001`: 商品浏览契约中的前端路径和后端 mapping 保持一致。 +- `MALL-BROWSE-AC01-FE-IT-001`: 移动端请求首页聚合接口。 +- `MALL-BROWSE-AC02-FE-IT-001`: 移动端商品列表筛选和分页参数透传。 +- `MALL-BROWSE-AC03-FE-IT-001`: 移动端按商品 ID 请求详情。 +- `MALL-BROWSE-AC04-FE-IT-001`: 移动端按商品 ID 请求相关推荐。 +- `MALL-BROWSE-AC03-E2E-001`: 浏览器从首页商品进入详情并看到库存、规格和相关推荐。 +- `MALL-BROWSE-AC02-E2E-001`: 浏览器商品列表按新品筛选且排序查询保持稳定。 + +## 目录说明 + +- `test-index.yml`: 测试层级、命令、责任边界和测试文件索引。 +- `contracts/`: 前后端接口契约、OpenAPI apispec、人读接口文档和微信支付回调样例。 +- `backend/`: 独立 Maven 测试工程，依赖 litemall 原模块。 +- `frontend/`: 独立 Vitest 测试工程，通过 alias 引用 `litemall-vue/src`。 +- `ui-agent/`: Page Agent UI 探索场景、证据格式和 Playwright handoff 规则。 +- `e2e/`: Playwright + Express 支付链路训练 harness。 +- `scripts/run-layered-tests.sh`: 团队本地和 CI 都可复用的统一入口。 +- `scripts/run-layered-tests-script-test.sh`: 分层入口脚本的轻量自检。 diff --git a/Tests/ai-native-workflow/litemall-payment/acceptance-criteria-order-cancel-unpaid.md b/Tests/ai-native-workflow/litemall-payment/acceptance-criteria-order-cancel-unpaid.md new file mode 100644 index 000000000..de004a51d --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/acceptance-criteria-order-cancel-unpaid.md @@ -0,0 +1,34 @@ +# Acceptance Criteria：取消未支付订单 + +## Acceptance Criteria + +| ac_id | story_id | type | Given | When | Then | observable_evidence | source | +| --- | --- | --- | --- | --- | --- | --- | --- | +| AC01 | MALL-ORD-CANCEL-001 | happy-path | 当前用户拥有状态为 101（未支付）的订单 | 用户以 `POST /order/cancel` 提交 `orderId` | 接口成功；订单状态变为 102（用户取消）；订单产生结束时间 | API response、订单对象/数据库状态、`end_time` | `WxOrderService.cancel`、`OrderUtil.build` | +| AC02 | MALL-ORD-CANCEL-001 | compensation | 未支付订单已占用商品库存 | 取消成功 | 订单中每个货品按订单数量回补库存；库存不出现负数或重复回补 | 商品货品数据库数量、库存服务调用 | `WxOrderService.cancel`、`LitemallGoodsProductService.addStock` | +| AC03 | MALL-ORD-CANCEL-001 | compensation | 未支付订单占用了状态为 USED 的优惠券 | 取消成功 | 相关优惠券恢复为 USABLE，并更新时间 | `litemall_coupon_user.status`、更新时间 | `WxOrderService.cancel`、`releaseCoupon` | +| AC04 | MALL-ORD-CANCEL-001 | guard | 订单不是当前用户的未支付订单，或订单状态为已支付/已发货/已取消 | 用户提交取消请求 | 返回业务错误；订单、库存和优惠券不发生取消副作用 | `errno/errmsg`、无更新/无库存调用/无优惠券更新 | `OrderUtil.build`、`WxOrderService.cancel` | +| AC05 | MALL-ORD-CANCEL-001 | contract | 客户端调用订单取消能力 | 客户端发送取消请求 | 请求使用 `POST /order/cancel`，body 必须包含 `orderId` | Controller mapping、contract fixture、前端 request spy | `WxOrderController.cancel`、`order-api.contract.json` | +| AC06 | MALL-ORD-CANCEL-001 | consistency | 取消过程中库存回补或优惠券释放失败 | 服务执行取消流程 | 订单状态、库存和优惠券不应留下部分成功状态；失败应可观察并回滚或进入明确补偿 | 事务回滚/错误响应/数据库一致性 | `@Transactional`、`WxOrderService.cancel` | + +## Business Rule Table + +| rule_id | condition | expected_result | risk_tag | evidence | +| --- | --- | --- | --- | --- | +| R01 | `order_status = 101` 且用户归属匹配 | 允许取消 | order-status-transition | `OrderUtil.build` | +| R02 | `order_status ∈ {201, 301, 102, 103}` | 拒绝取消，不产生资源副作用 | refund-guard / idempotency | `OrderUtil.build` | +| R03 | 取消成功 | `order_status = 102` 且设置 `end_time` | order-status-transition | `WxOrderService.cancel` | +| R04 | 订单包含货品 | 每个货品按数量回补 | stock-compensation | `addStock` | +| R05 | 订单关联已使用优惠券 | 优惠券变为可用 | coupon-release | `releaseCoupon` | +| R06 | 取消流程中出现运行时失败 | 事务一致性可验证 | transaction-consistency | `@Transactional` | + +## Open Decisions + +- AC01–AC05 依据当前业务规则和已有测试资产进入本轮验证。 +- AC06 当前只有源码上的 `@Transactional` 依据，没有完整取消流程的真实事务失败测试，列为本轮 residual risk。 +- 当前实现对重复取消返回“订单不能取消”；是否要求幂等成功需要产品确认。 + +## Downstream Handoff + +- `next_skill`: `test-case-design` +- `generation_focus`: 按 Feature 查找 AC09 相关已有用例，合并取消、库存、优惠券、接口契约和浏览器用例 diff --git a/Tests/ai-native-workflow/litemall-payment/acceptance-criteria-order-timeout-atomic-close.md b/Tests/ai-native-workflow/litemall-payment/acceptance-criteria-order-timeout-atomic-close.md new file mode 100644 index 000000000..957b3525f --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/acceptance-criteria-order-timeout-atomic-close.md @@ -0,0 +1,36 @@ +# Acceptance Criteria：未支付订单超时关闭资源一致性 + +## Acceptance Criteria + +| ac_id | story_id | type | Given | When | Then | observable_evidence | source | +| --- | --- | --- | --- | --- | --- | --- | --- | +| `MALL-ORD-TIMEOUT-AC01` | `MALL-ORD-TIMEOUT-001` | happy-path | 订单状态为 `101`，包含商品库存和已使用优惠券，且已达到超时时间 | 执行一次超时关闭任务 | 订单变为 `103`，全部库存回补一次，优惠券变为可用，任务成功结束 | 订单行、商品库存行、优惠券行、任务结果日志 | requirement R01–R04; `OrderUnpaidTask` | +| `MALL-ORD-TIMEOUT-AC02` | `MALL-ORD-TIMEOUT-001` | state-guard | 订单状态不是 `101`，包括已支付、用户取消或已自动取消 | 执行超时关闭任务 | 不更新订单、不回补库存、不释放优惠券，任务安全跳过 | 订单状态和资源副作用未变化 | requirement R01/R05 | +| `MALL-ORD-TIMEOUT-AC03` | `MALL-ORD-TIMEOUT-001` | failure | 订单状态为 `101`，库存回补在任一商品上失败 | 执行超时关闭任务 | 不得报告完整成功；订单与资源保持可恢复的一致状态，失败原因可定位 | 订单、库存、优惠券状态；异常结果；日志 | requirement R02/R06 | +| `MALL-ORD-TIMEOUT-AC04` | `MALL-ORD-TIMEOUT-001` | failure | 库存回补成功后，优惠券释放失败 | 执行超时关闭任务 | 不得静默成功；系统按确定策略回滚或登记可重试补偿，不能留下无主资源状态 | 订单、库存、优惠券状态；补偿记录或重试证据 | requirement R02/R06 | +| `MALL-ORD-TIMEOUT-AC05` | `MALL-ORD-TIMEOUT-001` | partial-failure | 订单包含多个商品，前一个商品回补成功，后一个商品回补失败 | 执行失败后再重试 | 最终每个商品库存只恢复一次，订单最终状态与全部资源一致 | 多商品库存行、订单行、重试结果 | requirement R03/R05 | +| `MALL-ORD-TIMEOUT-AC06` | `MALL-ORD-TIMEOUT-001` | concurrency | 同一订单被两个超时任务同时触发 | 并发执行任务 | 最多一个任务完成补偿；不重复更新订单、库存或优惠券 | 并发任务结果、数据库状态、资源变更次数 | requirement R03/R05 | +| `MALL-ORD-TIMEOUT-AC07` | `MALL-ORD-TIMEOUT-001` | observability | 超时任务成功、跳过或失败 | 任务处理结束 | 日志包含订单号、结果、失败原因和重试上下文，不包含敏感信息 | 结构化/可检索日志 | requirement R07 | + +## Business Rule Table + +| rule_id | condition | expected_result | risk_tag | evidence | +| --- | --- | --- | --- | --- | +| R01 | only order status `101` | eligible for timeout close | status-transition | order row | +| R02 | any resource compensation fails | atomic rollback or explicit recoverable compensation; never silent success | transaction-consistency | DB + failure result | +| R03 | same order resource is released | at most once | duplicate-compensation | DB delta | +| R04 | normal timeout close | status `103`, stock restored, coupon usable | timeout-compensation | DB rows | +| R05 | task repeats or races | safe skip/retry, no duplicate side effects | concurrency | task and DB evidence | +| R06 | task fails | error is visible and retry/owner is defined | observability | log/alert evidence | + +## Open Decisions + +1. AC03/AC04 的一致性策略必须在实现前确认：数据库事务回滚，或补偿记录 + 可重试状态机。 +2. AC06 是否作为本期 P0，还是先作为 P1/Release Gate。 +3. 日志格式、重试次数、退避时间和人工接管条件需要技术/运营确认。 + +## Downstream Handoff + +- `next_skill`: `test-case-design` +- `generation_focus`: 超时状态门禁、原子性/可恢复补偿、重复执行、并发、日志证据 +- `blocked_decisions`: AC03/AC04 的一致性策略、AC06 优先级、重试策略 diff --git a/Tests/ai-native-workflow/litemall-payment/quality-review-order-cancel-unpaid.md b/Tests/ai-native-workflow/litemall-payment/quality-review-order-cancel-unpaid.md new file mode 100644 index 000000000..100893e35 --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/quality-review-order-cancel-unpaid.md @@ -0,0 +1,47 @@ +# Quality Review：取消未支付订单 + +## Test Case Quality Review + +- `design_id`: `MALL-ORD-CANCEL-001-DESIGN` +- `overall_score`: 88 +- `decision`: `pass-with-residual-risk` +- `traceability`: pass +- `oracle_quality`: pass for AC01–AC05; AC06 blocked explicitly +- `existing_case_consolidation`: pass +- `layer_fit`: pass +- `benchmark_risk`: watch + +## Findings + +| severity | case/AC | issue | recommendation | +| --- | --- | --- | --- | +| medium | AC06 | no real failure-injection test proves rollback across order, stock, and coupon | keep out of current gate; add Backend IT when failure injection and product policy are confirmed | +| low | AC04 | current tests cover paid-order guard but not malformed body or wrong-user ownership | add focused Backend UT/API cases in a follow-up | +| low | AC05 | contract checks mapping and request shape, not complete response schema | retain as boundary evidence; do not claim complete schema coverage | +| low | AC01–AC03 | E2E uses local harness | retain as browser wiring evidence, not deployed-system evidence | + +## Existing Case Decisions + +| existing_case_id | decision | reason | +| --- | --- | --- | +| `MALL-PAY-AC09-BE-UT-001` | reuse | directly proves status, stock callback, and coupon release behavior | +| `MALL-PAY-AC09-BE-UT-002` | reuse | proves paid order cannot enter cancellation path | +| `MALL-PAY-AC09-BE-IT-001` | extend evidence | proves persistence primitives, not complete cancel orchestration | +| `MALL-PAY-AC00-CONTRACT-001` | extend evidence | proves POST mapping and contract ID alignment | +| `MALL-PAY-AC09-FE-IT-001` | reuse | exact frontend request payload is asserted | +| `MALL-PAY-AC09-E2E-001` | reuse | critical local browser path already exists | + +## Strategy Handoff + +- `next_skill`: `test-strategy` +- `selected_case_ids`: + - `MALL-PAY-AC09-BE-UT-001` + - `MALL-PAY-AC09-BE-UT-002` + - `MALL-PAY-AC09-BE-IT-001` + - `MALL-PAY-AC00-CONTRACT-001` + - `MALL-PAY-AC09-FE-IT-001` + - `MALL-PAY-AC09-E2E-001` +- `selected_evidence_layers`: `backend-ut`, `contract`, `frontend-it`, `backend-it`, `e2e` +- `must_keep_tests`: AC01–AC05 P0/P1 cases +- `deferred_cases`: `TEST-ORD-CANCEL-AC06-001` +- `residual_risk`: transaction rollback under injected inventory/coupon failure; malformed body and wrong-user guard coverage diff --git a/Tests/ai-native-workflow/litemall-payment/quality-review-order-timeout-atomic-close.md b/Tests/ai-native-workflow/litemall-payment/quality-review-order-timeout-atomic-close.md new file mode 100644 index 000000000..edd0ac09d --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/quality-review-order-timeout-atomic-close.md @@ -0,0 +1,45 @@ +# Quality Review：未支付订单超时关闭资源一致性 + +## Review Decision + +- `review_mode`: `case-design-and-implementation` +- `overall_score`: 91 +- `decision`: `approved-with-residual-risk` +- `blocking_findings`: none + +## Findings and Evidence + +| severity | area | finding | evidence | decision | +| --- | --- | --- | --- | --- | +| high | transaction consistency | timeout flow previously had no task-level transaction | `OrderTimeoutCompensationService.closeOrder()` is Spring-managed and transactional | fixed | +| high | rollback | resource failure could leave a closed order | Backend IT uses missing product failure and asserts order remains `101`, stock unchanged, coupon still used | fixed and proven | +| medium | duplicate compensation | repeated task could add stock twice | Backend IT runs close twice and asserts stock remains `7` | fixed and proven | +| medium | status guard | terminal orders must not compensate again | unit skip case plus repeated IT execution | fixed and proven | +| medium | observability | failure/skip/success needs order context | task logs order id, result and failure cause | implemented; structured assertion deferred | +| medium | concurrency | real multi-thread race is not separately exercised | optimistic-lock loss unit case proves safe loser behavior | partial; P1 follow-up | + +## Case Review + +| case_id | result | evidence | +| --- | --- | --- | +| `TEST-TIMEOUT-AC01-001` | passed | unit orchestration + MySQL commit | +| `TEST-TIMEOUT-AC02-001` | passed | terminal-state skip + repeated execution | +| `TEST-TIMEOUT-AC03-001` | passed | stock failure propagation + transaction rollback | +| `TEST-TIMEOUT-AC04-001` | passed | coupon update failure propagation unit | +| `TEST-TIMEOUT-AC05-001` | passed | repeated execution has no duplicate delta | +| `TEST-TIMEOUT-AC06-001` | partial | optimistic-lock loss covered; real concurrent IT deferred | +| `TEST-TIMEOUT-AC07-001` | partial | code/log review covered; structured log schema deferred | + +## Residual Risk + +1. Add a concurrent Testcontainers case for two real task invocations. +2. Define a structured task-result log schema and assert captured fields. +3. Add a multi-item fail-once adapter if the project later adopts compensating + retries beyond database rollback. + +## Handoff + +- `next_skill`: `test-strategy` +- `selected_layers`: `backend-ut`, `backend-it`, plus full regression `all` +- `release_boundary`: approve the implemented rollback/idempotency scope; do not + claim real concurrent execution or structured log collection as proven. diff --git a/Tests/ai-native-workflow/litemall-payment/requirement-order-cancel-unpaid.md b/Tests/ai-native-workflow/litemall-payment/requirement-order-cancel-unpaid.md new file mode 100644 index 000000000..db8e59082 --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/requirement-order-cancel-unpaid.md @@ -0,0 +1,73 @@ +# 需求：取消未支付订单并释放占用资源 + +## Story Card + +- `story_id`: `MALL-ORD-CANCEL-001` +- `title`: 取消未支付订单并释放库存与优惠券 +- `chain`: `order-lifecycle`, `stock-compensation`, `coupon-release` +- `actor`: 已登录商城用户 +- `user_story`: 作为商城用户，我希望能够取消尚未支付的订单，以便及时释放被订单占用的库存和优惠券，避免资源长期被锁定。 +- `business_value`: 降低未支付订单对库存和优惠券可用性的影响，保持订单状态与占用资源的一致性。 + +## In Scope + +1. 用户对未支付订单发起取消操作。 +2. 订单进入已取消状态。 +3. 订单已扣减或占用的商品库存得到回补。 +4. 订单已占用的优惠券恢复为可用状态。 +5. 取消结果能够被订单详情或订单列表观察到。 + +## Out of Scope + +- 已支付订单的退款流程。 +- 已发货订单的售后处理。 +- 支付回调本身的金额校验和幂等处理。 +- 新增库存预占模型或优惠券生命周期模型。 +- 浏览器端完整 UI 重构。 + +## Source Evidence + +- `Tests/ai-native-workflow/litemall-payment/workflow-pack.md`：AC09，取消未支付订单后回补库存并释放优惠券。 +- `Tests/test-index.yml`：`backend-ut`、`backend-it`、`frontend-it`、`e2e` 层的订单取消覆盖边界。 +- `WxOrderService.cancel`：订单取消业务入口。 +- `releaseCoupon`：优惠券释放逻辑。 +- `LitemallGoodsProductService.addStock`：库存回补逻辑。 +- `WxOrderLifecycleUnitTest`、`PaymentPersistenceIT`：现有生命周期与持久化测试资产。 + +## Impacted Objects + +- 订单状态与订单取消接口。 +- 商品货品库存。 +- 用户优惠券占用状态。 +- 移动端订单操作请求。 +- 订单详情/列表中的状态与可用动作展示。 + +## Risk Tags + +- `order-status-transition` +- `stock-compensation` +- `coupon-release` +- `transaction-consistency` +- `idempotency` +- `frontend-api-contract` + +## Assumptions + +- 本需求只讨论未支付订单。 +- 库存和优惠券是订单取消时需要处理的已占用资源。 +- 业务预期必须以产品/业务确认后的 Acceptance Criteria 为准，当前实现不能单独作为 Oracle。 + +## Open Questions + +1. 取消操作允许的订单状态是否只有“待支付”？超时关闭订单是否复用同一规则？ +2. 重复取消同一订单时，接口应返回成功、幂等成功，还是业务错误？ +3. 订单取消时，订单状态、库存回补、优惠券释放是否必须保持原子性？ +4. 优惠券已过期、已被其他流程使用或释放失败时，订单取消应如何处理？ +5. 用户端取消和后台超时补偿是否必须共享同一个接口与业务服务？ +6. 取消成功后，订单详情和列表是否需要立即刷新可用动作与资源状态？ + +## Downstream Handoff + +- `next_skill`: `acceptance-criteria` +- `required_focus`: 未支付状态边界、订单状态转移、库存回补、优惠券释放、重复取消、事务一致性、移动端请求契约 +- `blocked_until`: Open Questions 1–4 至少完成业务确认后再固化 P0/P1 Acceptance Criteria diff --git a/Tests/ai-native-workflow/litemall-payment/requirement-order-timeout-atomic-close.md b/Tests/ai-native-workflow/litemall-payment/requirement-order-timeout-atomic-close.md new file mode 100644 index 000000000..5d199b525 --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/requirement-order-timeout-atomic-close.md @@ -0,0 +1,110 @@ +# 需求：未支付订单超时关闭必须保持资源一致性 + +## Requirement Status + +- `status`: implemented-and-tested +- `implementation_change`: transaction-boundary service, task delegation, failure logging, and integration fixtures +- `story_id`: `MALL-ORD-TIMEOUT-001` +- `chain`: `order-lifecycle`, `timeout-compensation`, `stock-compensation`, `coupon-release` + +## Objective + +当未支付订单达到超时时间后，系统应自动关闭订单，并可靠释放订单占用的 +库存和优惠券。订单状态、库存和优惠券必须保持一致：不能出现订单已经关闭 +但库存未回补，也不能出现资源已经释放但订单仍显示为待支付。 + +如果超时任务因数据库、库存或优惠券服务暂时失败，系统必须能够安全重试， +不会重复回补库存或重复释放优惠券。 + +## User Story + +作为商城运营方，我希望未支付订单超时后能够自动、完整地释放占用资源， +以便库存和优惠券不会因为异常任务而长期不可用，也不会因为重试产生重复补偿。 + +## Current Implementation Gap + +当前 `OrderUnpaidTask.run()` 的处理顺序是： + +1. 将订单状态更新为系统自动取消 `103`； +2. 逐条回补商品库存； +3. 释放优惠券。 + +当前任务已委托给 Spring 管理的 `OrderTimeoutCompensationService`，由服务方法 +统一声明事务边界。订单状态、库存回补和优惠券释放在同一事务内执行，任一步 +失败都会抛出异常并回滚；订单状态门禁与乐观锁保证重复任务安全跳过。 + +Source evidence: + +- `litemall/litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/task/OrderUnpaidTask.java` +- `OrderUnpaidTask.run()` 先调用 `updateWithOptimisticLocker`，再调用 `addStock`，最后调用 `releaseCoupon`。 +- 当前已有测试覆盖正常超时路径的业务规则，但没有完整的故障注入、原子性和安全重试验收。 + +## In Scope + +1. 未支付订单达到超时时间后进入系统自动取消状态 `103`。 +2. 订单中的全部商品库存只回补一次。 +3. 已占用优惠券只释放一次，并恢复为可用状态。 +4. 订单状态、库存、优惠券的最终结果必须一致。 +5. 库存回补或优惠券释放失败时，定义事务回滚或补偿重试策略。 +6. 超时任务重复触发时不得产生重复库存或优惠券副作用。 +7. 任务失败、重试、跳过和最终成功必须有可审计日志。 + +## Out of Scope + +- 用户主动取消未支付订单的交互流程。 +- 已支付订单的退款。 +- 新增通用消息队列平台。 +- 修改库存预占模型或优惠券数据模型。 +- 运营后台的完整任务监控页面。 + +## Proposed Business Rules + +- R01：只有状态为待支付 `101` 的订单可以被超时任务关闭。 +- R02：订单关闭与资源释放必须遵循确定的原子性或可恢复补偿策略。 +- R03：一个订单的每个商品库存最多被超时补偿一次。 +- R04：一个订单的优惠券最多被超时释放一次。 +- R05：任务重复执行必须安全，不得把已关闭订单再次当作待支付订单处理。 +- R06：资源释放失败不能静默吞掉；任务必须失败、重试或进入明确的人工处理状态。 +- R07：任务日志必须包含订单号、任务结果、失败原因和重试上下文，但不得输出敏感信息。 + +## Acceptance-Oriented Success Criteria + +- 正常路径：待支付订单超时后变为 `103`，库存和优惠券均恢复。 +- 库存失败：系统不会留下无法解释的“订单已关闭但库存未恢复”状态，且存在可验证的恢复路径。 +- 优惠券失败：系统不会静默返回成功，且存在可验证的回滚或重试路径。 +- 部分库存补偿失败：重试后最终库存数量正确，不重复计算已经完成的补偿。 +- 重复任务：第二次执行不重复改变订单、库存或优惠券。 +- 并发任务：同一订单同时触发多个超时任务时，最多一个任务完成资源补偿。 +- 审计日志：成功和失败任务都能关联到订单号和处理结果。 + +## Testing Implications + +预计需要覆盖： + +- Backend UT：状态门禁、补偿顺序、重复执行和失败分支。 +- Backend IT：订单、库存、优惠券真实持久化一致性。 +- Failure Injection：库存失败、优惠券失败、部分商品失败后的回滚/重试。 +- Concurrency：同一订单多个超时任务的竞争行为。 +- Observability：失败日志包含必要上下文且不泄漏敏感信息。 +- E2E：只有当超时关闭结果需要从用户界面观察时才增加，不用 E2E 代替事务证据。 + +## Assumptions + +- 本次实现不新增数据库表、消息队列或补偿状态机。 +- 订单状态 `101` 表示待支付，`103` 表示系统自动取消。 +- 产品和技术方案需要共同决定采用数据库事务、补偿记录、幂等标记或其他可恢复机制。 + +## Remaining Verification Boundaries + +- 并发任务的真实多线程竞争尚未单独建立测试；当前有乐观锁失败单测和重复 + 执行 IT 证据。 +- 日志已包含订单号、成功/跳过/失败和失败原因，但尚未建立结构化日志 schema + 或日志采集断言。 + +## Downstream Handoff + +- `next_skill`: `acceptance-criteria` +- `required_focus`: 事务边界、补偿幂等、故障注入、并发任务、持久化一致性、审计日志 +- `implementation_status`: not implemented +- `do_not_claim`: 不得从现有正常路径测试通过推断故障恢复和事务一致性已实现 +- `expected_gap`: 当前超时任务缺少完整的故障恢复和重复补偿证明 diff --git a/Tests/ai-native-workflow/litemall-payment/test-case-design-order-cancel-unpaid.md b/Tests/ai-native-workflow/litemall-payment/test-case-design-order-cancel-unpaid.md new file mode 100644 index 000000000..1826e2795 --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/test-case-design-order-cancel-unpaid.md @@ -0,0 +1,93 @@ +# Test Case Design：取消未支付订单 + +## Test Basis + +| obligation_id | source | oracle | status | clarification_owner | +| --- | --- | --- | --- | --- | +| O01 | AC01 / `WxOrderService.cancel` | response success, status 102, `end_time != null` | READY | - | +| O02 | AC02 / `addStock` | every order-good quantity is restored | READY | - | +| O03 | AC03 / `releaseCoupon` | USED coupon becomes USABLE | READY | - | +| O04 | AC04 / `OrderUtil.build` | forbidden order cannot change or release resources | READY | - | +| O05 | AC05 / Controller + contract | POST path and `orderId` payload match | READY | - | +| O06 | AC06 / `@Transactional` | no partial persistence after injected failure | BLOCKED | product/test owner | + +## Test Analysis + +- changed_surfaces: order lifecycle service, order controller, inventory service, coupon release, mobile order API, payment-flow harness +- affected_contracts: `POST /order/cancel`, request body `{ orderId }` +- quality_concerns: transaction consistency, idempotency, data isolation +- risks: status transition, stock compensation, coupon release, ownership guard, duplicate cancel +- coverage_obligations: O01–O06 + +## Feature Case Discovery and Consolidation + +Feature fingerprint: `AC09`, `WxOrderService.cancel`, `OrderUtil.STATUS_CREATE`, +`STATUS_CANCEL`, `releaseCoupon`, `addStock`, `/order/cancel`, `orderId`, +`MALL-PAY-AC09-*`. + +| obligation_id | existing_case_id | origin | decision | evidence_gap | consolidated_case_id | +| --- | --- | --- | --- | --- | --- | +| O01/O02/O03 | `MALL-PAY-AC09-BE-UT-001` | existing | reuse | none for service-level happy path | `MALL-PAY-AC09-BE-UT-001` | +| O04 | `MALL-PAY-AC09-BE-UT-002` | existing | reuse | does not cover wrong-user or malformed body | `MALL-PAY-AC09-BE-UT-002` | +| O02 | `MALL-PAY-AC09-BE-IT-001` | existing | extend | verifies stock and coupon persistence separately, not one cancel transaction | `MALL-PAY-AC09-BE-IT-001` | +| O05 | `MALL-PAY-AC09-FE-IT-001` | existing | reuse | request spy proves client payload, not deployed endpoint | `MALL-PAY-AC09-FE-IT-001` | +| O05 | `MALL-PAY-AC00-CONTRACT-001` | existing | extend | verifies mapping and method; response schema remains partial | `MALL-PAY-AC00-CONTRACT-001` | +| O01/O02/O03 | `MALL-PAY-AC09-E2E-001` | existing | reuse | Express harness, not deployed backend | `MALL-PAY-AC09-E2E-001` | +| O06 | - | new | needs-clarification | no failure-injection transaction case | `TEST-ORD-CANCEL-AC06-001` | + +## Coverage and Technique Decisions + +| obligation_id | evidence_layer | technique | required_artifact | rationale | +| --- | --- | --- | --- | --- | +| O01/O02/O03 | backend-ut | direct example | input order + response + status/stock/coupon observations | one concrete service behavior already has a focused test | +| O04 | backend-ut | decision table | status/ownership/operation matrix | cancellation depends on order state and ownership | +| O05 | contract + frontend-it | direct example | endpoint mapping and captured request | consumer/provider boundary is distinct from service behavior | +| O06 | backend-it | cause-effect / direct failure example | injected failure + persisted rollback observations | requires real transaction/persistence evidence; currently not implemented | +| O01/O02/O03 | e2e | use case | browser action and visible status/stock/coupon observations | critical user journey, bounded to local harness | + +## Case Specifications + +| case_id | primary_ac | purpose | preconditions | test_data | steps | expected_result | oracle | priority | layer_rationale | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | +| MALL-PAY-AC09-BE-UT-001 | AC01/02/03 | prove successful cancellation releases resources | user 1 owns order 1001 in status 101 | product 1 × 2; coupon 501 USED | call `cancel(1,{orderId:1001})` | success, status 102, stock add 2, coupon USABLE | response/order/coupon/service observations | P0 | lowest layer for business rules | +| MALL-PAY-AC09-BE-UT-002 | AC04 | prove paid order cannot use cancel path | order status 201 | order 1001 | call cancel | errno 725; no update, stock, or coupon side effect | response and Mockito interaction boundary | P0 | pure guard rule | +| MALL-PAY-AC09-BE-IT-001 | AC02/03 | prove persistence primitives retain compensation state | MySQL Testcontainer fixture | product and coupon rows | update compensation records and reload | persisted stock/coupon state matches expected | MySQL rows | P1 | real persistence boundary | +| MALL-PAY-AC00-CONTRACT-001 | AC05 | prove endpoint method remains POST | source and contract fixture available | `/order/cancel`, `orderId` | validate mapping and contract | method/path/payload match | contract assertions | P1 | consumer/provider boundary | +| MALL-PAY-AC09-FE-IT-001 | AC05 | prove client sends cancel request correctly | request spy installed | `{ orderId: 1001 }` | call client method | POST `/order/cancel` with body | captured request | P1 | frontend integration boundary | +| MALL-PAY-AC09-E2E-001 | AC01/02/03 | prove critical user journey | local Express harness | unpaid order and occupied resources | submit, inspect, cancel, inspect | visible cancelled status, stock restored, coupon usable | Playwright DOM evidence | P1 | browser journey | +| TEST-ORD-CANCEL-AC06-001 | AC06 | prove rollback on compensation failure | failure injection available | stock or coupon update failure | cancel and reload all rows | no partial state | database transaction evidence | P1 | currently deferred | + +## Existing Case Decisions + +| existing_case_id | obligation_id | decision | evidence_gap_or_reason | +| --- | --- | --- | --- | +| `MALL-PAY-AC09-BE-UT-001` | O01/O02/O03 | reuse | directly proves service happy path | +| `MALL-PAY-AC09-BE-UT-002` | O04 | reuse | directly proves paid-order guard | +| `MALL-PAY-AC09-BE-IT-001` | O02/O03 | extend | persistence primitives are separated from cancel orchestration | +| `MALL-PAY-AC00-CONTRACT-001` | O05 | extend | response schema and malformed payload are not complete | +| `MALL-PAY-AC09-FE-IT-001` | O05 | reuse | exact client request is asserted | +| `MALL-PAY-AC09-E2E-001` | O01/O02/O03 | reuse | bounded harness journey already exists | + +## Consolidated Case Set + +| case_id | origin | source_existing_case | primary_ac | evidence_layer | technique | status | +| --- | --- | --- | --- | --- | --- | --- | +| `MALL-PAY-AC09-BE-UT-001` | existing | same | AC01/02/03 | backend-ut | direct example | READY | +| `MALL-PAY-AC09-BE-UT-002` | existing | same | AC04 | backend-ut | decision table row | READY | +| `MALL-PAY-AC09-BE-IT-001` | extended | same | AC02/03 | backend-it | direct example | READY | +| `MALL-PAY-AC00-CONTRACT-001` | extended | same | AC05 | contract | direct example | READY | +| `MALL-PAY-AC09-FE-IT-001` | existing | same | AC05 | frontend-it | direct example | READY | +| `MALL-PAY-AC09-E2E-001` | existing | same | AC01/02/03 | e2e | use case | READY | +| `TEST-ORD-CANCEL-AC06-001` | new | - | AC06 | backend-it | cause-effect/failure example | BLOCKED | + +## Coverage Gaps and Blockers + +| obligation_id | status | reason | owner | next_action | +| --- | --- | --- | --- | --- | +| O06 | BLOCKED | no failure-injection test proves full cancellation rollback | test owner | add transaction-failure IT after product decision | +| O04 | PARTIAL | wrong-user, malformed body, and repeat-cancel cases are not in current selected suite | test owner | add focused guard cases if API hardening is in scope | + +## Handoff + +- `next_skill`: `test-case-quality-review` +- `planner_input`: six READY existing/extended cases; one blocked transaction case; two residual guard gaps diff --git a/Tests/ai-native-workflow/litemall-payment/test-case-design-order-timeout-atomic-close.md b/Tests/ai-native-workflow/litemall-payment/test-case-design-order-timeout-atomic-close.md new file mode 100644 index 000000000..8a1e403f3 --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/test-case-design-order-timeout-atomic-close.md @@ -0,0 +1,55 @@ +# Test Case Design：未支付订单超时关闭资源一致性 + +## Test Basis + +| obligation_id | source | oracle | status | +| --- | --- | --- | --- | +| `OBL-01` | AC01/R01–R04 | order `103`, stock restored, coupon usable | passed | +| `OBL-02` | AC02/R01/R05 | ineligible order has no side effect | passed | +| `OBL-03` | AC03/R02/R06 | stock failure is visible and transaction is recoverable | passed | +| `OBL-04` | AC04/R02/R06 | coupon failure is visible and transaction boundary is preserved | passed in UT; rollback boundary shared | +| `OBL-05` | AC05/R03/R05 | repeat execution does not duplicate resource delta | passed | +| `OBL-06` | AC06/R03/R05 | concurrent tasks have one compensation winner | partial | +| `OBL-07` | AC07/R07 | success/skip/failure has safe order context | partial | + +## Layer-Neutral Case Specifications + +| case_id | primary_ac | purpose | expected_result | oracle | status | +| --- | --- | --- | --- | --- | --- | +| `TEST-TIMEOUT-AC01-001` | AC01 | normal timeout close | `101 → 103`; stock and coupon restored | MySQL order/stock/coupon rows | passed | +| `TEST-TIMEOUT-AC02-001` | AC02 | terminal-state guard | no update or resource mutation | Mockito interactions + repeated IT | passed | +| `TEST-TIMEOUT-AC03-001` | AC03 | stock failure consistency | exception; order, stock, coupon roll back | unit failure + MySQL rollback | passed | +| `TEST-TIMEOUT-AC04-001` | AC04 | coupon failure consistency | exception is not swallowed | unit failure propagation | passed | +| `TEST-TIMEOUT-AC05-001` | AC05 | duplicate execution | second run does not add stock twice | persisted resource delta | passed | +| `TEST-TIMEOUT-AC06-001` | AC06 | concurrency guard | optimistic-lock loser performs no compensation | update result `0` + no interactions | partial; no real concurrent IT | +| `TEST-TIMEOUT-AC07-001` | AC07 | audit context | order id and result/cause appear in task logs | code review | partial; no structured log capture | +| `TEST-TIMEOUT-AC08-001` | AC01 | task adapter routing | scheduler task invokes compensation service with the order id | Mockito delegation verification | passed | + +## Existing Case Discovery and Consolidation + +| existing_case_id | decision | reason | consolidated_case_id | +| --- | --- | --- | --- | +| `MALL-PAY-AC06-BE-IT-001` | extend | stock primitive is reused but timeout orchestration is new | `TEST-TIMEOUT-AC01-001` | +| `MALL-PAY-AC09-BE-IT-001` | extend | coupon persistence is reused but timeout orchestration is new | `TEST-TIMEOUT-AC01-001` | +| `MALL-PAY-AC09-BE-UT-002` | reuse pattern | terminal-state no-side-effect oracle is reusable | `TEST-TIMEOUT-AC02-001` | + +## Technique Decisions + +- State transition matrix for eligible and terminal order states. +- Fault matrix for stock and coupon failure boundaries. +- Duplicate-execution analysis for retry/idempotency. +- Optimistic-lock analysis for concurrent task losers. +- Code/log review for audit context; structured log schema remains P1. + +## Coverage Boundary + +The implemented rollback and repeated-execution behavior is executable and +proven. Real multi-thread concurrency and structured log collection are +explicitly retained as residual risks rather than being inferred from green +unit or E2E tests. + +## Handoff + +- `next_skill`: `test-case-quality-review` +- `selected_layers`: `backend-ut`, `backend-it` +- `regression_layers`: `scripts`, `contract`, `frontend-ut`, `frontend-it`, `e2e` diff --git a/Tests/ai-native-workflow/litemall-payment/test-execution-report-order-cancel-unpaid.md b/Tests/ai-native-workflow/litemall-payment/test-execution-report-order-cancel-unpaid.md new file mode 100644 index 000000000..8d4c3a236 --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/test-execution-report-order-cancel-unpaid.md @@ -0,0 +1,49 @@ +# Test Execution Report: Cancel Unpaid Order + +- Feature: `MALL-ORD-CANCEL-001` +- Strategy: `test-strategy-order-cancel-unpaid.md` +- Profile: `targeted-medium` +- Execution date: 2026-08-10 +- Overall status: **pass with environment-blocked backend IT and deferred AC06** + +## Executed lanes + +| Layer | Command | Result | Evidence | +| --- | --- | --- | --- | +| Fast gate | `./Tests/scripts/run-layered-tests.sh fast` | PASS | Backend UT, frontend UT, frontend IT, contract and performance-gate checks completed; coverage reports generated | +| Backend UT | `./Tests/scripts/run-layered-tests.sh backend-ut` | PASS | Cancel success and paid-order guard cases passed; expected negative pay-notify exception is handled by the test | +| Contract | `./Tests/scripts/run-layered-tests.sh contract` | PASS | `/order/cancel` method and `{orderId}` request contract passed | +| Frontend IT | `./Tests/scripts/run-layered-tests.sh frontend-it` | PASS | 2 files, 15 tests passed | +| Backend IT | `./Tests/scripts/run-layered-tests.sh backend-it` | BLOCKED | Testcontainers could not find Docker; Colima is not running | +| E2E | `./Tests/scripts/run-layered-tests.sh e2e` | PASS | 4 tests passed, including `MALL-PAY-AC09-E2E-001` | + +## Acceptance evidence + +- AC01: covered by backend UT, contract, frontend IT, and E2E. +- AC02: covered by backend UT and E2E; the E2E flow verifies stock recovery through the local harness. +- AC03: covered by backend UT and E2E; coupon recovery is asserted in the selected cancel flow. +- AC04: paid-order guard covered by backend UT. Wrong-owner and malformed-body variants remain residual gaps. +- AC05: contract and frontend IT passed for `POST /order/cancel` with `orderId`. +- AC06: not proven. The selected suite has no failure-injection case for stock/coupon failure and transaction rollback. + +## Environment block and rerun + +Backend IT is an execution-environment block, not a product failure. The runner +reported that `unix:///Users/summer/.colima/default/docker.sock` is not +listening and no valid Docker environment was available. + +After Docker/Colima is available, rerun: + +```bash +cd /Users/summer/Work/Code/AI/training/litemall +./Tests/scripts/run-layered-tests.sh backend-it +``` + +The deferred AC06 case should be implemented with controlled failure injection +before claiming full transaction rollback coverage. + +## Coverage boundary + +The generated JaCoCo and frontend coverage reports are useful implementation +signals, but they do not replace behavior evidence for AC06 or the missing +wrong-owner/malformed-request variants. diff --git a/Tests/ai-native-workflow/litemall-payment/test-execution-report-order-timeout-atomic-close.html b/Tests/ai-native-workflow/litemall-payment/test-execution-report-order-timeout-atomic-close.html new file mode 100644 index 000000000..4f3d27a5a --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/test-execution-report-order-timeout-atomic-close.html @@ -0,0 +1,125 @@ + + + + + + Order Timeout · Final Test Report + + + +
+
+
NEEDS_VERIFY最终结果：需要确认
+

未支付订单超时关闭资源一致性

+

订单状态、库存回补、优惠券释放必须在同一个可恢复的补偿边界内完成。

+
Feature: MALL-ORD-TIMEOUT-001Strategy: MALL-ORD-TIMEOUT-001-DESIGNEvidence package: 2026-08-18Latest rerun: 2026-08-22
+
为什么不是 PASS？ 已有证据包中的 UT、IT、Contract、Frontend、E2E 均为通过；但最新完整重跑在 Testcontainers 启动处阻塞，且 AC06 真实并发、AC07 结构化日志仍未完成。因此当前结论是需要确认，而不是把历史 PASS 直接升级为本次重跑 PASS。
+
+ +
+
+ 01 · LAYER RESULTS分层测试执行结果6 个层级 · 新增 10 个 · 既有回归通过 · 当前重跑 NEEDS_VERIFY +
+ + + + + + + + + + +
Layer执行命令新增既有回归最后成功证据本次重跑覆盖判断
Backend UTrun-layered-tests.sh backend-ut7既有回归通过PASS需复核AC01–AC04、AC06 部分、AC08
Backend ITrun-layered-tests.sh backend-it35 个通过8/8 PASSTestcontainers 阻塞AC01–AC03、AC05；AC06 并发未覆盖
Contractrun-layered-tests.sh contract0既有回归通过PASS需复核本次无公开契约变化
Frontend UTrun-layered-tests.sh frontend-ut04/4PASS需复核本次无前端代码变化
Frontend ITrun-layered-tests.sh frontend-it015/15PASS需复核前端 API 回归，不证明事务边界
E2Erun-layered-tests.sh e2e04/4PASS需复核主流程回归，不替代 Backend IT
+
PASS = 已有成功证据NEEDS_VERIFY = 本次运行未形成新证据BLOCK = 阻断发布
+
+
+
+ +
+
+ 02 · STRATEGY TRACEABILITY测试策略与 Case 对应关系8 个 Case · 6 个已证明 · 2 个 partial · 展开查看层级与证据目标 +
+
02 · STRATEGY TRACEABILITY

测试策略与 Case 对应关系

Strategy 决定层级；Case 保持分层无关
+ + + + + + + + + + + + +
Case IDAC策略选择的层级策略中的证据目标Case 状态Review 结论
TEST-TIMEOUT-AC01-001AC01Backend UT + IT101→103；库存/优惠券持久化状态passed已有证据
TEST-TIMEOUT-AC02-001AC02Backend UT + IT终态无副作用；重复任务无变化passed已有证据
TEST-TIMEOUT-AC03-001AC03Backend UT + IT库存失败；订单、库存、优惠券回滚passed已有证据
TEST-TIMEOUT-AC04-001AC04Backend UT优惠券失败向上抛出passed建议补事务级失败 IT
TEST-TIMEOUT-AC05-001AC05Backend IT第二次执行不重复增加资源passed已有证据
TEST-TIMEOUT-AC06-001AC06Backend UT；并发 IT 待补乐观锁 loser 无补偿；并发只有一个 winnerpartial需真实双线程 Testcontainers IT
TEST-TIMEOUT-AC07-001AC07Code / Log Review订单号、结果、失败原因可查询partial需结构化日志采集断言
TEST-TIMEOUT-AC08-001AC01Backend UTTask 将订单号委托给补偿服务passed已有证据
+
+
+
+ +
+
+ 03 · CASE REVIEW测试 Case 列表8 个 Case · 6 PASS · 2 PARTIAL · 点击展开具体步骤、Oracle 和 Evidence +
+
03 · CASE REVIEW

测试 Case 列表

点击任一 Case 展开细节
+
+
TEST-TIMEOUT-AC01-001AC01PASS正常超时关闭
Purpose
验证未支付订单可以完成关闭，并释放全部资源。
Strategy
Backend UT 验证编排；Backend IT 验证真实数据库状态。
Precondition
订单状态 101；库存已扣减 2；优惠券处于已使用状态。
Steps
执行超时补偿服务，查询订单、库存和优惠券记录。
Oracle
订单变为 103；库存 5→7；优惠券恢复可用。
Evidence
OrderTimeoutCompensationServiceUnitTest；OrderTimeoutConsistencyIT。
+
TEST-TIMEOUT-AC02-001AC02PASS终态门禁与无副作用
Purpose
验证已完成或已关闭订单不会再次释放资源。
Strategy
Backend UT 验证状态分支；Backend IT 验证持久化结果。
Precondition
订单已处于不可补偿终态。
Steps
执行任务一次或重复执行，检查 update、库存和优惠券调用。
Oracle
订单和资源均无变化；无重复副作用。
Evidence
Mockito interaction verification；重复执行 IT。
+
TEST-TIMEOUT-AC03-001AC03PASS库存失败回滚
Purpose
库存回补失败时，验证事务不会留下半完成状态。
Strategy
Backend UT 验证失败传播；Backend IT 验证 MySQL rollback。
Precondition
库存商品缺失或库存更新失败。
Steps
触发补偿，捕获异常并读取订单、库存、优惠券。
Oracle
异常可见；订单仍为 101；库存和优惠券保持原状态。
Evidence
Unit failure case；Testcontainers rollback assertion。
+
TEST-TIMEOUT-AC04-001AC04PASS优惠券失败传播
Purpose
验证优惠券释放失败不能被静默吞掉。
Strategy
Backend UT；事务边界的 IT 失败注入仍可补充。
Precondition
优惠券更新操作抛出异常。
Steps
执行补偿服务，检查调用方是否收到失败。
Oracle
异常向上抛出；不能报告为成功。
Evidence
OrderTimeoutCompensationServiceUnitTest。
Review gap：当前已证明失败传播，建议再补一条真实事务失败 IT，证明跨表状态不会半提交。
+
TEST-TIMEOUT-AC05-001AC05PASS重复执行幂等
Purpose
验证任务重试不会重复增加库存或释放优惠券。
Strategy
Backend IT；用持久化资源 delta 作为主要 Oracle。
Precondition
同一订单可被任务再次处理。
Steps
连续执行两次补偿，比较两次前后的订单、库存、优惠券。
Oracle
第二次执行不产生新的资源变化。
Evidence
OrderTimeoutConsistencyIT repeated-execution case。
+
TEST-TIMEOUT-AC06-001AC06PARTIAL并发补偿保护
Purpose
验证两个任务同时处理同一订单时，最多只有一个有效补偿。
Strategy
当前仅有 Backend UT 的 optimistic-lock loser；真实并发 IT 尚未实现。
Precondition
两个执行线程使用同一个未支付订单。
Steps
并发启动两个补偿任务，读取最终订单、库存和优惠券。
Oracle
一个 winner 完成补偿；另一个 loser 无副作用。
Evidence
当前只有 update result=0 与 no-interaction 的 UT 证据。
Open gap：必须补真实双线程 Testcontainers IT，才能把该 Case 标为 PASS。
+
TEST-TIMEOUT-AC07-001AC07PARTIAL审计日志上下文
Purpose
验证成功、跳过、失败日志都包含订单上下文和结果。
Strategy
Code / Log Review；当前未配置结构化日志采集断言。
Precondition
分别触发成功、终态跳过、依赖失败。
Steps
采集日志并按 orderId、result、failureCause 查询。
Oracle
三种路径的字段完整且 error level 正确。
Evidence
当前只有代码审查和人工日志观察。
Open gap：接入 appender 或结构化 sink，并加入自动断言后再标为 PASS。
+
TEST-TIMEOUT-AC08-001AC01PASSTask 委托路由
Purpose
验证 scheduler Task 不自行持有事务，而是将订单号委托给 Spring 管理的补偿服务。
Strategy
Backend UT；验证 delegation interaction。
Precondition
Task 收到订单号。
Steps
运行 Task，检查补偿服务是否收到同一订单号。
Oracle
委托调用发生且参数正确。
Evidence
OrderUnpaidTaskUnitTest。
+
+
+
+
+ +
+
+ 04 · REVIEW DECISION需要确认的项目2 个 P1 风险 · 1 个环境验证项 · 关闭后才可变为 PASS +
+
04 · REVIEW DECISION

需要确认的项目

关闭后才可从 NEEDS_VERIFY 变为 PASS
+ + + + + + + +
优先级问题当前状态关闭动作关闭标准
P1真实并发 IT 未执行AC06 partial恢复 Colima/Testcontainers，新增双线程 IT一个 winner、一个 loser；资源只释放一次
P1结构化日志无自动断言AC07 partial接入日志采集并断言 orderId/result/failureCause成功、跳过、失败三类日志均可查询
P2完整分层重跑被环境阻塞未形成 2026-08-22 新证据修复 Docker socket 后重跑 all命令退出码 0，报告时间戳更新
+
Review decision：当前不阻断代码评审，但阻断“无条件测试通过”结论。完成 P1 和完整重跑后，重新评审本报告首页状态。
+
+
+
+ +
+
05 · EVIDENCE

复核入口

+ ./Tests/scripts/run-layered-tests.sh all + ./Tests/scripts/run-layered-tests.sh coverage + ruby .agents/skills/test-agent-workflow/scripts/validate-workflow.rb +

Test Case Design

test-case-design-order-timeout-atomic-close.md

Test Strategy

test-strategy-order-timeout-atomic-close.md

Execution evidence

Tests/backend/target/{surefire,failsafe}-reports/

+
Generated for MALL-ORD-TIMEOUT-001Final report · reviewable format
+
+
+ + diff --git a/Tests/ai-native-workflow/litemall-payment/test-execution-report-order-timeout-atomic-close.md b/Tests/ai-native-workflow/litemall-payment/test-execution-report-order-timeout-atomic-close.md new file mode 100644 index 000000000..4303583c5 --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/test-execution-report-order-timeout-atomic-close.md @@ -0,0 +1,81 @@ +# Final Test Report：未支付订单超时关闭资源一致性 + +## Workflow Run + +- `mode`: `feature_delivery` +- `feature_id`: `MALL-ORD-TIMEOUT-001` +- `execution_date`: `2026-08-18` +- `strategy_status`: `targeted-release-evidence-complete` +- `production_code_changed`: yes +- `new_executable_tests_added`: yes +- `overall_status`: **implemented and verified with residual P1 risks** + +## Implementation Delivered + +1. Added `OrderTimeoutCompensationService` as the Spring transaction boundary. +2. Changed `OrderUnpaidTask` to delegate to that service; the raw scheduler + object no longer owns the database transaction. +3. Added rollback on stock/coupon failure, optimistic-lock safe skip, and task + success/skip/failure logs with order context. +4. Added unit and Testcontainers MySQL integration coverage, including the + missing `litemall_order_goods` test fixture. + +## Executed Commands + +| scope | command | result | evidence | +| --- | --- | --- | --- | +| focused UT | `mvn -q -f Tests/backend/pom.xml -Dtest=OrderTimeoutCompensationServiceUnitTest,OrderUnpaidTaskUnitTest test` | PASS | 7 timeout-related unit cases | +| full workflow | `./Tests/scripts/run-layered-tests.sh all` | PASS | scripts, Backend UT, Contract, Frontend UT/IT, Backend IT, E2E | +| workflow validation | `ruby .agents/skills/test-agent-workflow/scripts/validate-workflow.rb` | PASS | `public_skills=6`, `execution_layer_references=6` | + +The full `all` lane also generated backend and frontend coverage artifacts. +Backend IT used Testcontainers against the Colima Docker socket. + +## Layer Results + +| layer | new tests | existing regression | result | +| --- | ---: | --- | --- | +| Backend UT | **7** | existing regression passed | PASS | +| Backend IT | **3** | **5** existing regression tests passed | PASS, 8 total | +| Contract | 0 | existing regression passed | PASS | +| Frontend UT | 0 | existing regression 4/4 | PASS | +| Frontend IT | 0 | existing regression 15/15 | PASS | +| E2E | 0 | existing regression 4/4 | PASS | +| Runner / quality gates | 0 | existing checks passed | PASS | + +### Newly Added Executable Tests + +- Backend UT: `OrderTimeoutCompensationServiceUnitTest` — **5 tests** +- Backend UT: `OrderUnpaidTaskUnitTest` — **2 tests** +- Backend IT: `OrderTimeoutConsistencyIT` — **3 tests** + +The table intentionally keeps new tests and existing regression evidence +separate. The existing regression column is not itself a claim that every test +is directly impacted by this internal timeout change. + +## Acceptance Evidence + +| AC | result | evidence | +| --- | --- | --- | +| AC01 | PASS | order becomes `103`, product stock `5 → 7`, coupon becomes usable | +| AC02 | PASS | terminal order is skipped; repeated run has no new side effect | +| AC03 | PASS | missing product causes failure; order remains `101`, stock/coupon unchanged | +| AC04 | PASS | coupon update failure propagates instead of being silently accepted | +| AC05 | PASS | second execution does not add stock or release coupon again | +| AC06 | PARTIAL | optimistic-lock loss is a safe no-op; real concurrent IT is deferred | +| AC07 | PARTIAL | task logs order id/result/failure cause; structured log assertion is deferred | + +## Evidence Artifacts + +- `Tests/backend/target/surefire-reports/` +- `Tests/backend/target/failsafe-reports/` +- `Tests/backend/target/site/jacoco/index.html` +- `Tests/frontend/coverage/index.html` +- `litemall/Tests/ai-native-workflow/litemall-payment/test-case-design-order-timeout-atomic-close.md` +- `litemall/Tests/ai-native-workflow/litemall-payment/test-strategy-order-timeout-atomic-close.md` + +## Final Decision + +Approve the implemented atomic rollback and repeat-execution scope for release +review. Do not claim real multi-thread concurrency or structured log collection +as fully proven until the two P1 follow-up cases are added. diff --git a/Tests/ai-native-workflow/litemall-payment/test-strategy-order-cancel-unpaid.md b/Tests/ai-native-workflow/litemall-payment/test-strategy-order-cancel-unpaid.md new file mode 100644 index 000000000..89a200dc7 --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/test-strategy-order-cancel-unpaid.md @@ -0,0 +1,46 @@ +# Test Strategy：取消未支付订单 + +## Test Strategy + +- `design_id`: `MALL-ORD-CANCEL-001-DESIGN` +- `review_id`: `MALL-ORD-CANCEL-001-REVIEW` +- `impacted_chains`: `order-lifecycle`, `stock-compensation`, `coupon-release`, `frontend-api-contract` +- `changed_surfaces`: order cancellation service/controller, inventory compensation, coupon release, mobile order API, payment-flow harness +- `affected_contracts`: `POST /order/cancel`, body `{ orderId }` +- `risks`: order status transition, duplicate cancellation, stock/coupon consistency, ownership guard +- `execution_profile`: `targeted-medium` +- `selected_cases`: `MALL-PAY-AC09-BE-UT-001`, `MALL-PAY-AC09-BE-UT-002`, `MALL-PAY-AC00-CONTRACT-001`, `MALL-PAY-AC09-FE-IT-001`, `MALL-PAY-AC09-BE-IT-001`, `MALL-PAY-AC09-E2E-001` +- `deferred_cases`: `TEST-ORD-CANCEL-AC06-001` — no failure-injection transaction test yet +- `required_runtimes`: Java/Maven, Node/npm, Docker-compatible runtime for Backend IT, Playwright Chromium +- `evidence_contract`: command, selected case ID, layer, runtime, result, report/trace path, evidence boundary, residual risk + +## Execution Order + +1. Script self-check and Backend UT — fast business rules and guards. +2. Contract — controller method/path and contract ID consistency. +3. Frontend IT — client request path and payload. +4. Backend IT — persistence primitives and MySQL evidence. +5. E2E — critical browser cancellation path through local harness. + +## Commands + +```bash +./Tests/scripts/run-layered-tests.sh backend-ut +./Tests/scripts/run-layered-tests.sh contract +./Tests/scripts/run-layered-tests.sh frontend-it +./Tests/scripts/run-layered-tests.sh backend-it +./Tests/scripts/run-layered-tests.sh e2e +``` + +## Gates + +- Backend UT, Contract, Frontend IT, Backend IT, and E2E must execute intended + tests; a zero-test or setup failure is `BLOCKED`, not green. +- Backend IT must record Docker/Testcontainers runtime and database reset. +- E2E must record local harness boundary and retain trace/screenshot on failure. +- Do not claim AC06 or deployed-system behavior from this strategy. + +## Handoff + +- `next_skill`: `test-execution` +- `failure_route`: design defect → Test Case Design; runner/fixture/environment defect → Failure Repair diff --git a/Tests/ai-native-workflow/litemall-payment/test-strategy-order-timeout-atomic-close.md b/Tests/ai-native-workflow/litemall-payment/test-strategy-order-timeout-atomic-close.md new file mode 100644 index 000000000..9b5312504 --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/test-strategy-order-timeout-atomic-close.md @@ -0,0 +1,43 @@ +# Test Strategy：未支付订单超时关闭资源一致性 + +## Test Strategy + +- `design_id`: `MALL-ORD-TIMEOUT-001-DESIGN` +- `review_decision`: `approved-with-residual-risk` +- `strategy_status`: `targeted-release-evidence-complete` +- `changed_surfaces`: transaction service, timeout task delegation, stock/coupon compensation, failure logging +- `affected_contracts`: `none` (internal scheduled task) +- `primary_risks`: `status-transition`, `transaction-consistency`, `duplicate-compensation` +- `residual_risks`: real multi-thread race and structured log collection +- `execution_order`: focused UT → full `all` lane → workflow validation +- `required_runtimes`: Java/Maven; Docker/Colima for Backend IT; Node/Playwright for E2E +- `evidence_contract`: command, layer, test report, AC mapping, and explicit residual boundary + +## Selected Cases and Layers + +| case_id | AC | primary layer | evidence | +| --- | --- | --- | --- | +| `TEST-TIMEOUT-AC01-001` | AC01 | backend-ut/backend-it | orchestration unit + committed DB state | +| `TEST-TIMEOUT-AC02-001` | AC02 | backend-ut/backend-it | terminal-state no-op + repeated task | +| `TEST-TIMEOUT-AC03-001` | AC03 | backend-ut/backend-it | stock failure + transaction rollback | +| `TEST-TIMEOUT-AC04-001` | AC04 | backend-ut | coupon update failure propagation | +| `TEST-TIMEOUT-AC05-001` | AC05 | backend-it | repeated execution does not duplicate resource delta | +| `TEST-TIMEOUT-AC06-001` | AC06 | backend-ut | optimistic-lock loss no-op; concurrency IT deferred | +| `TEST-TIMEOUT-AC07-001` | AC07 | code/log review | task logs order id, result, and failure cause; structured assertion deferred | + +## Commands + +1. `./Tests/scripts/run-layered-tests.sh all` +2. `ruby .agents/skills/test-agent-workflow/scripts/validate-workflow.rb` + +The `all` lane includes scripts, Backend UT, Contract, Frontend UT/IT, +Backend IT, and E2E. Backend IT uses the Colima Docker socket through +Testcontainers. + +## Stop and Release Rules + +- Do not approve if Backend UT or Backend IT fails. +- Do not infer transaction consistency from E2E; the order/stock/coupon DB + assertions are the primary evidence. +- Mark AC06 and AC07 as partial until a concurrent integration harness and a + structured log assertion exist. diff --git a/Tests/ai-native-workflow/litemall-payment/workflow-pack.md b/Tests/ai-native-workflow/litemall-payment/workflow-pack.md new file mode 100644 index 000000000..836bd9b21 --- /dev/null +++ b/Tests/ai-native-workflow/litemall-payment/workflow-pack.md @@ -0,0 +1,99 @@ +# Payment Reliability Test Agent Workflow Pack + +schema_version: 2 +workflow_id: litemall-payment +chain: payment-callback-reliability + +## Identity Contract + +| identity | owner | meaning | +| --- | --- | --- | +| case_id | Test Case Design | stable layer-neutral business Case | +| test_case_id | Test Strategy | stable executable Case for one selected layer | +| execution_id | Test Strategy run | one ordered execution item | + +## Acceptance Criteria + +| ac_id | priority | behavior | observable oracle | +| --- | --- | --- | --- | +| AC01 | P0 | 订单更新为已支付，并持久化 pay_id 与 pay_time | mutated order status, pay_id, pay_time, MySQL row | +| AC02 | P0 | 系统幂等返回成功，不能再次更新订单或重复移除任务 | success response, no duplicate update, mutation count | +| AC03 | P0 | 系统失败返回且不更新订单 | FAIL response, order unchanged, no side effect | +| AC04 | P1 | 系统不能触发订单副作用，并保持 XML 契约可诊断 | XML fixture fields, FAIL response, no lookup/update | +| AC05 | P0 | 乐观锁拒绝覆盖，且停止通知和超时任务移除 | optimistic lock result, MySQL row status, no side effect | +| AC06 | P0 | 库存不能扣成负数，补偿路径可以回补库存 | product number, stock decrement, stock restore | +| AC07 | P1 | 请求路径、方法和 payload 必须符合契约 | captured request body, contract fixture, OpenAPI apispec | +| AC08 | P1 | 页面最终进入 paid 状态，重复回调只生效一次 | visible paid status, mutation count, Playwright trace when failed | +| AC09 | P0 | 订单置为已取消，并回补库存、释放已占用优惠券 | order status, stock restored, coupon released | +| AC10 | P0 | 团购状态被正确推进，查询忽略未支付占位和逻辑删除记录 | groupon status, share image, filtered MySQL rows | +| AC11 | P1 | 前端文案和动作映射必须与后端状态机保持一致 | pure function output, status table assertions | +| AC12 | P0 | 仅已付款未发货订单可进入退款中并通知运营 | order refund status, notification evidence, failed invalid request | +| AC13 | P1 | 接口契约必须保持稳定 | captured request body, contract method/path | +| AC14 | P1 | 接口契约必须保持稳定 | captured request body, contract method/path | + +## Test Case Design + +design_id: TCD-LITEMALL-PAYMENT-001 +design_version: 2 +boundary: business Cases only; no layer, framework, command, runtime, or target selection + +| case_id | ac_id | origin | priority | purpose | oracle | +| --- | --- | --- | --- | --- | --- | +| MALL-PAY-AC01-001 | AC01 | existing | P0 | 支付成功回调更新订单状态 | mutated order, SUCCESS response | +| MALL-PAY-AC02-002 | AC02 | existing | P0 | 重复支付回调幂等返回成功 | no update invocation, SUCCESS response | +| MALL-PAY-AC03-003 | AC03 | existing | P0 | 金额不一致拒绝更新订单 | FAIL response, no update invocation | +| MALL-PAY-AC04-004 | AC04 | existing | P1 | 微信支付回调 XML 必填字段稳定 | XML fixture validation | +| MALL-PAY-AC05-005 | AC05 | existing | P0 | 过期订单副本不能覆盖最新支付状态 | MySQL row status, optimistic lock result | +| MALL-PAY-AC06-006 | AC06 | existing | P0 | 库存不能为负且可回补 | MySQL product number | +| MALL-PAY-AC07-007 | AC07 | existing | P1 | 移动端订单 API 发送符合契约的请求 | captured request body | +| MALL-PAY-AC08-008 | AC08 | existing | P1 | 浏览器支付主链路只进入一次 paid 状态 | visible paid status, mutation count | +| MALL-PAY-AC09-009 | AC09 | new | P0 | 取消未支付订单恢复库存并释放优惠券 | mutated order, stock call, coupon state | +| MALL-PAY-AC10-010 | AC10 | new | P0 | 团购支付达到阈值后成团 | source groupon status, join groupon status | +| MALL-PAY-AC11-011 | AC11 | new | P1 | 前端订单状态和可用动作映射稳定 | pure function output | +| MALL-PAY-AC12-012 | AC12 | new | P0 | 已付款订单申请退款进入退款中 | mutated order, notification evidence | +| MALL-PAY-AC13-013 | AC13 | new | P1 | 移动端发送确认收货请求 | captured request body | +| MALL-PAY-AC14-014 | AC14 | new | P1 | 移动端发送删除订单请求 | captured request body | + +## Test Case Quality Review + +design: TCD-LITEMALL-PAYMENT-001 v2 +decision: PASS +approved_case_count: 14 +boundary: approves Case quality only; does not choose layers or commands + +## Test Strategy + +strategy_id: TS-LITEMALL-PAYMENT-001 +execution_profile: release-focused +decision: READY + +| order | execution_id | case_id | test_case_id | layer | layer_reference | action | command | +| ---: | --- | --- | --- | --- | --- | --- | --- | +| 1 | EXEC-20260815-001 | MALL-PAY-AC01-001 | MALL-PAY-AC01-BE-UT-001 | backend-ut | references/layers/backend-ut.md | run-existing | ./Tests/scripts/run-layered-tests.sh backend-ut | +| 2 | EXEC-20260815-002 | MALL-PAY-AC02-002 | MALL-PAY-AC02-BE-UT-001 | backend-ut | references/layers/backend-ut.md | run-existing | ./Tests/scripts/run-layered-tests.sh backend-ut | +| 3 | EXEC-20260815-003 | MALL-PAY-AC03-003 | MALL-PAY-AC03-BE-UT-001 | backend-ut | references/layers/backend-ut.md | run-existing | ./Tests/scripts/run-layered-tests.sh backend-ut | +| 4 | EXEC-20260815-004 | MALL-PAY-AC04-004 | MALL-PAY-AC04-CONTRACT-001 | contract | references/layers/contract.md | run-existing | ./Tests/scripts/run-layered-tests.sh contract | +| 5 | EXEC-20260815-005 | MALL-PAY-AC05-005 | MALL-PAY-AC05-BE-IT-001 | backend-it | references/layers/backend-it-testcontainers.md | run-existing | ./Tests/scripts/run-layered-tests.sh backend-it | +| 6 | EXEC-20260815-006 | MALL-PAY-AC06-006 | MALL-PAY-AC06-BE-IT-001 | backend-it | references/layers/backend-it-testcontainers.md | run-existing | ./Tests/scripts/run-layered-tests.sh backend-it | +| 7 | EXEC-20260815-007 | MALL-PAY-AC07-007 | MALL-PAY-AC07-FE-IT-001 | frontend-it | references/layers/frontend-it.md | run-existing | ./Tests/scripts/run-layered-tests.sh frontend-it | +| 8 | EXEC-20260815-008 | MALL-PAY-AC08-008 | MALL-PAY-AC08-E2E-001 | e2e | references/layers/e2e.md | run-existing | ./Tests/scripts/run-layered-tests.sh e2e | +| 9 | EXEC-20260815-009 | MALL-PAY-AC09-009 | MALL-PAY-AC09-BE-UT-001 | backend-ut | references/layers/backend-ut.md | create-new | ./Tests/scripts/run-layered-tests.sh backend-ut | +| 10 | EXEC-20260815-010 | MALL-PAY-AC10-010 | MALL-PAY-AC10-BE-UT-001 | backend-ut | references/layers/backend-ut.md | create-new | ./Tests/scripts/run-layered-tests.sh backend-ut | +| 11 | EXEC-20260815-011 | MALL-PAY-AC11-011 | MALL-PAY-AC11-FE-UT-001 | frontend-ut | references/layers/frontend-ut.md | create-new | ./Tests/scripts/run-layered-tests.sh frontend-ut | +| 12 | EXEC-20260815-012 | MALL-PAY-AC12-012 | MALL-PAY-AC12-BE-UT-001 | backend-ut | references/layers/backend-ut.md | create-new | ./Tests/scripts/run-layered-tests.sh backend-ut | +| 13 | EXEC-20260815-013 | MALL-PAY-AC13-013 | MALL-PAY-AC13-FE-IT-001 | frontend-it | references/layers/frontend-it.md | create-new | ./Tests/scripts/run-layered-tests.sh frontend-it | +| 14 | EXEC-20260815-014 | MALL-PAY-AC14-014 | MALL-PAY-AC14-FE-IT-001 | frontend-it | references/layers/frontend-it.md | create-new | ./Tests/scripts/run-layered-tests.sh frontend-it | + +## Execution and Repair Contract + +- Test Execution loads only the layer_reference values selected above. +- The project CLI and Tests/test-index.yml are execution authorities. +- Product defects are reported unless product-code repair was explicitly authorized. +- Design defects return to Case Design and Review; Strategy defects return to Test Strategy. +- Valid results: PASSED, FAILED, BLOCKED, SKIPPED, NOT_PROVEN, INCOMPLETE. + +## Validation + + ruby ".agents/skills/test-agent-workflow/scripts/validate-workflow.rb" + python3 "AI Native/scripts/build-litemall-quality-kb.py" + python3 "AI Native/scripts/run-litemall-skill-benchmark.py" diff --git a/Tests/backend/pom.xml b/Tests/backend/pom.xml new file mode 100644 index 000000000..327eed986 --- /dev/null +++ b/Tests/backend/pom.xml @@ -0,0 +1,173 @@ + + + 4.0.0 + + org.linlinjava.litemall.tests + litemall-tests-backend + 0.1.0 + jar + + + UTF-8 + 1.8 + 1.8 + 0.1.0 + 2.1.5.RELEASE + 4.13.2 + 4.11.0 + 1.14.19 + 1.23 + 1.21.4 + 0.8.13 + false + + + + + + org.springframework.boot + spring-boot-dependencies + ${spring.boot.version} + pom + import + + + net.bytebuddy + byte-buddy + ${bytebuddy.version} + + + net.bytebuddy + byte-buddy-agent + ${bytebuddy.version} + + + + + + + org.linlinjava + litemall-core + ${litemall.version} + + + org.linlinjava + litemall-db + ${litemall.version} + + + org.linlinjava + litemall-wx-api + ${litemall.version} + + + org.springframework.boot + spring-boot-starter-test + ${spring.boot.version} + test + + + org.mockito + mockito-core + + + com.vaadin.external.google + android-json + + + + + junit + junit + ${junit.version} + test + + + org.mockito + mockito-core + ${mockito.version} + test + + + org.testcontainers + mysql + ${testcontainers.version} + test + + + org.yaml + snakeyaml + ${snakeyaml.version} + test + + + + + + + org.apache.maven.plugins + maven-surefire-plugin + 3.2.5 + + + **/*Test.java + + + **/*IT.java + + + + + org.apache.maven.plugins + maven-failsafe-plugin + 3.2.5 + + ${skipITs} + + **/*IT.java + + + + + + integration-test + verify + + + + + + + + + + coverage + + + + org.jacoco + jacoco-maven-plugin + ${jacoco.version} + + + prepare-jacoco-agent + + prepare-agent + + + ${project.build.directory}/jacoco.exec + true + + org.linlinjava.litemall.* + + + + + + + + + + diff --git a/Tests/backend/src/test/java/org/linlinjava/litemall/tests/contract/FrontendBackendOrderContractTest.java b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/contract/FrontendBackendOrderContractTest.java new file mode 100644 index 000000000..feb8a31c5 --- /dev/null +++ b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/contract/FrontendBackendOrderContractTest.java @@ -0,0 +1,249 @@ +package org.linlinjava.litemall.tests.contract; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import org.junit.Test; +import org.yaml.snakeyaml.Yaml; + +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.Paths; +import java.util.List; +import java.util.Locale; +import java.util.Map; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +public class FrontendBackendOrderContractTest { + + @Test + public void mallPayAc07Contract001_mobileOrderApiPathsMatchBackendControllerMappings() throws Exception { + Path root = Paths.get("..", "..").toAbsolutePath().normalize(); + String frontendApi = read(root.resolve("litemall-vue/src/api/api.js")); + String backendController = read(root.resolve("litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/web/WxOrderController.java")); + JsonNode contract = new ObjectMapper().readTree(root.resolve("Tests/contracts/order-api.contract.json").toFile()); + + assertTrue(backendController.contains("@RequestMapping(\"/wx/order\")")); + + for (JsonNode endpoint : contract.get("endpoints")) { + JsonNode frontendPath = endpoint.get("frontendPath"); + if (!frontendPath.isNull()) { + assertTrue("frontend path missing: " + frontendPath.asText(), frontendApi.contains("'" + frontendPath.asText() + "'")); + } + String mapping = endpoint.get("backendMapping").asText(); + assertTrue("backend mapping missing: " + mapping, backendController.contains("\"" + mapping + "\"")); + assertTrue( + "backend HTTP method mismatch for " + mapping, + hasMethodMapping(backendController, endpoint.get("method").asText(), mapping) + ); + } + } + + @Test + public void mallPayAc00Contract001_contractFixtureKeepsStableCaseIdsAndHttpMethods() throws Exception { + Path root = Paths.get("..", "..").toAbsolutePath().normalize(); + JsonNode contract = new ObjectMapper().readTree(root.resolve("Tests/contracts/order-api.contract.json").toFile()); + + assertTrue(contract.hasNonNull("feature")); + assertTrue(contract.has("endpoints")); + + for (JsonNode endpoint : contract.get("endpoints")) { + String id = endpoint.get("id").asText(); + String method = endpoint.get("method").asText(); + + assertTrue("invalid test_case_id: " + id, id.matches("MALL-PAY-AC\\d{2}-(FE-IT|CONTRACT)-\\d{3}")); + assertTrue("unsupported method: " + method, method.matches("GET|POST|PUT|DELETE")); + assertFalse("backend mapping must not be blank", endpoint.get("backendMapping").asText().trim().isEmpty()); + } + } + + @Test + public void mallPayAc00Contract002_openApiSpecKeepsPathsMethodsAndTestCaseIdsInSync() throws Exception { + Path root = Paths.get("..", "..").toAbsolutePath().normalize(); + JsonNode contract = new ObjectMapper().readTree(root.resolve("Tests/contracts/order-api.contract.json").toFile()); + Map openApi = new Yaml().load(read(root.resolve("Tests/contracts/order-api.openapi.yaml"))); + Map paths = map(openApi.get("paths")); + + for (JsonNode endpoint : contract.get("endpoints")) { + String mapping = endpoint.get("backendMapping").asText(); + String path = "/order/" + mapping; + String method = endpoint.get("method").asText().toLowerCase(Locale.ROOT); + Map pathItem = map(paths.get(path)); + Map operation = map(pathItem.get(method)); + + assertFalse("OpenAPI operation missing for " + method + " " + path, operation.isEmpty()); + assertTrue("OpenAPI operationId missing for " + method + " " + path, operation.containsKey("operationId")); + assertTrue("OpenAPI test case id mismatch for " + method + " " + path, + endpoint.get("id").asText().equals(operation.get("x-test-case-id"))); + + JsonNode frontendPath = endpoint.get("frontendPath"); + if (!frontendPath.isNull()) { + assertTrue("OpenAPI frontend path mismatch for " + method + " " + path, + frontendPath.asText().equals(operation.get("x-frontend-path"))); + } + assertTrue("OpenAPI backend mapping mismatch for " + method + " " + path, + mapping.equals(operation.get("x-backend-mapping"))); + + assertRequiredFieldsMatch(endpoint, operation, openApi); + } + } + + @Test + public void mallPayAc07Contract002_requestMappingMethodMustBelongToTheSameEndpointAnnotation() { + String controllerSource = + "@RequestMapping(\"submit\")\n" + + "public Object submit() { return null; }\n" + + "@RequestMapping(value = \"cancel\", method = RequestMethod.POST)\n" + + "public Object cancel() { return null; }\n"; + + assertFalse(hasMethodMapping(controllerSource, "POST", "submit")); + assertTrue(hasMethodMapping(controllerSource, "POST", "cancel")); + } + + @Test + public void mallPayAc07Contract003_requestMappingSupportsNamedPathAndMethodArray() { + String controllerSource = + "@RequestMapping(path = {\"pay-notify\"}, method = {RequestMethod.POST})\n" + + "public Object payNotify() { return null; }\n"; + + assertTrue(hasMethodMapping(controllerSource, "POST", "pay-notify")); + assertFalse(hasMethodMapping(controllerSource, "GET", "pay-notify")); + } + + private String read(Path path) throws Exception { + return new String(Files.readAllBytes(path), StandardCharsets.UTF_8); + } + + @SuppressWarnings("unchecked") + private Map map(Object value) { + if (value instanceof Map) { + return (Map) value; + } + return java.util.Collections.emptyMap(); + } + + @SuppressWarnings("unchecked") + private List list(Object value) { + if (value instanceof List) { + return (List) value; + } + return java.util.Collections.emptyList(); + } + + private void assertRequiredFieldsMatch(JsonNode endpoint, Map operation, Map openApi) { + if (endpoint.has("requiredPayloadFields")) { + List expected = list(new ObjectMapper().convertValue(endpoint.get("requiredPayloadFields"), List.class)); + List actual = requiredJsonBodyFields(operation, openApi); + assertTrue("OpenAPI JSON body fields missing: " + expected, actual.containsAll(expected)); + } + if (endpoint.has("requiredQueryFields")) { + List expected = list(new ObjectMapper().convertValue(endpoint.get("requiredQueryFields"), List.class)); + List actual = requiredQueryFields(operation); + assertTrue("OpenAPI query fields missing: " + expected, actual.containsAll(expected)); + } + if (endpoint.has("requiredXmlFields")) { + List expected = list(new ObjectMapper().convertValue(endpoint.get("requiredXmlFields"), List.class)); + List actual = requiredXmlFields(operation, openApi); + assertTrue("OpenAPI XML fields missing: " + expected, actual.containsAll(expected)); + } + } + + private List requiredJsonBodyFields(Map operation, Map openApi) { + Map schema = resolveSchema(jsonRequestSchema(operation, openApi), openApi); + return list(schema.get("required")); + } + + private List requiredXmlFields(Map operation, Map openApi) { + Map requestBody = resolveRequestBody(map(operation.get("requestBody")), openApi); + Map content = map(requestBody.get("content")); + Map xml = map(content.get("application/xml")); + Map schema = resolveSchema(map(xml.get("schema")), openApi); + return list(schema.get("required")); + } + + private Map jsonRequestSchema(Map operation, Map openApi) { + Map requestBody = resolveRequestBody(map(operation.get("requestBody")), openApi); + Map content = map(requestBody.get("content")); + Map json = map(content.get("application/json")); + return map(json.get("schema")); + } + + private Map resolveRequestBody(Map requestBody, Map openApi) { + if (!requestBody.containsKey("$ref")) { + return requestBody; + } + Map components = map(openApi.get("components")); + Map requestBodies = map(components.get("requestBodies")); + return map(requestBodies.get(refName(String.valueOf(requestBody.get("$ref"))))); + } + + private Map resolveSchema(Map schema, Map openApi) { + if (!schema.containsKey("$ref")) { + return schema; + } + Map components = map(openApi.get("components")); + Map schemas = map(components.get("schemas")); + return map(schemas.get(refName(String.valueOf(schema.get("$ref"))))); + } + + private String refName(String ref) { + return ref.substring(ref.lastIndexOf('/') + 1); + } + + private List requiredQueryFields(Map operation) { + java.util.ArrayList result = new java.util.ArrayList<>(); + for (Object parameterObject : list(operation.get("parameters"))) { + Map parameter = map(parameterObject); + if (Boolean.TRUE.equals(parameter.get("required"))) { + result.add(parameter.get("name")); + } + } + return result; + } + + private boolean hasMethodMapping(String controllerSource, String method, String mapping) { + String normalizedMethod = method.toUpperCase(Locale.ROOT); + String methodMapping = normalizedMethod.substring(0, 1) + + normalizedMethod.substring(1).toLowerCase(Locale.ROOT) + + "Mapping"; + + return annotationWithMappingExists(controllerSource, methodMapping, mapping) + || requestMappingWithMethodExists(controllerSource, normalizedMethod, mapping); + } + + private boolean annotationWithMappingExists(String source, String annotationName, String mapping) { + Matcher matcher = Pattern.compile("@" + annotationName + "\\s*\\(([^)]*)\\)", Pattern.DOTALL).matcher(source); + while (matcher.find()) { + if (containsStringLiteral(matcher.group(1), mapping)) { + return true; + } + } + return false; + } + + private boolean requestMappingWithMethodExists(String source, String method, String mapping) { + Matcher matcher = Pattern.compile("@RequestMapping\\s*\\(([^)]*)\\)", Pattern.DOTALL).matcher(source); + while (matcher.find()) { + String annotationArgs = matcher.group(1); + if (containsStringLiteral(annotationArgs, mapping) + && Pattern.compile("\\bRequestMethod\\s*\\.\\s*" + method + "\\b").matcher(annotationArgs).find()) { + return true; + } + } + return false; + } + + private boolean containsStringLiteral(String source, String expected) { + Matcher matcher = Pattern.compile("\"([^\"]*)\"").matcher(source); + while (matcher.find()) { + if (expected.equals(matcher.group(1))) { + return true; + } + } + return false; + } +} diff --git a/Tests/backend/src/test/java/org/linlinjava/litemall/tests/contract/PaymentNotifyXmlContractTest.java b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/contract/PaymentNotifyXmlContractTest.java new file mode 100644 index 000000000..7708c6632 --- /dev/null +++ b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/contract/PaymentNotifyXmlContractTest.java @@ -0,0 +1,47 @@ +package org.linlinjava.litemall.tests.contract; + +import com.github.binarywang.wxpay.bean.notify.WxPayOrderNotifyResult; +import org.junit.Test; +import org.w3c.dom.Document; + +import javax.xml.parsers.DocumentBuilderFactory; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.Paths; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; + +public class PaymentNotifyXmlContractTest { + + @Test + public void mallPayAc04Contract001_wechatPaymentNotifyXmlKeepsRequiredFields() throws Exception { + Path xml = Paths.get("..", "contracts", "wechat-pay-notify-success.xml").toAbsolutePath().normalize(); + Document document = DocumentBuilderFactory.newInstance().newDocumentBuilder().parse(xml.toFile()); + + assertEquals("SUCCESS", text(document, "return_code")); + assertEquals("SUCCESS", text(document, "result_code")); + assertTrue(text(document, "out_trade_no").length() > 0); + assertTrue(text(document, "transaction_id").startsWith("wxpay-transaction")); + assertEquals("10000", text(document, "total_fee")); + } + + @Test + public void mallPayAc04Contract002_wechatPaymentNotifyXmlCanLoadIntoSdkNotifyResult() throws Exception { + Path xml = Paths.get("..", "contracts", "wechat-pay-notify-success.xml").toAbsolutePath().normalize(); + String xmlBody = new String(Files.readAllBytes(xml), StandardCharsets.UTF_8); + + WxPayOrderNotifyResult result = WxPayOrderNotifyResult.fromXML(xmlBody); + + assertEquals("SUCCESS", result.getReturnCode()); + assertEquals("SUCCESS", result.getResultCode()); + assertEquals("20260711000001", result.getOutTradeNo()); + assertEquals("wxpay-transaction-001", result.getTransactionId()); + assertEquals(Integer.valueOf(10000), result.getTotalFee()); + } + + private String text(Document document, String tag) { + return document.getElementsByTagName(tag).item(0).getTextContent(); + } +} diff --git a/Tests/backend/src/test/java/org/linlinjava/litemall/tests/contract/ProductBrowsingContractTest.java b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/contract/ProductBrowsingContractTest.java new file mode 100644 index 000000000..941989f61 --- /dev/null +++ b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/contract/ProductBrowsingContractTest.java @@ -0,0 +1,135 @@ +package org.linlinjava.litemall.tests.contract; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import org.junit.Test; + +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.Paths; +import java.util.Locale; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +public class ProductBrowsingContractTest { + + @Test + public void mallBrowseAc00Contract001_productBrowsingPathsMatchFrontendAndBackendMappings() throws Exception { + Path root = Paths.get("..", "..").toAbsolutePath().normalize(); + JsonNode contract = new ObjectMapper().readTree(root.resolve("Tests/contracts/product-browsing-api.contract.json").toFile()); + String mobileFrontend = read(root.resolve(contract.get("basePaths").get("mobileFrontend").asText())); + String miniProgramApi = read(root.resolve(contract.get("basePaths").get("miniProgramApi").asText())); + String homeController = read(root.resolve(contract.get("basePaths").get("homeController").asText())); + String goodsController = read(root.resolve(contract.get("basePaths").get("goodsController").asText())); + + assertTrue(homeController.contains("@RequestMapping(\"/wx/home\")")); + assertTrue(goodsController.contains("@RequestMapping(\"/wx/goods\")")); + + for (JsonNode endpoint : contract.get("endpoints")) { + String frontendPath = endpoint.get("frontendPath").asText(); + String controllerSource = "home".equals(endpoint.get("controller").asText()) ? homeController : goodsController; + String mapping = endpoint.get("backendMapping").asText(); + + assertTrue("frontend path missing: " + frontendPath, + mobileFrontend.contains("'" + frontendPath + "'") + || miniProgramApi.contains("'" + stripLeadingSlash(frontendPath) + "'")); + assertTrue("backend mapping missing: " + mapping, controllerSource.contains("\"" + mapping + "\"")); + assertTrue("backend HTTP method mismatch for " + mapping, + hasMethodMapping(controllerSource, endpoint.get("method").asText(), mapping)); + } + } + + @Test + public void mallBrowseAc00Contract002_contractFixtureKeepsStableCaseIdsAndMethods() throws Exception { + Path root = Paths.get("..", "..").toAbsolutePath().normalize(); + JsonNode contract = new ObjectMapper().readTree(root.resolve("Tests/contracts/product-browsing-api.contract.json").toFile()); + + assertTrue(contract.hasNonNull("feature")); + assertTrue(contract.has("endpoints")); + + for (JsonNode endpoint : contract.get("endpoints")) { + String id = endpoint.get("id").asText(); + String method = endpoint.get("method").asText(); + assertTrue("invalid test_case_id: " + id, + id.matches("MALL-BROWSE-AC\\d{2}-(BE-UT|FE-IT|E2E|CONTRACT)-\\d{3}")); + assertTrue("unsupported method: " + method, method.matches("GET|POST|PUT|DELETE")); + assertFalse("backend mapping must not be blank", endpoint.get("backendMapping").asText().trim().isEmpty()); + } + } + + @Test + public void mallBrowseAc03Contract001_requiredGoodsDetailQueryFieldIsStillId() throws Exception { + Path root = Paths.get("..", "..").toAbsolutePath().normalize(); + JsonNode contract = new ObjectMapper().readTree(root.resolve("Tests/contracts/product-browsing-api.contract.json").toFile()); + String goodsController = read(root.resolve(contract.get("basePaths").get("goodsController").asText())); + + JsonNode detailEndpoint = null; + for (JsonNode endpoint : contract.get("endpoints")) { + if ("MALL-BROWSE-AC03-CONTRACT-001".equals(endpoint.get("id").asText())) { + detailEndpoint = endpoint; + break; + } + } + + assertTrue("detail endpoint missing", detailEndpoint != null); + assertTrue("contract must require id", detailEndpoint.get("requiredQueryFields").toString().contains("\"id\"")); + assertTrue("WxGoodsController.detail must keep @NotNull Integer id", + Pattern.compile("detail\\s*\\([^)]*@NotNull\\s+Integer\\s+id", Pattern.DOTALL) + .matcher(goodsController) + .find()); + } + + private String read(Path path) throws Exception { + return new String(Files.readAllBytes(path), StandardCharsets.UTF_8); + } + + private String stripLeadingSlash(String value) { + return value.startsWith("/") ? value.substring(1) : value; + } + + private boolean hasMethodMapping(String controllerSource, String method, String mapping) { + String normalizedMethod = method.toUpperCase(Locale.ROOT); + String methodMapping = normalizedMethod.substring(0, 1) + + normalizedMethod.substring(1).toLowerCase(Locale.ROOT) + + "Mapping"; + + return annotationWithMappingExists(controllerSource, methodMapping, mapping) + || requestMappingWithMethodExists(controllerSource, normalizedMethod, mapping); + } + + private boolean annotationWithMappingExists(String source, String annotationName, String mapping) { + Matcher matcher = Pattern.compile("@" + annotationName + "\\s*\\(([^)]*)\\)", Pattern.DOTALL).matcher(source); + while (matcher.find()) { + if (containsStringLiteral(matcher.group(1), mapping)) { + return true; + } + } + return false; + } + + private boolean requestMappingWithMethodExists(String source, String method, String mapping) { + Matcher matcher = Pattern.compile("@RequestMapping\\s*\\(([^)]*)\\)", Pattern.DOTALL).matcher(source); + while (matcher.find()) { + String annotationArgs = matcher.group(1); + if (containsStringLiteral(annotationArgs, mapping) + && Pattern.compile("\\bRequestMethod\\s*\\.\\s*" + method + "\\b").matcher(annotationArgs).find()) { + return true; + } + } + return false; + } + + private boolean containsStringLiteral(String source, String expected) { + Matcher matcher = Pattern.compile("\"([^\"]*)\"").matcher(source); + while (matcher.find()) { + if (expected.equals(matcher.group(1))) { + return true; + } + } + return false; + } +} diff --git a/Tests/backend/src/test/java/org/linlinjava/litemall/tests/it/OrderTimeoutConsistencyIT.java b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/it/OrderTimeoutConsistencyIT.java new file mode 100644 index 000000000..08992cb47 --- /dev/null +++ b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/it/OrderTimeoutConsistencyIT.java @@ -0,0 +1,126 @@ +package org.linlinjava.litemall.tests.it; + +import org.junit.Before; +import org.junit.ClassRule; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.linlinjava.litemall.db.domain.LitemallCouponUser; +import org.linlinjava.litemall.db.domain.LitemallOrder; +import org.linlinjava.litemall.db.service.LitemallCouponUserService; +import org.linlinjava.litemall.db.service.LitemallGoodsProductService; +import org.linlinjava.litemall.db.service.LitemallOrderService; +import org.linlinjava.litemall.db.util.CouponUserConstant; +import org.linlinjava.litemall.db.util.OrderUtil; +import org.linlinjava.litemall.wx.service.OrderTimeoutCompensationService; +import org.mybatis.spring.annotation.MapperScan; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.util.TestPropertyValues; +import org.springframework.context.ApplicationContextInitializer; +import org.springframework.context.ConfigurableApplicationContext; +import org.springframework.context.annotation.Import; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; +import org.testcontainers.containers.MySQLContainer; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.fail; + +@RunWith(SpringRunner.class) +@SpringBootTest(classes = OrderTimeoutConsistencyIT.DbTestApplication.class) +@ContextConfiguration(initializers = OrderTimeoutConsistencyIT.Initializer.class) +public class OrderTimeoutConsistencyIT { + + @ClassRule + public static MySQLContainer mysql = new MySQLContainer<>("mysql:8.0") + .withDatabaseName("litemall_test") + .withUsername("litemall") + .withPassword("litemall123456") + .withInitScript("db/litemall-it-schema.sql"); + + @Autowired + private JdbcTemplate jdbcTemplate; + @Autowired + private LitemallOrderService orderService; + @Autowired + private LitemallGoodsProductService productService; + @Autowired + private LitemallCouponUserService couponUserService; + @Autowired + private OrderTimeoutCompensationService timeoutService; + + @Before + public void resetData() { + jdbcTemplate.update("delete from litemall_order_goods"); + jdbcTemplate.update("update litemall_goods_product set number = 5, update_time = now() where id = 1"); + jdbcTemplate.update("update litemall_order set order_status = 101, end_time = null, update_time = now() where id = 1"); + jdbcTemplate.update("update litemall_coupon_user set status = 1, used_time = now(), update_time = now(), deleted = 0 where id = 1"); + jdbcTemplate.update("insert into litemall_order_goods (id, order_id, goods_id, goods_name, goods_sn, product_id, number, price, specifications, pic_url, comment, add_time, update_time, deleted) values (1, 1, 100, '测试商品', 'goods-100', 1, 2, 100.00, '[\\\"standard\\\"]', '', 0, now(), now(), 0)"); + } + + @Test + public void mallOrdTimeoutAc01BeIt001_commitsOrderAndAllResourceChanges() { + timeoutService.closeOrder(1); + + LitemallOrder order = orderService.findById(1); + assertEquals(OrderUtil.STATUS_AUTO_CANCEL, order.getOrderStatus()); + assertNotNull(order.getEndTime()); + assertEquals(7, productService.findById(1).getNumber().intValue()); + assertEquals(CouponUserConstant.STATUS_USABLE, couponUserService.findById(1).getStatus()); + } + + @Test + public void mallOrdTimeoutAc02BeIt001_repeatedTaskDoesNotRepeatCompensation() { + timeoutService.closeOrder(1); + timeoutService.closeOrder(1); + + assertEquals(OrderUtil.STATUS_AUTO_CANCEL, orderService.findById(1).getOrderStatus()); + assertEquals(7, productService.findById(1).getNumber().intValue()); + assertEquals(CouponUserConstant.STATUS_USABLE, couponUserService.findById(1).getStatus()); + } + + @Test + public void mallOrdTimeoutAc03BeIt001_stockFailureRollsBackOrderAndCoupon() { + jdbcTemplate.update("update litemall_order_goods set product_id = 9999 where id = 1"); + + boolean failed = false; + try { + timeoutService.closeOrder(1); + } catch (RuntimeException expected) { + failed = true; + } + if (!failed) { + fail("stock failure must be visible to the caller"); + } + + assertEquals(OrderUtil.STATUS_CREATE, orderService.findById(1).getOrderStatus()); + assertEquals(5, productService.findById(1).getNumber().intValue()); + assertEquals(CouponUserConstant.STATUS_USED, couponUserService.findById(1).getStatus()); + } + + public static class Initializer implements ApplicationContextInitializer { + @Override + public void initialize(ConfigurableApplicationContext context) { + TestPropertyValues.of( + "spring.datasource.druid.url=" + mysql.getJdbcUrl(), + "spring.datasource.druid.username=" + mysql.getUsername(), + "spring.datasource.druid.password=" + mysql.getPassword(), + "spring.datasource.druid.driver-class-name=com.mysql.cj.jdbc.Driver", + "pagehelper.helperDialect=mysql" + ).applyTo(context.getEnvironment()); + } + } + + @SpringBootApplication(scanBasePackages = "org.linlinjava.litemall.db") + @Import(OrderTimeoutCompensationService.class) + @MapperScan("org.linlinjava.litemall.db.dao") + public static class DbTestApplication { + public static void main(String[] args) { + SpringApplication.run(DbTestApplication.class, args); + } + } +} diff --git a/Tests/backend/src/test/java/org/linlinjava/litemall/tests/it/PaymentPersistenceIT.java b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/it/PaymentPersistenceIT.java new file mode 100644 index 000000000..4844bdb25 --- /dev/null +++ b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/it/PaymentPersistenceIT.java @@ -0,0 +1,163 @@ +package org.linlinjava.litemall.tests.it; + +import org.junit.Before; +import org.junit.ClassRule; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.linlinjava.litemall.db.domain.LitemallCouponUser; +import org.linlinjava.litemall.db.domain.LitemallGoodsProduct; +import org.linlinjava.litemall.db.domain.LitemallGroupon; +import org.linlinjava.litemall.db.domain.LitemallOrder; +import org.linlinjava.litemall.db.service.LitemallCouponUserService; +import org.linlinjava.litemall.db.service.LitemallGoodsProductService; +import org.linlinjava.litemall.db.service.LitemallGrouponService; +import org.linlinjava.litemall.db.service.LitemallOrderService; +import org.linlinjava.litemall.db.util.CouponUserConstant; +import org.linlinjava.litemall.db.util.GrouponConstant; +import org.linlinjava.litemall.db.util.OrderUtil; +import org.mybatis.spring.annotation.MapperScan; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.util.TestPropertyValues; +import org.springframework.context.ApplicationContextInitializer; +import org.springframework.context.ConfigurableApplicationContext; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; +import org.testcontainers.containers.MySQLContainer; + +import java.time.LocalDateTime; +import java.util.List; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +@RunWith(SpringRunner.class) +@SpringBootTest(classes = PaymentPersistenceIT.DbTestApplication.class) +@ContextConfiguration(initializers = PaymentPersistenceIT.Initializer.class) +public class PaymentPersistenceIT { + + @ClassRule + public static MySQLContainer mysql = new MySQLContainer<>("mysql:8.0") + .withDatabaseName("litemall_test") + .withUsername("litemall") + .withPassword("litemall123456") + .withInitScript("db/litemall-it-schema.sql"); + + @Autowired + private JdbcTemplate jdbcTemplate; + @Autowired + private LitemallGoodsProductService productService; + @Autowired + private LitemallOrderService orderService; + @Autowired + private LitemallCouponUserService couponUserService; + @Autowired + private LitemallGrouponService grouponService; + + @Before + public void resetData() { + jdbcTemplate.update("update litemall_goods_product set number = 5, update_time = now() where id = 1"); + jdbcTemplate.update("update litemall_order set order_status = 101, pay_id = null, pay_time = null, update_time = now() where id = 1"); + jdbcTemplate.update("update litemall_coupon_user set status = 1, used_time = now(), update_time = now(), deleted = 0 where id = 1"); + jdbcTemplate.update("update litemall_groupon set status = 1, deleted = 0 where id in (10, 11)"); + jdbcTemplate.update("update litemall_groupon set status = 0, deleted = 0 where id = 12"); + jdbcTemplate.update("update litemall_groupon set status = 1, deleted = 1 where id = 13"); + } + + @Test + public void mallPayAc06BeIt001_stockCannotGoNegativeAndCanBeRestored() { + assertEquals(1, productService.reduceStock(1, (short) 3)); + assertEquals(2, productService.findById(1).getNumber().intValue()); + + assertEquals(0, productService.reduceStock(1, (short) 10)); + assertEquals(2, productService.findById(1).getNumber().intValue()); + + assertEquals(1, productService.addStock(1, (short) 3)); + assertEquals(5, productService.findById(1).getNumber().intValue()); + } + + @Test + public void mallPayAc05BeIt001_optimisticLockRejectsStaleOrderUpdate() { + LitemallOrder staleCopy = orderService.findById(1); + LitemallOrder freshCopy = orderService.findById(1); + + freshCopy.setOrderStatus(OrderUtil.STATUS_PAY); + assertEquals(1, orderService.updateWithOptimisticLocker(freshCopy)); + jdbcTemplate.update("update litemall_order set update_time = '2026-07-11 10:00:30' where id = 1"); + + staleCopy.setOrderStatus(OrderUtil.STATUS_SHIP); + assertEquals(0, orderService.updateWithOptimisticLocker(staleCopy)); + assertEquals(OrderUtil.STATUS_PAY, orderService.findById(1).getOrderStatus()); + } + + @Test + public void mallPayAc01BeIt001_paidOrderFieldsPersistWithOptimisticLock() { + LitemallOrder order = orderService.findById(1); + LocalDateTime paidAt = LocalDateTime.of(2026, 7, 11, 10, 0); + + order.setOrderStatus(OrderUtil.STATUS_PAY); + order.setPayId("wxpay-001"); + order.setPayTime(paidAt); + + assertEquals(1, orderService.updateWithOptimisticLocker(order)); + + LitemallOrder persisted = orderService.findById(1); + assertEquals(OrderUtil.STATUS_PAY, persisted.getOrderStatus()); + assertEquals("wxpay-001", persisted.getPayId()); + assertNotNull(persisted.getPayTime()); + assertEquals(paidAt, persisted.getPayTime()); + } + + @Test + public void mallPayAc09BeIt001_couponReleasePersistsUsableStatusForOrder() { + List coupons = couponUserService.findByOid(1); + assertEquals(1, coupons.size()); + assertEquals(CouponUserConstant.STATUS_USED, coupons.get(0).getStatus()); + + LitemallCouponUser couponUser = coupons.get(0); + couponUser.setStatus(CouponUserConstant.STATUS_USABLE); + assertEquals(1, couponUserService.update(couponUser)); + + LitemallCouponUser persisted = couponUserService.findById(1); + assertEquals(CouponUserConstant.STATUS_USABLE, persisted.getStatus()); + assertNotNull(persisted.getUpdateTime()); + } + + @Test + public void mallPayAc10BeIt001_grouponQueriesIgnoreNoneAndDeletedRows() { + List joinRecords = grouponService.queryJoinRecord(10); + assertEquals(1, joinRecords.size()); + assertEquals(Integer.valueOf(11), joinRecords.get(0).getId()); + assertEquals(1, grouponService.countGroupon(10)); + + LitemallGroupon byOrder = grouponService.queryByOrderId(2); + byOrder.setStatus(GrouponConstant.STATUS_SUCCEED); + assertEquals(1, grouponService.updateById(byOrder)); + + assertEquals(GrouponConstant.STATUS_SUCCEED, grouponService.queryById(11).getStatus()); + } + + public static class Initializer implements ApplicationContextInitializer { + @Override + public void initialize(ConfigurableApplicationContext context) { + TestPropertyValues.of( + "spring.datasource.druid.url=" + mysql.getJdbcUrl(), + "spring.datasource.druid.username=" + mysql.getUsername(), + "spring.datasource.druid.password=" + mysql.getPassword(), + "spring.datasource.druid.driver-class-name=com.mysql.cj.jdbc.Driver", + "pagehelper.helperDialect=mysql" + ).applyTo(context.getEnvironment()); + } + } + + @SpringBootApplication(scanBasePackages = "org.linlinjava.litemall.db") + @MapperScan("org.linlinjava.litemall.db.dao") + public static class DbTestApplication { + public static void main(String[] args) { + SpringApplication.run(DbTestApplication.class, args); + } + } +} diff --git a/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/OrderTimeoutCompensationServiceUnitTest.java b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/OrderTimeoutCompensationServiceUnitTest.java new file mode 100644 index 000000000..7672af95a --- /dev/null +++ b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/OrderTimeoutCompensationServiceUnitTest.java @@ -0,0 +1,141 @@ +package org.linlinjava.litemall.tests.unit; + +import org.junit.Before; +import org.junit.Test; +import org.linlinjava.litemall.db.domain.LitemallCouponUser; +import org.linlinjava.litemall.db.domain.LitemallOrder; +import org.linlinjava.litemall.db.domain.LitemallOrderGoods; +import org.linlinjava.litemall.db.service.LitemallCouponUserService; +import org.linlinjava.litemall.db.service.LitemallGoodsProductService; +import org.linlinjava.litemall.db.service.LitemallOrderGoodsService; +import org.linlinjava.litemall.db.service.LitemallOrderService; +import org.linlinjava.litemall.db.util.CouponUserConstant; +import org.linlinjava.litemall.db.util.OrderUtil; +import org.linlinjava.litemall.wx.service.OrderTimeoutCompensationService; + +import java.time.LocalDateTime; +import java.util.Collections; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.fail; +import static org.mockito.Mockito.*; + +public class OrderTimeoutCompensationServiceUnitTest { + private LitemallOrderService orderService; + private LitemallOrderGoodsService orderGoodsService; + private LitemallGoodsProductService productService; + private LitemallCouponUserService couponUserService; + private OrderTimeoutCompensationService service; + + @Before + public void setUp() { + orderService = mock(LitemallOrderService.class); + orderGoodsService = mock(LitemallOrderGoodsService.class); + productService = mock(LitemallGoodsProductService.class); + couponUserService = mock(LitemallCouponUserService.class); + service = new OrderTimeoutCompensationService(orderService, orderGoodsService, productService, couponUserService); + } + + @Test + public void mallOrdTimeoutAc01BeUt001_closesOrderAndReleasesResources() { + LitemallOrder order = order(1001, OrderUtil.STATUS_CREATE); + LitemallOrderGoods goods = orderGoods(1, 2); + LitemallCouponUser coupon = coupon(CouponUserConstant.STATUS_USED); + when(orderService.findById(1001)).thenReturn(order); + when(orderService.updateWithOptimisticLocker(order)).thenReturn(1); + when(orderGoodsService.queryByOid(1001)).thenReturn(Collections.singletonList(goods)); + when(productService.addStock(1, (short) 2)).thenReturn(1); + when(couponUserService.findByOid(1001)).thenReturn(Collections.singletonList(coupon)); + when(couponUserService.update(coupon)).thenReturn(1); + + service.closeOrder(1001); + + assertEquals(OrderUtil.STATUS_AUTO_CANCEL, order.getOrderStatus()); + assertNotNull(order.getEndTime()); + assertEquals(CouponUserConstant.STATUS_USABLE, coupon.getStatus()); + verify(productService).addStock(1, (short) 2); + verify(couponUserService).update(coupon); + } + + @Test + public void mallOrdTimeoutAc02BeUt001_terminalOrderIsSkippedWithoutSideEffects() { + LitemallOrder order = order(1001, OrderUtil.STATUS_AUTO_CANCEL); + when(orderService.findById(1001)).thenReturn(order); + + service.closeOrder(1001); + + verify(orderService, never()).updateWithOptimisticLocker(any(LitemallOrder.class)); + verifyNoInteractions(orderGoodsService, productService, couponUserService); + } + + @Test + public void mallOrdTimeoutAc03BeUt001_stockFailureIsPropagatedBeforeCouponRelease() { + LitemallOrder order = order(1001, OrderUtil.STATUS_CREATE); + LitemallOrderGoods goods = orderGoods(1, 2); + when(orderService.findById(1001)).thenReturn(order); + when(orderService.updateWithOptimisticLocker(order)).thenReturn(1); + when(orderGoodsService.queryByOid(1001)).thenReturn(Collections.singletonList(goods)); + when(productService.addStock(1, (short) 2)).thenReturn(0); + + try { + service.closeOrder(1001); + fail("stock failure must fail the transaction boundary"); + } catch (RuntimeException expected) { + assertEquals("商品货品库存增加失败", expected.getMessage()); + } + + verifyNoInteractions(couponUserService); + } + + @Test + public void mallOrdTimeoutAc06BeUt001_optimisticLockLossIsSafeSkip() { + LitemallOrder order = order(1001, OrderUtil.STATUS_CREATE); + when(orderService.findById(1001)).thenReturn(order); + when(orderService.updateWithOptimisticLocker(order)).thenReturn(0); + + service.closeOrder(1001); + + verifyNoInteractions(orderGoodsService, productService, couponUserService); + } + + @Test + public void mallOrdTimeoutAc04BeUt001_couponFailureIsPropagated() { + LitemallOrder order = order(1001, OrderUtil.STATUS_CREATE); + LitemallCouponUser coupon = coupon(CouponUserConstant.STATUS_USED); + when(orderService.findById(1001)).thenReturn(order); + when(orderService.updateWithOptimisticLocker(order)).thenReturn(1); + when(orderGoodsService.queryByOid(1001)).thenReturn(Collections.emptyList()); + when(couponUserService.findByOid(1001)).thenReturn(Collections.singletonList(coupon)); + when(couponUserService.update(coupon)).thenReturn(0); + + try { + service.closeOrder(1001); + fail("coupon failure must fail the transaction boundary"); + } catch (RuntimeException expected) { + assertEquals("优惠券返还失败", expected.getMessage()); + } + } + + private LitemallOrder order(Integer id, Short status) { + LitemallOrder order = new LitemallOrder(); + order.setId(id); + order.setOrderStatus(status); + order.setUpdateTime(LocalDateTime.of(2026, 7, 11, 10, 0)); + return order; + } + + private LitemallOrderGoods orderGoods(Integer productId, int number) { + LitemallOrderGoods goods = new LitemallOrderGoods(); + goods.setProductId(productId); + goods.setNumber((short) number); + return goods; + } + + private LitemallCouponUser coupon(Short status) { + LitemallCouponUser coupon = new LitemallCouponUser(); + coupon.setStatus(status); + coupon.setOrderId(1001); + return coupon; + } +} diff --git a/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/OrderUnpaidTaskUnitTest.java b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/OrderUnpaidTaskUnitTest.java new file mode 100644 index 000000000..3c575968e --- /dev/null +++ b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/OrderUnpaidTaskUnitTest.java @@ -0,0 +1,45 @@ +package org.linlinjava.litemall.tests.unit; + +import org.junit.Test; +import org.linlinjava.litemall.wx.service.OrderTimeoutCompensationService; +import org.linlinjava.litemall.wx.task.OrderUnpaidTask; + +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.doThrow; +import static org.mockito.Mockito.verify; + +public class OrderUnpaidTaskUnitTest { + + @Test + public void runDelegatesToTimeoutCompensationService() { + OrderTimeoutCompensationService service = mock(OrderTimeoutCompensationService.class); + OrderUnpaidTask task = new TestableOrderUnpaidTask(1001, service); + + task.run(); + + verify(service).closeOrder(1001); + } + + @Test(expected = IllegalStateException.class) + public void runPropagatesCompensationFailure() { + OrderTimeoutCompensationService service = mock(OrderTimeoutCompensationService.class); + doThrow(new IllegalStateException("database unavailable")) + .when(service).closeOrder(1001); + + new TestableOrderUnpaidTask(1001, service).run(); + } + + private static class TestableOrderUnpaidTask extends OrderUnpaidTask { + private final OrderTimeoutCompensationService service; + + private TestableOrderUnpaidTask(Integer orderId, OrderTimeoutCompensationService service) { + super(orderId, 0); + this.service = service; + } + + @Override + protected OrderTimeoutCompensationService getCompensationService() { + return service; + } + } +} diff --git a/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/OrderUtilUnitTest.java b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/OrderUtilUnitTest.java new file mode 100644 index 000000000..67aa1ce05 --- /dev/null +++ b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/OrderUtilUnitTest.java @@ -0,0 +1,49 @@ +package org.linlinjava.litemall.tests.unit; + +import org.junit.Test; +import org.linlinjava.litemall.db.domain.LitemallOrder; +import org.linlinjava.litemall.db.util.OrderHandleOption; +import org.linlinjava.litemall.db.util.OrderUtil; + +import static org.junit.Assert.*; + +public class OrderUtilUnitTest { + + @Test + public void mallPayAc02BeUt001_hasPayedReturnsFalseOnlyForUnpaidAndCancelledOrders() { + assertFalse(OrderUtil.hasPayed(order(OrderUtil.STATUS_CREATE))); + assertFalse(OrderUtil.hasPayed(order(OrderUtil.STATUS_CANCEL))); + assertFalse(OrderUtil.hasPayed(order(OrderUtil.STATUS_AUTO_CANCEL))); + + assertTrue(OrderUtil.hasPayed(order(OrderUtil.STATUS_PAY))); + assertTrue(OrderUtil.hasPayed(order(OrderUtil.STATUS_SHIP))); + assertTrue(OrderUtil.hasPayed(order(OrderUtil.STATUS_CONFIRM))); + } + + @Test + public void mallPayAc01BeUt002_createStatusAllowsPayAndCancelOnly() { + OrderHandleOption option = OrderUtil.build(order(OrderUtil.STATUS_CREATE)); + + assertTrue(option.isPay()); + assertTrue(option.isCancel()); + assertFalse(option.isRefund()); + assertFalse(option.isConfirm()); + assertFalse(option.isDelete()); + } + + @Test + public void mallPayAc01BeUt003_paidStatusAllowsRefundButNotPayAgain() { + OrderHandleOption option = OrderUtil.build(order(OrderUtil.STATUS_PAY)); + + assertTrue(option.isRefund()); + assertFalse(option.isPay()); + assertFalse(option.isCancel()); + assertFalse(option.isConfirm()); + } + + private LitemallOrder order(Short status) { + LitemallOrder order = new LitemallOrder(); + order.setOrderStatus(status); + return order; + } +} diff --git a/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/WxOrderLifecycleUnitTest.java b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/WxOrderLifecycleUnitTest.java new file mode 100644 index 000000000..94e019d3a --- /dev/null +++ b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/WxOrderLifecycleUnitTest.java @@ -0,0 +1,147 @@ +package org.linlinjava.litemall.tests.unit; + +import org.junit.Before; +import org.junit.Test; +import org.linlinjava.litemall.core.notify.NotifyService; +import org.linlinjava.litemall.db.domain.LitemallCouponUser; +import org.linlinjava.litemall.db.domain.LitemallOrder; +import org.linlinjava.litemall.db.domain.LitemallOrderGoods; +import org.linlinjava.litemall.db.service.LitemallCouponUserService; +import org.linlinjava.litemall.db.service.LitemallGoodsProductService; +import org.linlinjava.litemall.db.service.LitemallOrderGoodsService; +import org.linlinjava.litemall.db.service.LitemallOrderService; +import org.linlinjava.litemall.db.util.CouponUserConstant; +import org.linlinjava.litemall.db.util.OrderUtil; +import org.linlinjava.litemall.wx.service.WxOrderService; +import org.springframework.test.util.ReflectionTestUtils; + +import java.time.LocalDateTime; +import java.util.Collections; +import java.util.Map; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.*; + +public class WxOrderLifecycleUnitTest { + private WxOrderService service; + private LitemallOrderService orderService; + private LitemallOrderGoodsService orderGoodsService; + private LitemallGoodsProductService productService; + private LitemallCouponUserService couponUserService; + private NotifyService notifyService; + + @Before + public void setUp() { + service = new WxOrderService(); + orderService = mock(LitemallOrderService.class); + orderGoodsService = mock(LitemallOrderGoodsService.class); + productService = mock(LitemallGoodsProductService.class); + couponUserService = mock(LitemallCouponUserService.class); + notifyService = mock(NotifyService.class); + + ReflectionTestUtils.setField(service, "orderService", orderService); + ReflectionTestUtils.setField(service, "orderGoodsService", orderGoodsService); + ReflectionTestUtils.setField(service, "productService", productService); + ReflectionTestUtils.setField(service, "couponUserService", couponUserService); + ReflectionTestUtils.setField(service, "notifyService", notifyService); + } + + @Test + public void mallPayAc09BeUt001_cancelUnpaidOrderRestoresStockAndReleasesCoupon() { + LitemallOrder order = order(1, 1001, OrderUtil.STATUS_CREATE); + LitemallOrderGoods orderGoods = orderGoods(1, 2); + LitemallCouponUser couponUser = couponUser(501, CouponUserConstant.STATUS_USED); + + when(orderService.findById(1, 1001)).thenReturn(order); + when(orderService.updateWithOptimisticLocker(order)).thenReturn(1); + when(orderGoodsService.queryByOid(1001)).thenReturn(Collections.singletonList(orderGoods)); + when(productService.addStock(1, (short) 2)).thenReturn(1); + when(couponUserService.findByOid(1001)).thenReturn(Collections.singletonList(couponUser)); + when(couponUserService.update(couponUser)).thenReturn(1); + + Map response = responseMap(service.cancel(1, "{\"orderId\":1001}")); + + assertEquals(0, response.get("errno")); + assertEquals(OrderUtil.STATUS_CANCEL, order.getOrderStatus()); + assertNotNull(order.getEndTime()); + assertEquals(CouponUserConstant.STATUS_USABLE, couponUser.getStatus()); + assertNotNull(couponUser.getUpdateTime()); + verify(productService).addStock(1, (short) 2); + verify(couponUserService).update(couponUser); + } + + @Test + public void mallPayAc09BeUt002_paidOrderCannotUseCancelCompensationPath() { + LitemallOrder order = order(1, 1001, OrderUtil.STATUS_PAY); + when(orderService.findById(1, 1001)).thenReturn(order); + + Map response = responseMap(service.cancel(1, "{\"orderId\":1001}")); + + assertEquals(725, response.get("errno")); + assertEquals("订单不能取消", response.get("errmsg")); + assertEquals(OrderUtil.STATUS_PAY, order.getOrderStatus()); + verify(orderService, never()).updateWithOptimisticLocker(order); + verify(productService, never()).addStock(anyInt(), anyShort()); + verify(couponUserService, never()).findByOid(1001); + } + + @Test + public void mallPayAc12BeUt001_refundPaidOrderMovesToRefundStatusAndNotifiesOps() { + LitemallOrder order = order(1, 1001, OrderUtil.STATUS_PAY); + when(orderService.findById(1, 1001)).thenReturn(order); + when(orderService.updateWithOptimisticLocker(order)).thenReturn(1); + + Map response = responseMap(service.refund(1, "{\"orderId\":1001}")); + + assertEquals(0, response.get("errno")); + assertEquals(OrderUtil.STATUS_REFUND, order.getOrderStatus()); + verify(notifyService).notifyMail(eq("退款申请"), anyString()); + } + + @Test + public void mallPayAc12BeUt002_unpaidOrderCannotApplyRefund() { + LitemallOrder order = order(1, 1001, OrderUtil.STATUS_CREATE); + when(orderService.findById(1, 1001)).thenReturn(order); + + Map response = responseMap(service.refund(1, "{\"orderId\":1001}")); + + assertEquals(725, response.get("errno")); + assertEquals("订单不能取消", response.get("errmsg")); + assertEquals(OrderUtil.STATUS_CREATE, order.getOrderStatus()); + verify(orderService, never()).updateWithOptimisticLocker(order); + verify(notifyService, never()).notifyMail(anyString(), anyString()); + } + + @SuppressWarnings("unchecked") + private Map responseMap(Object response) { + return (Map) response; + } + + private LitemallOrder order(Integer userId, Integer orderId, Short status) { + LitemallOrder order = new LitemallOrder(); + order.setId(orderId); + order.setUserId(userId); + order.setOrderSn("20260711000001"); + order.setOrderStatus(status); + order.setMobile("13800000000"); + order.setUpdateTime(LocalDateTime.of(2026, 7, 11, 10, 0)); + return order; + } + + private LitemallOrderGoods orderGoods(Integer productId, int number) { + LitemallOrderGoods orderGoods = new LitemallOrderGoods(); + orderGoods.setProductId(productId); + orderGoods.setNumber((short) number); + return orderGoods; + } + + private LitemallCouponUser couponUser(Integer id, Short status) { + LitemallCouponUser couponUser = new LitemallCouponUser(); + couponUser.setId(id); + couponUser.setStatus(status); + couponUser.setOrderId(1001); + return couponUser; + } +} diff --git a/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/WxOrderPayNotifyUnitTest.java b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/WxOrderPayNotifyUnitTest.java new file mode 100644 index 000000000..f79a1f507 --- /dev/null +++ b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/WxOrderPayNotifyUnitTest.java @@ -0,0 +1,250 @@ +package org.linlinjava.litemall.tests.unit; + +import com.github.binarywang.wxpay.bean.notify.WxPayOrderNotifyResult; +import com.github.binarywang.wxpay.constant.WxPayConstants; +import com.github.binarywang.wxpay.exception.WxPayException; +import com.github.binarywang.wxpay.service.WxPayService; +import org.junit.Before; +import org.junit.Test; +import org.linlinjava.litemall.core.notify.NotifyService; +import org.linlinjava.litemall.core.qcode.QCodeService; +import org.linlinjava.litemall.core.system.SystemConfig; +import org.linlinjava.litemall.core.task.TaskService; +import org.linlinjava.litemall.db.domain.LitemallGroupon; +import org.linlinjava.litemall.db.domain.LitemallGrouponRules; +import org.linlinjava.litemall.db.domain.LitemallOrder; +import org.linlinjava.litemall.db.service.LitemallGrouponService; +import org.linlinjava.litemall.db.service.LitemallGrouponRulesService; +import org.linlinjava.litemall.db.util.GrouponConstant; +import org.linlinjava.litemall.db.service.LitemallOrderService; +import org.linlinjava.litemall.db.util.OrderUtil; +import org.linlinjava.litemall.wx.service.WxOrderService; +import org.springframework.mock.web.MockHttpServletRequest; +import org.springframework.mock.web.MockHttpServletResponse; +import org.springframework.test.util.ReflectionTestUtils; + +import java.math.BigDecimal; +import java.nio.charset.StandardCharsets; +import java.time.LocalDateTime; +import java.util.Collections; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.*; + +public class WxOrderPayNotifyUnitTest { + private WxOrderService service; + private WxPayService wxPayService; + private LitemallOrderService orderService; + private NotifyService notifyService; + private TaskService taskService; + private LitemallGrouponService grouponService; + private LitemallGrouponRulesService grouponRulesService; + private QCodeService qCodeService; + + @Before + public void setUp() { + service = new WxOrderService(); + wxPayService = mock(WxPayService.class); + orderService = mock(LitemallOrderService.class); + notifyService = mock(NotifyService.class); + taskService = mock(TaskService.class); + grouponService = mock(LitemallGrouponService.class); + grouponRulesService = mock(LitemallGrouponRulesService.class); + qCodeService = mock(QCodeService.class); + + ReflectionTestUtils.setField(service, "wxPayService", wxPayService); + ReflectionTestUtils.setField(service, "orderService", orderService); + ReflectionTestUtils.setField(service, "notifyService", notifyService); + ReflectionTestUtils.setField(service, "taskService", taskService); + ReflectionTestUtils.setField(service, "grouponService", grouponService); + ReflectionTestUtils.setField(service, "grouponRulesService", grouponRulesService); + ReflectionTestUtils.setField(service, "qCodeService", qCodeService); + SystemConfig.setConfigs(Collections.singletonMap(SystemConfig.LITEMALL_ORDER_UNPAID, "30")); + } + + @Test + public void mallPayAc01BeUt001_successCallbackMarksUnpaidOrderAsPaid() throws Exception { + LitemallOrder order = unpaidOrder("20260711000001", "100.00"); + when(wxPayService.parseOrderNotifyResult(anyString())).thenReturn(notifyResult("20260711000001", "wxpay-001", 10000)); + when(orderService.findBySn("20260711000001")).thenReturn(order); + when(orderService.updateWithOptimisticLocker(order)).thenReturn(1); + + Object response = service.payNotify(xmlRequest(), new MockHttpServletResponse()); + + assertTrue(response.toString().contains("SUCCESS")); + assertEquals(OrderUtil.STATUS_PAY, order.getOrderStatus()); + assertEquals("wxpay-001", order.getPayId()); + verify(orderService).updateWithOptimisticLocker(order); + verify(taskService).removeTask(any()); + verify(notifyService).notifyMail(eq("新订单通知"), anyString()); + } + + @Test + public void mallPayAc02BeUt001_duplicateCallbackReturnsSuccessWithoutSecondUpdate() throws Exception { + LitemallOrder order = unpaidOrder("20260711000001", "100.00"); + order.setOrderStatus(OrderUtil.STATUS_PAY); + when(wxPayService.parseOrderNotifyResult(anyString())).thenReturn(notifyResult("20260711000001", "wxpay-001", 10000)); + when(orderService.findBySn("20260711000001")).thenReturn(order); + + Object response = service.payNotify(xmlRequest(), new MockHttpServletResponse()); + + assertTrue(response.toString().contains("SUCCESS")); + verify(orderService, never()).updateWithOptimisticLocker(any()); + verify(taskService, never()).removeTask(any()); + } + + @Test + public void mallPayAc03BeUt001_amountMismatchFailsAndDoesNotMutateOrder() throws Exception { + LitemallOrder order = unpaidOrder("20260711000001", "100.00"); + when(wxPayService.parseOrderNotifyResult(anyString())).thenReturn(notifyResult("20260711000001", "wxpay-001", 9900)); + when(orderService.findBySn("20260711000001")).thenReturn(order); + + Object response = service.payNotify(xmlRequest(), new MockHttpServletResponse()); + + assertTrue(response.toString().contains("FAIL")); + assertEquals(OrderUtil.STATUS_CREATE, order.getOrderStatus()); + verify(orderService, never()).updateWithOptimisticLocker(any()); + verify(taskService, never()).removeTask(any()); + } + + @Test + public void mallPayAc04BeUt001_parseFailureReturnsFailBeforeOrderLookup() throws Exception { + when(wxPayService.parseOrderNotifyResult(anyString())).thenThrow(new WxPayException("signature invalid")); + + Object response = service.payNotify(xmlRequest(), new MockHttpServletResponse()); + + assertTrue(response.toString().contains("FAIL")); + assertTrue(response.toString().contains("signature invalid")); + verify(orderService, never()).findBySn(anyString()); + verify(orderService, never()).updateWithOptimisticLocker(any()); + verify(taskService, never()).removeTask(any()); + verify(notifyService, never()).notifyMail(anyString(), anyString()); + } + + @Test + public void mallPayAc04BeUt002_missingOrderReturnsFailWithoutMutation() throws Exception { + when(wxPayService.parseOrderNotifyResult(anyString())).thenReturn(notifyResult("20260711000002", "wxpay-002", 10000)); + when(orderService.findBySn("20260711000002")).thenReturn(null); + + Object response = service.payNotify(xmlRequest(), new MockHttpServletResponse()); + + assertTrue(response.toString().contains("FAIL")); + assertTrue(response.toString().contains("订单不存在")); + verify(orderService, never()).updateWithOptimisticLocker(any()); + verify(taskService, never()).removeTask(any()); + verify(notifyService, never()).notifyMail(anyString(), anyString()); + } + + @Test + public void mallPayAc05BeUt001_optimisticLockFailureStopsNotificationAndTaskRemoval() throws Exception { + LitemallOrder order = unpaidOrder("20260711000001", "100.00"); + when(wxPayService.parseOrderNotifyResult(anyString())).thenReturn(notifyResult("20260711000001", "wxpay-001", 10000)); + when(orderService.findBySn("20260711000001")).thenReturn(order); + when(orderService.updateWithOptimisticLocker(order)).thenReturn(0); + + Object response = service.payNotify(xmlRequest(), new MockHttpServletResponse()); + + assertTrue(response.toString().contains("FAIL")); + assertTrue(response.toString().contains("更新数据已失效")); + verify(orderService).updateWithOptimisticLocker(order); + verify(taskService, never()).removeTask(any()); + verify(notifyService, never()).notifyMail(anyString(), anyString()); + } + + @Test + public void mallPayAc10BeUt001_paidJoinCompletesGrouponWhenMemberThresholdReached() throws Exception { + LitemallOrder order = unpaidOrder("20260711000001", "100.00"); + LitemallGroupon joiner = groupon(12, 1001, 10, 7, GrouponConstant.STATUS_NONE); + LitemallGroupon source = groupon(10, 999, 0, 7, GrouponConstant.STATUS_ON); + LitemallGrouponRules rules = grouponRules(7, 2); + + when(wxPayService.parseOrderNotifyResult(anyString())).thenReturn(notifyResult("20260711000001", "wxpay-001", 10000)); + when(orderService.findBySn("20260711000001")).thenReturn(order); + when(orderService.updateWithOptimisticLocker(order)).thenReturn(1); + when(grouponService.queryByOrderId(1001)).thenReturn(joiner); + when(grouponRulesService.findById(7)).thenReturn(rules); + when(grouponService.updateById(any(LitemallGroupon.class))).thenReturn(1); + when(grouponService.queryJoinRecord(10)).thenReturn(Collections.singletonList(joiner)); + when(grouponService.queryById(10)).thenReturn(source); + + Object response = service.payNotify(xmlRequest(), new MockHttpServletResponse()); + + assertTrue(response.toString().contains("SUCCESS")); + assertEquals(GrouponConstant.STATUS_SUCCEED, joiner.getStatus()); + assertEquals(GrouponConstant.STATUS_SUCCEED, source.getStatus()); + verify(grouponService, times(3)).updateById(any(LitemallGroupon.class)); + } + + @Test + public void mallPayAc10BeUt002_groupOwnerCreatesShareImageAfterPayment() throws Exception { + LitemallOrder order = unpaidOrder("20260711000001", "100.00"); + LitemallGroupon owner = groupon(10, 1001, 0, 7, GrouponConstant.STATUS_NONE); + LitemallGrouponRules rules = grouponRules(7, 2); + rules.setGoodsName("测试团购商品"); + rules.setPicUrl("https://example.test/goods.png"); + + when(wxPayService.parseOrderNotifyResult(anyString())).thenReturn(notifyResult("20260711000001", "wxpay-001", 10000)); + when(orderService.findBySn("20260711000001")).thenReturn(order); + when(orderService.updateWithOptimisticLocker(order)).thenReturn(1); + when(grouponService.queryByOrderId(1001)).thenReturn(owner); + when(grouponRulesService.findById(7)).thenReturn(rules); + when(qCodeService.createGrouponShareImage("测试团购商品", "https://example.test/goods.png", owner)).thenReturn("/storage/groupon-share.png"); + when(grouponService.updateById(owner)).thenReturn(1); + when(grouponService.queryJoinRecord(0)).thenReturn(Collections.emptyList()); + + Object response = service.payNotify(xmlRequest(), new MockHttpServletResponse()); + + assertTrue(response.toString().contains("SUCCESS")); + assertEquals(GrouponConstant.STATUS_ON, owner.getStatus()); + assertEquals("/storage/groupon-share.png", owner.getShareUrl()); + verify(qCodeService).createGrouponShareImage("测试团购商品", "https://example.test/goods.png", owner); + } + + private MockHttpServletRequest xmlRequest() { + MockHttpServletRequest request = new MockHttpServletRequest(); + request.setCharacterEncoding("UTF-8"); + request.setContent("SUCCESS".getBytes(StandardCharsets.UTF_8)); + return request; + } + + private WxPayOrderNotifyResult notifyResult(String orderSn, String transactionId, int totalFee) { + WxPayOrderNotifyResult result = new WxPayOrderNotifyResult(); + result.setReturnCode(WxPayConstants.ResultCode.SUCCESS); + result.setResultCode(WxPayConstants.ResultCode.SUCCESS); + result.setOutTradeNo(orderSn); + result.setTransactionId(transactionId); + result.setTotalFee(totalFee); + return result; + } + + private LitemallOrder unpaidOrder(String orderSn, String actualPrice) { + LitemallOrder order = new LitemallOrder(); + order.setId(1001); + order.setOrderSn(orderSn); + order.setOrderStatus(OrderUtil.STATUS_CREATE); + order.setActualPrice(new BigDecimal(actualPrice)); + order.setMobile("13800000000"); + order.setUpdateTime(LocalDateTime.now()); + return order; + } + + private LitemallGroupon groupon(Integer id, Integer orderId, Integer grouponId, Integer rulesId, Short status) { + LitemallGroupon groupon = new LitemallGroupon(); + groupon.setId(id); + groupon.setOrderId(orderId); + groupon.setGrouponId(grouponId); + groupon.setRulesId(rulesId); + groupon.setStatus(status); + return groupon; + } + + private LitemallGrouponRules grouponRules(Integer id, Integer discountMember) { + LitemallGrouponRules rules = new LitemallGrouponRules(); + rules.setId(id); + rules.setDiscountMember(discountMember); + return rules; + } +} diff --git a/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/WxProductBrowsingUnitTest.java b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/WxProductBrowsingUnitTest.java new file mode 100644 index 000000000..76e428731 --- /dev/null +++ b/Tests/backend/src/test/java/org/linlinjava/litemall/tests/unit/WxProductBrowsingUnitTest.java @@ -0,0 +1,373 @@ +package org.linlinjava.litemall.tests.unit; + +import org.junit.Before; +import org.junit.Test; +import org.linlinjava.litemall.core.system.SystemConfig; +import org.linlinjava.litemall.db.domain.*; +import org.linlinjava.litemall.db.service.*; +import org.linlinjava.litemall.wx.service.HomeCacheManager; +import org.linlinjava.litemall.wx.service.WxGrouponRuleService; +import org.linlinjava.litemall.wx.web.WxGoodsController; +import org.linlinjava.litemall.wx.web.WxHomeController; +import org.mockito.ArgumentCaptor; +import org.springframework.test.util.ReflectionTestUtils; + +import java.math.BigDecimal; +import java.util.*; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.*; + +public class WxProductBrowsingUnitTest { + private WxHomeController homeController; + private WxGoodsController goodsController; + private LitemallAdService adService; + private LitemallGoodsService goodsService; + private LitemallBrandService brandService; + private LitemallTopicService topicService; + private LitemallCategoryService categoryService; + private WxGrouponRuleService grouponRuleService; + private LitemallCouponService couponService; + private LitemallGoodsProductService productService; + private LitemallIssueService issueService; + private LitemallGoodsAttributeService attributeService; + private LitemallCommentService commentService; + private LitemallUserService userService; + private LitemallCollectService collectService; + private LitemallFootprintService footprintService; + private LitemallSearchHistoryService searchHistoryService; + private LitemallGoodsSpecificationService specificationService; + private LitemallGrouponRulesService grouponRulesService; + + @Before + public void setUp() { + HomeCacheManager.clearAll(); + Map configs = new HashMap<>(); + configs.put(SystemConfig.LITEMALL_WX_INDEX_NEW, "2"); + configs.put(SystemConfig.LITEMALL_WX_INDEX_HOT, "2"); + configs.put(SystemConfig.LITEMALL_WX_INDEX_BRAND, "1"); + configs.put(SystemConfig.LITEMALL_WX_INDEX_TOPIC, "1"); + configs.put(SystemConfig.LITEMALL_WX_INDEX_CATLOG_LIST, "2"); + configs.put(SystemConfig.LITEMALL_WX_INDEX_CATLOG_GOODS, "4"); + configs.put(SystemConfig.LITEMALL_WX_SHARE, "false"); + SystemConfig.setConfigs(configs); + + homeController = new WxHomeController(); + goodsController = new WxGoodsController(); + adService = mock(LitemallAdService.class); + goodsService = mock(LitemallGoodsService.class); + brandService = mock(LitemallBrandService.class); + topicService = mock(LitemallTopicService.class); + categoryService = mock(LitemallCategoryService.class); + grouponRuleService = mock(WxGrouponRuleService.class); + couponService = mock(LitemallCouponService.class); + productService = mock(LitemallGoodsProductService.class); + issueService = mock(LitemallIssueService.class); + attributeService = mock(LitemallGoodsAttributeService.class); + commentService = mock(LitemallCommentService.class); + userService = mock(LitemallUserService.class); + collectService = mock(LitemallCollectService.class); + footprintService = mock(LitemallFootprintService.class); + searchHistoryService = mock(LitemallSearchHistoryService.class); + specificationService = mock(LitemallGoodsSpecificationService.class); + grouponRulesService = mock(LitemallGrouponRulesService.class); + + ReflectionTestUtils.setField(homeController, "adService", adService); + ReflectionTestUtils.setField(homeController, "goodsService", goodsService); + ReflectionTestUtils.setField(homeController, "brandService", brandService); + ReflectionTestUtils.setField(homeController, "topicService", topicService); + ReflectionTestUtils.setField(homeController, "categoryService", categoryService); + ReflectionTestUtils.setField(homeController, "grouponService", grouponRuleService); + ReflectionTestUtils.setField(homeController, "couponService", couponService); + + ReflectionTestUtils.setField(goodsController, "goodsService", goodsService); + ReflectionTestUtils.setField(goodsController, "productService", productService); + ReflectionTestUtils.setField(goodsController, "goodsIssueService", issueService); + ReflectionTestUtils.setField(goodsController, "goodsAttributeService", attributeService); + ReflectionTestUtils.setField(goodsController, "brandService", brandService); + ReflectionTestUtils.setField(goodsController, "commentService", commentService); + ReflectionTestUtils.setField(goodsController, "userService", userService); + ReflectionTestUtils.setField(goodsController, "collectService", collectService); + ReflectionTestUtils.setField(goodsController, "footprintService", footprintService); + ReflectionTestUtils.setField(goodsController, "categoryService", categoryService); + ReflectionTestUtils.setField(goodsController, "searchHistoryService", searchHistoryService); + ReflectionTestUtils.setField(goodsController, "goodsSpecificationService", specificationService); + ReflectionTestUtils.setField(goodsController, "rulesService", grouponRulesService); + } + + @Test + public void mallBrowseAc01BeUt001_homeIndexAggregatesMerchandisingBlocksForGuest() { + LitemallGoods newGoods = goods(100, "青瓷杯", 20); + LitemallGoods hotGoods = goods(101, "手冲壶", 20); + LitemallCategory parent = category(10, 0, "茶器"); + LitemallCategory child = category(20, 10, "茶杯"); + List floorGoods = Collections.singletonList(newGoods); + + when(adService.queryIndex()).thenReturn(Collections.singletonList(new LitemallAd())); + when(categoryService.queryChannel()).thenReturn(Collections.singletonList(parent)); + when(couponService.queryList(0, 3)).thenReturn(Collections.singletonList(new LitemallCoupon())); + when(goodsService.queryByNew(0, 2)).thenReturn(Collections.singletonList(newGoods)); + when(goodsService.queryByHot(0, 2)).thenReturn(Collections.singletonList(hotGoods)); + when(brandService.query(0, 1)).thenReturn(Collections.singletonList(new LitemallBrand())); + when(topicService.queryList(0, 1)).thenReturn(Collections.singletonList(new LitemallTopic())); + when(grouponRuleService.queryList(0, 5)).thenReturn(Collections.emptyList()); + when(categoryService.queryL1WithoutRecommend(0, 2)).thenReturn(Collections.singletonList(parent)); + when(categoryService.queryByPid(10)).thenReturn(Collections.singletonList(child)); + when(goodsService.queryByCategory(Collections.singletonList(20), 0, 4)).thenReturn(floorGoods); + + Map response = responseMap(homeController.index(null)); + Map data = responseData(response); + List> floorGoodsList = cast(data.get("floorGoodsList")); + + assertEquals(0, response.get("errno")); + assertEquals(Collections.singletonList(newGoods), data.get("newGoodsList")); + assertEquals(Collections.singletonList(hotGoods), data.get("hotGoodsList")); + assertEquals(Collections.singletonList(parent), data.get("channel")); + assertEquals("茶器", floorGoodsList.get(0).get("name")); + assertEquals(floorGoods, floorGoodsList.get(0).get("goodsList")); + verify(couponService).queryList(0, 3); + verify(couponService, never()).queryAvailableList(anyInt(), anyInt(), anyInt()); + } + + @Test + public void mallBrowseAc01BeUt002_homeIndexUsesUserAvailableCouponsWhenLoggedIn() { + stubEmptyHomeBlocks(); + + Map response = responseMap(homeController.index(7)); + + assertEquals(0, response.get("errno")); + verify(couponService).queryAvailableList(7, 0, 3); + verify(couponService, never()).queryList(0, 3); + } + + @Test + public void mallBrowseAc02BeUt001_goodsListKeepsFiltersPaginationAndSearchHistory() { + LitemallGoods goods = goods(100, "青瓷杯", 20); + LitemallCategory filterCategory = category(20, 10, "茶杯"); + List categoryIds = Collections.singletonList(20); + + when(goodsService.querySelective(10, 5, "青瓷", false, true, 3, 8, "name", "asc")) + .thenReturn(Collections.singletonList(goods)); + when(goodsService.getCatIds(5, "青瓷", false, true)).thenReturn(categoryIds); + when(categoryService.queryL2ByIds(categoryIds)).thenReturn(Collections.singletonList(filterCategory)); + + Map response = responseMap( + goodsController.list(10, 5, "青瓷", true, false, 7, 3, 8, "name", "asc") + ); + Map data = responseData(response); + ArgumentCaptor searchCaptor = ArgumentCaptor.forClass(LitemallSearchHistory.class); + + assertEquals(0, response.get("errno")); + assertEquals(Collections.singletonList(goods), data.get("list")); + assertEquals(Collections.singletonList(filterCategory), data.get("filterCategoryList")); + verify(searchHistoryService).save(searchCaptor.capture()); + assertEquals(Integer.valueOf(7), searchCaptor.getValue().getUserId()); + assertEquals("青瓷", searchCaptor.getValue().getKeyword()); + assertEquals("wx", searchCaptor.getValue().getFrom()); + } + + @Test + public void mallBrowseAc03BeUt001_goodsDetailReturnsMerchandisingDataAndTracksLoggedInFootprint() { + LitemallGoods goods = goods(100, "青瓷杯", 20); + goods.setBrandId(5); + goods.setShareUrl("https://cdn.example.test/share/goods-100.png"); + LitemallGoodsProduct product = product(9001, 100, "天青色", "88.00", 12); + LitemallGoodsAttribute attribute = attribute("材质", "瓷"); + LitemallIssue issue = issue("如何保养?"); + LitemallBrand brand = brand(5, "器物集"); + LitemallComment comment = comment(301, 17, "手感很好"); + LitemallUser user = user(17, "summer"); + Map specification = new HashMap<>(); + specification.put("name", "颜色"); + specification.put("valueList", Collections.singletonList("天青色")); + + when(goodsService.findById(100)).thenReturn(goods); + when(attributeService.queryByGid(100)).thenReturn(Collections.singletonList(attribute)); + when(specificationService.getSpecificationVoList(100)).thenReturn(Collections.singletonList(specification)); + when(productService.queryByGid(100)).thenReturn(Collections.singletonList(product)); + when(issueService.querySelective("", 1, 4, "", "")).thenReturn(Collections.singletonList(issue)); + when(brandService.findById(5)).thenReturn(brand); + when(commentService.queryGoodsByGid(100, 0, 2)).thenReturn(Collections.singletonList(comment)); + when(userService.findById(17)).thenReturn(user); + when(grouponRulesService.queryByGoodsId(100)).thenReturn(Collections.emptyList()); + when(collectService.count(7, (byte) 0, 100)).thenReturn(1); + + Map response = responseMap(goodsController.detail(7, 100)); + Map data = responseData(response); + ArgumentCaptor footprintCaptor = ArgumentCaptor.forClass(LitemallFootprint.class); + + assertEquals(0, response.get("errno")); + assertEquals(goods, data.get("info")); + assertEquals(1, data.get("userHasCollect")); + assertEquals(Collections.singletonList(product), data.get("productList")); + assertEquals(Collections.singletonList(attribute), data.get("attribute")); + assertEquals(brand, data.get("brand")); + assertEquals("https://cdn.example.test/share/goods-100.png", data.get("shareImage")); + verify(footprintService, timeout(1000)).add(footprintCaptor.capture()); + assertEquals(Integer.valueOf(7), footprintCaptor.getValue().getUserId()); + assertEquals(Integer.valueOf(100), footprintCaptor.getValue().getGoodsId()); + } + + @Test + public void mallBrowseAc04BeUt001_relatedRejectsUnknownGoodsAndUsesCategoryRecommendations() { + LitemallGoods goods = goods(100, "青瓷杯", 20); + LitemallGoods related = goods(101, "手冲壶", 20); + when(goodsService.findById(404)).thenReturn(null); + when(goodsService.findById(100)).thenReturn(goods); + when(goodsService.queryByCategory(20, 0, 6)).thenReturn(Collections.singletonList(related)); + + Map missingResponse = responseMap(goodsController.related(404)); + Map relatedResponse = responseMap(goodsController.related(100)); + Map relatedData = responseData(relatedResponse); + + assertEquals(402, missingResponse.get("errno")); + assertEquals(0, relatedResponse.get("errno")); + assertEquals(Collections.singletonList(related), relatedData.get("list")); + verify(goodsService).queryByCategory(20, 0, 6); + } + + @Test + public void mallBrowseAc05BeUt001_goodsCategoryPromotesParentToFirstChildAndReturnsSiblingFilters() { + LitemallCategory parent = category(10, 0, "茶器"); + LitemallCategory firstChild = category(20, 10, "茶杯"); + LitemallCategory secondChild = category(21, 10, "茶壶"); + List children = Arrays.asList(firstChild, secondChild); + + when(categoryService.findById(10)).thenReturn(parent); + when(categoryService.queryByPid(10)).thenReturn(children); + + Map response = responseMap(goodsController.category(10)); + Map data = responseData(response); + + assertEquals(0, response.get("errno")); + assertEquals(firstChild, data.get("currentCategory")); + assertEquals(parent, data.get("parentCategory")); + assertEquals(children, data.get("brotherCategory")); + } + + @Test + public void mallBrowseAc05BeUt002_goodsCategoryKeepsLeafAsCurrentAndFindsParentSiblings() { + LitemallCategory parent = category(10, 0, "茶器"); + LitemallCategory current = category(20, 10, "茶杯"); + LitemallCategory sibling = category(21, 10, "茶壶"); + List siblings = Arrays.asList(current, sibling); + + when(categoryService.findById(20)).thenReturn(current); + when(categoryService.findById(10)).thenReturn(parent); + when(categoryService.queryByPid(10)).thenReturn(siblings); + + Map response = responseMap(goodsController.category(20)); + Map data = responseData(response); + + assertEquals(0, response.get("errno")); + assertEquals(current, data.get("currentCategory")); + assertEquals(parent, data.get("parentCategory")); + assertEquals(siblings, data.get("brotherCategory")); + } + + @Test + public void mallBrowseAc06BeUt001_goodsCountReturnsOnSaleGoodsTotal() { + when(goodsService.queryOnSale()).thenReturn(42); + + Map response = responseMap(goodsController.count()); + + assertEquals(0, response.get("errno")); + assertEquals(42, response.get("data")); + verify(goodsService).queryOnSale(); + } + + private void stubEmptyHomeBlocks() { + when(adService.queryIndex()).thenReturn(Collections.emptyList()); + when(categoryService.queryChannel()).thenReturn(Collections.emptyList()); + when(couponService.queryAvailableList(anyInt(), anyInt(), anyInt())).thenReturn(Collections.emptyList()); + when(goodsService.queryByNew(anyInt(), anyInt())).thenReturn(Collections.emptyList()); + when(goodsService.queryByHot(anyInt(), anyInt())).thenReturn(Collections.emptyList()); + when(brandService.query(anyInt(), anyInt())).thenReturn(Collections.emptyList()); + when(topicService.queryList(anyInt(), anyInt())).thenReturn(Collections.emptyList()); + when(grouponRuleService.queryList(anyInt(), anyInt())).thenReturn(Collections.emptyList()); + when(categoryService.queryL1WithoutRecommend(anyInt(), anyInt())).thenReturn(Collections.emptyList()); + } + + @SuppressWarnings("unchecked") + private Map responseMap(Object response) { + return (Map) response; + } + + @SuppressWarnings("unchecked") + private Map responseData(Map response) { + return (Map) response.get("data"); + } + + @SuppressWarnings("unchecked") + private T cast(Object value) { + return (T) value; + } + + private LitemallGoods goods(Integer id, String name, Integer categoryId) { + LitemallGoods goods = new LitemallGoods(); + goods.setId(id); + goods.setName(name); + goods.setCategoryId(categoryId); + goods.setBrandId(0); + goods.setRetailPrice(new BigDecimal("88.00")); + goods.setPicUrl("https://cdn.example.test/goods-" + id + ".png"); + goods.setDetail("

" + name + "

"); + return goods; + } + + private LitemallCategory category(Integer id, Integer pid, String name) { + LitemallCategory category = new LitemallCategory(); + category.setId(id); + category.setPid(pid); + category.setName(name); + return category; + } + + private LitemallGoodsProduct product(Integer id, Integer goodsId, String specification, String price, Integer number) { + LitemallGoodsProduct product = new LitemallGoodsProduct(); + product.setId(id); + product.setGoodsId(goodsId); + product.setSpecifications(new String[]{specification}); + product.setPrice(new BigDecimal(price)); + product.setNumber(number); + product.setUrl("https://cdn.example.test/product-" + id + ".png"); + return product; + } + + private LitemallGoodsAttribute attribute(String name, String value) { + LitemallGoodsAttribute attribute = new LitemallGoodsAttribute(); + attribute.setAttribute(name); + attribute.setValue(value); + return attribute; + } + + private LitemallIssue issue(String question) { + LitemallIssue issue = new LitemallIssue(); + issue.setQuestion(question); + return issue; + } + + private LitemallBrand brand(Integer id, String name) { + LitemallBrand brand = new LitemallBrand(); + brand.setId(id); + brand.setName(name); + return brand; + } + + private LitemallComment comment(Integer id, Integer userId, String content) { + LitemallComment comment = new LitemallComment(); + comment.setId(id); + comment.setUserId(userId); + comment.setContent(content); + comment.setPicUrls(new String[0]); + return comment; + } + + private LitemallUser user(Integer id, String nickname) { + LitemallUser user = new LitemallUser(); + user.setId(id); + user.setNickname(nickname); + user.setAvatar("https://cdn.example.test/avatar-" + id + ".png"); + return user; + } +} diff --git a/Tests/backend/src/test/resources/db/litemall-it-schema.sql b/Tests/backend/src/test/resources/db/litemall-it-schema.sql new file mode 100644 index 000000000..877155616 --- /dev/null +++ b/Tests/backend/src/test/resources/db/litemall-it-schema.sql @@ -0,0 +1,128 @@ +CREATE TABLE litemall_goods_product ( + id int NOT NULL AUTO_INCREMENT, + goods_id int NOT NULL DEFAULT 0, + specifications varchar(1023) NOT NULL, + price decimal(10,2) NOT NULL DEFAULT 0.00, + number int NOT NULL DEFAULT 0, + url varchar(125) DEFAULT NULL, + add_time datetime DEFAULT NULL, + update_time datetime DEFAULT NULL, + deleted tinyint(1) DEFAULT 0, + PRIMARY KEY (id) +); + +CREATE TABLE litemall_order ( + id int NOT NULL AUTO_INCREMENT, + user_id int NOT NULL, + order_sn varchar(63) NOT NULL, + order_status smallint NOT NULL, + aftersale_status smallint DEFAULT 0, + consignee varchar(63) NOT NULL, + mobile varchar(63) NOT NULL, + address varchar(127) NOT NULL, + message varchar(512) NOT NULL DEFAULT '', + goods_price decimal(10,2) NOT NULL, + freight_price decimal(10,2) NOT NULL, + coupon_price decimal(10,2) NOT NULL, + integral_price decimal(10,2) NOT NULL, + groupon_price decimal(10,2) NOT NULL, + order_price decimal(10,2) NOT NULL, + actual_price decimal(10,2) NOT NULL, + pay_id varchar(63) DEFAULT NULL, + pay_time datetime DEFAULT NULL, + ship_sn varchar(63) DEFAULT NULL, + ship_channel varchar(63) DEFAULT NULL, + ship_time datetime DEFAULT NULL, + refund_amount decimal(10,2) DEFAULT NULL, + refund_type varchar(63) DEFAULT NULL, + refund_content varchar(127) DEFAULT NULL, + refund_time datetime DEFAULT NULL, + confirm_time datetime DEFAULT NULL, + comments smallint DEFAULT 0, + end_time datetime DEFAULT NULL, + add_time datetime DEFAULT NULL, + update_time datetime DEFAULT NULL, + deleted tinyint(1) DEFAULT 0, + PRIMARY KEY (id), + KEY order_sn (order_sn) +); + +CREATE TABLE litemall_order_goods ( + id int NOT NULL AUTO_INCREMENT, + order_id int NOT NULL DEFAULT 0, + goods_id int NOT NULL DEFAULT 0, + goods_name varchar(127) NOT NULL DEFAULT '', + goods_sn varchar(63) NOT NULL DEFAULT '', + product_id int NOT NULL DEFAULT 0, + number smallint NOT NULL DEFAULT 0, + price decimal(10,2) NOT NULL DEFAULT 0.00, + specifications varchar(1023) NOT NULL, + pic_url varchar(255) NOT NULL DEFAULT '', + comment int DEFAULT 0, + add_time datetime DEFAULT NULL, + update_time datetime DEFAULT NULL, + deleted tinyint(1) DEFAULT 0, + PRIMARY KEY (id), + KEY order_id (order_id), + KEY goods_id (goods_id) +); + +CREATE TABLE litemall_coupon_user ( + id int NOT NULL AUTO_INCREMENT, + user_id int DEFAULT NULL, + coupon_id int DEFAULT NULL, + status smallint DEFAULT NULL, + used_time datetime DEFAULT NULL, + start_time datetime DEFAULT NULL, + end_time datetime DEFAULT NULL, + order_id int DEFAULT NULL, + add_time datetime DEFAULT NULL, + update_time datetime DEFAULT NULL, + deleted tinyint(1) DEFAULT 0, + PRIMARY KEY (id), + KEY order_id (order_id) +); + +CREATE TABLE litemall_groupon ( + id int NOT NULL AUTO_INCREMENT, + order_id int DEFAULT NULL, + groupon_id int DEFAULT NULL, + rules_id int DEFAULT NULL, + user_id int DEFAULT NULL, + share_url varchar(255) DEFAULT NULL, + creator_user_id int DEFAULT NULL, + creator_user_time datetime DEFAULT NULL, + status smallint DEFAULT NULL, + add_time datetime DEFAULT NULL, + update_time datetime DEFAULT NULL, + deleted tinyint(1) DEFAULT 0, + PRIMARY KEY (id), + KEY order_id (order_id), + KEY groupon_id (groupon_id) +); + +INSERT INTO litemall_goods_product + (id, goods_id, specifications, price, number, url, add_time, update_time, deleted) +VALUES + (1, 100, '["standard"]', 100.00, 5, '', now(), now(), 0); + +INSERT INTO litemall_order + (id, user_id, order_sn, order_status, consignee, mobile, address, message, + goods_price, freight_price, coupon_price, integral_price, groupon_price, + order_price, actual_price, comments, add_time, update_time, deleted) +VALUES + (1, 1, '20260711000001', 101, '测试用户', '13800000000', '测试地址', '', + 100.00, 0.00, 0.00, 0.00, 0.00, 100.00, 100.00, 0, now(), now(), 0); + +INSERT INTO litemall_coupon_user + (id, user_id, coupon_id, status, used_time, start_time, end_time, order_id, add_time, update_time, deleted) +VALUES + (1, 1, 2001, 1, now(), '2026-07-01 00:00:00', '2026-07-31 23:59:59', 1, now(), now(), 0); + +INSERT INTO litemall_groupon + (id, order_id, groupon_id, rules_id, user_id, share_url, creator_user_id, creator_user_time, status, add_time, update_time, deleted) +VALUES + (10, 900, 0, 7, 1, '/storage/source.png', 1, now(), 1, now(), now(), 0), + (11, 2, 10, 7, 2, NULL, 1, now(), 1, now(), now(), 0), + (12, 3, 10, 7, 3, NULL, 1, now(), 0, now(), now(), 0), + (13, 4, 10, 7, 4, NULL, 1, now(), 1, now(), now(), 1); diff --git a/Tests/backend/src/test/resources/logback-test.xml b/Tests/backend/src/test/resources/logback-test.xml new file mode 100644 index 000000000..9e35716dd --- /dev/null +++ b/Tests/backend/src/test/resources/logback-test.xml @@ -0,0 +1,17 @@ + + + + + %d{HH:mm:ss.SSS} %-5level %logger{36} - %msg%n + + + + + + + + + + + + diff --git a/Tests/contracts/order-api.apispec.md b/Tests/contracts/order-api.apispec.md new file mode 100644 index 000000000..c9f87617f --- /dev/null +++ b/Tests/contracts/order-api.apispec.md @@ -0,0 +1,87 @@ +# litemall 订单与支付接口 API Spec + +这份文档是 `Tests/contracts/order-api.openapi.yaml` 的人工阅读版，用于培训、评审和 AI Native workflow。当前项目仍保留 Springfox Swagger 配置，但测试体系需要一份随代码版本化的静态 spec，保证 Story、AC、Test Case ID、契约测试和脚本生成使用同一份接口事实。 + +## 范围 + +- 后端控制器：`litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/web/WxOrderController.java` +- 前端客户端：`litemall-vue/src/api/api.js` +- 前端开发环境 baseURL：`/wx` +- API 前缀：`/wx/order` +- 机器可读 spec：`Tests/contracts/order-api.openapi.yaml` +- 测试索引：`Tests/test-index.yml` + +## 通用约定 + +| 项 | 约定 | +| --- | --- | +| 登录态 | 前端请求拦截器通过 `X-Litemall-Token` 传递本地 token | +| JSON 响应 | `{ errno, errmsg, data? }` | +| 成功码 | `errno = 0` | +| 未登录 | `errno = 501` | +| 参数错误 | `errno = 401 / 402` | +| 乐观锁过期 | `errno = 504` | +| 支付回调 | 微信服务端 XML callback，响应也是 XML | + +## 接口清单 + +| Test Case ID | Method | Path | 前端路径 | 后端 mapping | 关键验证 | +| --- | --- | --- | --- | --- | --- | +| - | GET | `/wx/order/list` | `/order/list` | `list` | 订单分页列表 | +| `MALL-PAY-AC08-FE-IT-001` | GET | `/wx/order/detail` | `/order/detail` | `detail` | `orderId` 查询参数 | +| `MALL-PAY-AC07-FE-IT-001` | POST | `/wx/order/submit` | `/order/submit` | `submit` | 下单 payload 字段完整 | +| `MALL-PAY-AC09-FE-IT-001` | POST | `/wx/order/cancel` | `/order/cancel` | `cancel` | 取消未支付订单，库存和优惠券补偿 | +| `MALL-PAY-AC01-FE-IT-001` | POST | `/wx/order/prepay` | `/order/prepay` | `prepay` | JSAPI 预支付 | +| `MALL-PAY-AC01-FE-IT-002` | POST | `/wx/order/h5pay` | `/order/h5pay` | `h5pay` | H5 支付 | +| `MALL-PAY-AC04-CONTRACT-001` | POST | `/wx/order/pay-notify` | - | `pay-notify` | 微信 XML 回调字段、金额一致性、幂等 | +| `MALL-PAY-AC12-FE-IT-001` | POST | `/wx/order/refund` | `/order/refund` | `refund` | 退款申请 | +| `MALL-PAY-AC13-FE-IT-001` | POST | `/wx/order/confirm` | `/order/confirm` | `confirm` | 确认收货 | +| `MALL-PAY-AC14-FE-IT-001` | POST | `/wx/order/delete` | `/order/delete` | `delete` | 删除可删除订单 | +| - | GET | `/wx/order/goods` | - | `goods` | 待评价订单商品 | +| - | POST | `/wx/order/comment` | - | `comment` | 订单商品评价 | + +## 关键请求体 + +### 提交订单 + +```json +{ + "addressId": 1, + "cartId": 0, + "couponId": 0, + "userCouponId": 0, + "grouponLinkId": null, + "grouponRulesId": null, + "message": "请尽快发货" +} +``` + +### 订单 ID 请求 + +这些接口共用同一请求体：`prepay`、`h5pay`、`cancel`、`refund`、`confirm`、`delete`。 + +```json +{ + "orderId": 1001 +} +``` + +### 微信支付回调 XML + +```xml + + + + + + 10000 + +``` + +完整 fixture 见 `Tests/contracts/wechat-pay-notify-success.xml`。 + +## 测试闭环 + +- `FrontendBackendOrderContractTest` 校验前端路径、后端 mapping、HTTP method 和 OpenAPI spec 对齐。 +- `PaymentNotifyXmlContractTest` 校验微信 XML fixture 的必填字段，并确认 fixture 可装载为微信 SDK notify result 模型。 +- `test-index.yml` 把接口 spec、contract、前端 IT、后端 UT、后端 IT、E2E 串成可追踪测试资产。 diff --git a/Tests/contracts/order-api.contract.json b/Tests/contracts/order-api.contract.json new file mode 100644 index 000000000..556fd2541 --- /dev/null +++ b/Tests/contracts/order-api.contract.json @@ -0,0 +1,81 @@ +{ + "feature": "payment-callback-reliability", + "basePaths": { + "mobileFrontend": "litemall-vue/src/api/api.js", + "backendController": "litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/web/WxOrderController.java" + }, + "endpoints": [ + { + "id": "MALL-PAY-AC07-FE-IT-001", + "name": "submit order", + "frontendPath": "/order/submit", + "backendMapping": "submit", + "method": "POST", + "requiredPayloadFields": ["addressId", "cartId", "couponId", "userCouponId", "grouponLinkId", "grouponRulesId", "message"] + }, + { + "id": "MALL-PAY-AC01-FE-IT-001", + "name": "create JSAPI prepay", + "frontendPath": "/order/prepay", + "backendMapping": "prepay", + "method": "POST", + "requiredPayloadFields": ["orderId"] + }, + { + "id": "MALL-PAY-AC01-FE-IT-002", + "name": "create H5 pay", + "frontendPath": "/order/h5pay", + "backendMapping": "h5pay", + "method": "POST", + "requiredPayloadFields": ["orderId"] + }, + { + "id": "MALL-PAY-AC04-CONTRACT-001", + "name": "wechat pay notify", + "frontendPath": null, + "backendMapping": "pay-notify", + "method": "POST", + "requiredXmlFields": ["return_code", "result_code", "out_trade_no", "transaction_id", "total_fee"] + }, + { + "id": "MALL-PAY-AC08-FE-IT-001", + "name": "order detail", + "frontendPath": "/order/detail", + "backendMapping": "detail", + "method": "GET", + "requiredQueryFields": ["orderId"] + }, + { + "id": "MALL-PAY-AC09-FE-IT-001", + "name": "cancel unpaid order", + "frontendPath": "/order/cancel", + "backendMapping": "cancel", + "method": "POST", + "requiredPayloadFields": ["orderId"] + }, + { + "id": "MALL-PAY-AC12-FE-IT-001", + "name": "refund paid order", + "frontendPath": "/order/refund", + "backendMapping": "refund", + "method": "POST", + "requiredPayloadFields": ["orderId"] + }, + { + "id": "MALL-PAY-AC13-FE-IT-001", + "name": "confirm shipped order", + "frontendPath": "/order/confirm", + "backendMapping": "confirm", + "method": "POST", + "requiredPayloadFields": ["orderId"] + }, + { + "id": "MALL-PAY-AC14-FE-IT-001", + "name": "delete completed order", + "frontendPath": "/order/delete", + "backendMapping": "delete", + "method": "POST", + "requiredPayloadFields": ["orderId"] + } + ] +} diff --git a/Tests/contracts/order-api.openapi.yaml b/Tests/contracts/order-api.openapi.yaml new file mode 100644 index 000000000..4a7984b67 --- /dev/null +++ b/Tests/contracts/order-api.openapi.yaml @@ -0,0 +1,416 @@ +openapi: 3.0.3 +info: + title: litemall wx order API + version: 0.1.0-training + description: > + Static OpenAPI contract for the litemall mobile order and payment slice used + by the AI Native testing workshop. The running project still has Springfox + Swagger configuration, while this file is versioned with Tests so contract + tests, test planners, and AI skills can use one stable source of truth. +servers: + - url: /wx + description: litemall-vue development baseURL +tags: + - name: Order + description: Mobile order lifecycle APIs. + - name: Payment + description: WeChat payment creation and callback APIs. +paths: + /order/list: + get: + tags: [Order] + operationId: listOrders + summary: List current user's orders. + description: Mirrors WxOrderController.list and litemall-vue orderList. + parameters: + - $ref: '#/components/parameters/ShowType' + - $ref: '#/components/parameters/Page' + - $ref: '#/components/parameters/Limit' + - $ref: '#/components/parameters/Sort' + - $ref: '#/components/parameters/Order' + responses: + '200': + description: Litemall response containing paged order list. + content: + application/json: + schema: + $ref: '#/components/schemas/LitemallResponse' + /order/detail: + get: + tags: [Order] + operationId: getOrderDetail + summary: Get one order detail. + x-test-case-id: MALL-PAY-AC08-FE-IT-001 + x-frontend-path: /order/detail + x-backend-mapping: detail + parameters: + - name: orderId + in: query + required: true + schema: + type: integer + description: Order id owned by the current login user. + responses: + '200': + description: Litemall response containing orderInfo, orderGoods, and expressInfo. + content: + application/json: + schema: + $ref: '#/components/schemas/LitemallResponse' + /order/submit: + post: + tags: [Order] + operationId: submitOrder + summary: Submit a shopping cart order. + x-test-case-id: MALL-PAY-AC07-FE-IT-001 + x-frontend-path: /order/submit + x-backend-mapping: submit + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/OrderSubmitRequest' + responses: + '200': + description: Litemall response containing the created order id and order sn. + content: + application/json: + schema: + $ref: '#/components/schemas/LitemallResponse' + /order/cancel: + post: + tags: [Order] + operationId: cancelOrder + summary: Cancel an unpaid order and release occupied resources. + x-test-case-id: MALL-PAY-AC09-FE-IT-001 + x-frontend-path: /order/cancel + x-backend-mapping: cancel + requestBody: + $ref: '#/components/requestBodies/OrderIdJson' + responses: + '200': + description: Litemall response. Success also implies stock and coupon compensation. + content: + application/json: + schema: + $ref: '#/components/schemas/LitemallResponse' + /order/prepay: + post: + tags: [Payment] + operationId: createJsapiPrepay + summary: Create WeChat JSAPI prepay session. + x-test-case-id: MALL-PAY-AC01-FE-IT-001 + x-frontend-path: /order/prepay + x-backend-mapping: prepay + requestBody: + $ref: '#/components/requestBodies/OrderIdJson' + responses: + '200': + description: Litemall response containing WxPayMpOrderResult. + content: + application/json: + schema: + $ref: '#/components/schemas/LitemallResponse' + /order/h5pay: + post: + tags: [Payment] + operationId: createH5Pay + summary: Create WeChat H5 payment session. + x-test-case-id: MALL-PAY-AC01-FE-IT-002 + x-frontend-path: /order/h5pay + x-backend-mapping: h5pay + requestBody: + $ref: '#/components/requestBodies/OrderIdJson' + responses: + '200': + description: Litemall response containing WxPayMwebOrderResult. + content: + application/json: + schema: + $ref: '#/components/schemas/LitemallResponse' + /order/pay-notify: + post: + tags: [Payment] + operationId: receiveWechatPayNotify + summary: Receive WeChat payment callback. + description: > + WeChat server-to-server callback. The service verifies SDK parsing, + payment result code, order existence, amount consistency, and duplicate + callback idempotency before mutating the order. + x-test-case-id: MALL-PAY-AC04-CONTRACT-001 + x-related-test-case-ids: + - MALL-PAY-AC04-CONTRACT-002 + - MALL-PAY-AC01-BE-UT-001 + - MALL-PAY-AC02-BE-UT-001 + - MALL-PAY-AC03-BE-UT-001 + x-frontend-path: null + x-backend-mapping: pay-notify + requestBody: + required: true + content: + application/xml: + schema: + $ref: '#/components/schemas/WechatPayNotifyXml' + responses: + '200': + description: WeChat XML notify response with SUCCESS or FAIL. + content: + application/xml: + schema: + $ref: '#/components/schemas/WechatPayNotifyResponse' + /order/refund: + post: + tags: [Order] + operationId: requestOrderRefund + summary: Request refund for a paid order. + x-test-case-id: MALL-PAY-AC12-FE-IT-001 + x-frontend-path: /order/refund + x-backend-mapping: refund + requestBody: + $ref: '#/components/requestBodies/OrderIdJson' + responses: + '200': + description: Litemall response. Success moves the order to refunding. + content: + application/json: + schema: + $ref: '#/components/schemas/LitemallResponse' + /order/confirm: + post: + tags: [Order] + operationId: confirmOrderReceipt + summary: Confirm receipt of a shipped order. + x-test-case-id: MALL-PAY-AC13-FE-IT-001 + x-frontend-path: /order/confirm + x-backend-mapping: confirm + requestBody: + $ref: '#/components/requestBodies/OrderIdJson' + responses: + '200': + description: Litemall response. Success moves the order to confirmed. + content: + application/json: + schema: + $ref: '#/components/schemas/LitemallResponse' + /order/delete: + post: + tags: [Order] + operationId: deleteOrder + summary: Logically delete an order that can be deleted by current user. + x-test-case-id: MALL-PAY-AC14-FE-IT-001 + x-frontend-path: /order/delete + x-backend-mapping: delete + requestBody: + $ref: '#/components/requestBodies/OrderIdJson' + responses: + '200': + description: Litemall response. + content: + application/json: + schema: + $ref: '#/components/schemas/LitemallResponse' + /order/goods: + get: + tags: [Order] + operationId: getOrderGoodsForComment + summary: Get one order goods item for comment. + parameters: + - name: ogid + in: query + required: true + schema: + type: integer + description: Order goods id. + responses: + '200': + description: Litemall response containing one order goods item. + content: + application/json: + schema: + $ref: '#/components/schemas/LitemallResponse' + /order/comment: + post: + tags: [Order] + operationId: commentOrderGoods + summary: Submit a comment for an order goods item. + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/OrderCommentRequest' + responses: + '200': + description: Litemall response. + content: + application/json: + schema: + $ref: '#/components/schemas/LitemallResponse' +components: + parameters: + ShowType: + name: showType + in: query + required: false + schema: + type: integer + default: 0 + description: Order tab filter. 0 means all orders. + Page: + name: page + in: query + required: false + schema: + type: integer + default: 1 + minimum: 1 + Limit: + name: limit + in: query + required: false + schema: + type: integer + default: 10 + minimum: 1 + Sort: + name: sort + in: query + required: false + schema: + type: string + default: add_time + Order: + name: order + in: query + required: false + schema: + type: string + enum: [asc, desc] + default: desc + requestBodies: + OrderIdJson: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/OrderIdRequest' + schemas: + LitemallResponse: + type: object + required: [errno, errmsg] + properties: + errno: + type: integer + description: 0 for success; 4xx client errors; 5xx system errors; 7xx wx business errors. + example: 0 + errmsg: + type: string + example: 成功 + data: + description: Endpoint-specific response payload. + OrderSubmitRequest: + type: object + required: + - addressId + - cartId + - couponId + - userCouponId + - grouponLinkId + - grouponRulesId + - message + properties: + addressId: + type: integer + cartId: + type: integer + description: 0 means checked cart items; otherwise a single cart id. + couponId: + type: integer + userCouponId: + type: integer + grouponLinkId: + type: integer + nullable: true + grouponRulesId: + type: integer + nullable: true + message: + type: string + OrderIdRequest: + type: object + required: [orderId] + properties: + orderId: + type: integer + OrderCommentRequest: + type: object + required: + - orderGoodsId + - content + - star + properties: + orderGoodsId: + type: integer + content: + type: string + star: + type: integer + minimum: 1 + maximum: 5 + hasPicture: + type: boolean + picUrls: + type: array + items: + type: string + WechatPayNotifyXml: + type: object + required: + - return_code + - result_code + - out_trade_no + - transaction_id + - total_fee + properties: + return_code: + type: string + example: SUCCESS + result_code: + type: string + example: SUCCESS + appid: + type: string + mch_id: + type: string + nonce_str: + type: string + sign: + type: string + openid: + type: string + trade_type: + type: string + example: JSAPI + bank_type: + type: string + total_fee: + type: integer + description: Paid amount in fen. + example: 10000 + transaction_id: + type: string + out_trade_no: + type: string + description: litemall orderSn. + time_end: + type: string + WechatPayNotifyResponse: + type: object + required: [return_code, return_msg] + properties: + return_code: + type: string + enum: [SUCCESS, FAIL] + return_msg: + type: string diff --git a/Tests/contracts/product-browsing-api.contract.json b/Tests/contracts/product-browsing-api.contract.json new file mode 100644 index 000000000..8f6cfb7ed --- /dev/null +++ b/Tests/contracts/product-browsing-api.contract.json @@ -0,0 +1,68 @@ +{ + "feature": "product-browsing", + "basePaths": { + "mobileFrontend": "litemall-vue/src/api/api.js", + "miniProgramApi": "litemall-wx/config/api.js", + "homeController": "litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/web/WxHomeController.java", + "goodsController": "litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/web/WxGoodsController.java" + }, + "endpoints": [ + { + "id": "MALL-BROWSE-AC01-CONTRACT-001", + "name": "home index merchandising blocks", + "frontendPath": "/home/index", + "controller": "home", + "backendMapping": "/index", + "method": "GET", + "responseFields": ["banner", "channel", "couponList", "newGoodsList", "hotGoodsList", "brandList", "topicList", "grouponList", "floorGoodsList"] + }, + { + "id": "MALL-BROWSE-AC02-CONTRACT-001", + "name": "goods list filters and pagination", + "frontendPath": "/goods/list", + "controller": "goods", + "backendMapping": "list", + "method": "GET", + "optionalQueryFields": ["categoryId", "brandId", "keyword", "isNew", "isHot", "page", "limit", "sort", "order"], + "responseFields": ["list", "total", "page", "limit", "pages", "filterCategoryList"] + }, + { + "id": "MALL-BROWSE-AC03-CONTRACT-001", + "name": "goods detail merchandising aggregate", + "frontendPath": "/goods/detail", + "controller": "goods", + "backendMapping": "detail", + "method": "GET", + "requiredQueryFields": ["id"], + "responseFields": ["info", "userHasCollect", "issue", "comment", "specificationList", "productList", "attribute", "brand", "groupon", "share", "shareImage"] + }, + { + "id": "MALL-BROWSE-AC04-CONTRACT-001", + "name": "related goods for detail page", + "frontendPath": "/goods/related", + "controller": "goods", + "backendMapping": "related", + "method": "GET", + "requiredQueryFields": ["id"], + "responseFields": ["list", "total", "page", "limit", "pages"] + }, + { + "id": "MALL-BROWSE-AC05-CONTRACT-001", + "name": "goods category sibling filter data", + "frontendPath": "/goods/category", + "controller": "goods", + "backendMapping": "category", + "method": "GET", + "requiredQueryFields": ["id"], + "responseFields": ["currentCategory", "parentCategory", "brotherCategory"] + }, + { + "id": "MALL-BROWSE-AC06-CONTRACT-001", + "name": "on-sale goods count", + "frontendPath": "/goods/count", + "controller": "goods", + "backendMapping": "count", + "method": "GET" + } + ] +} diff --git a/Tests/contracts/wechat-pay-notify-success.xml b/Tests/contracts/wechat-pay-notify-success.xml new file mode 100644 index 000000000..efddc9b57 --- /dev/null +++ b/Tests/contracts/wechat-pay-notify-success.xml @@ -0,0 +1,15 @@ + + + + + + + + + + + 10000 + + + + diff --git a/Tests/e2e/fixtures/payment-flow-server.mjs b/Tests/e2e/fixtures/payment-flow-server.mjs new file mode 100644 index 000000000..4920a8b24 --- /dev/null +++ b/Tests/e2e/fixtures/payment-flow-server.mjs @@ -0,0 +1,450 @@ +import express from 'express'; + +const app = express(); +app.use(express.json()); + +const state = { + order: null, + callbackMutations: 0, + productStock: 5, + couponStatus: '可用' +}; + +const products = [ + { + id: 100, + name: '青瓷杯', + categoryId: 20, + brandId: 5, + isNew: true, + isHot: true, + retailPrice: 88.00, + picUrl: '/static/goods-100.png', + detail: '

天青色手作茶杯

', + stock: 12, + specification: '天青色' + }, + { + id: 101, + name: '手冲壶', + categoryId: 20, + brandId: 5, + isNew: false, + isHot: true, + retailPrice: 128.00, + picUrl: '/static/goods-101.png', + detail: '

细口控流手冲壶

', + stock: 8, + specification: '银色' + }, + { + id: 102, + name: '茶盘', + categoryId: 20, + brandId: 6, + isNew: false, + isHot: false, + retailPrice: 168.00, + picUrl: '/static/goods-102.png', + detail: '

竹制茶盘

', + stock: 5, + specification: '原竹色' + } +]; + +const browseState = { + lastListQuery: '' +}; + +function resetDemoState() { + state.order = null; + state.callbackMutations = 0; + state.productStock = 5; + state.couponStatus = '可用'; +} + +app.get('/', (_req, res) => { + resetDemoState(); + res.type('html').send(` + + + + litemall payment flow test harness + + + +
+

litemall 支付回调可靠性 E2E

+
加载中
+
未下单
+
未开始
+
0
+
5
+
可用
+ + + + +
+ + +`); +}); + +app.get('/browse', (_req, res) => { + browseState.lastListQuery = ''; + res.type('html').send(` + + + + litemall product browsing test harness + + + +
+

litemall 商品浏览 E2E

+
0
+
0
+
+ +
未筛选
+
+

未选择

+
未选择
+
未选择
+
未选择
+
未加载
+
+
+ + +`); +}); + +app.get('/wx/cart/checkout', (_req, res) => { + res.json({ + errno: 0, + data: { + cartId: 9, + addressId: 7, + couponId: -1, + userCouponId: -1, + actualPrice: 100.00, + goodsTotalPrice: 100.00, + freightPrice: 0, + couponPrice: 0, + productStock: state.productStock, + couponStatus: state.couponStatus + } + }); +}); + +app.post('/wx/order/submit', (_req, res) => { + state.productStock -= 2; + state.couponStatus = '已使用'; + state.order = { + id: 1001, + orderSn: '20260711000001', + orderStatus: 101, + orderStatusText: '未付款', + actualPrice: 100.00, + payId: null + }; + state.callbackMutations = 0; + res.json({ + errno: 0, + data: { + orderId: state.order.id, + orderSn: state.order.orderSn, + payed: false + } + }); +}); + +app.post('/wx/order/cancel', (_req, res) => { + if (!state.order) { + res.status(404).json({ errno: 404, errmsg: '订单不存在' }); + return; + } + if (state.order.orderStatus !== 101) { + res.status(409).json({ errno: 720, errmsg: '订单不能取消' }); + return; + } + state.order.orderStatus = 102; + state.order.orderStatusText = '已取消'; + state.productStock += 2; + state.couponStatus = '可用'; + res.json({ errno: 0, errmsg: '成功' }); +}); + +app.post('/wx/order/pay-notify', (req, res) => { + if (!state.order) { + res.status(404).json({ errno: 404, errmsg: '订单不存在' }); + return; + } + if (req.body.totalFee !== 10000) { + res.status(409).json({ errno: 409, errmsg: '支付金额不符合' }); + return; + } + if (state.order.orderStatus !== 201) { + state.order.orderStatus = 201; + state.order.orderStatusText = '已付款'; + state.order.payId = req.body.transactionId; + state.callbackMutations += 1; + } + res.json({ errno: 0, errmsg: '处理成功' }); +}); + +app.get('/wx/order/detail', (_req, res) => { + res.json({ + errno: 0, + data: { + orderInfo: state.order, + callbackMutations: state.callbackMutations, + productStock: state.productStock, + couponStatus: state.couponStatus + } + }); +}); + +app.get('/wx/home/index', (_req, res) => { + res.json({ + errno: 0, + errmsg: '成功', + data: { + banner: [], + channel: [{ id: 20, name: '茶器' }], + couponList: [], + newGoodsList: products.filter((item) => item.isNew), + hotGoodsList: products.filter((item) => item.isHot).slice(0, 1), + brandList: [{ id: 5, name: '器物集' }], + topicList: [], + grouponList: [], + floorGoodsList: [ + { + id: 20, + name: '茶器', + goodsList: products.filter((item) => item.categoryId === 20) + } + ] + } + }); +}); + +app.get('/wx/goods/list', (req, res) => { + browseState.lastListQuery = new URLSearchParams(req.query).toString(); + let list = products.slice(); + if (req.query.isNew === 'true') { + list = list.filter((item) => item.isNew); + } + if (req.query.isHot === 'true') { + list = list.filter((item) => item.isHot); + } + if (req.query.keyword) { + list = list.filter((item) => item.name.includes(String(req.query.keyword))); + } + if (req.query.sort === 'retail_price') { + list.sort((left, right) => left.retailPrice - right.retailPrice); + } + if (req.query.order === 'desc') { + list.reverse(); + } + res.json({ + errno: 0, + errmsg: '成功', + data: { + list, + total: list.length, + page: Number(req.query.page || 1), + limit: Number(req.query.limit || list.length), + pages: 1, + filterCategoryList: [{ id: 20, name: '茶器' }], + queryLog: browseState.lastListQuery + } + }); +}); + +app.get('/wx/goods/detail', (req, res) => { + const goods = products.find((item) => item.id === Number(req.query.id)); + if (!goods) { + res.status(404).json({ errno: 402, errmsg: '参数值不对' }); + return; + } + res.json({ + errno: 0, + errmsg: '成功', + data: { + info: goods, + userHasCollect: 0, + issue: [], + comment: { count: 0, data: [] }, + specificationList: [ + { + name: '颜色', + valueList: [{ value: goods.specification }] + } + ], + productList: [ + { + id: 9000 + goods.id, + goodsId: goods.id, + price: goods.retailPrice, + number: goods.stock, + specifications: [goods.specification], + url: goods.picUrl + } + ], + attribute: [{ attribute: '材质', value: '瓷' }], + brand: { id: goods.brandId, name: '器物集' }, + groupon: [], + share: false, + shareImage: '/static/share-' + goods.id + '.png' + } + }); +}); + +app.get('/wx/goods/related', (req, res) => { + const goods = products.find((item) => item.id === Number(req.query.id)); + if (!goods) { + res.status(404).json({ errno: 402, errmsg: '参数值不对' }); + return; + } + const list = products.filter((item) => item.categoryId === goods.categoryId && item.id !== goods.id); + res.json({ + errno: 0, + errmsg: '成功', + data: { + list, + total: list.length, + page: 1, + limit: list.length, + pages: 1 + } + }); +}); + +app.listen(4179, '127.0.0.1', () => { + console.log('payment flow harness listening on http://127.0.0.1:4179'); +}); diff --git a/Tests/e2e/package-lock.json b/Tests/e2e/package-lock.json new file mode 100644 index 000000000..cab52b8a8 --- /dev/null +++ b/Tests/e2e/package-lock.json @@ -0,0 +1,892 @@ +{ + "name": "litemall-tests-e2e", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "litemall-tests-e2e", + "dependencies": { + "express": "^4.21.2" + }, + "devDependencies": { + "@playwright/test": "^1.49.1" + } + }, + "node_modules/@playwright/test": { + "version": "1.61.1", + "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.61.1.tgz", + "integrity": "sha512-8nKv6+0RJSL9FE4jYOEGXnPeM/Hg12qZpmqzZjRh3qM0Y7c3z1mrOTfFLids72RDQYVh9WpLEfR5WdpNX4fkig==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "playwright": "1.61.1" + }, + "bin": { + "playwright": "cli.js" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/accepts": { + "version": "1.3.8", + "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz", + "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==", + "license": "MIT", + "dependencies": { + "mime-types": "~2.1.34", + "negotiator": "0.6.3" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/array-flatten": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz", + "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==", + "license": "MIT" + }, + "node_modules/body-parser": { + "version": "1.20.6", + "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.6.tgz", + "integrity": "sha512-p5tAzS57i5MV9fZFDj9LeIiTZEufbSe2eDozP+ElheSUq1m74CRq1jI4mYNDdVs9vQztXFLuk/Gd6BWTdwRJ5g==", + "license": "MIT", + "dependencies": { + "bytes": "~3.1.2", + "content-type": "~1.0.5", + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "~1.2.0", + "http-errors": "~2.0.1", + "iconv-lite": "~0.4.24", + "on-finished": "~2.4.1", + "qs": "~6.15.1", + "raw-body": "~2.5.3", + "type-is": "~1.6.18", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/bytes": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", + "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/call-bound": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz", + "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "get-intrinsic": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/content-disposition": { + "version": "0.5.4", + "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz", + "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==", + "license": "MIT", + "dependencies": { + "safe-buffer": "5.2.1" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/content-type": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz", + "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/cookie": { + "version": "0.7.2", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz", + "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/cookie-signature": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.7.tgz", + "integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA==", + "license": "MIT" + }, + "node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/depd": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz", + "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/destroy": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz", + "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==", + "license": "MIT", + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/ee-first": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", + "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==", + "license": "MIT" + }, + "node_modules/encodeurl": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz", + "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-object-atoms": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz", + "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/escape-html": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", + "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==", + "license": "MIT" + }, + "node_modules/etag": { + "version": "1.8.1", + "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", + "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/express": { + "version": "4.22.2", + "resolved": "https://registry.npmjs.org/express/-/express-4.22.2.tgz", + "integrity": "sha512-IuL+Elrou2ZvCFHs18/CIzy2Nzvo25nZ1/D2eIZlz7c+QUayAcYoiM2BthCjs+EBHVpjYjcuLDAiCWgeIX3X1Q==", + "license": "MIT", + "dependencies": { + "accepts": "~1.3.8", + "array-flatten": "1.1.1", + "body-parser": "~1.20.5", + "content-disposition": "~0.5.4", + "content-type": "~1.0.4", + "cookie": "~0.7.1", + "cookie-signature": "~1.0.6", + "debug": "2.6.9", + "depd": "2.0.0", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "finalhandler": "~1.3.1", + "fresh": "~0.5.2", + "http-errors": "~2.0.0", + "merge-descriptors": "1.0.3", + "methods": "~1.1.2", + "on-finished": "~2.4.1", + "parseurl": "~1.3.3", + "path-to-regexp": "~0.1.12", + "proxy-addr": "~2.0.7", + "qs": "~6.15.1", + "range-parser": "~1.2.1", + "safe-buffer": "5.2.1", + "send": "~0.19.0", + "serve-static": "~1.16.2", + "setprototypeof": "1.2.0", + "statuses": "~2.0.1", + "type-is": "~1.6.18", + "utils-merge": "1.0.1", + "vary": "~1.1.2" + }, + "engines": { + "node": ">= 0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/finalhandler": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.2.tgz", + "integrity": "sha512-aA4RyPcd3badbdABGDuTXCMTtOneUCAYH/gxoYRTZlIJdF0YPWuGqiAsIrhNnnqdXGswYk6dGujem4w80UJFhg==", + "license": "MIT", + "dependencies": { + "debug": "2.6.9", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "on-finished": "~2.4.1", + "parseurl": "~1.3.3", + "statuses": "~2.0.2", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/forwarded": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz", + "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/fresh": { + "version": "0.5.2", + "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz", + "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/fsevents": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.2.tgz", + "integrity": "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-intrinsic": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "function-bind": "^1.1.2", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz", + "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/http-errors": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz", + "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==", + "license": "MIT", + "dependencies": { + "depd": "~2.0.0", + "inherits": "~2.0.4", + "setprototypeof": "~1.2.0", + "statuses": "~2.0.2", + "toidentifier": "~1.0.1" + }, + "engines": { + "node": ">= 0.8" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/iconv-lite": { + "version": "0.4.24", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz", + "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==", + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "license": "ISC" + }, + "node_modules/ipaddr.js": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz", + "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==", + "license": "MIT", + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/media-typer": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz", + "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/merge-descriptors": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz", + "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/methods": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz", + "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz", + "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", + "license": "MIT", + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/negotiator": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz", + "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/object-inspect": { + "version": "1.13.4", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz", + "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/on-finished": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz", + "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==", + "license": "MIT", + "dependencies": { + "ee-first": "1.1.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/parseurl": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", + "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/path-to-regexp": { + "version": "0.1.13", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.13.tgz", + "integrity": "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA==", + "license": "MIT" + }, + "node_modules/playwright": { + "version": "1.61.1", + "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.61.1.tgz", + "integrity": "sha512-DWnY5o3YbLWK4GovuAVwpqL+1VwGNdUGrRr++8j8PtQQzvAVZUIMjKQ90fY689sEJZJBbZVw1rXaOKSTitkzPQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "playwright-core": "1.61.1" + }, + "bin": { + "playwright": "cli.js" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "fsevents": "2.3.2" + } + }, + "node_modules/playwright-core": { + "version": "1.61.1", + "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.61.1.tgz", + "integrity": "sha512-h7Qlt6m4REp25qvIdvbDtVmD4LqVXfpRxhORv9L0jzETM05p4fuPJ3dKyuSXQxDSbXnmS79HAgi9589lGSpLkg==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "playwright-core": "cli.js" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/proxy-addr": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", + "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==", + "license": "MIT", + "dependencies": { + "forwarded": "0.2.0", + "ipaddr.js": "1.9.1" + }, + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/qs": { + "version": "6.15.3", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.3.tgz", + "integrity": "sha512-O9gl3zCl5h5blw1KGUzQKhA5oUXSl8rwUIM5o0S3nCXMliSvy5Dzx7/DJcI+SwgICv+IneSZwhBh1oSyEHA71A==", + "license": "BSD-3-Clause", + "dependencies": { + "es-define-property": "^1.0.1", + "side-channel": "^1.1.1" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/range-parser": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz", + "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/raw-body": { + "version": "2.5.3", + "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.3.tgz", + "integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==", + "license": "MIT", + "dependencies": { + "bytes": "~3.1.2", + "http-errors": "~2.0.1", + "iconv-lite": "~0.4.24", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "license": "MIT" + }, + "node_modules/send": { + "version": "0.19.2", + "resolved": "https://registry.npmjs.org/send/-/send-0.19.2.tgz", + "integrity": "sha512-VMbMxbDeehAxpOtWJXlcUS5E8iXh6QmN+BkRX1GARS3wRaXEEgzCcB10gTQazO42tpNIya8xIyNx8fll1OFPrg==", + "license": "MIT", + "dependencies": { + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "1.2.0", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "fresh": "~0.5.2", + "http-errors": "~2.0.1", + "mime": "1.6.0", + "ms": "2.1.3", + "on-finished": "~2.4.1", + "range-parser": "~1.2.1", + "statuses": "~2.0.2" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/send/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/serve-static": { + "version": "1.16.3", + "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.3.tgz", + "integrity": "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA==", + "license": "MIT", + "dependencies": { + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "parseurl": "~1.3.3", + "send": "~0.19.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/setprototypeof": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", + "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==", + "license": "ISC" + }, + "node_modules/side-channel": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.1.tgz", + "integrity": "sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.4", + "side-channel-list": "^1.0.1", + "side-channel-map": "^1.0.1", + "side-channel-weakmap": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-list": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.1.tgz", + "integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-map": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz", + "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==", + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-weakmap": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz", + "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==", + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3", + "side-channel-map": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/statuses": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz", + "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/toidentifier": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz", + "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==", + "license": "MIT", + "engines": { + "node": ">=0.6" + } + }, + "node_modules/type-is": { + "version": "1.6.18", + "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz", + "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==", + "license": "MIT", + "dependencies": { + "media-typer": "0.3.0", + "mime-types": "~2.1.24" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/unpipe": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz", + "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/utils-merge": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz", + "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==", + "license": "MIT", + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/vary": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz", + "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + } + } +} diff --git a/Tests/e2e/package.json b/Tests/e2e/package.json new file mode 100644 index 000000000..24904306d --- /dev/null +++ b/Tests/e2e/package.json @@ -0,0 +1,14 @@ +{ + "name": "litemall-tests-e2e", + "private": true, + "type": "module", + "scripts": { + "test": "playwright test" + }, + "dependencies": { + "express": "^4.21.2" + }, + "devDependencies": { + "@playwright/test": "^1.49.1" + } +} diff --git a/Tests/e2e/playwright.config.ts b/Tests/e2e/playwright.config.ts new file mode 100644 index 000000000..979df76f7 --- /dev/null +++ b/Tests/e2e/playwright.config.ts @@ -0,0 +1,16 @@ +import { defineConfig } from '@playwright/test'; + +export default defineConfig({ + testDir: './tests', + timeout: 30_000, + use: { + baseURL: 'http://127.0.0.1:4179', + trace: 'retain-on-failure' + }, + webServer: { + command: 'node fixtures/payment-flow-server.mjs', + url: 'http://127.0.0.1:4179', + reuseExistingServer: false, + timeout: 15_000 + } +}); diff --git a/Tests/e2e/tests/payment-flow.spec.ts b/Tests/e2e/tests/payment-flow.spec.ts new file mode 100644 index 000000000..cf7bed6fe --- /dev/null +++ b/Tests/e2e/tests/payment-flow.spec.ts @@ -0,0 +1,36 @@ +import { expect, test } from '@playwright/test'; + +test('MALL-PAY-AC08-E2E-001 browser payment flow reaches paid state exactly once', async ({ page }) => { + await page.goto('/'); + + await expect(page.getByTestId('actual-price')).toHaveText('¥100.00'); + + await page.getByRole('button', { name: '提交订单' }).click(); + await expect(page.getByTestId('order-sn')).toHaveText('20260711000001'); + await expect(page.getByTestId('order-status')).toHaveText('未付款'); + + await page.getByRole('button', { name: '模拟支付回调' }).click(); + await expect(page.getByTestId('order-status')).toHaveText('已付款'); + await expect(page.getByTestId('callback-count')).toHaveText('1'); + + await page.getByRole('button', { name: '重复回调' }).click(); + await expect(page.getByTestId('order-status')).toHaveText('已付款'); + await expect(page.getByTestId('callback-count')).toHaveText('1'); +}); + +test('MALL-PAY-AC09-E2E-001 canceling unpaid order restores stock and coupon', async ({ page }) => { + await page.goto('/'); + + await expect(page.getByTestId('stock-count')).toHaveText('5'); + await expect(page.getByTestId('coupon-status')).toHaveText('可用'); + + await page.getByRole('button', { name: '提交订单' }).click(); + await expect(page.getByTestId('order-status')).toHaveText('未付款'); + await expect(page.getByTestId('stock-count')).toHaveText('3'); + await expect(page.getByTestId('coupon-status')).toHaveText('已使用'); + + await page.getByRole('button', { name: '取消订单' }).click(); + await expect(page.getByTestId('order-status')).toHaveText('已取消'); + await expect(page.getByTestId('stock-count')).toHaveText('5'); + await expect(page.getByTestId('coupon-status')).toHaveText('可用'); +}); diff --git a/Tests/e2e/tests/product-browsing-flow.spec.ts b/Tests/e2e/tests/product-browsing-flow.spec.ts new file mode 100644 index 000000000..854ca49b8 --- /dev/null +++ b/Tests/e2e/tests/product-browsing-flow.spec.ts @@ -0,0 +1,26 @@ +import { expect, test } from '@playwright/test'; + +test('MALL-BROWSE-AC03-E2E-001 browses homepage product into detail and related goods', async ({ page }) => { + await page.goto('/browse'); + + await expect(page.getByTestId('new-goods-count')).toHaveText('1'); + await expect(page.getByTestId('hot-goods-count')).toHaveText('1'); + + await page.getByRole('button', { name: /青瓷杯/ }).first().click(); + + await expect(page.getByTestId('product-name')).toHaveText('青瓷杯'); + await expect(page.getByTestId('product-price')).toHaveText('¥88.00'); + await expect(page.getByTestId('product-stock')).toHaveText('12'); + await expect(page.getByTestId('product-spec')).toHaveText('天青色'); + await expect(page.getByTestId('related-goods')).toContainText('手冲壶'); +}); + +test('MALL-BROWSE-AC02-E2E-001 filters goods list by new item query without losing sort contract', async ({ page }) => { + await page.goto('/browse'); + + await page.getByRole('button', { name: '只看新品' }).click(); + + await expect(page.getByTestId('goods-list')).toContainText('青瓷杯'); + await expect(page.getByTestId('goods-list')).not.toContainText('手冲壶'); + await expect(page.getByTestId('query-log')).toHaveText('isNew=true&page=1&limit=10&sort=retail_price&order=asc'); +}); diff --git a/Tests/frontend/package-lock.json b/Tests/frontend/package-lock.json new file mode 100644 index 000000000..946dfb491 --- /dev/null +++ b/Tests/frontend/package-lock.json @@ -0,0 +1,3196 @@ +{ + "name": "litemall-tests-frontend", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "litemall-tests-frontend", + "dependencies": { + "axios": "^1.7.9", + "dayjs": "^1.11.13", + "lodash": "^4.17.21", + "vue": "2.6.10", + "vue-template-compiler": "2.6.10" + }, + "devDependencies": { + "@types/lodash": "^4.17.13", + "@vitest/coverage-v8": "2.1.9", + "jsdom": "^25.0.1", + "typescript": "^5.7.2", + "vite": "^5.4.11", + "vitest": "^2.1.8" + } + }, + "node_modules/@ampproject/remapping": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz", + "integrity": "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.24" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@asamuzakjp/css-color": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/@asamuzakjp/css-color/-/css-color-3.2.0.tgz", + "integrity": "sha512-K1A6z8tS3XsmCMM86xoWdn7Fkdn9m6RSVtocUrJYIwZnFVkng/PvkEoWtOWmP+Scc6saYWHWZYbndEEXxl24jw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@csstools/css-calc": "^2.1.3", + "@csstools/css-color-parser": "^3.0.9", + "@csstools/css-parser-algorithms": "^3.0.4", + "@csstools/css-tokenizer": "^3.0.3", + "lru-cache": "^10.4.3" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz", + "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz", + "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.7.tgz", + "integrity": "sha512-hnORnjP/1P/zFEndoeX+n+t1RwWRJiJpM/jO7FW32Kn9r5+sJB2JWOdYo4L6k78j15eCwY3Gm/7364B1EMwtNg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.29.7" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/types": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.7.tgz", + "integrity": "sha512-4zBIxpPzowiZpusoFkyGVwakdRJUyuH5PxQ/PrqghfdFWWasvnCdPfQXHrenDai+gyLARulZjZowCOj6fjT4pA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.29.7", + "@babel/helper-validator-identifier": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@bcoe/v8-coverage": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz", + "integrity": "sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@csstools/color-helpers": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/@csstools/color-helpers/-/color-helpers-5.1.0.tgz", + "integrity": "sha512-S11EXWJyy0Mz5SYvRmY8nJYTFFd1LCNV+7cXyAgQtOOuzb4EsgfqDufL+9esx72/eLhsRdGZwaldu/h+E4t4BA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/csstools" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + ], + "license": "MIT-0", + "engines": { + "node": ">=18" + } + }, + "node_modules/@csstools/css-calc": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/@csstools/css-calc/-/css-calc-2.1.4.tgz", + "integrity": "sha512-3N8oaj+0juUw/1H3YwmDDJXCgTB1gKU6Hc/bB502u9zR0q2vd786XJH9QfrKIEgFlZmhZiq6epXl4rHqhzsIgQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/csstools" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + ], + "license": "MIT", + "engines": { + "node": ">=18" + }, + "peerDependencies": { + "@csstools/css-parser-algorithms": "^3.0.5", + "@csstools/css-tokenizer": "^3.0.4" + } + }, + "node_modules/@csstools/css-color-parser": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/@csstools/css-color-parser/-/css-color-parser-3.1.0.tgz", + "integrity": "sha512-nbtKwh3a6xNVIp/VRuXV64yTKnb1IjTAEEh3irzS+HkKjAOYLTGNb9pmVNntZ8iVBHcWDA2Dof0QtPgFI1BaTA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/csstools" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + ], + "license": "MIT", + "dependencies": { + "@csstools/color-helpers": "^5.1.0", + "@csstools/css-calc": "^2.1.4" + }, + "engines": { + "node": ">=18" + }, + "peerDependencies": { + "@csstools/css-parser-algorithms": "^3.0.5", + "@csstools/css-tokenizer": "^3.0.4" + } + }, + "node_modules/@csstools/css-parser-algorithms": { + "version": "3.0.5", + "resolved": "https://registry.npmjs.org/@csstools/css-parser-algorithms/-/css-parser-algorithms-3.0.5.tgz", + "integrity": "sha512-DaDeUkXZKjdGhgYaHNJTV9pV7Y9B3b644jCLs9Upc3VeNGg6LWARAT6O+Q+/COo+2gg/bM5rhpMAtf70WqfBdQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/csstools" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + ], + "license": "MIT", + "engines": { + "node": ">=18" + }, + "peerDependencies": { + "@csstools/css-tokenizer": "^3.0.4" + } + }, + "node_modules/@csstools/css-tokenizer": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@csstools/css-tokenizer/-/css-tokenizer-3.0.4.tgz", + "integrity": "sha512-Vd/9EVDiu6PPJt9yAh6roZP6El1xHrdvIVGjyBsHR0RYwNHgL7FJPyIIW4fANJNG6FtyZfvlRPpFI4ZM/lubvw==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/csstools" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + ], + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz", + "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz", + "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz", + "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz", + "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz", + "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz", + "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz", + "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz", + "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz", + "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz", + "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz", + "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz", + "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz", + "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz", + "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz", + "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz", + "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz", + "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz", + "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz", + "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz", + "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz", + "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz", + "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz", + "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@isaacs/cliui": { + "version": "8.0.2", + "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz", + "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==", + "dev": true, + "license": "ISC", + "dependencies": { + "string-width": "^5.1.2", + "string-width-cjs": "npm:string-width@^4.2.0", + "strip-ansi": "^7.0.1", + "strip-ansi-cjs": "npm:strip-ansi@^6.0.1", + "wrap-ansi": "^8.1.0", + "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/@istanbuljs/schema": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/@istanbuljs/schema/-/schema-0.1.6.tgz", + "integrity": "sha512-+Sg6GCR/wy1oSmQDFq4LQDAhm3ETKnorxN+y5nbLULOR3P0c14f2Wurzj3/xqPXtasLFfHd5iRFQ7AJt4KH2cw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@jridgewell/gen-mapping": { + "version": "0.3.13", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", + "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.0", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", + "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "dev": true, + "license": "MIT" + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.31", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz", + "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/resolve-uri": "^3.1.0", + "@jridgewell/sourcemap-codec": "^1.4.14" + } + }, + "node_modules/@pkgjs/parseargs": { + "version": "0.11.0", + "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz", + "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==", + "dev": true, + "license": "MIT", + "optional": true, + "engines": { + "node": ">=14" + } + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.62.2.tgz", + "integrity": "sha512-6o7ZLZK+BeenkZCFNDXqpbjw9bD6nuWonvS/lwQJp7NoVVxm6p3qE7qQ5jGuBjiFsgvqjD8mZAU5oWxTmbOeOg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.62.2.tgz", + "integrity": "sha512-BaH7BllCACHoH1LguOU56UItGfUWjujlO65kS9LAodViaN4bwIKd7oeW/ZHJ/4ljr/7MIiENnNy3HJ0zXv8Zkw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.62.2.tgz", + "integrity": "sha512-v39RCCvj4He82I9sFmk+M1VZ0PLM9sfsLVikjfx2hYBNALhrrOR2D3JjQA6AhlaSOgcR+RzrKY7e1+bT6SUO/A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.62.2.tgz", + "integrity": "sha512-yl0y2vq3S3lHeuXhEdss6TWfKW8vkujImO12tn4ZkG/4oghr09LvdYm2RElVjokTQiUvDUGXLGsYeLqUMCKpGA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.62.2.tgz", + "integrity": "sha512-tT4pvt4qXD+vEoezupCWi+a1F0vvDiksiHc+PxRlYTOH1I6/X4id9jPxTP+Fg+545euaFT1jJVs4CEdHZAU1vw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.62.2.tgz", + "integrity": "sha512-6nU5F2wCW+qvCBhTn1pdIU3bzsIoF7EUwsCDRxilWGprQR6yd508YnH9+OKFCwpfS8pjZqDUmnCAr7exax0XCg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.62.2.tgz", + "integrity": "sha512-n1GJHPOvpIfhi3TmrCeh6S6URt9BFCt0KQE3qvexyGCTAKpR4Lg+eWvNZEqu7epxwus/8ElT3hacYEucm49SZg==", + "cpu": [ + "arm" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.62.2.tgz", + "integrity": "sha512-JqgflS8wEB+UXV/vS1RpRbifGBeN4D5lz8D8oOFbFZw4vedvdOgCFAjfBmIMdW3yL10XpQQ0Ambepw6MXrhOnA==", + "cpu": [ + "arm" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.62.2.tgz", + "integrity": "sha512-wnFJkogWvN4jm/hQRF2UBaeUmk20j5+DmHvoyWii2b8HJDyvz1MF2OU/6ynXt2KR63rbZLWkFpoytpdc/yBuSA==", + "cpu": [ + "arm64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.62.2.tgz", + "integrity": "sha512-HVu2bp0zhvJ8xHEV9+UUs7S90VadmBSY3LcIMvozbPo4AuMGDWlz3ymHLHZPX4hR67TKTt8Qp5PJ5RBg/i+RMQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.62.2.tgz", + "integrity": "sha512-mQqqAV8QaoSgr9I2fKDLY2BAVvmKjWoGiu/cSYQonsLvtqwEn1E4QYfnCOcp5zoEqNhsDYin1s6jx/VJmrxlZg==", + "cpu": [ + "loong64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.62.2.tgz", + "integrity": "sha512-IxKLoxCQ2IWi6bT2akyDUBGsOImDKB+sPp4EsTmwFQ/fMwpCKm8uLSSgP/Kx/QYUgKis6SEZ5/Nlhup0DIA0PQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.62.2.tgz", + "integrity": "sha512-Mk5ha2RQSgyFfmYYLkBpPnUk8D8FriBxesO1u9O75X0mHgXL1UQcH5Itl2lurWL2tj0RxV9b9tJgipac0hRY9A==", + "cpu": [ + "ppc64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.62.2.tgz", + "integrity": "sha512-CjvEnqJL/0/TQ3TXX3OPIJ/kmBellrWd4heXUmHeJlTnmwjKpSJzoehLaL6Xk0ZnMHBu9dZuFADNOrtjF4v+2w==", + "cpu": [ + "ppc64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.62.2.tgz", + "integrity": "sha512-1SiZbzwdkaDURsew/tSOrooKiYy7EQGT6m8ufavAi9NEyQb/6VuIxFXAL1fqa4iZe3g4NbNk4P7J32z2tw5Mgg==", + "cpu": [ + "riscv64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.62.2.tgz", + "integrity": "sha512-nQts12zJ3NQRoE6uYljOH89v7szzLDvG2JD/vsX+vGXU8w/At1GowTZ5/7qeFQ8m7L55rpR8Okugnuo5bgjy2Q==", + "cpu": [ + "riscv64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.62.2.tgz", + "integrity": "sha512-E9/ll019jhPIJgpzfZoIkBGhcz+kKNgVWYRY0zr9srBdPPFVpvOKW8VaJKUbeK+eZXyQF9ltME+Kk6affeaPgg==", + "cpu": [ + "s390x" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.62.2.tgz", + "integrity": "sha512-5BqxR/pshjey51iliyzTD5Xi3EN0aLmQ2lZ3lvefVV9c82BvrLo2/6OT55iifpWBufs6kdwWbuOKS841DrmK9A==", + "cpu": [ + "x64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.62.2.tgz", + "integrity": "sha512-uNN83XxQrRAh/w0/pmAfibcwyb6YWt4gP+dpnQKPVJshAloQ785ii8CT8ZCIxkGg9opVsvAlGhFitSm6D1Jjpg==", + "cpu": [ + "x64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.62.2.tgz", + "integrity": "sha512-srjEIxSH3LRnJN6THczDHWQplqEMFiAJrTab0msUryh9kwNpkICf3Ea6q6MN/2cZwRFUNx5w+h6Hpi4QuHS6Zg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.62.2.tgz", + "integrity": "sha512-8hOJnxgbyObnCm5AlRA3A931xX19xq80RjVTKgJOvEKWqJruP/Uf12IbAOaDjjEXYRewwHLfmF0YRIdK3OwKWA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.62.2.tgz", + "integrity": "sha512-mmF4AY1i0hG/bLWUctUq59gtmgaSIRa3cu/A3JFRp/sCNEme2bgDEiDS22P9FbnJB8NJNF4jPJiSP5RHQpUTDg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.62.2.tgz", + "integrity": "sha512-DZgkknc6jhHrk46V25vbAM0zZkyP0nSDkJB8/dRkLTxv470dOmWDqGoEJl/9A0dFfS7yE3REOwNDxpHwSLSt0Q==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.62.2.tgz", + "integrity": "sha512-T6xr6ucWSFto+VGajA8YH26LdpHRuP4YLHEKAtCWvJDOlnmWcDZVCI2Jmjr+IFHDlt2zRaTAKE4tfjTaWLgJBg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.62.2.tgz", + "integrity": "sha512-BfzEnDJOt9T8M989/lA37EcJgat01wLRnoi5dQf3QzOH7jzpqTAzdDbVfRljVr5r+jzKqpbHeyOfAaXxAd0PAA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@types/estree": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", + "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/lodash": { + "version": "4.17.24", + "resolved": "https://registry.npmjs.org/@types/lodash/-/lodash-4.17.24.tgz", + "integrity": "sha512-gIW7lQLZbue7lRSWEFql49QJJWThrTFFeIMJdp3eH4tKoxm1OvEPg02rm4wCCSHS0cL3/Fizimb35b7k8atwsQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@vitest/coverage-v8": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/coverage-v8/-/coverage-v8-2.1.9.tgz", + "integrity": "sha512-Z2cOr0ksM00MpEfyVE8KXIYPEcBFxdbLSs56L8PO0QQMxt/6bDj45uQfxoc96v05KW3clk7vvgP0qfDit9DmfQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@ampproject/remapping": "^2.3.0", + "@bcoe/v8-coverage": "^0.2.3", + "debug": "^4.3.7", + "istanbul-lib-coverage": "^3.2.2", + "istanbul-lib-report": "^3.0.1", + "istanbul-lib-source-maps": "^5.0.6", + "istanbul-reports": "^3.1.7", + "magic-string": "^0.30.12", + "magicast": "^0.3.5", + "std-env": "^3.8.0", + "test-exclude": "^7.0.1", + "tinyrainbow": "^1.2.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "@vitest/browser": "2.1.9", + "vitest": "2.1.9" + }, + "peerDependenciesMeta": { + "@vitest/browser": { + "optional": true + } + } + }, + "node_modules/@vitest/expect": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-2.1.9.tgz", + "integrity": "sha512-UJCIkTBenHeKT1TTlKMJWy1laZewsRIzYighyYiJKZreqtdxSos/S1t+ktRMQWu2CKqaarrkeszJx1cgC5tGZw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/spy": "2.1.9", + "@vitest/utils": "2.1.9", + "chai": "^5.1.2", + "tinyrainbow": "^1.2.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/mocker": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-2.1.9.tgz", + "integrity": "sha512-tVL6uJgoUdi6icpxmdrn5YNo3g3Dxv+IHJBr0GXHaEdTcw3F+cPKnsXFhli6nO+f/6SDKPHEK1UN+k+TQv0Ehg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/spy": "2.1.9", + "estree-walker": "^3.0.3", + "magic-string": "^0.30.12" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "msw": "^2.4.9", + "vite": "^5.0.0" + }, + "peerDependenciesMeta": { + "msw": { + "optional": true + }, + "vite": { + "optional": true + } + } + }, + "node_modules/@vitest/pretty-format": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-2.1.9.tgz", + "integrity": "sha512-KhRIdGV2U9HOUzxfiHmY8IFHTdqtOhIzCpd8WRdJiE7D/HUcZVD0EgQCVjm+Q9gkUXWgBvMmTtZgIG48wq7sOQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "tinyrainbow": "^1.2.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/runner": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-2.1.9.tgz", + "integrity": "sha512-ZXSSqTFIrzduD63btIfEyOmNcBmQvgOVsPNPe0jYtESiXkhd8u2erDLnMxmGrDCwHCCHE7hxwRDCT3pt0esT4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/utils": "2.1.9", + "pathe": "^1.1.2" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/snapshot": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-2.1.9.tgz", + "integrity": "sha512-oBO82rEjsxLNJincVhLhaxxZdEtV0EFHMK5Kmx5sJ6H9L183dHECjiefOAdnqpIgT5eZwT04PoggUnW88vOBNQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/pretty-format": "2.1.9", + "magic-string": "^0.30.12", + "pathe": "^1.1.2" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/spy": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-2.1.9.tgz", + "integrity": "sha512-E1B35FwzXXTs9FHNK6bDszs7mtydNi5MIfUWpceJ8Xbfb1gBMscAnwLbEu+B44ed6W3XjL9/ehLPHR1fkf1KLQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "tinyspy": "^3.0.2" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/utils": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-2.1.9.tgz", + "integrity": "sha512-v0psaMSkNJ3A2NMrUEHFRzJtDPFn+/VWZ5WxImB21T9fjucJRmS7xCS3ppEnARb9y11OAzaD+P2Ps+b+BGX5iQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/pretty-format": "2.1.9", + "loupe": "^3.1.2", + "tinyrainbow": "^1.2.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/agent-base": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz", + "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==", + "license": "MIT", + "dependencies": { + "debug": "4" + }, + "engines": { + "node": ">= 6.0.0" + } + }, + "node_modules/ansi-regex": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz", + "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/assertion-error": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz", + "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + } + }, + "node_modules/asynckit": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", + "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", + "license": "MIT" + }, + "node_modules/axios": { + "version": "1.18.1", + "resolved": "https://registry.npmjs.org/axios/-/axios-1.18.1.tgz", + "integrity": "sha512-3nTvFlvpn9Zu/RkHUqtc7/+al4UpRW5az71ap5zccp6e8RAYEzhMTecX8Dz1wWDYrPpUoB1HAQEGEAEvUr7S9g==", + "license": "MIT", + "dependencies": { + "follow-redirects": "^1.16.0", + "form-data": "^4.0.5", + "https-proxy-agent": "^5.0.1", + "proxy-from-env": "^2.1.0" + } + }, + "node_modules/balanced-match": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", + "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/brace-expansion": { + "version": "5.0.7", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.7.tgz", + "integrity": "sha512-7oFy703dxfY3/NLxC1fh2SUCQ0H9rmAY+5EpDVfXjUTTs+HEwR2nYaqLv+GWcTsumwxPfiz6CzCNkwXwBUwqCA==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^4.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/cac": { + "version": "6.7.14", + "resolved": "https://registry.npmjs.org/cac/-/cac-6.7.14.tgz", + "integrity": "sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/chai": { + "version": "5.3.3", + "resolved": "https://registry.npmjs.org/chai/-/chai-5.3.3.tgz", + "integrity": "sha512-4zNhdJD/iOjSH0A05ea+Ke6MU5mmpQcbQsSOkgdaUMJ9zTlDTD/GYlwohmIE2u0gaxHYiVHEn1Fw9mZ/ktJWgw==", + "dev": true, + "license": "MIT", + "dependencies": { + "assertion-error": "^2.0.1", + "check-error": "^2.1.1", + "deep-eql": "^5.0.1", + "loupe": "^3.1.0", + "pathval": "^2.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/check-error": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/check-error/-/check-error-2.1.3.tgz", + "integrity": "sha512-PAJdDJusoxnwm1VwW07VWwUN1sl7smmC3OKggvndJFadxxDRyFJBX/ggnu/KE4kQAB7a3Dp8f/YXC1FlUprWmA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 16" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/combined-stream": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz", + "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", + "license": "MIT", + "dependencies": { + "delayed-stream": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/cssstyle": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/cssstyle/-/cssstyle-4.6.0.tgz", + "integrity": "sha512-2z+rWdzbbSZv6/rhtvzvqeZQHrBaqgogqt85sqFNbabZOuFbCVFb8kPeEtZjiKkbrm395irpNKiYeFeLiQnFPg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@asamuzakjp/css-color": "^3.2.0", + "rrweb-cssom": "^0.8.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/cssstyle/node_modules/rrweb-cssom": { + "version": "0.8.0", + "resolved": "https://registry.npmjs.org/rrweb-cssom/-/rrweb-cssom-0.8.0.tgz", + "integrity": "sha512-guoltQEx+9aMf2gDZ0s62EcV8lsXR+0w8915TC3ITdn2YueuNjdAYh/levpU9nFaoChh9RUS5ZdQMrKfVEN9tw==", + "dev": true, + "license": "MIT" + }, + "node_modules/data-urls": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/data-urls/-/data-urls-5.0.0.tgz", + "integrity": "sha512-ZYP5VBHshaDAiVZxjbRVcFJpc+4xGgT0bK3vzy1HLN8jTO975HEbuYzZJcHoQEY5K1a0z8YayJkyVETa08eNTg==", + "dev": true, + "license": "MIT", + "dependencies": { + "whatwg-mimetype": "^4.0.0", + "whatwg-url": "^14.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/dayjs": { + "version": "1.11.21", + "resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.21.tgz", + "integrity": "sha512-98IT+HOahAisibz/yjKbzuOBwYcjJ7BCLPzARyHiyEBmRz4fatF+KPJszEHXsGYjUG234aH/cOjW1wwTbKUZlA==", + "license": "MIT" + }, + "node_modules/de-indent": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/de-indent/-/de-indent-1.0.2.tgz", + "integrity": "sha512-e/1zu3xH5MQryN2zdVaF0OrdNLUbvWxzMbi+iNA6Bky7l1RoP8a2fIbRocyHclXt/arDrrR6lL3TqFD9pMQTsg==", + "license": "MIT" + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/decimal.js": { + "version": "10.6.0", + "resolved": "https://registry.npmjs.org/decimal.js/-/decimal.js-10.6.0.tgz", + "integrity": "sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==", + "dev": true, + "license": "MIT" + }, + "node_modules/deep-eql": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-5.0.2.tgz", + "integrity": "sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/delayed-stream": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", + "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", + "license": "MIT", + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/eastasianwidth": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz", + "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==", + "dev": true, + "license": "MIT" + }, + "node_modules/emoji-regex": { + "version": "9.2.2", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", + "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==", + "dev": true, + "license": "MIT" + }, + "node_modules/entities": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz", + "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-module-lexer": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.7.0.tgz", + "integrity": "sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==", + "dev": true, + "license": "MIT" + }, + "node_modules/es-object-atoms": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz", + "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-set-tostringtag": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz", + "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.6", + "has-tostringtag": "^1.0.2", + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/esbuild": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz", + "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=12" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.21.5", + "@esbuild/android-arm": "0.21.5", + "@esbuild/android-arm64": "0.21.5", + "@esbuild/android-x64": "0.21.5", + "@esbuild/darwin-arm64": "0.21.5", + "@esbuild/darwin-x64": "0.21.5", + "@esbuild/freebsd-arm64": "0.21.5", + "@esbuild/freebsd-x64": "0.21.5", + "@esbuild/linux-arm": "0.21.5", + "@esbuild/linux-arm64": "0.21.5", + "@esbuild/linux-ia32": "0.21.5", + "@esbuild/linux-loong64": "0.21.5", + "@esbuild/linux-mips64el": "0.21.5", + "@esbuild/linux-ppc64": "0.21.5", + "@esbuild/linux-riscv64": "0.21.5", + "@esbuild/linux-s390x": "0.21.5", + "@esbuild/linux-x64": "0.21.5", + "@esbuild/netbsd-x64": "0.21.5", + "@esbuild/openbsd-x64": "0.21.5", + "@esbuild/sunos-x64": "0.21.5", + "@esbuild/win32-arm64": "0.21.5", + "@esbuild/win32-ia32": "0.21.5", + "@esbuild/win32-x64": "0.21.5" + } + }, + "node_modules/estree-walker": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz", + "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0" + } + }, + "node_modules/expect-type": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.4.0.tgz", + "integrity": "sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/follow-redirects": { + "version": "1.16.0", + "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.0.tgz", + "integrity": "sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw==", + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/RubenVerborgh" + } + ], + "license": "MIT", + "engines": { + "node": ">=4.0" + }, + "peerDependenciesMeta": { + "debug": { + "optional": true + } + } + }, + "node_modules/foreground-child": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz", + "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==", + "dev": true, + "license": "ISC", + "dependencies": { + "cross-spawn": "^7.0.6", + "signal-exit": "^4.0.1" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/form-data": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.6.tgz", + "integrity": "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ==", + "license": "MIT", + "dependencies": { + "asynckit": "^0.4.0", + "combined-stream": "^1.0.8", + "es-set-tostringtag": "^2.1.0", + "hasown": "^2.0.4", + "mime-types": "^2.1.35" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-intrinsic": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "function-bind": "^1.1.2", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/glob": { + "version": "10.5.0", + "resolved": "https://registry.npmjs.org/glob/-/glob-10.5.0.tgz", + "integrity": "sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==", + "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me", + "dev": true, + "license": "ISC", + "dependencies": { + "foreground-child": "^3.1.0", + "jackspeak": "^3.1.2", + "minimatch": "^9.0.4", + "minipass": "^7.1.2", + "package-json-from-dist": "^1.0.0", + "path-scurry": "^1.11.1" + }, + "bin": { + "glob": "dist/esm/bin.mjs" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/glob/node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/glob/node_modules/brace-expansion": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.2.tgz", + "integrity": "sha512-w5JZcKgdhDOgOwm8H+KgbosopHMuGcl6qbulwjtz3SM7I7P3yW1eAjzMPLrIE+NQ9vjgANKHWeMHnrT0OXW1oA==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0" + } + }, + "node_modules/glob/node_modules/minimatch": { + "version": "9.0.9", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.9.tgz", + "integrity": "sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.2" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-tostringtag": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz", + "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==", + "license": "MIT", + "dependencies": { + "has-symbols": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz", + "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/he": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz", + "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==", + "license": "MIT", + "bin": { + "he": "bin/he" + } + }, + "node_modules/html-encoding-sniffer": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-4.0.0.tgz", + "integrity": "sha512-Y22oTqIU4uuPgEemfz7NDJz6OeKf12Lsu+QC+s3BVpda64lTiMYCyGwg5ki4vFxkMwQdeZDl2adZoqUgdFuTgQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "whatwg-encoding": "^3.1.1" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/html-escaper": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz", + "integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==", + "dev": true, + "license": "MIT" + }, + "node_modules/http-proxy-agent": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-7.0.2.tgz", + "integrity": "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==", + "dev": true, + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.0", + "debug": "^4.3.4" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/http-proxy-agent/node_modules/agent-base": { + "version": "7.1.4", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz", + "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 14" + } + }, + "node_modules/https-proxy-agent": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz", + "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==", + "license": "MIT", + "dependencies": { + "agent-base": "6", + "debug": "4" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/iconv-lite": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz", + "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==", + "dev": true, + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-fullwidth-code-point": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", + "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-potential-custom-element-name": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz", + "integrity": "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "dev": true, + "license": "ISC" + }, + "node_modules/istanbul-lib-coverage": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz", + "integrity": "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=8" + } + }, + "node_modules/istanbul-lib-report": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz", + "integrity": "sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "istanbul-lib-coverage": "^3.0.0", + "make-dir": "^4.0.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/istanbul-lib-source-maps": { + "version": "5.0.6", + "resolved": "https://registry.npmjs.org/istanbul-lib-source-maps/-/istanbul-lib-source-maps-5.0.6.tgz", + "integrity": "sha512-yg2d+Em4KizZC5niWhQaIomgf5WlL4vOOjZ5xGCmF8SnPE/mDWWXgvRExdcpCgh9lLRRa1/fSYp2ymmbJ1pI+A==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@jridgewell/trace-mapping": "^0.3.23", + "debug": "^4.1.1", + "istanbul-lib-coverage": "^3.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/istanbul-reports": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.2.0.tgz", + "integrity": "sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "html-escaper": "^2.0.0", + "istanbul-lib-report": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jackspeak": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.4.3.tgz", + "integrity": "sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "@isaacs/cliui": "^8.0.2" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + }, + "optionalDependencies": { + "@pkgjs/parseargs": "^0.11.0" + } + }, + "node_modules/jsdom": { + "version": "25.0.1", + "resolved": "https://registry.npmjs.org/jsdom/-/jsdom-25.0.1.tgz", + "integrity": "sha512-8i7LzZj7BF8uplX+ZyOlIz86V6TAsSs+np6m1kpW9u0JWi4z/1t+FzcK1aek+ybTnAC4KhBL4uXCNT0wcUIeCw==", + "dev": true, + "license": "MIT", + "dependencies": { + "cssstyle": "^4.1.0", + "data-urls": "^5.0.0", + "decimal.js": "^10.4.3", + "form-data": "^4.0.0", + "html-encoding-sniffer": "^4.0.0", + "http-proxy-agent": "^7.0.2", + "https-proxy-agent": "^7.0.5", + "is-potential-custom-element-name": "^1.0.1", + "nwsapi": "^2.2.12", + "parse5": "^7.1.2", + "rrweb-cssom": "^0.7.1", + "saxes": "^6.0.0", + "symbol-tree": "^3.2.4", + "tough-cookie": "^5.0.0", + "w3c-xmlserializer": "^5.0.0", + "webidl-conversions": "^7.0.0", + "whatwg-encoding": "^3.1.1", + "whatwg-mimetype": "^4.0.0", + "whatwg-url": "^14.0.0", + "ws": "^8.18.0", + "xml-name-validator": "^5.0.0" + }, + "engines": { + "node": ">=18" + }, + "peerDependencies": { + "canvas": "^2.11.2" + }, + "peerDependenciesMeta": { + "canvas": { + "optional": true + } + } + }, + "node_modules/jsdom/node_modules/agent-base": { + "version": "7.1.4", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz", + "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 14" + } + }, + "node_modules/jsdom/node_modules/https-proxy-agent": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz", + "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==", + "dev": true, + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.2", + "debug": "4" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/lodash": { + "version": "4.18.1", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz", + "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==", + "license": "MIT" + }, + "node_modules/loupe": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/loupe/-/loupe-3.2.1.tgz", + "integrity": "sha512-CdzqowRJCeLU72bHvWqwRBBlLcMEtIvGrlvef74kMnV2AolS9Y8xUv1I0U/MNAWMhBlKIoyuEgoJ0t/bbwHbLQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/lru-cache": { + "version": "10.4.3", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz", + "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/magicast": { + "version": "0.3.5", + "resolved": "https://registry.npmjs.org/magicast/-/magicast-0.3.5.tgz", + "integrity": "sha512-L0WhttDl+2BOsybvEOLK7fW3UA0OQ0IQ2d6Zl2x/a6vVRs3bAY0ECOSHHeL5jD+SbOpOCUEi0y1DgHEn9Qn1AQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.25.4", + "@babel/types": "^7.25.4", + "source-map-js": "^1.2.0" + } + }, + "node_modules/make-dir": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-4.0.0.tgz", + "integrity": "sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==", + "dev": true, + "license": "MIT", + "dependencies": { + "semver": "^7.5.3" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/minimatch": { + "version": "10.2.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz", + "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "brace-expansion": "^5.0.5" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/minipass": { + "version": "7.1.3", + "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz", + "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==", + "dev": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": ">=16 || 14 >=14.17" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.15", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.15.tgz", + "integrity": "sha512-y7Wygv/7mEOvxTuEQDB8StXdMRBWf1kR/tlhAzBRUFkB2jfcLOAxO/SHmOO2zgz1pVgK29/kyupn059/bCHdjA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/nwsapi": { + "version": "2.2.24", + "resolved": "https://registry.npmjs.org/nwsapi/-/nwsapi-2.2.24.tgz", + "integrity": "sha512-7YRhZ3jS45LwmSCT4b2sVFHt/WuovaktDU07QrtOBY2PXskss5a9jfmR9jptyumwXST+rFjrmppMY1KT/yn35A==", + "dev": true, + "license": "MIT" + }, + "node_modules/package-json-from-dist": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz", + "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==", + "dev": true, + "license": "BlueOak-1.0.0" + }, + "node_modules/parse5": { + "version": "7.3.0", + "resolved": "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz", + "integrity": "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==", + "dev": true, + "license": "MIT", + "dependencies": { + "entities": "^6.0.0" + }, + "funding": { + "url": "https://github.com/inikulin/parse5?sponsor=1" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-scurry": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz", + "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "lru-cache": "^10.2.0", + "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0" + }, + "engines": { + "node": ">=16 || 14 >=14.18" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/pathe": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/pathe/-/pathe-1.1.2.tgz", + "integrity": "sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/pathval": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/pathval/-/pathval-2.0.1.tgz", + "integrity": "sha512-//nshmD55c46FuFw26xV/xFAaB5HF9Xdap7HJBBnrKdAd6/GxDBaNA1870O79+9ueg61cZLSVc+OaFlfmObYVQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 14.16" + } + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, + "node_modules/postcss": { + "version": "8.5.16", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.16.tgz", + "integrity": "sha512-vuwillviilfKZsg0VGj5R/YwwcHx4SLsIOI/7K6mQkWx+l5cUHTjj5g0AasTBcyXsbfTgrwsUNmVUb5xVwyPwg==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.12", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/proxy-from-env": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-2.1.0.tgz", + "integrity": "sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/rollup": { + "version": "4.62.2", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.62.2.tgz", + "integrity": "sha512-RFnrW4lhXA3s3eqHDZvN654g8OTjzRfqpIRJYczCGB6HzphckVAi/Qh4tbPUbRuDi7s1Llv8g/NspLkttY3gTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.9" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@rollup/rollup-android-arm-eabi": "4.62.2", + "@rollup/rollup-android-arm64": "4.62.2", + "@rollup/rollup-darwin-arm64": "4.62.2", + "@rollup/rollup-darwin-x64": "4.62.2", + "@rollup/rollup-freebsd-arm64": "4.62.2", + "@rollup/rollup-freebsd-x64": "4.62.2", + "@rollup/rollup-linux-arm-gnueabihf": "4.62.2", + "@rollup/rollup-linux-arm-musleabihf": "4.62.2", + "@rollup/rollup-linux-arm64-gnu": "4.62.2", + "@rollup/rollup-linux-arm64-musl": "4.62.2", + "@rollup/rollup-linux-loong64-gnu": "4.62.2", + "@rollup/rollup-linux-loong64-musl": "4.62.2", + "@rollup/rollup-linux-ppc64-gnu": "4.62.2", + "@rollup/rollup-linux-ppc64-musl": "4.62.2", + "@rollup/rollup-linux-riscv64-gnu": "4.62.2", + "@rollup/rollup-linux-riscv64-musl": "4.62.2", + "@rollup/rollup-linux-s390x-gnu": "4.62.2", + "@rollup/rollup-linux-x64-gnu": "4.62.2", + "@rollup/rollup-linux-x64-musl": "4.62.2", + "@rollup/rollup-openbsd-x64": "4.62.2", + "@rollup/rollup-openharmony-arm64": "4.62.2", + "@rollup/rollup-win32-arm64-msvc": "4.62.2", + "@rollup/rollup-win32-ia32-msvc": "4.62.2", + "@rollup/rollup-win32-x64-gnu": "4.62.2", + "@rollup/rollup-win32-x64-msvc": "4.62.2", + "fsevents": "~2.3.2" + } + }, + "node_modules/rrweb-cssom": { + "version": "0.7.1", + "resolved": "https://registry.npmjs.org/rrweb-cssom/-/rrweb-cssom-0.7.1.tgz", + "integrity": "sha512-TrEMa7JGdVm0UThDJSx7ddw5nVm3UJS9o9CCIZ72B1vSyEZoziDqBYP3XIoi/12lKrJR8rE3jeFHMok2F/Mnsg==", + "dev": true, + "license": "MIT" + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "dev": true, + "license": "MIT" + }, + "node_modules/saxes": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/saxes/-/saxes-6.0.0.tgz", + "integrity": "sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==", + "dev": true, + "license": "ISC", + "dependencies": { + "xmlchars": "^2.2.0" + }, + "engines": { + "node": ">=v12.22.7" + } + }, + "node_modules/semver": { + "version": "7.8.5", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz", + "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", + "dev": true, + "license": "MIT", + "dependencies": { + "shebang-regex": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/shebang-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", + "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/siginfo": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz", + "integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==", + "dev": true, + "license": "ISC" + }, + "node_modules/signal-exit": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz", + "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/stackback": { + "version": "0.0.2", + "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz", + "integrity": "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==", + "dev": true, + "license": "MIT" + }, + "node_modules/std-env": { + "version": "3.10.0", + "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.10.0.tgz", + "integrity": "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==", + "dev": true, + "license": "MIT" + }, + "node_modules/string-width": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz", + "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "eastasianwidth": "^0.2.0", + "emoji-regex": "^9.2.2", + "strip-ansi": "^7.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/string-width-cjs": { + "name": "string-width", + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/string-width-cjs/node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/string-width-cjs/node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "dev": true, + "license": "MIT" + }, + "node_modules/string-width-cjs/node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-ansi": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz", + "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.2.2" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/strip-ansi-cjs": { + "name": "strip-ansi", + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-ansi-cjs/node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/symbol-tree": { + "version": "3.2.4", + "resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz", + "integrity": "sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==", + "dev": true, + "license": "MIT" + }, + "node_modules/test-exclude": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/test-exclude/-/test-exclude-7.0.2.tgz", + "integrity": "sha512-u9E6A+ZDYdp7a4WnarkXPZOx8Ilz46+kby6p1yZ8zsGTz9gYa6FIS7lj2oezzNKmtdyyJNNmmXDppga5GB7kSw==", + "dev": true, + "license": "ISC", + "dependencies": { + "@istanbuljs/schema": "^0.1.2", + "glob": "^10.4.1", + "minimatch": "^10.2.2" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/tinybench": { + "version": "2.9.0", + "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz", + "integrity": "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/tinyexec": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-0.3.2.tgz", + "integrity": "sha512-KQQR9yN7R5+OSwaK0XQoj22pwHoTlgYqmUscPYoknOoWCWfj/5/ABTMRi69FrKU5ffPVh5QcFikpWJI/P1ocHA==", + "dev": true, + "license": "MIT" + }, + "node_modules/tinypool": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/tinypool/-/tinypool-1.1.1.tgz", + "integrity": "sha512-Zba82s87IFq9A9XmjiX5uZA/ARWDrB03OHlq+Vw1fSdt0I+4/Kutwy8BP4Y/y/aORMo61FQ0vIb5j44vSo5Pkg==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.0.0 || >=20.0.0" + } + }, + "node_modules/tinyrainbow": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/tinyrainbow/-/tinyrainbow-1.2.0.tgz", + "integrity": "sha512-weEDEq7Z5eTHPDh4xjX789+fHfF+P8boiFB+0vbWzpbnbsEr/GRaohi/uMKxg8RZMXnl1ItAi/IUHWMsjDV7kQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/tinyspy": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/tinyspy/-/tinyspy-3.0.2.tgz", + "integrity": "sha512-n1cw8k1k0x4pgA2+9XrOkFydTerNcJ1zWCO5Nn9scWHTD+5tp8dghT2x1uduQePZTZgd3Tupf+x9BxJjeJi77Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/tldts": { + "version": "6.1.86", + "resolved": "https://registry.npmjs.org/tldts/-/tldts-6.1.86.tgz", + "integrity": "sha512-WMi/OQ2axVTf/ykqCQgXiIct+mSQDFdH2fkwhPwgEwvJ1kSzZRiinb0zF2Xb8u4+OqPChmyI6MEu4EezNJz+FQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "tldts-core": "^6.1.86" + }, + "bin": { + "tldts": "bin/cli.js" + } + }, + "node_modules/tldts-core": { + "version": "6.1.86", + "resolved": "https://registry.npmjs.org/tldts-core/-/tldts-core-6.1.86.tgz", + "integrity": "sha512-Je6p7pkk+KMzMv2XXKmAE3McmolOQFdxkKw0R8EYNr7sELW46JqnNeTX8ybPiQgvg1ymCoF8LXs5fzFaZvJPTA==", + "dev": true, + "license": "MIT" + }, + "node_modules/tough-cookie": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-5.1.2.tgz", + "integrity": "sha512-FVDYdxtnj0G6Qm/DhNPSb8Ju59ULcup3tuJxkFb5K8Bv2pUXILbf0xZWU8PX8Ov19OXljbUyveOFwRMwkXzO+A==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "tldts": "^6.1.32" + }, + "engines": { + "node": ">=16" + } + }, + "node_modules/tr46": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/tr46/-/tr46-5.1.1.tgz", + "integrity": "sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==", + "dev": true, + "license": "MIT", + "dependencies": { + "punycode": "^2.3.1" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/vite": { + "version": "5.4.21", + "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.21.tgz", + "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "^0.21.3", + "postcss": "^8.4.43", + "rollup": "^4.20.0" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^18.0.0 || >=20.0.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^18.0.0 || >=20.0.0", + "less": "*", + "lightningcss": "^1.21.0", + "sass": "*", + "sass-embedded": "*", + "stylus": "*", + "sugarss": "*", + "terser": "^5.4.0" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + } + } + }, + "node_modules/vite-node": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/vite-node/-/vite-node-2.1.9.tgz", + "integrity": "sha512-AM9aQ/IPrW/6ENLQg3AGY4K1N2TGZdR5e4gu/MmmR2xR3Ll1+dib+nook92g4TV3PXVyeyxdWwtaCAiUL0hMxA==", + "dev": true, + "license": "MIT", + "dependencies": { + "cac": "^6.7.14", + "debug": "^4.3.7", + "es-module-lexer": "^1.5.4", + "pathe": "^1.1.2", + "vite": "^5.0.0" + }, + "bin": { + "vite-node": "vite-node.mjs" + }, + "engines": { + "node": "^18.0.0 || >=20.0.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/vitest": { + "version": "2.1.9", + "resolved": "https://registry.npmjs.org/vitest/-/vitest-2.1.9.tgz", + "integrity": "sha512-MSmPM9REYqDGBI8439mA4mWhV5sKmDlBKWIYbA3lRb2PTHACE0mgKwA8yQ2xq9vxDTuk4iPrECBAEW2aoFXY0Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/expect": "2.1.9", + "@vitest/mocker": "2.1.9", + "@vitest/pretty-format": "^2.1.9", + "@vitest/runner": "2.1.9", + "@vitest/snapshot": "2.1.9", + "@vitest/spy": "2.1.9", + "@vitest/utils": "2.1.9", + "chai": "^5.1.2", + "debug": "^4.3.7", + "expect-type": "^1.1.0", + "magic-string": "^0.30.12", + "pathe": "^1.1.2", + "std-env": "^3.8.0", + "tinybench": "^2.9.0", + "tinyexec": "^0.3.1", + "tinypool": "^1.0.1", + "tinyrainbow": "^1.2.0", + "vite": "^5.0.0", + "vite-node": "2.1.9", + "why-is-node-running": "^2.3.0" + }, + "bin": { + "vitest": "vitest.mjs" + }, + "engines": { + "node": "^18.0.0 || >=20.0.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "@edge-runtime/vm": "*", + "@types/node": "^18.0.0 || >=20.0.0", + "@vitest/browser": "2.1.9", + "@vitest/ui": "2.1.9", + "happy-dom": "*", + "jsdom": "*" + }, + "peerDependenciesMeta": { + "@edge-runtime/vm": { + "optional": true + }, + "@types/node": { + "optional": true + }, + "@vitest/browser": { + "optional": true + }, + "@vitest/ui": { + "optional": true + }, + "happy-dom": { + "optional": true + }, + "jsdom": { + "optional": true + } + } + }, + "node_modules/vue": { + "version": "2.6.10", + "resolved": "https://registry.npmjs.org/vue/-/vue-2.6.10.tgz", + "integrity": "sha512-ImThpeNU9HbdZL3utgMCq0oiMzAkt1mcgy3/E6zWC/G6AaQoeuFdsl9nDhTDU3X1R6FK7nsIUuRACVcjI+A2GQ==", + "deprecated": "Vue 2 has reached EOL and is no longer actively maintained. See https://v2.vuejs.org/eol/ for more details.", + "license": "MIT" + }, + "node_modules/vue-template-compiler": { + "version": "2.6.10", + "resolved": "https://registry.npmjs.org/vue-template-compiler/-/vue-template-compiler-2.6.10.tgz", + "integrity": "sha512-jVZkw4/I/HT5ZMvRnhv78okGusqe0+qH2A0Em0Cp8aq78+NK9TII263CDVz2QXZsIT+yyV/gZc/j/vlwa+Epyg==", + "license": "MIT", + "dependencies": { + "de-indent": "^1.0.2", + "he": "^1.1.0" + } + }, + "node_modules/w3c-xmlserializer": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/w3c-xmlserializer/-/w3c-xmlserializer-5.0.0.tgz", + "integrity": "sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==", + "dev": true, + "license": "MIT", + "dependencies": { + "xml-name-validator": "^5.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/webidl-conversions": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-7.0.0.tgz", + "integrity": "sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=12" + } + }, + "node_modules/whatwg-encoding": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-3.1.1.tgz", + "integrity": "sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ==", + "deprecated": "Use @exodus/bytes instead for a more spec-conformant and faster implementation", + "dev": true, + "license": "MIT", + "dependencies": { + "iconv-lite": "0.6.3" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/whatwg-mimetype": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-4.0.0.tgz", + "integrity": "sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/whatwg-url": { + "version": "14.2.0", + "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-14.2.0.tgz", + "integrity": "sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==", + "dev": true, + "license": "MIT", + "dependencies": { + "tr46": "^5.1.0", + "webidl-conversions": "^7.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "dev": true, + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/why-is-node-running": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz", + "integrity": "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==", + "dev": true, + "license": "MIT", + "dependencies": { + "siginfo": "^2.0.0", + "stackback": "0.0.2" + }, + "bin": { + "why-is-node-running": "cli.js" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/wrap-ansi": { + "version": "8.1.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz", + "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.1.0", + "string-width": "^5.0.1", + "strip-ansi": "^7.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/wrap-ansi-cjs": { + "name": "wrap-ansi", + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", + "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/wrap-ansi-cjs/node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/wrap-ansi-cjs/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/wrap-ansi-cjs/node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "dev": true, + "license": "MIT" + }, + "node_modules/wrap-ansi-cjs/node_modules/string-width": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/wrap-ansi-cjs/node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/ws": { + "version": "8.21.0", + "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.0.tgz", + "integrity": "sha512-Vsp28b7DRcimFQvrqu2Wek3z1iYxDCWqHYB8Qsnk/S4RfaCQzPGPyBNuVjJV3cd6UiKtUtp6sNM77gWvzcCH+g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10.0.0" + }, + "peerDependencies": { + "bufferutil": "^4.0.1", + "utf-8-validate": ">=5.0.2" + }, + "peerDependenciesMeta": { + "bufferutil": { + "optional": true + }, + "utf-8-validate": { + "optional": true + } + } + }, + "node_modules/xml-name-validator": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-5.0.0.tgz", + "integrity": "sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18" + } + }, + "node_modules/xmlchars": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/xmlchars/-/xmlchars-2.2.0.tgz", + "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==", + "dev": true, + "license": "MIT" + } + } +} diff --git a/Tests/frontend/package.json b/Tests/frontend/package.json new file mode 100644 index 000000000..f0aefbb08 --- /dev/null +++ b/Tests/frontend/package.json @@ -0,0 +1,27 @@ +{ + "name": "litemall-tests-frontend", + "private": true, + "type": "module", + "scripts": { + "test": "vitest run", + "test:ut": "vitest run tests/unit", + "test:it": "vitest run tests/it", + "test:browse-it": "vitest run tests/it/mobile-product-browsing-api.it.test.ts", + "coverage": "vitest run --coverage" + }, + "dependencies": { + "axios": "^1.7.9", + "dayjs": "^1.11.13", + "lodash": "^4.17.21", + "vue": "2.6.10", + "vue-template-compiler": "2.6.10" + }, + "devDependencies": { + "@vitest/coverage-v8": "2.1.9", + "@types/lodash": "^4.17.13", + "jsdom": "^25.0.1", + "typescript": "^5.7.2", + "vite": "^5.4.11", + "vitest": "^2.1.8" + } +} diff --git a/Tests/frontend/src/domain/litemallPaymentRules.ts b/Tests/frontend/src/domain/litemallPaymentRules.ts new file mode 100644 index 000000000..4df7b3471 --- /dev/null +++ b/Tests/frontend/src/domain/litemallPaymentRules.ts @@ -0,0 +1,67 @@ +export type OrderActionState = { + statusText: string; + canPay: boolean; + canCancel: boolean; + canRefund: boolean; + canConfirm: boolean; + canDelete: boolean; + canAftersale: boolean; +}; + +export function orderActionState(status: number): OrderActionState { + switch (status) { + case 101: + return state('未付款', { canPay: true, canCancel: true }); + case 102: + return state('已取消', { canDelete: true }); + case 103: + return state('已取消(系统)', { canDelete: true }); + case 201: + return state('已付款', { canRefund: true }); + case 202: + return state('订单取消，退款中'); + case 203: + return state('已退款', { canDelete: true }); + case 204: + return state('已超时团购'); + case 301: + return state('已发货', { canConfirm: true }); + case 401: + case 402: + return state(status === 401 ? '已收货' : '已收货(系统)', { + canDelete: true, + canAftersale: true + }); + default: + throw new Error(`unsupported litemall order status: ${status}`); + } +} + +export function checkoutSummary(input: { + goodsTotalPrice: number; + freightPrice: number; + couponPrice: number; + grouponPrice: number; + actualPrice: number; +}) { + return { + goods: input.goodsTotalPrice.toFixed(2), + freight: input.freightPrice.toFixed(2), + coupon: input.couponPrice.toFixed(2), + groupon: input.grouponPrice.toFixed(2), + payable: input.actualPrice.toFixed(2) + }; +} + +function state(statusText: string, enabled: Partial> = {}): OrderActionState { + return { + statusText, + canPay: false, + canCancel: false, + canRefund: false, + canConfirm: false, + canDelete: false, + canAftersale: false, + ...enabled + }; +} diff --git a/Tests/frontend/test-support/lodash-stub.ts b/Tests/frontend/test-support/lodash-stub.ts new file mode 100644 index 000000000..468428b34 --- /dev/null +++ b/Tests/frontend/test-support/lodash-stub.ts @@ -0,0 +1,2 @@ +export const isNumber = (value: unknown) => + typeof value === 'number' && !Number.isNaN(value); diff --git a/Tests/frontend/test-support/request-spy.ts b/Tests/frontend/test-support/request-spy.ts new file mode 100644 index 000000000..277ce659e --- /dev/null +++ b/Tests/frontend/test-support/request-spy.ts @@ -0,0 +1,24 @@ +export type RequestConfig = { + url: string; + method: string; + data?: unknown; + params?: unknown; +}; + +export const requestCalls: RequestConfig[] = []; + +export function resetRequestCalls() { + requestCalls.splice(0, requestCalls.length); +} +export default function request(config: RequestConfig) { + requestCalls.push(config); + return Promise.resolve({ + data: { + errno: 0, + errmsg: '成功', + data: { + echo: config + } + } + }); +} diff --git a/Tests/frontend/test-support/setup-browser.ts b/Tests/frontend/test-support/setup-browser.ts new file mode 100644 index 000000000..e2706a122 --- /dev/null +++ b/Tests/frontend/test-support/setup-browser.ts @@ -0,0 +1,31 @@ +const createMemoryStorage = (): Storage => { + const data = new Map(); + + return { + get length() { + return data.size; + }, + clear() { + data.clear(); + }, + getItem(key: string) { + return data.has(key) ? data.get(key)! : null; + }, + key(index: number) { + return Array.from(data.keys())[index] ?? null; + }, + removeItem(key: string) { + data.delete(key); + }, + setItem(key: string, value: string) { + data.set(key, String(value)); + } + }; +}; + +if (!window.localStorage) { + Object.defineProperty(window, 'localStorage', { + value: createMemoryStorage(), + configurable: true + }); +} diff --git a/Tests/frontend/test-support/vant-stub.ts b/Tests/frontend/test-support/vant-stub.ts new file mode 100644 index 000000000..0e62a6d19 --- /dev/null +++ b/Tests/frontend/test-support/vant-stub.ts @@ -0,0 +1,20 @@ +import { vi } from 'vitest'; + +export const Dialog = { + alert: vi.fn(() => Promise.resolve()) +}; + +export const Toast = { + fail: vi.fn(), + success: vi.fn() +}; + +export const Radio = { name: 'van-radio' }; +export const RadioGroup = { name: 'van-radio-group' }; +export const Card = { name: 'van-card' }; +export const Tag = { name: 'van-tag' }; +export const Field = { name: 'van-field' }; +export const SubmitBar = { name: 'van-submit-bar' }; +export const CouponCell = { name: 'van-coupon-cell' }; +export const CouponList = { name: 'van-coupon-list' }; +export const Popup = { name: 'van-popup' }; diff --git a/Tests/frontend/tests/it/mobile-order-api.it.test.ts b/Tests/frontend/tests/it/mobile-order-api.it.test.ts new file mode 100644 index 000000000..b8b71033f --- /dev/null +++ b/Tests/frontend/tests/it/mobile-order-api.it.test.ts @@ -0,0 +1,132 @@ +import { beforeEach, describe, expect, it } from 'vitest'; +import { + cartCheckout, + orderCancel, + orderConfirm, + orderDelete, + orderDetail, + orderRefund, + orderH5pay, + orderPrepay, + orderSubmit +} from '@/api/api.js'; +import { + requestCalls, + resetRequestCalls +} from '../../test-support/request-spy'; + +describe('mobile order API frontend integration contract', () => { + beforeEach(() => { + resetRequestCalls(); + }); + + it('MALL-PAY-AC07-FE-IT-001 sends order submit payload to /order/submit', async () => { + const payload = { + addressId: 7, + cartId: 9, + couponId: -1, + userCouponId: -1, + grouponLinkId: 0, + grouponRulesId: 0, + message: 'leave at front desk' + }; + + await orderSubmit(payload); + + expect(requestCalls).toEqual([ + { + url: '/order/submit', + method: 'post', + data: payload + } + ]); + }); + + it('MALL-PAY-AC01-FE-IT-001 sends JSAPI prepay request with orderId', async () => { + await orderPrepay({ orderId: 1001 }); + + expect(requestCalls[0]).toEqual({ + url: '/order/prepay', + method: 'post', + data: { orderId: 1001 } + }); + }); + + it('MALL-PAY-AC01-FE-IT-002 sends H5 pay request with orderId', async () => { + await orderH5pay({ orderId: 1001 }); + + expect(requestCalls[0]).toEqual({ + url: '/order/h5pay', + method: 'post', + data: { orderId: 1001 } + }); + }); + + it('MALL-PAY-AC07-FE-IT-002 sends checkout query parameters without mutating payload', async () => { + const query = { + cartId: 9, + addressId: 7, + couponId: -1, + userCouponId: -1, + grouponRulesId: 0 + }; + + await cartCheckout(query); + + expect(requestCalls[0]).toEqual({ + url: '/cart/checkout', + method: 'get', + params: query + }); + }); + + it('MALL-PAY-AC08-FE-IT-001 sends order detail query with orderId', async () => { + await orderDetail({ orderId: 1001 }); + + expect(requestCalls[0]).toEqual({ + url: '/order/detail', + method: 'get', + params: { orderId: 1001 } + }); + }); + + it('MALL-PAY-AC09-FE-IT-001 sends cancel request with orderId for unpaid compensation', async () => { + await orderCancel({ orderId: 1001 }); + + expect(requestCalls[0]).toEqual({ + url: '/order/cancel', + method: 'post', + data: { orderId: 1001 } + }); + }); + + it('MALL-PAY-AC12-FE-IT-001 sends refund request with orderId for paid order', async () => { + await orderRefund({ orderId: 1001 }); + + expect(requestCalls[0]).toEqual({ + url: '/order/refund', + method: 'post', + data: { orderId: 1001 } + }); + }); + + it('MALL-PAY-AC13-FE-IT-001 sends confirm request with orderId for shipped order', async () => { + await orderConfirm({ orderId: 1001 }); + + expect(requestCalls[0]).toEqual({ + url: '/order/confirm', + method: 'post', + data: { orderId: 1001 } + }); + }); + + it('MALL-PAY-AC14-FE-IT-001 sends delete request with orderId for closed order', async () => { + await orderDelete({ orderId: 1001 }); + + expect(requestCalls[0]).toEqual({ + url: '/order/delete', + method: 'post', + data: { orderId: 1001 } + }); + }); +}); diff --git a/Tests/frontend/tests/it/mobile-product-browsing-api.it.test.ts b/Tests/frontend/tests/it/mobile-product-browsing-api.it.test.ts new file mode 100644 index 000000000..57877a81f --- /dev/null +++ b/Tests/frontend/tests/it/mobile-product-browsing-api.it.test.ts @@ -0,0 +1,89 @@ +import { beforeEach, describe, expect, it } from 'vitest'; +import { + getHome, + goodsCategory, + goodsCount, + goodsDetail, + goodsList, + goodsRelated +} from '@/api/api.js'; +import { + requestCalls, + resetRequestCalls +} from '../../test-support/request-spy'; + +describe('mobile product browsing API frontend integration contract', () => { + beforeEach(() => { + resetRequestCalls(); + }); + + it('MALL-BROWSE-AC01-FE-IT-001 requests homepage merchandising blocks', async () => { + await getHome(); + + expect(requestCalls[0]).toEqual({ + url: '/home/index', + method: 'get' + }); + }); + + it('MALL-BROWSE-AC02-FE-IT-001 sends goods list filters and pagination unchanged', async () => { + const query = { + categoryId: 20, + brandId: 5, + keyword: '青瓷', + isNew: true, + isHot: false, + page: 3, + limit: 8, + sort: 'retail_price', + order: 'asc' + }; + + await goodsList(query); + + expect(requestCalls[0]).toEqual({ + url: '/goods/list', + method: 'get', + params: query + }); + }); + + it('MALL-BROWSE-AC03-FE-IT-001 requests goods detail by id', async () => { + await goodsDetail({ id: 100 }); + + expect(requestCalls[0]).toEqual({ + url: '/goods/detail', + method: 'get', + params: { id: 100 } + }); + }); + + it('MALL-BROWSE-AC04-FE-IT-001 requests related goods by id', async () => { + await goodsRelated({ id: 100 }); + + expect(requestCalls[0]).toEqual({ + url: '/goods/related', + method: 'get', + params: { id: 100 } + }); + }); + + it('MALL-BROWSE-AC05-FE-IT-001 requests category sibling filter data by id', async () => { + await goodsCategory({ id: 20 }); + + expect(requestCalls[0]).toEqual({ + url: '/goods/category', + method: 'get', + params: { id: 20 } + }); + }); + + it('MALL-BROWSE-AC06-FE-IT-001 requests on-sale goods count', async () => { + await goodsCount(); + + expect(requestCalls[0]).toEqual({ + url: '/goods/count', + method: 'get' + }); + }); +}); diff --git a/Tests/frontend/tests/unit/mobile-payment-rules.test.ts b/Tests/frontend/tests/unit/mobile-payment-rules.test.ts new file mode 100644 index 000000000..1de05088a --- /dev/null +++ b/Tests/frontend/tests/unit/mobile-payment-rules.test.ts @@ -0,0 +1,157 @@ +import { describe, expect, it, beforeEach } from 'vitest'; +import { yuan } from '@/filter/index.js'; +import { + getLocalStorage, + removeLocalStorage, + setLocalStorage +} from '@/utils/local-storage.js'; +import { + checkoutSummary, + orderActionState +} from '../../src/domain/litemallPaymentRules'; + +describe('mobile payment frontend unit rules', () => { + beforeEach(() => { + window.localStorage.clear(); + }); + + it('MALL-PAY-AC01-FE-UT-001 formats cents into yuan display text', () => { + expect(yuan(0)).toBe('¥0.00'); + expect(yuan(10000)).toBe('¥100.00'); + expect(yuan(105)).toBe('¥1.05'); + expect(yuan(1)).toBe('¥0.01'); + expect(yuan('10000')).toBe('10000'); + }); + + it('MALL-PAY-AC07-FE-UT-001 persists checkout identifiers in localStorage', () => { + setLocalStorage({ + AddressId: 7, + CartId: 9, + CouponId: -1, + UserCouponId: -1 + }); + + expect(getLocalStorage('AddressId', 'CartId', 'CouponId', 'UserCouponId')).toEqual({ + AddressId: '7', + CartId: '9', + CouponId: '-1', + UserCouponId: '-1' + }); + + removeLocalStorage('CouponId', 'UserCouponId'); + + expect(getLocalStorage('CouponId', 'UserCouponId')).toEqual({ + CouponId: null, + UserCouponId: null + }); + }); + + it('MALL-PAY-AC11-FE-UT-001 maps backend order status into visible actions', () => { + expect(orderActionState(101)).toEqual({ + statusText: '未付款', + canPay: true, + canCancel: true, + canRefund: false, + canConfirm: false, + canDelete: false, + canAftersale: false + }); + expect(orderActionState(102)).toEqual({ + statusText: '已取消', + canPay: false, + canCancel: false, + canRefund: false, + canConfirm: false, + canDelete: true, + canAftersale: false + }); + expect(orderActionState(103)).toEqual({ + statusText: '已取消(系统)', + canPay: false, + canCancel: false, + canRefund: false, + canConfirm: false, + canDelete: true, + canAftersale: false + }); + expect(orderActionState(201)).toEqual({ + statusText: '已付款', + canPay: false, + canCancel: false, + canRefund: true, + canConfirm: false, + canDelete: false, + canAftersale: false + }); + expect(orderActionState(202)).toEqual({ + statusText: '订单取消，退款中', + canPay: false, + canCancel: false, + canRefund: false, + canConfirm: false, + canDelete: false, + canAftersale: false + }); + expect(orderActionState(203)).toEqual({ + statusText: '已退款', + canPay: false, + canCancel: false, + canRefund: false, + canConfirm: false, + canDelete: true, + canAftersale: false + }); + expect(orderActionState(204)).toEqual({ + statusText: '已超时团购', + canPay: false, + canCancel: false, + canRefund: false, + canConfirm: false, + canDelete: false, + canAftersale: false + }); + expect(orderActionState(301)).toEqual({ + statusText: '已发货', + canPay: false, + canCancel: false, + canRefund: false, + canConfirm: true, + canDelete: false, + canAftersale: false + }); + expect(orderActionState(401)).toEqual({ + statusText: '已收货', + canPay: false, + canCancel: false, + canRefund: false, + canConfirm: false, + canDelete: true, + canAftersale: true + }); + expect(orderActionState(402)).toEqual({ + statusText: '已收货(系统)', + canPay: false, + canCancel: false, + canRefund: false, + canConfirm: false, + canDelete: true, + canAftersale: true + }); + }); + + it('MALL-PAY-AC03-FE-UT-001 summarizes payable amount with coupon and groupon discounts', () => { + expect(checkoutSummary({ + goodsTotalPrice: 120, + freightPrice: 10, + couponPrice: 15, + grouponPrice: 20, + actualPrice: 95 + })).toEqual({ + goods: '120.00', + freight: '10.00', + coupon: '15.00', + groupon: '20.00', + payable: '95.00' + }); + }); +}); diff --git a/Tests/frontend/vitest.config.ts b/Tests/frontend/vitest.config.ts new file mode 100644 index 000000000..f342032fe --- /dev/null +++ b/Tests/frontend/vitest.config.ts @@ -0,0 +1,54 @@ +import { defineConfig } from 'vitest/config'; +import { resolve } from 'node:path'; + +export default defineConfig({ + resolve: { + alias: [ + { + find: /^dayjs$/, + replacement: resolve(__dirname, 'node_modules/dayjs/dayjs.min.js') + }, + { + find: /^lodash$/, + replacement: resolve(__dirname, 'test-support/lodash-stub.ts') + }, + { + find: /^@\/utils\/request$/, + replacement: resolve(__dirname, 'test-support/request-spy.ts') + }, + { + find: 'vant', + replacement: resolve(__dirname, 'test-support/vant-stub.ts') + }, + { + find: '@', + replacement: resolve(__dirname, '../../litemall-vue/src') + } + ] + }, + test: { + environment: 'jsdom', + environmentOptions: { + jsdom: { + url: 'http://localhost/' + } + }, + setupFiles: ['test-support/setup-browser.ts'], + globals: true, + include: ['tests/**/*.test.ts'], + coverage: { + provider: 'v8', + reportsDirectory: 'coverage', + reporter: ['text', 'html', 'lcov', 'json-summary'], + allowExternal: true, + include: [ + resolve(__dirname, 'src/**/*.ts'), + resolve(__dirname, '../../litemall-vue/src/api/api.js') + ], + exclude: [ + 'test-support/**', + 'tests/**' + ] + } + } +}); diff --git a/Tests/performance/performance-gate.yml b/Tests/performance/performance-gate.yml new file mode 100644 index 000000000..919d2d0a1 --- /dev/null +++ b/Tests/performance/performance-gate.yml @@ -0,0 +1,111 @@ +version: 1 +project: litemall +quality_dimension: performance +status: planned-measurement +source_design: + - agent-skills/skills/performance-optimization + - agent-skills/agents/web-performance-auditor + - agent-skills/references/performance-checklist.md +metric_honesty_rule: + quick_mode: "No Lighthouse, CrUX, PageSpeed, DevTools trace, or RUM artifact is available. Metrics must be reported as not measured." + deep_mode: "At least one measurement artifact is available. Every metric must cite its source." + forbidden: + - "Do not infer Core Web Vitals from source code alone." + - "Do not mix lab and field data in one value." + - "Do not mark a performance gate as passed without an artifact path." +workflow: + - measure + - identify + - fix + - verify + - guard +frontend_targets: + lighthouse_performance: + target: 90 + source: "Lighthouse synthetic" + blocking: false + lcp_ms: + target: 2500 + source: "Core Web Vitals p75" + blocking: false + inp_ms: + target: 200 + source: "Core Web Vitals p75" + blocking: false + cls: + target: 0.1 + source: "Core Web Vitals p75" + blocking: false + initial_js_gzip_kb: + target: 200 + source: "bundle analyzer or CI artifact" + blocking: false +backend_targets: + order_detail_api_p95_ms: + target: 200 + source: "APM, k6, JMeter, or server timing artifact" + blocking: false + submit_order_api_p95_ms: + target: 300 + source: "APM, k6, JMeter, or server timing artifact" + blocking: false + pay_notify_api_p95_ms: + target: 200 + source: "APM, k6, JMeter, or server timing artifact" + blocking: false +audit_targets: + pages: + - id: PERF-PAGE-001 + name: mobile home + path: "/" + risks: + - slow LCP from images or initial bundle + - render-blocking scripts + - id: PERF-PAGE-002 + name: order detail + path: "/pages/ucenter/orderDetail/orderDetail" + risks: + - slow API response + - layout shifts in order status and action area + - id: PERF-PAGE-003 + name: checkout + path: "/pages/checkout/checkout" + risks: + - slow address/cart/coupon waterfall + - expensive synchronous rendering before submit + endpoints: + - id: PERF-API-001 + name: order detail + method: GET + path: "/wx/order/detail" + p95_ms: 200 + - id: PERF-API-002 + name: submit order + method: POST + path: "/wx/order/submit" + p95_ms: 300 + - id: PERF-API-003 + name: pay notify + method: POST + path: "/wx/order/pay-notify" + p95_ms: 200 +ci_gates: + pr_perf: + mode: quick + blocking: false + required_artifacts: + - performance-gate.yml validation + - source-level performance review + nightly_perf: + mode: deep + blocking: false + required_artifacts: + - Lighthouse JSON or DevTools trace + - API p95 report + release_perf: + mode: deep + blocking: true + required_artifacts: + - Lighthouse JSON + - API p95 report + - before/after comparison for any performance fix diff --git a/Tests/performance/validate-performance-gate.rb b/Tests/performance/validate-performance-gate.rb new file mode 100755 index 000000000..22e9a76fe --- /dev/null +++ b/Tests/performance/validate-performance-gate.rb @@ -0,0 +1,49 @@ +#!/usr/bin/env ruby +# frozen_string_literal: true + +require "yaml" + +path = File.expand_path("performance-gate.yml", __dir__) +gate = YAML.load_file(path) + +required_top = %w[ + version project quality_dimension status source_design metric_honesty_rule + workflow frontend_targets backend_targets audit_targets ci_gates +] + +missing = required_top.reject { |key| gate.key?(key) } +abort "Missing top-level fields: #{missing.join(', ')}" unless missing.empty? + +expected_workflow = %w[measure identify fix verify guard] +unless gate.fetch("workflow") == expected_workflow + abort "workflow must be #{expected_workflow.join(' -> ')}" +end + +honesty = gate.fetch("metric_honesty_rule") +%w[quick_mode deep_mode forbidden].each do |key| + abort "metric_honesty_rule.#{key} is required" unless honesty[key] +end + +frontend_targets = gate.fetch("frontend_targets") +%w[lighthouse_performance lcp_ms inp_ms cls initial_js_gzip_kb].each do |key| + target = frontend_targets[key] || abort("frontend target #{key} is required") + abort "frontend target #{key} must define target" unless target.key?("target") + abort "frontend target #{key} must define source" unless target["source"] +end + +backend_targets = gate.fetch("backend_targets") +%w[order_detail_api_p95_ms submit_order_api_p95_ms pay_notify_api_p95_ms].each do |key| + target = backend_targets[key] || abort("backend target #{key} is required") + abort "backend target #{key} must define target" unless target.key?("target") + abort "backend target #{key} must define source" unless target["source"] +end + +ci_gates = gate.fetch("ci_gates") +%w[pr_perf nightly_perf release_perf].each do |key| + lane = ci_gates[key] || abort("ci gate #{key} is required") + abort "ci gate #{key} must define mode" unless lane["mode"] + abort "ci gate #{key} must define required_artifacts" unless lane["required_artifacts"].is_a?(Array) +end + +puts "[performance] performance-gate.yml is valid" +puts "[performance] Current lane validates gate design only; measured Lighthouse/CrUX/API artifacts are required for Deep mode." diff --git a/Tests/scripts/run-layered-tests-script-test.sh b/Tests/scripts/run-layered-tests-script-test.sh new file mode 100644 index 000000000..69365ea61 --- /dev/null +++ b/Tests/scripts/run-layered-tests-script-test.sh @@ -0,0 +1,188 @@ +#!/usr/bin/env bash +set -euo pipefail + +SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)" +TMP_DIR="$(mktemp -d)" +trap 'rm -rf "$TMP_DIR"' EXIT + +NPM_CALLS_FILE="$TMP_DIR/npm-calls.log" +NPX_CALLS_FILE="$TMP_DIR/npx-calls.log" +MVN_CALLS_FILE="$TMP_DIR/mvn-calls.log" +JAVA_CALLS_FILE="$TMP_DIR/java-calls.log" +export NPM_CALLS_FILE +export NPX_CALLS_FILE +export MVN_CALLS_FILE +export JAVA_CALLS_FILE + +mkdir -p "$TMP_DIR/bin" +cat > "$TMP_DIR/bin/npm" <<'NPM' +#!/usr/bin/env bash +set -euo pipefail +echo "$*" >> "$NPM_CALLS_FILE" +case "${1:-}" in + ci|install) + mkdir -p node_modules + ;; + run|test) + ;; + *) + echo "unexpected npm command: $*" >&2 + exit 2 + ;; +esac +NPM +chmod +x "$TMP_DIR/bin/npm" +cat > "$TMP_DIR/bin/npx" <<'NPX' +#!/usr/bin/env bash +set -euo pipefail +echo "$*" >> "$NPX_CALLS_FILE" +NPX +chmod +x "$TMP_DIR/bin/npx" +cat > "$TMP_DIR/bin/mvn" <<'MVN' +#!/usr/bin/env bash +set -euo pipefail +echo "$*" >> "$MVN_CALLS_FILE" +mkdir -p Tests/backend/target +touch Tests/backend/target/jacoco.exec +for arg in "$@"; do + case "$arg" in + -DoutputDirectory=*) + output_dir="${arg#-DoutputDirectory=}" + mkdir -p "$output_dir" + touch "$output_dir/org.jacoco.cli-0.8.13-nodeps.jar" + ;; + esac +done +MVN +chmod +x "$TMP_DIR/bin/mvn" +cat > "$TMP_DIR/bin/java" <<'JAVA' +#!/usr/bin/env bash +set -euo pipefail +echo "$*" >> "$JAVA_CALLS_FILE" +JAVA +chmod +x "$TMP_DIR/bin/java" +export PATH="$TMP_DIR/bin:$PATH" + +source "$SCRIPT_DIR/run-layered-tests.sh" +export PATH="$TMP_DIR/bin:$PATH" + +fixture="$TMP_DIR/npm-project" +mkdir -p "$fixture/node_modules" +cat > "$fixture/package.json" <<'JSON' +{ + "name": "npm-deps-fixture", + "private": true, + "version": "1.0.0" +} +JSON +cat > "$fixture/package-lock.json" <<'JSON' +{ + "name": "npm-deps-fixture", + "lockfileVersion": 3, + "packages": { + "": { + "name": "npm-deps-fixture", + "version": "1.0.0" + } + } +} +JSON + +ensure_npm_deps "$fixture" +grep -qx "ci" "$NPM_CALLS_FILE" + +: > "$NPM_CALLS_FILE" +ensure_npm_deps "$fixture" +[[ ! -s "$NPM_CALLS_FILE" ]] + +cat > "$fixture/package-lock.json" <<'JSON' +{ + "name": "npm-deps-fixture", + "lockfileVersion": 3, + "packages": { + "": { + "name": "npm-deps-fixture", + "version": "1.0.1" + } + } +} +JSON + +ensure_npm_deps "$fixture" +grep -qx "ci" "$NPM_CALLS_FILE" + +performance_gate + +ROOT="$TMP_DIR/project" +mkdir -p "$ROOT/Tests/frontend/node_modules" "$ROOT/Tests/frontend/node_modules/.cache/litemall-tests" \ + "$ROOT/Tests/e2e/node_modules" "$ROOT/Tests/e2e/node_modules/.cache/litemall-tests" +cat > "$ROOT/Tests/frontend/package-lock.json" <<'JSON' +{ + "name": "frontend-coverage-fixture", + "lockfileVersion": 3, + "packages": { + "": { + "name": "frontend-coverage-fixture", + "version": "1.0.0" + } + } +} +JSON +lockfile_hash "$ROOT/Tests/frontend/package-lock.json" > "$ROOT/Tests/frontend/node_modules/.cache/litemall-tests/package-lock.sha256" +cat > "$ROOT/Tests/e2e/package-lock.json" <<'JSON' +{ + "name": "e2e-fixture", + "lockfileVersion": 3, + "packages": { + "": { + "name": "e2e-fixture", + "version": "1.0.0" + } + } +} +JSON +lockfile_hash "$ROOT/Tests/e2e/package-lock.json" > "$ROOT/Tests/e2e/node_modules/.cache/litemall-tests/package-lock.sha256" + +: > "$NPM_CALLS_FILE" +: > "$MVN_CALLS_FILE" +LAYER=coverage +main +grep -q -- "-Pcoverage" "$MVN_CALLS_FILE" +grep -qx "run coverage" "$NPM_CALLS_FILE" +grep -q -- "jacoco.exec" "$JAVA_CALLS_FILE" + +export LITEMALL_TESTS_SKIP_BACKEND_INSTALL=1 + +: > "$NPM_CALLS_FILE" +: > "$NPX_CALLS_FILE" +: > "$MVN_CALLS_FILE" +LAYER=browse-backend-ut +main +grep -q -- "-Dtest=WxProductBrowsingUnitTest" "$MVN_CALLS_FILE" + +: > "$MVN_CALLS_FILE" +LAYER=browse-contract +main +grep -q -- "-Dtest=ProductBrowsingContractTest" "$MVN_CALLS_FILE" + +: > "$NPM_CALLS_FILE" +LAYER=browse-frontend-it +main +grep -qx "run test:browse-it" "$NPM_CALLS_FILE" + +: > "$NPM_CALLS_FILE" +: > "$NPX_CALLS_FILE" +LAYER=browse-e2e +main +grep -qx "playwright install chromium" "$NPX_CALLS_FILE" +grep -qx "test -- tests/product-browsing-flow.spec.ts" "$NPM_CALLS_FILE" + +: > "$NPM_CALLS_FILE" +: > "$MVN_CALLS_FILE" +LAYER=browse-fast +main +grep -q -- "-Dtest=WxProductBrowsingUnitTest" "$MVN_CALLS_FILE" +grep -q -- "-Dtest=ProductBrowsingContractTest" "$MVN_CALLS_FILE" +grep -qx "run test:browse-it" "$NPM_CALLS_FILE" + +echo "[scripts] run-layered-tests npm dependency guard passed" diff --git a/Tests/scripts/run-layered-tests.sh b/Tests/scripts/run-layered-tests.sh new file mode 100755 index 000000000..ca7e88699 --- /dev/null +++ b/Tests/scripts/run-layered-tests.sh @@ -0,0 +1,260 @@ +#!/usr/bin/env bash +set -euo pipefail + +ROOT="$(cd "$(dirname "$0")/../.." && pwd)" +LAYER="${1:-fast}" +JAVA_HOME_FALLBACK="/opt/homebrew/Cellar/openjdk/26.0.1/libexec/openjdk.jdk/Contents/Home" +COLIMA_DOCKER_SOCKET="$HOME/.colima/default/docker.sock" +BACKEND_ARTIFACTS_INSTALLED=0 +JACOCO_VERSION="0.8.13" + +if [[ -z "${JAVA_HOME:-}" && -d "$JAVA_HOME_FALLBACK" ]]; then + export JAVA_HOME="$JAVA_HOME_FALLBACK" + export PATH="$JAVA_HOME/bin:$PATH" +fi + +if [[ -z "${DOCKER_HOST:-}" && -S "$COLIMA_DOCKER_SOCKET" ]]; then + export DOCKER_HOST="unix://$COLIMA_DOCKER_SOCKET" + export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE="${TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE:-/var/run/docker.sock}" + export DOCKER_API_VERSION="${DOCKER_API_VERSION:-1.40}" +fi + +ensure_backend_artifacts() { + if [[ "${LITEMALL_TESTS_SKIP_BACKEND_INSTALL:-0}" == "1" ]]; then + echo "[setup] Skipping backend module install because LITEMALL_TESTS_SKIP_BACKEND_INSTALL=1" + return + fi + + if [[ "$BACKEND_ARTIFACTS_INSTALLED" == "0" ]]; then + echo "[setup] Installing current litemall backend modules into local Maven repository..." + (cd "$ROOT" && mvn -q -DskipTests install) + BACKEND_ARTIFACTS_INSTALLED=1 + fi +} + +ensure_npm_deps() { + local dir="$1" + local lockfile="$dir/package-lock.json" + local sentinel_dir="$dir/node_modules/.cache/litemall-tests" + local sentinel="$sentinel_dir/package-lock.sha256" + + if [[ ! -d "$dir/node_modules" ]]; then + install_npm_deps "$dir" "$lockfile" "$sentinel_dir" "$sentinel" + return + fi + + if [[ -f "$lockfile" ]]; then + local expected_hash + expected_hash="$(lockfile_hash "$lockfile")" + if [[ ! -f "$sentinel" || "$(cat "$sentinel")" != "$expected_hash" ]]; then + install_npm_deps "$dir" "$lockfile" "$sentinel_dir" "$sentinel" + fi + fi +} + +install_npm_deps() { + local dir="$1" + local lockfile="$2" + local sentinel_dir="$3" + local sentinel="$4" + + echo "[setup] Installing npm dependencies in $dir..." + if [[ -f "$lockfile" ]]; then + (cd "$dir" && npm ci) + mkdir -p "$sentinel_dir" + lockfile_hash "$lockfile" > "$sentinel" + else + (cd "$dir" && npm install) + fi +} + +lockfile_hash() { + if command -v shasum >/dev/null 2>&1; then + shasum -a 256 "$1" | awk '{print $1}' + elif command -v sha256sum >/dev/null 2>&1; then + sha256sum "$1" | awk '{print $1}' + else + echo "Neither shasum nor sha256sum is available for package-lock hash checks." >&2 + exit 2 + fi +} + +script_checks() { + (cd "$ROOT" && bash Tests/scripts/run-layered-tests-script-test.sh) +} + +backend_ut() { + ensure_backend_artifacts + (cd "$ROOT" && mvn -q -f Tests/backend/pom.xml -Dtest='*UnitTest' test) +} + +browse_backend_ut() { + ensure_backend_artifacts + (cd "$ROOT" && mvn -q -f Tests/backend/pom.xml -Dtest=WxProductBrowsingUnitTest test) +} + +contract() { + ensure_backend_artifacts + (cd "$ROOT" && mvn -q -f Tests/backend/pom.xml -Dtest='*ContractTest' test) +} + +browse_contract() { + ensure_backend_artifacts + (cd "$ROOT" && mvn -q -f Tests/backend/pom.xml -Dtest=ProductBrowsingContractTest test) +} + +backend_it() { + ensure_backend_artifacts + (cd "$ROOT" && mvn -q -f Tests/backend/pom.xml -DskipITs=false verify) +} + +backend_coverage() { + ensure_backend_artifacts + (cd "$ROOT" && mvn -q -f Tests/backend/pom.xml -Pcoverage -DskipITs=false verify) + (cd "$ROOT" && mvn -q -f Tests/backend/pom.xml org.apache.maven.plugins:maven-dependency-plugin:3.6.1:copy \ + -Dartifact="org.jacoco:org.jacoco.cli:${JACOCO_VERSION}:jar:nodeps" \ + -DoutputDirectory="$ROOT/Tests/backend/target") + + local cli_jar + cli_jar="$(find "$ROOT/Tests/backend/target" -maxdepth 1 -name 'org.jacoco.cli-*nodeps.jar' -print -quit)" + if [[ -z "$cli_jar" ]]; then + echo "Unable to find JaCoCo CLI jar in Tests/backend/target" >&2 + exit 2 + fi + + mkdir -p "$ROOT/Tests/backend/target/site/jacoco" + java -jar "$cli_jar" report "$ROOT/Tests/backend/target/jacoco.exec" \ + --classfiles "$ROOT/litemall-core/target/classes" \ + --classfiles "$ROOT/litemall-db/target/classes" \ + --classfiles "$ROOT/litemall-wx-api/target/classes" \ + --sourcefiles "$ROOT/litemall-core/src/main/java" \ + --sourcefiles "$ROOT/litemall-db/src/main/java" \ + --sourcefiles "$ROOT/litemall-wx-api/src/main/java" \ + --html "$ROOT/Tests/backend/target/site/jacoco" \ + --xml "$ROOT/Tests/backend/target/site/jacoco/jacoco.xml" \ + --csv "$ROOT/Tests/backend/target/site/jacoco/jacoco.csv" + echo "[coverage] Backend report: Tests/backend/target/site/jacoco/index.html" +} + +frontend_ut() { + ensure_npm_deps "$ROOT/Tests/frontend" + (cd "$ROOT/Tests/frontend" && npm run test:ut) +} + +frontend_it() { + ensure_npm_deps "$ROOT/Tests/frontend" + (cd "$ROOT/Tests/frontend" && npm run test:it) +} + +browse_frontend_it() { + ensure_npm_deps "$ROOT/Tests/frontend" + (cd "$ROOT/Tests/frontend" && npm run test:browse-it) +} + +frontend_coverage() { + ensure_npm_deps "$ROOT/Tests/frontend" + (cd "$ROOT/Tests/frontend" && npm run coverage) + echo "[coverage] Frontend report: Tests/frontend/coverage/index.html" +} + +coverage() { + backend_coverage + frontend_coverage +} + +e2e() { + ensure_npm_deps "$ROOT/Tests/e2e" + (cd "$ROOT/Tests/e2e" && npx playwright install chromium && npm test) +} + +browse_e2e() { + ensure_npm_deps "$ROOT/Tests/e2e" + (cd "$ROOT/Tests/e2e" && npx playwright install chromium && npm test -- tests/product-browsing-flow.spec.ts) +} + +browse_fast() { + browse_backend_ut + browse_contract + browse_frontend_it +} + +performance_gate() { + (cd "$ROOT" && ruby Tests/performance/validate-performance-gate.rb) +} + +main() { + case "$LAYER" in + scripts) + script_checks + ;; + backend-ut) + backend_ut + ;; + browse-backend-ut) + browse_backend_ut + ;; + contract) + contract + ;; + browse-contract) + browse_contract + ;; + backend-it) + backend_it + ;; + backend-coverage) + backend_coverage + ;; + frontend-ut) + frontend_ut + ;; + frontend-it) + frontend_it + ;; + browse-frontend-it) + browse_frontend_it + ;; + frontend-coverage) + frontend_coverage + ;; + coverage) + coverage + ;; + e2e) + e2e + ;; + browse-e2e) + browse_e2e + ;; + performance-gate) + performance_gate + ;; + fast) + script_checks + backend_ut + contract + frontend_ut + frontend_it + ;; + browse-fast) + browse_fast + ;; + all) + script_checks + backend_ut + contract + frontend_ut + frontend_it + backend_it + e2e + ;; + *) + echo "Usage: $0 [scripts|backend-ut|browse-backend-ut|contract|browse-contract|backend-it|backend-coverage|frontend-ut|frontend-it|browse-frontend-it|frontend-coverage|coverage|e2e|browse-e2e|performance-gate|fast|browse-fast|all]" >&2 + exit 2 + ;; + esac +} + +if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then + main +fi diff --git a/Tests/test-index.yml b/Tests/test-index.yml new file mode 100644 index 000000000..9c17b0687 --- /dev/null +++ b/Tests/test-index.yml @@ -0,0 +1,198 @@ +version: 1 +project: litemall +feature: payment-callback-reliability +additional_features: + - product-browsing +feature_profiles: + product-browsing: + business_path: + - home + - goods-list + - goods-detail + - specification-and-stock + - related-goods + focused_commands: + fast: ./Tests/scripts/run-layered-tests.sh browse-fast + backend-ut: ./Tests/scripts/run-layered-tests.sh browse-backend-ut + contract: ./Tests/scripts/run-layered-tests.sh browse-contract + frontend-it: ./Tests/scripts/run-layered-tests.sh browse-frontend-it + e2e: ./Tests/scripts/run-layered-tests.sh browse-e2e + current_gaps: + - specification selection and zero-stock unavailable state have no dedicated executable test + - related-goods browser smoke displays recommendations but does not navigate into a new detail page + - product browsing contract test does not validate complete response schemas +case_id_format: MALL--AC- +test_case_id_format: MALL--AC-- +execution_id_format: EXEC-- +workflow_pack: ai-native-workflow/litemall-payment/workflow-pack.md +quality_dimensions: + functional: + status: implemented + owns: + - business rule correctness + - API contract stability + - persistence behavior + - browser golden path smoke + performance: + status: gate-config-implemented + owns: + - Core Web Vitals budget + - Lighthouse synthetic regression detection + - frontend bundle budget + - key API p95 response-time budget + - metric honesty rule + - Quick mode and Deep mode audit boundary + suggested_tools: + - Lighthouse CI + - Playwright trace + - k6 or JMeter + - application timing/APM + gate_config: + command: ./Tests/scripts/run-layered-tests.sh performance-gate + file: performance/performance-gate.yml + validator: performance/validate-performance-gate.rb + coverage: + status: implemented-reporting + owns: + - backend JaCoCo HTML/XML/CSV reports for litemall-core, litemall-db, and litemall-wx-api classes touched by tests + - frontend Vitest V8 HTML/LCOV/JSON summary reports for the training slice + - report generation without claiming whole-system percentage gates + gate_config: + command: ./Tests/scripts/run-layered-tests.sh coverage + backend_report: backend/target/site/jacoco/index.html + frontend_report: frontend/coverage/index.html + accessibility: + status: planned + owns: + - axe-core automated scan + - keyboard-only critical path + - focus order and focus visibility + - form labels and semantic structure + - color contrast checks + suggested_tools: + - axe-core + - Playwright accessibility checks + - keyboard navigation scripts + - manual screen-reader spot checks +functional_layers: + backend-ut: + command: ./Tests/scripts/run-layered-tests.sh backend-ut + owns: + - order status rules + - payment callback branch behavior + - amount consistency rejection + - idempotent duplicate callback behavior + - unpaid order cancellation compensation + - paid order refund transition + - groupon payment status transition + tests: + - backend/src/test/java/org/linlinjava/litemall/tests/unit/OrderUtilUnitTest.java + - backend/src/test/java/org/linlinjava/litemall/tests/unit/WxOrderPayNotifyUnitTest.java + - backend/src/test/java/org/linlinjava/litemall/tests/unit/WxOrderLifecycleUnitTest.java + - backend/src/test/java/org/linlinjava/litemall/tests/unit/OrderTimeoutCompensationServiceUnitTest.java + - backend/src/test/java/org/linlinjava/litemall/tests/unit/WxProductBrowsingUnitTest.java + backend-it: + command: ./Tests/scripts/run-layered-tests.sh backend-it + owns: + - MySQL mapper behavior + - optimistic lock update + - stock reduce/add behavior + - coupon release persistence + - groupon query/update behavior + tests: + - backend/src/test/java/org/linlinjava/litemall/tests/it/PaymentPersistenceIT.java + - backend/src/test/java/org/linlinjava/litemall/tests/it/OrderTimeoutConsistencyIT.java + contract: + command: ./Tests/scripts/run-layered-tests.sh contract + owns: + - frontend mobile order API paths + - backend controller mappings + - static OpenAPI apispec paths, methods, test case ids, and required fields + - WeChat callback XML required fields + - WeChat callback XML to SDK notify model compatibility + - order lifecycle endpoint stability + tests: + - backend/src/test/java/org/linlinjava/litemall/tests/contract/FrontendBackendOrderContractTest.java + - backend/src/test/java/org/linlinjava/litemall/tests/contract/PaymentNotifyXmlContractTest.java + - backend/src/test/java/org/linlinjava/litemall/tests/contract/ProductBrowsingContractTest.java + contracts: + - contracts/order-api.contract.json + - contracts/order-api.openapi.yaml + - contracts/order-api.apispec.md + - contracts/product-browsing-api.contract.json + frontend-ut: + command: ./Tests/scripts/run-layered-tests.sh frontend-ut + owns: + - amount display rule + - local storage helper behavior + - order action state mapping + - checkout payable summary formatting + tests: + - frontend/tests/unit/mobile-payment-rules.test.ts + - frontend/src/domain/litemallPaymentRules.ts + frontend-it: + command: ./Tests/scripts/run-layered-tests.sh frontend-it + owns: + - order submit payload + - prepay request + - h5pay request + - checkout query params + - order detail query + - cancel/refund/confirm/delete request payloads + tests: + - frontend/tests/it/mobile-order-api.it.test.ts + - frontend/tests/it/mobile-product-browsing-api.it.test.ts + e2e: + command: ./Tests/scripts/run-layered-tests.sh e2e + owns: + - browser payment golden path + - duplicate callback idempotency evidence + - unpaid order cancellation compensation smoke + tests: + - e2e/tests/payment-flow.spec.ts + - e2e/tests/product-browsing-flow.spec.ts + - e2e/fixtures/payment-flow-server.mjs +quality_gates: + coverage: + command: ./Tests/scripts/run-layered-tests.sh coverage + owns: + - backend JaCoCo coverage report + - frontend Vitest V8 coverage report + - coverage artifacts for training review + reports: + - backend/target/site/jacoco/index.html + - backend/target/site/jacoco/jacoco.xml + - backend/target/site/jacoco/jacoco.csv + - frontend/coverage/index.html + - frontend/coverage/lcov.info + - frontend/coverage/coverage-summary.json + performance-gate: + command: ./Tests/scripts/run-layered-tests.sh performance-gate + owns: + - performance budget configuration + - measure-identify-fix-verify-guard workflow + - Quick mode vs Deep mode honesty + - required artifact rules for PR, Nightly, and Release gates + tests: + - performance/performance-gate.yml + - performance/validate-performance-gate.rb +runner_checks: + scripts: + command: ./Tests/scripts/run-layered-tests.sh scripts + owns: + - layered test runner dispatch + - npm lockfile dependency refresh + - repeated npm install guard + tests: + - scripts/run-layered-tests-script-test.sh +optional_tools: + ui-agent-exploration: + command: manual; see Tests/ui-agent/page-agent-scenarios.md + ci_gate: false + owns: + - natural-language UI flow exploration + - selector repair suggestions + - candidate Playwright step generation + - manual UI evidence for workshop demos + tests: + - ui-agent/page-agent-scenarios.md diff --git a/Tests/ui-agent/page-agent-scenarios.md b/Tests/ui-agent/page-agent-scenarios.md new file mode 100644 index 000000000..75e4ce6fa --- /dev/null +++ b/Tests/ui-agent/page-agent-scenarios.md @@ -0,0 +1,72 @@ +# Page Agent UI Layer Scenarios + +This layer adds Page Agent as an optional AI Native UI exploration tool for litemall payment and order flows. It is not part of `./Tests/scripts/run-layered-tests.sh all` because it depends on an LLM key, external model behavior, and browser-resident automation. + +## Why It Fits The UI Layer + +Page Agent runs inside the webpage. Its `PageAgent` class combines an agent loop, DOM controller, and optional panel. The loop observes simplified DOM text, asks an OpenAI-compatible LLM for the next action, executes tools such as click, input, select, scroll, wait, and done, then returns history evidence. + +Use it to discover or repair UI flows, then convert stable traces into Playwright tests. + +## Local Setup + +Load Page Agent only in local development or a training harness: + +```html + +``` + +Then create an agent from the browser console or an internal local-only helper: + +```js +const agent = new window.PageAgent({ + model: window.sessionStorage.getItem('PAGE_AGENT_MODEL'), + baseURL: window.sessionStorage.getItem('PAGE_AGENT_BASE_URL'), + apiKey: window.sessionStorage.getItem('PAGE_AGENT_API_KEY'), + language: 'zh-CN', + maxSteps: 16, + transformPageContent: (content) => + content + .replace(/1[3-9]\d{9}/g, '***********') + .replace(/sk-[A-Za-z0-9_-]+/g, 'sk-***') +}) +``` + +Use a training-only key and clear session storage after the run. Do not commit real keys. Do not run this against production customer or payment data. + +## Output Evidence Contract + +```json +{ + "test_case_id": "MALL-PAY-AC08-UIAGENT-001", + "target_url": "http://localhost:8080/#/checkout", + "prompt": "使用测试用户提交订单并完成支付，确认订单最终只进入一次已支付状态。", + "model": "env:PAGE_AGENT_MODEL", + "seed": "local payment harness seeded order/cart/coupon", + "result_success": true, + "history_summary": [ + { "step": 0, "action": "click/input/scroll", "business_evidence": "..." } + ], + "candidate_playwright_steps": [ + "await page.getByRole('button', { name: '提交订单' }).click()" + ], + "decision": "convert-to-playwright" +} +``` + +## Scenario Pack + +| test_case_id | AC | Prompt | Required Evidence | Handoff | +| --- | --- | --- | --- | --- | +| MALL-PAY-AC08-UIAGENT-001 | AC08 | 使用测试用户提交订单并完成支付，确认订单最终只进入一次已支付状态。 | 订单状态可见为 paid/已付款；重复回调计数仍为 1。 | Convert successful trace to `e2e/tests/payment-flow.spec.ts` steps. | +| MALL-PAY-AC09-UIAGENT-001 | AC09 | 创建未支付订单后取消订单，确认库存和优惠券恢复。 | 页面显示订单取消；库存恢复；优惠券可再次使用。 | Convert only visible UI path to Playwright; keep stock/coupon DB proof in backend IT. | +| MALL-PAY-AC12-UIAGENT-001 | AC12 | 对已付款未发货订单发起退款申请，确认订单进入退款中。 | 页面出现退款中状态或退款申请成功提示。 | Convert to Playwright smoke only after backend UT keeps refund state rules. | + +## Review Rules + +- Page Agent output is exploratory evidence, not a passed E2E gate. +- Preserve `test_case_id` in prompt, trace file, generated script, and review note. +- Convert DOM indexes into stable Playwright selectors before accepting a script. +- Keep `experimentalScriptExecutionTool` disabled unless a security review approves local-only JavaScript execution. +- If Page Agent discovers a UI ambiguity, add a review finding instead of weakening assertions. +- If a trace is flaky or model-dependent, mark it `manual-evidence` and do not promote it to CI. diff --git a/litemall-architecture.html b/litemall-architecture.html new file mode 100644 index 000000000..c736696d0 --- /dev/null +++ b/litemall-architecture.html @@ -0,0 +1,13768 @@ + + + + + + + litemall 小商场系统架构 Diagram + + + + + + + + + + + +
+ +
+
+
+

litemall 小商场系统架构

+
+

Spring Boot + MyBatis + Vue + 微信小程序 全栈开源商城

+
+ + + + + + +
+ + litemall 小商场系统架构 + Spring Boot + MyBatis + Vue + 微信小程序 全栈开源商城 + + + + + + + + + + + + + + + + + + + + + + + + + Spring Boot 后端 + + + Vue 前端 + + + + + + + + + + + + + + + Vue管理后台 · Element UI · Vue 前端 · 前端 + + + + Vue管理后台 + Element UI + 前端 + + + + 微信小程序 · litemall-wx · Architecture component · 前端 + + + + 微信小程序 + litemall-wx + 前端 + + + + Vue移动端 · Vant UI · Vue 前端 · 前端 + + + + Vue移动端 + Vant UI + 前端 + + + + Admin API · Shiro鉴权 · :8083 · Spring Boot 后端 · 后端 + + + + Admin API + Shiro鉴权 · :8083 + 后端 + + + + Wx API · JWT鉴权 · :8082 · Spring Boot 后端 · 后端 + + + + Wx API + JWT鉴权 · :8082 + 后端 + + + + litemall-core · 存储 · 快递 · 二维码 · Spring Boot 后端 · 工具 + + + + litemall-core + 存储 · 快递 · 二维码 + 工具 + + + + 业务服务层 · 商品·订单·用户·购物车 · Spring Boot 后端 · 后端 + + + + 业务服务层 + 商品·订单·用户·购物车 + 后端 + + + + MyBatis DAO · 34实体 · 36Mapper · Spring Boot 后端 · 数据 + + + + MyBatis DAO + 34实体 · 36Mapper + 数据 + + + + MySQL · Druid连接池 · Architecture component · 数据库 + + + + MySQL + Druid连接池 + 数据库 + + + + 对象存储 · COS · OSS · Qiniu · Architecture component · 外部 + + + + 对象存储 + COS · OSS · Qiniu + 外部 + + + + 微信支付 · WeChat Pay API · Architecture component · 外部 + + + + 微信支付 + WeChat Pay API + 外部 + + + + + + Axios · REST API + + + + REST API + + + + Vant · REST API + + + + 调用 + + + + 调用 + + + + 引用 + + + + 依赖 + + + + JDBC + + + + 上传文件 + + + + + Legend + + + Frontend + + + + Backend + + + + Database + + + + Cloud + + + + External + + + +

+ + + + + + + + +
+ + +
+
+
+
+

前后端分离架构

+
+
    +
  • • 三个独立前端：微信小程序(C端)、Vue管理后台(B端)、Vue移动端(H5)
    • +
  • • 后端统一REST API：Admin API走Shiro会话鉴权，Wx API走JWT Token鉴权
    • +
+
+ +
+
+
+

数据访问分层

+
+
    +
  • • litemall-db模块：34个实体类映射MySQL表，36个MyBatis Mapper接口
    • +
  • • Service层封装分页查询(PageHelper)和事务操作：订单状态机、库存扣减、优惠券核验
    • +
+
+ +
+
+
+

外部服务集成

+
+
    +
  • • 对象存储三方案：腾讯云COS、阿里云OSS、七牛云Kodo
    • +
  • • 微信支付集成退款API，订单售后联动库存回滚和优惠券回收
    • +
+
+
+ +
+ + + + diff --git a/litemall-architecture.json b/litemall-architecture.json new file mode 100644 index 000000000..033bdf465 --- /dev/null +++ b/litemall-architecture.json @@ -0,0 +1,42 @@ +{ + "schema_version": 1, + "diagram_type": "architecture", + "meta": { + "title": "litemall 小商场系统架构", + "subtitle": "Spring Boot + MyBatis + Vue + 微信小程序 全栈开源商城", + "quality_profile": "showcase" + }, + "components": [ + { "id": "admin-vue", "type": "frontend", "label": "Vue管理后台", "sublabel": "Element UI", "pos": [40, 40], "size": [138, 56], "tag": "前端" }, + { "id": "wx-mini", "type": "frontend", "label": "微信小程序", "sublabel": "litemall-wx", "pos": [240, 40], "size": [130, 56], "tag": "前端" }, + { "id": "mobile-vue", "type": "frontend", "label": "Vue移动端", "sublabel": "Vant UI", "pos": [430, 40], "size": [130, 56], "tag": "前端" }, + { "id": "admin-api", "type": "backend", "label": "Admin API", "sublabel": "Shiro鉴权 · :8083", "pos": [90, 180], "size": [160, 60], "tag": "后端" }, + { "id": "wx-api", "type": "backend", "label": "Wx API", "sublabel": "JWT鉴权 · :8082", "pos": [350, 180], "size": [160, 60], "tag": "后端" }, + { "id": "core", "type": "backend", "label": "litemall-core", "sublabel": "存储 · 快递 · 二维码", "pos": [90, 340], "size": [148, 56], "tag": "工具" }, + { "id": "services", "type": "backend", "label": "业务服务层", "sublabel": "商品·订单·用户·购物车", "pos": [350, 340], "size": [172, 64], "tag": "后端" }, + { "id": "mybatis", "type": "database", "label": "MyBatis DAO", "sublabel": "34实体 · 36Mapper", "pos": [200, 510], "size": [152, 58], "tag": "数据" }, + { "id": "mysql", "type": "database", "label": "MySQL", "sublabel": "Druid连接池", "pos": [560, 510], "size": [128, 56], "tag": "数据库" }, + { "id": "cos-oss", "type": "cloud", "label": "对象存储", "sublabel": "COS · OSS · Qiniu", "pos": [90, 440], "size": [148, 56], "tag": "外部" }, + { "id": "wxpay", "type": "external", "label": "微信支付", "sublabel": "WeChat Pay API", "pos": [620, 610], "size": [128, 56], "tag": "外部" } + ], + "boundaries": [ + { "kind": "region", "label": "Spring Boot 后端", "wraps": ["admin-api", "wx-api", "core", "services", "mybatis"] }, + { "kind": "region", "label": "Vue 前端", "wraps": ["admin-vue", "mobile-vue"] } + ], + "connections": [ + { "from": "admin-vue", "to": "admin-api", "label": "Axios · REST API", "fromSide": "bottom", "toSide": "top" }, + { "from": "wx-mini", "to": "wx-api", "label": "REST API", "fromSide": "bottom", "toSide": "top" }, + { "from": "mobile-vue", "to": "wx-api", "label": "Vant · REST API", "variant": "dashed", "fromSide": "bottom", "toSide": "top" }, + { "from": "admin-api", "to": "services", "label": "调用", "fromSide": "bottom", "toSide": "top" }, + { "from": "wx-api", "to": "services", "label": "调用", "fromSide": "bottom", "toSide": "top", "labelDy": 28 }, + { "from": "core", "to": "services", "label": "引用", "variant": "dashed", "fromSide": "right", "toSide": "left" }, + { "from": "services", "to": "mybatis", "label": "依赖", "fromSide": "bottom", "toSide": "top" }, + { "from": "mybatis", "to": "mysql", "label": "JDBC" }, + { "from": "core", "to": "cos-oss", "label": "上传文件", "variant": "dashed", "fromSide": "bottom", "toSide": "top", "labelDy": 28 } + ], + "cards": [ + { "dot": "cyan", "title": "前后端分离架构", "items": ["三个独立前端：微信小程序(C端)、Vue管理后台(B端)、Vue移动端(H5)", "后端统一REST API：Admin API走Shiro会话鉴权，Wx API走JWT Token鉴权"] }, + { "dot": "amber", "title": "数据访问分层", "items": ["litemall-db模块：34个实体类映射MySQL表，36个MyBatis Mapper接口", "Service层封装分页查询(PageHelper)和事务操作：订单状态机、库存扣减、优惠券核验"] }, + { "dot": "emerald", "title": "外部服务集成", "items": ["对象存储三方案：腾讯云COS、阿里云OSS、七牛云Kodo", "微信支付集成退款API，订单售后联动库存回滚和优惠券回收"] } + ] +} \ No newline at end of file diff --git a/litemall-vue/src/api/api.js b/litemall-vue/src/api/api.js index 2f18a5020..50a8c0512 100644 --- a/litemall-vue/src/api/api.js +++ b/litemall-vue/src/api/api.js @@ -123,6 +123,13 @@ export function goodsDetail(query) { }) } const GoodsRelated='/goods/related'; //商品详情页的关联商品（大家都在看） +export function goodsRelated(query) { + return request({ + url: GoodsRelated, + method: 'get', + params: query + }) +} const BrandList='/brand/list'; //品牌列表 export function brandList(query) { diff --git a/litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/service/OrderTimeoutCompensationService.java b/litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/service/OrderTimeoutCompensationService.java new file mode 100644 index 000000000..e089b18de --- /dev/null +++ b/litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/service/OrderTimeoutCompensationService.java @@ -0,0 +1,87 @@ +package org.linlinjava.litemall.wx.service; + +import org.apache.commons.logging.Log; +import org.apache.commons.logging.LogFactory; +import org.linlinjava.litemall.db.domain.LitemallCouponUser; +import org.linlinjava.litemall.db.domain.LitemallOrder; +import org.linlinjava.litemall.db.domain.LitemallOrderGoods; +import org.linlinjava.litemall.db.service.LitemallCouponUserService; +import org.linlinjava.litemall.db.service.LitemallGoodsProductService; +import org.linlinjava.litemall.db.service.LitemallOrderGoodsService; +import org.linlinjava.litemall.db.service.LitemallOrderService; +import org.linlinjava.litemall.db.util.CouponUserConstant; +import org.linlinjava.litemall.db.util.OrderUtil; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.time.LocalDateTime; +import java.util.List; + +/** + * Owns the transaction boundary for unpaid-order timeout compensation. + * + *

The scheduler task is created with {@code new}, so it cannot provide a + * Spring transaction proxy itself. This Spring-managed service is the single + * transaction boundary for the order state and all resource compensations.

+ */ +@Service +public class OrderTimeoutCompensationService { + private final Log logger = LogFactory.getLog(OrderTimeoutCompensationService.class); + + private final LitemallOrderService orderService; + private final LitemallOrderGoodsService orderGoodsService; + private final LitemallGoodsProductService productService; + private final LitemallCouponUserService couponUserService; + + public OrderTimeoutCompensationService(LitemallOrderService orderService, + LitemallOrderGoodsService orderGoodsService, + LitemallGoodsProductService productService, + LitemallCouponUserService couponUserService) { + this.orderService = orderService; + this.orderGoodsService = orderGoodsService; + this.productService = productService; + this.couponUserService = couponUserService; + } + + /** + * Closes one unpaid order and compensates all resources atomically. + * + *

A non-unpaid order is an idempotent no-op. If the optimistic-lock + * update loses a race, another task owns the order and this invocation is + * also a safe no-op. Any resource failure is thrown so Spring rolls back + * the order transition and all prior compensation updates.

+ */ + @Transactional(rollbackFor = Exception.class) + public void closeOrder(Integer orderId) { + LitemallOrder order = orderService.findById(orderId); + if (order == null || !OrderUtil.isCreateStatus(order)) { + logger.info("超时订单任务跳过，订单号=" + orderId); + return; + } + + order.setOrderStatus(OrderUtil.STATUS_AUTO_CANCEL); + order.setEndTime(LocalDateTime.now()); + if (orderService.updateWithOptimisticLocker(order) == 0) { + logger.info("超时订单任务竞争失败，订单号=" + orderId); + return; + } + + List orderGoodsList = orderGoodsService.queryByOid(orderId); + for (LitemallOrderGoods orderGoods : orderGoodsList) { + if (productService.addStock(orderGoods.getProductId(), orderGoods.getNumber()) == 0) { + throw new RuntimeException("商品货品库存增加失败"); + } + } + + List couponUsers = couponUserService.findByOid(orderId); + for (LitemallCouponUser couponUser : couponUsers) { + couponUser.setStatus(CouponUserConstant.STATUS_USABLE); + couponUser.setUpdateTime(LocalDateTime.now()); + if (couponUserService.update(couponUser) == 0) { + throw new RuntimeException("优惠券返还失败"); + } + } + + logger.info("超时订单任务处理成功，订单号=" + orderId); + } +} diff --git a/litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/task/OrderUnpaidTask.java b/litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/task/OrderUnpaidTask.java index 42b16a304..d3ed8ed2a 100644 --- a/litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/task/OrderUnpaidTask.java +++ b/litemall-wx-api/src/main/java/org/linlinjava/litemall/wx/task/OrderUnpaidTask.java @@ -5,16 +5,7 @@ import org.linlinjava.litemall.core.system.SystemConfig; import org.linlinjava.litemall.core.task.Task; import org.linlinjava.litemall.core.util.BeanUtil; -import org.linlinjava.litemall.db.domain.LitemallOrder; -import org.linlinjava.litemall.db.domain.LitemallOrderGoods; -import org.linlinjava.litemall.db.service.LitemallGoodsProductService; -import org.linlinjava.litemall.db.service.LitemallOrderGoodsService; -import org.linlinjava.litemall.db.service.LitemallOrderService; -import org.linlinjava.litemall.db.util.OrderUtil; -import org.linlinjava.litemall.wx.service.WxOrderService; - -import java.time.LocalDateTime; -import java.util.List; +import org.linlinjava.litemall.wx.service.OrderTimeoutCompensationService; public class OrderUnpaidTask extends Task { private final Log logger = LogFactory.getLog(OrderUnpaidTask.class); @@ -33,41 +24,21 @@ public OrderUnpaidTask(Integer orderId){ @Override public void run() { logger.info("系统开始处理延时任务---订单超时未付款---" + this.orderId); - - LitemallOrderService orderService = BeanUtil.getBean(LitemallOrderService.class); - LitemallOrderGoodsService orderGoodsService = BeanUtil.getBean(LitemallOrderGoodsService.class); - LitemallGoodsProductService productService = BeanUtil.getBean(LitemallGoodsProductService.class); - WxOrderService wxOrderService = BeanUtil.getBean(WxOrderService.class); - - LitemallOrder order = orderService.findById(this.orderId); - if(order == null){ - return; - } - if(!OrderUtil.isCreateStatus(order)){ - return; - } - - // 设置订单已取消状态 - order.setOrderStatus(OrderUtil.STATUS_AUTO_CANCEL); - order.setEndTime(LocalDateTime.now()); - if (orderService.updateWithOptimisticLocker(order) == 0) { - throw new RuntimeException("更新数据已失效"); + try { + getCompensationService().closeOrder(this.orderId); + } catch (RuntimeException exception) { + logger.error("系统处理延时任务失败---订单超时未付款---订单号=" + this.orderId + + ", 原因=" + exception.getMessage(), exception); + throw exception; } - - // 商品货品数量增加 - Integer orderId = order.getId(); - List orderGoodsList = orderGoodsService.queryByOid(orderId); - for (LitemallOrderGoods orderGoods : orderGoodsList) { - Integer productId = orderGoods.getProductId(); - Short number = orderGoods.getNumber(); - if (productService.addStock(productId, number) == 0) { - throw new RuntimeException("商品货品库存增加失败"); - } - } - - //返还优惠券 - wxOrderService.releaseCoupon(orderId); - logger.info("系统结束处理延时任务---订单超时未付款---" + this.orderId); } + + /** + * Resolve the Spring-managed service at execution time because this task is + * deliberately created with {@code new} by the task scheduler. + */ + protected OrderTimeoutCompensationService getCompensationService() { + return BeanUtil.getBean(OrderTimeoutCompensationService.class); + } } diff --git a/skills b/skills new file mode 120000 index 000000000..501823006 --- /dev/null +++ b/skills @@ -0,0 +1 @@ +.agents/skills \ No newline at end of file