Files
AIclinicalresearch/docs/07-运维文档
HaHafeng fa72beea6c feat(platform): Complete Postgres-Only architecture refactoring (Phase 1-7)
Major Changes:
- Implement Platform-Only architecture pattern (unified task management)
- Add PostgresCacheAdapter for unified caching (platform_schema.app_cache)
- Add PgBossQueue for job queue management (platform_schema.job)
- Implement CheckpointService using job.data (generic for all modules)
- Add intelligent threshold-based dual-mode processing (THRESHOLD=50)
- Add task splitting mechanism (auto chunk size recommendation)
- Refactor ASL screening service with smart mode selection
- Refactor DC extraction service with smart mode selection
- Register workers for ASL and DC modules

Technical Highlights:
- All task management data stored in platform_schema.job.data (JSONB)
- Business tables remain clean (no task management fields)
- CheckpointService is generic (shared by all modules)
- Zero code duplication (DRY principle)
- Follows 3-layer architecture principle
- Zero additional cost (no Redis needed, save 8400 CNY/year)

Code Statistics:
- New code: ~1750 lines
- Modified code: ~500 lines
- Test code: ~1800 lines
- Documentation: ~3000 lines

Testing:
- Unit tests: 8/8 passed
- Integration tests: 2/2 passed
- Architecture validation: passed
- Linter errors: 0

Files:
- Platform layer: PostgresCacheAdapter, PgBossQueue, CheckpointService, utils
- ASL module: screeningService, screeningWorker
- DC module: ExtractionController, extractionWorker
- Tests: 11 test files
- Docs: Updated 4 key documents

Status: Phase 1-7 completed, Phase 8-9 pending
2025-12-13 16:10:04 +08:00
..

运维文档

文档定位: 系统运维、监控、故障排查
适用范围: 运维团队、SRE团队


📋 运维文档清单

文档 说明 状态
01-环境配置指南.md 环境变量、数据库连接、API密钥配置 已完成
02-环境变量配置模板.md .env配置模板含CloseAI配置 已完成
03-监控告警.md 监控指标、告警规则 待创建
04-故障排查.md 常见问题排查手册 待创建
05-备份恢复.md 数据备份和恢复策略 待创建

🎯 核心运维任务

1. 监控

  • 系统健康检查
  • 性能监控
  • 告警通知

2. 日志

  • 日志收集
  • 日志分析
  • 日志归档

3. 备份

  • 数据库备份
  • 文件备份
  • 恢复演练

4. 故障处理

  • 故障诊断
  • 应急预案
  • 事后总结

最后更新: 2025-11-06
维护人: 技术架构师