[릴리즈] v1.0.41.4: 연산 엔진의 언어 중립화 및 도메인 상수 일원화 아키텍처 구축

안녕하세요, 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 constexport 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는 전 세계 사용자가 언어와 기기의 장벽 없이 언제 어디서나 최고 속도로 유틸리티를 활용할 수 있도록 끊임없이 아키텍처를 고도화해 나가겠습니다.

이 포스팅은 쿠팡 파트너스 및 알리익스프레스 어필리에이트 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *