Merge pull request 'Developer 역할 Spring 골격 smoke' (#4) from forge/role-developer-live-1522-001-attempt-1-run-6a48084c658b into main

.forge/role-developer-live-1522-001-attempt-1-run-6a48084c658b.md

@@ -0,0 +1,3 @@
+# role-developer-live-1522-001-attempt-1-run-6a48084c658b
+
+Forge 이슈 작업 브랜치 `forge/role-developer-live-1522-001-attempt-1-run-6a48084c658b`.

.forge/role-pm-live-1522-001-attempt-1-run-3980dffa3ff4.md

@@ -0,0 +1,3 @@
+# role-pm-live-1522-001-attempt-1-run-3980dffa3ff4
+
+Forge 이슈 작업 브랜치 `forge/role-pm-live-1522-001-attempt-1-run-3980dffa3ff4`.

docs/handover/PM_ROLE_HANDOVER.md

@@ -0,0 +1,64 @@
+# PM 역할 인수인계 문서 (Smoke)
+
+**프로젝트**: runtime-role-matrix-live-202607141522  
+**작성일**: 2025-01-15  
+**작성자**: PM
+
+---
+
+## 1. 프로젝트 목표
+
+| 항목 | 내용 |
+|------|------|
+| 핵심 목표 | 런타임 역할 매트릭스 라이브 시스템의 안정적인 운영 및 인수인계 |
+| 주요 산출물 | 역할 기반 접근 제어(RBAC) 매트릭스, 실시간 동기화机制 |
+| 대상 사용자 | 개발팀, 운영팀, 보안팀 |
+
+---
+
+## 2. 완료 기준
+
+- [ ] 역할 매트릭스 설정 파일 검증 완료
+- [ ] 런타임 동기화 테스트 통과
+- [ ] 문서화 완료 (API, 설정, 장애 대응)
+- [ ] 인수인계 리허설 완료
+
+---
+
+## 3. 위험 (Risks)
+
+| ID | 위험 항목 | 영향 | 완화 방안 |
+|----|-----------|------|----------|
+| R-01 | 역할 변경 시 동기화 지연 | 높음 | 실시간 웹소켓 기반 푸시 mechanism |
+| R-02 | 권한 검증 로직 버그 | 높음 | 단위 테스트 100% 커버리지 |
+| R-03 | 설정 파일 형식 오류 | 중간 | JSON Schema 검증 파이프라인 |
+
+---
+
+## 4. 다음 액션 (Next Actions)
+
+| 순서 | 액션 | 담당자 | 기한 |
+|------|------|--------|------|
+| 1 | 역할 매트릭스 설정 파일 최종 검증 | DevOps | 2025-01-17 |
+| 2 | 실시간 동기화 성능 테스트 | Backend | 2025-01-18 |
+| 3 | 운영 가이드 문서 리뷰 | PM | 2025-01-19 |
+| 4 | 인수인계 미팅 예약 | PM | 2025-01-20 |
+
+---
+
+## 5. 주요 연락처
+
+| 역할 | 이름 | 연락처 |
+|------|------|--------|
+| PM | - | - |
+| Tech Lead | - | - |
+| DevOps | - | - |
+
+---
+
+## 6. 리포지토리 정보
+
+- **Repo**: `runtime-role-matrix-live-202607141522`
+- **Branch**: `main`
+- **CI/CD**: GitHub Actions
+- **Monitoring**: Prometheus + Grafana

pom.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>3.2.5</version>
+        <relativePath/>
+    </parent>
+    <groupId>com.example</groupId>
+    <artifactId>demo</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+    <name>demo</name>
+    <description>Developer Role Spring Skeleton Application</description>
+    <properties>
+        <java.version>17</java.version>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+</project>

src/main/java/com/example/demo/DemoApplication.java

@@ -0,0 +1,12 @@
+package com.example.demo;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class DemoApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(DemoApplication.class, args);
+    }
+}

src/main/java/com/example/demo/controller/HelloController.java

@@ -0,0 +1,29 @@
+package com.example.demo.controller;
+
+import com.example.demo.service.HelloService;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/api/hello")
+public class HelloController {
+
+    private final HelloService helloService;
+
+    public HelloController(HelloService helloService) {
+        this.helloService = helloService;
+    }
+
+    @GetMapping
+    public ResponseEntity<String> greet() {
+        return ResponseEntity.ok(helloService.getGreeting());
+    }
+
+    @GetMapping("/{name}")
+    public ResponseEntity<String> greetWithName(@PathVariable String name) {
+        return ResponseEntity.ok(helloService.getGreetingFor(name));
+    }
+}

src/main/java/com/example/demo/service/HelloService.java

@@ -0,0 +1,21 @@
+package com.example.demo.service;
+
+import org.springframework.stereotype.Service;
+
+@Service
+public class HelloService {
+
+    private static final String GREETING_TEMPLATE = "Hello, %s!";
+    private static final String DEFAULT_GREETING = "Hello, World!";
+
+    public String getGreeting() {
+        return DEFAULT_GREETING;
+    }
+
+    public String getGreetingFor(String name) {
+        if (name == null || name.isBlank()) {
+            return DEFAULT_GREETING;
+        }
+        return String.format(GREETING_TEMPLATE, name);
+    }
+}

src/main/resources/application.properties

@@ -0,0 +1,2 @@
+spring.application.name=demo
+server.port=8080

src/test/java/com/example/demo/DemoApplicationTests.java

@@ -0,0 +1,15 @@
+package com.example.demo;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.test.context.TestPropertySource;
+
+@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
+@TestPropertySource(properties = {"spring.main.allow-bean-definition-overriding=true"})
+class DemoApplicationTests {
+
+    @Test
+    void contextLoads() {
+        // Smoke test: verify Spring context loads successfully
+    }
+}

src/test/java/com/example/demo/controller/HelloControllerTest.java

@@ -0,0 +1,48 @@
+package com.example.demo.controller;
+
+import com.example.demo.service.HelloService;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.boot.test.mock.mockito.MockBean;
+import org.springframework.http.MediaType;
+import org.springframework.test.web.servlet.MockMvc;
+
+import static org.mockito.Mockito.when;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+@WebMvcTest(HelloController.class)
+@DisplayName("HelloController Unit Tests")
+class HelloControllerTest {
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @MockBean
+    private HelloService helloService;
+
+    @Test
+    @DisplayName("GET /api/hello returns default greeting")
+    void greet_ReturnsDefaultGreeting() throws Exception {
+        when(helloService.getGreeting()).thenReturn("Hello, World!");
+
+        mockMvc.perform(get("/api/hello")
+                        .accept(MediaType.APPLICATION_JSON))
+                .andExpect(status().isOk())
+                .andExpect(content().string("Hello, World!"));
+    }
+
+    @Test
+    @DisplayName("GET /api/hello/{name} returns personalized greeting")
+    void greetWithName_ReturnsPersonalizedGreeting() throws Exception {
+        when(helloService.getGreetingFor("Developer")).thenReturn("Hello, Developer!");
+
+        mockMvc.perform(get("/api/hello/Developer")
+                        .accept(MediaType.APPLICATION_JSON))
+                .andExpect(status().isOk())
+                .andExpect(content().string("Hello, Developer!"));
+    }
+}

src/test/java/com/example/demo/service/HelloServiceTest.java

@@ -0,0 +1,55 @@
+package com.example.demo.service;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+
+@DisplayName("HelloService Unit Tests")
+class HelloServiceTest {
+
+    private HelloService helloService;
+
+    @BeforeEach
+    void setUp() {
+        helloService = new HelloService();
+    }
+
+    @Test
+    @DisplayName("getGreeting returns default greeting")
+    void getGreeting_ReturnsDefaultGreeting() {
+        String result = helloService.getGreeting();
+        
+        assertNotNull(result);
+        assertEquals("Hello, World!", result);
+    }
+
+    @Test
+    @DisplayName("getGreetingFor returns personalized greeting")
+    void getGreetingFor_ReturnsPersonalizedGreeting() {
+        String result = helloService.getGreetingFor("Developer");
+        
+        assertNotNull(result);
+        assertEquals("Hello, Developer!", result);
+    }
+
+    @Test
+    @DisplayName("getGreetingFor with null returns default greeting")
+    void getGreetingFor_WithNull_ReturnsDefaultGreeting() {
+        String result = helloService.getGreetingFor(null);
+        
+        assertNotNull(result);
+        assertEquals("Hello, World!", result);
+    }
+
+    @Test
+    @DisplayName("getGreetingFor with blank string returns default greeting")
+    void getGreetingFor_WithBlankString_ReturnsDefaultGreeting() {
+        String result = helloService.getGreetingFor("   ");
+        
+        assertNotNull(result);
+        assertEquals("Hello, World!", result);
+    }
+}