fc / apps /reminders /README.md
jun2024's picture
Upload 2241 files
b4f2238 verified
|
Raw History Blame Contribute Delete
1.47 kB

⏰ 重要日期提醒模块 (Reminders)

管理案件/合同相关的关键日期提醒(开庭、举证到期、上诉期等)。

📁 目录结构

reminders/
├── api/        # Ninja API(CRUD + 类型枚举)
├── admin/      # Django Admin
├── ports/      # 目标查询端口(Contract/CaseLog)
├── services/   # ReminderService(业务逻辑)+ Adapter(跨模块接口)
├── models.py   # Reminder 模型
└── schemas.py  # API 输入/输出 Schema

🔑 核心设计

  • Reminder 必须绑定 contract 或 case_log 之一(DB 级 CheckConstraint)
  • ReminderService 通过构造注入 ContractTargetQueryPort / CaseLogTargetQueryPort,不直接依赖外部模块 Model
  • ReminderServiceAdapter 实现 IReminderService 协议,供案件模块、合同模块、自动化模块调用
  • 文书类型到提醒类型的映射在 Adapter 的 DOCUMENT_TYPE_TO_REMINDER_TYPE 中维护
  • 读侧导出能力(合同/案件日志/批量/最新一条)统一由 Adapter 提供,消费侧不直接使用 reverse ORM 作为主路径

🔌 对外能力(IReminderService)

  • 创建:create_case_log_reminder_internal / create_contract_reminders_internal / create_case_log_reminders_internal
  • 查询:export_contract_reminders_internal / export_case_log_reminders_internal / export_case_log_reminders_batch_internal
  • 摘要:get_latest_case_log_reminder_internal