diff --git a/.forge/role-developer-live-1522-001-attempt-1-run-6a48084c658b.md b/.forge/role-developer-live-1522-001-attempt-1-run-6a48084c658b.md new file mode 100644 index 0000000..ae2040e --- /dev/null +++ b/.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`. diff --git a/.forge/role-pm-live-1522-001-attempt-1-run-3980dffa3ff4.md b/.forge/role-pm-live-1522-001-attempt-1-run-3980dffa3ff4.md new file mode 100644 index 0000000..adc3e67 --- /dev/null +++ b/.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`. diff --git a/docs/handover/PM_ROLE_HANDOVER.md b/docs/handover/PM_ROLE_HANDOVER.md new file mode 100644 index 0000000..d004309 --- /dev/null +++ b/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 diff --git a/pom.xml b/pom.xml new file mode 100644 index 0000000..a9c2722 --- /dev/null +++ b/pom.xml @@ -0,0 +1,39 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 3.2.5 + + + com.example + demo + 0.0.1-SNAPSHOT + demo + Developer Role Spring Skeleton Application + + 17 + + + + org.springframework.boot + spring-boot-starter-web + + + org.springframework.boot + spring-boot-starter-test + test + + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + \ No newline at end of file diff --git a/src/main/java/com/example/demo/DemoApplication.java b/src/main/java/com/example/demo/DemoApplication.java new file mode 100644 index 0000000..2a9bdbe --- /dev/null +++ b/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); + } +} diff --git a/src/main/java/com/example/demo/controller/HelloController.java b/src/main/java/com/example/demo/controller/HelloController.java new file mode 100644 index 0000000..54f430c --- /dev/null +++ b/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 greet() { + return ResponseEntity.ok(helloService.getGreeting()); + } + + @GetMapping("/{name}") + public ResponseEntity greetWithName(@PathVariable String name) { + return ResponseEntity.ok(helloService.getGreetingFor(name)); + } +} diff --git a/src/main/java/com/example/demo/service/HelloService.java b/src/main/java/com/example/demo/service/HelloService.java new file mode 100644 index 0000000..f2dfb2d --- /dev/null +++ b/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); + } +} diff --git a/src/main/resources/application.properties b/src/main/resources/application.properties new file mode 100644 index 0000000..4e0b68a --- /dev/null +++ b/src/main/resources/application.properties @@ -0,0 +1,2 @@ +spring.application.name=demo +server.port=8080 diff --git a/src/test/java/com/example/demo/DemoApplicationTests.java b/src/test/java/com/example/demo/DemoApplicationTests.java new file mode 100644 index 0000000..f37ed66 --- /dev/null +++ b/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 + } +} diff --git a/src/test/java/com/example/demo/controller/HelloControllerTest.java b/src/test/java/com/example/demo/controller/HelloControllerTest.java new file mode 100644 index 0000000..85559c4 --- /dev/null +++ b/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!")); + } +} diff --git a/src/test/java/com/example/demo/service/HelloServiceTest.java b/src/test/java/com/example/demo/service/HelloServiceTest.java new file mode 100644 index 0000000..55d748d --- /dev/null +++ b/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); + } +}