Skip to content

v0.243.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 10 Sep 20:41
· 1 commit to main since this release
v0.243.0
f546d6a

kanpic v0.243.0

v0.243.0

가이드에 실린 화면이 실제로 띄워 찍은 화면입니다

사용자 가이드와 관리자 가이드에는 화면 캡처가 한 장도 없었습니다. 그 자리를
사람이 손으로 그린 표가 대신하고 있었습니다.

┌─────────────────────────────────────────┐
│  [로고]  홈   워크북   공유됨      [프로필] │
├─────────────────────────────────────────┤
│  + 새 워크북                             │
└─────────────────────────────────────────┘

이런 그림은 처음 그릴 때부터 실물과 조금씩 다르고, 화면이 바뀌어도 아무도
고치지 않습니다. 단추가 어디 있는지 찾으려고 가이드를 편 사람은 없는 화면
을 보게 됩니다. 두 가이드가 마지막으로 손질된 것은 v0.18.0(2026-08-02)이었고,
그 사이에 홈 화면도 편집기도 관리자 콘솔도 여러 번 바뀌었습니다.

이번 릴리즈의 두 가이드에는 v0.242.0 을 실제로 띄워 1440×900 에서 찍은 19장
이 들어갑니다. 로그인, 홈, 가져오기, 편집기, 차트, 버전 이력, 공유, AI, 개인
설정, 관리자 콘솔의 개요·사용자·명단 올리기·워크북·부서·API 키·로그·설정·시스템
화면입니다.

찍는 일을 저장소가 합니다

캡처를 다시 찍는 도구를 저장소에 두었습니다(web/e2e/guide-screenshots.mjs).
로컬에 띄운 서버에 가짜 명단·워크북·부서·API 키를 채워 넣고 차례로 찍습니다.
다음에 화면이 바뀌면 다시 돌리면 됩니다 — 손으로 그린 그림에는 그런 길이
없었습니다.

찍을 대상과 로그인 정보는 캡처 전용 환경 변수로만 받습니다. 스크립트에는
주소도 아이디도 비밀번호도 적히지 않고, 값이 없으면 그 자리에서 멈춥니다.
버려도 되는 환경임을 사람이 매번 밝혀야 하며, 전역 설정은 읽기만 합니다.

사용자 가이드: 처음 5분과 막혔을 때

가이드를 처음 펴는 사람은 대개 지금 당장 워크북 하나를 만들어 봐야 하는
사람 입니다. 그런데 문서는 시스템 소개부터 시작했습니다.

  • 처음 5분 — 로그인부터 워크북 만들기·수식·차트·공유까지 한 번에 지나가는
    길을 맨 앞에 두었습니다.
  • 막혔을 때 — 화면에 실제로 나오는 오류 문구를 그대로 싣고, 그 문구가
    나왔을 때 무엇을 하면 되는지 적었습니다. 문구를 그대로 실어야 사람이 화면과
    문서를 눈으로 맞춰 볼 수 있습니다.
  • 용어 — 워크북·시트·범위·필터 뷰처럼 문서가 계속 쓰는 말을 한자리에
    모았습니다.

관리자 가이드: 받은 파일에서 첫 로그인까지

관리자 가이드에는 정작 릴리즈 자산을 받아 처음부터 끝까지 설치하는 절차 가
없었습니다. 폐쇄망에 kanpic 을 올리는 사람이 가장 먼저 필요한 것이 그것입니다.

  • 구성 요소·포트·볼륨 표
  • sha256sum -c 로 받은 파일을 확인하고 docker load 부터 최초 관리자 로그인
    까지 이어지는 설치 절차
  • 코드에서 읽어 적은 환경 변수 4개(POSTGRES_DSN·BOOTSTRAP_ADMIN_ID·
    BOOTSTRAP_ADMIN_PASSWORD·PORT)와 관리자 콘솔 설정 키 전수 표
  • 상태 점검(GET /healthz·GET /api/v1/version)과 업그레이드·되돌리기
  • 증상 → 확인할 곳 → 로그 문구 → 조치 로 적은 장애 대응. 장애가 났을 때
    사람이 손에 쥔 것은 증상뿐이므로 거기서 시작하도록 두었습니다.
  • 기본값 중 반드시 바꿔야 하는 것과 밖으로 열면 안 되는 포트

정본을 하나로 두었습니다

같은 가이드가 .md·.pdf·.html 세 벌로 있었고, 그중 HTML 사본은 이미지를
싣지 않는 방식으로 만들어져 캡처가 통째로 빠진 가이드 가 되었습니다. 어느
것이 정본인지 알 수 없는 상태로 세 벌을 두는 대신, HTML 사본을 지우고 문서
사이트의 링크를 PDF 로 옮겼습니다. PDF 는 공용 md2pdf 로 다시 만들었습니다
(사용자 가이드 85쪽).

확인

  • 캡처 19장을 한 장씩 눈으로 확인했습니다 — 빈 목록이나 아직 도는 스피너를
    찍은 것이 없는지, 실명이나 비밀값이 찍히지 않았는지 봤습니다.
  • 두 문서의 이미지 참조 22곳이 모두 실제 파일을 가리키는지 확인했습니다.
  • npm run lint, go build ./..., scripts/check-release-docs.sh,
    scripts/check-commit-identities.sh

올리실 때

문서만 바뀌었습니다. 서버와 웹 코드는 한 줄도 손대지 않았고 마이그레이션도
없습니다. 필수 런타임 환경 변수는 계속 POSTGRES_DSN 하나입니다. v0.242.0 에서
올라오시는 분은 이미지만 바꿔 다시 띄우시면 됩니다.

오프라인 설치

이 릴리즈는 웹 자산과 서버 바이너리를 포함한 Docker 이미지 아카이브로 제공됩니다.

sha256sum -c kanpic-v0.243.0.tar.gz.sha256
gzip -dc kanpic-v0.243.0.tar.gz | docker load
docker run --rm -p 8080:8080 \
  -e POSTGRES_DSN='postgres://kanpic:password@postgres.internal:5432/kanpic?sslmode=require' \
  kanpic:v0.243.0
  • 필수 런타임 환경 변수: POSTGRES_DSN
  • Redis 및 외부 인터넷 연결: 불필요
  • 관리자 초기 로그인을 보호하려면 BOOTSTRAP_ADMIN_ID와 BOOTSTRAP_ADMIN_PASSWORD를 함께 지정합니다.
  • 무결성 검증 파일: kanpic-v0.243.0.tar.gz.sha256
Assets 4
Loading