OneAuth/tests

VBase Integration Tests

本目录包含 VBase 后端 API 的集成测试。这些测试验证 API 端点的功能，包括身份验证、权限检查和资源管理。

运行测试

在项目根目录下运行以下命令以执行所有测试：

go test -v ./tests/...

或者运行单个测试文件：

go test -v ./tests/auth_test.go

测试结构

测试设计为在隔离环境中运行，使用临时 SQLite 数据库和内存 Redis 模拟。

1. 全局设置 (main_test.go)

• TestMain: 测试套件的入口点。
  • 初始化 Vigo 应用程序。
  • 设置内存 SQLite 数据库 (:memory:)。
  • 模拟 Redis 客户端。
  • 运行所有测试。
  • 执行后无需清理资源。

2. 用户设置 (helpers_test.go)

• ensureUsers: 一个辅助函数，由需要身份验证的测试调用。
  • 检查全局 Token (AdminToken, User1Token, User2Token) 是否已设置。
  • 如果未设置，它会注册并登录三个标准测试用户：
    • admin_test (管理员)
    • user1_test (普通用户)
    • user2_test (普通用户)
  • 将它们的 ID 和 Token 存储在全局变量中，供跨测试文件使用。

3. 测试场景

• none_auth_test.go: 检查公开端点，并验证受保护端点拒绝未认证请求。
• auth_test.go: 测试用户生命周期事件（注册 -> 登录 -> 获取/更新个人资料 -> 登出）。
• resource_perm_test.go: 验证用户除非获得授权（例如管理员），否则无法修改其他用户的数据。
• org_permission_test.go: 测试组织基于角色的访问控制 (RBAC)（创建组织 -> 添加成员 -> 验证角色）。
• org_load_middleware_test.go: 专门测试 LoadOrg 中间件，该中间件强制执行组织特定端点的成员资格检查。

开发注意事项

• 全局状态: 我们在 main_test.go 中使用全局变量（如 AdminToken, User1ID）在测试函数之间共享状态。这模拟了测试运行期间的持久环境。
• 幂等性: ensureUsers 辅助函数设计为幂等的。它会优雅地处理"用户已存在"错误，允许测试在不手动清理数据库的情况下重新运行（尽管 TestMain 通常会重置数据库）。
• 辅助函数: 使用 doRequest, assertStatus, 和 decodeResponse (在 helpers_test.go 中) 保持测试代码整洁一致。
• 数据库隔离: 测试使用内存数据库 (:memory:) 以避免干扰开发数据库，并提供更快的执行速度。

添加新测试

1. 在此目录下创建一个新的 _test.go 文件。
2. 使用 package tests。
3. 如果需要已认证的用户，请在测试函数开头调用 ensureUsers(t)。
4. 使用 doRequest 与 API 交互。

func TestNewFeature(t *testing.T) {
    ensureUsers(t) // 确保 User1Token 可用

    t.Run("Scenario Description", func(t *testing.T) {
        resp := doRequest(t, "GET", "/api/new-feature", nil, User1Token)
        assertStatus(t, resp, 200)
    })
}