/cc-inspector:config — 앱 설정·기능 스위치 점검기#

한마디로#

실행 중인 앱이 지금 어떤 설정값으로 돌아가고 있는지 들여다보는 도구입니다. 건물의 두꺼비집(배전반)을 열어 "어떤 스위치가 켜져 있고, 어느 콘센트에 연결돼 있는지" 확인하는 것과 같아요.

누가·언제 쓰나요#

• "분명히 켰는데 그 기능이 안 보여요" — 기능 스위치(feature flag)가 진짜 켜져 있는지 확인하고 싶을 때
• "개발용인데 운영 설정으로 켜진 것 같아요" — 지금 앱이 개발/운영 중 어떤 환경으로 돌고 있는지 헷갈릴 때
• "외부 서버 연결이 안 돼요" — 앱이 바라보는 주소(API 주소)가 맞는지 점검할 때

무엇을 해주나요#

실행 중인 앱에서 다음을 그 자리에서 읽어 보여줍니다.

• 전체 설정값 — 앱이 쓰는 모든 설정을 한눈에 (비밀번호·키 같은 민감 값은 ***masked***로 가려서 안전하게)
• 특정 설정값 — 궁금한 항목 하나만 콕 집어서 (예: 외부 서버 주소 apiBaseUrl)
• 기능 스위치 상태 — 어떤 기능이 켜져(on) 있고 꺼져(off) 있는지 (예: 다크 모드, 새 홈 화면)
• 현재 환경 정보 — 지금이 개발(development)인지 운영인지, 버전은 몇인지

어떻게 쓰나요#

# 모든 설정값 한 번에 보기
/inspector/config all

# 특정 설정값 하나만 보기 (예: 외부 서버 주소)
/inspector/config value apiBaseUrl

# 기능 스위치(켜짐/꺼짐) 상태 보기
/inspector/config flags

# 현재 환경 정보 보기 (개발/운영, 버전 등)
/inspector/config env

all은 전체, value는 한 항목만, flags는 기능 스위치, env는 환경 정보를 봅니다. 상황에 맞는 것 하나만 골라 쓰면 됩니다.

안에서 무슨 일이 벌어지나요#

대표적인 문제 상황별로 점검 순서가 정해져 있습니다.

• 기능이 안 켜질 때: 기능 스위치 목록을 불러와 해당 스위치가 켜져 있는지, 켜지는 조건이 맞는지 차례로 확인합니다.
• 환경 설정이 어긋난 것 같을 때: 현재 환경을 먼저 확인하고, 전체 설정값을 불러와 "원래 기대했던 환경"과 비교합니다.
• 외부 연결이 안 될 때: 서버 주소(apiBaseUrl)가 올바른 곳을 가리키는지 보고, 환경별로 설정이 다른지 점검합니다.

{
   " config " : {
     " apiBaseUrl " :  " https://api.example.com " ,
     " apiKey " :  " ***masked*** " ,
     " timeout " : 30000,
     " cacheEnabled " : true
  }
}

{
   " featureFlags " : {
     " ui " : {
       " darkModeEnabled " : true,
       " newHomeLayout " : false
    },
     " api " : {
       " useNewEndpoint " : true
    }
  }
}

{
   " environment " : {
     " name " :  " development " ,
     " isDebug " : true,
     " flavor " :  " dev " ,
     " version " :  " 1.0.0 " 
   }
}

1. config_get_feature_flags - >   Check flag status
2. Check the relevant feature flag value
3. Review flag condition logic

1. config_get_environment - >   Check current environment
2. config_get_all - >   Check configuration values
3. Compare with expected environment

1. Check config_get_value key= " apiBaseUrl " 
 2. Verify it is the correct endpoint
3. Check configuration differences across environments

/inspector/config all

/inspector/config value apiBaseUrl

/inspector/config flags

/inspector/config env