docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거
Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를 Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류. - 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로 자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거, 동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거. - 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming, Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business, Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로, 나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는 title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백). 원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지. - 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서. - 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는 지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지. - Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경. - 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
This commit is contained in:
Antigravity Agent
@@ -0,0 +1,185 @@
|
||||
---
|
||||
id: ts-effect-fp-patterns
|
||||
title: Effect / fp-ts — 함수형 에러 / 의존성 / 동시성
|
||||
category: Coding
|
||||
status: draft
|
||||
source_trust_level: B
|
||||
verification_status: conceptual
|
||||
created_at: 2026-05-09
|
||||
updated_at: 2026-05-09
|
||||
tags: [typescript, effect, fp-ts, functional, vibe-coding]
|
||||
tech_stack: { language: "TS", applicable_to: ["Backend", "Frontend"] }
|
||||
applied_in: []
|
||||
aliases: [Effect, fp-ts, Either, Option, Result, Layer, dependency injection, retry]
|
||||
---
|
||||
|
||||
# Effect / fp-ts
|
||||
|
||||
> Promise + try/catch 의 한계 = 명시적 에러 type X, 의존성 묶임. **Effect (modern) / fp-ts (전통)** = 타입 안전 에러 + DI + 재시도 + 동시성 일급. 학습 곡선 큼 — 팀 합의 필요.
|
||||
|
||||
## 📖 핵심 개념
|
||||
- Effect<A, E, R>: 성공 A / 에러 E / 의존성 R.
|
||||
- pipe: 작은 함수 합성.
|
||||
- Layer: 의존성 주입.
|
||||
- Schedule: retry / repeat 정책.
|
||||
|
||||
## 💻 코드 패턴
|
||||
|
||||
### Effect 기본
|
||||
```ts
|
||||
import { Effect } from 'effect';
|
||||
|
||||
const program = Effect.gen(function* () {
|
||||
const user = yield* fetchUser('u1'); // Effect<User, ApiError, never>
|
||||
const orders = yield* fetchOrders(user.id);
|
||||
return { user, orders };
|
||||
});
|
||||
|
||||
const result = await Effect.runPromise(program); // throws on failure
|
||||
// 또는
|
||||
const result = await Effect.runPromiseExit(program); // Exit<A, E>
|
||||
```
|
||||
|
||||
### Either / 명시적 에러
|
||||
```ts
|
||||
import { Effect } from 'effect';
|
||||
|
||||
class UserNotFound { readonly _tag = 'UserNotFound'; }
|
||||
class NetworkError { readonly _tag = 'NetworkError'; }
|
||||
|
||||
function fetchUser(id: string): Effect.Effect<User, UserNotFound | NetworkError> {
|
||||
return Effect.tryPromise({
|
||||
try: () => api.get(id),
|
||||
catch: (e) => e instanceof TypeError ? new NetworkError() : new UserNotFound(),
|
||||
});
|
||||
}
|
||||
|
||||
// Match
|
||||
const handled = program.pipe(
|
||||
Effect.catchTag('UserNotFound', () => Effect.succeed(defaultUser)),
|
||||
Effect.catchTag('NetworkError', () => Effect.retry(...)),
|
||||
);
|
||||
```
|
||||
|
||||
### Layer (DI)
|
||||
```ts
|
||||
class Database extends Effect.Service<Database>()('Database', {
|
||||
effect: Effect.gen(function* () {
|
||||
const url = yield* Config.string('DATABASE_URL');
|
||||
return { query: (sql: string) => Effect.tryPromise(() => pg.query(sql)) };
|
||||
}),
|
||||
}) {}
|
||||
|
||||
const program = Effect.gen(function* () {
|
||||
const db = yield* Database;
|
||||
const r = yield* db.query('SELECT 1');
|
||||
return r;
|
||||
});
|
||||
|
||||
// 실행 시 layer 제공
|
||||
Effect.runPromise(program.pipe(Effect.provide(Database.Default)));
|
||||
```
|
||||
|
||||
### Schedule (retry + backoff)
|
||||
```ts
|
||||
import { Schedule, Effect } from 'effect';
|
||||
|
||||
const policy = Schedule.exponential('100 millis').pipe(
|
||||
Schedule.compose(Schedule.recurs(5)),
|
||||
Schedule.jittered,
|
||||
);
|
||||
|
||||
const robust = program.pipe(Effect.retry(policy));
|
||||
```
|
||||
|
||||
### Concurrency
|
||||
```ts
|
||||
const all = Effect.all([fetchA, fetchB, fetchC], { concurrency: 'unbounded' });
|
||||
const limited = Effect.all(items.map(process), { concurrency: 10 });
|
||||
|
||||
// Race
|
||||
const fast = Effect.race(slowEndpoint, fastEndpoint);
|
||||
```
|
||||
|
||||
### Stream
|
||||
```ts
|
||||
import { Stream } from 'effect';
|
||||
|
||||
const numbers = Stream.range(1, 1000);
|
||||
const processed = numbers.pipe(
|
||||
Stream.map(n => n * 2),
|
||||
Stream.filter(n => n % 3 === 0),
|
||||
Stream.take(10),
|
||||
Stream.runCollect,
|
||||
);
|
||||
```
|
||||
|
||||
### Schema (built-in 검증, like zod)
|
||||
```ts
|
||||
import { Schema } from 'effect';
|
||||
|
||||
const User = Schema.Struct({
|
||||
id: Schema.String.pipe(Schema.uuid()),
|
||||
email: Schema.String.pipe(Schema.email()),
|
||||
age: Schema.Number.pipe(Schema.greaterThan(0)),
|
||||
});
|
||||
|
||||
type User = Schema.Schema.Type<typeof User>;
|
||||
|
||||
const decoded = Schema.decodeUnknownEither(User)(input);
|
||||
```
|
||||
|
||||
### Resource (자동 cleanup)
|
||||
```ts
|
||||
const file = Effect.acquireRelease(
|
||||
Effect.sync(() => fs.openSync(path, 'r')),
|
||||
(fd) => Effect.sync(() => fs.closeSync(fd)),
|
||||
);
|
||||
|
||||
const program = Effect.scoped(Effect.gen(function* () {
|
||||
const fd = yield* file;
|
||||
// 사용
|
||||
// 자동 close
|
||||
}));
|
||||
```
|
||||
|
||||
### fp-ts (전통 — Effect 가 후속)
|
||||
```ts
|
||||
import { pipe } from 'fp-ts/function';
|
||||
import * as TE from 'fp-ts/TaskEither';
|
||||
|
||||
const program = pipe(
|
||||
fetchUser('u1'),
|
||||
TE.flatMap(user => fetchOrders(user.id)),
|
||||
TE.map(orders => orders.length),
|
||||
);
|
||||
|
||||
const result = await program(); // Either<Error, number>
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준
|
||||
| 상황 | 추천 |
|
||||
|---|---|
|
||||
| 작은 / 일반 팀 | Promise + try/catch + zod |
|
||||
| 큰 백엔드 + FP 팀 | Effect |
|
||||
| Monad / FP 학습 | fp-ts |
|
||||
| Error type 안전 강 | Effect |
|
||||
| 큰 동시성 / 재시도 정책 복잡 | Effect |
|
||||
| Front + Back 공유 | Effect (range 광범위) |
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **Promise 와 Effect 혼용**: 변환 비용. 한 모델만.
|
||||
- **Effect 도입 — 팀 학습 X**: 유지보수 못 함.
|
||||
- **catchAll 모든 에러 swallow**: type 안전 의미 없음.
|
||||
- **runSync prod**: error 던짐. runPromise / runFork.
|
||||
- **Layer 없이 직접 의존**: testability 낮음.
|
||||
- **Stream 으로 작은 데이터**: overkill. 일반 array.
|
||||
|
||||
## 🤖 LLM 활용 힌트
|
||||
- 도입 결정 = 팀 합의 필수.
|
||||
- Effect 가 modern (2024+), fp-ts 는 legacy (저자가 Effect 로 이동).
|
||||
- Schema + DI + retry 가 가장 ROI.
|
||||
|
||||
## 🔗 관련 문서
|
||||
- [[TS_tsconfig_Strategy]]
|
||||
- [[Error_Handling_Result_vs_Throw]]
|
||||
Reference in New Issue
Block a user