alpha-dc-common 0.1.23__py2.py3-none-any.whl

alpha_dc_common-0.1.23.dist-info/METADATA

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: alpha-dc-common
+Version: 0.1.23
+Summary: Shared schemas and utils for the datacenter project.
+Author-email: Hang GuangLiang <hanguangliang@alphaaidig.com>
+Requires-Dist: pydantic>=2.0

alpha_dc_common-0.1.23.dist-info/RECORD

@@ -0,0 +1,38 @@
+dc_common/__init__.py,sha256=OtW3SuOD7_04PgwCPor5AFdWE049sWd_uchQcyrwkJk,284
+dc_common/core/logger.py,sha256=pNiOjkL0TIidKZTww0X8wDZiCyoBSeWcl2h645yhf9k,1347
+dc_common/data_sources/__init__.py,sha256=j6nxSaoK8YtLJr7FU2qr-oXJzw3bt3wWXf2RXHvW9D4,363
+dc_common/data_sources/base_source.py,sha256=zgCHLF0fAfdO3xOR1WC2R7NK5ih1cd6BhhycUg2a_lM,4477
+dc_common/data_sources/daily_quote_source.py,sha256=Lq6SbvIIq_2mvG1T5EHery4G9nw5WkrDGWfV1__H5FI,6754
+dc_common/schemas/__init__.py,sha256=XEI89qPJnW0VUDjthP-hoMn49Rj30CL8yI4JnL9Eirc,1206
+dc_common/schemas/a_stock.py,sha256=FV3utksDO1FdHaCe9xPjr5CgnAbUKgLCPTPaKnuqMRU,920
+dc_common/schemas/base.py,sha256=34ydqpF1ascnqQQ3hNcOesXYLfTXwihwVOHmZ2cu5dM,1076
+dc_common/schemas/hk_announcement.py,sha256=VG2TInENO7R8aRabf92DIp3qdXQWW0oMOWq5fV5u5z8,1560
+dc_common/schemas/hk_company_profile.py,sha256=lLjsRpScBDIp-TXTAmjEBr4D0sq6BUjfPoHskLTgTQ4,2628
+dc_common/schemas/hk_stock.py,sha256=aroehzwxB28qhOSkjG7PN2ZRYJshj7j7oT_XkOkT2vY,961
+dc_common/schemas/hs_industry.py,sha256=Q3JKsUEG5jifRRttTKcv6Zk0isHXVsLyT8tkVP0eUEw,800
+dc_common/schemas/hs_industry_company.py,sha256=J2nPIw0KzqA0GvHIlk2wDRtiWHW8PLWFqV4MxJv6Ytw,1127
+dc_common/schemas/index_basic.py,sha256=2ggaAwW6o9Xnf3igiC7u-JT5IPS2gwu5ijs6dNjnR8A,1093
+dc_common/schemas/index_company.py,sha256=LkA6Zxr4SyilPw9KQ8dCygspA-qr8xmlswtJ-sO6-uM,516
+dc_common/schemas/index_daily.py,sha256=Uy_-3a2XIE-huepP-tFMgsO4gpEx3Qgsb4mxMqiiChs,1311
+dc_common/schemas/margin_account.py,sha256=9IeDYKT7j7BlRkYUzIbSpj7cemdtiU6afbj1ktDz8rE,1567
+dc_common/schemas/margin_analysis.py,sha256=uh16WPAtUKdIEucedJNEpp5ksxhGeiljFM9gENYYqKA,2029
+dc_common/schemas/margin_detail.py,sha256=yN5LTB3-hdq2Us9YP8KpvQNjmky0Kg1txX8LBSZz8Hg,1315
+dc_common/schemas/results.py,sha256=kyJWlJxm8UB8LCREID1oXww465FCxK1md64bOmeXXX4,1392
+dc_common/schemas/sw_index_daily.py,sha256=erSsYQWDafFVOdhym9d48C6KMlsPhtKobGP53YQElcM,1597
+dc_common/schemas/sw_industry.py,sha256=aM1wwV9xdcAJBztzTGOlzhJcIfAj4YtHLh5Q0U_8AP4,2432
+dc_common/schemas/sw_industry_company.py,sha256=lUkSQDL6TqFuIl5DmbUQC9dzIucn08DlolDyY0VPGJg,791
+dc_common/utils/auth_token.py,sha256=jDW_HLhcM_UXb0VAWaiJEMDfuUzWjDHDTRng89G5c3c,1789
+dc_common/utils/baidu_utils.py,sha256=x20NcxkBY3W0LOShoEG2FvwoJ8Wne9FQKrvkyR-_XzA,4199
+dc_common/utils/cache_utils.py,sha256=CFDvckeZcbe0fq7iYzx0FfLmYJR9XdWwAvWcu8QChNE,5054
+dc_common/utils/config_reader.py,sha256=fPBs5XcAHyNlZvWbldpsOBaVLs1s_ABwhM5ZcsA8CSE,2449
+dc_common/utils/eastmoney_utils.py,sha256=un5uGcsVTZrTVOiVvhEQwZk5usGbT4Y6gtnc6ErVZiM,3527
+dc_common/utils/jin10_utils.py,sha256=x6azWD3oEIDdf1yGKh_FdDWcSjbhSXRPypYGKoTZ2BQ,5477
+dc_common/utils/logging_config.py,sha256=lIlpfWZbQzH6ZkGV7_ujIli7KRDGz-T4e6SadfeMLE8,3805
+dc_common/utils/markdown_convert.py,sha256=jsfoOR8aEefCQmkmd3UqCzVVYntqU2zBbIXfRwbWXGA,4430
+dc_common/utils/money_format.py,sha256=pYL03L1ErLkVEzoeTBhMholaI6CCZ2orEHGONk2xN3s,539
+dc_common/utils/proxy_utils.py,sha256=uEg3bI_6nBJkn2DYn_wJLMYbrYmNGSZkyG7173IP3oM,8183
+dc_common/utils/schema_extract.py,sha256=U8OIVdX31fyI8kL-p-7wpEb9qIgj-gohwr37HccKsbc,6673
+dc_common/utils/xueqiu_utils.py,sha256=4kaHn_uGBtRAkUpbDgV5D8bJQVbSxUvLPSAPgXERRUo,9055
+alpha_dc_common-0.1.23.dist-info/METADATA,sha256=Sj8IyB8PVphSFwFOXXi2ROY1wZ1KdUpGjUGPHIeA52Y,212
+alpha_dc_common-0.1.23.dist-info/WHEEL,sha256=aha0VrrYvgDJ3Xxl3db_g_MDIW-ZexDdrc_m-Hk8YY4,105
+alpha_dc_common-0.1.23.dist-info/RECORD,,

alpha_dc_common-0.1.23.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any

dc_common/__init__.py

@@ -0,0 +1,15 @@
+"""
+DataCenter Common - 公共库
+
+提供：
+- 数据源（Tushare、本地缓存等）
+- 工具函数
+- 核心组件
+"""
+from .data_sources import BaseDataSource, DataSourceStatus, DailyQuoteSource
+
+__all__ = [
+    'BaseDataSource',
+    'DataSourceStatus',
+    'DailyQuoteSource',
+]

dc_common/core/logger.py

@@ -0,0 +1,48 @@
+import logging
+import sys
+import os
+from pathlib import Path
+
+def setup_logger(name: str = "datacenter") -> logging.Logger:
+    """设置并返回配置好的logger实例"""
+    
+    # 区分开发和生产环境
+    if os.environ.get('ENVIRONMENT') == 'production':
+        # 生产环境使用标准日志目录
+        log_dir = Path("/var/log/datacenter")
+        log_dir.mkdir(exist_ok=True, mode=0o755)
+    else:
+        # 开发环境使用相对路径
+        log_dir = Path("logs")
+        log_dir.mkdir(exist_ok=True)
+    
+    # 创建logger
+    logger = logging.getLogger(name)
+    logger.setLevel(logging.INFO)
+    
+    # 清除现有的handlers
+    logger.handlers.clear()
+    
+    # 创建formatter
+    formatter = logging.Formatter(
+        '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+    )
+    
+    # 文件handler
+    file_handler = logging.FileHandler(log_dir / "app.log", encoding="utf-8")
+    file_handler.setLevel(logging.INFO)
+    file_handler.setFormatter(formatter)
+    
+    # 控制台handler
+    console_handler = logging.StreamHandler(sys.stdout)
+    console_handler.setLevel(logging.INFO)
+    console_handler.setFormatter(formatter)
+    
+    # 添加handlers
+    logger.addHandler(file_handler)
+    logger.addHandler(console_handler)
+    
+    return logger
+
+# 创建默认logger实例
+logger = setup_logger()

dc_common/data_sources/__init__.py

@@ -0,0 +1,16 @@
+"""
+数据源模块 - 提供各类数据源的实现
+
+本模块提供统一的数据源接口，支持：
+- Tushare 数据源
+- 本地缓存管理
+- 数据质量验证
+"""
+from .base_source import BaseDataSource, DataSourceStatus
+from .daily_quote_source import DailyQuoteSource
+
+__all__ = [
+    'BaseDataSource',
+    'DataSourceStatus',
+    'DailyQuoteSource'
+]

dc_common/data_sources/base_source.py

@@ -0,0 +1,176 @@
+"""
+数据源基类定义
+"""
+from abc import ABC, abstractmethod
+from datetime import datetime, time
+from typing import Dict, Any, Optional
+import pandas as pd
+import logging
+from pathlib import Path
+from enum import Enum
+
+
+class DataSourceStatus(Enum):
+    """数据源状态"""
+    PENDING = "pending"        # 等待中
+    READY = "ready"           # 数据就绪
+    UPDATING = "updating"     # 更新中
+    FAILED = "failed"         # 更新失败
+    NOT_NEEDED = "not_needed" # 该日不需要更新
+
+
+class BaseDataSource(ABC):
+    """数据源基类
+
+    每个数据源有独立的调度策略和更新时间
+    """
+
+    def __init__(self, data_dir: str, logger: Optional[logging.Logger] = None):
+        self.data_dir = Path(data_dir)
+        self.data_dir.mkdir(parents=True, exist_ok=True)
+        self.logger = logger or logging.getLogger(__name__)
+
+    @property
+    @abstractmethod
+    def source_name(self) -> str:
+        """数据源唯一标识"""
+        pass
+
+    @property
+    @abstractmethod
+    def display_name(self) -> str:
+        """显示名称"""
+        pass
+
+    @property
+    @abstractmethod
+    def update_time(self) -> str:
+        """
+        期望更新时间
+        例如: "17:00", "09:30"
+        """
+        pass
+
+    @property
+    def update_delay_days(self) -> int:
+        """
+        更新延迟天数
+        0 = 当天更新
+        1 = 次日更新
+        """
+        return 0
+
+    @property
+    def priority(self) -> int:
+        """
+        优先级（数字越小越优先）
+        基础数据优先级高，衍生数据优先级低
+        """
+        return 100
+
+    @abstractmethod
+    def fetch_data(self, trade_date: str) -> pd.DataFrame:
+        """
+        获取数据
+
+        Args:
+            trade_date: 交易日期 (YYYYMMDD)
+
+        Returns:
+            数据 DataFrame
+        """
+        pass
+
+    @abstractmethod
+    def validate_data(self, df: pd.DataFrame) -> bool:
+        """
+        验证数据质量
+
+        Returns:
+            True=数据有效, False=数据无效
+        """
+        pass
+
+    def is_ready(self, trade_date: str) -> DataSourceStatus:
+        """
+        检查数据是否就绪
+
+        Args:
+            trade_date: 交易日期
+
+        Returns:
+            数据源状态
+        """
+        # 1. 检查本地是否已有数据
+        if self._has_local_data(trade_date):
+            return DataSourceStatus.READY
+
+        # 2. 检查是否到了更新时间
+        if not self._is_update_time():
+            return DataSourceStatus.PENDING
+
+        return DataSourceStatus.READY
+
+    def update(self, trade_date: str) -> Dict[str, Any]:
+        """
+        更新数据
+
+        Args:
+            trade_date: 交易日期
+
+        Returns:
+            更新结果字典
+        """
+        result = {
+            'source': self.source_name,
+            'trade_date': trade_date,
+            'status': 'unknown',
+            'rows': 0,
+            'message': ''
+        }
+
+        try:
+            self.logger.info(f"🔄 开始更新 {self.display_name}: {trade_date}")
+
+            # 1. 获取数据
+            df = self.fetch_data(trade_date)
+
+            # 2. 验证数据
+            if not self.validate_data(df):
+                result['status'] = 'failed'
+                result['message'] = '数据验证失败'
+                return result
+
+            # 3. 保存数据
+            self._save_data(df, trade_date)
+
+            result['status'] = 'success'
+            result['rows'] = len(df)
+            result['message'] = f'成功更新 {len(df)} 条数据'
+
+            self.logger.info(f"✅ {self.display_name} 更新完成: {len(df)} 条")
+
+        except Exception as e:
+            result['status'] = 'failed'
+            result['message'] = str(e)
+            self.logger.error(f"❌ {self.display_name} 更新失败: {e}")
+
+        return result
+
+    def _is_update_time(self) -> bool:
+        """检查是否到了更新时间"""
+        try:
+            hour, minute = map(int, self.update_time.split(':'))
+            target_time = time(hour, minute)
+            now = datetime.now().time()
+            return now >= target_time
+        except:
+            return True
+
+    def _has_local_data(self, trade_date: str) -> bool:
+        """检查本地是否已有数据（子类覆盖）"""
+        return False
+
+    def _save_data(self, df: pd.DataFrame, trade_date: str):
+        """保存数据（子类实现）"""
+        pass

dc_common/data_sources/daily_quote_source.py

@@ -0,0 +1,195 @@
+"""
+日线行情数据源
+"""
+import os
+import pandas as pd
+from pathlib import Path
+from typing import Optional
+import logging
+
+from .base_source import BaseDataSource, DataSourceStatus
+
+
+class DailyQuoteSource(BaseDataSource):
+    """日线行情数据源
+
+    从 Tushare 获取日线行情数据
+    更新时间：每天 17:00
+    """
+
+    def __init__(
+        self,
+        data_dir: str,
+        tushare_token: Optional[str] = None,
+        logger: Optional[logging.Logger] = None
+    ):
+        super().__init__(data_dir, logger)
+
+        self.token = tushare_token or os.getenv('TUSHARE_TOKEN')
+        if not self.token:
+            raise ValueError("Tushare token 未配置，请设置 TUSHARE_TOKEN 环境变量")
+
+        # 缓存文件直接存储在 data_dir 下（不再添加 raw 子目录）
+        self.cache_file = self.data_dir / 'daily_quotes.parquet'
+        self.raw_cache_file = self.data_dir / 'daily_quotes_raw.parquet'
+
+        # 延迟初始化 Tushare（避免导入时立即连接）
+        self._pro = None
+
+    @property
+    def pro(self):
+        """延迟初始化 Tushare Pro API"""
+        if self._pro is None:
+            import tushare as ts
+            ts.set_token(self.token)
+            self._pro = ts.pro_api()
+        return self._pro
+
+    @property
+    def source_name(self) -> str:
+        return "daily_quotes"
+
+    @property
+    def display_name(self) -> str:
+        return "日线行情"
+
+    @property
+    def update_time(self) -> str:
+        return "17:00"
+
+    @property
+    def update_delay_days(self) -> int:
+        return 0
+
+    @property
+    def priority(self) -> int:
+        return 10
+
+    def fetch_data(self, trade_date: str) -> pd.DataFrame:
+        """从 Tushare 获取日线数据"""
+        self.logger.info(f"从 Tushare 获取 {trade_date} 的日线数据...")
+
+        df = self.pro.daily(
+            trade_date=trade_date
+        )
+
+        if df.empty:
+            self.logger.warning(f"{trade_date} 无数据（可能是非交易日）")
+        else:
+            self.logger.info(f"获取到 {len(df)} 条数据")
+
+        return df
+
+    def validate_data(self, df: pd.DataFrame) -> bool:
+        """验证数据质量"""
+        if df.empty:
+            return True  # 空数据也是有效的（可能是非交易日）
+
+        required_fields = ['ts_code', 'trade_date', 'close']
+        return all(field in df.columns for field in required_fields)
+
+    def _has_local_data(self, trade_date: str) -> bool:
+        """检查本地是否已有数据"""
+        if not self.raw_cache_file.exists():
+            return False
+
+        try:
+            df = pd.read_parquet(self.raw_cache_file)
+            return trade_date in df['trade_date'].values
+        except Exception as e:
+            self.logger.warning(f"检查本地数据失败: {e}")
+            return False
+
+    def _save_data(self, df: pd.DataFrame, trade_date: str):
+        """保存数据（追加模式）"""
+        # 确保目录存在
+        self.raw_cache_file.parent.mkdir(parents=True, exist_ok=True)
+        self.cache_file.parent.mkdir(parents=True, exist_ok=True)
+
+        # 保存原始长格式数据
+        if self.raw_cache_file.exists():
+            existing_df = pd.read_parquet(self.raw_cache_file)
+
+            # 移除旧的同日期数据（如果有）
+            existing_df = existing_df[existing_df['trade_date'] != trade_date]
+
+            # 合并数据
+            combined_df = pd.concat([existing_df, df], ignore_index=True)
+
+            # 去重（基于 trade_date 和 ts_code，保留后出现的）
+            combined_df = combined_df.drop_duplicates(
+                subset=['trade_date', 'ts_code'],
+                keep='last'
+            )
+        else:
+            combined_df = df
+
+        combined_df.to_parquet(self.raw_cache_file, compression='snappy')
+        self.logger.info(f"原始数据已保存: {self.raw_cache_file}")
+
+        # 转换并保存宽表格式（用于因子计算）
+        self._save_wide_format(combined_df)
+
+    def _save_wide_format(self, df: pd.DataFrame):
+        """转换为宽表格式并保存（增量追加）"""
+        if df.empty:
+            return
+
+        # 排序
+        df = df.sort_values(['trade_date', 'ts_code'])
+
+        # 如果文件已存在，进行增量追加
+        if self.cache_file.exists():
+            try:
+                # 读取已有数据
+                existing_df = pd.read_parquet(self.cache_file)
+
+                # 移除与新数据重复的日期
+                existing_dates = existing_df['trade_date'].unique()
+                new_dates = df['trade_date'].unique()
+
+                # 只保留新数据中没有的旧日期
+                dates_to_keep = set(existing_dates) - set(new_dates)
+                if dates_to_keep:
+                    existing_df = existing_df[existing_df['trade_date'].isin(dates_to_keep)]
+                else:
+                    existing_df = pd.DataFrame()
+
+                # 合并数据
+                if not existing_df.empty:
+                    combined_df = pd.concat([existing_df, df], ignore_index=True)
+                else:
+                    combined_df = df
+
+                # 去重（基于 trade_date 和 ts_code，保留后出现的）
+                combined_df = combined_df.drop_duplicates(
+                    subset=['trade_date', 'ts_code'],
+                    keep='last'
+                )
+
+                # 排序
+                combined_df = combined_df.sort_values(['trade_date', 'ts_code'])
+
+                # 保存
+                combined_df.to_parquet(self.cache_file, compression='snappy', index=False)
+
+                old_len = len(existing_df) if dates_to_keep else 0
+                new_len = len(combined_df)
+                added_rows = new_len - old_len
+
+                self.logger.info(
+                    f"宽表数据已增量更新: {self.cache_file} "
+                    f"(原有: {old_len}, 新增: {added_rows}, 总计: {new_len})"
+                )
+            except Exception as e:
+                self.logger.warning(f"增量更新失败: {e}，执行覆盖保存")
+                df.to_parquet(self.cache_file, compression='snappy', index=False)
+                self.logger.info(f"宽表数据已保存: {self.cache_file}")
+        else:
+            # 首次保存（先去重）
+            df = df.drop_duplicates(subset=['trade_date', 'ts_code'], keep='last')
+            df.to_parquet(self.cache_file, compression='snappy', index=False)
+            self.logger.info(f"宽表数据已保存: {self.cache_file}")
+
+        self.logger.info(f"数据范围: {df['trade_date'].min()} ~ {df['trade_date'].max()}")
+        self.logger.info(f"股票数量: {df['ts_code'].nunique()}")

dc_common/schemas/__init__.py

@@ -0,0 +1,46 @@
+"""
+数据中心通用schemas模块
+"""
+from .base import BaseResponse, PaginatedResponse, PaginationInfo
+from .results import ResultType, BaseResult, TableResult, PageResult, DictResult, SingleResult
+from .a_stock import AStock
+from .hk_stock import HKStock
+from .index_basic import IndexBasic
+from .index_company import IndexCompany
+from .margin_account import MarginAccount
+from .margin_analysis import MarginAnalysis
+from .margin_detail import MarginDetail
+
+from .hs_industry import HSIndustry, HSIndustryCategory
+from .hs_industry_company import HSIndustryCompany
+from .sw_industry import SWIndustry
+from .sw_industry_company import SWIndustryCompany
+from .index_daily import IndexDaily
+from .sw_index_daily import SWIndexDaily
+
+__all__ = [
+    "BaseResponse",
+    "PaginatedResponse",
+    "PaginationInfo",
+    "ResultType",
+    "BaseResult",
+    "TableResult",
+    "PageResult",
+    "DictResult",
+    "SingleResult",
+    "AStock",
+    "HKStock",
+    "IndexBasic",
+    "IndexCompany",
+    "MarginAccount",
+    "MarginAnalysis",
+    "MarginDetail",
+
+    "HSIndustry",
+    "HSIndustryCategory",
+    "HSIndustryCompany",
+    "SWIndustry",
+    "SWIndustryCompany",
+    "IndexDaily",
+    "SWIndexDaily",
+]

dc_common/schemas/a_stock.py

@@ -0,0 +1,24 @@
+"""
+A股相关的Pydantic模型
+"""
+from pydantic import BaseModel, Field
+from typing import Optional
+from datetime import datetime
+
+class AStockBase(BaseModel):
+    stock_code: str = Field(..., description="股票代码")
+    stock_name: str = Field(..., description="股票名称")
+    exchange: str = Field(..., description="交易所(SH/SZ/BJ)")
+    list_status: Optional[str] = Field(None, description="上市状态(L上市/D退市/P暂停上市)")
+    list_date: Optional[datetime] = Field(None, description="上市日期")
+    curr_type: Optional[str] = Field(None, description="交易货币(CNY)")
+    market: Optional[str] = Field(None, description="市场类型(主板/创业板/科创板/北交所)")
+    ric_code: Optional[str] = Field(None, description="路透代码")
+
+class AStock(AStockBase):
+    id: int
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        from_attributes = True

dc_common/schemas/base.py

@@ -0,0 +1,45 @@
+"""
+基础Pydantic模型
+"""
+from typing import Any, Generic, TypeVar, List, Optional
+from pydantic import BaseModel, Field
+
+T = TypeVar("T")
+
+class PaginatedResponse(BaseModel, Generic[T]):
+    """分页响应模型"""
+    total: int
+    page: int
+    size: int
+    items: List[T]
+
+class BaseResponse(BaseModel):
+    """基础响应模型"""
+    status: str = "success"
+    message: Optional[str] = None
+    data: Optional[dict] = None
+
+class PaginationInfo(BaseModel):
+    """分页信息响应模型"""
+    total: int
+    page: int
+    page_size: int
+    total_pages: int
+
+class StandardListResponse(BaseModel):
+    """标准列表响应模型，类似Java中的Result<T>"""
+    status: str = "success"
+    data: dict
+
+class StandardResponse(BaseModel):
+    """标准通用响应模型"""
+    status: str = "success"
+    data: Any
+
+class PydanticPaginationResult(BaseModel, Generic[T]):
+    """支持Pydantic模型的分页查询结果"""
+    items: List[T] = Field(default_factory=list)
+    total: int = 0
+    page: int = 1
+    page_size: int = 10
+    total_pages: int = 0

dc_common/schemas/hk_announcement.py

@@ -0,0 +1,31 @@
+"""
+港股公告数据模式
+"""
+from datetime import datetime
+from typing import Optional
+from pydantic import Field, BaseModel
+
+
+class HKAnnouncement(BaseModel):
+    """港股公告数据模式"""
+
+    id: Optional[int] = Field(None, description="主键ID")
+    announcement_id: str = Field(..., description="公告唯一标识")
+    stock_code: str = Field(..., description="股票代码（逗号分隔）")
+    ric_code: str = Field(..., description="RIC代码（逗号分隔）")
+    sec_name: Optional[str] = Field(None, description="股票名称（逗号分隔）")
+    announcement_title: str = Field(..., description="公告标题")
+    announcement_time: datetime = Field(..., description="公告发布时间")
+    announcement_type: Optional[str] = Field(None, description="公告类型")
+    org_id: Optional[str] = Field(None, description="机构ID")
+    adjunct_url: str = Field(..., description="附件URL")
+    adjunct_size: Optional[int] = Field(None, description="附件大小（字节）")
+    adjunct_type: Optional[str] = Field(None, description="附件类型")
+    market_sector: str = Field(..., description="市场板块（HKZB主板/HKCY创业板）")
+    is_external_pdf: Optional[bool] = Field(False, description="是否外部PDF")
+    critical_announcement: Optional[int] = Field(0, description="是否重要公告")
+    created_at: Optional[datetime] = Field(None, description="记录创建时间")
+    updated_at: Optional[datetime] = Field(None, description="记录更新时间")
+
+    class Config:
+        from_attributes = True