안녕하세요, Fredric18 Apps 엔지니어링 팀입니다. 웹 유틸리티 허브의 아키텍처 확장성과 타입 안정성을 비약적으로 향상시킨 Release v1.0.41.3 & v1.0.41.4 정기 업데이트 소식을 전해드립니다.
이번 릴리즈는 내부 연산 알고리즘의 완전한 언어 중립화(Language Neutrality)를 달성하고, 프로젝트 전반의 상수 체계를 LOCALES 스타일로 100% 일원화하여 고성능 다국어 서비스 기반을 구축하는 데 집중하였습니다.
🌟 핵심 업데이트 요약 (Key Highlights)
1. 연산 엔진의 언어 중립화 및 i18n 추상화 계층 분리
- 계산 엔진의 순수 데이터 반환: 수열 극한 수치해석, 수 체계 파싱, 삼각함수 특수각 계산, 화학 원소 퀴즈 생성 등 코어 연산 모듈 내부에서 문자열이나 언어 종속적 텍스트 생성을 완전히 제거했습니다.
- i18n 프레젠테이션 레이어 전담: 모든 사용자 대면 텍스트 조립과 언어별 포맷팅은
@/lib/i18n/data/계층에서 100% 전담 처리하도록 엄격히 분리하여, 새로운 언어 추가 시 연산 로직을 단 1줄도 수정할 필요가 없도록 완성했습니다.
2. LOCALES 스타일 객체 상수(as const) 및 파생 유니온 타입 전면 일원화
- 단독 유니온 타입 배제: 문자열 리터럴 유니온(
export type SomeType = 'a' | 'b') 대신,export const DOMAIN_CONSTANTS = { ... } as const와export type DomainConstant = (typeof DOMAIN_CONSTANTS)[keyof typeof DOMAIN_CONSTANTS]패턴을 프로젝트 전반에 의무화했습니다. - 8대 도메인 전체 적용: 군 복무(
MILITARY_BRANCHES), 수열/극한(SEQUENCE_TYPES), 수 체계(NUMBER_CLASSIFICATIONS), 삼각비(TRIG_FUNCTIONS), 주기율표(PERIODIC_QUIZ_TYPES,ELEMENT_CATEGORIES), 단위 변환(UNIT_CATEGORIES), 명언(QUOTE_CATEGORY_IDS,CARD_THEME_IDS), 함수 개념(FUNCTION_PRESET_IDS) 등 전 영역에 적용 완료했습니다.
3. i18n 외부 조건식 0건 원칙(Remaining conditions: 0) 완벽 달성
- 사이드 윙 배너(
AffiliateSideBanners)를 포함한 컴포넌트 전반에서locale === LOCALES.KO등 직접 언어를 비교하던 조건식을 전용 헬퍼 함수(getAffiliateNetwork,resolveLocale)로 일원화하여, 감사 스크립트 기준 i18n 외부 언어 조건식 0건을 완벽히 보장합니다.
4. 도메인 다국어 데이터셋 I18nContents<T> 표준화 및 SSOT 규칙 개정
quotesData,elementsData,periodicTableData,numberSystemData등 지식 데이터셋의 레거시 평탄화 키(xxxKo,xxxEn)를contents: { ko, en }표준 인터페이스로 전환 완료했습니다.- 프로젝트 공식 SSOT 문서(
01-i18n-locale.md,07-i18n-modulation-spec.md,AGENTS.md)에 상수 및 타입 파생 규격을 공식 제정하였습니다.
Fredric18 Apps는 전 세계 사용자가 언어와 기기의 장벽 없이 언제 어디서나 최고 속도로 유틸리티를 활용할 수 있도록 끊임없이 아키텍처를 고도화해 나가겠습니다.




Leave a Reply