docs: add package and exported symbol comments for revive lint compliance

internal/apps/oauth/audit.go

@@ -15,6 +15,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+// Package oauth 提供 OAuth/OIDC 认证与会话管理
 package oauth
 
 import (
@@ -26,6 +27,7 @@ import (
 	"github.com/gin-gonic/gin"
 )
 
+// LogForAudit 将登录鉴权审计日志写入 Logger
 func LogForAudit(ctx context.Context, user *model.User, c *gin.Context) {
 	auditLog := loginRequiredAuditLog{
 		UserID:     user.ID,

internal/apps/oauth/constants.go

@@ -22,6 +22,7 @@ import (
 	"time"
 )
 
+// Session 用户信息字段 Key
 const (
 	UserNameKey                     = "username"
 	UserIDKey                       = "user_id"
@@ -32,11 +33,13 @@ const (
 	PendingOAuthEmailKey            = "pending_oauth_email"
 )
 
+// OAuth State 缓存 Key 格式与过期时间
 const (
 	OAuthStateCacheKeyFormat     = "oauth:state:%s"
 	OAuthStateCacheKeyExpiration = 10 * time.Minute
 )
 
+// OAuth 授权用途常量
 const (
 	OAuthPurposeLogin = "login"
 	OAuthPurposeBind  = "bind"

internal/apps/oauth/errs.go

@@ -17,6 +17,7 @@ limitations under the License.
 
 package oauth
 
+// OAuth 认证相关错误消息
 const (
 	InvalidState                    = "非法登录请求"
 	IDTokenVerifyFailed             = "ID Token 验证失败"