系統分析與設計規格書 ｜ MMO GM Console (遊戲管理)

MMO GM Console

系統分析與設計規格書

遊戲管理（Game Console）

目錄

目錄 ........................................................................................................................................................................................ 2

文件更新記錄 ...................................................................................................................................................................... 6

1 文件範圍 ........................................................................................................................................................................ 6

2 業務需求摘要 ............................................................................................................................................................... 6

3 功能需求清單 ............................................................................................................................................................... 7

4 系統架構與共用設定 .................................................................................................................................................. 7

4.1 系統架構 ............................................................................................................................................................ 7

4.2 資料來源與連線取得 ...................................................................................................................................... 8

4.3 權限..................................................................................................................................................................... 9

4.4 查詢與分頁 ....................................................................................................................................................... 9

4.5 彈窗與參數傳遞............................................................................................................................................... 9

4.6 訊息顯示 ......................................................................................................................................................... 10

5 畫面與流程 ................................................................................................................................................................. 11

5.1 帳號管理（AccountManage） .............................................................................................................. 11

5.1.1 頁面顯示邏輯 .................................................................................................................................... 12

5.1.2 查詢邏輯............................................................................................................................................. 12

5.1.3 增加點數............................................................................................................................................. 13

5.1.4 修改密碼............................................................................................................................................. 15

5.1.5 停權帳號............................................................................................................................................. 16

5.1.6 復權帳號............................................................................................................................................. 18

5.1.7 介面清單............................................................................................................................................. 18

5.1.8 訊息一覽............................................................................................................................................. 19

5.2 角色管理（PlayerManage）................................................................................................................... 20

5.2.1 頁面顯示邏輯 .................................................................................................................................... 20

5.2.2 查詢邏輯............................................................................................................................................. 20

5.2.3 唯讀檢視............................................................................................................................................. 20

5.2.4 給予物品............................................................................................................................................. 21

5.2.5 角色改名............................................................................................................................................. 22

5.2.6 介面與訊息 ........................................................................................................................................ 23

5.3 公會管理（GuildManage） .................................................................................................................... 25

5.3.1 頁面顯示邏輯與查詢....................................................................................................................... 25

5.3.2 公會資料............................................................................................................................................. 25

5.3.3 成員清單............................................................................................................................................. 26

5.3.4 公會銀行............................................................................................................................................. 26

5.3.5 介面與訊息 ........................................................................................................................................ 26

5.4 GM 帳號管理（GameMasterManage） ............................................................................................ 27

5.4.1 頁面顯示邏輯與查詢....................................................................................................................... 27

5.4.2 新增與修改 ........................................................................................................................................ 27

5.4.3 介面與訊息 ........................................................................................................................................ 28

5.5 GM 頻道訊息（GameMasterChannel） ............................................................................................ 30

5.5.1 頁面顯示邏輯與查詢....................................................................................................................... 30

5.5.2 編輯訊息............................................................................................................................................. 30

5.5.3 批次改狀態 ........................................................................................................................................ 31

5.5.4 介面與訊息 ........................................................................................................................................ 31

5.6 批次封鎖（BatchBanned） ..................................................................................................................... 32

5.6.1 頁面顯示邏輯與查詢....................................................................................................................... 32

5.6.2 驗證邏輯............................................................................................................................................. 32

5.6.3 寫入資料邏輯 .................................................................................................................................... 33

5.6.4 介面與訊息 ........................................................................................................................................ 33

5.7 伺服器補償物品（CompensateItem）................................................................................................ 34

5.7.1 頁面顯示邏輯 .................................................................................................................................... 34

5.7.2 查詢對象筆數 .................................................................................................................................... 34

5.7.3 發送補償............................................................................................................................................. 34

5.7.4 介面與訊息 ........................................................................................................................................ 35

5.8 物品管理（ItemManage） ...................................................................................................................... 36

5.8.1 頁面顯示邏輯與查詢....................................................................................................................... 36

5.8.2 新增與修改 ........................................................................................................................................ 37

5.8.3 介面與訊息 ........................................................................................................................................ 38

5.9 物品主類別管理（ItemType01Manage）.......................................................................................... 39

5.9.1 頁面顯示邏輯與查詢....................................................................................................................... 39

5.9.2 新增與修改 ........................................................................................................................................ 39

5.10 物品次類別管理（ItemType02Manage） ....................................................................................... 41

5.10.1 頁面顯示邏輯與查詢 .................................................................................................................... 41

5.10.2 新增與修改...................................................................................................................................... 41

5.11 物品旗標管理（ItemFlagManage） .................................................................................................. 43

5.11.1 頁面顯示邏輯與查詢 .................................................................................................................... 43

5.11.2 新增與修改...................................................................................................................................... 43

5.12 活動付費管理（EventPayTotalManage） ....................................................................................... 45

5.12.1 頁面顯示邏輯與驗證 .................................................................................................................... 45

5.12.2 寫入資料邏輯 ................................................................................................................................. 45

5.13 登入管理（LoginManage） ................................................................................................................. 46

5.13.1 頁面顯示邏輯與查詢 .................................................................................................................... 46

5.13.2 解除帳號卡登 ................................................................................................................................. 46

5.14 跑馬燈排程（MarqueeScheduleManage） ................................................................................... 48

5.14.1 頁面顯示邏輯與查詢 .................................................................................................................... 48

5.14.2 新增與修改...................................................................................................................................... 48

5.14.3 介面 ................................................................................................................................................... 49

6 資料存取對象 ............................................................................................................................................................ 50

6.1 主庫（MySQL） .......................................................................................................................................... 50

6.2 遊戲庫（依區服） ....................................................................................................................................... 50

6.3 名稱庫（MySQL，依區服） .................................................................................................................... 51

7 業務規則與驗證 ........................................................................................................................................................ 51

8 例外處理 ..................................................................................................................................................................... 52

9 使用者與權限 ............................................................................................................................................................ 52

10 非功能需求 .............................................................................................................................................................. 52

文件更新記錄

版本

日期

修改人

修改事項

0.1

2026-09-11

—

初稿：系統總綱與帳號管理模組（規約導向，已改版）

0.2

2026-09-13

—

改為畫面驅動之實作規格，涵蓋遊戲管理區 14 支功能頁；開

發守則與現況落差清單移至另一份文件

1

文件範圍

本文件描述 MMO GM Console 後台「遊戲管理」功能區的系統分析與設計，供開發、測試與驗收使

用。內容以畫面為單位展開：每個功能頁先呈現畫面，再依序說明頁面顯示邏輯、查詢邏輯、驗證邏

輯與資料寫入邏輯，並標明所涉及的資料表、欄位與對使用者顯示的訊息。

項目

內容

涵蓋

遊戲管理功能區（Areas/GameManage）的全部功能頁，共 14 支

涵蓋

上述頁面所使用的共用機制：伺服器連線取得、權限、分頁、彈窗與訊息

不涵蓋

YiSha 框架原生功能（使用者、部門、角色權限、選單、字典、排程、代碼生成）

不涵蓋

數據統計、資料查詢、CCU 監控等其他客製功能區（另行撰寫）

不涵蓋

遊戲伺服器本體的程式與資料庫設計，視為外部系統

另見

《MMO GM Console 開發守則與現況落差清單》：開發規約、命名規則、交付清單，以及

現行程式與本規格不一致之處

文件中的畫面均為示意圖，依實際頁面版型與欄位重製，用於標示欄位位置與狀態，不代表實際資料。

2

業務需求摘要

遊戲營運團隊在日常維運中需要對玩家資料進行查詢與處置。這些操作原本必須由工程人員直接對遊

戲資料庫下指令，既無權限控管也無稽核軌跡。遊戲管理功能區將這些操作收斂為後台頁面，由權限

控管、留下紀錄，並確保寫入一律經由遊戲端提供的程序。

需求

說明

對應功能

帳號處置

查詢玩家帳號，協助補點、改密碼、停權與解權

帳號管理、批次封鎖

角色資料查詢

查詢角色的基本資料、職業、技能、好友、身上與

角色管理

倉庫物品

公會查詢

查詢公會資訊、成員與公會倉庫

公會管理

GM 管理

維護 GM 帳號與其可用頻道

GM 帳號管理、GM 頻道訊息

物品維護

維護物品資料與其分類、旗標設定

物品管理、物品主／次類別、物品旗

標

需求

說明

對應功能

營運操作

補償發放、活動付費管理、登入管理、跑馬燈排程

補償物品、活動付費管理、登入管

理、跑馬燈排程

所有操作皆以區服為單位：使用者必須先指定要操作的遊戲區服，系統才會連線至該區服的資料庫執

行。

3

功能需求清單

遊戲管理功能區的功能頁一覽。詳細規格見第 5 章對應小節。

編號

功能頁

路由

說明

章節

GM-01

帳號管理

AccountManage

查詢玩家帳號並進行補點、改密碼、停權、

5.1

復權

角色管理

PlayerManage

GM-03

公會管理

GuildManage

查詢公會資訊、成員與公會倉庫

5.3

GM-04

GM 帳號管理

GameMasterManage

維護 GM 帳號

5.4

GM-05

GM 頻道訊息

GameMasterChannel

維護 GM 可用的頻道設定

5.5

GM-06

批次封鎖

BatchBanned

一次對多個帳號執行封鎖

5.6

GM-07

伺服器補償物品

CompensateItem

對指定對象發放補償物品

5.7

GM-08

物品管理

ItemManage

維護物品資料

5.8

GM-09

物品主類別管理

ItemType01Manage

維護物品主分類

5.9

GM-10

物品次類別管理

ItemType02Manage

維護物品次分類

5.10

GM-11

物品旗標管理

ItemFlagManage

維護物品旗標

5.11

GM-12

活動付費管理

查詢與管理活動付費總額

5.12

GM-13

登入管理

EventPayTotalManag

e

LoginManage

查詢與管理玩家登入狀態

5.13

MarqueeScheduleMan

age

設定遊戲內跑馬燈的播放排程

5.14

GM-02

查詢角色資料、職業技能、物品與好友，並

5.2

可給予物品

GM-14

跑馬燈排程

4

系統架構與共用設定

4.1

系統架構

圖 4.1-1

分層架構與資料流向

頁面（View）以 AJAX 呼叫控制器（Controller），控制器將參數交給業務層（BLL），業務層補上操

作者資訊後交由服務層（Service）組出 SQL 並選定目標資料庫，最後由資料層建立連線執行。回傳一

律為統一的結果物件。

4.2

資料來源與連線取得

圖 4.2-1

資料來源與連線取得方式

資料來源

型別

連線字串來源

內容

主庫

MySQL

appsettings.json

選單與權限、使用者、伺服器連線設定

（server_config）、客製維護表

遊戲庫

SQL Server

主庫

玩家帳號、角色、物品、公會等遊戲資料

server_config.conn_str

ing

名稱庫

MySQL

主庫

跨服指令佇列（cmd_queue），例如踢線指令

server_config.conn_str

ing

取得跨庫連線的固定流程：畫面只送區服編號 → 後端以該編號向主庫查 server_config 取得連線字串

→ 以連線字串建立對應型別的 Repository → 執行查詢或寫入。連線字串不經前端傳遞。

var server = await serverService.GetEntity(param.ServerList);

var repo

var list

// 主庫

= this.ServerRepository(server.conn_string, "SqlServer");

= await repo.FindList(sql, parameters);

每一次查詢都必須自行建立 Repository：查詢方法在執行後會關閉連線，同一個 Repository 連續查

兩次，第二次會失敗。

權限

4.3

圖 4.3-1

權限判定流程

每個 Action 以權限碼標註，登入者的角色透過選單資料取得被授權的權限碼，兩者比對後決定放行。

系統管理者略過比對。權限碼格式為 {功能區}:{功能代號}:{動作}；本文件各節的「介面」表格即列出

該功能所需的權限碼。

查詢與分頁

4.4

清單頁一律採伺服器端分頁。前端表格送出的參數與後端接收的欄位對應如下：

前端送出

後端欄位

說明

limit

PageSize

每頁筆數

offset

PageIndex

換算後的頁碼，自 1 起算

sort

Sort

排序欄位，須為資料庫實際欄位

order

SortType

asc 或 desc

回傳格式固定如下，前端以 Tag 判定成敗、以 Total 與 Data 繪製表格：

欄位

型別

意義

Tag

整數

1 表示成功，其餘表示失敗

Message

字串

顯示給使用者的訊息；成功時未填則前端顯示「操作成功」

Total

整數

資料總筆數，非分頁查詢為 0

Data

物件／陣列

資料內容

彈窗與參數傳遞

4.5

清單頁的操作按鈕以彈窗開啟子頁，子頁以 iframe 載入，資料的識別資訊透過查詢字串帶入，子頁不

再重新查詢。子頁按下確定時，由父頁呼叫子頁的送出函式，成功後父頁重新整理表格並關閉彈窗。

ys.openDialog({

title: "增加點數：" + row.login_name,

content: "…/AccountManageAddPoint?id=" + row.member_id

+ "&ServerList=" + serverList + "&account=" + row.login_name,

callback: function (index, layero) { /* 呼叫子頁 saveForm */ }

});

4.6

訊息顯示

訊息以浮動提示呈現，分成功與失敗兩種樣式；表單欄位的驗證訊息則直接顯示於欄位下方。

圖 4.6-1

成功提示

圖 4.6-2

失敗提示

5

畫面與流程

本章每一小節對應一支功能頁。各小節先呈現畫面，再依序說明頁面顯示邏輯、查詢邏輯，以及各項

操作的顯示、驗證與寫入邏輯。

5.1

帳號管理（AccountManage）

提供 GM 與客服查詢玩家帳號，並執行增加點數、修改密碼、停權與復權四項處置。玩家資料位於各

區服的遊戲庫，因此所有操作都必須先指定伺服器。