tdc114plus/docs/review_tdc114plus_policy_document_2026-07-07.md

tdc114plus 정책 문서 개편 검토

작성일: 2026-07-07 상태: review v1.0

목적: docs/ 아래 기존 정책/계약/절차 문서가 새로 수립한 분리형 API 전환 정책 기준으로 수정 가능한지 검토하고, 문서별 후속 조치 방향을 정리한다.

관련 기준 문서:

• docs/00_policy_tdc114plus_decoupled_api_migration_2026-07-07.md

백업 위치:

• /home/ubuntu/workspace/tdc114plus/temp/docs-policy-backup/

1. 결론

• 기존 문서들은 대부분 수정 가능하다.
• 다만 전부를 새로 쓰는 것은 아니고, 문서 성격에 따라 전면 개정, 부분 개정, 유지, 기록 보존으로 나눠야 한다.
• 특히 개발 정책, API 계약, 테스트 정책, 작업 타임테이블, 외부 API 사용 가이드는 새 정책 기준으로 반드시 재정렬하는 것이 맞다.
• 반대로 Android 설치/ADB/체크리스트류 문서는 분리형 API 정책과 직접 충돌하지 않으므로 기본 유지가 맞다.

2. 문서별 판정

문서	판정	이유	권장 조치
docs/00_policy_tdc114plus_development_2026-07-02.md	전면 개정 권장	Baron SSO API 생성 중심 문구가 강하고 Swagger 중심 인터페이스 개발 원칙이 상위 기준으로 드러나지 않음	새 정책을 반영해 상위 실행 원칙 문구 재작성
docs/00_contract_tdc114plus_api_2026-07-02.md	전면 개정 권장	현재 계약이 Baron SSO 전용 설계와 내부 추정 구조에 많이 기대고 있음	Swagger 기준 endpoint/DTO 문서로 재작성
docs/00_policy_tdc114plus_testing_2026-07-02.md	부분 개정 권장	테스트 구조는 유효하지만 실제 API 연동 기준이 Baron SSO runtime 중심임	mock 우선, Swagger 계약 검증, remote/mock 전환 테스트 기준 추가
docs/00_guide_tdc114plus_work_progress_timetable_2026-07-02.md	부분 개정 권장	기존 진행 이력은 보존 가치가 있으나 실행 Phase가 이전 방식 중심으로 적혀 있음	새 정책 Phase 기준으로 다음 작업 구간만 재정렬
docs/00_guide_tdc114plus_external_api_usage_2026-07-03.md	부분 개정 권장	외부 API 활용 방식 문서이므로 새 정책과 잘 결합 가능	Swagger 우선 사용 원칙과 data source 분리 기준 추가
docs/guide_baron_sso_reference_source_2026-07-02.md	부분 개정 권장	완전 삭제할 문서는 아니지만, 이제는 Baron SSO 코드 참조 문서이지 앱 개발 상위 기준 문서는 아님	제목/목적을 참조용 문서 성격으로 낮추고 우선순위 하향
docs/00_policy_tdc114plus_screen_feature_2026-07-07.md	부분 개정 가능	화면 정책 자체는 유효하지만 일부 용어가 Baron SSO 전제에 묶여 있음	화면 규칙은 유지하고 API/세션 관련 표현만 일반화
docs/dev_env_tdc114plus_setup_plan_2026-07-02.md	기록 보존 중심	초기 환경 구축 기록 성격이 강하고 현재는 실행 정책 문서라기보다 이력 문서에 가까움	원본 유지, 필요 시 현재 환경 기준 별도 문서 신설
docs/guide_tdc114plus_development_decision_brief_2026-07-01.md	기록 보존 중심	초기 판단 근거 문서라 현재 정책으로 덮어쓰는 대상이 아님	원본 유지
docs/guide_tdc114plus_script_automation_plan_2026-07-02.md	부분 개정 가능	자동화 계획은 계속 유효하나 검증 대상을 Swagger 계약 기준으로 보강할 필요가 있음	smoke/test 분리를 명확히 보강
docs/policy_android_app_install_execution_2026-07-06.md	유지	API 분리 정책과 직접 충돌 없음	유지
docs/policy_android_studio_wsl_adb_2026-07-03.md	유지	개발 장비/실행 정책 문서라 독립적임	유지
docs/scenario_android_emulator_device_integration_test_2026-07-03.md	부분 개정 가능	시나리오는 유효하나 API 대상 URL/테스트 전제가 바뀔 수 있음	실제 API 대상 설명만 갱신
docs/checklist_pre_staging_manual_2026-07-06.md	부분 개정 가능	staging 체크리스트는 유지 가능하나 기준 API가 Swagger 중심으로 바뀌어야 함	체크 항목 갱신
docs/scenario_staging_baron_sso_login_verification_2026-07-06.md	부분 개정 가능	로그인 검증 흐름은 유효하지만 Baron SSO 내부 구현 전제가 강함	인터페이스 계약 기준으로 표현 수정
docs/checklist_morning_startup_runtime_2026-07-03.md	유지	운영성 체크리스트라 정책 변경 영향이 낮음	유지
docs/checklist_evening_shutdown_runtime_2026-07-06.md	유지	운영성 체크리스트라 정책 변경 영향이 낮음	유지
docs/guide_baron_org_context_api_reference_2026-07-03.md	참조용 유지	특정 외부 연동 참고자료로 쓸 수 있음	정책 문서가 아닌 reference로 유지
docs/guide_baron_sso_org_context_mirror_recovery_request_2026-07-03.md	기록 보존	이슈 대응 기록 문서임	유지

3. 우선 개편 대상

가장 먼저 손대야 할 문서는 아래 다섯 개다.

1. docs/00_policy_tdc114plus_development_2026-07-02.md
2. docs/00_contract_tdc114plus_api_2026-07-02.md
3. docs/00_policy_tdc114plus_testing_2026-07-02.md
4. docs/00_guide_tdc114plus_work_progress_timetable_2026-07-02.md
5. docs/00_guide_tdc114plus_external_api_usage_2026-07-03.md

이유:

• 새 정책의 실행력은 위 다섯 문서가 실제로 같은 방향을 보느냐에 달려 있다.
• 특히 개발 정책과 API 계약이 이전 기준에 남아 있으면 이후 코드 작업도 다시 Baron SSO 종속 방식으로 흔들릴 수 있다.

4. 수정 방식 제안

권장 순서:

1. tdc114plus-development-policy를 먼저 고친다.
2. 그 다음 tdc114plus-api-contract를 Swagger 기준으로 재작성한다.
3. 이후 tdc114plus-testing-policy를 mock/contract/real API 3단계 구조로 맞춘다.
4. tdc114plus-work-progress-timetable의 다음 작업 구간을 새 Phase 기준으로 정리한다.
5. 마지막으로 external-api-usage-guide, screen-feature-policy, staging 체크리스트 문서를 정렬한다.

5. 해석 원칙

• 기존 문서에 적힌 과거 진행 이력은 가능한 보존한다.
• 다만 앞으로의 실행 기준은 docs/00_policy_tdc114plus_decoupled_api_migration_2026-07-07.md를 상위 기준으로 둔다.
• Baron SSO 관련 문구가 있어도 참조, 연동 대상, 과거 구현 근거 수준이면 유지 가능하다.
• Baron SSO 소스 수정 또는 Baron SSO 전용 endpoint 추가를 기본 개발 방식처럼 서술한 부분은 새 정책에 맞춰 수정해야 한다.

6. 다음 문서 작업 제안

다음 실제 수정 작업은 아래 순서가 가장 적절하다.

1. docs/00_policy_tdc114plus_development_2026-07-02.md 개정
2. docs/00_contract_tdc114plus_api_2026-07-02.md 개정
3. docs/00_policy_tdc114plus_testing_2026-07-02.md 개정

이 세 문서가 먼저 정리되면, 이후 코드 구조 개편도 문서 기준으로 일관되게 진행할 수 있다.