Skip to Content

Sơ đồ, kanban, AI chat

Những màn hình không phải bảng hay form, như sửa quy trình bằng sơ đồ, xem sơ đồ tổ chức, kéo thả kanban và khung chat AI, dựng bằng các thư viện có sẵn trong app.

Bốn thư viện @xyflow/react, @ant-design/graphs, @dnd-kit/*, @ant-design/x có sẵn trong app: import là dùng được, không phải cài. Mỗi ví dụ là một file app/page.tsx đầy đủ để bạn chép về làm điểm bắt đầu: sửa quy trình duyệt, sơ đồ tổ chức, kanban đơn hàng, trợ lý AI.

Lối tắt: block_add("ai-assistant") thêm trợ lý AI cùng phần server: file agent *.agent.ts, lưu hội thoại, gọi công cụ trên dữ liệu thật của app, từng bước hiện ngay trên màn hình, việc thay đổi dữ liệu chờ người dùng duyệt. Nhờ agent thêm khối này thay vì tự viết.

Sửa quy trình bằng sơ đồ

Khi người dùng cần vẽ hoặc sửa một quy trình, như các bước duyệt hay luồng xử lý, dùng @xyflow/react: ReactFlow, useNodesState, useEdgesState, addEdge, và node tự vẽ có Handle.

Thiết kế quy trình (React Flow)Thiết kế quy trình duyệt: @xyflow/react kéo thả node, nối cạnh, thêm bước, lưu JSON (CSS đã có trong vendor — không import .css).
ví-dụ.manh.run · dữ liệu mẫuMở để sửa ↗
Ví dụ chạy khi bạn cuộn tới

Lưu cả sơ đồ dưới dạng JSON { nodes, edges } qua API của app.

app/workflows/[id:int]/page.tsx
const [nodes, setNodes, onNodesChange] = useNodesState<Node<StepData>>(initialNodes); const [edges, setEdges, onEdgesChange] = useEdgesState<Edge>(initialEdges); const onConnect = useCallback((c: Connection) => setEdges((eds) => addEdge(c, eds)), [setEdges]); const save = () => api.workflows.update(id, { graph: JSON.stringify({ nodes, edges }) }); <Flex style={{ height: 520 }}> {/* khung phải có chiều cao cố định */} <ReactFlow nodes={nodes} edges={edges} onNodesChange={onNodesChange} onEdgesChange={onEdgesChange} onConnect={onConnect} nodeTypes={nodeTypes} fitView> <Background /><MiniMap pannable zoomable /><Controls /> </ReactFlow> </Flex>

Tô màu node bằng theme.useToken() để sơ đồ theo giao diện sáng / tối của app.

Xem sơ đồ tổ chức

Sơ đồ chỉ để xem, như sơ đồ tổ chức, sơ đồ luồng, mind map, thì dựng từ dữ liệu bằng @ant-design/graphs: OrganizationChart, FlowGraph, MindMap, FlowDirectionGraph.

Sơ đồ tổ chức (graphs)Sơ đồ tổ chức chỉ-xem: @ant-design/graphs OrganizationChart từ dữ liệu phòng ban (G6: { nodes: [{ id, data }], edges }).
ví-dụ.manh.run · dữ liệu mẫuMở để sửa ↗
Ví dụ chạy khi bạn cuộn tới
app/org/page.tsx
const data = { nodes: people.map((p) => ({ id: p.id, data: { name: p.name } })), edges: people.filter((p) => p.manager).map((p) => ({ source: p.manager, target: p.id })), }; <div style={{ height: 520 }}> <OrganizationChart data={data} labelField={(d) => d.data.name} autoFit="view" /> </div>

Kanban kéo thả

Kanban cho người dùng đổi giai đoạn bằng cách kéo thẻ sang cột khác. Dùng @dnd-kit/core: DndContext, useDraggable, useDroppable, DragOverlay. Màu trạng thái của cột để ở chấm Badge hoặc Tag cạnh tên cột, đừng kẻ viền màu dày trên đầu cột hay card.

Kanban kéo thả (dnd-kit)Kanban pipeline khách hàng: @dnd-kit kéo thẻ giữa các cột, đếm và tổng giá trị mỗi cột, thẻ ProCard theo token antd.
ví-dụ.manh.run · dữ liệu mẫuMở để sửa ↗
Ví dụ chạy khi bạn cuộn tới

Lưu giai đoạn mới trong onDragEnd, rồi tải lại danh sách.

app/deals/page.tsx
// Kéo hơn 5px mới tính là kéo, nên bấm vào thẻ vẫn mở được const sensors = useSensors(useSensor(PointerSensor, { activationConstraint: { distance: 5 } })); const onDragEnd = async (e: DragEndEvent) => { setActive(null); const to = e.over?.id as Stage | undefined; if (!to) return; await api.deals.update(Number(e.active.id), { stage: to }); refresh(); }; <DndContext sensors={sensors} onDragStart={(e) => setActive(String(e.active.id))} onDragEnd={onDragEnd}> <Flex gap={12} wrap align="flex-start"> {STAGES.map((s) => <Column key={s.key} stage={s} deals={byStage[s.key]} />)} </Flex> <DragOverlay>{active ? <DealCard deal={find(active)} /> : null}</DragOverlay> </DndContext>

Sắp xếp lại các dòng trong bảng thì dùng DragSortTable của pro-components.

Khung chat AI

Khung chat dùng @ant-design/x: Welcome và Prompts khi chưa có tin nhắn, Bubble.List cho hội thoại, Sender cho ô nhập. Câu trả lời của AI hiện bằng <XMarkdown content> từ @ant-design/x-markdown.

Trợ lý AI (antd X)Trợ lý AI trong app: antd X (Welcome, Prompts, Bubble.List, Sender) + XMarkdown; câu trả lời giả lập stream (app thật: khối lego "ai-assistant").
ví-dụ.manh.run · dữ liệu mẫuMở để sửa ↗
Ví dụ chạy khi bạn cuộn tới

Khối ai-assistant có sẵn phần server: lưu hội thoại, cho AI gọi công cụ trên dữ liệu của app với đúng quyền người đang dùng, chờ duyệt trước khi thay đổi dữ liệu, nút Dừng. Ví dụ dưới đây chỉ giả lập câu trả lời. Nhờ agent thêm khối này thay vì tự viết. Server chạy agent bằng manh/agent.

Cập nhật ngay khi dữ liệu đổi

Khi người khác đổi dữ liệu, như kéo thẻ hay duyệt đơn, màn hình của bạn tải lại ngay. Handler phát tín hiệu lên một kênh sau khi ghi thành công, còn trang nghe kênh đó.

app/deals/[id:int]/patch.ts
import { broadcast } from "manh/realtime"; // … sau khi cập nhật thành công broadcast("deals", { id: deal.id });
app/deals/page.tsx
import { useLive } from "app/hooks"; useLive("deals", () => refresh());

Cần biết

  • Không import file CSS của @xyflow/react. CSS đã có sẵn, import thêm thì check báo lỗi code.no-css-import.
  • Khung chứa ReactFlow hoặc sơ đồ của @ant-design/graphs phải có chiều cao cố định, nếu không sơ đồ sẽ cao 0px.
  • Ai mở app cũng nghe được kênh realtime (trừ user:<id>). Chỉ gửi id hoặc tín hiệu “đã đổi”, để trang tự tải lại qua API có kiểm quyền.

Bước tiếp theo

Cập nhật