admin

package
v0.33.5 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 4, 2026 License: Apache-2.0 Imports: 24 Imported by: 0

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 仅作契约/文档。

gen/handler/admin/localfiles_ops.go — 管理端残留手写面 IDL 化收编 （2026-10-10：local-files 三端点 / 设置测试端点 / 审计日志自 customHandler 与 routes_custom 内联闭包迁入，wire 形态逐字段保形）。

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AdminActivities added in v0.16.0 

func AdminActivities(ctx context.Context, c *app.RequestContext)

AdminActivities 管理操作审计日志分页。 @router /admin/activities [GET]

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 AdminDeleteLocalFile added in v0.16.0 

func AdminDeleteLocalFile(ctx context.Context, c *app.RequestContext)

AdminDeleteLocalFile 删除白名单目录内文件。 @router /admin/local-files [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 AdminImportLocalFile added in v0.16.0 

func AdminImportLocalFile(ctx context.Context, c *app.RequestContext)

AdminImportLocalFile 把白名单目录内文件导入为分享（配额/审核同链路）。 @router /admin/local-files/import [POST]

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 AdminListLocalFiles added in v0.16.0 

func AdminListLocalFiles(ctx context.Context, c *app.RequestContext)

AdminListLocalFiles 本地文件管理：白名单根目录+条目列表。 @router /admin/local-files [GET]

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 AdminTestOIDC added in v0.16.0 

func AdminTestOIDC(ctx context.Context, c *app.RequestContext)

AdminTestOIDC 验证当前生效 OIDC issuer discovery 可达。 从全局配置现构建 service（与热重建同源，「测的就是当前生效值」语义不变）。 @router /admin/oidc/test [POST]

func AdminTestSMTP added in v0.16.0 

func AdminTestSMTP(ctx context.Context, c *app.RequestContext)

AdminTestSMTP 用当前生效 SMTP 配置发送测试邮件。 @router /admin/notify/smtp/test [POST]

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]

func SetManageServices added in v0.15.2 

func SetManageServices(svc *adminapp.Service, userSvc *userapp.Service)

SetManageServices 注入管理端增强服务（bootstrap 调用）。 storage 注入不在此处——全站存储实例由 transport/http/handler.SetManageStorage 持有（share 多文件/寄件码 handler 依赖面），gen handler 不 import storage（规则6）。

func SetShareService added in v0.16.0 

func SetShareService(s *shareService.Service)

SetShareService 注入分享服务（bootstrap/wiring 调用）。

Types

This section is empty.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.