
ソシャゲのサーバーを作る。ホームまでたどり着く(11)
第一部で土台ができました。
ここからは、その上にゲームを載せていきます。
まずは起動してからホーム画面に着くまでで。
新規なら名前を入れてプロローグが流れる。
2回目以降はタイトルから直接ホームへ。
どこまで進んだかを持つ
最初に決めることがあります。
名前入力をいつ出すかです。
新規のときだけ出して、2回目以降は飛ばしたい。
ではそれをどう判定するか。
名前が入っているかどうかで見る、というのは使えません。
10本目で初期値を「プレイヤー」にしたので、最初から入ってます。
サインアップの戻り値に is_new があるので、それを使う手はあります。
ただ名前入力の途中でブラウザを閉じられると詰みます。
次に来たときは既存ユーザーなので、名前を入れる機会が二度と来ない。
デフォルトの名前で進行するゲームもありますが(笑)
なので進捗を持つことにしました。
0 … 名前を入れていない
1 … 名前入力済み
2 … プロローグ済み
3 … ホーム到達済み
4 … 初回ガチャ済みuser_status に tutorial_step という列を1つ足します。
名前入力の判定だけなら真偽値で足りますが、 それだと使い道がそこで終わってしまうので。
チュートリアルの進み具合として持っておけば、 初回ガチャの誘導にもそのまま使えます。
進行度の定義はコードの定数です。
マスタに入れてもいいのですが、 チュートリアル進行度を差し替えることはあまり無いので。
新規ユーザーの離脱率が高い場合は、このあたりを分析して改修していきます、いわゆるKPIですね。
運用前だから直せる
10本目で作ったばかりのテーブルに、列を1つ足すことになりました。
前回「運用中のALTERは御法度」と書いたばかりですね。
ただまだ誰も遊んでいません。
本番のデータが1行も無いので、定義ファイルを書き換えて入れ直せば済みます。
とはいえ、そのまま流しても列は増えません。
ユーザー側の _all.sql は CREATE TABLE IF NOT EXISTS だけなので、 既にあるテーブルには何もしないんですよね。
1行も消せないテーブルなので、そう作ってあります。
なので今回は、定義ファイルを直したうえで、 手元のDBには ALTER TABLE を直接当てました。
それで済むのは、DBが1つしかないからです。
運用が始まるとこうはいきません
本番、ステージング、開発環境。
同じ変更を、同じ順番で、それぞれに当てる必要が出てきます。
誰がどこまで当てたかを記憶で管理するのは無理ですね。
そこで連番のマイグレーションになります。
001_create_tables.sql
002_add_tutorial_step.sql
003_...適用済みの番号をDBに持たせておいて、 まだ当てていないものだけを順に流す。
環境ごとの状態が番号ひとつで分かるのがこの仕組みの肝です。
マイグレートツールを使うところが多いのではないかと思います。
いまは要りません。
DBは手元に1つで、作り直しても誰も困らないので。
必要になってから入れます。
これができるのは今のうちだけですね。
APIは3本
進捗の更新をどこでやるか、少し考えました。
進捗を上げるためだけのAPIを1本作って、 名前保存とは別に叩く、という形もあります。
やめました。片方だけ失敗すると面倒なので。
名前は保存されたのに進捗が0のまま、という状態が起きると、 次の起動でまた名前入力が出てきます。
入れた名前は消えていないので、 「プレイヤー」でも空でもない名前が入った状態で名前入力画面に来る。
なので同じトランザクションで一緒に更新します。
POST /user/name 名前を保存して、進捗を1に
POST /user/tutorial/prologue 進捗を2に
GET /user/home ホームのデータを返す。進捗が2なら3にプロローグだけは送るものが無いので、専用に1本作りました。
「見終わった」以外に伝えることが無いんですよね。
飛ばしてホームで2つ進める手もありましたが、 それだと演出の途中で閉じた人が、次回プロローグを見られません。
初回の体験なので、ちゃんと見せたいところです。
名前をどこまで見るか
名前の入力欄には maxLength を付けてあります。
ただそれは当てにしません。
APIを直接叩けば、いくらでも長い文字列を送れるので。
typescript
function normalizeUserName(raw: string): string | null {
const name = raw.trim();
if (name === "") return null;
// サロゲートペア(絵文字など)を2文字と数えないよう、コードポイントで数える
if ([...name].length > USER_NAME_MAX_LENGTH) return null;
// 改行を含む制御文字は弾く。表示が崩れるうえ、名前として意味がない
if (/\p{Cc}/u.test(name)) return null;
return name;
}文字数の数え方だけ、少し気をつけました。
length で数えると絵文字が2文字になるので、 10文字のつもりが5文字しか入らない、ということが起きます。
名前の重複はオッケーです。
同じ名前のプレイヤーがいても、管理はIDなので。
ホームは起動時の入口
GET /user/home という名前にしましたが、 これはホーム画面のためのAPIというより、 起動したら誰もが最初に叩くものになります。
サインアップかセッション復帰が済んだら、まずこれを叩く。
返ってきた進捗を見て、名前入力に行くのかホームに行くのかが決まります。
名前もLvも所持金も、ここで全部返ってくる。
Webでいうと index に近い立ち位置ですね。
セッションが始まったときの状態取得、と言ったほうが実態に合っています。
返すものを並べるとこうなります。
Lv / 名前 / EXP / スタミナ / ゴールド / 素材 / ポーション
進捗
中央に立っているキャラ最初、所持ヒーローを全部返そうかと思いました。 ホームでキャラを表示するので。
ただホームに要るのは1体分だけなんですよね。
数百体持っている人のデータを毎回全部返す理由がない。
デッキも同じです。
複数持てる作りにしたので、全部返すと無駄が増える。
なのでサーバ側で1体に絞って返します。
json
"lead_hero": { "user_hero_id": 3, "hero_id": 11, "level": 30 }いま使っているデッキの先頭を引いて、それだけ返す。
ホームに立たせるキャラを別に選べる列も用意してありますが、 今はまだ設定する画面が無いので、デッキの先頭になります。
所持ヒーロー一覧やデッキの中身は、 それぞれの画面のAPIで返すという感じ。
引くときの条件に user_id も入れてあります。
sql
SELECT ... FROM `user_hero` WHERE `user_id` = ? AND `user_hero_id` = ?user_hero_id だけで一意に決まるので、 本来は user_id は要りません。
ただ他人の個体を指す値が入っていたときに引けてしまうんですよね。
外部キーを張らない方針なので、こういうところは自分で締めます。
画面ごとに必要なものを返すのが結局いちばん素直かなと。
入口のAPIだからといって、全部を詰め込む場所にはしない。
ここが太ると、起動のたびに重くなりますからね。
ちなみに今は所持ヒーローが0体なので、ここは null です。
スタミナ上限は返さない
stamina は返しますが、stamina_max は返しません。
上限は player_level_curve に入っていて、 そのマスタはクライアントにも配信済みです。
プレイヤーLvが分かれば、クライアント側で引けます。
8本目でマスタを配ったのは、こういうときのためです。
サーバが計算して渡すのではなく、 IDと数値だけ渡して、意味はクライアントが引く。
同じ理屈で、次のLvまでの必要EXPも返していません。
画面はほぼそのまま
3つとも移植です。
名前入力は、決定したときにAPIを叩くだけ。
プロトは「入力した名前は非永続」とコメントが書いてありました。
今回はサーバに送るので、そこだけ書き換えです。
プロローグは2.6秒待って次へ進むだけの画面ですね。
ホームは中身の繋ぎ替えが要ります。
プロトは全部を1つのオブジェクトから引いていたので、 ホームAPIの返り値に合わせ直しました。
HUDはゴールドが currencies、素材とポーションが items から来ます。
テーブルを分けたぶん、引く先が増えていますね。
一晩置いたら消えていた
動かそうとしたら、タイトルをタップした直後に弾かれました。
前の日にコンテナを止めていたので、 Redisに入っていたセッションが期限切れで消えていたんですね。
Done loading RDB, keys loaded: 0, keys expired: 36本目でやったとおりの挙動です。
消えても作り直せるものだけ置いてあるので、 ログインし直せば元に戻ります。
期限切れ自体は正常な動作なので、 クライアント側には9本目で復帰処理を入れてあります。
401が返ったらトークンを捨てて、取り直して、もう一度だけ試す。
今回足した GET /user/home も同じ扱いになっています。
動かす
ブラウザでアクセスします。




中央は「まだ仲間がいません」です。
10本目で決めたとおり、初期データにヒーローを入れていないので。
次回はここを埋めます。
今回はここまで
チュートリアルの進捗を user_status に1列足した
進捗の更新は、名前保存やホーム取得と同じトランザクションで
ホームAPIは起動時に必ず通る入口。ただし太らせない
返すヒーローはデッキ先頭の1体だけ
スタミナ上限はクライアントがマスタから引く
画面は3つとも移植
次回はガチャです。
【最後まで読んでいただきありがとうございます!】 面白かったと感じた方は、ぜひ「スキ」と「フォロー」をお願いします!
コード
今回の記事で作ったコードです、興味のある方はどうぞ。
routes/home.ts
import type { IncomingMessage, ServerResponse } from "node:http";
import type { PoolConnection, RowDataPacket } from "mysql2/promise";
import { withUserTransaction } from "../db.ts";
import { selectStatusForUpdate } from "../user/status.ts";
import type { UserStatus } from "../user/status.ts";
import { recoverStamina, staminaMaxOf } from "../user/stamina.ts";
import { formatUtc } from "../datetime.ts";
import {
DECK_LEAD_SLOT_NO,
HOME_USER_HERO_UNSET,
TUTORIAL_STEP,
} from "../constants.ts";
import { sendError, sendJson } from "../http.ts";
// GET /user/home は「ホーム画面のAPI」ではなく、セッション開始時の状態取得。
// クライアントは起動のたびにここを叩き、返ってきた tutorial_step で行き先を決める。
type LeadHero = {
user_hero_id: number;
hero_id: number;
level: number;
exp: number;
};
type HomeResponse = {
status: {
name: string;
player_lv: number;
player_exp: number;
stamina: number;
stamina_updated_at: string;
tutorial_step: number;
active_deck_id: number;
};
currencies: { currency_id: number; amount: number }[];
items: { item_id: number; amount: number }[];
lead_hero: LeadHero | null;
};
/** GET /user/home — 起動時の状態一式を返す */
export async function handleHome(
_req: IncomingMessage,
res: ServerResponse,
userId: number,
): Promise<void> {
const home = await withUserTransaction((conn) => loadHome(conn, userId, new Date()));
if (home === null) {
// セッションは生きているのに user_status がいない。通常は起きない
sendError(res, 401, "UNAUTHORIZED", "ユーザーが存在しない");
return;
}
sendJson(res, 200, home);
}
/**
* 状態を読み、進捗とスタミナを書き戻してから返す。
*
* スタミナは時間回復を「引くときに計算して書き戻す」方式なので、読むだけの入口でも更新が要る。
* 進捗もここで1段進むことがあるため、読みと書きを同じトランザクションに入れる
*/
async function loadHome(
conn: PoolConnection,
userId: number,
now: Date,
): Promise<HomeResponse | null> {
const status = await selectStatusForUpdate(conn, userId);
if (status === null) return null;
const stamina = recoverStamina(
status.stamina,
status.staminaUpdatedAt,
staminaMaxOf(status.playerLv),
now,
);
// プロローグを見た直後の1回だけ、ホーム到達として段を進める
const tutorialStep =
status.tutorialStep === TUTORIAL_STEP.PROLOGUE ? TUTORIAL_STEP.HOME : status.tutorialStep;
await conn.execute(
"UPDATE `user_status` SET `stamina` = ?, `stamina_updated_at` = ?, `tutorial_step` = ?" +
" WHERE `user_id` = ?",
[stamina.stamina, stamina.staminaUpdatedAt, tutorialStep, userId],
);
return {
status: {
name: status.name,
player_lv: status.playerLv,
player_exp: status.playerExp,
stamina: stamina.stamina,
stamina_updated_at: formatUtc(stamina.staminaUpdatedAt),
tutorial_step: tutorialStep,
active_deck_id: status.activeDeckId,
},
currencies: await selectCurrencies(conn, userId),
items: await selectItems(conn, userId),
lead_hero: await selectLeadHero(conn, userId, status),
};
}
/** 所持している通貨。0件なら空配列。持っていない種別の行は作らない */
async function selectCurrencies(
conn: PoolConnection,
userId: number,
): Promise<{ currency_id: number; amount: number }[]> {
const [rows] = await conn.execute<RowDataPacket[]>(
"SELECT `currency_id`, `amount` FROM `user_currency` WHERE `user_id` = ?" +
" ORDER BY `currency_id`",
[userId],
);
return rows.map((row) => ({
currency_id: Number(row.currency_id),
amount: Number(row.amount),
}));
}
/** 所持しているアイテム。0件なら空配列 */
async function selectItems(
conn: PoolConnection,
userId: number,
): Promise<{ item_id: number; amount: number }[]> {
const [rows] = await conn.execute<RowDataPacket[]>(
"SELECT `item_id`, `amount` FROM `user_item` WHERE `user_id` = ? ORDER BY `item_id`",
[userId],
);
return rows.map((row) => ({ item_id: Number(row.item_id), amount: Number(row.amount) }));
}
/**
* ホームに立たせる個体。
* 設定があればそれ、無ければ使用中デッキの先頭。どちらも無ければ null。
*
* 返すのは ID とレベルだけ。名前やステータスはクライアントがマスタから引く
*/
async function selectLeadHero(
conn: PoolConnection,
userId: number,
status: UserStatus,
): Promise<LeadHero | null> {
const userHeroId =
status.homeUserHeroId !== HOME_USER_HERO_UNSET
? status.homeUserHeroId
: await selectDeckLeadUserHeroId(conn, userId, status.activeDeckId);
if (userHeroId === null) return null;
// user_id も条件に入れる。他人の個体を指す値が入っていても引けないようにする
const [rows] = await conn.execute<RowDataPacket[]>(
"SELECT `user_hero_id`, `hero_id`, `level`, `exp` FROM `user_hero`" +
" WHERE `user_id` = ? AND `user_hero_id` = ?",
[userId, userHeroId],
);
const row = rows[0];
if (row === undefined) return null;
return {
user_hero_id: Number(row.user_hero_id),
hero_id: Number(row.hero_id),
level: Number(row.level),
exp: Number(row.exp),
};
}
/** 使用中デッキの先頭スロットに入っている個体。空きなら行が無いので null */
async function selectDeckLeadUserHeroId(
conn: PoolConnection,
userId: number,
deckId: number,
): Promise<number | null> {
const [rows] = await conn.execute<RowDataPacket[]>(
"SELECT `user_hero_id` FROM `user_deck`" +
" WHERE `user_id` = ? AND `deck_id` = ? AND `slot_no` = ?",
[userId, deckId, DECK_LEAD_SLOT_NO],
);
const row = rows[0];
return row === undefined ? null : Number(row.user_hero_id);
}
routes/user.ts
import type { IncomingMessage, ServerResponse } from "node:http";
import type { RowDataPacket } from "mysql2/promise";
import { userPool, withUserTransaction } from "../db.ts";
import { selectStatusForUpdate } from "../user/status.ts";
import { TUTORIAL_STEP, USER_NAME_MAX_LENGTH } from "../constants.ts";
import { readJsonBody, readStringField, sendError, sendJson } from "../http.ts";
/** GET /user/profile — 自分の情報を返す */
export async function handleProfile(
_req: IncomingMessage,
res: ServerResponse,
userId: number,
): Promise<void> {
const [rows] = await userPool.execute<RowDataPacket[]>(
"SELECT `id`, `name`, `created_at` FROM `user` WHERE `id` = ?",
[userId],
);
const row = rows[0];
if (row === undefined) {
// セッションは生きているのにユーザーがいない。通常は起きない
sendError(res, 401, "UNAUTHORIZED", "ユーザーが存在しない");
return;
}
sendJson(res, 200, {
user_id: Number(row.id),
name: row.name,
created_at: row.created_at,
});
}
/**
* 名前として受け付けられる形なら、整えた文字列を返す。駄目なら null。
* クライアントの maxLength は当てにしない。長さも中身もここで見る
*/
function normalizeUserName(raw: string): string | null {
const name = raw.trim();
if (name === "") return null;
// サロゲートペア(絵文字など)を2文字と数えないよう、コードポイントで数える
if ([...name].length > USER_NAME_MAX_LENGTH) return null;
// 改行を含む制御文字は弾く。表示が崩れるうえ、名前として意味がない
if (/\p{Cc}/u.test(name)) return null;
return name;
}
/**
* POST /user/name — 名前を保存する。
*
* 名前入力はチュートリアルの1段目でもあるので、名前と進捗を一緒に更新する。
* 2回目以降は名前変更として動かし、進捗は動かさない
*/
export async function handleUserName(
req: IncomingMessage,
res: ServerResponse,
userId: number,
): Promise<void> {
const raw = readStringField(await readJsonBody(req), "name");
if (raw === null) {
sendError(res, 400, "INVALID_REQUEST", "name は必須");
return;
}
const name = normalizeUserName(raw);
if (name === null) {
sendError(
res,
400,
"INVALID_NAME",
`名前は1〜${USER_NAME_MAX_LENGTH}文字。改行と制御文字は使えない`,
);
return;
}
const tutorialStep = await withUserTransaction(async (conn) => {
const status = await selectStatusForUpdate(conn, userId);
if (status === null) return null;
// 名前を入れ直しただけなら進捗は据え置く。段は前に戻さないし、飛ばさない
const next =
status.tutorialStep === TUTORIAL_STEP.NONE ? TUTORIAL_STEP.NAME : status.tutorialStep;
await conn.execute(
"UPDATE `user_status` SET `name` = ?, `tutorial_step` = ? WHERE `user_id` = ?",
[name, next, userId],
);
return next;
});
if (tutorialStep === null) {
sendError(res, 401, "UNAUTHORIZED", "ユーザーが存在しない");
return;
}
sendJson(res, 200, { name, tutorial_step: tutorialStep });
}
/**
* POST /user/tutorial/prologue — プロローグを見終わったことを記録する。
*
* 同じリクエストが2度届いても壊れないように、1段目のときだけ進める。
* それ以外は現在値を返すだけでエラーにしない(演出を最後まで見せた側を失敗にしない)
*/
export async function handleTutorialPrologue(
_req: IncomingMessage,
res: ServerResponse,
userId: number,
): Promise<void> {
const tutorialStep = await withUserTransaction(async (conn) => {
const status = await selectStatusForUpdate(conn, userId);
if (status === null) return null;
if (status.tutorialStep !== TUTORIAL_STEP.NAME) return status.tutorialStep;
await conn.execute("UPDATE `user_status` SET `tutorial_step` = ? WHERE `user_id` = ?", [
TUTORIAL_STEP.PROLOGUE,
userId,
]);
return TUTORIAL_STEP.PROLOGUE;
});
if (tutorialStep === null) {
sendError(res, 401, "UNAUTHORIZED", "ユーザーが存在しない");
return;
}
sendJson(res, 200, { tutorial_step: tutorialStep });
}
user/status.ts
import type { PoolConnection, RowDataPacket } from "mysql2/promise";
import { parseDateTime } from "../datetime.ts";
// user_status の読み方をここに閉じる。列名と型の変換を各ハンドラに書かない。
export type UserStatus = {
name: string;
playerLv: number;
playerExp: number;
stamina: number;
staminaUpdatedAt: Date;
tutorialStep: number;
activeDeckId: number;
homeUserHeroId: number;
};
/**
* user_status を1行読んで、書き換えが終わるまで他のトランザクションに触らせない。
* 行が無ければ null(通常は起きない。ユーザー作成時に必ず1行入れている)。
*
* 進捗もスタミナも「読んだ値を見て次の値を決める」ので、読んだ時点で行を押さえる
*/
export async function selectStatusForUpdate(
conn: PoolConnection,
userId: number,
): Promise<UserStatus | null> {
const [rows] = await conn.execute<RowDataPacket[]>(
"SELECT `name`, `player_lv`, `player_exp`, `stamina`, `stamina_updated_at`," +
" `tutorial_step`, `active_deck_id`, `home_user_hero_id`" +
" FROM `user_status` WHERE `user_id` = ? FOR UPDATE",
[userId],
);
const row = rows[0];
if (row === undefined) return null;
return {
name: String(row.name),
playerLv: Number(row.player_lv),
playerExp: Number(row.player_exp),
stamina: Number(row.stamina),
staminaUpdatedAt: parseDateTime(String(row.stamina_updated_at)),
tutorialStep: Number(row.tutorial_step),
activeDeckId: Number(row.active_deck_id),
homeUserHeroId: Number(row.home_user_hero_id),
};
}
index.ts
import { createServer } from "node:http";
import type { IncomingMessage, ServerResponse } from "node:http";
import { handlePrepare, handleSignup } from "./routes/auth.ts";
import { handleProfile, handleTutorialPrologue, handleUserName } from "./routes/user.ts";
import { handleHome } from "./routes/home.ts";
import { handleMaster } from "./routes/master.ts";
import { authenticate } from "./auth/session.ts";
import { master } from "./master/store.ts";
import { buildDeliveryPayload } from "./master/delivery.ts";
import { sendStaticFile } from "./static.ts";
import { sendError } from "./http.ts";
type Handler = (req: IncomingMessage, res: ServerResponse) => Promise<void>;
/** 認証を通ったハンドラ。user_id は解決済みで渡ってくる */
type AuthedHandler = (
req: IncomingMessage,
res: ServerResponse,
userId: number,
) => Promise<void>;
/**
* 認証が要るハンドラを包む。トークンから user_id を解決するのはここ1箇所だけ。
* ハンドラ側は「user_id は解決済み」の前提で書ける
*/
function authed(handler: AuthedHandler): Handler {
return async (req, res) => {
const userId = await authenticate(req);
if (userId === null) {
sendError(res, 401, "UNAUTHORIZED", "トークンが無効か、期限切れ");
return;
}
await handler(req, res, userId);
};
}
// ルーティングは「メソッド + パス」の完全一致で引く。
// パスにパラメータが必要になるまでは、これで足りる。
const routes: Record<string, Handler> = {
"POST /auth/prepare": handlePrepare,
"POST /auth/signup": handleSignup,
"GET /master": authed(handleMaster),
"GET /user/profile": authed(handleProfile),
"GET /user/home": authed(handleHome),
"POST /user/name": authed(handleUserName),
"POST /user/tutorial/prologue": authed(handleTutorialPrologue),
};
const port = Number(process.env.PORT ?? 3000);
/**
* ルート表を引き、無ければ静的ファイルを探す。
* どちらでもなければ 404 のJSON。POST はルート表に無い時点で 404 になる
*/
async function handleRequest(req: IncomingMessage, res: ServerResponse): Promise<void> {
const path = (req.url ?? "/").split("?")[0];
const handler = routes[`${req.method} ${path}`];
if (handler !== undefined) {
await handler(req, res);
return;
}
if (req.method === "GET" && (await sendStaticFile(res, path))) return;
sendError(res, 404, "NOT_FOUND", `${req.method} ${path} は存在しない`);
}
const server = createServer((req, res) => {
// ハンドラ内で投げられた例外はここで拾う。中身はクライアントに返さない
handleRequest(req, res).catch((error: unknown) => {
console.error(error);
if (res.headersSent) {
res.end();
return;
}
sendError(res, 500, "INTERNAL_ERROR", "サーバー内部エラー");
});
});
// マスタはリッスンを開始する前に読み込む。読み終わるまでリクエストは受けない。
// ここで失敗したらサーバを起動させない。マスタ無しで動かしても正しい応答は返せない
try {
await master.load();
buildDeliveryPayload();
} catch (error) {
console.error("[master] 読み込みに失敗した。起動を中止する");
console.error(error);
process.exit(1);
}
server.listen(port, () => {
console.log(`listening on http://localhost:${port}`);
});
App.tsx
// 起動シーケンス:タイトル →(タップ)→ サインアップ/マスタ取得 → GET /user/home。
// タップ前は一切通信しない。実際のソシャゲではこの間にメンテナンスチェックと
// マスタのバージョンチェックが入るが、今回は実装しない。
//
// 名前入力を出すかホームへ直行するかは、サーバが返す tutorial_step だけで決める。
// クライアントは「どこまで進んだか」を自分では覚えない。
import { useCallback, useState, type ReactNode } from 'react';
import { fetchToken } from './api/auth';
import { errorMessage, isUnauthorized } from './api/client';
import { fetchHome, postPrologueDone, postUserName, type HomeResponse } from './api/home';
import { TUTORIAL_STEP } from './constants';
import { buildMasterStore, fetchMaster, type MasterStore } from './master/store';
import { clearToken, loadOrCreateDeviceKey, loadToken, saveToken } from './storage/token';
import { TopBar, BottomNav } from './ui/Hud';
import { TitleScreen } from './ui/screens/TitleScreen';
import { LoadingScreen } from './ui/screens/LoadingScreen';
import { NameInputScreen } from './ui/screens/NameInputScreen';
import { IntroScreen } from './ui/screens/IntroScreen';
import { HomeScreen } from './ui/screens/HomeScreen';
/** 起動時に取れたもの一式。以後のAPIはこのトークンで叩く */
interface Session {
token: string;
master: MasterStore;
home: HomeResponse;
}
type Phase =
| { kind: 'title' }
| { kind: 'loading' }
| { kind: 'name'; session: Session }
| { kind: 'intro'; session: Session; name: string }
| { kind: 'home'; session: Session }
| { kind: 'error'; message: string };
/** 保存済みトークンがあればそれを使う。無ければサインアップして保存する */
async function prepareToken(deviceKey: string): Promise<string> {
const saved = loadToken();
if (saved !== null) return saved;
const token = await fetchToken(deviceKey);
saveToken(token);
return token;
}
/** マスタと起動時の状態を取る */
async function openSession(token: string): Promise<Session> {
const master = buildMasterStore(await fetchMaster(token));
return { token, master, home: await fetchHome(token) };
}
/**
* タップしてから行き先が決まるまでの通信一式。
*
* 401 が返るのは、保存していたトークンが期限切れか無効になったとき。
* その1回だけトークンを捨てて取り直す。2度目も駄目なら諦めてエラーにする
*/
async function boot(): Promise<Session> {
const deviceKey = loadOrCreateDeviceKey();
const token = await prepareToken(deviceKey);
try {
return await openSession(token);
} catch (error) {
if (!isUnauthorized(error)) throw error;
clearToken();
return openSession(await prepareToken(deviceKey));
}
}
export function App() {
const [phase, setPhase] = useState<Phase>({ kind: 'title' });
const fail = useCallback((error: unknown) => {
setPhase({ kind: 'error', message: errorMessage(error) });
}, []);
// 行き先を決めるのは tutorial_step だけ。ここに条件を増やさない
const enter = useCallback((session: Session) => {
const step = session.home.status.tutorial_step;
if (step === TUTORIAL_STEP.NONE) {
setPhase({ kind: 'name', session });
} else if (step === TUTORIAL_STEP.NAME) {
setPhase({ kind: 'intro', session, name: session.home.status.name });
} else {
setPhase({ kind: 'home', session });
}
}, []);
// タイトルのタップと、エラー画面の再試行ボタンの両方から呼ぶ
const start = useCallback(() => {
setPhase({ kind: 'loading' });
boot().then(enter, fail);
}, [enter, fail]);
/** 名前を保存してプロローグへ。失敗は入力画面側で拾わせるので、ここでは投げ直す */
const decideName = useCallback(async (session: Session, name: string) => {
const saved = await postUserName(session.token, name);
setPhase({ kind: 'intro', session, name: saved.name });
}, []);
/** プロローグ済みを記録してホームへ。進捗と名前が反映された状態で出すため取り直す */
const finishPrologue = useCallback(
(session: Session) => {
setPhase({ kind: 'loading' });
postPrologueDone(session.token)
.then(() => fetchHome(session.token))
.then((home) => setPhase({ kind: 'home', session: { ...session, home } }), fail);
},
[fail],
);
let body: ReactNode = null;
if (phase.kind === 'title') {
body = <TitleScreen onStart={start} />;
} else if (phase.kind === 'loading') {
body = <LoadingScreen message="接続中…" />;
} else if (phase.kind === 'name') {
const session = phase.session;
body = <NameInputScreen onDecide={(name) => decideName(session, name)} />;
} else if (phase.kind === 'intro') {
const session = phase.session;
body = <IntroScreen name={phase.name} onDone={() => finishPrologue(session)} />;
} else if (phase.kind === 'home') {
body = (
<>
<TopBar home={phase.session.home} master={phase.session.master} />
<HomeScreen home={phase.session.home} master={phase.session.master} />
<BottomNav current="home" />
</>
);
} else {
body = (
<div className="screenBody">
<div className="centerWrap">
<div className="panel bootError">
<div className="bootText">つうしんに失敗しました</div>
<div className="bootDetail">{phase.message}</div>
<button type="button" className="btnP" onClick={start}>
再試行
</button>
</div>
</div>
</div>
);
}
return (
<div className="app">
<div className="lightshaft" />
{body}
<div className="rotateOverlay">
<div>📱↻<br />横向きにしてあそんでね</div>
</div>
</div>
);
}
api/home.ts
// 起動時の状態取得と、チュートリアルの進捗更新。
import { apiGet, apiPost } from './client';
export interface HomeStatus {
name: string;
player_lv: number;
player_exp: number;
stamina: number;
/** UTC。"2026-09-13T12:34:56Z" */
stamina_updated_at: string;
tutorial_step: number;
active_deck_id: number;
}
/** ホームに立たせる個体。名前やステータスは来ないので、hero_id でマスタを引く */
export interface LeadHero {
user_hero_id: number;
hero_id: number;
level: number;
exp: number;
}
export interface HomeResponse {
status: HomeStatus;
currencies: { currency_id: number; amount: number }[];
items: { item_id: number; amount: number }[];
lead_hero: LeadHero | null;
}
/**
* GET /user/home。起動のたびに叩く入口。
* ホーム画面専用ではなく、行き先を決めるための状態取得
*/
export function fetchHome(token: string): Promise<HomeResponse> {
return apiGet<HomeResponse>('/user/home', token);
}
/** POST /user/name。初回はこれでチュートリアルが1段進む */
export function postUserName(
token: string,
name: string,
): Promise<{ name: string; tutorial_step: number }> {
return apiPost<{ name: string; tutorial_step: number }>('/user/name', { name }, token);
}
/** POST /user/tutorial/prologue。プロローグを見終わったことを記録する */
export function postPrologueDone(token: string): Promise<{ tutorial_step: number }> {
return apiPost<{ tutorial_step: number }>('/user/tutorial/prologue', {}, token);
}
/** 所持している通貨の量。行が無ければ 0 */
export function currencyAmount(home: HomeResponse, currencyId: number): number {
return home.currencies.find((row) => row.currency_id === currencyId)?.amount ?? 0;
}
/** 所持しているアイテムの数。行が無ければ 0 */
export function itemAmount(home: HomeResponse, itemId: number): number {
return home.items.find((row) => row.item_id === itemId)?.amount ?? 0;
}
ui/Hud.tsx
// 上部ステータスHUDと下部共通ナビ(常設)。プロトから移植。
// プロトはローカルの UserData を見ていたが、ここでは ホームAPI + マスタ から組み立てる。
import { currencyAmount, itemAmount, type HomeResponse } from '../api/home';
import { CURRENCY_ID, ITEM_ID } from '../constants';
import type { MasterStore } from '../master/store';
export type NavScreen = 'home' | 'gacha' | 'deck' | 'quest' | 'shop';
export function TopBar({ home, master }: { home: HomeResponse; master: MasterStore }) {
const status = home.status;
// スタミナ上限と次のLvまでのEXPはサーバが返さない。クライアントがマスタから引く
const curve = master.playerLevelCurveByLv.get(status.player_lv);
const staminaMax = curve?.stamina_max ?? 0;
const needExp = curve?.need_exp ?? 0;
const expRate = needExp === 0 ? 0 : Math.min(100, (status.player_exp / needExp) * 100);
return (
<div className="topbar">
<div className="pinfo panel">
<span className="lv">Lv.{status.player_lv}</span>
<span className="pname">{status.name}</span>
<div className="expmini">
<div className="bar"><i style={{ width: `${expRate}%` }} /></div>
<div className="num">EXP {status.player_exp}/{needExp}</div>
</div>
</div>
<div className="chips">
<div className="chip panel">⚡ <b>{status.stamina}</b>/{staminaMax}</div>
<div className="chip panel">🪙 <b>{currencyAmount(home, CURRENCY_ID.GOLD)}</b></div>
<div className="chip panel">🔨 <b>{itemAmount(home, ITEM_ID.MATERIAL)}</b></div>
<div className="chip panel">🧪 <b>{itemAmount(home, ITEM_ID.POTION)}</b></div>
</div>
</div>
);
}
const NAV_ITEMS: { id: NavScreen; icon: string; label: string }[] = [
{ id: 'home', icon: '🏠', label: 'ホーム' },
{ id: 'gacha', icon: '🎰', label: 'ガチャ' },
{ id: 'deck', icon: '🛡️', label: '編成' },
{ id: 'quest', icon: '⚔️', label: 'クエスト' },
{ id: 'shop', icon: '🛒', label: 'ショップ' },
];
/** 行き先の画面がまだ無いので、押しても何もしない。遷移は各画面を作るときに繋ぐ */
export function BottomNav({ current }: { current: NavScreen }) {
return (
<nav className="bottomnav">
{NAV_ITEMS.map((item) => (
<button key={item.id} type="button" className={`navitem ${current === item.id ? 'act' : ''}`}>
<span className="ni">{item.icon}</span>
{item.label}
</button>
))}
</nav>
);
}
user_status.sql
-- user_status : プレイヤーの現在の状態。user 1件につき1行
--
-- ここに置くのは「常に1つしかない値」だけ。数が増えるもの(通貨・ヒーロー・アイテム)は別テーブル。
-- user_id は `user`.`id` を指す。外部キーは張らない(整合性はアプリ側の責任)。
CREATE TABLE IF NOT EXISTS `user_status` (
`user_id` BIGINT NOT NULL,
`name` VARCHAR(32) NOT NULL,
`player_lv` INT NOT NULL DEFAULT 1,
`player_exp` INT NOT NULL DEFAULT 0,
-- 現在のスタミナ。上限(player_level_curve.stamina_max)を超えることがあるので、
-- ここでは上限を持たず、超過も素直に入れる
`stamina` INT NOT NULL,
-- 時間回復の起点。「最後に回復を計算した時刻」であって、最後に消費した時刻ではない
`stamina_updated_at` DATETIME NOT NULL,
-- チュートリアルの進捗。段の意味はコードの TUTORIAL_STEP に置く(マスタには入れない)
`tutorial_step` INT NOT NULL DEFAULT 0,
-- 使用中のデッキ番号。user_deck.deck_id を指す。deck_id は 1 始まり
`active_deck_id` INT NOT NULL DEFAULT 1,
-- ホームに表示するキャラ。user_hero.user_hero_id を指す。未設定は 0
`home_user_hero_id` BIGINT NOT NULL DEFAULT 0,
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;