القائمة
系统架构设计指南 — 单体 vs 微服务、分层架构、领域驱动设计(DDD)、高可用/高扩展方案选型
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Consolidate scattered utility scripts into a centralized directory with comprehensive documentation, then publish to version control.
Debug cron job execution failures — check job status, session logs, gateway errors, model availability, and stale gateway code
Hermes gateway port 8642 is WebSocket-based only — NOT a REST API. Do NOT try to send WeChat/Weixin alerts via curl HTTP POST to the gateway. Understanding this prevents wasted time debugging "404 on all endpoints" when trying to send alerts from cron jobs.
Karpathy's LLM Wiki — build and maintain a persistent, interlinked markdown knowledge base. Ingest sources, query compiled knowledge, and lint for consistency.
A股每日/每周收盘行情汇总报告生成 — 东方财富 API 为主，AKShare (Sina + 同花顺) 兜底
每日美股收盘行情汇总 — 主要指数、板块轮动、个股亮点、宏观消息面、技术分析
| name | system-architecture-design |
| description | 系统架构设计指南 — 单体 vs 微服务、分层架构、领域驱动设计(DDD)、高可用/高扩展方案选型 |
| category | software-development |
当用户需要：设计新系统架构、评估现有架构、做技术选型决策、讨论微服务拆分、解决扩展性/可用性问题时使用。
| 维度 | 单体 Monolith | 模块化单体 Modular Monolith | 微服务 Microservices |
|---|---|---|---|
| 适用阶段 | MVP / 小团队 (<10人) | 成长期 / 中型团队 | 大规模 / 多团队 (>50人) |
| 部署复杂度 | 低 | 中 | 高 (需 K8s/服务网格) |
| 数据一致性 | 简单 (ACID) | 简单 (ACID) | 复杂 (Saga/Eventual) |
| 技术栈 | 统一 | 统一但可隔离 | 每服务独立 |
| 运维成本 | 低 | 中 | 高 |
| 扩展方式 | 整体水平扩展 | 按模块拆分扩展 | 每服务独立扩展 |
决策建议：
┌─────────────────────────────────────┐
│ Presentation Layer │ ← API Controllers / Views
├─────────────────────────────────────┤
│ Application Layer │ ← Use Cases / Service Orchestration
├─────────────────────────────────────┤
│ Domain Layer │ ← Business Logic / Entities / Value Objects
├─────────────────────────────────────┤
│ Infrastructure Layer │ ← DB / Cache / MQ / External APIs
└─────────────────────────────────────┘
核心原则：
Aggregate (聚合根)
├── Entity (实体，有唯一标识)
├── Value Object (值对象，不可变，按值比较)
├── Domain Event (领域事件)
└── Repository (仓储，持久化抽象)
| SLA | 年停机时间 | 实现方式 |
|---|---|---|
| 99.9% | 8.76h | 负载均衡 + 健康检查 |
| 99.95% | 4.38h | 多可用区部署 |
| 99.99% | 52.6min | 多区域 + 自动故障转移 |
| 99.999% | 5.26min | 全冗余 + 混沌工程 |
垂直扩展 (Scale Up) → 加 CPU/内存，简单但有上限
水平扩展 (Scale Out) → 加机器，需无状态设计
读写分离 → 主库写，从库读
分库分表 (Sharding) → 按用户ID/地域/时间拆分
CQRS → 命令和查询分离，独立优化
| 场景 | 推荐 | 理由 |
|---|---|---|
| 高并发 API / 实时应用 | Node.js (NestJS / Express) | 事件驱动，非阻塞 I/O，高并发性能好 |
| AI/ML 集成 / 数据处理 | Python (FastAPI) | 原生 Python 生态，自动 OpenAPI 文档 |
| 企业级 / 复杂业务 | Java (Spring Boot) / C# (.NET) | 成熟生态，强类型，事务管理 |
| 高性能微服务 | Go (Gin / Fiber) | 编译型，低内存占用，goroutine 并发 |
| 全栈 TypeScript | NestJS | Angular 风格架构，支持 REST/gRPC/WS |
| 场景 | 推荐 | 理由 |
|---|---|---|
| 企业 SPA / 丰富生态 | React (Next.js) | 最大社区，组件库丰富，SSR/SSG/ISR |
| 快速原型 / 渐进式 | Vue (Nuxt) | 学习曲线低，约定优于配置，Vite 构建快 |
| 极致性能 / 小包 | Svelte (SvelteKit) | 编译时优化，无虚拟 DOM，包体积小 |
| 传统 MPA / 强交互 | HTMX + 服务端渲染 | 简单，无需构建步骤，SEO 友好 |
# ADR-NNN: [决策标题]
## 状态: [提议 | 已接受 | 已弃用 | 已取代]
## 背景
[描述驱动决策的上下文和问题]
## 决策
[描述做出的具体决策]
## 后果
### 正面
- [优点1]
### 负面
- [缺点/风险1]
### 中性
- [需要关注的方面]