업무 출처·전체 조회와 메시징
상태: 회사 공통 표준 — 2026-10-11 KST(2026-10-22 KST 개정 — 사람이 남기는 글의 탭 이름은 「기록」이 아니라 「노트」)
노트·로그·메시징의 업무 연결과 직원 발송 자격을 정의합니다. 화면 패턴은
leysys-design, 제품별 원장·권한 표·적용 상태는 소유 제품, 실제 외부 발송 실행은 승인된 연동 실행 주체가 소유합니다. 이 문서의 확정은 운영 발송이나 모든 제품의 채택 완료를 뜻하지 않습니다.
업무를 연결하는 기준
업무 출처는 사람이 자유롭게 붙이고 지우는 태그가 아닙니다. 조직·현장·업무 종류·불변 고유코드를 함께 참조합니다. 이름과 관리코드는 검색·표시를 위한 정보입니다. 레코드 식별 필드의 기존 식별 체계를 사용하며 별도 코드 체계를 중복해서 만들지 않습니다.
| 정보 | 의미 |
|---|---|
업무 참조 contextRefs | 회의·청구 회차·발행 고지서·계약 등 사건과 연결된 실제 업무 |
시작점 sourceRef | 의결권자 상세·멤버 상세·서명 요청 등 사건을 시작한 대상/레코드 |
| 사건 소유 범위 | 업무 연결과 별도로 보존하는 실제 조직·현장 |
| 당시 표시 정보 | 사건 당시 업무 이름·관리코드·발송 내용 등의 불변 복사 |
업무가 원래 없는 일반 사건과 옛 자료의 출처를 모르는 미연결 사건을 구분합니다. 이름·전화번호로 옛 자료의 연결을 추측하지 않습니다. 일반·미연결 사건도 실제 사건 소유 현장으로 조회하며, 가짜 회의·고지서를 만들지 않습니다.
LeyVote는 회의 참조를 사용합니다. Leyve의 청구 회차 전체와 개별 고지서는 별도 업무이며, 발송은 당시 발행본/버전을 보존합니다. 통합 고지서가 여러 계약을 포함하면 실제 저장한 여러 연결을 사용합니다. 한 이력이 여러 조건에 맞아도 한 건으로 표시합니다. 기존 제품의 안정 ID와 버전 관계는 소유 제품이 연결합니다.
전체 페이지와 상세 범위
노트·로그·메시징 각각의 전체 페이지는 업무 이름·관리코드 검색과 현장·업무 종류·관련 업무 복수 선택을 제공합니다. 한 조건 안의 복수 값은 OR, 서로 다른 조건은 AND입니다. 제품은 일시·대상과 노트 종류, 로그 동작/주체, 메시징 채널/결과를 추가합니다. 이미 현장이 고정된 화면에는 현장 선택을 반복하지 않습니다.
상세의 본 회의 / 전체, 본 고지서 / 전체는 같은 원장의 조회 범위입니다. 업무 없이 연 멤버 상세에는 가짜 본 업무 선택을 두지 않습니다. 전체도 현재 조직과 허용된 현장·대상 안에서만 조회합니다.
- 결과·후보·건수·당시 이름과 코드·본문은 모두 같은 현재 조회 권한으로 제한합니다.
- 종료 업무도 조회 자격이 있는 경우에만 당시 정보를 표시합니다. 살아 있는 목적지가 없으면 링크를 제거합니다.
- 접근할 수 없는 업무의 보존 정보는 조회 결과에 넣지 않습니다. 일부 연결만 접근 가능한 사건에 안전한 projection 정책이 없으면 사건 전체를 제외합니다.
- 유효하지 않거나 접근할 수 없게 된 선택을 전체로 바꾸지 않습니다. 선택 재확인과 결과 없음으로 남깁니다.
- 청구 회차를 고르면 명시적으로 연결된 하위 고지서를 포함할 수 있습니다. 관련 계약 조회도 실제 고지서 관계를 사용하며 결과를 중복하지 않습니다.
조회 helper는 권한 판정기가 아닙니다. 제품은 서버 또는 승인된 prototype adapter에서 접근 가능한 projection을 만든 뒤 공통 화면에 전달합니다.
노트·메시징·로그의 차이
노트는 사람이 남기는 글(연락한 내용 등)이고, 메시징은 발송 요청·수신자별 시도·결과이며, 로그는 감사 사건입니다. 문자나 이메일을 보냈다고 적은 노트를 실제 전송 결과로 간주하지 않습니다. 동일 사건을 서로 다른 원장에 중복 복제하지 않습니다.
실제 메시징 기능이 있는 상세의 마지막 탭은 노트 · 메시징 · 로그 순서입니다. 없는 기능의 빈 탭은 만들지 않습니다. 조회 범위와 업무 필터의 기준은 공유하며 각 원장의 권한·상세 동작은 유지합니다.
사람이 남기는 글의 탭과 카드 이름은 바로 옆 「로그」와 헷갈리지 않게 「노트」입니다(2026-10-22 KST 오너 결정, 그전 이름 「기록」). 노트는 제목이나 긴 본문이 있고 댓글을 다는 글이고, 메모는 댓글 없이 한 줄로 적는 짧은 글(예: 비고 칸)입니다. 노트 안의 종류(노트 · 전화 기록 · 문자 기록 · 이메일 기록 · 방문 기록 · 할 일)는 그대로 둡니다. 화면 정본은 leysys-design 결정 기록 RECORD-STREAM-ONE-LIST-2026-10-05의 2026-10-22 KST 개정입니다.
발신수단과 직원 권한
문자는 조직이 등록·인증한 번호 + 발송 권한이 있는 직원이 사용합니다. 번호를 등록한 직원 한 명에게 묶지 않습니다. 알림톡은 조직의 사용 가능한 발신 프로필과 승인 템플릿을 별도로 요구합니다. 문자 번호 인증이 카카오와 이메일 자격을 대신하지 않습니다.
| 권한 키 | 기준 |
|---|---|
messaging.delivery.read | 허용된 대상·업무의 발송 이력 조회 |
messaging.delivery.send | 허용된 대상·업무에서 조직 발신수단으로 요청 |
messaging.sender.read | 조직 범위에서 발신수단 설정 조회·마스킹 |
messaging.sender.update | 조직 관리자의 발신수단 설정 변경 |
발송은 일반 편집 권한에서 추론하지 않고 제품의 정적 권한 표에 명시합니다. 초기 프로토타입 표는 관리자·편집자에게 허용 업무의 조회/발송, 조회자에게 조회만 부여합니다. 발신수단 변경은 조직 관리자에게만 둡니다. 직원 기능 권한, 현재 조직·현장·업무 접근, 채널별 발신 자격을 발송 명령 경계에서 다시 확인합니다. 접근 역할 체계를 함께 따릅니다.
받는 사람은 기존의 허용된 당사자·멤버·연락처를 참조합니다. 직원 로그인 번호나 증빙 담당자의 번호를 일반 메시지 수신번호로 추정하지 않습니다. 같은 번호를 쓴다는 이유로 다른 사람의 이력을 합치지 않습니다. CRM 구독 자체를 공통 메시징의 사용 조건으로 삼지 않습니다.
작성·확인·접수
최종 확인에는 받는 사람이 실제로 볼 개인별 본문, 수신 주소, 발신수단/템플릿 버전, 업무 출처와 요청 견적을 독립 복사해 표시합니다. 필요한 현장코드·포털 링크도 실제 본문에 포함합니다. 권한·수신 연락처·발신수단·템플릿·업무·견적이 바뀌면 이전 확인을 무효화하고 다시 확인합니다. 바뀌었다가 원래 값으로 돌아와도 확인을 자동 복원하지 않습니다.
채널 단가·문자 길이/분할·대체 발송의 최대 비용·크레딧 처리는 Pricebook과 소유 제품의 견적 계약을 따릅니다. 공통 화면에 단가를 복제하지 않습니다. 요청 견적을 확인할 권한과 조직 전체 잔액을 조회할 청구 권한은 별도로 판정합니다.
제품/서버는 요청의 고유코드와 멱등 키를 만들고 네트워크 재요청에 같은 키를 사용합니다. 사용자 다시 보내기는 새 요청이며, 자동 재시도·대체 발송은 같은 요청의 새 시도로 연결합니다. 당시 본문·주소·발신수단·업무·가격 버전을 보존하고 발송 뒤 읽기 전용으로 조회합니다.
| 상태 | 뜻 |
|---|---|
| 접수 / 대기 | 요청을 보존했거나 처리 순서를 기다림 |
| 처리 중 | 공급자 접수 여부·결과를 확인 중 |
| 전달 완료 | 해당 수신자의 공급자 전달 증거를 확인함 |
| 실패 | 확정된 거절·전송 실패와 사유가 있음 |
| 결과 확인 중 | 응답 유실 등으로 결과가 미확정 |
접수는 전달 완료나 읽음을 뜻하지 않습니다. 읽음은 채널이 지원하고 증거가 있는 경우에만 표시합니다. 결과가 불명하면 원래 요청 결과부터 확인하고 다른 공급자로 임의 재시도하지 않습니다. 실제 발송 없는 프로토타입은 데모 요청/모의 상태를 표시하며 실제 비용 차감을 주장하지 않습니다.
후속 결정과 구현 경계
본사 공용 번호·이메일 제공, 고객별 위임/회신 경로, 이메일·광고 발송은 별도 결정 사항입니다. 미설정 고객에게 본사 번호나 주소를 기본 사용하도록 활성화하지 않습니다.
leysys-design은 e-business-context-query, e-messaging의 canonical registry item을 제공합니다. 제품은 병합 SHA와 dependency closure를 기록하고 별도 검증·배포합니다. 이 공통 계약은 운영 DB 테이블 신설이나 미게시 SDK 사용 지시가 아닙니다. 실제 발송 실행은 아키텍처 경계와 소유 제품의 채택 계약을 따릅니다.