OpenAPI 문서와 실제 API가 어긋날 때 먼저 잡을 기준Swagger UI에는 분명 email이 필수라고 적혀 있는데, 실제 응답에는 가끔 빠집니다. 문서에는 status가 active | blocked라고 되어 있지만 운영 데이터에는 pending이 섞여 있습니다. 프론트엔드는 타입을 믿고 배포했는데, 어느 날 특정 고객 계정에서만 화면이 깨집니다.이런 문제는 OpenAPI를 "문서 자동 생성" 정도로만 보면 계속 반복됩니다. OpenAPI는 예쁜 API 문서가 아니라, 클라이언트와 서버가 함께 지키는 계약으로 다뤄야 합니다. 계약이 깨지는 순간은 대개 큰 리팩토링 때가 아닙니다. 필드 하나를 optional로 바꾸거나, 에러 응답 형식을 급하게 추가하거나, 테스트 데이터에 없는 케이스가 운영에서..
분리배출 헷갈릴 때, 집에서 먼저 확인할 7가지 기준택배 상자를 뜯고 나면 종이 상자, 송장 스티커, 완충재, 테이프가 한꺼번에 남습니다. 배달 음식 용기는 더 애매합니다. 플라스틱처럼 보이지만 기름이 묻어 있고, 비닐은 깨끗한 것 같지만 양념 냄새가 남아 있습니다.이럴 때 분리배출 표시만 보고 바로 버리면 자주 틀립니다. 표시가 있더라도 내용물이 남아 있거나, 다른 재질이 붙어 있거나, 지역 수거 방식과 맞지 않으면 재활용품으로 처리되기 어렵습니다. 집에서 판단할 때는 표시 확인보다 비우기 → 헹구기 → 분리하기 → 섞지 않기 순서가 먼저입니다.3줄 요약분리배출의 기본은 환경부가 안내한 네 가지 원칙, 즉 비우고 헹구고 분리하고 섞지 않는 것입니다.오염이 심한 종이, 기름 묻은 비닐, 내용물이 남은 용..
목 어깨 통증 줄이는 책상 루틴: 자세보다 먼저 바꿀 5가지목이 뻐근해서 자세를 고쳐 앉아도 10분 뒤면 다시 모니터 쪽으로 몸이 기울어집니다. 의지가 약해서가 아닙니다. 모니터가 낮고, 마우스가 멀고, 팔을 둘 곳이 없으면 몸은 계속 그쪽으로 끌려갑니다. 오래 앉아 일하는 사람의 목 어깨 통증은 "바른 자세를 얼마나 오래 참느냐"보다 틀어진 세팅을 얼마나 덜 만들었느냐에서 먼저 갈립니다.최종 업데이트: 2026-08-06이 글은 일반적인 생활 건강 정보입니다. 목 통증의 진단이나 치료를 대신하지 않습니다. 통증이 심하거나 팔 저림, 힘 빠짐, 발열, 외상 뒤 통증처럼 경고 신호가 있으면 의료 전문가에게 확인하는 편이 안전합니다.먼저 보면 좋은 기준책상 루틴의 목표는 완벽한 자세가 아니라, 목과 어깨가 ..
페이지 번호를 포기해야 할 때, OFFSET과 커서 페이지네이션의 갈림길관리자 목록 화면에서 1페이지는 40ms, 900페이지는 4초가 나오는 상황을 본 적이 있습니다. 쿼리는 똑같습니다. 인덱스도 그대로입니다. 바뀐 건 OFFSET 뒤에 붙은 숫자 하나뿐입니다. 이때 개발자가 가장 먼저 손대는 곳은 보통 인덱스인데, 정작 문제는 인덱스가 아니라 "건너뛰기"라는 동작 자체에 있습니다.이 글은 목록 API를 만들 때 OFFSET 방식과 커서 방식 중 무엇을 고를지 판단하는 순서를 정리한 것입니다. 성능 비교표를 만드는 것이 목적이 아니라, "우리 화면이 정말 페이지 번호를 필요로 하는가"부터 되묻는 쪽에 가깝습니다. MySQL, PostgreSQL 공식 문서와 Laravel 페이지네이션 문서를 기준으로 삼..
재택근무 생산성은 "집에서 일하느냐"보다 "집에서 일하는 방식을 어떻게 설계하느냐"에 더 크게 좌우됩니다. OECD는 관리자와 근로자 모두 재택근무를 대체로 긍정적으로 평가했지만, 이상적인 빈도는 주 2~3일 수준이라고 분석했고, 커뮤니케이션과 지식 흐름 저하가 주요 비용이라고 설명합니다. ILO도 재택근무는 유연성을 주지만 일과 사생활의 경계가 흐려지고 장시간 노동과 고립 위험이 커질 수 있다고 지적합니다. (출처: OECD - The role of telework for productivity during and post-COVID-19, ILO - Working from home: From invisibility to decent work)요약 박스재택근무 생산성은 집중 시간 확보, 비동기 문서화,..
AI Coding Agent · Open Source Tools AI 코딩 에이전트를 더 똑똑하게 만드는 오픈소스 도구들 Claude Code, Codex, Cursor, Gemini CLI 같은 AI 코딩 에이전트를 실제 개발 워크플로우에 붙일 때 필요한 메모리, 토큰 최적화, 코드베이스 분석, 명세화, 작업 관리 도구를 정리했다. 요약 AI 코딩의 생산성은 모델 성능만으로 결정되지 않는다. 에이전트가 기억하고, 로그를 줄이고, 코드베이스를 이해하고, 요구사항을 명세화하고, 작업 상태를 추적할 수 있어야 실제 개발 환경에서 안정적으로 쓸 수 있다. 목차 AI 코딩 에이전트에 보조 도구가 필요한 이유 mem0 / Honcho: 장기 메모리..