Struct MemberService 

pub struct MemberService;

组员服务

提供组员账号生命周期管理的完整业务逻辑。 所有方法为关联函数，通过 &AppState 获取数据库连接和配置。

Implementations

impl MemberService

pub async fn login( state: &AppState, req: MemberLoginRequest, ) -> ApiResult<Option<String>>

验证凭证并签发 JWT Token。

查询组员 → bcrypt 密码比对 → 检查退组状态 → 签发 JWT。

返回值

• Ok(Some(token)) — 登录成功，返回 JWT 字符串，有效期由 jwt.expire_ms 配置
• Ok(None) — 用户名不存在或密码不匹配

Errors

• AppError::LoginExpired("你已经退出了提灯喵猫娘化计划喵……") — 组员 intern=4（已退组）
• AppError::Database — 数据库查询失败
• AppError::Internal — JWT 签发失败（密钥算法不可用）

pub async fn register_member(state: &AppState, reg: Reg) -> ApiResult<()>

注册新组员

pub async fn page( state: &AppState, page: i32, page_size: i32, username: Option<String>, post: Option<i16>, intern: Option<i16>, email: Option<String>, ) -> ApiResult<PageBean<MemberListVo>>

分页查询组员

pub async fn page_json( state: &AppState, page: i32, page_size: i32, username: Option<String>, post: Option<i16>, intern: Option<i16>, email: Option<String>, ) -> ApiResult<Arc<Vec<u8>>>

组员分页预序列化 JSON（短 TTL 缓存）

pub async fn get_member_list(state: &AppState) -> ApiResult<Vec<MemberCache>>

全量组员缓存列表

pub async fn get_member_list_json(state: &AppState) -> ApiResult<Arc<Vec<u8>>>

全量组员列表预序列化 JSON（缓存命中零拷贝）

pub async fn delete(state: &AppState, ids: Vec<i32>) -> ApiResult<()>

批量删除组员

pub async fn new_member( state: &AppState, req: MemberAddRequest, ) -> ApiResult<()>

新增组员

pub async fn get_member_by_id(state: &AppState, id: i32) -> ApiResult<Member>

按 ID 查询组员

pub async fn update_member( state: &AppState, req: MemberUpdateRequest, ) -> ApiResult<()>

更新组员信息

pub async fn update_member_self( state: &AppState, req: MemberSelfUpdateRequest, ) -> ApiResult<()>

组员自助更新昵称与 QQ

pub async fn find_stationed_mangas( state: &AppState, id: i32, ) -> ApiResult<Vec<StationedManga>>

查询组员常驻漫画（短 TTL 缓存）

pub async fn find_stationed_mangas_json( state: &AppState, id: i32, ) -> ApiResult<Arc<Vec<u8>>>

查询组员常驻漫画预序列化 JSON（短 TTL 缓存）

pub async fn update_member_password( state: &AppState, reset: ResetPassword, ) -> ApiResult<()>

修改密码

pub async fn page_episode( state: &AppState, page: i32, page_size: i32, id: i32, ) -> ApiResult<PageBean<MemberEpisodeVo>>

分页查询组员话数

pub async fn page_episode_json( state: &AppState, page: i32, page_size: i32, id: i32, ) -> ApiResult<Arc<Vec<u8>>>

组员话数分页预序列化 JSON（短 TTL 缓存）

pub async fn get_workbench_overview( state: &AppState, member_id: i32, ) -> ApiResult<MemberWorkbenchOverview>

工作台总览（统计卡 + Tab 计数）

pub async fn get_workbench_overview_json( state: &AppState, member_id: i32, ) -> ApiResult<Arc<Vec<u8>>>

工作台总览预序列化 JSON（短 TTL 缓存）

pub async fn page_workbench_tasks( state: &AppState, member_id: i32, tab: Option<&str>, view: Option<&str>, keyword: Option<&str>, page: i32, page_size: i32, ) -> ApiResult<PageBean<MemberWorkbenchTaskGroup>>

工作台在做任务按漫画组分页（Tab + View + 关键词 + 最新接稿时间排序）

pub async fn page_workbench_tasks_json( state: &AppState, member_id: i32, tab: Option<&str>, view: Option<&str>, keyword: Option<&str>, page: i32, page_size: i32, ) -> ApiResult<Arc<Vec<u8>>>

工作台在做任务漫画组分页预序列化 JSON（短 TTL 缓存）

pub async fn take_episode( state: &AppState, ep: MemberEpisode, operator: Option<Member>, ) -> ApiResult<()>

接稿

鉴权规则（管理员即审稿岗位 post=4，可重新分派，跳过以下校验）：

• 只能为本人接稿（ep.member_id == 当前登录 ID）
• 必须为正式组员（intern == 0）
• 必须持有对应岗位
• 岗位须空缺，防止覆盖他人接稿

pub async fn submit_episode( state: &AppState, ep: MemberEpisode, ) -> ApiResult<()>

交稿

pub async fn get_invitation_codes( state: &AppState, ) -> ApiResult<Vec<InvitationCode>>

邀请码列表

pub async fn delete_invitation_code(state: &AppState, id: i32) -> ApiResult<()>

删除邀请码

pub async fn add_invitation_code( state: &AppState, code: InvitationCode, ) -> ApiResult<()>

新增邀请码