메뉴
系统架构设计指南 — 单体 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]
### 中性
- [需要关注的方面]