package api.v1

Get desktop application:
View/edit binary Protocol Buffers messages

定义标准的 CRUD API 接口

• rpc GetUser (GetUserRequest, GetUserResponse)

  gpt-4o-user.proto:31

  获取用户详细信息

  message GetUserRequest

  gpt-4o-user.proto:44

  请求和响应对象设计

  • string user_id = 1

    通过用户 ID 来获取用户信息

  message GetUserResponse

  gpt-4o-user.proto:48

  • optional UserDTO user = 1

    返回用户 DTO 对象

• rpc CreateUser (CreateUserRequest, UserResponse)

  gpt-4o-user.proto:34

  创建新用户

  message CreateUserRequest

  gpt-4o-user.proto:52

  • optional UserDTO user = 1

    传递完整的用户信息来创建用户

• rpc UpdateUser (UpdateUserRequest, UserResponse)

  gpt-4o-user.proto:37

  更新现有用户

  message UpdateUserRequest

  gpt-4o-user.proto:56

  • optional UserDTO user = 1

    更新时传递完整的用户信息

• rpc DeleteUser (DeleteUserRequest, DeleteUserResponse)

  gpt-4o-user.proto:40

  删除用户

  message DeleteUserRequest

  gpt-4o-user.proto:60

  • string user_id = 1

    通过用户 ID 来删除用户

  message DeleteUserResponse

  gpt-4o-user.proto:64

  • bool success = 1

    是否成功删除用户

用户状态枚举，符合常见 API 模型中状态设计

Used in: UserDTO

• ACTIVE = 0

  用户激活

• INACTIVE = 1

  用户非活跃

• DELETED = 2

  用户被删除

定义 API DTO 对象，通常反映领域模型的数据

Used in: CreateUserRequest, GetUserResponse, UpdateUserRequest, UserResponse

• string id = 1

  用户唯一标识符，通常使用 string 而非 int32

• string name = 2

  用户名称

• repeated string roles = 3

  用户角色列表

• map<string, string> metadata = 4

  用于存储键值对的附加元数据

• Status status = 5

  枚举类型，用户状态

• optional UserDTO.ContactInfo contact_info = 6

  嵌套消息，用于联系信息

嵌套的联系信息（作为 DTO 的一部分）

Used in: UserDTO

• string email = 1

• string phone = 2

通用响应消息

Used as response type in: UserService.CreateUser, UserService.UpdateUser

• optional UserDTO user = 1

  返回用户 DTO 对象