Skip to Content

Dashboard

Dashboard cho người dùng ở mỗi vai trò thấy ngay việc cần làm và vài con số chính. Dựng trang bằng StatRow, ProCard, ProList và biểu đồ của @ant-design/charts.

Đây là trang đầu tiên sau khi đăng nhập. Người duyệt cần biết còn bao nhiêu đề xuất chờ mình và cái nào sắp tới hạn. Nhân viên cần biết đề xuất của mình đang ở bước nào. Mỗi con số có một dòng phụ, còn danh sách việc cần làm là phần chính của trang.

DashboardDashboard người duyệt: StatisticCard.Group (mỗi số có dòng phụ) + danh sách việc cần làm (Listy) + biểu đồ donut.
ví-dụ.manh.run · dữ liệu mẫuMở để sửa ↗
Ví dụ chạy khi bạn cuộn tới

Bố cục trang

Trang gồm các khối xếp dọc, thẳng hàng ở mép trái và mép phải:

PageContainer lời chào · số việc chờ · một nút chính └── Flex vertical gap={16} ├── StatRow 3–4 số KPI, mỗi số một dòng phụ └── Row gutter={[16, 16]} ├── Col lg={15} ProCard "Cần tôi duyệt" → ProList └── Col lg={9} ProCard "Theo hạng mục" → Pie

Đầu trang cho biết việc cần làm

title là lời chào, subTitle là số việc đang chờ, extra là một nút dẫn tới việc đó.

app/page.tsx
<PageContainer title={`Chào buổi sáng, ${user.name}`} subTitle={manager ? `${s?.pending ?? "…"} đề xuất đang chờ bạn duyệt` : "Đề xuất mua sắm của bạn"} extra={<Button type="primary" onClick={() => nav("/requests")}>Mở hộp duyệt</Button>} > {/* … */} </PageContainer>

Hàng KPI có dòng phụ

StatRow từ manh/shell hiện mỗi con số một ô, bốn ô một hàng trên máy tính và 2 × 2 trên điện thoại. description là dòng phụ: so với kỳ trước, giá trị tiền hoặc số lượng. Con số đứng một mình trông như trang chưa làm xong.

app/page.tsx
<StatRow loading={!s} items={[ { title: "Đang chờ duyệt", value: s?.pending ?? 0, status: "processing", description: `Giá trị ${vndShort(s?.pendingAmount ?? 0)}`, onClick: () => nav("/requests") }, { title: "Đã duyệt tháng này", value: vndShort(cur), description: "Tăng 12% so với tháng trước", chart: <Tiny.Area height={46} data={series} /> }, ]} />
  • Tối đa 3–4 số. Nhiều hơn thì người xem không biết nên nhìn vào đâu.
  • onClick đưa người xem tới danh sách đứng sau con số đó. Mục false hay null được bỏ qua, tiện cho số chỉ một vai trò được thấy.

Việc cần làm và biểu đồ cạnh nhau

Chia cột bằng Row gutter + Col để thẻ thẳng mép với hàng KPI phía trên. Danh sách việc xếp theo hạn, việc gần hạn nhất lên đầu, mục quá hạn tô màu danger.

app/page.tsx
<Row gutter={[16, 16]}> <Col xs={24} lg={15}> <ProCard title="Cần tôi duyệt" subTitle="gần hạn trước" headerBordered extra={<a onClick={() => nav("/requests")}>Xem tất cả</a>} style={{ height: "100%" }}> <ProList<Request> rowKey="id" split dataSource={rows} onItem={(r) => ({ onClick: () => nav(`/requests/${r.id}`) })} locale={{ emptyText: <Empty description="Không còn đề xuất nào chờ duyệt." /> }} metas={{ avatar: { render: (_, r) => <Avatar>{r.creatorName?.[0]}</Avatar> }, title: { dataIndex: "title" }, description: { render: (_, r) => <Space>{r.creatorName}<span>{CATEGORY[r.category]}</span><Due r={r} /></Space> }, actions: { render: (_, r) => [<b key="amt">{vnd(r.amount)}</b>] }, }} /> </ProCard> </Col> <Col xs={24} lg={9}> <ProCard title="Theo hạng mục" headerBordered style={{ height: "100%" }}> <Pie data={byCategory} angleField="value" colorField="type" innerRadius={0.62} label={false} height={280} tooltip={{ items: [{ field: "value", valueFormatter: (v: number) => vnd(v) }] }} /> </ProCard> </Col> </Row>

Chọn biểu đồ theo điều cần xem

  • Xu hướng theo thời gian → Line / Area.
  • So sánh nhóm → Column / Bar.
  • Tỷ trọng, tối đa 6 phần → Pie có innerRadius.
  • Mục tiêu so với thực tế → Progress / Gauge / Liquid.
  • Hai đại lượng, hai thang → DualAxes.
  • Số nhỏ trong thẻ KPI → Tiny.Area, Tiny.Column.

Đặt mỗi biểu đồ trong một ProCard có tiêu đề, ghi đơn vị trong tooltip hoặc nhãn trục.

Cần biết

  • trend="up" tô đỏ, "down" tô xanh (quy ước thị trường Trung Quốc). App cho người Việt nên ghi bằng chữ (“tăng 12%”) hoặc tự tô màu bằng token.
  • Không dùng ProCard gutter để chia cột vì thẻ sẽ thụt vào khoảng 8px so với hàng KPI.
  • Đặt height và autoFit cho mọi biểu đồ để biểu đồ vừa với thẻ.

Biến thể

Dashboard điều hành. Đổi kỳ là mọi con số đổi theo. Trang có biểu đồ doanh thu và lợi nhuận, tỷ trọng kênh bán, sản phẩm bán chạy và hàng tồn cần chú ý.

Dashboard điều hành (bán lẻ đa kênh)Dashboard của chủ cửa hàng nội thất 3 kênh: chọn kỳ (hôm nay / 7 ngày / tháng / 12 tháng) đổi mọi con số, 4 KPI có so sánh kỳ trước, biểu đồ doanh thu – lợi nhuận, tỷ trọng kênh, sản phẩm bán chạy, việc cần xử lý và tồn kho cảnh báo.
ví-dụ.manh.run · dữ liệu mẫuMở để sửa ↗
Ví dụ chạy khi bạn cuộn tới

Bước tiếp theo

Cập nhật