v5 · 2026-06-06 · Architecture Overhaul

1472 쉬레드 → irosafe 쉬레드

신규 시스템 구축 — 통합 분석 보고서

마이그레이션 → 전면 재구축으로 큰 그림 전환. Notion SOP / 개발 요청 문서 / UI 명세 / 2026-05-27 회의 녹취 4종 통합. 계약 트랙 이원화·캘린더 RBAC·매월 25일 배치·DB 이관 정합·SOP 단일 운영.

Spring Boot 3.3 LTS Java 21 LTS wellsa-commons + irosafe-shred-commons 계약 이원화 (원콜 + 정기) RBAC (작업자 1일 / 관리자 일·주·월) QR 인프라 매월 25일 배치

인풋 자료 (4종 통합)

Notion
쉬레드 현재 업무 흐름 및 SOP 개선 방향
현장 동행 (2026-05-06 임형국 / 05-07 김태용) · 업무 흐름 15단계 · 문제점 7 · 개선 방향 6
PDF
개발 요청 문서 (3페이지)
Architecture Overhaul 선언 · 원콜/정기 트랙 · RBAC · 배치 · Excel 업로드 · QR · 수용 4기준
Excel
SOP 개발 요청 UI 명세 (6 시트)
관리자 메뉴 13 · 계약 원콜/정기 (리스트·상세) · 일정 캘린더 (필터·뷰·트리거)
회의 녹취
2026-05-27 회의 (92KB · 2,263줄)
결정 19건 · 왜·어떻게의 운영 근거 · "월 N회" 단순화 / 1년 자동 연장 / SOP 단일 운영 등

핵심 전환 — 마이그 → 신규 구축

개발 요청 문서가 명시 — "계약 및 일정 관리 구조를 전면 개편 (Re-architecture)". 데이터 마이그 범위는 계약·지점·일정 횟수로 한정. 기존 v4 plan (브랜드 이관·데드코드·OpenRewrite) 의미 폭락. 신규 작성 + 좁은 데이터 이관이 진짜 그림.

v4 (폐기)
  • • 1472 → irosafe 마이그레이션
  • • 패키지 IDE refactor (sgisframe → irosafe.shred)
  • • 데드코드 정리 / OpenRewrite plan
  • • ETL 28 모듈 (전 도메인 풀 마이그)
v5 (신규)
  • • 신규 시스템 작성 (Architecture Overhaul)
  • • 새 패키지 그대로 시작 (refactor 불필요)
  • • 기존 코드 참고용 (Crm1472 등 보존)
  • • 좁힘 ETL (계약 + 지점 + 일정 횟수만)

계약 트랙 이원화

트랙 ① 원콜 (One-Call)
단발 — 상위 계약 없음
원콜계약 → 스케쥴 및 작업
  • · 인입: 수기 · 홈페이지 문의
  • · 계약명 자동 prefix [원콜]
  • · 단일 작업일 (캘린더 피커)
  • · 향후: OBS 수준 세발 MVP
트랙 ② 정기 (Recurring)
상위 그룹 → 지점 → 스케줄
정기상위그룹 → 계약(지점) → 작업(월 N회)
  • · 인입: 수기 · 여러 지점 묶음
  • · 만료 = 1년 디폴트 + 자동 1년 연장
  • · 매월 25일 배치 → 다음 달 1달치
  • · Excel 대량 업로드 (상위그룹 + 지점)
회의 결정

데이터 모델 단계부터 완전 분리. 한 화면 짬뽕 X. 단, 워크테이블에서는 작업자 한 명이 원콜·정기 동시 처리 가능 (관리자가 "이 사람 좀 논다 싶으면").

RBAC 권한

Worker 작업자
  • · 일일(1일) 캘린더 뷰만
  • · "오늘 몇 시 어디" 가 메인 정보
  • · 담당자 변경 (땡겨오기) 가능
  • · 지점명 변경 잠금
Admin 관리자 (사무실)
  • · 일·주·월 캘린더 뷰 스위칭
  • · 종합 대시보드
  • · 일정 일괄 변경 / 일괄 수거 / 일괄 삭제
  • · 지점명 변경 전용 권한

일정 캘린더

제어 툴바
[<] [오늘] [>] · 일·주·월 스위처 · 전체/원콜/정기 필터
시각 핵심
협력사별 컬러 매핑 (기존 연두색 일색 폐기). 텍스트(화이트), 카운트(볼드).
트리거
플랫 바 클릭 → 자동 필터 리스트. 날짜 숫자 클릭 → 해당 일자 전체.
회의 결정 — 캘린더 원칙
  • · SOP 자체가 캘린더. Google·네이버 연동 X (사용성으로 외부 흡수).
  • · 반복 일정 = "월 N회" 만 등록. 매월 며칠/N번째 요일 같은 구체 패턴 X.
  • · 매월 25일 배치 → 다음 달 1달치 생성. 사람이 SOP 안에서 날짜 조정.
  • · 5주차 충돌 = 전 달 사람이 보고 조정 (자동 해소).
  • · 동선 = 외부 내비 (Google/Tmap) 활용. 자체 알고리즘 X.

2026-05-27 회의 — 결정 19건

PDF/Excel 명세의 왜·어떻게를 알려주는 운영 근거.

    Phase A~G 마일스톤 v5

      데이터 마이그 (좁힘)

      기존 ILSA 전 도메인 풀 마이그 폐기. 계약 + 지점 + 일정 횟수로 한정. ERD v0.5 설계 시 마이그 정합성 = 핵심 제약.

      계약
      기존 계약 row 단위. 자연키 (계약번호) 보존.
      지점
      계약에 엮인 지점만. 자연키 (지점코드) 보존.
      일정 횟수
      "주 몇 회" 만 정제. 세부 일정 X.

      Out of Scope (명시 제외)

      CRM-SOP 이관 프로세스
      별도 운영 유지. 자동 이관 X.
      쉬레드 ERP 연동
      외부 ERP 연동 X. 쉬레드 = SOP 단일 운영.
      정기 건 세발 등록
      홀딩 (추후 고도화). 원콜 세발만 MVP.

      기존 v4 산출물 운명

      산출물 v5 상태 비고

      결정 필요 — 마마 컨펌 대기

        즉시 개발 진입 — 10 블로커

        MVP D-24 · 6/30

        6월 말 MVP 목표 (D-24). 50+ 안건 중 이 10건만 답 주시면 즉시 코드 작성 가능. 다른 결정은 진행하면서 받음. 권장: 본 워커 default 값으로 미리 진행 → 마마는 변경 사항만 짧게 답 (5분 안에 끝).

        1차 5건 — 코드 첫 push 차단
          2차 5건 — ERD 그리기 차단
            회의 (5/27) 에서 이미 결정 — 답 X
            트랙 분리 / 1년 자동 연장 / '월 N회' 단순 / 매월 25일 배치 / SOP 자체 캘린더 / 외부 내비 / 작업자 일일 뷰 / 담당자 변경 명시 / 지점명 잠금 / SOP 단일 운영 / 정기 세발 홀딩 / 디자인 자유도

            MVP 축약 일정 — 6/30 데모 목표

            D-24
            W1 · 6/6~12
            Phase A 설계
            ERD v0.5 · 화면 명세 · 와이어프레임 · 6/12 회의로 블로커 닫음
            W2 · 6/13~19
            Phase B + C 핵심
            신규 레포 · SB3.3 · Flyway V1 · 사용자·계약·캘린더
            W3 · 6/20~26
            Phase C 나머지 + D 일부
            외주 · 콘솔+바코드 · 증명서 단순 · 매월 25일 배치
            W4 · 6/27~30
            통합 · 데모
            수용 테스트 · 데모 배포 · MVP 종료
            IN (24일 안)
            • · 계약 — 원콜 + 정기 (등록·수정·리스트)
            • · 일정 캘린더 — 관리자 일·주·월 + 작업자 일일
            • · 사용자 / RBAC 3단계
            • · 외주 협력사 (단순)
            • · 콘솔 + 바코드 매칭/생성
            • · 매월 25일 배치 (수동 트리거 OK)
            • · 담당자 변경 (땡겨오기 명시)
            OUT (MVP 후 7월~)
            • · 데이터 마이그 (Phase E)
            • · 모바일 안드로이드 (Phase F)
            • · QR 프린트 인프라 (영우님)
            • · Excel 대량 업로드
            • · 파쇄증명서 정밀 (5종 분리)
            • · 일일업무 / 코드 마스터 정밀
            • · Swagger / 커버리지 30%+

            2026-06-12 회의 안건

            D-6

            회의 통과 못 하면 Phase A 막힘. 우선순위 별로 정리. 상세: _docs/01_요구사항/20260612_회의_안건.md