Bản đồ kỹ thuật

flowchart TB
accTitle: Bản đồ hệ thống website hiện tại
accDescr: Trình duyệt đọc trang tĩnh, trang SSR hoặc API công việc. Trang SSR và API dùng repository để đọc dữ liệu cục bộ.
browser["Trình duyệt"]
staticPages["Trang tĩnh Astro"]
ssrPages["Trang SSR Astro"]
ticketApi["API công việc · chỉ GET"]
ticketRepo["Repository công việc"]
teamRepo["Repository thành viên"]
ticketData[("Dữ liệu công việc cục bộ")]
teamData[("Danh mục và hoạt động thành viên")]
browser -->|"Đọc trang"| staticPages
browser -->|"Đọc trang"| ssrPages
browser -->|"Gọi GET"| ticketApi
ssrPages --> ticketRepo
ssrPages --> teamRepo
ticketApi --> ticketRepo
ticketRepo --> ticketData
teamRepo --> teamData

sequenceDiagram
accTitle: API đọc một công việc theo ID
accDescr: API kiểm định dạng ID, tra cứu repository và trả lỗi 400, lỗi 404 hoặc dữ liệu công khai 200.
participant client as Bên gọi
participant api as API công việc
participant repo as Repository
client->>api: GET /api/tickets/{id}
alt ID sai định dạng
api-->>client: 400 · invalid_id
else ID hợp lệ
api->>repo: get(id)
repo-->>api: Bản ghi hoặc null
alt Không tìm thấy
api-->>client: 404 · not_found
else Có bản ghi
api->>api: Chọn trường công khai
api-->>client: 200 · ticket
end
end

sequenceDiagram
accTitle: API phân trang danh sách công việc
accDescr: Repository kiểm tra dự án, giới hạn và con trỏ, sau đó trả danh sách công khai cùng con trỏ kế tiếp.
participant client as Bên gọi
participant api as API công việc
participant repo as Repository
Note over client,api: gameId=vo, limit=20
client->>api: GET /api/tickets
api->>repo: list(gameId, limit, after)
alt Truy vấn hoặc con trỏ không hợp lệ
repo-->>api: InvalidTicketQuery
api-->>client: 400 · invalid_query
else Hợp lệ
repo-->>api: items và nextCursor
api->>api: Chọn trường công khai của từng mục
api-->>client: 200 · items và nextCursor
opt nextCursor khác null
client->>api: GET cùng gameId, after=nextCursor
api->>repo: Đọc trang tiếp
repo-->>api: items và nextCursor mới
api-->>client: 200 · trường công khai
end
end