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

internal/db/idgen/snowflake.go

@@ -15,6 +15,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+// Package idgen 提供分布式 ID 生成器
 package idgen
 
 import (
@@ -41,6 +42,7 @@ func init() {
 	log.Printf("[Snowflake] initialized with node ID: %d, epoch: 2025-12-01\n", nodeID)
 }
 
+// NextUint64ID 生成下一个分布式唯一 ID
 func NextUint64ID() uint64 {
 	return uint64(node.Generate().Int64())
 }

internal/db/postgres.go

@@ -203,6 +203,7 @@ func buildDSN(host string, port int, username, password string) string {
 	return pqURL.String()
 }
 
+// DB 返回带上下文追踪的 GORM 数据库实例
 func DB(ctx context.Context) *gorm.DB {
 	if db == nil {
 		return nil

internal/db/redis.go

@@ -32,6 +32,7 @@ import (
 )
 
 var (
+	// Redis 全局 Redis 客户端实例
 	Redis redis.UniversalClient
 )