feat: Add base project structure with API and web components

api/app/models/generic_file_model.py

@@ -0,0 +1,52 @@
+import datetime
+import uuid
+from sqlalchemy import Column, Integer, String, DateTime, Boolean, Index, JSON
+from sqlalchemy.dialects.postgresql import UUID
+from app.db import Base
+
+
+class GenericFile(Base):
+    """
+    通用文件模型，支持多种上传上下文（头像、应用图标、知识库文件、临时文件等）
+    """
+    __tablename__ = "generic_files"
+
+    # 主键和租户信息
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4, index=True, comment="文件唯一标识")
+    tenant_id = Column(UUID(as_uuid=True), nullable=False, index=True, comment="租户ID")
+    created_by = Column(UUID(as_uuid=True), nullable=False, index=True, comment="创建者用户ID")
+
+    # 文件基本信息
+    file_name = Column(String, nullable=False, comment="原始文件名")
+    file_ext = Column(String, nullable=False, index=True, comment="文件扩展名")
+    file_size = Column(Integer, nullable=False, comment="文件大小（字节）")
+    mime_type = Column(String, nullable=True, comment="MIME类型")
+
+    # 上传上下文
+    context = Column(String, nullable=False, index=True, comment="上传上下文（avatar/app_icon/knowledge_base/temp/attachment）")
+
+    # 存储信息
+    storage_path = Column(String, nullable=False, comment="文件存储路径")
+
+    # 元数据（JSON格式，存储业务相关信息）
+    file_metadata = Column(JSON, nullable=True, default={}, comment="业务元数据")
+
+    # 状态和访问控制
+    status = Column(String, default="active", index=True, comment="文件状态（active/processing/deleted）")
+    is_public = Column(Boolean, default=False, comment="是否公开访问")
+    access_url = Column(String, nullable=True, comment="访问URL")
+
+    # 引用计数（用于判断文件是否可以删除）
+    reference_count = Column(Integer, default=0, comment="引用计数")
+
+    # 时间戳
+    created_at = Column(DateTime, default=datetime.datetime.now, comment="创建时间")
+    updated_at = Column(DateTime, default=datetime.datetime.now, onupdate=datetime.datetime.now, comment="更新时间")
+    deleted_at = Column(DateTime, nullable=True, comment="删除时间（软删除）")
+
+    # 复合索引
+    __table_args__ = (
+        Index('idx_tenant_context', 'tenant_id', 'context'),
+        Index('idx_tenant_status', 'tenant_id', 'status'),
+        Index('idx_created_at', 'created_at'),
+    )