初始化

2026-03-05 21:27:11 +08:00
commit 130de0fd5d
140 changed files with 21972 additions and 0 deletions
--- a/.cursor/rules/015-testing.mdc
+++ b/.cursor/rules/015-testing.mdc
@@ -0,0 +1,133 @@
+---
+description: "测试规范 — 测试原则 + 后端 PHPUnit/PHPStan + 覆盖率目标"
+globs:
+  - "**/*.test.*"
+  - "**/*.spec.*"
+  - "**/__tests__/**"
+  - "**/vitest.config.*"
+  - "**/playwright.config.*"
+  - "Case-Database-Backend/tests/**/*.php"
+  - "Case-Database-Backend/phpunit.xml"
+  - "Case-Database-Backend/phpstan.neon"
+alwaysApply: false
+---
+
+# Testing Standards
+
+> 前端测试（Vitest / Vue Test Utils / Playwright）的具体工作流和模板
+> 由 `skill-vue-testing.mdc` 自动注入，本文件不再重复。
+
+## 通用原则
+
+- 测试行为 (behavior)，不测试实现细节
+- 每个测试只验证一件事
+- 不为覆盖率写无意义测试
+- 测试是文档的一部分
+
+---
+
+## 后端测试 (PHP Hyperf)
+
+### 测试金字塔
+
+| 类型 | 占比 | 框架 | 目标 |
+|------|------|------|------|
+| Unit | 60% | PHPUnit | Service、Repository、工具类 |
+| Integration | 30% | PHPUnit + TestContainer | API 端点、数据库交互 |
+| Static | 持续 | PHPStan (Level max) | 类型安全、潜在 Bug |
+
+### 覆盖率目标
+
+- 行覆盖率 >= 75%
+- 分支覆盖率 >= 70%
+- Service 层 100%
+- 关键业务路径 100%
+
+### 运行命令
+
+```bash
+composer test              # PHPUnit 所有测试
+composer test:unit         # 仅单元测试
+composer test:feature      # 仅功能测试 (API)
+composer test:coverage     # PHPUnit + 覆盖率
+composer analyse           # PHPStan 静态分析
+```
+
+### AAA 模式
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Unit\Service;
+
+use App\Service\Production\OrderService;
+use PHPUnit\Framework\TestCase;
+
+class OrderServiceTest extends TestCase
+{
+    public function testCalculateDiscountReturnsZeroBelowThreshold(): void
+    {
+        // Arrange
+        $service = new OrderService();
+        $amount = 99.0;
+
+        // Act
+        $discount = $service->calculateDiscount($amount);
+
+        // Assert
+        $this->assertEquals(0.0, $discount);
+    }
+}
+```
+
+### PHPUnit 目录结构
+
+```
+tests/
+├── Unit/                    # 纯单元测试（不依赖框架）
+│   ├── Service/
+│   ├── Repository/
+│   └── Utils/
+├── Feature/                 # 功能测试（HTTP API 级别）
+│   ├── Auth/
+│   ├── Production/
+│   └── Permission/
+├── bootstrap.php
+└── phpunit.xml
+```
+
+### PHPStan 配置
+
+```neon
+# phpstan.neon
+parameters:
+    level: max
+    paths:
+        - app
+    excludePaths:
+        - app/Command
+    ignoreErrors: []
+```
+
+---
+
+## 新功能必须附带
+
+### 前端
+
+- [ ] Happy path 测试
+- [ ] 边界条件测试
+- [ ] 错误情况测试
+- [ ] 权限/授权测试 (如涉及 v-auth / v-roles)
+
+> 前端测试的具体写法见 `skill-vue-testing.mdc`
+
+### 后端
+
+- [ ] Service 单元测试
+- [ ] API 功能测试 (HTTP 请求/响应)
+- [ ] 权限/数据权限测试 (如涉及 DataScope)
+- [ ] 事务回滚测试 (如涉及数据库写操作)
+- [ ] PHPStan 通过 (`composer analyse`)