9명 팀으로 v1 작성 → 17명 적대적 재검증 팀(항목별 반박 + 독립 심판 + 평결)으로 교정한 v2. (원본 MD: docs/architecture/recommended-design-2026.md) 현행 진단은 개발 가이드, 비용·이슈는 아키텍처 검토.
• 규모 전제: prod ~9명 사용자·1인 팀. 모든 권장은 업계 "table-stakes"가 아니라 이 현실 기준. v1은 9명에 분산추적·durable saga·LLM을 권하며 자기 프로젝트가 캐싱을 "조기 최적화"로 보류한 기준을 위반.
• "유지"의 진짜 근거: 594 테스트 통과 중 배포 스택을 9명 위해 마이그레이션은 낭비 — 이것이 유지 근거(그린필드 최적이라서가 아님; 진짜 그린필드라면 단일 VPS+PG나 Supabase가 더 단순할 수 있음).
• 확증 편향: "8개 브리프 수렴"은 검증 아닌 동기화 추론 신호. architecture-review.md는 같은 자체 PostGIS를 P1 SPOF로 보고 관리형 이전을 권장 — v1은 더 위험한 쪽을 "합의"라 칭함.
• 벤더 락인은 비용: 추가 항목 전부 Cloudflare 종속 심화, exit story 없음.
• 버전·날짜 미검증: 실제 repo는 Zod ^3.24·Biome ^1.9·Vitest ^3.2·TS ^5.8. TS7/tsgo·Bun1.3·Containers GA·"45 출처"는 1차 출처 확인 전 신뢰 금지.
• 관측성 정정: 소스에 Sentry 없음(v1 오류), 로깅 비구조화.
| 유지 + AVOID 목록 | ✅ 유지 — K8s·마이크로서비스·Redis·폴리글랏·별도 벡터DB 금지는 문서 최고 부분 |
|---|---|
| C2 Workflows | ❌ 기각 — 정산은 이미 단일 db.transaction(), saga 부재. 외부 결제 게이트웨이 도입 시로 보류 |
| C3 OpenTelemetry | 🔄 재구성 — 지금은 구조화 로깅+requestId만, 전면 OTel은 트래픽 증가 시 |
| C4 Hono RPC+Zod4 | 🔄 저비용 80%만 — 중복 DTO를 shared-types로, Zod 3 유지. RPC/zod-mini 기각 |
| C5 패스키 | ❌ 폐기 — 9명에 위협 없음, 공격면만↑, 복구 플로우는 1인 팀 최악 |
| C6 LLM 레이어 | ❌ 작업 폐기 — 지원/KYC 파이프라인 없음, n=9 이상탐지 무의미. "돈 근처 금지" 가드레일만 보존 |
| C7 Alchemy IaC+공급망 | ❌ 기각 — CI(.github/) 부재, wrangler.toml이 이미 IaC, canary 무의미. 공급망 강화는 CI 도입 시 |
| C8 (브리프) 이전·Neon | ❌ 허수아비/기각 — 문서는 프론트 이전 금지·Neon 명명 안 함. 안전 항목은 TS 5.9 in-major 범프뿐 |
STALE_DISPATCH_SECONDS==COUNTDOWN_SECONDS 회귀 테스트(과거 30s/300s 버그 영구 봉인, Workflows 불필요). P1 DB SPOF는 pg_dump→R2 백업+복구 리허설로 이미 비례 완화.| 언어 | TypeScript 5.9(타입체크 속도용 tsgo/TS7 beta 병행) — 전 계층 단일 타입 |
|---|---|
| 런타임 prod | Cloudflare workerd + nodejs_compat(compat 2026-03+) — 콜드스타트≈0 |
| 툴체인 dev | Bun 1.3 + Node 24 LTS CI — 정확성은 wrangler dev에서 검증 |
| API | Hono RPC + Zod 4(zod/mini) — 코드젠 없이 종단 타입 |
| 프론트 | Next.js 15(React 19 RSC) 유지 + PWA 강화 — 이미 최적, 이전 금지 |
| 실시간 | Durable Objects(WebSocket Hibernation) — 동급 최강 |
| 비동기 | Cloudflare Queues + Workflows — 돈/saga 신뢰성 |
| 데이터 | PostgreSQL + PostGIS(Hyperdrive) + Drizzle 유지 |
| 인증 | 패스키/WebAuthn + JWT/refresh 유지 — 2026 표준 |
| 관측성 | OpenTelemetry — 2026 표준, 임시 로깅 대체 |
| AI/LLM | Workers AI + AI Gateway + 구조화 출력 |
| IaC | Wrangler + Alchemy(TS 네이티브 IaC) |
| 테스트/린트 | Vitest + Playwright · Biome 유지 |
[3 PWA: customer/driver/admin] Next15+React19 정적 → CF Pages
│ (Hono RPC 타입드 클라이언트; 패스키)
▼
[ktaxi-api (Hono)] 모듈러 모놀리스: routes→services→db
├─ Hyperdrive → PostgreSQL 16 + PostGIS (OLTP·공간 디스패치)
├─ KV(캐시·토큰) R2(업로드) Queues(비동기)
├─ Workflows(durable): 정산·다단계 예약/환불 saga
└─ AI Gateway → Workers AI/프런티어 (운영 코파일럿·이상탐지)
├─ [ktaxi-realtime: DO] tracking/driver-notify/admin-notify (Hibernation)
└─ [consumers + flight-poller] Queues 소비자·cron
횡단: OpenTelemetry 트레이스 Pages→Worker→DO→PG · Alchemy(TS IaC) · Sentry1. 서버리스 우선 유지 — K8s는 escape hatch만(CPU 바운드 배치엔 Containers 2026-04 GA).
2. 단일 API Worker 모듈러 모놀리스 — 마이크로서비스 거부(소팀 2026 합의).
3. 돈 흐름에 Workflows(durable execution) 추가 — 수작업 saga/retry 버그 제거, 최고가치 단일 추가.
4. OpenTelemetry 지금 도입 — 엣지 분산 디버깅의 유일한 방법.
5. 패스키/WebAuthn — 피싱 저항·2026 표준(JWT/refresh 폴백).
6. LLM은 AI Gateway 경유 — 캐싱·레이트리밋·비용 가시성·모델 라우팅.
7. PostgreSQL+PostGIS 단일 진실원, pgvector는 AI 필요 시만.
| 1 | OpenTelemetry 계측(Worker→DO→PG) — 가치 운영가시성 / 위험 낮음 |
|---|---|
| 2 | 정산·환불 → Cloudflare Workflows — 금전 정합성 / 중간 |
| 3 | Hono RPC + Zod 4 프론트 타입 통합(N3/N7) — 드리프트 제거 / 중간 |
| 4 | 패스키/WebAuthn(폴백 JWT) — 보안·UX / 중간 |
| 5 | AI Gateway 운영 레이어(고객응대·이상탐지) — 운영효율 / 낮음 |
| 6 | Alchemy IaC 코드화 — 재현성 / 낮음 |
| 7 | (필요 시) pgvector / Containers 핫스팟 — 측정 후 |
검증 버전: TS 5.9(2025-08)·TS7/tsgo(2026-04 beta, ~10배)·Node 24 LTS·Bun 1.3·Zod 4·Cloudflare Containers GA(2026-04)·Workflows·Workers AI·Next.js 15. 검증 출처 45건.