본문 바로가기

upcurve631

[독서 기록] 기술문서 작성 완벽 가이드(자레드 바티 외 지음, 하성창 옮김, 한빛미디어) 하버드 대학의 한 경제학자 그룹은 사람들이 다른 사람도 자신과 같은 지식을 갖고 있다고 가정한다는 연구 결과를 내놓았습니다. 그들은 이 인지적 편향을 '지식의 저주'라고 명명했습니다. - 30p 지식의 저주를 기억하세요. 사용자는 여러분만큼 제품을 잘 알지 못하므로 제품과 관련하여 생각지도 못한 기초적인 질문을 할 수도 있습니다. - 35p 사용자 페르소나를 만들어 나갈 때는 사용자의 니즈를 고려해야 합니다. 누구에게 가장 도움이 필요한가요? 여러분의 소프트웨어를 사용하려고 할 때 누가 가장 가파른 학습 곡선을 경험하게 될까요? - 44p 사용자 스토리는 일반적으로 다음과 같은 형식을 따릅니다. '[사용자 유형]으로서, [목표]를 할 수 있도록 [행동]을 하고 싶다.' - 44p 개발자에게 가장 기본적인.. 2023. 8. 17.
Spring에서 argumentResolver를 사용하여 인증 책임 분리하기 문제의식 다음과 같은 컨트롤러 메서드가 있다고 해보자. @PostMapping("/tasks") public ResponseEntity createTask(@RequestBody TaskCreateReq taskCreateReq, HttpSession session) { final Long userId = (Long) session.getAttribute(LOGIN_SESSION_KEY); if (userId == null) { throw new RuntimeException("bad request. no session."); } taskService.create(taskCreateReq, AuthUser.of(userId)); return ResponseEntity.ok().build(); } 위 코드.. 2023. 7. 23.
객체 필드 중복을 해결하는 다양한 방법들과 객체지향 패러다임을 이용한 순수 코드 방식의 해결법(feat. DDD의 Aggregate와의 연관성) 문제 정의 비슷한 역할을 하는 객체가 여러 있을 수 있다. 이때 동일한 필드를 가져 중복 코드가 다수 발생하는 문제가 생긴다. 예를 들어 일정 관리 프로그램을 만드는 과정에서 다음과 같이 Event(이벤트), Task(할일), Notification(알림) 객체들이 있다고 해보자. @Getter @NoArgsConstructor public class Event { private Long id; private LocalDateTime startAt; private LocalDateTime endAt; private String title; private String description; private User writer; private List engagements; private LocalDate.. 2023. 7. 22.
RestDocs로 API 문서를 만들어보자 (MockMvc 테스트, 커스터마이징 옵션 설정하기) RestDocs란 ? - 테스트 코드 기반으로 Restful Api 문서 생성을 돕는 도구 - Asciidoctor를 이용해서 Html 등등 다양한 포맷으로 문서를 자동으로 출력할 수 있다. - 가장 큰 장점은 테스트 코드 기반으로 문서를 작성한다는 것이다. -> 테스트 코드 강제화 -> 검증된 문서 보장 Swagger Vs RestDocs Swagger는 Api에 대한 명세 기능을 제공하면서도 호출에 좀 더 초점을 맞추고 있다. 또한 Swagger는 애노테이션 기반으로 구성해야 한다. 예를 들면 다음과 같은 방식이다. 실제 코드에 영향을 미치지는 않지만 지속적으로 명세를 추가해야 하기 때문에 복잡성이 증대된다. 집중해야 하는 비즈니스 로직에 덧붙이는 코드가 많기 때문에 가독성을 해친다. 반면 RestD.. 2023. 7. 13.
[독서 기록] 개발자 원칙 - 박성철, 강대명, 공용준, 김정, 박미정, 박종천, 이동욱(네피림), 이동욱(향로), 장동수 공저 개발자 원칙 “나도 테크 리더가 될 수 있을까? 어떻게 선배 개발자들처럼 성장할 수 있을까? 3년 10년 후에도 개발자로 살아갈 수 있을까? 팀워크는 도대체 어떻게 맞춰야 하는 걸까?” 개발자로 살아가면서 하루에도 천 번을 되묻는 물음에 컬리, 레몬트리, 카카오, 코드스쿼드, 무신사, 몰로코, 데이블, 인프런, 패스트캠퍼스 테크 리더 9명이 답합니다. 지금까지 만나 볼 수 없었던 생존과 성장의 원칙에서 자신만의 해답을 찾아보세요. 저자 박성철, 강대명, 공용준, 김정, 박미정, 박종천 출판 골든래빗(주) 출판일 2022.12.20 원칙 : 쓸모 있는 소프트웨어를 만들자 - 26, 박성철 저는 개발자를 두고 공장에 자기만의 생산 선비를 들고 들어가서 일하는 노동자라고 표현합니다. - 39, 박성철 최종적인.. 2023. 7. 13.

티스토리툴바