chore: land in-progress workspace changes before 1.16.2
The tree carried uncommitted work from several areas (web push, mobile screens, admin charts, test-hygiene cleanup, CI and map docs). It is landed as one commit so the release pipeline can start from a clean tree; the desktop transcript-correction behaviour shipped in the previous commit and is unchanged here.
This commit is contained in:
parent
9c2b6a9782
commit
7fe49c437e
144 changed files with 3760 additions and 4523 deletions
|
|
@ -1,7 +1,7 @@
|
|||
# D3RO-VOICE 리팩토링 정책 (SSOT)
|
||||
|
||||
> 마지막 갱신: 2026-07-22 — Wave 1 정책 수립
|
||||
> 적용 범위: `apps/desktop` + `packages/{core,ui,i18n}` (web/admin/site/server/mobile은 별도 wave)
|
||||
> 마지막 갱신: 2026-11-04 — Wave 4 전체 모노레포 위생 점검 정책 확정
|
||||
> 적용 범위: `apps/*` + `packages/*` + `server/*` + `site/` + 빌드·배포 스크립트 (기능 변경은 별도 요청)
|
||||
|
||||
## 0. 전제: 기존 3계층 규칙 SSOT와의 관계
|
||||
|
||||
|
|
@ -51,7 +51,7 @@ D3RO는 이미 3계층 강제 규칙 체계를 가진다. 본 정책은 이를 *
|
|||
- **확정: 3회** (2026-07-22 합의)
|
||||
|
||||
### DP8. 자동화 — typecheck + lint + test + 강제 규칙 훅
|
||||
- WS 통합 후 반드시 GREEN: `npm run typecheck`(turbo) · `npm run lint` · `npm run test` · `npm run build`(빌드 영향 WS).
|
||||
- WS 통합 후 반드시 GREEN: `npm run typecheck`(npm workspaces) · `npm run lint` · `npm run test` · `npm run build`(빌드 영향 WS).
|
||||
- UI 변경: `npm run dev`로 화면 1회 확인. (WS3은 화면별 즉시)
|
||||
|
||||
---
|
||||
|
|
@ -122,3 +122,35 @@ D3RO는 이미 3계층 강제 규칙 체계를 가진다. 본 정책은 이를 *
|
|||
| W3-8 | 사이트 배포 | Cloudflare Pages 한 경로. GitHub Pages·NAS wwwroot 복사 경로 삭제 | — |
|
||||
|
||||
DRY 원칙 보강: Deno처럼 정본을 직접 import할 수 없는 런타임은 **생성 사본 + `--check` 게이트**로만 복제를 허용한다(`version:sync` 패턴과 같음). 손으로 옮겨 적은 사본은 금지.
|
||||
|
||||
---
|
||||
|
||||
## Wave 4 (2026-11-04) — 두 번째 전체 위생 점검
|
||||
|
||||
사용자 지시: "두 번째 소스코드 정리, 대대적인 위생 점검." 기존 DP1~DP11과 Wave 3 정본 결정을 그대로 계승한다.
|
||||
|
||||
### W4-1. 목표와 비목표
|
||||
|
||||
- 목표: 전체 모노레포에서 증거가 확인된 데드코드·데드 스텁·중복 선언/동작·의존성 잔여물·계약 드리프트·빌드/스크립트 중복을 줄인다.
|
||||
- 비목표: 새 기능, UI/UX·문구 변경, DB 마이그레이션, 공개 API/IPC/payload의 breaking 변경, 비밀값·운영 서버 변경, 릴리스·배포는 제외한다. 실제 DB와 어긋난 공유 타입의 additive 정합화는 소비자 전체 typecheck를 조건으로 허용한다.
|
||||
- 추측만으로 대형 파일을 쪼개거나 이름을 바꾸지 않는다. 삭제 우선 → 계약 안정화 → 중복 통합 순서를 지키고, 의미 있는 중복 제거 없이는 새 추상화를 만들지 않는다.
|
||||
|
||||
### W4-2. 유지 불변량
|
||||
|
||||
- 공개 API·IPC 채널, 오류 코드/메시지, 결과 순서, 보안 경계, 저장·동기화 의미, 광고·결제 fail-closed 동작은 유지한다.
|
||||
- 화면 상태와 시각 결과는 유지한다. UI 동작 변경이 필요한 발견은 이번 Wave에서 기능 변경 후보로 분리하고 순수 정리와 섞지 않는다.
|
||||
- 기존 사용자 변경과 무관한 파일을 되돌리지 않으며, 현재 정책 문서 변경 외에는 감사 단계에서 소스를 수정하지 않는다.
|
||||
|
||||
### W4-3. 감사와 실행 분리
|
||||
|
||||
- 감사 A: 데스크톱 main/preload + `packages/core` — 서비스 경계, IPC·타입 SSOT, 데드코드/스텁, 중복 워크플로, any/console, 캐시 소유권.
|
||||
- 감사 B: desktop renderer + web/admin/mobile/site + `packages/ui`/`ui-native` — 디자인 토큰, i18n, 중복 UI/스타일, 미사용 컴포넌트와 export, any/console.
|
||||
- 감사 C: `packages/i18n` + server + 빌드/CI/의존성/스크립트 — 로케일 정합, 계약 사본, 미사용 의존성, 설정 중복, 문서-코드 드리프트.
|
||||
- 모든 후보는 `file:line`, 참조/호출 증거, HIGH/MED/LOW 확신도, DELETE/REPLACE/REFACTOR/KEEP 판정과 예상 게이트를 가져야 한다. KEEP도 이유를 명시하고, HIGH라도 구현 전에 다시 읽어 false positive를 걸러낸다.
|
||||
|
||||
### W4-4. 패치 그룹과 검증
|
||||
|
||||
- 파일이 겹치지 않는 P1 삭제/잔여물, P2 중복·SSOT, P3 설정/의존성 그룹으로 나눈다. 순수 리팩토링과 불가피한 기능 수정은 절대 같은 그룹에 두지 않는다.
|
||||
- 그룹마다 잔여 식별자 grep, 최소 표적 테스트, 변경 파일 lint를 먼저 실행하고, 통합 후 루트 `typecheck`·`test`·`lint`, 모바일 `typecheck`·`test`·`lint`, 영향받은 빌드와 `version:check`·`contract:check`를 실행한다.
|
||||
- packages 공유 계약 변경은 모든 소비 앱을 검사한다. UI 시각 변경은 원칙적으로 제외하며, 예외가 생기면 별도 합의와 시각 증거가 필요하다. 에이전트 서브쉘에서 Electron GUI를 백그라운드 실행하지 않는다.
|
||||
- 커밋·푸시는 사용자가 별도로 명시할 때만 수행한다. 이번 Wave는 패치 그룹별 diff와 검증 증거를 보존하고, `docs/REFACTOR_WAVE4_REPORT.md`에 변경/검증/SKIP/잔여 위험을 기록한다.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue