디포 전체를,
브라우저 탭 하나에.

P4V 열 일, 전부 브라우저에서

카드마다 실제로 실행되는 p4 명령이 붙어 있습니다 — 앱은 얇고 정직한 래퍼라서 결과가 CLI와 정확히 일치합니다.

My Changes: 브라우저에서 편집하고 서브밋

사용자마다 서버 측 워크스페이스(p4web-<user>)가 스파스 싱크로 만들어집니다 — 파일은 작업하는 동안에만 나타납니다.

1분 안에 실행

스크립트 하나가 venv를 만들고 의존성 두 개를 설치한 뒤 서빙합니다.

$ git clone https://github.com/neoocean/p4-web.git && cd p4-web
$ ./run.sh
# 다음과 동일:
$ python3 -m venv .venv
$ .venv/bin/pip install -r requirements.txt
$ .venv/bin/uvicorn app.main:app --host 127.0.0.1 --port 8080
# 이후 http://127.0.0.1:8080 을 열고 Perforce 계정으로 로그인

필요: Python 3.10+ · PATH에 있는 p4 CLI · Perforce 서버 네트워크 접근

git이 없다면? 소스를 .zip으로 다운로드

보안은, 지루한 방식으로

코드 리뷰·보안 감사·레드팀까지 끝에서 끝까지 검토했고, 결과 문서는 저장소에 있습니다. 핵심 경계는:

• 당신의 티켓, 당신의 권한. 모든 API 호출은 세션 사용자의 티켓으로 p4를 실행합니다 — Perforce 프로텍션이 P4V에서와 똑같이 적용됩니다.
• 티켓 유출 없음. 모든 서브프로세스의 P4TICKETS는 /dev/null을 가리킵니다 — 서버를 구동하는 OS 사용자의 티켓 파일로는 절대 인증되지 않습니다.
• 비밀번호는 저장하지 않습니다. 자격 증명은 p4 login 티켓으로 교환되며, Swarm처럼 티켓 값을 직접 붙여넣을 수도 있습니다.
• 명령 허용 목록. p4 래퍼는 알려진 명령만 허용합니다; 쓰기 작업은 자신의 p4-web 체인지리스트로 한정되고 감사 기록이 남습니다.
• 강화된 엔드포인트. 스트리밍 raw 다운로드와 제한된 업로드 스풀링(100 MB 버퍼 없음), 세션별 요청 제한, Secure 쿠키, 로그인 스로틀링.

셸이 있는 곳이면 어디든 배포

세션은 SQLite(data/sessions.db)에 보존되어 재시작해도 로그아웃되지 않습니다. ssl: 서버는 P4WEB_AUTO_TRUST=1로 첫 접속 시 지문을 수락합니다.

읽을 수 있을 만큼 작게

app/
  main.py      FastAPI 라우트: 인증, 탐색, 파일, 디프, 어노테이트,
               체인지, 코멘트, 워크스페이스 쓰기 작업
  p4.py        p4 CLI 래퍼: -G 마샬 파싱, 경로 이스케이프,
               명령 허용 목록, 오류 → HTTP 매핑
  sessions.py  쿠키 sid → {user, ticket}, SQLite 저장
  index.py     사용자별 체인지리스트 검색 인덱스(프로텍션 준수)
static/
  index.html   로그인 화면 + 앱 셸
  app.js       해시 라우팅 SPA — 프레임워크 없음, 빌드 없음
  style.css    라이트 + 다크, 768px 미만 반응형
  vendor/      highlight.js, marked, DOMPurify (오프라인)

스택 전체가 파이썬 프로세스 하나와 정적 파일 디렉터리입니다. 뭔가 고장 나면, 고장 난 코드는 커피 한 잔 하는 동안 읽을 수 있을 만큼 짧습니다 — 그리고 모든 기능은 이미 알고 있는 p4 명령에 대응합니다.