회사별 주문을 한곳에서 조회하고, 역할 권한에 따라 상태를 변경하며, 모든 변경 과정을 감사 이력으로 남기는 멀티테넌트 주문 운영 시스템입니다.
앱을 실행한 뒤 개인 개발자 포트폴리오에서 구현 가능한 범위와 기술 역량을 먼저 확인하고, OrderOps 프로젝트 상세에서 제품 화면과 시스템 설계를 이어서 볼 수 있습니다.
- 서울프레시 물류 또는 부산크래프트 상점의 역할별 계정으로 로그인합니다.
- PostgreSQL에서 집계한 주문 지표와 현재 회사의 주문만 조회합니다.
- 검색, 상태, 예외 필터로 주문을 좁히고 우측 인스펙터에서 정규화 근거를 확인합니다.
- 서버가 현재 역할과 상태에 허용한 다음 단계만 선택해 주문을 변경합니다.
- 같은 트랜잭션에서 저장된 담당자, 이전·다음 상태, 변경 사유를 감사 로그에서 확인합니다.
- 열람 전용 계정으로 로그인하면 화면과 API 양쪽에서 변경이 차단됩니다.
| 역할별 로그인 | 상태 변경 후 감사 이력 |
|---|---|
 |
 |
모바일 화면도 같은 API와 권한 규칙을 사용합니다.
프로젝트 상세에서는 로그인부터 예외 검토, 상태 변경, 감사 이력, 역할 권한, 회사별 데이터 분리까지 이어지는 제품 화면을 확인할 수 있습니다.
- React + TypeScript 기반 로그인, 주문 테이블, 필터, 상태 변경, 감사 타임라인
- Node.js 24 + Express 5 API와 PostgreSQL 16 영속화
tenant_id를 모든 업무 쿼리에 적용한 회사별 데이터 격리admin,operator,viewer역할과 서버 권한 검증received → normalized → ready → shipped및 예외 처리 상태 전이- 행 잠금과
expectedVersion을 함께 사용한 동시 수정 충돌 처리 - 주문 변경과 감사 이벤트를 한 PostgreSQL 트랜잭션으로 기록
- 일반 수정·삭제를 거부하는 감사 이벤트 DB 트리거
scrypt비밀번호 검증, 해시만 저장하는 불투명 세션,HttpOnly쿠키- 같은 출처 변경 표식, Fetch Metadata 확인, 보안 응답 헤더
- liveness/readiness 분리, 입력 검증, 안정적인 API 오류 코드
- 단위·PostgreSQL 통합·Playwright 사용자 흐름 테스트와 CI
- Docker Compose 로컬 실행, OpenAPI 명세, Vercel 배포 어댑터
flowchart LR
Browser["React + Vite\n주문 워크스페이스"]
API["Express API\n인증·권한·워크플로"]
DB["PostgreSQL 16\n회사·주문·세션·감사 이력"]
Browser -->|"same-origin /api\nHttpOnly cookie"| API
API -->|"tenant-scoped SQL\ntransaction"| DB
브라우저가 보내는 회사 ID나 역할은 신뢰하지 않습니다. 보호된 API는 세션에서 사용자와 회사를 복원하고, 서버가 상태 전이를 다시 검사합니다. 자세한 결정과 신뢰 경계는 아키텍처 문서에 정리했습니다.
Docker Desktop 또는 Docker Engine과 Docker Compose v2가 있다면 다음 한 줄로 앱과 PostgreSQL을 함께 시작할 수 있습니다.
docker compose up --build- 앱:
http://localhost:8787 - liveness:
http://localhost:8787/api/health/live - PostgreSQL readiness:
http://localhost:8787/api/health/ready
데이터 볼륨까지 삭제하고 종료하려면 docker compose down --volumes를 사용합니다.
Node.js 24와 PostgreSQL 16이 필요합니다.
npm ci
cp .env.example .env
npm run db:setup
npm run dev- React 개발 서버:
http://127.0.0.1:5182 - Express API:
http://127.0.0.1:8787
공통 접근 비밀번호는 .env.example의 ACCESS_ACCOUNT_PASSWORD=orderops-access-2026입니다.
| 회사 | 관리자 | 운영 담당자 | 열람 전용 |
|---|---|---|---|
| 서울프레시 물류 | admin@seoulfresh.example |
operator@seoulfresh.example |
viewer@seoulfresh.example |
| 부산크래프트 상점 | admin@busancraft.example |
operator@busancraft.example |
viewer@busancraft.example |
로그인 화면에서 회사와 역할을 고르면 계정 정보가 준비됩니다. 주문 워크스페이스 열기를 눌러 시작합니다.
PostgreSQL이 준비된 환경에서 전체 검증을 실행합니다.
npm run verify개별 검사는 다음과 같습니다.
npm test
npm run test:integration
npm run typecheck
npm run build
npm run test:e2e
npm audit --omit=dev검증 범위에는 정상 상태 변경과 감사 기록, 열람 전용 거부, 다른 회사 주문 은닉, 오래된 버전 충돌, 감사 이벤트 수정·삭제 차단, 브라우저 로그인·변경·감사·모바일 흐름이 포함됩니다.
SHARED_ACCESS_MODE=true는 여러 사용자가 하나의 공개 DB에 접근할 때 서버 측 보호 기능을 활성화합니다.
- 로그인 성공 시 해당 회사의 주문과 감사 이력을 기준 상태로 초기화합니다.
- 사용자와 기존 세션은 유지합니다.
- 자유 입력 변경 사유 대신
공개 환경에서 수행한 상태 변경을 저장합니다. - 로그인과 상태 변경 요청에 인스턴스 단위 제한을 적용합니다.
- 로그인·세션 응답의
user.sharedAccessMode로 화면의 입력 방식을 조정합니다.
공유 상태는 회사 단위이므로 동시에 같은 회사에 접근하면 초기화 또는 409 VERSION_CONFLICT가 발생할 수 있습니다. 로컬 기본 모드에서는 자동 초기화와 공유 환경용 변경 제한 없이 전체 변경 흐름을 확인할 수 있습니다.
비밀번호 재설정, MFA, 분산 요청 제한, PostgreSQL RLS, 버전형 마이그레이션, 택배사·웹훅 연동, 구조화 로그·APM, 백업 복구 훈련, 부하 테스트는 아직 포함하지 않았습니다. Docker Compose는 로컬 실행을, Vercel 어댑터는 서버리스 배포 경로를 담당합니다.