공통 규칙

세 제품이 같이 지키는 로그인 흐름, 언어, 관리 영역, 같은 이름의 환경 변수예요.

로그인

회사 SSO(OIDC)가 있으면 그것, 없으면 이메일로 받는 6자리 코드예요. 사람에게 비밀번호가 없어요. 화면은 세 제품 모두 같은 두 단계예요.

  1. 로그인 — 이메일을 넣고 코드 받기. 안내 한 줄만 제품마다 달라요(갈피는 처음이면 계정이 만들어지고, Mothership은 초대받은 주소, 나루는 등록된 주소).
  2. 코드를 넣어 주세요 — 여섯 번째 숫자에서 바로 로그인돼요. 아래에 코드 다시 보내기와 다른 이메일로.
갈피의 로그인갈피의 로그인
갈피의 로그인
Mothership의 로그인Mothership의 로그인
Mothership의 로그인
나루의 로그인나루의 로그인
나루의 로그인
  • 메일의 링크: 코드와 같은 메일에 링크(/auth/verify)가 있어요. 여는 것만으로는 아무도 로그인시키지 않고, 누가 요청했는지(브라우저, 운영체제, IP, 시각)를 보여 준 뒤 "예, 로그인할게요"를 물어요. 예를 누르면 코드를 기다리던 창이 로그인돼요.
  • 사내 계정: 버튼은 셋 다 "사내 계정으로 로그인"이에요(이름을 정하면 "<이름>(으)로 로그인"). 계정은 제품마다 따로 있고, 같은 회사 IdP를 세 곳에 각각 등록하면 한 번 로그인으로 이어져요. 갈피와 나루는 같은 OIDC_* 환경 변수를 받고, Mothership은 회사마다 화면에서 등록해요.

언어

한국어(기본)와 영어. 각 화면의 English / 한국어로 바꾸고, 기본은 APP_LANG이에요. 한국어는 "해요"체로 써요. 로고 옆과 홀로 쓰이는 이름은 두 언어 모두 Galpi · Mothership · Naru로 쓰고, 한국어 문장 안에서는 갈피 · 나루로 써요.

화면

  • 기준은 갈피예요: Catalyst의 zinc 색, Pretendard, 흑백 기본 버튼, 조금의 주황색. 주황은 네 제품이 같은 값이에요(밝은 화면 #d04a02, 어두운 화면과 아이콘 #fd5108). 다른 둘은 갈피의 값을 복사해 쓰고 갈피에 런타임으로 기대지 않아요. 이 문서 사이트도 같은 값으로 그렸어요.
  • 관리 영역은 따로 여는 영역이에요("Galpi / 시스템 관리", "Mothership / 회사 관리", "Naru / 관리"). 머리에 제품과 영역 이름, 무리로 나눈 목록, 바닥에 돌아가기 하나.
  • 저장: 설정 화면은 저장 바, 목록의 스위치는 바로 저장하고 알려요. 범위를 넓히는 일은 먼저 물어요.
  • 확인 창: 제목은 대상을 넣은 질문, 그 아래 일어나는 일을 짧은 목록으로, 되돌릴 수 없으면 맨 끝에 적어요. 안전한 버튼이 먼저예요.
  • 테마: 밝게 → 어둡게 → 시스템 설정대로.

오류

API 오류에는 언어와 상관없는 code가 있어요. 화면은 code로 판단하고 메시지는 보여 주기만 해요. 스크립트도 메시지 대신 code를 봐요.

환경 변수 이름

같은 설정은 세 제품에서 같은 이름이에요. 기준은 갈피의 이름이고, 한 제품에만 있는 설정은 그 제품 이름으로 시작해요(MOTHERSHIP_…, NARU_…). 예전 이름도 계속 받고, 둘 다 있으면 예전(제품 전용) 이름이 이겨요.

제품군 이름 뜻 갈피 Mothership 나루
PUBLIC_URL 사람들이 여는 주소 그대로 예전 MOTHERSHIP_PUBLIC_URL 그대로
PORT 듣는 포트 그대로 그대로 그대로
DATA_DIR 데이터 폴더 그대로 해당 없음(DATABASE_URL) 그대로
SECRETS_KEY 저장하는 비밀값을 봉인하는 키 그대로 예전 MOTHERSHIP_SECRET_ENCRYPTION_KEYS 예전 NARU_SECRETS_KEYS
ADMIN_EMAILS 시작할 때 관리자가 되는 사람 그대로 운영자 그대로
SMTP_URL, MAIL_FROM 메일 서버와 보내는 사람 그대로 예전 MOTHERSHIP_EMAIL_* 그대로
APP_LANG 기본 언어 예전 GALPI_LANG 새로 받음 예전 NARU_LANG
LOGIN_METHODS email, oidc, email,oidc 그대로 해당 없음(회사마다 화면에서) 새로 받음
OIDC_* 사내 계정(SSO) 그대로 해당 없음 예전 NARU_OIDC_*
S3_* 파일 보관소 그대로 예전 MOTHERSHIP_S3_* 해당 없음
LLM_BASE_URL, LLM_API_KEY, LLM_MODEL 모델 서버 그대로 LLM_API_FORMAT=openai일 때만 해당 없음
MODE_FAST_MODEL, MODE_SMART_MODEL, MODE_DEEP_MODEL 등급마다의 모델 그 모드를 만들어요 같은 이름의 등급(openai 형식일 때) 해당 없음

AI 등급 이름은 세 곳 모두 fast · smart · deep이에요.

Esc