docs: CLAUDE.md 및 README.md 업데이트

0-ROK · 0-ROK · commit a746bacf1b89 · 2025-09-16T10:47:44.000+09:00
- CLAUDE.md에 체인 빌더 및 HTTP 파서 기능 추가
- README.md에서 주요 기능 및 다운로드 정보 개선
- 사용자 경험 향상을 위한 UI 요소 및 설명 추가
- 프로젝트 구조 및 빌드 과정에 대한 정보 업데이트
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -16,8 +16,10 @@ RiSA is an Electron-based desktop application for RSA encryption and decryption
 ### Key Components
 - **Settings Management**: Uses `electron-store` for persistent settings with GUI configuration panel
 - **RSA Operations**: Implemented using `node-rsa` library in the main process
+- **Chain Builder**: Sequential operation system for complex workflows (encoding, encryption, HTTP parsing)
+- **HTTP Parser**: URL template-based parsing and building with reusable templates
 - **IPC Communication**: Defined channels in `src/shared/constants.ts` for secure process communication
-- **State Management**: React Context API for settings state across the renderer process
+- **State Management**: React Context API for settings, chains, keys, history, and HTTP templates
 
 ### Project Structure
 ```
@@ -34,30 +36,35 @@ src/
 
 ### Prerequisites
 - Uses `pnpm` as package manager
-- Requires Node.js and Electron dependencies
+- Node.js 18+ and Electron dependencies required
 
 ### Building and Development
 ```bash
 # Install dependencies
 pnpm install
 
-# Development mode (needs to be set up)
-NODE_ENV=development pnpm run dev
+# Development mode (runs both main and renderer processes)
+pnpm run dev
 
-# Build for production
+# Build for production (builds main, renderer, and preload)
 pnpm run build
 
-# TypeScript compilation
+# Build individual components
+pnpm run build:main      # Main process only
+pnpm run build:renderer  # Renderer process only
+pnpm run build:preload   # Preload script only
+
+# Run built application
+pnpm run start
+
+# Package for distribution
+pnpm run package        # All platforms
+pnpm run package:mac    # macOS only
+
+# TypeScript type checking
 pnpm exec tsc --noEmit
 ```
 
-### Current Development Status
-The project is in early development with basic structure set up. Missing components include:
-- Build scripts in package.json
-- Settings page implementation
-- Key manager page implementation
-- Webpack build configuration for both main and renderer processes
-
 ## Technical Notes
 
 ### TypeScript Configuration
@@ -69,7 +76,10 @@ The project is in early development with basic structure set up. Missing compone
 All communication between main and renderer processes goes through predefined IPC channels defined in `src/shared/constants.ts`. The main process handles:
 - Settings persistence via electron-store
 - RSA key generation and cryptographic operations
+- Chain execution via `chainExecutor.ts` (URL encoding, Base64, RSA, HTTP parsing/building)
+- HTTP template management and URL parsing/building
 - File system operations (folder/file selection)
+- History tracking for all operations
 - Settings import/export functionality
 
 ### Security Considerations
@@ -84,15 +94,28 @@ Uses Ant Design components with:
 - Theme support (light/dark mode)
 - React Router for page navigation
 
-## Known Issues
-
-### Current TypeScript Errors
-- `electron-store` usage needs proper typing
-- Missing CSS loader dependencies for webpack
-- Build scripts not configured in package.json
-
-### Missing Implementation
-- Settings page UI and functionality
-- Key manager page
-- File encryption/decryption features
-- Proper webpack dev server setup
+## Feature Areas
+
+### Implemented Features
+- RSA encryption/decryption with multiple key sizes and algorithms
+- Key generation and management with import/export
+- Chain Builder for sequential operations
+- HTTP Parser with template-based URL parsing and building
+- Base64 and URL encoding/decoding tools
+- Operation history with filtering
+- Auto-update system for macOS
+
+### Chain Builder Operations
+The Chain Builder (`ChainBuilderPage.tsx`) supports sequential operations with input/output mapping:
+- URL encoding/decoding
+- Base64 encoding/decoding
+- RSA encryption/decryption
+- HTTP parsing (extract path/query parameters from URLs)
+- HTTP building (construct URLs from templates and parameters)
+
+### HTTP Templates
+HTTP templates (`HttpTemplateContext.tsx`) enable reusable URL patterns:
+- Path parameters using `:param` or `{param}` syntax
+- Query parameters with validation patterns
+- Template-based parsing and building in Chain Builder
+- Input/output field mapping for chain operations
diff --git a/README.md b/README.md
@@ -2,9 +2,9 @@
 
 <div align="center">
   <img src="assets/icons/RiSA.png" alt="RiSA Logo" width="120" height="120">
-  
-  **간단하고 직관적인 RSA 암호화 데스크톱 애플리케이션**
-  
+
+  **민감한 데이터를 로컬에서 안전하게 암호화하는 오픈소스 데스크톱 앱**
+
   [![GitHub release](https://img.shields.io/github/v/release/0-ROK/RiSA)](https://github.com/0-ROK/RiSA/releases)
   [![GitHub downloads](https://img.shields.io/github/downloads/0-ROK/RiSA/total)](https://github.com/0-ROK/RiSA/releases)
   [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -13,47 +13,49 @@
 
 ---
 
+## 🛡️ 왜 RiSA인가?
+
+**완전한 로컬 보안**: 모든 암호화 과정이 사용자의 컴퓨터에서만 실행됩니다. 네트워크 전송 없이, 서버 업로드 없이, 온전히 로컬에서 처리됩니다.
+
+**투명성과 신뢰**: 모든 소스코드가 공개되어 있어 언제든 검증할 수 있습니다. 숨겨진 백도어나 데이터 수집이 없습니다.
+
+**편리한 GUI**: 복잡한 명령어나 설정 없이 직관적인 그래픽 인터페이스로 강력한 RSA 암호화를 사용할 수 있습니다.</div>
+
+---
+
 ## 📥 다운로드
 
 ### 🌐 공식 다운로드 페이지
 
 **[https://0-rok.github.io/RiSA](https://0-rok.github.io/RiSA)**
 
-### 📦 직접 다운로드
-
-최신 릴리즈는 [GitHub Releases](https://github.com/0-ROK/RiSA/releases/latest)에서 다운로드할 수 있습니다.
+가장 쉽고 안전한 다운로드 방법입니다. 운영체제를 자동으로 감지하여 최적의 설치 파일을 제공합니다.
 
-| 플랫폼       | 다운로드                                                                                                                  |
-| ------------ | ------------------------------------------------------------------------------------------------------------------------- |
-| 🍎 **macOS** | [DMG 파일](https://github.com/0-ROK/RiSA/releases/latest) • [ZIP 압축파일](https://github.com/0-ROK/RiSA/releases/latest) |
+*최신 릴리즈는 [GitHub Releases](https://github.com/0-ROK/RiSA/releases/latest)에서도 확인할 수 있습니다.*
 
 ---
 
 ## ✨ 주요 기능
 
 ### 🔒 **강력한 RSA 암호화**
-
 - RSA-OAEP (권장) 및 RSA-PKCS1 알고리즘 지원
 - 1024, 2048, 4096 비트 키 크기 선택 가능
-- 안전한 키 생성 및 관리
+- 안전한 키 생성, 관리, 가져오기/내보내기
 
-### 🎨 **직관적인 사용자 인터페이스**
+### 🔗 **Chain Builder (연속 작업)**
+- 여러 작업을 순차적으로 연결하여 실행
+- URL 인코딩/디코딩, Base64 인코딩/디코딩
+- RSA 암호화/복호화를 포함한 복합 워크플로우
 
-- 깔끔하고 현대적인 디자인
-- 사이드바 네비게이션으로 쉬운 접근
-- 실시간 오류 검증 및 사용자 피드백
+### 🌐 **HTTP Parser (URL 템플릿)**
+- URL 템플릿을 활용한 파싱 및 생성
+- 경로 파라미터와 쿼리 파라미터 추출
+- 재사용 가능한 템플릿 시스템
 
-### 🔧 **키 관리 시스템**
-
-- RSA 키 쌍 자동 생성
-- 키 가져오기/내보내기 (JSON 형식)
-- 저장된 키 목록 관리
-
-### ⚡ **성능 최적화**
-
-- Electron 기반 네이티브 성능
-- 빠른 암호화/복호화 처리
-- 자동 업데이트 지원
+### 🎨 **직관적인 사용자 경험**
+- 깔끔한 사이드바 네비게이션
+- 실시간 검증 및 피드백
+- 작업 히스토리 자동 저장
 
 ---
 
@@ -93,28 +95,12 @@
 - **알고리즘**: RSA-OAEP 사용
 - **키 관리**: 개인키는 안전한 곳에 보관
 
-### 다운로드 안전성
+### 신뢰할 수 있는 다운로드
 
 - ✅ **오픈소스**: 모든 코드는 GitHub에서 공개적으로 검증 가능
 - ✅ **자동 빌드**: GitHub Actions로 자동 빌드되어 변조 불가능
 - ✅ **MIT 라이선스**: 자유롭게 사용, 수정, 배포 가능
 
-### 설치 시 보안 경고 해결법
-
-#### 🍎 macOS
-
-1. **"확인되지 않은 개발자"** 경고 시:
-   - 앱 파일을 **우클릭** → "**열기**" 선택
-   - 다시 "**열기**" 확인 클릭
-2. **"앱이 손상되었습니다"** 경고 시:
-   ```bash
-   # 터미널에서 다음 명령어 실행
-   xattr -cr /Applications/RiSA.app
-   ```
-3. **대안 방법**:
-   - 시스템 환경설정 → 보안 및 개인 정보 보호
-   - "**확인 없이 열기**" 버튼 클릭
-
 ---
 
 ## 🔄 자동 업데이트
@@ -127,88 +113,16 @@ RiSA는 자동 업데이트를 지원합니다:
 
 ---
 
-## 🔨 소스코드에서 빌드하기
-
-개발자나 고급 사용자를 위한 소스코드 빌드 방법:
-
-### 사전 요구사항
-
-- Node.js 18 이상
-- pnpm (권장) 또는 npm
-- Git
-
-### 빌드 과정
-
-```bash
-# 저장소 클론
-git clone https://github.com/0-ROK/RiSA.git
-cd RiSA
-
-# 의존성 설치
-pnpm install
-
-# 개발 모드 실행
-pnpm run dev
-
-# 프로덕션 빌드
-pnpm run build
-
-# 플랫폼별 패키징
-pnpm run package:win   # Windows
-pnpm run package:mac   # macOS
-pnpm run package:linux # Linux
-```
-
-### Apple Developer 통합 (macOS 개발자용)
-
-macOS 앱 서명 및 공증을 위한 설정은 [APPLE_DEVELOPER_SETUP.md](APPLE_DEVELOPER_SETUP.md)를 참조하세요.
-
----
-
-## 🛠️ 개발자 정보
-
-### 기술 스택
-
-- **Frontend**: React 19, TypeScript, Ant Design
-- **Backend**: Electron, Node.js
-- **암호화**: node-rsa, node-forge
-- **빌드**: Webpack, electron-builder
-
-### 시스템 요구사항
-
-- **macOS**: macOS 10.15 이상
-
----
-
-## 🐛 문제 해결
-
-### 일반적인 문제
-
-1. **앱이 실행되지 않음**: 최신 버전 다운로드 확인
-2. **암호화 실패**: Base64 형식 및 키 유효성 확인
-3. **키 가져오기 실패**: JSON 파일 형식 확인
-
-### 지원 요청
-
-문제가 지속되면 [GitHub Issues](https://github.com/0-ROK/RiSA/issues)에서 도움을 요청하세요.
-
----
 
 ## 📄 라이선스
 
 이 프로젝트는 [MIT 라이선스](LICENSE) 하에 배포됩니다.
 
 ---
 
-## 🤝 기여하기
-
-버그 신고, 기능 제안, 코드 기여를 환영합니다!
+## 💬 지원
 
-1. 이 저장소를 포크하세요
-2. 기능 브랜치를 생성하세요 (`git checkout -b feature/amazing-feature`)
-3. 변경사항을 커밋하세요 (`git commit -m 'Add amazing feature'`)
-4. 브랜치에 푸시하세요 (`git push origin feature/amazing-feature`)
-5. Pull Request를 생성하세요
+문제가 있거나 기능 제안이 있으시면 [GitHub Issues](https://github.com/0-ROK/RiSA/issues)에서 알려주세요.
 
 ---
 
