ProcessCenter 시스템 아키텍처 발표 구성안
권장 분량: 11장, 12~15분
대상: 경영진·프로세스 오너·IT 운영·개발 팀
핵심 메시지: ProcessCenter는 프로세스 체계와 L5 실행 흐름을 하나의 기준 데이터로 관리하며, PortalConsole·PostgreSQL·컨테이너 배포를 기반으로 안전하고 운영 가능한 포털을 제공한다.
발표 흐름 요약
| 구간 | 슬라이드 | 청중이 이해해야 할 내용 |
|---|---|---|
| 문제와 목표 | 1~3 | 왜 ProcessCenter가 필요하며 무엇을 통합하는가 |
| 시스템 구조 | 4~7 | 어떤 계층·데이터·인증 구조로 동작하는가 |
| 업무 가치 | 8 | L4 통합 맵이 L5 실제 흐름을 어떻게 연결하는가 |
| 안정성·운영 | 9~10 | 어떻게 배포·보안·예외 처리를 관리하는가 |
| 결론 | 11 | 현재 성과와 다음 우선순위 |
슬라이드 1. 표지 — ProcessCenter 시스템 아키텍처
제목: ProcessCenter 시스템 아키텍처
부제: 프로세스 계층, L5 실행 흐름, 중앙 인증을 연결하는 운영 포털
핵심 메시지: 프로세스 모델과 실제 실행 흐름을 분리하지 않고, 하나의 포털에서 관리한다.
권장 시각 구성: 네이비 배경 위에 L1 → L4 → L5 → L6의 계층선과 워크플로우 화살표를 얇은 라인으로 배치한다. 우측 하단에는 Process Center 브랜드명을 표기한다.
발표자 노트: “오늘은 ProcessCenter가 프로세스 체계와 L5 실행 흐름을 어떤 구조로 관리하고, 중앙 인증·데이터베이스·배포 환경과 어떻게 연결되는지 설명드리겠습니다.”
슬라이드 2. 해결하려는 문제
제목: 프로세스 문서화와 실행 흐름의 단절을 해소합니다
| 기존 문제 | ProcessCenter의 해결 방식 |
|---|---|
| 프로세스 계층이 문서·스프레드시트·개별 시스템에 분산 | L1~L5 계층과 책임자·RACI를 단일 기준 데이터로 관리 |
| L5별 업무 흐름이 서로 연결되지 않아 end-to-end 파악이 어려움 | L5 Workflow와 L4 통합 맵으로 흐름·handoff를 시각화 |
| 사용자·권한이 서비스마다 중복 관리됨 | PortalConsole 기반 중앙 인증과 포털별 권한 적용 |
| 배포·DB 전환·운영 장애 대응이 개별 작업에 의존 | PostgreSQL·Docker 기반 표준화된 실행 경로 |
핵심 메시지: ProcessCenter는 “프로세스 목록”이 아니라 프로세스의 책임·흐름·연결·운영을 함께 관리하는 시스템이다.
권장 시각 구성: 좌측에는 흩어진 문서·화살표·사람 아이콘, 우측에는 통합 포털 화면과 하나의 데이터 허브를 대조한다.
슬라이드 3. 업무 범위와 프로세스 계층
제목: 프로세스 구조부터 실행 단위까지 일관되게 관리합니다
| 관리 범위 | 주요 정보 |
|---|---|
| L1~L4 | 프로세스 계층, 설명, 코드, 담당 조직, RACI |
| L5 | Workflow, 외부유입·외부전달, 조건분기, 종료 규칙 |
| L6 | 실행 Task, 책임자, 역할, 상세 업무 단위 |
| 공통 | 사용자·권한, 승인 정책, 공지, 첨부·미디어, 용어 |
핵심 메시지: L4는 업무 영역의 컨테이너이고, L5와 L6가 실제 실행 흐름을 형성한다.
슬라이드 4. 전체 시스템 아키텍처
제목: 프론트엔드·API·DB·외부 서비스가 명확히 분리된 구조입니다
| 계층 | 기술·역할 |
|---|---|
| 사용자 인터페이스 | React, Vite, Tailwind, portal-foundation, L5/L4 Workflow 캔버스 |
| 애플리케이션 API | Express, tRPC, Zod, 도메인 서비스, Repository |
| 데이터 계층 | Drizzle ORM, PostgreSQL, migration, transaction·advisory lock |
| 외부 연동 | PortalConsole, Object Storage, 선택적 Private AI/RAG |
핵심 메시지: UI·업무 규칙·데이터 접근·외부 인증의 책임을 분리하여 변경과 운영을 안전하게 한다.
슬라이드 5. 애플리케이션 구성과 API 책임 분리
제목: tRPC 라우터와 서비스 계층이 업무 규칙을 통제합니다
| 영역 | 주요 책임 | 대표 처리 |
|---|---|---|
processes | 프로세스 트리와 책임자 | 계층 생성·수정, 코드 검증, RACI·책임자 관리 |
flow | L5/L4 Workflow | 단계·전환·조건분기·외부 L5 handoff·L4 통합 맵 |
approvals | 승인 체계 | 승인 정책, 단계, 대상 관리 |
admin | 관리 기능 | 사용자·역할·운영 관리 |
runtimeSettings | 런타임 연동 | PortalConsole, 배포 프로필, 포털 설정 |
notices, rag | 정보 제공·검색 | 공지, 지식 검색과 보조 기능 |
핵심 메시지: 화면이 DB를 직접 변경하지 않는다. 모든 mutation은 입력 검증 → 권한 검증 → 도메인 규칙 → 트랜잭션 → Repository 순서로 처리한다.
권장 시각 구성: UI → tRPC Router → Service → Repository → PostgreSQL의 5단 레이어 다이어그램.
슬라이드 6. PostgreSQL 중심 데이터 아키텍처
제목: 프로세스·워크플로우·권한을 관계형 모델로 일관되게 관리합니다
| 핵심 엔티티 | 의미 |
|---|---|
processNodes | L1~L6 계층과 코드·명칭·조직 정보 |
workflowSteps | L5 내부의 L6·START·END·의사결정·조건 단계 |
workflowTransitions | 단계 간 관계, outcome, label, 조건식 |
users, 역할 할당 | 사용자·관리자·프로세스 책임 범위 |
portalRuntimeSettings | PortalConsole·배포 프로필·포털 연동 설정 |
핵심 메시지: PostgreSQL로 전환한 뒤 SQL 방언·타입·advisory lock·migration을 운영 기준으로 표준화했다.
슬라이드 7. PortalConsole 중앙 인증과 권한 흐름
제목: PKCE 기반 중앙 로그인과 포털 권한 검증을 적용합니다
핵심 메시지: PortalConsole는 신원의 기준 시스템이고, ProcessCenter는 state·PKCE·portal ID·세션·애플리케이션 권한을 단계적으로 검증한다.
강조 문구: “저장된 포털 설정을 OAuth 흐름에 사용하고, callback URL 차이도 함께 처리한다.”
슬라이드 8. L5 Workflow에서 L4 통합 맵까지
제목: L4 맵은 하위 L5의 실제 워크플로우를 연결한 end-to-end 뷰입니다
| 구분 | L5 Workflow | L4 통합 Workflow Map |
|---|---|---|
| 목적 | 개별 Sub Process의 실행 흐름 편집 | L4 하위 L5 전체의 end-to-end 흐름 이해 |
| 노드 | L6·START·END·의사결정·조건분기 | 각 L5의 실제 노드와 내부 흐름을 lane으로 표시 |
| 연결 | 내부 전환과 외부유입·외부전달 설정 | 실제 등록된 L5 간 handoff를 자동 집계 |
| 수정 권한 | L5 상세 화면에서 관리 | 읽기 전용 통합 가시화 |
핵심 메시지: L4 화면에서 별도 선을 수동으로 그리는 것이 아니라, L5에서 관리한 실제 연결이 자동으로 상위 맵에 반영된다.
슬라이드 9. 배포와 운영 구조
제목: 빌드·런타임·DB를 분리해 배포 안정성을 확보합니다
| 운영 요소 | 원칙 |
|---|---|
| 컨테이너 | Node 22 Alpine, multi-stage build, non-root 실행 |
| 실행 명령 | node dist/index.js로 런타임 pnpm 의존 제거 |
| DB | DATABASE_URL, DATABASE_DIALECT=postgresql을 secret으로 관리 |
| 배포 관찰 | build log와 runtime log를 분리해 확인 |
| 실패 복구 | 재시작 정책과 제한적 transaction retry |
핵심 메시지: “빌드는 성공했지만 기동이 실패하는 문제”를 runtime log와 실행 명령 분리로 진단·해결할 수 있다.
슬라이드 10. 보안 및 예외 처리 구조
제목: 안전한 실패와 운영 가능한 예외 처리를 설계합니다
| 계층 | 보안 통제 | 예외 처리 |
|---|---|---|
| 브라우저·Express | CORS allowlist, body size limit, Secure·HttpOnly cookie | 안전한 4xx·5xx 응답, 민감 정보 비노출 |
| 인증 | OAuth state, PKCE, portal mismatch 검증 | 만료·교환 실패를 로그인 재시도 메시지로 변환 |
| tRPC·도메인 | protectedProcedure, adminProcedure, Zod | UNAUTHORIZED, FORBIDDEN, BAD_REQUEST, CONFLICT |
| DB·외부 연동 | transaction, advisory lock, secret 관리 | rollback, retry 대상 제한, 연동 오류 정규화 |
| 운영 | 런타임 로그, 감사·이력 | correlation ID·구조화 로그·알림 도입 확대 |
핵심 메시지: 사용자는 수정 가능한 오류를 받고, 운영자는 원인을 추적할 수 있어야 한다.
보완 과제: 전역 오류 envelope, 구조화 JSON log, rate limit, 보안 헤더, 외부 연동 timeout·circuit breaker.
슬라이드 11. 결론과 다음 단계
제목: 프로세스 기준 데이터에서 end-to-end 운영 플랫폼으로 확장합니다
| 현재 확보한 기반 | 다음 우선순위 |
|---|---|
| PostgreSQL 호환성과 실행 안정화 | DB 제약조건과 workflow 순환 참조 방어 강화 |
| PortalConsole 중앙 인증과 포털 설정 연동 | 포털별 관리자 권한의 조회·감사 가시화 강화 |
| L5 외부연결과 L4 통합 맵 | L4 통합 맵의 클릭 드릴다운·시각 회귀 테스트 |
| 다크·라이트 모드와 공통 포털 UI 정비 | 구조화 로그·모니터링·알림 체계 확장 |
마무리 메시지:
ProcessCenter는 프로세스 계층을 정리하는 도구를 넘어, L5 실행 흐름과 부서·업무 간 handoff를 하나의 운영 모델로 연결하는 기반 시스템입니다.
발표자 노트: “다음 단계에서는 통합 맵의 탐색성, 권한 가시성, 운영 관측성을 강화하여 실제 업무 운영의 통제력까지 높이겠습니다.”
발표 제작 가이드
발표 자료는 Process Center의 네이비·오프화이트 브랜드를 유지한다. 제목은 네이비, 흐름 화살표는 보라색 또는 딥블루, 외부 L5 handoff는 파란 점선으로 구분한다. 한 슬라이드에는 하나의 결론만 배치하고, 표는 최대 5행 내외로 제한한다. 아키텍처·인증·L4 통합 맵 슬라이드에는 위 Mermaid 도식을 기준으로 재작성한 벡터 다이어그램을 사용한다.
발표 목적이 경영진 중심일 때는 슬라이드 5의 라우터 표를 축약하고 슬라이드 8과 10의 업무 가치·리스크 통제 메시지를 강조한다. 개발·운영 팀 중심일 때는 슬라이드 5~7과 9~10의 API·DB·인증·배포 세부 설명을 확대한다.