docs: README / README_ko 개발 현황 및 구성 업데이트

- Phase 1.5 진행률 40% → 90%, 서브 페이즈별 스냅샷 표로 재편 (2026-04-15 기준)
- Phase 1.9 완료 항목 추가, Phase 1.95(Setup 설치 마법사) 진행 중 항목 추가
- Quick Start 제거 → Phase 1.95 완료 시 배포 가이드 공개 안내로 대체
- Tech Stack 섹션 추가 (실제 구현 기준)
- 로컬 개발 환경 섹션 추가 (pnpm dev:bypass, mock 계정 테이블)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: SOIV

README.md

@@ -29,45 +29,86 @@ Current phase: **Development in progress (Roadmap Phase 1.5)**
 
 - ✅ Planning and documentation are complete
 - ✅ Roadmap Phase 1 (Core foundation) is complete
-- 🚧 Development is active, and missing details are being filled during implementation
-- 🚧 Roadmap Phase 1.5 (Core Control Plane UI/UX) is in progress
+- ✅ Roadmap Phase 1.9 (API server, DB, auth backend, shared links) is complete
+- 🚧 Roadmap Phase 1.5 (Core Control Plane UI/UX) is nearing completion
 - 🎯 Target timeline remains **2026-2027**
 
 ### Phase Progress
 
 | Phase | Scope (Roadmap) | Status | Progress |
 | ------- | ----------- | ------- | ------- |
 | Phase 1 | Core foundation setup | Completed ✅ | 100% |
-| Phase 1.5 | Core Control Plane UI/UX | In progress ⏳ | 40% |
+| Phase 1.5 | Core Control Plane UI/UX | In progress ⏳ | 90% |
+| Phase 1.9 | API server · DB · auth backend · shared links | Completed ✅ | 100% |
+| Phase 1.95 | Setup install wizard (mode switch · backend API · UI) | In progress ⏳ | 0% |
 | Phase 2 | Core module development (Ledger, Subscription) | Not started 🚧 | 0% |
 | Phase 3 | Marketplace and website | Not started 🚧 | 0% |
 | Phase 4 | Deployment optimization | Not started 🚧 | 0% |
 | Phase 5 | Expansion and ecosystem | Not started 🚧 | 0% |
 | Phase 6 | Community growth (continuous) | Not started 🚧 | 0% |
 
-#### Phase 1.5 Snapshot (2026-02-26)
+#### Phase 1.5 Snapshot (2026-04-15)
 
-- Control contracts (P0/P0.5): **100%**
-- `@fieldstack/controls` scaffold: **100%**
-- Render components (TSX + styles + a11y behaviors): **0%**
-- End-to-end flow verification: **0%**
+| Sub-phase | Scope | Status |
+| --------- | ----- | ------ |
+| 1.5.1 | Control UI components (P0/P0.5 implemented, `ready: true`) | Done ✅ |
+| 1.5.2 | Install wizard dev bypass (`dev:bypass`) | Done ✅ |
+| 1.5.3 | Login UX (failure/lock/session expiry, password recovery, mock accounts) | Done ✅ |
+| 1.5.4 | Main Home (sidebar, deep link routing, mobile drawer, onboarding banner) | Done ✅ |
+| 1.5.5 | Admin dashboard / general settings (PIN step-up, audit log, dirty-state save) | Done ✅ |
+| 1.5.6 | UX quality baseline (responsive breakpoints, QA checklist, a11y, tone guide) | Done ✅ |
+| Gate | Accessibility / responsive / E2E pass · UI contract freeze | Pending ⏳ |
 
 > Note: This phase table follows `docs/v2_FINANCIAL-LEDGER/roadmap/01-development-plan.md` and is updated as implementation progresses.
 
 ---
 
-## Quick Start
+## Tech Stack
+
+| Layer | Technology |
+| ----- | ---------- |
+| Frontend | React 19, Vite, TypeScript (strict) |
+| Backend | Node.js, Express 5, tsx |
+| Database | PostgreSQL (primary) · SQLite (planned) |
+| Auth | JWT, TOTP 2FA, Argon2id |
+| Monorepo | pnpm workspaces |
+| Testing | Vitest |
+| UI Components | `@fieldstack/controls` (internal), Storybook |
+| Styling | CSS custom properties (design token system) |
+
+---
+
+## Getting Started
+
+> **Production deployment guide will be published when the Setup install wizard (Phase 1.95) is complete.**
+> Until then, you can run the project locally in development mode.
+
+### Local Development
 
-### Docker Compose (Recommended)
 ```bash
 git clone https://github.com/fieldstack-project/fieldstack.git
 cd fieldstack
+pnpm install
+
+# Start PostgreSQL (Docker required)
 docker-compose up -d
 
-# Browser will open automatically
-→ http://localhost:3000/install
+# Run dev server (web + api in parallel)
+pnpm dev:bypass       # skip install wizard
+# → Web:  http://localhost:5173
+# → API:  http://localhost:3000
+
+# Storybook (UI components)
+pnpm storybook        # http://localhost:6007
 ```
 
+**Dev mock accounts**
+
+| Role | Email | Password |
+| ---- | ----- | -------- |
+| Admin | `admin@fieldstack.dev` | `Admin1234!` |
+| User | `user@fieldstack.dev` | `User1234!` |
+
 ---
 
 ## Documentation

README_ko.md

@@ -29,45 +29,86 @@ Fieldstack은 개인 생산성과 재무 관리를 위한 오픈소스 기반의
 
 - ✅ 기획 및 문서화 단계 완료
 - ✅ 로드맵 Phase 1(Core 기반 구축) 완료
-- 🚧 실제 개발을 진행하며 부족한 부분을 병행 보완 중
-- 🚧 로드맵 Phase 1.5(Core Control Plane UI/UX) 진행 중
+- ✅ 로드맵 Phase 1.9(API 서버 · DB · 인증 백엔드 · 공유 링크) 완료
+- 🚧 로드맵 Phase 1.5(Core Control Plane UI/UX) 마무리 단계
 - 🎯 전체 목표 타임라인은 **2026-2027** 유지
 
 ### Phase 진행 현황
 
 | 단계(Phase) | 범위(로드맵) | 상태 | 진행률 |
 | ----------- | ----------- | --- | ----- |
 | Phase 1 | Core 기반 구축 | 완료 ✅ | 100% |
-| Phase 1.5 | Core Control Plane UI/UX | 진행 중 ⏳ | 40% |
+| Phase 1.5 | Core Control Plane UI/UX | 진행 중 ⏳ | 90% |
+| Phase 1.9 | API 서버 · DB · 인증 백엔드 · 공유 링크 | 완료 ✅ | 100% |
+| Phase 1.95 | Setup 설치 마법사 (모드 전환 · 백엔드 API · UI) | 진행 중 ⏳ | 0% |
 | Phase 2 | 기본 모듈 개발(Ledger, Subscription) | 시작 전 🚧 | 0% |
 | Phase 3 | 마켓플레이스 및 웹사이트 | 시작 전 🚧 | 0% |
 | Phase 4 | 배포 최적화 | 시작 전 🚧 | 0% |
 | Phase 5 | 확장 및 생태계 | 시작 전 🚧 | 0% |
 | Phase 6 | 커뮤니티 성장(지속) | 시작 전 🚧 | 0% |
 
-#### Phase 1.5 스냅샷 (2026-02-26)
+#### Phase 1.5 스냅샷 (2026-04-15)
 
-- Control 계약(P0/P0.5): **100%**
-- `@fieldstack/controls` 패키지 기초 스캐폴딩: **100%**
-- 실제 렌더 컴포넌트 구현(TSX + 스타일 + 접근성 동작): **0%**
-- 설치 -> 로그인 -> 홈 -> 설정/관리자 흐름 통합 검증(E2E): **0%**
+| 서브 페이즈 | 범위 | 상태 |
+| ----------- | ---- | ---- |
+| 1.5.1 | Control UI 컴포넌트 (P0/P0.5 구현 완료, `ready: true`) | 완료 ✅ |
+| 1.5.2 | 설치 마법사 개발용 bypass (`dev:bypass`) | 완료 ✅ |
+| 1.5.3 | 로그인 UX (실패/잠금/세션 만료, 비밀번호 복구, mock 계정 시스템) | 완료 ✅ |
+| 1.5.4 | 메인 홈 (사이드바, 딥 링크, 모바일 Drawer, 온보딩 배너) | 완료 ✅ |
+| 1.5.5 | 관리자 대시보드 / 일반 설정 (PIN step-up, 감사 로그, dirty-state 저장) | 완료 ✅ |
+| 1.5.6 | UX 품질 기준 (반응형 브레이크포인트, QA 체크리스트, 접근성, 톤 가이드) | 완료 ✅ |
+| 게이트 | 접근성/반응형/E2E 통과 · UI 계약 동결 | 진행 중 ⏳ |
 
 > 참고: 본 Phase 표는 `docs/v2_FINANCIAL-LEDGER/roadmap/01-development-plan.md` 기준이며, 구현 진행에 따라 갱신됩니다.
 
 ---
 
-## 빠른 시작
+## 기술 스택
+
+| 레이어 | 기술 |
+| ------ | ---- |
+| 프론트엔드 | React 19, Vite, TypeScript (strict) |
+| 백엔드 | Node.js, Express 5, tsx |
+| 데이터베이스 | PostgreSQL (1순위) · SQLite (예정) |
+| 인증 | JWT, TOTP 2FA, Argon2id |
+| 모노레포 | pnpm workspaces |
+| 테스트 | Vitest |
+| UI 컴포넌트 | `@fieldstack/controls` (내부 패키지), Storybook |
+| 스타일링 | CSS 커스텀 프로퍼티 (디자인 토큰 시스템) |
+
+---
+
+## 시작하기
+
+> **프로덕션 배포 가이드는 Setup 설치 마법사(Phase 1.95) 완료 시점에 공개됩니다.**
+> 그 전까지는 아래 방법으로 로컬 개발 환경에서 실행할 수 있습니다.
+
+### 로컬 개발 환경
 
-### Docker Compose (권장)
 ```bash
 git clone https://github.com/fieldstack-project/fieldstack.git
 cd fieldstack
+pnpm install
+
+# PostgreSQL 실행 (Docker 필요)
 docker-compose up -d
 
-# 브라우저가 자동으로 열립니다
-→ http://localhost:3000/install
+# 개발 서버 실행 (web + api 병렬)
+pnpm dev:bypass       # 설치 마법사 스킵
+# → Web:  http://localhost:5173
+# → API:  http://localhost:3000
+
+# Storybook (UI 컴포넌트 확인)
+pnpm storybook        # http://localhost:6007
 ```
 
+**개발용 mock 계정**
+
+| 역할 | 이메일 | 비밀번호 |
+| ---- | ------ | -------- |
+| 관리자 | `admin@fieldstack.dev` | `Admin1234!` |
+| 일반 사용자 | `user@fieldstack.dev` | `User1234!` |
+
 ---
 
 ## 문서