프롬프트 라이브러리

CKEditor 5 아키텍처 가이드라인을 엄격히 준수한 mopick 뉴스레터 탭 위젯 플러그인(NewsletterPlugin)과 이를 실시간으로 테스트할 수 있는 인터랙티브 WYSIWYG 에디터 환경을 구현했습니다. 모듈별 TypeScript 전체 소스 코드 스튜디오와 함께 툴바 대화상자 생성, 모델 기반 탭 전환, 더블 클릭 재편집 및 CKEditor 4에서 CKEditor 5로의 마이그레이션 가이드를 한 화면에서 완벽히 제공합니다.

제출해주신 Python 코드에 대한 코드 리뷰 결과입니다. 요청하신대로 데이터베이스 쿼리 최적화 및 메모리 효율성에 초점을 맞추어 검토했습니다.

1. 주요 개선 포인트: In-Memory 필터링 지양

현재 코드는 SELECT * FROM orders를 통해 데이터베이스의 전체 주문 데이터를 메모리로 로드한 후, Python의 for 문으로 user_id를 필터링하고 있습니다. 데이터 건수가 많아질수록 애플리케이션 메모리 사용량이 급증하며, 심각한 성능 병목이 발생합니다.

2. 권장 코드 개선안

데이터베이스 레벨에서 WHERE 절을 사용하여 필요한 데이터만 가져오도록 수정합니다.

def get_user_orders(user_id):
    # DB 차원에서 user_id 데이터만 필터링하여 조회
    query = "SELECT id, order_date, total_price FROM orders WHERE user_id = %s"
    return db.query(query, (user_id,))

3. 추가 베스트 프랙티스 제안

• **SELECT * 사용 지양**: 전체 컬럼을 조회하는 대신 필요한 컬럼만 명시하여 네트워크 대역폭 및 메모리 소모를 줄이세요.
• SQL Injection 방지: 파라미터 바인딩 방식((user_id,))을 사용하여 보안을 강화하세요.
• DB 인덱스 설정: orders 테이블의 user_id 컬럼에 인덱스가 적용되어 있는지 확인하세요.

위 수정사항을 적용하면 쿼리 속도와 전체 시스템의 대용량 데이터 처리 효율이 크게 향상됩니다.

1. 지도 시스템 흐름 (Map System Flow)

• 흐름: [사용자 클릭] → [UI] → [Controller.addLayer()] → [SDK 비동기 레이어 생성/등록] → (완료 후) → [SDK.setLayerStyle()] → [지도 렌더링]
• 타이밍 포인트: setLayerStyle은 레이어가 SDK 네이티브 메모리에 완전히 등록된 후 호출되어야 합니다.

2~4. 현재 문제 및 불일치 (Current vs Expected)

기존 코드에서는 addLayer 호출 직후 동기적으로 setLayerStyle을 실행합니다. SDK가 레이어를 비동기로 생성 중일 때 스타일 변경 명령이 도착하여 스타일이 무시되거나 에러가 발생합니다.

5. 원인 (Root Cause)

비동기 타이밍 이슈 (Timing Issue): addLayer 처리 완료(await)를 대기하지 않고 setLayerStyle을 실행함.

6. 최소 수정 코드 (Minimal Fix)

Future<void> updateRouteStyle(String category) async {
  await mapController.addLayer(routeLayer);
  final color = category == 'express' ? Colors.red : Colors.blue;
  await mapController.setLayerStyle(routeLayer.id, LayerStyle(color: color, width: 5.0));
}

7. 해결 이유 (Why Fix Works)

await를 추가하여 SDK 내부 레이어 등록 완료 후 스타일 변경을 호출하므로 흐름 타이밍이 정상화됩니다.

8. 리스크 (Risks)

네트워크 지연 시 스타일 적용이 약간 늦어질 수 있으나 로딩 인디케이터로 해소 가능합니다.

9. 아키텍처 예방책 (Prevention)

레이어 생성 시점에 초기 스타일 컨피그(Config)를 함께 전달하는 구조로 작성하세요.

1. 물리 수학 공식 (LaTeX)

• 탄성 장력 및 감쇠력 (Hooke's Law with Damping):

$$F_{rope} = -k (||\mathbf{r}|| - l_0) \hat{\mathbf{r}} - d (\mathbf{v} \cdot \hat{\mathbf{r}}) \hat{\mathbf{r}}$$
($k$: 탄성계수, $l_0$: 로프 기본길이, $d$: 감쇠계수, $\hat{\mathbf{r}}$: 앵커 방향 단위벡터)

• 원심력 (Centrifugal Force):

$$F_{centrifugal} = m \frac{v_{\theta}^2}{||\mathbf{r}||} \hat{\mathbf{r}}$$

2. 상태 머신 (State Machine)

[Normal State] --(Input Down & Raycast Hit)--> [Hook Launching]
[Hook Launching] --(Attach To Target)--> [Swinging (Elastic Physics)]
[Swinging] --(Input Up / Disconnect)--> [Airborne (Momentum Preserved)]

3. Unity C# 구현 예시

using UnityEngine;

public class ElasticGrapple : MonoBehaviour {
    [SerializeField] private Rigidbody rb;
    public Vector3 anchorPoint;
    public float restLength = 8f, springK = 200f, damping = 15f;
    public bool isGrappling;

    void FixedUpdate() {
        if (!isGrappling) return;
        Vector3 dir = transform.position - anchorPoint;
        float currentLength = dir.magnitude;
        
        if (currentLength > restLength) {
            Vector3 normDir = dir.normalized;
            float delta = currentLength - restLength;
            float springForce = delta * springK;
            float dampingForce = Vector3.Dot(rb.velocity, normDir) * damping;
            Vector3 totalForce = -normDir * (springForce + dampingForce

제출해주신 calculate_user_points 함수에 대한 코드 리뷰 결과입니다.

1. 보안 취약점 (SQL Injection)
2. 문제: f"SELECT ... '{user_id}'" 형태의 문자열 삽입은 SQL 인젝션 공격에 취약합니다.
3. 개선: 파라미터화된 쿼리(cursor.execute("... WHERE id = ?", (user_id,))\)를 사용하세요.

1. 자원 누수 및 예외 처리
2. 문제: DB 연결(conn)이 닫히지 않아 자원 누수가 발생합니다. 또한 사용자가 존재하지 않을 경우(row가 None) TypeError가 발생합니다.
3. 개선: with 문을 통해 자원을 자동 해제하고, row 존재 여부를 검증하세요.

1. 코딩 표준 및 최적화 (PEP 8)
2. 문제: import sqlite3가 함수 내부에서 호출되고 있으며, 매번 DB 커넥션을 생성하여 성능상 불리합니다.
3. 개선: import는 최상단으로 이동하고, DB 커넥션은 외부에서 주입받거나 커넥션 풀을 사용하는 것이 좋습니다.

[개선 코드 예시]

import sqlite3

def calculate_user_points(user_id: str, purchase_amount: float, conn: sqlite3.Connection) -> float:
    cursor = conn.cursor()
    cursor.execute("SELECT level FROM users WHERE id = ?", (user_id,))
    row = cursor.fetchone()
    
    if not row:
        raise ValueError(f"User not found: {user_id}")
        
    rates = {'VIP': 0.05, 'GOLD': 0.03}
    rate = rates.get(row[0], 0.01)
    
    return purchase_amount * rate

완성도 높은 코드를 작성하는 데 도움이 되기를 바랍니다.

고속 레이싱/비행 게임을 위한 모바일 최적화 무한 PCG 지형 생성 시스템 설계안입니다.

1. 높이맵 및 위치 추적

Simplex Noise와 CPU 멀티스레딩(Job System)을 활용하여 플레이어의 이동(X, Z)에 맞춰 렌더링 영역의 Vertex 높이를 실시간 계산합니다. 4단 Octave와 Low-frequency 설정으로 고속 주행에 적합한 완만한 곡선과 굴곡을 연출합니다.

1. 청크 오브젝트 풀링 (모바일 60 FPS)

플레이어 중심 5x5 청크 그리드 풀을 유지합니다. 시야 범위를 벗어난 청크는 즉시 재사용(Recycle)되어 진행 방향 전방으로 재배치됩니다. Draw Call 절감을 위해 GPU Instancing 및 거리별 LOD 시스템을 적용합니다.

1. 경사도 기반 장애물 배치

정점 간 이웃 높이차를 이용해 경사각(Gradient)을 계산합니다. 경사도가 35도 이상인 험준한 지형 영역의 표면에 바위나 파괴 가능한 장애물 메쉬를 풀링 시스템으로 자동 스폰합니다.

1. 표면 법선(Normal) 계산 및 물리 반영

삼각면 정점들의 외적(Cross Product)으로 표면 Normal을 실시간 산출합니다. 기체 레이캐스트를 통해 Up 벡터를 지면 Normal과 정렬하고, 경사각에 따라 내리막길 가속 및 오르막길 감속 피드백을 적용합니다.

1. 입체감을 높이는 조명 설정
2. Direct Light: 25~30도의 낮게 비추는 주광(Sun)을 설정하여 그림자를 길게 늘어뜨려 지형의 음영 입체감을 강조합니다.
3. Ambient & Fog: Gradient Ambient Light와 이동 속도에 따라 감도가 변하는 Height Fog를 조합하여 정교한 깊이감과 속도감을 선사합니다.

안녕하세요! 카카오페이 결제 연동 모듈의 안정성과 유지보수성을 높이기 위해 요청하신 가이드라인을 반영하여 코드 개선 방안과 커밋 메시지를 작성했습니다.

주요 개선 작업 내역 (예시)

1. 비동기 처리 및 타임아웃: PaymentService를 async/await 구조로 리팩토링하고, API 요청 시 timeout 옵션(기본 5000ms)을 설정할 수 있도록 개선했습니다.
2. 웹훅 서명 검증: 카카오페이 콜백 요청의 보안 강화를 위해 crypto.createHmac 기반의 validateWebhookSignature 검증 로직을 구현했습니다.
3. 재시도 로직: 5xx 서버 에러 발생 시 지수 백오프(Exponential Backoff) 알고리즘을 적용해 최대 3회 재시도하도록 처리했습니다.
4. 에러 핸들링 & 테스트: 커스텀 PaymentApiError 클래스를 도입하여 에러 응답 구조를 통일하고, Jest 단위 테스트 작성 및 README 문서 내 환경변수 설정 가이드를 업데이트했습니다.

권장 커밋 메시지

feat(payment): refactor KakaoPay module with retry and webhook verification

- Refactor payment request handler to async/await with configurable timeout
- Add HMAC-SHA256 signature verification logic for incoming webhook callbacks
- Implement exponential backoff retry mechanism for transient network errors
- Add PaymentApiError class and enhance overall error handling
- Add unit tests for payment approval flow and signature validation
- Update README.md with webhook environment configuration details

Senior WebGL Game Architect 관점에서 작성한 Three.js 및 Cannon.js 물리 엔진 연동 핵심 로직과 수학적 설명입니다.

1. 핵심 JavaScript 로직

import * as THREE from 'three';
import * as CANNON from 'cannon-es';

// 1. 물리 및 시각 씬 초기화
const scene = new THREE.Scene();
const world = new CANNON.World({ gravity: new CANNON.Vec3(0, -9.82, 0) });
const defaultMat = new CANNON.Material({ friction: 0.3, restitution: 0.7 });
world.addContactMaterial(new CANNON.ContactMaterial(defaultMat, defaultMat, { friction: 0.3, restitution: 0.7 }));

const objects = [];
const raycaster = new THREE.Raycaster();
const mouse = new THREE.Vector2();

// 2. 모듈식 객체 생성 함수 (Sphere, Box 등 커스텀 가능)
export function createPhysicsObject(mesh, shape, mass, position) {
  const body = new CANNON.Body({ mass, shape, material: defaultMat });
  body.linearDamping = 0.1;  // 공기 저항 (선형 댐핑)
  body.angularDamping = 0.1; // 회전 저항 (각 댐핑)
  body.position.copy(position);
  
  scene.add(mesh);
  world.addBody(body);
  objects.push({ mesh, body });
}

// 3. Force Interaction (클릭 시 충격량 부여)
window.addEventListener('pointerdown', (event) => {
  mouse.x = (event.clientX / window.innerWidth) * 2 - 1;
  mouse.y = -(event.clientY / window.innerHeight) * 2 + 1;
  
  raycaster.setFromCamera(mouse, camera);
  const intersects = raycaster.intersectObjects(objects.map(o => o.mesh));
  
  if (intersects.length > 0) {
    const hit = intersects[0];
    const targ

[PHASE 1: 재현 (Reproduce)]
PaymentServiceTest.java에 토큰 만료 상황을 재현하는 테스트를 작성했습니다.

@Test
void testPayment_TokenExpired_ThrowsNPE() {
    when(kakaoPayClient.getToken()).thenReturn(null);
    assertThrows(PaymentException.class, () -> paymentService.processCheckout(req));
}

*실패 테스트 출력:* FAILED: java.lang.NullPointerException at com.example.PaymentService.java:142

[PHASE 2: 가설 수립 (Hypothesize)]

1. 가설 1 (가능성 높음): 토큰 만료 시 API 응답이 null인데 검증 로직 없이 접근함 (PaymentService.java:142).
2. 가설 2 (중간): 토큰 갱신 실패 처리(catch) 누락으로 비동기 객체 반환 지점 오류.
3. 가설 3 (낮음): 결제 요청 타임아웃 시 세션 객체가 미리 삭제되는 레이스 조건.

[PHASE 3: 병렬 수정 (Parallel Fix)]

• Sub-agent 1 (fix/null-check): null 가드 로직 및 명시적 예외 처리 추가 -> *재현 테스트 통과, 전체 테스트 성공*
• Sub-agent 2 (fix/try-catch-retry): 토큰 재발급 로직 추가 -> *재현 테스트 통과, 타임아웃 테스트 1건 실패*
• Sub-agent 3 (fix/async-lock): 동기화 락 적용 -> *재현 테스트 여전히 실패*

[PHASE 4: 종합 및 병합 (Synthesize)]
권장 수정안: fix/null-check (Sub-agent 1)
사유: NPE의 근본 원인인 null 검증을 확실히 해결하며 기존 테스트 수트 전체(100%)를 성공적으로 유지함.
커밋 완료: git commit -m "fix: add null check and throw custom exception on expired KakaoPay token"