chore: initial commit — leaudit-platform project skeleton

17-table PostgreSQL schema with full Chinese column comments,
FastAPI project structure (admin/common/modules),
DSL rule files, and schema migration scripts.

fastapi_common/fastapi_common_web/controller.py

@@ -0,0 +1,20 @@
+"""BaseController —— 所有控制器继承此类。"""
+
+from __future__ import annotations
+
+from fastapi import APIRouter
+
+
+class BaseController:
+    """控制器基类。
+
+    子类在 __init__ 中用 @self.router.get/post 注册路由。
+    """
+
+    def __init__(self, prefix: str = "", tags: list[str] | None = None):
+        self.router = APIRouter(prefix=prefix, tags=tags or [])
+        self.Init()
+
+    def Init(self) -> None:
+        """子类重写此方法注册路由。"""
+        pass

fastapi_common/fastapi_common_web/domain/responses.py

@@ -0,0 +1,57 @@
+"""统一响应格式。"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import Enum
+from typing import Any, Generic, TypeVar
+
+T = TypeVar("T")
+
+
+class StatusCodeEnum(Enum):
+    """HTTP 状态码枚举。"""
+
+    HTTP_200_OK = 200
+    HTTP_201_CREATED = 201
+    HTTP_400_BAD_REQUEST = 400
+    HTTP_401_UNAUTHORIZED = 401
+    HTTP_403_FORBIDDEN = 403
+    HTTP_404_NOT_FOUND = 404
+    HTTP_409_CONFLICT = 409
+    HTTP_422_UNPROCESSABLE_ENTITY = 422
+    HTTP_500_INTERNAL_SERVER_ERROR = 500
+
+
+@dataclass
+class PaginationInfo:
+    """分页信息。"""
+
+    total: int
+    page: int
+    pageSize: int
+
+
+@dataclass
+class PageResult(Generic[T]):
+    """分页结果。"""
+
+    list: list[T]
+    pagination: PaginationInfo
+
+
+@dataclass
+class Result(Generic[T]):
+    """统一响应。"""
+
+    code: int
+    message: str
+    data: T | None = None
+
+    @classmethod
+    def success(cls, data: T | None = None, message: str = "ok") -> "Result[T]":
+        return cls(code=200, message=message, data=data)
+
+    @classmethod
+    def error(cls, status: StatusCodeEnum, message: str | None = None) -> "Result[None]":
+        return cls(code=status.value, message=message or status.name, data=None)

fastapi_common/fastapi_common_web/exception/Base/BusinessException.py

@@ -0,0 +1,14 @@
+"""业务异常基类。"""
+
+from __future__ import annotations
+
+from fastapi_common.fastapi_common_web.domain.responses import StatusCodeEnum
+
+
+class BusinessException(Exception):
+    """所有业务异常继承此类。"""
+
+    def __init__(self, status: StatusCodeEnum, message: str):
+        self.status = status
+        self.message = message
+        super().__init__(message)

fastapi_common/fastapi_common_web/exception/LeauditException.py

@@ -0,0 +1,7 @@
+"""LeAudit 域异常。"""
+
+from fastapi_common.fastapi_common_web.exception.Base.BusinessException import BusinessException
+
+
+class LeauditException(BusinessException):
+    """LeAudit 模块异常。"""

fastapi_common/fastapi_common_web/models/__init__.py

@@ -0,0 +1,32 @@
+"""BaseModel —— 所有业务模型的抽象基类。
+
+自动提供三个公共时间字段：
+- create_time：INSERT 时由数据库写入当前时间
+- update_time：INSERT 和 UPDATE 时自动更新
+- delete_time：默认 NULL，非 NULL 表示已软删除
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+
+from sqlalchemy import DateTime, func
+from sqlalchemy.orm import Mapped, mapped_column
+
+from fastapi_common.fastapi_common_sqlalchemy.base import Base
+
+
+class BaseModel(Base):
+    """所有业务模型的抽象基类。"""
+
+    __abstract__ = True
+
+    create_time: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), server_default=func.now(), comment="创建时间"
+    )
+    update_time: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), server_default=func.now(), onupdate=func.now(), comment="更新时间"
+    )
+    delete_time: Mapped[datetime | None] = mapped_column(
+        DateTime(timezone=True), default=None, comment="软删除时间"
+    )