Aislo/docs/raw/plans/2026-08-02_plan_backlog_reorg.md

[C04] 미결사항 전면 재정리 및 토공 운반장비 선정거리 확정

이 문서는 docs/raw/PLAN.md의 「현재 작업」에서 검증 완료 후 이관된 아카이브입니다. 검증 보고서: docs/raw/verification/2026-08-02_verify_backlog_reorg.md 검증 판정: CONDITIONAL PASS — 기능·판단 결함 없음. 문서 기재 오류 1건(F5) 아래에서 정정함.

---

[C04] 미결사항 전면 재정리 및 장비 선정거리 확정 (2026-08-02)

사용자와 미결사항 8개 항목을 하나씩 검토해 코드 반영 1건 + 판단 확정 3건 + 조사 결론 2건 + 항목 삭제 3건을 처리했다. 향후 작업에 남아 있던 미해결 항목 중 이번에 해결된 것을 여기로 옮겨 아카이빙 대상으로 남긴다.

1. 토공 운반장비 선정거리 config 반영 (코드 변경)

• 결정: 종무대 ≤20m / 도쟈 ≤50m / 그 이상 덤프. 3공구 실제 도면 관측치(종무대 14~16m, 도쟈 20m, 덤프 67.8m)와 모순 없다.
• 구현: config/config_system.py 5-4-5절 신설.

  EARTHWORK_HAUL_EQUIPMENT_LIMITS_M = (
      ("free_haul", 20.0),    # 종무대
      ("dozer", 50.0),        # 도쟈
      ("dump_truck", None),   # 덤프 — 나머지 전부
  )
  

• 단일 정의처 규칙: 이 경계는 오직 이 상수 한 곳에서만 정의·참조한다.
• 일반 토목 문헌과의 차이(기록용): 일반 도로토공 자료는 무대 20m / 도쟈 70m / 스크레파 500m / 덤프 500m 이상을 쓴다. 임도는 연장이 짧고 스크레파를 쓰지 않으므로 도면 기준값을 채택했다. 나중에 조정 시 이 차이를 근거로 판단한다.
• 커밋: e684131. ruff format / ruff check 통과, config_system.py 604줄.

2. M.N 성격 확정 (판단)

평탄화 후 유토곡선과의 마지막 교차 측점을 가리키는 위치값이다. 토량 계산에 관여하지 않으므로 Phase 2에서 표기만 하면 된다. 선행 조건에서 내렸다.

3. 「누가토량 vs 사토 합계 11배 모순」 — 모순 아님 (오기록 정정)

최종 누가토량은 사토 + 리핑암 + 발파암 전부의 합이므로 사토 합계와 다른 것이 정상이다. C02 분석 문서에 「모순」으로 적어 둔 것은 정의 차이를 오인한 것이며, 이를 정정하고 향후 작업 1번(암반 경계선 분리)의 근거로 전환했다.

4. 토량환산계수 성격 확정 (판단)

돈이 아니라 부피 보정값이다. 같은 흙도 상태에 따라 부피가 달라진다.

계수	정의	쓰이는 곳
L (팽창률)	흐트러진 부피 ÷ 자연상태 부피	트럭 적재 대수 =운반량
C (다짐률)	다진 부피 ÷ 자연상태 부피	성토에 실제 들어가는 양 =소요량

절토 100㎥와 성토 100㎥를 그대로 뺄 수 없는 이유이며, 유토곡선이 다짐상태로 기준을 통일하는 근거다. 비용과는 간접적으로만 연결된다 — 수량이 확정돼야 B08/B09에서 단가를 곱한다. 실무값 확정은 향후 작업 3번으로 남는다.

5. raw/guidelines/design.md 조사 결론

위키 index.md "⚠️ 미해결 항목"이 "Aislo와 무관한 Wiza 스타일 가이드, ingest하지 않음"으로 적어 둔 것은 사실이 아니다.

• 토큰이 ui_template_theme.css와 정확히 일치한다 — --color-royal-amethyst: #3e0079(:18), --color-deep-iris / --color-mist-violet / --color-canvas / --color-paper / --color-ash 전부 존재, --text-caption: 12px(:95), 8px 간격 스케일, Britti Sans / Inter.
• wiki/concepts/design.md로 이미 ingest 되어 있다(2026-07-19). index.md의 [[design]] 항목도 등록돼 있다.
• "Wiza"는 스타일 가이드 생성 도구가 붙인 제품명일 뿐, 내용은 이 프로젝트의 실제 디자인 시스템이다.
• C02의 유토곡선 곡선 색으로 쓴 --color-royal-amethyst가 이 가이드의 토큰이다 — 실제로 참조해 작업했다.

결론: 디자인 가이드는 정상 동작 중이며, 같은 index.md 안에서 자기모순을 일으키는 낡은 경고문만 남아 있다. 정정 작업은 위키 관리자 몫으로 향후 작업 7번에 유지한다.

6. 「A그룹 보안정책 일관성 검토」 조사 결론 — 불일치 실재하지 않음

위키 wiki/pages/A09_Security/A09_frontend.md:69-73이 "약관 텍스트와 실 코드 불일치"로 적어 둔 내용을 코드로 대조한 결과, 세 곳이 이미 일치한다.

출처	값
약관A09_Security_Terms.ts:13	12시간 / 4시간 비활동
configconfig_system.py:610-611	SESSION_MAX_AGE_SECONDS=43200(12h), SESSION_IDLE_TIMEOUT_SECONDS=14400(4h)
실동작verify_session()	위 두 상수로 판정

위키가 지적한 auth_expires_at = NOW() + 3개월은 007_trusted_device_token.sql:17에서 컬럼째 DROP 됐고, 지금은 last_email_verified_at + EMAIL_REVERIFY_DAYS(90일) 파생 계산이다(B01_Dashboard_Repository.py:54).

원인은 개념 혼동이다 — 세션 만료(12h/4h)와 이메일 재인증(90일)은 별개인데 위키가 둘을 같은 것으로 보고 "불일치"로 기록했다. 2026-07-17 디바이스 토큰 도입 때 정리된 내용이 A09 페이지에 반영되지 않았다. 남은 실물은 미사용 코드 2건뿐이라 향후 작업 6번으로 흡수했고, 위키 정정은 7번에 유지한다.

7. 미결사항 3건 삭제 (사용자 판단, 취소선 아닌 완전 삭제)

삭제 항목	사유
B06 진행단계 오버레이가 차트 우측을 가림	가리기는 하나 문제없음. 필요 시 사용자가 직접 변경
docs/가 .gitignore 대상	의도된 설정. Gitea를 다른 사용자와 함께 쓰는데 이 폴더를 공유하고 싶지 않아서이며, 본인 PC 간에는 시놀로지 드라이브로 동기화 중이라 문제없다
B그룹 후반부(B08~B09) 및 견적자동화 구현	다른 담당자가 작업 중. 이 세션의 관심사가 아니다

---

---

검증 단계 정정 사항 (2026-08-02)

• [F5] config_system.py 줄 수 오기: 본문에 "604줄"로 적혀 있으나 실제 664줄이다. git show e684131:config/config_system.py | wc -l = 664, HEAD = 664, 작업본 = 664로 커밋 시점부터 664줄이었다. 기능 영향은 없으나 700줄 제한 여유가 36줄뿐이므로 다음 상수 추가 시 파일 분할을 먼저 검토해야 한다.
• 법령 역검증 통과: [임도의 설계 및 시설기준] 별표 원문에 무대운반·도쟈·스크레이퍼· 덤프트럭·토량변화율·유토곡선 어느 단어도 등장하지 않음을 확인했다. 장비 선정거리의 근거가 법령이 아니라는 본문의 단정이 옳다.
• A그룹 보안정책·design.md 조사 결론: 코드·DB 마이그레이션·파일 존재 여부로 재대조해 전부 사실로 확인했다. 상세는 검증 보고서 §2-④⑤ 참조.