Help us shape the future of Go! Take the 2026 Go Developer Survey

admin

package
v0.32.18 Latest Latest
Warning

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

 Go to latest Published: Oct 26, 2026 License: Apache-2.0 Imports: 22 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.