- apps/server: Hono API(auth/me/config/admin), Bun WebSocket(welcome·ping/pong, 압축 끔), SQLite 마이그레이션 - 사이트 설정: 채팅 도배 방지 기본 꺼짐(관리자가 켬, 초당·순간 횟수) - apps/web: 첫 화면·로그인·관리자(대시보드·사이트·사용자·관리자·기록), 라이트/다크, 휴대폰, noindex - packages/shared: 닉네임 규칙, 프로토콜(zod), 시계 차이 계산 - 테스트 20개 + 브라우저 e2e 6단계 통과 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
159 lines
6.9 KiB
TypeScript
159 lines
6.9 KiB
TypeScript
/** Admin API (docs/02 관리자 페이지). Mounted under /api/admin. Ported from joke-app (rooms/games parts come later). */
|
|
import { Hono, type Context } from 'hono';
|
|
import { z } from 'zod';
|
|
import { nicknameError, normalizeNickname, type Role } from '@mq/shared';
|
|
import type { Audit, Roles } from '../admin/roles';
|
|
import { SiteSettingsSchema, type SettingsStore } from '../admin/settings';
|
|
import type { Sessions } from '../auth/sessions';
|
|
import { toPublicUser, type Users } from '../auth/users';
|
|
|
|
export interface AdminDeps {
|
|
users: Users;
|
|
sessions: Sessions;
|
|
roles: Roles;
|
|
audit: Audit;
|
|
settings: SettingsStore;
|
|
disconnectUser: (userId: string) => void;
|
|
stats: () => Record<string, unknown>;
|
|
}
|
|
|
|
type Env = { Variables: { userId: string | null; role: Role } };
|
|
|
|
const DISCORD_ID = /^\d{17,20}$/;
|
|
|
|
export function createAdminApp(d: AdminDeps) {
|
|
const app = new Hono<Env>();
|
|
|
|
app.use('*', async (c, next) => {
|
|
const role = d.roles.roleOf(c.get('userId'));
|
|
if (role === 'user') return c.json({ error: '권한이 없어요.' }, c.get('userId') ? 403 : 401);
|
|
c.set('role', role);
|
|
await next();
|
|
});
|
|
|
|
const superOnly = async (c: Context<Env>, next: () => Promise<void>) => {
|
|
if (c.get('role') !== 'superadmin') return c.json({ error: '슈퍼어드민만 할 수 있어요.' }, 403);
|
|
await next();
|
|
};
|
|
const actor = (c: Context<Env>) => c.get('userId')!;
|
|
const body = async (c: Context<Env>) => c.req.json().catch(() => null);
|
|
|
|
app.get('/me', (c) => c.json({ role: c.get('role'), me: toPublicUser(d.users.get(actor(c))!) }));
|
|
|
|
app.get('/overview', (c) => c.json({ users: d.users.counts(), ...d.stats() }));
|
|
|
|
// ------------------------------------------------------------ site
|
|
app.get('/site', (c) => c.json({ site: d.settings.getSite() }));
|
|
app.put('/site', async (c) => {
|
|
const parsed = SiteSettingsSchema.safeParse(await body(c));
|
|
if (!parsed.success) return c.json({ error: `입력 값이 올바르지 않아요: ${parsed.error.issues.map((i) => i.path.join('.')).join(', ')}` }, 400);
|
|
const before = d.settings.getSite();
|
|
d.settings.setSite(parsed.data, actor(c));
|
|
d.audit.log(actor(c), 'site.update', null, before, parsed.data);
|
|
return c.json({ site: parsed.data });
|
|
});
|
|
|
|
// ------------------------------------------------------------ audit
|
|
app.get('/audit', (c) => {
|
|
const page = Math.max(0, Number(c.req.query('page') ?? 0) || 0);
|
|
return c.json({ entries: d.audit.list(50, page * 50) });
|
|
});
|
|
|
|
// ------------------------------------------------------------ users (superadmin)
|
|
app.use('/users/*', superOnly);
|
|
app.use('/users', superOnly);
|
|
app.get('/users', (c) => {
|
|
const q = (c.req.query('q') ?? '').trim().slice(0, 60);
|
|
const page = Math.max(0, Number(c.req.query('page') ?? 0) || 0);
|
|
const { rows, total } = d.users.search(q, 30, page * 30);
|
|
return c.json({
|
|
total,
|
|
users: rows.map((u) => ({
|
|
id: u.id,
|
|
nickname: u.nickname,
|
|
kind: u.kind,
|
|
discordId: u.discord_id,
|
|
discordName: u.discord_name,
|
|
role: d.roles.roleOfDiscord(u.discord_id),
|
|
banned: u.banned_at ? { at: u.banned_at, reason: u.banned_reason } : null,
|
|
createdAt: u.created_at,
|
|
lastSeenAt: u.last_seen_at,
|
|
})),
|
|
});
|
|
});
|
|
|
|
app.patch('/users/:id', async (c) => {
|
|
const id = c.req.param('id');
|
|
const u = d.users.get(id);
|
|
if (!u) return c.json({ error: '사용자를 찾을 수 없어요.' }, 404);
|
|
const parsed = z
|
|
.object({ nickname: z.string().max(100).optional(), ban: z.object({ reason: z.string().trim().min(1).max(200) }).nullable().optional() })
|
|
.safeParse(await body(c));
|
|
if (!parsed.success) return c.json({ error: '입력 값이 올바르지 않아요.' }, 400);
|
|
const discordId = d.roles.discordIdOf(id);
|
|
if (parsed.data.ban && discordId && d.roles.isSuperadminDiscord(discordId)) return c.json({ error: '슈퍼어드민은 제한할 수 없어요.' }, 400);
|
|
if (parsed.data.nickname !== undefined) {
|
|
const nick = normalizeNickname(parsed.data.nickname);
|
|
const e = nicknameError(nick, d.settings.getSite().bannedWords);
|
|
if (e) return c.json({ error: e }, 400);
|
|
d.users.forceNickname(id, nick);
|
|
d.audit.log(actor(c), 'user.rename', id, u.nickname, nick);
|
|
}
|
|
if (parsed.data.ban !== undefined) {
|
|
if (parsed.data.ban) {
|
|
d.users.setBan(id, parsed.data.ban.reason);
|
|
d.sessions.revokeAll(id);
|
|
d.disconnectUser(id);
|
|
d.audit.log(actor(c), 'user.ban', id, null, parsed.data.ban);
|
|
} else {
|
|
d.users.setBan(id, null);
|
|
d.audit.log(actor(c), 'user.unban', id, { reason: u.banned_reason }, null);
|
|
}
|
|
}
|
|
return c.json({ ok: true });
|
|
});
|
|
|
|
app.post('/users/:id/logout', (c) => {
|
|
const id = c.req.param('id');
|
|
if (!d.users.get(id)) return c.json({ error: '사용자를 찾을 수 없어요.' }, 404);
|
|
d.sessions.revokeAll(id);
|
|
d.disconnectUser(id);
|
|
d.audit.log(actor(c), 'user.logout', id, null, null);
|
|
return c.json({ ok: true });
|
|
});
|
|
|
|
app.delete('/users/:id', (c) => {
|
|
const id = c.req.param('id');
|
|
const u = d.users.get(id);
|
|
if (!u) return c.json({ error: '사용자를 찾을 수 없어요.' }, 404);
|
|
const discordId = d.roles.discordIdOf(id);
|
|
if (discordId && d.roles.isSuperadminDiscord(discordId)) return c.json({ error: '슈퍼어드민은 삭제할 수 없어요.' }, 400);
|
|
d.disconnectUser(id);
|
|
d.users.softDelete(id);
|
|
d.audit.log(actor(c), 'user.delete', id, { nickname: u.nickname, discordId }, null);
|
|
return c.json({ ok: true });
|
|
});
|
|
|
|
// ------------------------------------------------------------ admins (superadmin)
|
|
app.use('/admins/*', superOnly);
|
|
app.use('/admins', superOnly);
|
|
app.get('/admins', (c) => c.json({ admins: d.roles.listAdmins() }));
|
|
app.post('/admins', async (c) => {
|
|
const parsed = z.object({ discordId: z.string().trim(), note: z.string().trim().max(100).optional() }).safeParse(await body(c));
|
|
if (!parsed.success || !DISCORD_ID.test(parsed.data.discordId)) return c.json({ error: '디스코드 ID는 숫자 17~20자리예요.' }, 400);
|
|
if (d.roles.isSuperadminDiscord(parsed.data.discordId)) return c.json({ error: '이미 슈퍼어드민이에요.' }, 400);
|
|
if (!d.roles.addAdmin(parsed.data.discordId, parsed.data.note ?? null, actor(c))) return c.json({ error: '이미 등록된 관리자예요.' }, 400);
|
|
d.audit.log(actor(c), 'admin.add', parsed.data.discordId, null, { note: parsed.data.note ?? null });
|
|
return c.json({ admins: d.roles.listAdmins() });
|
|
});
|
|
app.delete('/admins/:discordId', (c) => {
|
|
const id = c.req.param('discordId');
|
|
if (d.roles.isSuperadminDiscord(id)) return c.json({ error: '설정 파일의 슈퍼어드민은 지울 수 없어요.' }, 400);
|
|
if (!d.roles.removeAdmin(id)) return c.json({ error: '등록되지 않은 디스코드 ID예요.' }, 404);
|
|
d.audit.log(actor(c), 'admin.remove', id, null, null);
|
|
return c.json({ admins: d.roles.listAdmins() });
|
|
});
|
|
|
|
return app;
|
|
}
|