Refine onboarding state and nickname checks

This commit is contained in:
dahyeon committed 2026-04-21 12:42:24 -07:00
1 parent 5579db54da
commit 9c013f7d4f
33 files changed
+1523 -119

No files matched your search

+1 -1
View File
@@ -31,7 +31,7 @@ export const HEART_LOCATION_TEXT =
'채팅방 오른쪽 상단 메뉴 버튼을 누르면 "커버 보기"가 보여요. 거기서 프로필과 하트를 확인하실 수 있어요.';
export const DISCORD_GUIDE_TEXT =
"닉네임 변경과 하트 인증을 모두 완료하신 뒤에 디스코드 서버에서 프로필을 설정하시면 권한이 자동으로 부여돼요.";
"카카오톡 닉네임 변경과 방 하트 인증을 마치신 뒤, 디스코드 본인인증방과 구인방에 입장하고 서버 프로필 닉네임과 프로필 메시지를 설정하시면 권한이 자동으로 부여돼요.";
export const DISCORD_INVITE_URL =
process.env["DISCORD_INVITE_URL"]?.trim() || "";
+61 -45
View File
@@ -1,4 +1,12 @@
import type { NicknameIssue, OnboardingSession } from "./types.js";
import {
formatRemainingSteps,
getRemainingSteps,
hasExtendedOnboardingTracking,
isDiscordGuidanceUnlocked,
isOnboardingCompleted,
isStep1Completed,
} from "./state/progress.js";
import {
HEART_LOCATION_TEXT,
HEART_RULE_TEXT,
@@ -100,17 +108,20 @@ export function analyzeNicknameIssues(nickname: string): NicknameIssue[] {
export function getWelcomeMessage(nickname: string): string {
return pickRandom([
`${nickname}님 환영합니다! 새내기 등록은 닉네임 변경과 하트 인증 두 가지를 진행하시면 돼요.\n\n` +
`${nickname}님 환영합니다! 새내기 등록 1단계는 카카오톡 닉네임 변경과 하트 인증이에요.\n\n` +
`1. 닉네임 변경: 이름/나이/성별/티어 형식 (예: 홍길동/25/남/G)\n` +
`2. 하트 인증: 채팅방 프로필 하트를 빨간색으로 만들고 원본 스크린샷 전송\n\n` +
`2. 하트 인증: 채팅방 프로필 하트를 빨간색으로 만들고 원본 스크린샷 전송\n` +
`3. 1단계 완료 후 디스코드 단계가 이어질 수 있어요.\n\n` +
`궁금한 점 있으시면 편하게 물어봐 주세요!`,
`${nickname}님 반갑습니다! 톡 게시글의 공지를 참고하셔서 닉네임 변경과 하트 인증을 진행해 주세요.\n\n` +
`${nickname}님 반갑습니다! 톡 게시글의 공지를 참고하셔서 먼저 카카오톡 닉네임 변경과 하트 인증을 진행해 주세요.\n\n` +
`닉네임: 이름/나이/성별/티어 형식으로 변경 (예: 홍길동/25/남/G)\n` +
`하트 인증: 프로필 하트 빨간색 상태 원본 스크린샷 전송\n\n` +
`하트 인증: 프로필 하트 빨간색 상태 원본 스크린샷 전송\n` +
`이후에는 디스코드 단계가 이어질 수 있어요.\n\n` +
`어떤 것부터 시작하시겠어요?`,
`${nickname}님 롤림푸스에 오신 걸 환영해요! 등록 절차를 안내해 드릴게요.\n\n` +
`닉네임을 이름/나이/성별/티어 형식(예: 홍길동/25/남/G)으로 바꿔주시고, ` +
`채팅방 프로필 하트를 빨간색으로 만든 원본 스크린샷을 보내주시면 됩니다. 순서는 상관없어요!`,
`채팅방 프로필 하트를 빨간색으로 만든 원본 스크린샷을 보내주시면 됩니다. ` +
`카카오톡 1단계가 끝나면 디스코드 단계가 이어질 수 있어요.`,
]);
}
@@ -194,28 +205,22 @@ export function getProgressMessage(
): string {
const nicknameIcon = session.nicknameVerified ? "v" : "x";
const photoIcon = session.photoVerified ? "v" : "x";
let nextStep = "";
if (!session.nicknameVerified && !session.photoVerified) {
nextStep = pickRandom([
"\n\n톡 게시글의 공지를 참고하셔서 닉네임 변경과 하트 인증을 진행해 주세요!",
"\n\n아직 두 가지 모두 남아있어요. 어떤 것부터 시작하시겠어요?",
]);
} else if (!session.nicknameVerified) {
nextStep = pickRandom([
"\n\n닉네임 변경만 완료하시면 돼요! 이름/나이/성별/티어 형식으로 변경해 주세요.",
"\n\n하트 인증은 완료됐어요! 닉네임만 변경해 주시면 끝이에요.",
]);
} else if (!session.photoVerified) {
nextStep = pickRandom([
"\n\n하트 인증만 남았어요! 프로필 하트를 빨간색으로 만든 스크린샷을 보내주세요.",
"\n\n닉네임은 완료됐어요! 하트 인증 스크린샷만 보내주시면 끝이에요.",
]);
}
const discordNicknameIcon =
session.discordProfileNicknameVerified === true ? "v" : "x";
const discordMessageIcon =
session.discordProfileMessageVerified === true ? "v" : "x";
const remaining = getRemainingSteps(session);
const remainingText =
remaining.length > 0
? `\n\n이제 ${formatRemainingSteps(remaining)}만 남아 있어요.`
: "\n\n이제 새내기 등록 절차는 모두 완료됐어요.";
const extendedStatus = hasExtendedOnboardingTracking(session)
? ` | 디스코드 닉네임 [${discordNicknameIcon}] | 디스코드 메시지 [${discordMessageIcon}]`
: "";
return (
`${nickname}님 현재 진행상황: 닉네임 [${nicknameIcon}] | 하트인증 [${photoIcon}]` +
nextStep
`${nickname}님 현재 진행상황: 카카오톡 닉네임 [${nicknameIcon}] | 방 하트 인증 [${photoIcon}]${extendedStatus}` +
remainingText
);
}
@@ -237,10 +242,10 @@ export function getGenericHelpMessage(
nickname: string,
session: OnboardingSession | null,
): string {
if (!session || (!session.nicknameVerified && !session.photoVerified)) {
if (!session || !isStep1Completed(session)) {
return pickRandom([
`톡 게시글의 공지를 참고하셔서 닉네임 변경과 하트 인증을 진행해 주세요!`,
`닉네임 변경과 하트 인증 두 가지를 완료하시면 돼요. 톡 게시글의 공지를 확인해 주세요!`,
`톡 게시글의 공지를 참고하셔서 먼저 카카오톡 닉네임 변경과 하트 인증을 진행해 주세요!`,
`먼저 닉네임 변경과 하트 인증 두 가지를 완료하시면 돼요. 톡 게시글의 공지를 확인해 주세요!`,
]);
}
@@ -258,40 +263,51 @@ export function getGenericHelpMessage(
]);
}
return `${nickname}님 두 절차가 모두 확인되면 디스코드 권한이 자동으로 부여돼요!`;
if (isOnboardingCompleted(session)) {
return `${nickname}님 모든 절차가 완료됐어요! 디스코드 권한이 자동으로 부여돼요!`;
}
return `${nickname}님 카카오톡 절차는 완료됐고, 이제 ${formatRemainingSteps(
getRemainingSteps(session),
)}만 진행하시면 돼요!`;
}
export function getRemainingStatusMessage(
session: OnboardingSession | null,
): string {
if (!session || (!session.nicknameVerified && !session.photoVerified)) {
return "이제 닉네임 변경과 방 하트 인증 두 가지가 남아 있어요.";
const remaining = getRemainingSteps(session);
if (remaining.length === 0) {
return "이제 새내기 등록 절차는 모두 완료됐어요.";
}
if (!session.nicknameVerified) {
return "이제 닉네임 변경만 남았어요.";
}
if (!session.photoVerified) {
return "이제 방 하트 인증만 남았어요.";
}
return "이제 새내기 등록 절차는 모두 완료됐어요.";
return `이제 ${formatRemainingSteps(remaining)}만 남아 있어요.`;
}
export function getDiscordMessage(
nickname: string,
session: OnboardingSession | null,
): string {
if (session?.nicknameVerified && session?.photoVerified) {
if (!isDiscordGuidanceUnlocked(session)) {
return pickRandom([
`${nickname}님 두 절차 모두 완료되셨어요! 디스코드 서버에 입장해서 서버 프로필을 설정해 주시면 봇이 자동으로 권한을 부여해 드려요.`,
`${nickname}님 닉네임과 하트 인증 모두 완료됐어요! 이제 디스코드 서버에 입장하신 후 서버 프로필을 설정하시면 권한이 자동 부여돼요.`,
`${nickname}님 카카오톡 닉네임 변경과 하트 인증을 먼저 완료해 주셔야 디스코드 안내를 드릴 수 있어요!`,
`${nickname}님 디스코드 단계는 카카오톡 닉네임 변경과 하트 인증을 모두 완료하신 뒤에 안내드릴게요!`,
]);
}
if (session && !isOnboardingCompleted(session)) {
return pickRandom([
`${nickname}님 카카오톡 절차는 완료됐어요! 이제 ${formatRemainingSteps(
getRemainingSteps(session),
)}만 진행하시면 돼요.`,
`${nickname}님 이제 디스코드 단계만 남았어요. ${formatRemainingSteps(
getRemainingSteps(session),
)}을 확인해 주세요.`,
]);
}
return pickRandom([
`${nickname}님 닉네임 변경과 하트 인증을 먼저 완료해 주셔야 디스코드 안내를 드릴 수 있어요!`,
`${nickname}님 디스코드 권한은 닉네임 변경과 하트 인증을 모두 완료하신 후에 안내드릴게요!`,
`${nickname}님 디스코드 단계까지 모두 완료되셨어요! 권한이 자동으로 부여될 거예요.`,
`${nickname}님 모든 새내기 등록 절차가 끝났어요! 디스코드 권한 반영만 잠시 기다려 주세요.`,
]);
}
@@ -26,8 +26,10 @@ function makeSession(
chatroomId: "room-1",
deadlineAt: "2026-04-16T12:00:00.000Z",
joinedAt: "2026-04-16T10:00:00.000Z",
kakaotalkNickname: "프리리/95/여/D",
kakaotalkNicknameAliases: [],
kakaotalkNicknameVerified: true,
lastEventAt: "2026-04-16T10:30:00.000Z",
nickname: "프리리/95/여/D",
nicknameVerified: true,
photoVerified: false,
status: "pending",
@@ -68,6 +70,7 @@ describe("PromptBuilder", () => {
expect(messages[0]?.role).toBe("system");
expect(messages[0]?.content).toContain("하트 인증이 뭐예요?");
expect(messages[0]?.content).not.toContain("나이 제한 있나요?");
expect(messages[0]?.content).toContain("카카오톡 닉네임");
});
it("limits prompt history to the latest five turns when summary exists", () => {
+14 -2
View File
@@ -25,7 +25,7 @@ export const EXAMPLES_BY_INTENT: Record<Intent["kind"], Example[]> = {
"status-question": [
{
user: "이제 뭐 남았지?",
assistant: "이제 방 하트 인증만 남았어요.",
assistant: "이제 디스코드 프로필 닉네임 설정과 프로필 메시지 설정만 남아 있어요.",
},
{
user: "진행상황 알려줘",
@@ -74,7 +74,19 @@ export const EXAMPLES_BY_INTENT: Record<Intent["kind"], Example[]> = {
{
user: "디스코드는 언제 들어가요?",
assistant:
"닉네임 변경과 하트 인증을 모두 완료하신 뒤에 디스코드 안내를 받으실 수 있어요.",
"카카오톡 닉네임 변경과 하트 인증을 완료하셨다면, 이제 디스코드 방 입장과 프로필 설정을 진행하시면 돼요.",
},
],
"discord-verify-question": [
{
user: "디코 닉변 확인해줘",
assistant:
"아직 디스코드 닉네임 변경은 확인되지 않았어요.",
},
{
user: "디스코드 프로필 닉네임 설정 완료했어요",
assistant:
"디스코드 닉네임을 확인해봤는데 아직 올바른 형식으로 확인되지는 않았어요.",
},
],
"age-question": [
+38 -7
View File
@@ -13,6 +13,12 @@ import {
NICKNAME_FORMAT_EXAMPLE,
TIER_CODES_TEXT,
} from "../constants.js";
import {
formatRemainingSteps,
getRemainingSteps,
hasExtendedOnboardingTracking,
isStep1Completed,
} from "../state/progress.js";
import { EXAMPLES_BY_INTENT } from "./examples.js";
function formatKstTimestamp(value: string | undefined): string {
@@ -38,8 +44,8 @@ function formatNicknameStatus(session: OnboardingSession | null): string {
}
return session.nicknameVerified
? `완료 (${session.nickname})`
: `미완료 (현재: ${session.nickname})`;
? `완료 (${session.kakaotalkNickname})`
: `미완료 (현재: ${session.kakaotalkNickname})`;
}
function formatPhotoStatus(session: OnboardingSession | null): string {
@@ -50,6 +56,14 @@ function formatPhotoStatus(session: OnboardingSession | null): string {
return session.photoVerified ? "완료" : "미완료";
}
function formatOptionalVerificationStatus(value: boolean | undefined): string {
if (value === undefined) {
return "추적 안 함";
}
return value ? "완료" : "미완료";
}
function formatHistory(history: ConversationMessage[]): string {
if (history.length === 0) {
return "(최근 대화 없음)";
@@ -101,11 +115,13 @@ export function personaLayer(): string {
[커뮤니티 규칙]
- 가입 가능 연령은 ${MIN_AGE}세 이상이야.
- 새내기 등록은 닉네임 변경과 방 하트 인증 두 가지를 모두 완료하면 돼.
- 새내기 등록 1단계는 카카오톡 닉네임 변경과 방 하트 인증이야.
- 1단계 완료 후에는 디스코드 본인인증방/구인방 입장과 서버 프로필 설정이 남아 있을 수 있어.
- 닉네임 형식은 이름/출생 연도 두 자리/성별/티어야. 예: ${NICKNAME_FORMAT_EXAMPLE}
- 성별은 남 또는 여, 티어 코드는 ${TIER_CODES_TEXT} 중 하나야.
- 방 하트 인증은 ${HEART_RULE_TEXT}
- 디스코드 안내는 닉네임 변경과 하트 인증이 모두 완료된 뒤에만 해줘.`;
- 세션에 디스코드 관련 미완료 항목이 있으면 전체 등록은 아직 완료가 아니야.
- 디스코드 안내는 카카오톡 1단계가 완료된 뒤에만 해줘.`;
}
export function policyLayer(
@@ -144,7 +160,13 @@ export function policyLayer(
lines.push("- 하트 인증에 대해서만 답하고 다른 절차는 언급하지 마.");
break;
case "discord-question":
lines.push("- 디스코드 질문에만 답해. 완료 전이라면 먼저 온보딩 완료가 필요하다고만 알려줘.");
lines.push("- 디스코드 질문에만 답해. 카카오톡 1단계 전이라면 먼저 닉네임 변경과 하트 인증이 필요하다고 알려줘.");
break;
case "discord-verify-question":
lines.push("- 디스코드 닉네임 확인 결과만 답해.");
lines.push("- 확인되지 않았으면 확인되지 않았다고만 답하고, 추측해서 단정하지 마.");
lines.push("- 카카오톡 닉네임 형식이 틀리면 예시를 1개만 들고 형식에 맞게 변경해 달라고 안내해.");
lines.push("- 사용자가 묻지 않은 디스코드 절차나 다음 단계는 먼저 붙이지 마.");
break;
case "age-question":
lines.push("- 나이 제한만 간단히 답해.");
@@ -165,11 +187,20 @@ export function stateLayer(
session: OnboardingSession | null,
derived: DerivedState,
): string {
const remaining = getRemainingSteps(session);
return [
"[현재 유저 상태]",
`- phase: ${derived.phase.kind}`,
`- nickname: ${formatNicknameStatus(session)}`,
`- photo: ${formatPhotoStatus(session)}`,
`- step1(카카오톡): ${session ? (isStep1Completed(session) ? "완료" : "미완료") : "미완료"}`,
`- 카카오톡 닉네임: ${formatNicknameStatus(session)}`,
`- 방 하트 인증: ${formatPhotoStatus(session)}`,
`- 디스코드 본인인증방 입장: ${formatOptionalVerificationStatus(session?.identityRoomJoined)}`,
`- 디스코드 구인방 입장: ${formatOptionalVerificationStatus(session?.recruitingRoomJoined)}`,
`- 디스코드 프로필 닉네임: ${formatOptionalVerificationStatus(session?.discordProfileNicknameVerified)}`,
`- 디스코드 프로필 메시지: ${formatOptionalVerificationStatus(session?.discordProfileMessageVerified)}`,
`- extendedTracking: ${hasExtendedOnboardingTracking(session) ? "on" : "off"}`,
`- remaining: ${remaining.length > 0 ? formatRemainingSteps(remaining) : "없음"}`,
`- deadline(KST): ${formatKstTimestamp(session?.deadlineAt)}`,
].join("\n");
}
+8 -1
View File
@@ -13,7 +13,14 @@ export function buildToolPolicy(
}
if (intent === "age-question" || intent === "discord-question") {
return "- 규칙 확인이 필요하면 lookup-community-rule 도구를 사용해 정확한 규칙만 답해.";
return [
"- 디스코드 일반 안내나 규칙 질문이면 lookup-community-rule 도구를 사용해 정확한 규칙만 답해.",
"- 사용자가 디스코드 닉네임이나 프로필 설정을 끝냈다고 말하거나 반영 여부를 묻는다면 verify-discord-nickname 도구를 먼저 사용해 직접 확인해.",
].join("\n");
}
if (intent === "discord-verify-question") {
return "- 디스코드 닉네임 확인 요청은 verify-discord-nickname 도구를 먼저 사용하고, 조회 결과만 짧게 답해.";
}
if (intent === "help-where") {
+51 -7
View File
@@ -1,4 +1,4 @@
import { getContext } from "@obs/context";
import { getContext, getRequestLogger } from "@obs/context";
import type { LlmClient } from "@llm/llm-client";
import type { ChatMessage } from "@llm/types";
import type { Tool, ToolContext } from "@tools/tool";
@@ -147,11 +147,11 @@ function buildPlannerMessages(
approach:
"answer-direct | ask-clarification | redirect-to-step | validate-then-explain | lookup-rule-then-answer | soft-decline",
targetPhase:
"fresh | nickname-pending | photo-pending | both-pending | nickname-rejected | photo-rejected | deadline-near | completed | timed-out",
"fresh | nickname-pending | photo-pending | both-pending | step1-completed | nickname-rejected | photo-rejected | deadline-near | completed | timed-out",
mustInclude: ["short strings"],
mustAvoid: ["short strings"],
suggestedTools: [
"validate-nickname | check-onboarding-progress | lookup-community-rule | get-room-context",
"validate-nickname | check-onboarding-progress | lookup-community-rule | get-room-context | verify-discord-nickname",
],
tone: "friendly | concise | encouraging | neutral | apologetic",
targetLengthChars: 150,
@@ -186,8 +186,9 @@ function buildResponderAddendum(plan: PlannerOutput): string {
function pickToolsForPlan(
plan: PlannerOutput,
tools: readonly Tool<unknown, unknown>[],
forceTools: boolean,
): readonly Tool<unknown, unknown>[] {
if (plan.approach === "answer-direct" || plan.approach === "soft-decline") {
if (!forceTools && (plan.approach === "answer-direct" || plan.approach === "soft-decline")) {
return [];
}
@@ -214,8 +215,19 @@ export class OnboardingOrchestrator {
maxTokens: number,
modelOverride: string,
): Promise<string | null> {
const logger = getRequestLogger();
const deadlineMs = getRemainingDeadlineMs();
logger.debug(
{
intent: derived.intent.kind,
responderTools: responderTools.map((tool) => tool.name),
role: "responder",
tier: derived.tier,
},
"[OnboardingOrchestrator] Responder execution mode decided",
);
if (responderTools.length > 0) {
return runWithTools({
deadlineMs,
@@ -247,6 +259,7 @@ export class OnboardingOrchestrator {
derived: DerivedState,
messages: ChatMessage[],
): Promise<PlannerOutput> {
const logger = getRequestLogger();
const plannerMessages = buildPlannerMessages(derived, messages);
const firstAttempt = await this.llmClient.chatCompletion(plannerMessages, {
deadlineMs: getRemainingDeadlineMs(),
@@ -262,6 +275,14 @@ export class OnboardingOrchestrator {
? tryParsePlannerOutput(firstAttempt.content)
: null;
if (firstPlan) {
logger.debug(
{
intent: derived.intent.kind,
plan: firstPlan,
source: "first-attempt",
},
"[OnboardingOrchestrator] Planner output parsed",
);
return firstPlan;
}
@@ -285,7 +306,28 @@ export class OnboardingOrchestrator {
});
const retryPlan = retry?.content ? tryParsePlannerOutput(retry.content) : null;
return retryPlan ?? getDefaultPlan(derived);
if (retryPlan) {
logger.debug(
{
intent: derived.intent.kind,
plan: retryPlan,
source: "retry",
},
"[OnboardingOrchestrator] Planner output parsed",
);
return retryPlan;
}
const fallbackPlan = getDefaultPlan(derived);
logger.debug(
{
intent: derived.intent.kind,
plan: fallbackPlan,
source: "fallback",
},
"[OnboardingOrchestrator] Planner fell back to default plan",
);
return fallbackPlan;
}
private async runTier0(
@@ -317,7 +359,8 @@ export class OnboardingOrchestrator {
messages,
buildResponderAddendum(plan),
);
const responderTools = pickToolsForPlan(plan, options.tools ?? []);
const forceTools = derived.responseMode === "llm-with-tools";
const responderTools = pickToolsForPlan(plan, options.tools ?? [], forceTools);
return this.runDirect(
derived,
@@ -339,7 +382,8 @@ export class OnboardingOrchestrator {
messages,
buildResponderAddendum(plan),
);
const responderTools = pickToolsForPlan(plan, options.tools ?? []);
const forceTools = derived.responseMode === "llm-with-tools";
const responderTools = pickToolsForPlan(plan, options.tools ?? [], forceTools);
const draft = await this.runDirect(
derived,
@@ -14,6 +14,7 @@ export const PlannerTargetPhaseSchema = z.enum([
"nickname-pending",
"photo-pending",
"both-pending",
"step1-completed",
"nickname-rejected",
"photo-rejected",
"deadline-near",
@@ -26,6 +27,7 @@ export const PlannerSuggestedToolSchema = z.enum([
"check-onboarding-progress",
"lookup-community-rule",
"get-room-context",
"verify-discord-nickname",
]);
export const PlannerToneSchema = z.enum([
@@ -1,4 +1,5 @@
import { withToolSpan } from "@obs/spans";
import { getRequestLogger } from "@obs/context";
import type { LlmClient } from "@llm/llm-client";
import type { ChatCompletionOptions, ChatMessage } from "@llm/types";
import { parseToolCalls } from "@tools/parser";
@@ -22,6 +23,7 @@ export interface ToolLoopOptions {
export async function runWithTools(
options: ToolLoopOptions,
): Promise<string | null> {
const logger = getRequestLogger();
const maxHops = options.maxHops ?? 2;
const messages = options.messages.map((message) => ({ ...message }));
let allowNativeTools = true;
@@ -39,14 +41,44 @@ export async function runWithTools(
});
if (!response) {
logger.debug(
{
hop,
role: options.role,
tier: options.tier,
},
"[ToolLoop] LLM returned no response",
);
return null;
}
const toolCalls = parseToolCalls(response.message);
if (toolCalls.length === 0) {
logger.debug(
{
content: response.content,
hop,
role: options.role,
tier: options.tier,
},
"[ToolLoop] No tool call in model response",
);
return response.content;
}
logger.debug(
{
hop,
role: options.role,
tier: options.tier,
toolCalls: toolCalls.map((call) => ({
id: call.id,
name: call.name,
})),
},
"[ToolLoop] Parsed tool calls",
);
if (hop === maxHops) {
messages.push(response.message);
messages.push({
@@ -66,6 +98,15 @@ export async function runWithTools(
throw new Error(`Tool not registered for call: ${call.name}`);
}
logger.debug(
{
arguments: call.arguments,
callId: call.id,
tool: tool.name,
},
"[ToolLoop] Executing tool call",
);
const validated = tool.argsSchema.parse(call.arguments);
const result = await withToolSpan(
tool.name,
@@ -76,6 +117,15 @@ export async function runWithTools(
() => tool.execute(validated, options.toolContext),
);
logger.debug(
{
callId: call.id,
result,
tool: tool.name,
},
"[ToolLoop] Tool call completed",
);
messages.push({
role: "tool",
name: tool.name,
@@ -19,7 +19,7 @@ function makeDerived(
}
describe("validateOnboardingResponse", () => {
it("rejects discord guidance before onboarding is completed", () => {
it("rejects discord guidance before step1 is completed", () => {
const result = validateOnboardingResponse(
"디스코드 서버에 들어가시면 돼요.",
makeDerived(),
@@ -29,6 +29,21 @@ describe("validateOnboardingResponse", () => {
expect(result.reasons).toContain("stateConsistency");
});
it("allows discord guidance after step1 is completed", () => {
const result = validateOnboardingResponse(
"이제 디스코드 프로필 닉네임과 프로필 메시지를 설정하시면 돼요.",
makeDerived({
intent: { kind: "discord-question" },
phase: {
kind: "step1-completed",
remaining: ["discord-profile-nickname", "discord-profile-message"],
},
}),
);
expect(result.status).toBe("pass");
});
it("rejects invalid nickname examples", () => {
const result = validateOnboardingResponse(
"홍길동/95/남/Z로 바꾸시면 돼요.",
+17 -1
View File
@@ -96,6 +96,22 @@ function hasRepeatedPhrase(text: string): boolean {
return [...phrases.values()].some((count) => count >= 3);
}
function canAdvanceDiscordStep(derived: DerivedState): boolean {
if (
derived.phase.kind === "completed" ||
derived.phase.kind === "step1-completed"
) {
return true;
}
if (derived.phase.kind !== "deadline-near") {
return false;
}
return !derived.phase.remaining.includes("nickname") &&
!derived.phase.remaining.includes("photo");
}
function markValidation(result: ValidationResult): ValidationResult {
const activeSpan = trace.getActiveSpan();
activeSpan?.setAttributes({
@@ -137,7 +153,7 @@ export function validateOnboardingResponse(
if (
mentionsDiscord &&
derived.phase.kind !== "completed" &&
!canAdvanceDiscordStep(derived) &&
advancesDiscordStep &&
!defersDiscordStep
) {
+210
View File
@@ -0,0 +1,210 @@
import type {
OnboardingSession,
OnboardingStatus,
StoredOnboardingSession,
} from "./types.js";
export interface ParsedKakaoNickname {
baseName: string;
gender: string;
tier: string;
year: string;
}
interface KakaoNicknameCarrier {
kakaotalkNickname?: string | undefined;
nickname?: string | undefined;
}
function trimString(value: string | undefined): string | undefined {
const normalized = value?.trim();
return normalized ? normalized : undefined;
}
function optionalStringField<K extends string>(
key: K,
value: string | undefined,
): Partial<Record<K, string>> {
return value === undefined ? {} : ({ [key]: value } as Partial<Record<K, string>>);
}
function optionalBooleanField<K extends string>(
key: K,
value: boolean | undefined,
): Partial<Record<K, boolean>> {
return value === undefined ? {} : ({ [key]: value } as Partial<Record<K, boolean>>);
}
function isOnboardingStatus(value: string | undefined): value is OnboardingStatus {
return value === "pending" || value === "completed" || value === "timed_out";
}
function escapeForRegExp(value: string): string {
return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
}
export function collectNicknameAliases(
...sources: Array<readonly string[] | string | null | undefined>
): string[] {
const aliases: string[] = [];
const seen = new Set<string>();
const pushAlias = (value: string | undefined): void => {
const normalized = trimString(value);
if (!normalized || seen.has(normalized)) {
return;
}
seen.add(normalized);
aliases.push(normalized);
};
for (const source of sources) {
if (Array.isArray(source)) {
for (const value of source) {
pushAlias(value);
}
continue;
}
if (typeof source === "string") {
pushAlias(source);
}
}
return aliases;
}
export function getKakaotalkNickname(session: KakaoNicknameCarrier): string {
return trimString(session.kakaotalkNickname) ?? trimString(session.nickname) ?? "";
}
export function parseKakaoNickname(
kakaotalkNickname: string,
): ParsedKakaoNickname | null {
const [baseName, year, gender, tier, ...rest] = kakaotalkNickname
.split("/")
.map((value) => value.trim());
if (rest.length > 0 || !baseName || !year || !gender || !tier) {
return null;
}
return {
baseName,
gender,
tier,
year,
};
}
export function matchesDiscordNicknameRule(
guildNickname: string | undefined,
kakaotalkNickname: string,
): boolean {
const normalizedGuildNickname = trimString(guildNickname);
const parsed = parseKakaoNickname(kakaotalkNickname);
if (!normalizedGuildNickname || !parsed) {
return false;
}
const pattern = new RegExp(
`^${escapeForRegExp(parsed.baseName)}#[^/]+/${escapeForRegExp(parsed.year)}/${escapeForRegExp(parsed.tier)}$`,
"u",
);
return pattern.test(normalizedGuildNickname);
}
export function normalizeOnboardingSession(
session: StoredOnboardingSession | null,
): OnboardingSession | null {
if (!session) {
return null;
}
const chatroomId = trimString(session.chatroomId);
const deadlineAt = trimString(session.deadlineAt);
const joinedAt = trimString(session.joinedAt);
const lastEventAt = trimString(session.lastEventAt);
const userId = trimString(session.userId);
if (
!chatroomId ||
!deadlineAt ||
!joinedAt ||
!lastEventAt ||
!userId ||
!isOnboardingStatus(session.status)
) {
return null;
}
const kakaotalkNickname = getKakaotalkNickname(session);
const kakaotalkNicknameAliases = collectNicknameAliases(
session.kakaotalkNicknameAliases,
session.nicknameAliases,
);
const kakaotalkNicknameVerified =
session.kakaotalkNicknameVerified ?? session.nicknameVerified ?? false;
const kakaotalkNicknameVerifiedAt =
trimString(session.kakaotalkNicknameVerifiedAt) ??
trimString(session.nicknameVerifiedAt);
const completedAt = trimString(session.completedAt);
const discordMemberId = trimString(session.discordMemberId);
const discordProfileMessageVerifiedAt = trimString(
session.discordProfileMessageVerifiedAt,
);
const discordProfileNicknameVerifiedAt = trimString(
session.discordProfileNicknameVerifiedAt,
);
const identityRoomJoinedAt = trimString(session.identityRoomJoinedAt);
const nicknameVerifiedAt = kakaotalkNicknameVerifiedAt;
const photoVerifiedAt = trimString(session.photoVerifiedAt);
const recruitingRoomJoinedAt = trimString(session.recruitingRoomJoinedAt);
const step1CompletedAt = trimString(session.step1CompletedAt);
const timedOutAt = trimString(session.timedOutAt);
return {
chatroomId,
deadlineAt,
joinedAt,
kakaotalkNickname,
kakaotalkNicknameAliases,
kakaotalkNicknameVerified,
lastEventAt,
nicknameVerified: kakaotalkNicknameVerified,
photoVerified: session.photoVerified ?? false,
status: session.status,
userId,
...optionalStringField("completedAt", completedAt),
...optionalStringField("discordMemberId", discordMemberId),
...optionalBooleanField(
"discordProfileMessageVerified",
session.discordProfileMessageVerified,
),
...optionalStringField(
"discordProfileMessageVerifiedAt",
discordProfileMessageVerifiedAt,
),
...optionalBooleanField(
"discordProfileNicknameVerified",
session.discordProfileNicknameVerified,
),
...optionalStringField(
"discordProfileNicknameVerifiedAt",
discordProfileNicknameVerifiedAt,
),
...optionalBooleanField("identityRoomJoined", session.identityRoomJoined),
...optionalStringField("identityRoomJoinedAt", identityRoomJoinedAt),
...optionalStringField(
"kakaotalkNicknameVerifiedAt",
kakaotalkNicknameVerifiedAt,
),
...optionalStringField("nicknameVerifiedAt", nicknameVerifiedAt),
...optionalStringField("photoVerifiedAt", photoVerifiedAt),
...optionalBooleanField("recruitingRoomJoined", session.recruitingRoomJoined),
...optionalStringField("recruitingRoomJoinedAt", recruitingRoomJoinedAt),
...optionalStringField("step1CompletedAt", step1CompletedAt),
...optionalStringField("timedOutAt", timedOutAt),
};
}
+38 -3
View File
@@ -1,6 +1,7 @@
import type { AgentRequest, AgentResponse, ConversationMessage } from "@agent/types";
import { getConversationSummaryKey } from "@conv/conversation-store";
import type { GarnetClient } from "@common/garnet";
import type { NatsClient } from "@common/nats";
import { getContext, getRequestLogger } from "@obs/context";
import type { LlmClient } from "@llm/llm-client";
import type { ChatMessage } from "@llm/types";
@@ -36,7 +37,12 @@ import { OnboardingIntentClassifier } from "./state/classifier.js";
import type { DerivedState, Intent } from "./state/onboarding-state.js";
import { OnboardingOrchestrator } from "./runtime/orchestrator.js";
import { validateOnboardingResponse } from "./runtime/validator.js";
import type { OnboardingSession, PromptContext } from "./types.js";
import { normalizeOnboardingSession } from "./session.js";
import type {
OnboardingSession,
PromptContext,
StoredOnboardingSession,
} from "./types.js";
type LlmTextResult =
| { status: "success"; text: string }
@@ -56,6 +62,7 @@ export class OnboardingSkill implements Skill {
private readonly llmClient: LlmClient,
private readonly roomContextService?: RoomContextService,
shadowEvalPublisher?: ShadowEvalPublisher,
private readonly natsClient?: Pick<NatsClient, "request">,
) {
this.classifier = new OnboardingIntentClassifier(llmClient);
this.blackboardStore = new OnboardingBlackboardStore(garnetClient);
@@ -124,6 +131,16 @@ export class OnboardingSkill implements Skill {
}
}
if (derived.intent.kind === "discord-verify-question") {
logger.debug(
{
responseSource: response.source,
responseText: response.text,
},
"[OnboardingSkill] Final discord verification response",
);
}
if (response.text.trim()) {
await this.rememberTurn(request, derived).catch((error) => {
logger.warn({ err: error }, "[OnboardingSkill] Failed to update blackboard");
@@ -148,7 +165,8 @@ export class OnboardingSkill implements Skill {
): Promise<OnboardingSession | null> {
const prefix = getOnboardingSessionKeyPrefix();
const key = `${prefix}:onboarding:${chatroomId}:${userId}`;
return this.garnetClient.getJson<OnboardingSession>(key);
const rawSession = await this.garnetClient.getJson<StoredOnboardingSession>(key);
return normalizeOnboardingSession(rawSession);
}
private async handleLlm(
@@ -260,7 +278,8 @@ export class OnboardingSkill implements Skill {
derived.intent.kind === "help-where" ||
derived.intent.kind === "nickname-question" ||
derived.intent.kind === "photo-question" ||
derived.intent.kind === "discord-question"
derived.intent.kind === "discord-question" ||
derived.intent.kind === "discord-verify-question"
)
? [...current.openQuestions, userMessage].slice(-3)
: current.openQuestions;
@@ -400,6 +419,8 @@ export class OnboardingSkill implements Skill {
return getGenericHelpMessage(nickname, session);
case "discord-question":
return getDiscordMessage(nickname, session);
case "discord-verify-question":
return getDiscordMessage(nickname, session);
case "age-question":
return getAgeRequirementMessage();
case "chitchat":
@@ -514,6 +535,7 @@ export class OnboardingSkill implements Skill {
): ToolContext {
return {
chatroomId: request.chatroomId,
natsClient: this.natsClient,
userId: request.userId,
session,
garnetClient: this.garnetClient,
@@ -524,6 +546,12 @@ export class OnboardingSkill implements Skill {
private selectToolsForDerived(
derived: DerivedState,
): readonly Tool<unknown, unknown>[] {
if (derived.intent.kind === "discord-verify-question") {
return this.tools.filter((tool) =>
tool.name === "verify-discord-nickname",
);
}
if (derived.phase.kind === "nickname-rejected") {
return this.tools.filter((tool) =>
tool.name === "validate-nickname" ||
@@ -538,6 +566,13 @@ export class OnboardingSkill implements Skill {
);
}
if (derived.intent.kind === "discord-question") {
return this.tools.filter((tool) =>
tool.name === "lookup-community-rule" ||
tool.name === "verify-discord-nickname",
);
}
return this.tools;
}
@@ -33,4 +33,22 @@ describe("OnboardingIntentClassifier", () => {
expect(result.intent.kind).toBe("nickname-question");
expect(result.source).toBe("regex");
});
it("classifies discord verification via regex", async () => {
const result = await classifier.classify(
"디코 닉변 확인해줘",
"user-message",
);
expect(result.intent.kind).toBe("discord-verify-question");
expect(result.source).toBe("regex");
});
it("classifies discord nickname completion reports as verification", async () => {
const result = await classifier.classify(
"디스코드 프로필 닉네임 설정 완료했어요",
"user-message",
);
expect(result.intent.kind).toBe("discord-verify-question");
expect(result.source).toBe("regex");
});
});
+20 -1
View File
@@ -76,6 +76,24 @@ function classifyByRegex(userMessage: string): ClassifiedIntent {
return { intent: intent("help-how"), confidence: 0.9, source: "regex" };
}
const mentionsDiscord = /(디스코드|디코|discord)/u.test(lower);
const asksDiscordVerification =
/(확인|조회|찾아|검색|검사|바뀌|변경|닉변|맞(?:아|나요)?|됐(?:나|나요)?|완료됐(?:나|나요)?)/u.test(
trimmed,
);
const reportsDiscordNicknameCompletion =
/(닉네임|닉변|프로필\s*닉네임|서버\s*닉네임)/u.test(trimmed) &&
/(완료했(?:어|어요|습니다)?|끝냈(?:어|어요|습니다)?|설정했(?:어|어요|습니다)?|바꿨(?:어|어요|습니다)?|변경했(?:어|어요|습니다)?|다\s*했(?:어|어요|습니다)?|해놨(?:어|어요|습니다)?|해뒀(?:어|어요|습니다)?|적용됐(?:어|어요|습니다)?)/u.test(
trimmed,
);
if (mentionsDiscord && (asksDiscordVerification || reportsDiscordNicknameCompletion)) {
return {
intent: intent("discord-verify-question"),
confidence: 0.96,
source: "regex",
};
}
if (/(디스코드|디코|discord)/u.test(lower)) {
return {
intent: intent("discord-question"),
@@ -123,6 +141,7 @@ function parseIntent(raw: unknown): Intent {
raw === "nickname-question" ||
raw === "photo-question" ||
raw === "discord-question" ||
raw === "discord-verify-question" ||
raw === "age-question" ||
raw === "chitchat" ||
raw === "off-topic-to-other"
@@ -147,7 +166,7 @@ async function classifyByLlm(
{
role: "system",
content:
'다음 유저 메시지의 intent를 JSON으로만 분류해. {"intent":"..."} 형식만 출력하고, intent는 greeting, acknowledgement, status-question, help-how, help-where, nickname-question, photo-question, discord-question, age-question, chitchat, off-topic-to-other, unknown 중 하나만 사용해.',
'다음 유저 메시지의 intent를 JSON으로만 분류해. {"intent":"..."} 형식만 출력하고, intent는 greeting, acknowledgement, status-question, help-how, help-where, nickname-question, photo-question, discord-question, discord-verify-question, age-question, chitchat, off-topic-to-other, unknown 중 하나만 사용해.',
},
{
role: "user",
+37 -1
View File
@@ -11,8 +11,10 @@ function makeSession(
chatroomId: "room-1",
deadlineAt: new Date(Date.now() + 2 * 60 * 60 * 1000).toISOString(),
joinedAt: new Date().toISOString(),
kakaotalkNickname: "프리리/95/여/D",
kakaotalkNicknameAliases: [],
kakaotalkNicknameVerified: false,
lastEventAt: new Date().toISOString(),
nickname: "프리리/95/여/D",
nicknameVerified: false,
photoVerified: false,
status: "pending",
@@ -58,4 +60,38 @@ describe("deriveState", () => {
expect(derived.allowShortResponse).toBe(true);
expect(derived.suggestedMaxTokens).toBe(96);
});
it("uses tool mode for discord verification questions", () => {
const derived = deriveState(
makeSession(),
"user-message",
intent("discord-verify-question"),
);
expect(derived.responseMode).toBe("llm-with-tools");
expect(derived.tier).toBe(1);
});
it("does not mark completed when only step1 is done for extended sessions", () => {
const derived = deriveState(
makeSession({
discordProfileMessageVerified: false,
discordProfileNicknameVerified: false,
identityRoomJoined: true,
nicknameVerified: true,
photoVerified: true,
recruitingRoomJoined: true,
step1CompletedAt: new Date().toISOString(),
}),
"user-message",
intent("status-question"),
);
expect(derived.phase.kind).toBe("step1-completed");
if (derived.phase.kind === "step1-completed") {
expect(derived.phase.remaining).toEqual([
"discord-profile-nickname",
"discord-profile-message",
]);
}
});
});
+4
View File
@@ -27,6 +27,7 @@ function getSuggestedMaxTokens(
intent.kind === "help-where" ||
intent.kind === "nickname-question" ||
intent.kind === "photo-question" ||
intent.kind === "discord-verify-question" ||
trigger === "nickname-invalid" ||
trigger === "photo-failed"
) {
@@ -76,6 +77,9 @@ export function deriveState(
if (phase.kind === "nickname-rejected") {
responseMode = "llm-with-tools";
tier = 1;
} else if (intent.kind === "discord-verify-question") {
responseMode = "llm-with-tools";
tier = 1;
} else if (phase.kind === "deadline-near") {
responseMode = "llm";
tier = 1;
@@ -4,7 +4,8 @@ export const EXPECTED_KEYWORDS: Record<Intent["kind"], string[]> = {
acknowledgement: ["네", "좋아요", "천천히"],
"age-question": ["27", "가입", "가능"],
chitchat: [],
"discord-question": ["디스코드", "권한", "완료"],
"discord-question": ["디스코드", "프로필", "권한", "설정"],
"discord-verify-question": ["디스코드", "확인", "닉네임"],
greeting: ["반갑", "환영", "어서 오세요"],
"help-how": ["하트", "닉네임", "스크린샷", "형식", "커버 보기"],
"help-where": ["오른쪽 상단", "커버 보기", "프로필"],
@@ -1,12 +1,19 @@
import type { NicknameIssue } from "../types.js";
export type RemainingStep = "nickname" | "photo";
export type RemainingStep =
| "nickname"
| "photo"
| "identity-room"
| "recruiting-room"
| "discord-profile-nickname"
| "discord-profile-message";
export type OnboardingPhase =
| { kind: "fresh" }
| { kind: "nickname-pending"; current: string }
| { kind: "photo-pending" }
| { kind: "both-pending" }
| { kind: "step1-completed"; remaining: RemainingStep[] }
| { kind: "nickname-rejected"; current: string; issues: NicknameIssue[] }
| { kind: "photo-rejected"; reason?: string | undefined }
| { kind: "deadline-near"; remaining: RemainingStep[] }
@@ -22,6 +29,7 @@ export type Intent =
| { kind: "nickname-question" }
| { kind: "photo-question" }
| { kind: "discord-question" }
| { kind: "discord-verify-question" }
| { kind: "age-question" }
| { kind: "chitchat" }
| { kind: "off-topic-to-other" }
+173
View File
@@ -0,0 +1,173 @@
import type { OnboardingSession } from '../types.js';
import type { RemainingStep } from './onboarding-state.js';
const REMAINING_STEP_LABELS: Record<RemainingStep, string> = {
nickname: '카카오톡 닉네임 변경',
photo: '방 하트 인증',
'identity-room': '디스코드 본인인증방 입장',
'recruiting-room': '디스코드 구인방 입장',
'discord-profile-nickname': '디스코드 프로필 닉네임 설정',
'discord-profile-message': '디스코드 주민신청 채널에 메시지 남기기',
};
export function isStep1Completed(session: OnboardingSession | null): boolean {
return Boolean(session?.nicknameVerified && session?.photoVerified);
}
export function hasExtendedOnboardingTracking(session: OnboardingSession | null): boolean {
if (!session) {
return false;
}
return (
session.step1CompletedAt !== undefined ||
session.identityRoomJoined !== undefined ||
session.identityRoomJoinedAt !== undefined ||
session.recruitingRoomJoined !== undefined ||
session.recruitingRoomJoinedAt !== undefined ||
session.discordProfileNicknameVerified !== undefined ||
session.discordProfileNicknameVerifiedAt !== undefined ||
session.discordProfileMessageVerified !== undefined ||
session.discordProfileMessageVerifiedAt !== undefined
);
}
function shouldTrackDiscordRooms(session: OnboardingSession | null): boolean {
if (!session) {
return false;
}
return (
session.identityRoomJoined !== undefined ||
session.identityRoomJoinedAt !== undefined ||
session.recruitingRoomJoined !== undefined ||
session.recruitingRoomJoinedAt !== undefined
);
}
function shouldTrackDiscordProfile(session: OnboardingSession | null): boolean {
if (!session) {
return false;
}
return (
session.discordProfileNicknameVerified !== undefined ||
session.discordProfileNicknameVerifiedAt !== undefined ||
session.discordProfileMessageVerified !== undefined ||
session.discordProfileMessageVerifiedAt !== undefined
);
}
function hasJoinedAllTrackedDiscordRooms(session: OnboardingSession | null): boolean {
if (!session) {
return false;
}
if (!shouldTrackDiscordRooms(session)) {
return true;
}
return session.identityRoomJoined !== false && session.recruitingRoomJoined !== false;
}
export function getRemainingSteps(session: OnboardingSession | null): RemainingStep[] {
if (!session) {
return ['nickname', 'photo'];
}
const remaining: RemainingStep[] = [];
if (!session.nicknameVerified) {
remaining.push('nickname');
}
if (!session.photoVerified) {
remaining.push('photo');
}
if (remaining.length > 0) {
return remaining;
}
if (!hasExtendedOnboardingTracking(session)) {
return [];
}
if (shouldTrackDiscordRooms(session)) {
if (session.identityRoomJoined === false) {
remaining.push('identity-room');
}
if (session.recruitingRoomJoined === false) {
remaining.push('recruiting-room');
}
}
if (!hasJoinedAllTrackedDiscordRooms(session)) {
return remaining;
}
if (shouldTrackDiscordProfile(session)) {
if (session.discordProfileNicknameVerified === false) {
remaining.push('discord-profile-nickname');
}
if (session.discordProfileMessageVerified === false) {
remaining.push('discord-profile-message');
}
}
return remaining;
}
export function isOnboardingCompleted(session: OnboardingSession | null): boolean {
if (!session) {
return false;
}
if (session.status === 'completed') {
return true;
}
if (!isStep1Completed(session)) {
return false;
}
if (!hasExtendedOnboardingTracking(session)) {
return true;
}
return getRemainingSteps(session).length === 0;
}
export function isDiscordGuidanceUnlocked(session: OnboardingSession | null): boolean {
return isStep1Completed(session);
}
export function formatRemainingStep(step: RemainingStep): string {
return REMAINING_STEP_LABELS[step];
}
function appendKoreanAnd(left: string, right: string): string {
const lastChar = left.charCodeAt(left.length - 1);
const hasBatchim = lastChar >= 0xac00 && lastChar <= 0xd7a3 && (lastChar - 0xac00) % 28 !== 0;
return `${left}${hasBatchim ? '과' : '와'} ${right}`;
}
export function formatRemainingSteps(steps: RemainingStep[]): string {
const labels = steps.map(formatRemainingStep);
if (labels.length === 0) {
return '';
}
if (labels.length === 1) {
return labels[0] ?? '';
}
if (labels.length === 2) {
return appendKoreanAnd(labels[0] ?? '', labels[1] ?? '');
}
const head = labels.slice(0, -1).join(', ');
const tail = labels[labels.length - 1] ?? '';
return appendKoreanAnd(head, tail);
}
+16 -21
View File
@@ -2,23 +2,11 @@ import { DEADLINE_NEAR_THRESHOLD_MIN } from "../constants.js";
import { analyzeNicknameIssues } from "../onboarding-templates.js";
import type { OnboardingSession } from "../types.js";
import type { OnboardingPhase, RemainingStep } from "./onboarding-state.js";
function getRemainingSteps(
session: OnboardingSession | null,
): RemainingStep[] {
if (!session) {
return ["nickname", "photo"];
}
const remaining: RemainingStep[] = [];
if (!session.nicknameVerified) {
remaining.push("nickname");
}
if (!session.photoVerified) {
remaining.push("photo");
}
return remaining;
}
import {
getRemainingSteps,
isOnboardingCompleted,
isStep1Completed,
} from "./progress.js";
function isDeadlineNear(session: OnboardingSession | null): boolean {
if (!session?.deadlineAt) {
@@ -45,15 +33,15 @@ export function derivePhaseFromSession(
return { kind: "timed-out" };
}
if (session.status === "completed" || (session.nicknameVerified && session.photoVerified)) {
if (isOnboardingCompleted(session)) {
return { kind: "completed" };
}
if (trigger === "nickname-invalid") {
return {
kind: "nickname-rejected",
current: session.nickname,
issues: analyzeNicknameIssues(session.nickname),
current: session.kakaotalkNickname,
issues: analyzeNicknameIssues(session.kakaotalkNickname),
};
}
@@ -73,7 +61,7 @@ export function derivePhaseFromSession(
if (!session.nicknameVerified) {
return {
kind: "nickname-pending",
current: session.nickname,
current: session.kakaotalkNickname,
};
}
@@ -81,5 +69,12 @@ export function derivePhaseFromSession(
return { kind: "photo-pending" };
}
if (isStep1Completed(session) && remaining.length > 0) {
return {
kind: "step1-completed",
remaining,
};
}
return { kind: "fresh" };
}
+18 -1
View File
@@ -47,14 +47,31 @@ export interface OnboardingSession {
completedAt?: string;
deadlineAt: string;
discordMemberId?: string;
discordProfileMessageVerified?: boolean;
discordProfileMessageVerifiedAt?: string;
discordProfileNicknameVerified?: boolean;
discordProfileNicknameVerifiedAt?: string;
identityRoomJoined?: boolean;
identityRoomJoinedAt?: string;
joinedAt: string;
kakaotalkNickname: string;
kakaotalkNicknameAliases: string[];
kakaotalkNicknameVerified: boolean;
kakaotalkNicknameVerifiedAt?: string;
lastEventAt: string;
nickname: string;
nicknameVerified: boolean;
nicknameVerifiedAt?: string;
photoVerified: boolean;
photoVerifiedAt?: string;
recruitingRoomJoined?: boolean;
recruitingRoomJoinedAt?: string;
step1CompletedAt?: string;
status: OnboardingStatus;
timedOutAt?: string;
userId: string;
}
export type StoredOnboardingSession = Partial<OnboardingSession> & {
nickname?: string;
nicknameAliases?: string[];
};