IdentityService

用户认证与管理的核心服务，负责注册、登录、用户 CRUD、密码管理。支持 Admin 和 Customer 两种用户类型，认证方式分别为 Session Cookie（Admin）和 JWT Bearer（Customer）。

RPC 列表

Register

描述

注册新 customer 用户，自动创建关联的 Customer 记录。

Request — RegisterRequest

Response — RegisterResponse

错误码

示例

grpcurl -plaintext \
  -d '{"username":"testuser","email":"[email protected]","display_name":"Test","password":"Pass123!","verification_code":"123456"}' \
  localhost:50051 rustbill.identity.IdentityService/Register

const resp = await api.register({
  username: "testuser",
  email: "[email protected]",
  display_name: "Test",
  password: "Pass123!",
  verification_code: "123456"
});
// resp.user, resp.customer_id

SendVerificationCode

描述

向指定邮箱发送验证码，用于注册或密码重置流程。

Request — SendVerificationCodeRequest

Response — SendVerificationCodeResponse

错误码

示例

grpcurl -plaintext \
  -d '{"email":"[email protected]","purpose":"registration"}' \
  localhost:50051 rustbill.identity.IdentityService/SendVerificationCode

const resp = await api.sendVerificationCode({
  email: "[email protected]",
  purpose: "registration"
});
// resp.sent, resp.retry_after_secs

Login

描述

用户登录。user_type="admin" 时返回 session cookie（Set-Cookie 响应头），user_type="customer" 时返回 JWT token 对。

Request — LoginRequest

Response — LoginResponse

错误码

示例

# Admin 登录
grpcurl -plaintext \
  -d '{"username":"admin","password":"admin123","user_type":"admin"}' \
  localhost:50051 rustbill.identity.IdentityService/Login

# Customer 登录
grpcurl -plaintext \
  -d '{"username":"customer1","password":"pass123","user_type":"customer"}' \
  localhost:50051 rustbill.identity.IdentityService/Login

const resp = await api.login({
  username: "customer1",
  password: "pass123",
  user_type: "customer"
});
// resp.access_token → 存入 localStorage
// resp.user → 存入 auth store

RefreshToken

描述

使用 refresh token 获取新的 access token（仅 customer 用户）。

Request — RefreshTokenRequest

Response — RefreshTokenResponse

错误码

示例

grpcurl -plaintext \
  -d '{"refresh_token":"eyJhbGciOiJIUzI1NiIs..."}' \
  localhost:50051 rustbill.identity.IdentityService/RefreshToken

const resp = await api.refreshToken({
  refresh_token: localStorage.getItem("rustbill_customer_refresh")
});
// 更新 localStorage 中的 token

ListUsers

描述

分页查询用户列表，支持按角色、状态、用户类型、关键词、客户 ID 筛选。

Request — ListUsersRequest

Response — ListUsersResponse

错误码

示例

grpcurl -plaintext -H "authorization: Bearer <token>" \
  -d '{"pagination":{"page":1,"page_size":20},"user_type":"customer","is_active":true}' \
  localhost:50051 rustbill.identity.IdentityService/ListUsers

const resp = await api.listUsers({
  pagination: { page: 1, page_size: 20 },
  user_type: "customer",
  is_active: true
});

GetUser

描述

获取单个用户的详细信息。

Request — GetUserRequest

Response — GetUserResponse

错误码

示例

grpcurl -plaintext -H "authorization: Bearer <token>" \
  -d '{"id":"0192a123-4567-7890-abcd-ef0123456789"}' \
  localhost:50051 rustbill.identity.IdentityService/GetUser

UpdateUser

描述

更新用户信息（邮箱、显示名称、角色、状态等）。

Request — UpdateUserRequest

Response — UpdateUserResponse

错误码

示例

grpcurl -plaintext -H "authorization: Bearer <token>" \
  -d '{"id":"0192a123-...","display_name":"New Name","is_active":true}' \
  localhost:50051 rustbill.identity.IdentityService/UpdateUser

DeleteUser

描述

删除指定用户（仅 Admin 角色可操作）。

Request — DeleteUserRequest

Response — DeleteUserResponse

无字段。

错误码

示例

grpcurl -plaintext -H "authorization: Bearer <token>" \
  -d '{"id":"0192a123-4567-7890-abcd-ef0123456789"}' \
  localhost:50051 rustbill.identity.IdentityService/DeleteUser

ChangePassword

描述

当前登录用户修改自己的密码（需提供旧密码验证）。

Request — ChangePasswordRequest

Response — ChangePasswordResponse

无字段。

错误码

示例

grpcurl -plaintext -H "authorization: Bearer <token>" \
  -d '{"old_password":"oldpass","new_password":"newpass123!"}' \
  localhost:50051 rustbill.identity.IdentityService/ChangePassword

const resp = await api.changePassword({
  old_password: "oldpass",
  new_password: "newpass123!"
});

AdminResetPassword

描述

管理员重置指定用户的密码（仅 Admin 角色可操作，无需旧密码）。

Request — AdminResetPasswordRequest

Response — AdminResetPasswordResponse

无字段。

错误码

示例

grpcurl -plaintext -H "authorization: Bearer <token>" \
  -d '{"user_id":"0192a123-...","new_password":"resetpass123!"}' \
  localhost:50051 rustbill.identity.IdentityService/AdminResetPassword

GetMe

描述

获取当前登录用户的个人信息。Admin 用户从 session cookie 恢复身份，Customer 用户从 JWT 解析。

Request — GetMeRequest

无字段。

Response — GetMeResponse

错误码

示例

# Admin: cookie 自动携带
grpcurl -plaintext -H "cookie: rustbill_session=..." \
  -d '{}' \
  localhost:50051 rustbill.identity.IdentityService/GetMe

# Customer: JWT Bearer
grpcurl -plaintext -H "authorization: Bearer <token>" \
  -d '{}' \
  localhost:50051 rustbill.identity.IdentityService/GetMe

// Admin SPA (credentials: 'include' 自动携带 cookie)
const resp = await api.getMe({});
// Customer SPA
const resp = await api.getMe({});

Logout

描述

登出当前用户。Admin 端清除 session cookie，Customer 端客户端自行删除本地 token。

Request — LogoutRequest

无字段。

Response — LogoutResponse

无字段。

错误码

示例

grpcurl -plaintext -H "authorization: Bearer <token>" \
  -d '{}' \
  localhost:50051 rustbill.identity.IdentityService/Logout

const resp = await api.logout({});
// 清除 localStorage 中的 token
localStorage.removeItem("rustbill_customer_token");
localStorage.removeItem("rustbill_customer_refresh");

公共类型

UserInfo