path
Jin's Lab
코드로 실험하고 기록하는 개발 일지 · J.Lab

Jin's Lab

코드로 실험하고 기록하는 개발 일지. 커리어와 삶의 방향을 탐색하며 기록하는 공간입니다

Automation Queue

자동화 발행 큐 정렬 순서 오류로 뒤죽박죽된 포스트 복구기

J.Lab ·
목차

    얼마 전 자동화 시스템의 제목 동기화 버그를 잡고 기분 좋게 퇴근했다. 오랫동안 나를 괴롭히던 동기화 문제를 말끔히 해결하고 밀린 데이터를 맞추기 위해 수동 복구 스크립트까지 깔끔하게 돌린 직후였다. 하지만 다음 날 아침, 모닝커피를 마시며 링크드인 피드를 확인한 나는 경악을 금치 못했다. 분명히 논리적인 순서대로 차근차근 업로드되어야 할 시리즈 게시글이 가장 최근에 작성된 글부터 거꾸로 나가고 있었기 때문이다.

    내가 운영하는 개발 블로그는 단순한 잡담 공간이 아니라 작업 기록을 시리즈 순번대로 차곡차곡 쌓는 공간이다. 콘텐츠의 전후 맥락이 무엇보다 중요하기 때문에 순서가 뒤죽박죽 엉키는 것은 블로그 정체성에 매우 치명적이었다. 어쩌다가 잘 돌아가던 자동화 발행 시스템에서 순서가 뒤집히는 참사가 발생했는지 원인을 파악하기 위해 곧바로 로그를 분석하기 시작했다.

    발행 순서가 뒤섞여 혼란스러운 데이터베이스 상태를 나타내는 아이소메트릭 일러스트레이션

    정렬 조건 누락이 불러온 대참사

    원인은 생각보다 너무 허무하면서도 뼈아픈 곳에 있었다. 최근에 추가한 재활용 발행 기능을 담당하는 노션 API 조회 쿼리에 정렬 조건을 아예 지정하지 않았던 것이다. 큐 빌더가 조회 시점에 아무런 정렬 규칙을 전달하지 않자, 노션 데이터베이스는 자체적인 임의 순서대로 데이터를 반환해 버렸다.

    불행히도 노션이 판단한 임의 순서의 최상단에는 방금 내가 복구 스크립트로 신나게 수정한 글들이 배치되어 있었다. 결과적으로 자동화 발행 큐 정렬 메커니즘이 완전히 붕괴한 상태에서 최근 수정본이 가장 먼저 발행 프로세스에 투입되는 결과를 낳았다. 소스 시스템의 임의 반환 조건에만 전적으로 의존하는 구조가 얼마나 허술한지 뼈저리게 느끼는 순간이었다.

    이 문제를 완전히 해결하려면 큐에 콘텐츠를 채워 넣을 때마다 사전에 정의된 명확한 기준에 따라 재정렬하는 로직을 새로 보강해야만 했다. 외부 API의 정렬 동작에 의존하는 대신, 내부 코드에서 최종 순서를 완벽하게 통제할 수 있도록 기존에 세워둔 프로젝트 표준 설계를 다시 들여다보았다.

    우선순위 태그가 깔끔하게 정리된 노션 데이터베이스 관리 화면의 아이소메트릭 디자인

    CLAUDE.md 우선순위 규칙에서 답을 찾다

    다행히도 프로젝트의 빌드와 개발 가이드라인을 정의해 둔 CLAUDE.md 파일에는 콘텐츠 발행 우선순위가 명확하게 기재되어 있었다. 정의된 우선순위는 긴급도가 가장 높은 글부터 시작하여 높음 단계, 시리즈 순번순, 보통 단계, 마지막으로 낮음 단계 순서로 배정되는 구조였다. 이 우선순위 정의 규칙을 큐 빌더에 그대로 녹여내면 문제를 완벽히 해결할 수 있었다.

    심지어 같은 구글 앱스 스크립트(GAS) 프로젝트 안에는 이미 개별 아이템의 우선순위 가중치를 계산해 주는 기존 함수가 존재하고 있었다. 바로 getItemSortRank라는 이름의 헬퍼 함수였는데, 이 녀석은 콘텐츠의 긴급도 태그와 시리즈 순번 값을 조합하여 정렬용 가중치를 숫자로 변환해 주는 아주 유용한 도구였다.

    새로운 복잡한 정렬 코드를 처음부터 다시 작성할 필요 없이, 기존 프로젝트 안에 만들어 두었던 getItemSortRank 함수를 그대로 재사용하기로 결정했다. GAS 큐 빌더가 노션에서 API 데이터를 받아오는 직후에 이 가중치를 기준으로 수집된 데이터 배열을 다시 오름차순으로 완벽히 정렬하도록 코드를 전면 수정했다.

    자동화 큐가 명시적인 정렬 기준에 따라 순서대로 정렬된 모습을 보여주는 일러스트레이션

    명시적인 자동화 발행 큐 정렬의 중요성

    코드를 수정하고 다시 복구 스크립트를 시뮬레이션해 보니, 이제야 내가 의도했던 대로 큐가 차곡차곡 쌓이기 시작했다. 우선순위가 높은 글과 시리즈 순번이 앞서는 글들이 정확한 순서대로 배열에 배치되었고, 이 순서 그대로 안전하게 발행 대기 상태로 넘어갔다. 이번 삽질을 통해 시스템 간 연동에서 명시적인 정렬 규칙이 왜 핵심 요소인지를 다시금 똑똑히 깨닫게 되었다.

    세상의 모든 콘텐츠가 최신순으로 발행되어야 하는 것은 아니다. 독립적인 주제의 글이라면 무작위로 올라가도 지장이 없겠지만, 흐름이 이어지는 시리즈형 콘텐츠의 경우 발행 순서가 독자의 이해도를 완벽히 좌우한다. 앞으로는 그 어떤 외부 API를 연동하더라도 데이터의 순서를 소스 시스템에 내맡기지 않고, 자체적인 정렬 로직을 명시적으로 선언하여 주도권을 쥐고 설계할 것이다.

    Automation Queue Bug Fix Content Strategy Google Apps Script Notion API Publishing Flow
    ← 이전 글
    최근 게시물
    다음 글 →
    이전 게시물
    ≡ 글 목록으로
    소개
    path
    J.Lab

    커리어와 삶의 방향을 탐색하며
    기록하는 공간입니다

    카테고리
    403 Forbidden Error 1 429 Error 1 Ad Exchange 1 Ad Layout Guide 1 ad-slot 1 adsense 2 AdSense 2 AdSense Bot Detection 1 AdSense CTR 1 AdSense Display Issue 1 adsense-optimization 1 AI Automation 1 AI Image Generation 1 ai-automation 2 ai-book-writing 1 ai-image-generation 1 AI-Prompting 1 ai-side-hustle 1 ai-workflow 1 ai-writing 1 AIAutomation 1 AIBlogAutomation 1 AICodeLog 1 AIContentGeneration 1 AIImageGeneration 1 AIWritingErrors 1 API Automation 2 API Retry Design 1 api-automation 1 API-Deprecation 1 api-error 1 api-fallback 1 api-integration 2 api-pagination 1 api-retry-strategy 1 api-troubleshooting 1 APIDebugging 1 APIError 1 APIErrorHandling 1 APIIntegration 3 APIQuotaOptimization 1 APITokenRenewal 1 apps-script-trigger 1 AppsScript 1 appsScriptAutomation 1 AutomatedBlogging 1 automation 5 Automation 4 Automation Queue 1 Automation Scheduler 1 Automation Troubleshooting 1 automation-error 1 automation-script 1 AutomationBug 1 AutomationTroubleshooting 1 Backoff Algorithm 1 Base64 Image 1 Base64Encoding 1 batch-processing 1 BatchProcessing 1 Blog Optimization 2 blog-automation 4 blog-customization 2 blog-migration 4 blog-monetization 1 Blog-Sorting 1 blog-strategy 1 blog-theme-customization 1 blog-workflow 1 blogautomation 1 BlogAutomation 4 Blogger 13 Blogger API 2 Blogger Automation 2 Blogger SEO 1 blogger-api 4 blogger-automation 1 blogger-customization 1 blogger-error-400 1 blogger-labels 1 blogger-seo 1 blogger-theme 1 blogger-theme-debug 1 blogger-tips 1 Blogger-Tips 1 blogger-xml 1 BloggerAPI 7 BloggerAutomation 1 BloggerBypath 1 BloggerCustomization 2 BloggerFavicon 1 BloggerPermalink 1 BloggerTemplate 1 BloggerTemplateEditing 1 BloggerTheme 3 BloggerThemeCustomization 1 BloggerXMLStructure 1 Blogging-Automation 1 BloggingTools 1 BlogQuality 1 BlogSpot 1 Bug Fix 1 bug-fix 1 bug-hunting 1 BWidgetBIncludable 1 card-overlay-css 1 CardClickHandler 1 career-advice 1 CDATA 1 checklist-template 1 clamping-text 1 Claude 1 claude-ai 3 claude-code 2 ClaudeChat 1 ClaudeCode 1 CLIPTokenLimit 1 CloudflareWorkersAI 1 CNAME 1 Code Cleanup 1 Code Integration 1 code-refactoring 1 codelog 1 CodeLog 1 codeRefactoring 1 CodeStack 1 coding-log 2 comment-classification 1 config-pattern 1 Content Strategy 1 Content-Marketing 1 content-monetization 1 content-strategy 1 content-writing 1 contentsequencing 1 ContentStrategy 1 context-management 1 cost-reduction 1 CSS 1 css-axis-rotation 1 css-bug-fix 1 CSS-Debugging 1 css-fix 1 css-flexbox 1 css-layout 3 css-logo 1 css-print 1 css-troubleshooting 1 CSSLayout 1 CSSOverlay 1 Custom Domain 1 custom-theme 1 data-backfill 1 data-parsing 1 data-synchronization 1 data-validation 1 DatabaseDesign 1 DataMigration 1 DataRecovery 1 DataValidation 1 DateInjection 1 debugging 2 Debugging 5 Debugging Log 1 DebuggingLog 1 derived-state 1 detail-page-design 1 dev-journey 2 dev-log 1 Developer-Blog 1 developer-career 1 DeveloperJourney 2 DevJourney 1 DevLog 1 digital-creator 1 digital-products 2 display-none-seo 1 DOM-Inspection 1 dom-manipulation 1 Domain Migration 1 DomainMigration 1 DOMAutomation 1 duplicate-content 1 dynamic-menu 1 ebook-marketing 2 ebook-planning 1 ebook-publishing 5 editing-tips 1 Error Handling 2 error-handling 1 Error-Handling 1 ErrorHandling 2 EventDispatch 1 Execution Timeout 1 ExecutionLimit 1 exponential-backoff 1 FactChecking 1 FallbackSystem 1 FaviconEmbedding 1 Feed-API 1 filesystem 1 Flat Illustration 1 flux-model 1 FluxModel 1 FreeAIImage 1 frontend 1 Frontend 1 frontend-developer 1 frontend-layout 1 frontend-tips 1 FrontEndDev 1 FrontendTips 1 GAS 1 GAS Blogger API 1 GAS Refactoring 1 GAS Trigger 1 gas-automation 2 gas-optimization 1 gas-trigger 1 GASTimeout 1 gasTriggerManagement 1 GCP Project Linkage 1 Gemini 1 Gemini API 2 gemini-api 1 GeminiAPI 3 GeminiPrompt 1 GeminiPromptEngineering 1 getBoundingClientRect 1 github-raw-url 1 GmailRestrictions 1 Google AdSense 1 Google Apps Script 12 Google Discover 1 google-apps-script 8 Google-Apps-Script 1 google-blogger 1 googleAppsScript 1 GoogleAppsScript 12 googlesapps-script 1 GoogleSearchConsole 1 grep 1 hero-image 1 hero-image-validation 1 HTML Fix 1 HTMLCSS 1 HTMLWidgetBlogger 1 http-429 1 HuggingFace 1 HuggingFaceAPI 1 ico-generator 1 Image Optimization 1 image-automation 2 image-generation 1 image-hosting 1 image-optimization 1 image-processing 1 image-upload 1 ImageGeneration 2 ImageIntegrity 1 ImageOptimization 1 In-App Browser 1 invalid-argument 1 javascript 4 JavaScript 4 javascript-automation 1 javascript-toc 1 JavaScriptDevLog 1 JavaScriptInjection 1 jlab-codelog 1 JLabDevLog 1 json-schema 1 label-length-limit 1 lead-magnet 1 legacy-code 1 LinkedIn-API 2 LinkedIn-OAuth 1 LinkHub 1 linux 1 markdown 1 meta-description 1 MetaTags 1 Migration 1 Migration Script 1 mobile-friendly 1 Mobile-Web 1 monetization 1 Monitoring Automation 1 MultilingualSEO 1 NakedDomain 1 Negative Prompt 1 node-js 1 nodejs-automation 1 noindex-tag 1 Notion API 1 notion-api 3 notion-database 2 notion-gas-integration 1 notion-setup 1 notion-template 1 NotionAPI 3 NotionAutomation 1 notionintegration 1 NotionIntegration 1 OAuth Scope 1 OpenGraph 1 padding-overlap 1 pagination 1 payload-validation 1 pdf-generation 1 pdf-publishing 1 pdf-selling 1 permalink-management 1 PersonaDesign 1 pil-image-processing 1 Pinterest 2 PinterestAutomation 1 PipelineFix 1 playwright 1 Pollinations 1 Pollinations Flux 1 pollinations-ai 1 pollinations-api 2 PollinationsAI 1 PositionAbsolute 1 post-queue 1 productivity-tools 1 Prompt Design 1 Prompt Engineering 1 prompt-engineering 3 Prompt-Engineering 1 prompt-validation 1 PromptEngineering 3 Publishing Flow 1 publishorder 1 python-favicon 1 python-markdown 1 python-pil 2 python-scripting 1 Queue Design 1 queue-pattern 1 queue-stuck 1 RandomDelay 1 rate-limiting 1 react 1 React 1 Refactoring 1 Resource Exhausted 1 responsive-ads 1 responsive-design 4 ResponsiveCSS 1 ResponsiveDesign 1 retrospective 1 rfc3339 2 Robots Meta Tag 1 RSS Feed 1 rss-feed 1 RSSProxy 2 SAXParseException 1 Script Authorization 1 scriptNotFound 1 SDXL 1 Search Engine Optimization 2 Search-Engine-Optimization 1 SearchConsole 1 Self Rescheduling Trigger 1 SEO 2 SEO Tips 1 seo-optimization 5 SEO-Optimization 1 SEOOptimization 2 seriesmanagement 1 serverless-automation 1 sessionstart-hook 1 shell-script 1 Side Ad Duplication 1 side-income 1 side-project 1 SidebarLinks 1 SNSMarketing 1 Social-Media-Automation 2 SocialSharing 1 state-management 1 StaticWebPage 1 sub-agent 1 SVG Icon 1 svg-mask 1 SVGIcon 1 Synchronization 1 table-of-contents 1 tech-blogging 1 TechJournal 1 TechVibe 1 Template 1 TextSanitization 1 threads-api 2 Threads-API-Comparison 1 ThreadsAPI 3 time-driven-trigger 1 Tistory 2 tistory-customization 1 tistory-migration 1 tistory-skin 1 tistory-theming 1 tistory-tips 1 TOC Ad Placement 1 token-optimization 1 TranslationAPI 1 transparent-favicon 1 triggerCleanup 1 troubleshooting 2 Troubleshooting 2 typesetting 1 ui-optimization 1 unzip 1 URL Slug 1 UrlFetchApp 1 usememo 1 UTF8Encoding 1 vanilla-js 1 Web Development 2 Web Publishing 2 Web Security 1 web-development 7 Web-Development 2 web-development-log 1 web-development-tips 1 web-layout 1 Web-Layout 1 web-performance 1 web-publisher 1 web-scraping 1 WebAccessibility 1 WebAutomation 1 WebDebugging 1 WebDesign 2 WebDevelopment 10 WebDevelopmentTips 1 WebDevJourney 1 WebMigration 1 windows 1 windows-task-scheduler 2 WorkAutomation 1 workflow-automation 1 WorkflowAutomation 1 writing-process 1 XHTML 1 XMLCustomization 1 XMLParser 1 XMLSpecialCharacters 1 XMLTheme 1 z-index-issue 1 zip 1
    인기 글
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    다른 블로그
    IssueLog
    IssueLog
    issuelog.jinbytes.com
    KidStory
    KidStory
    kidstory.jinbytes.com
    IT Story
    IT Story
    jinbytes.com
    이야기하는 밤
    이야기하는 밤
    story.jinbytes.com
    [eBook] 개발자로 살아간다는 것
    [eBook] 개발자로 살아간다는 것
    유료 전자책
    [eBook] FE 실무 디테일
    [eBook] FE 실무 디테일
    유료 전자책
    [미니북] FE 실무 디테일
    [미니북] FE 실무 디테일
    무료 미니북
    © Jin's Lab · J.Lab · All Rights Reserved
    jinbytes.com · Powered by Blogger