액추에이터 선정 기준·문서 관리 콘솔
제품·모델 사양, 선정 규칙·기준값, 데이터시트 양식과 도면 파일을 관리자가 직접 수정하고, 기준 정보 변경 이력과 사용자 권한·감사 로그를 확인하는 관리 쪽 콘솔을 구현하는 확장 프로젝트입니다.
프로젝트 개요
제품·모델 사양, 선정 규칙·기준값, 데이터시트 양식과 도면 파일을 관리자가 직접 수정하고, 기준 정보 변경 이력과 사용자 권한·감사 로그를 확인하는 관리 쪽 콘솔을 구현하는 확장 프로젝트입니다. 개발사 호출 없이 운영할 수 있는 구조를 보여 줍니다.
작업 범위
- 관리 현황: 관리자가 제품·규칙·양식 현황과 최근 변경 요청, 확인이 필요한 규칙 충돌 건을 한 화면에서 확인합니다
- 선정 규칙 관리: 관리자가 선정 입력 항목, 선정 규칙, 기준값을 직접 추가·수정하고 변경 전에 샘플 의뢰로 결과를 시험해 봅니다. 규칙에 쓰이는 변수가 입력 항목에 없으면 누락으로 표시합니다
- 제품·양식 관리: 제품별 사양과 모델 정보를 등록·수정하고 엑셀로 일괄 등록하며, 데이터시트 양식과 외형도·회로도 파일을 올려 적용 조건을 지정합니다
- 변경 이력·권한: 규칙·제품 정보가 바뀐 시점의 기준 스냅샷과 변경 일시·담당자·사유를 조회하고 두 시점을 비교합니다. 사용자 계정과 역할을 관리하고 주요 작업의 감사 로그를 확인합니다
주요 업무
- 관리 현황 화면: 기준 정보 요약 카드와 처리 대기 목록을 역할별로 다르게 보여 주고 각 항목에서 상세 화면으로 이동합니다
- 선정 규칙 관리 화면: 규칙을 조건식 데이터로 저장하고 저장 전 시험 실행과 누락 변수 점검을 거쳐 새 기준 버전으로 반영합니다
- 제품·양식 관리 화면: 엑셀 일괄 등록은 검증 결과를 미리 보여 준 뒤 확정하고, 도면 파일은 리비전과 적용 조건을 함께 저장합니다
- 변경 이력·권한 화면: 기준 정보 변경마다 스냅샷 버전을 만들어 과거 선정 버전이 참조하도록 하고, 계정·역할 변경은 감사 로그에 남깁니다



프로젝트 핵심 과제
규칙 수정이 잦은 환경에서 변수 누락으로 선정이 빠지지 않
저장 전 점검 방식 설계 필요
기준 정보가 바뀐 뒤에도 과거 선정 근거를 재현하기 위한 스냅샷 저장 범위와 참조 구조 설계
엑셀 일괄 등록 시 모델 사양의 형식 편차를 확정 전에 걸러내는 행별 검증 규칙 설계
도면 원본이 캐드 형식일 때 PDF 변환본과 리비전을 어긋남 없이 연결하는 파일 관리 방식 확인
핵심 기능 상세
관리 현황
관리자가 제품·규칙·양식 현황과 최근 변경 요청, 확인이 필요한 규칙 충돌 건을 한 화면에서 확인합니다. 기준 정보 요약 카드와 처리 대기 목록을 역할별로 다르게 보여 주고 각 항목에서 상세 화면으로 이동합니다.
- 역할별 메뉴·카드 노출을 라우트와 API 양쪽에서 검증하는 권한 계층 적용
- 규칙·제품 변경 요청 대기 목록을 상태별로 묶는 Prisma 집계 쿼리 구성
- 검색·필터 상태를 주소 파라미터와 동기화해 목록 공유 지원
관리자 역할에 따라 보이는 메뉴와 버튼이 실제로 달라지는 권한 구조를 라우트·API·화면 3곳에서 함께 검증하도록 구현합니다.


선정 규칙 관리
관리자가 선정 입력 항목, 선정 규칙, 기준값을 직접 추가·수정하고 변경 전에 샘플 의뢰로 결과를 시험해 봅니다. 규칙에 쓰이는 변수가 입력 항목에 없으면 누락으로 표시합니다.
- 조건식 편집기에서 입력 항목과 기준값을 선택해 규칙을 구성하는 폼 설계
- 규칙이 참조하는 변수와 입력 항목 목록을 대조하는 누락 변수 점검 로직 구현
- 샘플 의뢰로 변경 전후 선정 결과를 나란히 보여 주는 시험 실행 화면 구현
규칙과 기준값을 코드가 아닌 데이터로 두어 관리자가 개발사 도움 없이 수정하고 반영 전 결과를 확인하는 구조를 구현합니다.


제품·양식 관리
제품별 사양과 모델 정보를 등록·수정하고 엑셀로 일괄 등록하며, 데이터시트 양식과 외형도·회로도 파일을 올려 적용 조건을 지정합니다.
- ExcelJS로 제품 사양 엑셀을 읽어 행별 검증 결과를 미리 보여 주는 일괄 등록 흐름 구현
- AWS S3에 양식·도면 파일을 보관하고 리비전별 메타데이터를 PostgreSQL에 연결
- 적용 조건(모델군·사양 범위)을 도면과 양식에 지정하는 조건 편집 화면 구현
일괄 등록 확정 전 행별 오류를 보여 주고 도면·양식을 리비전과 적용 조건으로 관리해 문서 생성 단계에서 바로 선택되도록 연결합니다.


변경 이력·권한
규칙·제품 정보가 바뀐 시점의 기준 스냅샷과 변경 일시·담당자·사유를 조회하고 두 시점을 비교합니다. 사용자 계정과 역할을 관리하고 주요 작업의 감사 로그를 확인합니다.
- 변경 트랜잭션 안에서 규칙·제품 정보 스냅샷을 함께 저장하는 이력 구조 설계
- 두 스냅샷의 규칙·기준값 차이를 계산해 변경 항목만 보여 주는 비교 화면 구현
- 담당자·역할·계정 변경을 추가 전용 감사 로그 테이블에 기록하는 미들웨어 적용
기준 정보가 바뀌어도 과거 버전이 변경 시점의 스냅샷을 참조하도록 하여 과거 선정 근거를 재현할 수 있는 이력 구조를 구현합니다.


프로젝트 진행 단계
기준 정보 모델링 및 이력 스키마 설계 · 2026.11
제품·규칙·기준값 테이블과 변경 시점 스냅샷 이력 구조를 Prisma 스키마로 설계
규칙 편집기 및 시험 실행 구현 · 2026.11
조건식 편집 폼, 누락 변수 점검, 샘플 의뢰 시험 실행 화면을 React로 구현
제품·양식·도면 관리 화면 개발 · 2026.11
엑셀 일괄 등록 검증, 양식·도면 파일 업로드와 리비전·적용 조건 관리 구현
권한·감사 로그 및 이력 비교 구현 · 2026.11
역할별 권한 검증과 추가 전용 감사 로그, 스냅샷 비교 화면 구현
개발 결과
기술적 주안점
- 관리자 역할에 따라 보이는 메뉴와 버튼이 실제로 달라지는 권한 구조를 라우트·API·화면 3곳에서 함께 검증하도록 구현합니다
- 규칙과 기준값을 코드가 아닌 데이터로 두어 관리자가 개발사 도움 없이 수정하고 반영 전 결과를 확인하는 구조를 구현합니다
- 일괄 등록 확정 전 행별 오류를 보여 주고 도면·양식을 리비전과 적용 조건으로 관리해 문서 생성 단계에서 바로 선택되도록 연결합니다