Documentation
¶
Overview ¶
admin_manage.go 管理端增强:用户 CRUD / 文件管理 / 富统计 Dashboard。 2026-10-10 IDL 化收编:由 customHandler 手写路由(transport/http/handler/ admin_manage.go)迁入 gen 层,路由经 idl/admin.thrift 注册(gen/router/admin)。 均在 /admin 组(AdminMiddleware 保护),操作经审计落 admin_operation_logs。
信封沿用 pkg/resp 助手(成功 code=0/"success"+trace_id,错误=业务码);仅 AdminTransferLogs / AdminListFilesFiltered 走 legacy 信封(code=200 + data{items,total,page,page_size}),item 字段为手工小写 snake_case,逐字段保形 (迁移前后响应 JSON 逐字段一致)。响应体由本文件的 map 构造 + resp/legacy 助手 产出,与迁移前逐字节一致;contracts/gen/admin 的 Req/Resp 仅作契约/文档。
Index ¶
- func AdminBatchDeleteFiles(ctx context.Context, c *app.RequestContext)
- func AdminBatchExtendFiles(ctx context.Context, c *app.RequestContext)
- func AdminBatchSetFilesStatus(ctx context.Context, c *app.RequestContext)
- func AdminCreateUser(ctx context.Context, c *app.RequestContext)
- func AdminDeleteFile(ctx context.Context, c *app.RequestContext)
- func AdminDeleteUser(ctx context.Context, c *app.RequestContext)
- func AdminDownloadFile(ctx context.Context, c *app.RequestContext)
- func AdminEnhancedStats(ctx context.Context, c *app.RequestContext)
- func AdminFileDetail(ctx context.Context, c *app.RequestContext)
- func AdminGetConfig(ctx context.Context, c *app.RequestContext)
- func AdminGetUserSettings(ctx context.Context, c *app.RequestContext)
- func AdminListFiles(ctx context.Context, c *app.RequestContext)
- func AdminListFilesFiltered(ctx context.Context, c *app.RequestContext)
- func AdminListUsers(ctx context.Context, c *app.RequestContext)
- func AdminListUsersFiltered(ctx context.Context, c *app.RequestContext)
- func AdminLogin(ctx context.Context, c *app.RequestContext)
- func AdminPurgeFiles(ctx context.Context, c *app.RequestContext)
- func AdminResetUserPassword(ctx context.Context, c *app.RequestContext)
- func AdminRestoreFiles(ctx context.Context, c *app.RequestContext)
- func AdminSetFileStatus(ctx context.Context, c *app.RequestContext)
- func AdminStats(ctx context.Context, c *app.RequestContext)
- func AdminStatsTrend(ctx context.Context, c *app.RequestContext)
- func AdminTransferLogs(ctx context.Context, c *app.RequestContext)
- func AdminUpdateConfig(ctx context.Context, c *app.RequestContext)
- func AdminUpdateFile(ctx context.Context, c *app.RequestContext)
- func AdminUpdateUser(ctx context.Context, c *app.RequestContext)
- func AdminUpdateUserSettings(ctx context.Context, c *app.RequestContext)
- func AdminUpdateUserStatus(ctx context.Context, c *app.RequestContext)
- func SetManageServices(svc *adminapp.Service, userSvc *userapp.Service)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AdminBatchDeleteFiles ¶ added in v0.15.2
func AdminBatchDeleteFiles(ctx context.Context, c *app.RequestContext)
AdminBatchDeleteFiles 批量删除文件 POST /admin/files/batch-delete {ids:[]}
func AdminBatchExtendFiles ¶ added in v0.15.2
func AdminBatchExtendFiles(ctx context.Context, c *app.RequestContext)
AdminBatchExtendFiles 批量延期 POST /admin/files/batch-extend {ids:[], expire_value, expire_style}
func AdminBatchSetFilesStatus ¶ added in v0.15.2
func AdminBatchSetFilesStatus(ctx context.Context, c *app.RequestContext)
AdminBatchSetFilesStatus 批量设置分享管控状态(滥用处置主路径:定位 IP 后批量禁用) POST /admin/files/batch-status {ids: [..], status: normal|blocked|pending_review}
func AdminCreateUser ¶ added in v0.15.2
func AdminCreateUser(ctx context.Context, c *app.RequestContext)
AdminCreateUser 创建用户 POST /admin/users {username,email,password,nickname,role,max_storage_quota}
func AdminDeleteFile ¶
func AdminDeleteFile(ctx context.Context, c *app.RequestContext)
AdminDeleteFile . @router /admin/files/:id [DELETE]
func AdminDeleteUser ¶ added in v0.15.2
func AdminDeleteUser(ctx context.Context, c *app.RequestContext)
AdminDeleteUser 删除用户(级联软删分享,带审计) DELETE /admin/users/:id
func AdminDownloadFile ¶ added in v0.15.2
func AdminDownloadFile(ctx context.Context, c *app.RequestContext)
AdminDownloadFile 管理端下载:302 到公开下载端点(附服务端签发的下载令牌) GET /admin/files/:id/download
func AdminEnhancedStats ¶ added in v0.15.2
func AdminEnhancedStats(ctx context.Context, c *app.RequestContext)
AdminEnhancedStats 富指标(昨日对比 / 下载总量 / top 后缀 / 类型分布 / 存储用量与配额) GET /admin/stats/enhanced
func AdminFileDetail ¶ added in v0.15.2
func AdminFileDetail(ctx context.Context, c *app.RequestContext)
AdminFileDetail 文件详情 GET /admin/files/:id
func AdminGetConfig ¶
func AdminGetConfig(ctx context.Context, c *app.RequestContext)
AdminGetConfig . @router /admin/config [GET]
func AdminGetUserSettings ¶ added in v0.15.2
func AdminGetUserSettings(ctx context.Context, c *app.RequestContext)
AdminGetUserSettings 获取"用户配置"段(生效值:持久化优先,回退 yaml)。 GET /admin/config/user
func AdminListFiles ¶
func AdminListFiles(ctx context.Context, c *app.RequestContext)
AdminListFiles . @router /admin/files [GET]
func AdminListFilesFiltered ¶ added in v0.15.2
func AdminListFilesFiltered(ctx context.Context, c *app.RequestContext)
AdminListFilesFiltered 管理端文件列表组合过滤。 GET /admin/files/filter?keyword=&user_id=&upload_type=&owner_ip=&status=&
min_size=&max_size=&created_after=&created_before=&expired=&page=&page_size=
相比 IDL /admin/files(仅 keyword)补充滥用定位维度,返回项含 owner_ip/status/ upload_type/user_id(owner_ip 仅管理端可见)。
func AdminListUsers ¶
func AdminListUsers(ctx context.Context, c *app.RequestContext)
AdminListUsers . @router /admin/users [GET]
func AdminListUsersFiltered ¶ added in v0.15.2
func AdminListUsersFiltered(ctx context.Context, c *app.RequestContext)
AdminListUsersFiltered 带筛选的用户列表(keyword/status/role) GET /admin/users/filter?keyword=&status=&role=&page=&page_size=
func AdminLogin ¶
func AdminLogin(ctx context.Context, c *app.RequestContext)
AdminLogin . @router /admin/login [POST]
func AdminPurgeFiles ¶ added in v0.15.2
func AdminPurgeFiles(ctx context.Context, c *app.RequestContext)
AdminPurgeFiles 彻底删除(DB 硬删 + 存储对象删除,不可恢复) POST /admin/files/purge {ids:[]}
func AdminResetUserPassword ¶ added in v0.15.2
func AdminResetUserPassword(ctx context.Context, c *app.RequestContext)
AdminResetUserPassword 管理员重置用户密码 POST /admin/users/:id/reset-password {password}
func AdminRestoreFiles ¶ added in v0.15.2
func AdminRestoreFiles(ctx context.Context, c *app.RequestContext)
AdminRestoreFiles 从回收站恢复(软删 → 存活) POST /admin/files/restore {ids:[]}
func AdminSetFileStatus ¶ added in v0.15.2
func AdminSetFileStatus(ctx context.Context, c *app.RequestContext)
AdminSetFileStatus 设置单个分享管控状态(禁用/恢复/待审) PUT /admin/files/:id/status {status: normal|blocked|pending_review}
func AdminStats ¶
func AdminStats(ctx context.Context, c *app.RequestContext)
AdminStats . @router /admin/stats [GET]
func AdminStatsTrend ¶ added in v0.15.2
func AdminStatsTrend(ctx context.Context, c *app.RequestContext)
AdminStatsTrend 趋势序列(连续 N 天,缺失日补 0): uploads 来自 file_codes 按天创建数,downloads 来自 transfer_logs(pkg/transfer 写入)。 GET /admin/stats/trend?days=7
func AdminTransferLogs ¶ added in v0.15.2
func AdminTransferLogs(ctx context.Context, c *app.RequestContext)
AdminTransferLogs 传输日志分页查询 GET /admin/logs/transfer?page=&page_size=&operation=&keyword=
func AdminUpdateConfig ¶
func AdminUpdateConfig(ctx context.Context, c *app.RequestContext)
AdminUpdateConfig . @router /admin/config [PUT]
func AdminUpdateFile ¶ added in v0.15.2
func AdminUpdateFile(ctx context.Context, c *app.RequestContext)
AdminUpdateFile 编辑文件(延期 / 改剩余次数) PUT /admin/files/:id {expire_value, expire_style, expired_count}
func AdminUpdateUser ¶ added in v0.15.2
func AdminUpdateUser(ctx context.Context, c *app.RequestContext)
AdminUpdateUser 更新用户(昵称/角色/状态/配额) PUT /admin/users/:id {nickname,role,status,max_storage_quota,max_upload_size}
func AdminUpdateUserSettings ¶ added in v0.15.2
func AdminUpdateUserSettings(ctx context.Context, c *app.RequestContext)
AdminUpdateUserSettings 在线更新"用户配置"段:写穿 DB 并即时生效 (注册开关/配额默认/会话时长)。 PUT /admin/config/user
func AdminUpdateUserStatus ¶
func AdminUpdateUserStatus(ctx context.Context, c *app.RequestContext)
AdminUpdateUserStatus . @router /admin/users/:id/status [PUT]
Types ¶
This section is empty.