Files

T

koriweb d8a80f6272 chore(wiki): dangling 링크 canonical 정규화 (768파일/1200건)

이름만 다른(표기 변형) [[위키링크]]를 대상 문서의 canonical 제목으로 치환해
끊겼던 1,200개 링크를 연결. 제목/파일명 정규화 일치만 적용하고 별칭 매칭은
과병합 위험으로 제외(애매성 가드). 원본은 _link_reconcile_backup/ 에 백업.
도구: Datacollect/scripts/link_reconcile_apply.mjs

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-08 12:24:15 +09:00

4.6 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack

title

Single Source of Truth (SSoT)

매 한 줄

"매 fact 의 1 authoritative location. Everywhere else 의 derive.". 매 information architecture 의 fundamental principle — duplication 의 minimize 후 매 derived view 의 cache/projection 으로 처리. 매 frontend (Redux), backend (master DB), DevOps (Git as IaC source) 의 cross-cutting pattern.

매 핵심

매 layers

DB layer: master DB + read replicas (no parallel sources).
App state: Redux store / TanStack Query cache.
Config: Git repo (Infrastructure as Code).
Identity: SCIM-synced IdP (Okta/Entra).
Schema: protobuf / OpenAPI as type-source.

매 derived view

Materialized views (DB).
Selectors / memoized derive (frontend).
Search indexes (Elastic) reflecting master.
Reporting cubes built from master.

매 응용

Redux Toolkit createSlice — 1 store, derived UI.
Git → Terraform → Cloud (no console drift).
SCIM provisioning — IdP authoritative.
CDC (Debezium) — master DB → downstream consumers.
Event sourcing — log as SSoT.

💻 패턴

Redux normalize + selector

import { createSlice, createSelector } from '@reduxjs/toolkit';

const usersSlice = createSlice({
  name: 'users',
  initialState: { byId: {} as Record<string, User> },
  reducers: { upsert: (state, { payload }) => { state.byId[payload.id] = payload; } },
});

export const selectUser = (id: string) => (state: RootState) => state.users.byId[id];
export const selectActiveUsers = createSelector(
  (s: RootState) => Object.values(s.users.byId),
  (users) => users.filter(u => u.active),
);

Terraform as IaC SSoT

resource "aws_s3_bucket" "logs" {
  bucket = "company-logs-prod"
  tags = { managed_by = "terraform", repo = "infra" }
}
# Console changes drift-detected via `terraform plan`

Debezium CDC

connector.class: io.debezium.connector.postgresql.PostgresConnector
database.hostname: master.db
table.include.list: public.orders
plugin.name: pgoutput
# Master postgres → Kafka → search/analytics consumers

Schema-first (protobuf)

syntax = "proto3";
message User {
  string id = 1;
  string email = 2;
  bool active = 3;
}
// codegen → TS, Go, Python types — single schema source

Materialized view (Postgres)

CREATE MATERIALIZED VIEW user_stats AS
SELECT user_id, COUNT(*) AS orders, SUM(total) AS revenue
FROM orders GROUP BY user_id;

REFRESH MATERIALIZED VIEW CONCURRENTLY user_stats;

SCIM provisioning

// IdP (Okta) → /scim/v2/Users — app receives, never originates user identity
app.put('/scim/v2/Users/:id', (req, res) => {
  await db.upsertUser(req.params.id, req.body);
  res.status(200).json(req.body);
});

TanStack Query cache as derived

const { data: user } = useQuery({
  queryKey: ['user', id],
  queryFn: () => api.getUser(id),
  staleTime: 60_000,
});
// Server is SSoT — cache is derived view with TTL

매 결정 기준

상황	Approach
Cross-system data sync	CDC from master DB
Cloud config	Git + Terraform
User identity	IdP + SCIM
Frontend state	Normalized Redux + selectors
Analytics	Reflect master via warehouse

기본값: master + derived projections — never multi-master unless conflict-resolution strategy defined.

🔗 Graph

부모: Data-Modeling
변형: Event Sourcing · CQRS
응용: Redux-Toolkit · Terraform · CDC · GitOps
Adjacent: Eventual Consistency

🤖 LLM 활용

언제: design-time data flow review, drift audit, cache invalidation strategy. 언제 X: distributed systems with offline-first requirement — CRDT 가 적합.

❌ 안티패턴

Dual-write: 매 app writes both DB and search — drift inevitable. CDC 사용.
Console drift: cloud console change without IaC update.
Cached as authoritative: TTL stale → cache mistakenly trusted.

🧪 검증 / 중복

Verified (Fowler, Kleppmann DDIA, Redux docs, Terraform best practices).
신뢰도 A.

🕓 Changelog

날짜	변경
2026-05-08	Phase 1
2026-05-10	Manual cleanup — SSoT principle, master + derived patterns, CDC/IaC/SCIM

4.6 KiB Raw Blame History