feat(mixin): add TableBaseMixin and UUIDTableBaseMixin for async CRUD operations

- Implemented TableBaseMixin providing generic CRUD methods and automatic timestamp management.
- Introduced UUIDTableBaseMixin for models using UUID as primary keys.
- Added ListResponse for standardized paginated responses.
- Created TimeFilterRequest and PaginationRequest for filtering and pagination parameters.
- Enhanced get_with_count method to return both item list and total count.
- Included validation for time filter parameters in TimeFilterRequest.
- Improved documentation and usage examples throughout the code.

models/redeem.py

@@ -1,10 +1,22 @@
-from sqlmodel import Field, text
-from .base import TableBase
+from enum import StrEnum
 
-class Redeem(TableBase, table=True):
+from sqlmodel import Field, text
+
+from .base import SQLModelBase
+from .mixin import TableBaseMixin
+
+
+class RedeemType(StrEnum):
+    """兑换码类型枚举"""
+    # [TODO] 补充具体兑换码类型
+    pass
+
+
+class Redeem(SQLModelBase, TableBaseMixin):
     """兑换码模型"""
 
-    type: int = Field(description="兑换码类型")
+    type: int = Field(default=0, sa_column_kwargs={"server_default": "0"})
+    """兑换码类型 [TODO] 待定义枚举"""
     product_id: int | None = Field(default=None, description="关联的商品/权益ID")
     num: int = Field(default=1, sa_column_kwargs={"server_default": "1"}, description="可兑换数量/时长等")
     code: str = Field(unique=True, index=True, description="兑换码，唯一")