Mở đầu — vì sao bài này quan trọng
Nếu bạn đã quen với JIRA qua các bài trước, hãy hình dung thế này: JIRA là nơi công việc "chảy" qua từng trạng thái, còn Confluence là nơi tri thức "đọng" lại. JIRA trả lời câu hỏi "Ai đang làm gì, đến đâu rồi?", còn Confluence trả lời "Tại sao chúng ta quyết định như vậy? Quy chuẩn của team là gì? Tài liệu yêu cầu nằm ở đâu?". Với một Business Analyst (BA), Confluence chính là ngôi nhà của tài liệu nghiệp vụ — BRD, user story, biên bản họp, sơ đồ luồng, quyết định thiết kế.
Vấn đề là rất nhiều BA mới bắt đầu dùng Confluence theo kiểu... Google Docs có URL đẹp hơn. Họ tạo trang lung tung, đặt tên trùng nhau, không có cấu trúc phân cấp, đến khi dự án phình to thì không ai tìm nổi tài liệu nào ra tài liệu nào. Tôi từng vào một workspace Confluence của một công ty fintech ở TP.HCM có hơn 4.000 trang nhưng không có Space nào được tổ chức tử tế — kết quả là mỗi lần audit, đội ngũ mất trung bình 25 phút chỉ để tìm phiên bản BRD đúng.
Bài này tập trung vào hai viên gạch nền tảng nhất của Confluence: Space và Page, cùng với cách tổ chức cấu trúc phân cấp (hierarchy). Nắm chắc hai khái niệm này, bạn sẽ có "bộ xương" vững chắc để sau này gắn thêm template, macro, permission ở các bài sau. Đây là bài đặt nền móng — làm sai ở đây, cả ngôi nhà tài liệu của bạn sẽ lệch.
Khái niệm cốt lõi
Confluence được tổ chức như thế nào?
Hãy hình dung Confluence như một tòa nhà tri thức của tổ chức. Cấu trúc phân cấp đi từ trên xuống như sau:
Confluence Site (toàn bộ tổ chức của bạn)
└── Space (ví dụ: "BA Team Knowledge")
├── Page (ví dụ: "Requirements Standards")
│ ├── Child Page (ví dụ: "BRD Template Guide")
│ │ └── Child Page (ví dụ: "Approval Checklist")
│ └── Child Page (ví dụ: "User Story Guidelines")
└── Page (ví dụ: "Meeting Notes")
├── Child Page (ví dụ: "2026-06 Sprint Planning")
└── Child Page (ví dụ: "2026-06 Retrospective")
Ba tầng cần nhớ: Site → Space → Page (và Child Page).
Site — toàn bộ Confluence của tổ chức
Site là cấp cao nhất — chính là instance Confluence mà công ty bạn đăng ký (ví dụ vietcombank.atlassian.net). Là BA, bạn hiếm khi đụng tới cấp Site; đó là việc của quản trị viên (admin). Nhưng bạn cần biết nó tồn tại, vì các thiết lập về bảo mật, người dùng và license đều nằm ở tầng này.
Space — không gian làm việc độc lập
Space là khái niệm quan trọng nhất bạn cần làm chủ. Mỗi Space là một khu vực làm việc độc lập, có trang chủ (Space Home/Overview) riêng, có cây phân cấp trang riêng, có phân quyền riêng và có "khóa định danh" gọi là Space Key (ví dụ Space "BA Team Knowledge" có thể có key là BATK). Space Key chính là phần xuất hiện trong URL: .../wiki/spaces/BATK/....
Có hai loại Space chính:
- Team/Project Space: dùng cho một dự án, một phòng ban hoặc một đội. Đây là loại bạn dùng nhiều nhất với vai trò BA. Ví dụ: Space cho dự án "Mobile Banking 2026", Space cho "Phòng Phân tích Nghiệp vụ".
- Personal Space: không gian riêng của mỗi cá nhân, dùng để nháp, ghi chú cá nhân. Tên Space cá nhân thường gắn với tên người dùng. Đừng dùng Personal Space để chứa tài liệu chính thức của dự án — vì khi bạn nghỉ việc, tài liệu đó có nguy cơ "biến mất" theo tài khoản.
Page — trang nội dung
Page là đơn vị nội dung thực tế — nơi bạn viết BRD, ghi biên bản họp, vẽ sơ đồ. Mỗi Page có:
- Tiêu đề (Title) — phải là duy nhất trong cùng một Space (đây là ràng buộc kỹ thuật của Confluence, rất nhiều người mới mắc lỗi ở đây).
- Nội dung — soạn bằng trình editor, có thể chèn bảng, hình, macro, link.
- Vị trí trong cây phân cấp — nằm ở gốc Space hoặc là con của một trang khác.
- Lịch sử phiên bản — mỗi lần lưu tạo một version mới (chi tiết ở Bài 29).
Child Page và cây phân cấp (Page Tree)
Một Page có thể có trang con (Child Page), và trang con lại có thể có trang con của nó — tạo thành cây phân cấp gần như không giới hạn độ sâu. Cây này hiển thị ở thanh điều hướng bên trái (sidebar) và là "bản đồ" giúp mọi người định vị tài liệu.
Lời khuyên thực chiến: đừng để cây quá sâu (trên 4 tầng là dấu hiệu cần xem lại) cũng đừng để quá phẳng (50 trang nằm chung một cấp thì không khác gì một đống giấy đổ ra bàn). Một cây phân cấp tốt giống như mục lục của một cuốn sách — nhìn vào là biết nội dung nằm ở chương nào.
Phân biệt nhanh với JIRA
Đừng nhầm: trong JIRA, "Project" là nơi chứa các Issue; còn trong Confluence, "Space" là nơi chứa các Page. Một dự án thực tế thường có một JIRA Project + một Confluence Space đi kèm — JIRA để theo dõi công việc, Confluence để lưu tri thức. Bài 16 sẽ dạy bạn cách liên kết hai bên lại với nhau.
Tình huống thực tế
Tình huống 1 — Công ty Tiki tổ chức Space cho đội BA
Giả sử đội Phân tích Nghiệp vụ của Tiki có 6 BA, phụ trách 3 sản phẩm: Tiki Mall (sàn TMĐT), TikiNOW (giao hàng nhanh) và Tiki Trading (bán hàng trực tiếp). Lúc đầu, trưởng nhóm BA tạo một Space duy nhất tên "BA Documents" và nhét tất cả tài liệu của cả ba sản phẩm vào đó.
Sau ba tháng, vấn đề bùng nổ: BA của TikiNOW vô tình sửa nhầm BRD của Tiki Mall vì hai trang có tiêu đề na ná nhau ("Checkout Flow" và "Checkout Flow v2"); team Tiki Trading muốn giới hạn quyền xem tài liệu nhạy cảm về giá vốn nhưng không thể, vì mọi người trong Space đều thấy hết.
Họ tái cấu trúc lại thành bốn Space:
BAHUB— "BA Team Hub": chứa quy chuẩn chung, template, hướng dẫn onboarding cho BA (toàn đội đều xem).MALL— "Tiki Mall": tài liệu riêng của Tiki Mall.TNOW— "TikiNOW".TRAD— "Tiki Trading": bật phân quyền hạn chế cho phần nhạy cảm.
Tình huống 2 — Startup giáo dục ở Hà Nội và cây phân cấp của một dự án
Một startup edtech 20 người ở Hà Nội triển khai dự án "Hệ thống quản lý học viên" (LMS). BA tên Mai được giao tạo cấu trúc tài liệu trong Space LMS. Thay vì tạo 30 trang nằm phẳng, Mai thiết kế cây phân cấp như sau:
LMS (Space Home)
├── 01. Project Overview
├── 02. Requirements
│ ├── BRD - Quản lý học viên
│ ├── BRD - Thanh toán học phí
│ └── User Stories
│ ├── US - Đăng ký khóa học
│ └── US - Hoàn tiền
├── 03. Meeting Notes
│ ├── 2026-05 Kickoff
│ └── 2026-06 Sprint Planning
└── 04. Decisions Log
Mai đặt số thứ tự (01, 02, 03) ở đầu các trang cấp một để ép thứ tự hiển thị trong sidebar đúng ý (mặc định Confluence sắp theo thứ tự tạo hoặc theo cấu hình, nhưng tiền tố số là mẹo đơn giản và bền vững). Khi một thành viên mới gia nhập, anh ta tự định hướng được tài liệu chỉ trong 5 phút mà không cần hỏi ai.
Bài học rút ra: Cây phân cấp tốt phản ánh cách con người tư duy về dự án (tổng quan → yêu cầu → họp → quyết định), chứ không phải đổ tài liệu theo thứ tự ngẫu nhiên lúc bạn nghĩ ra. Một trang cha "rỗng" làm nhãn nhóm (như "Requirements", "User Stories") là hoàn toàn hợp lý và rất hữu ích.
Tình huống 3 — Lỗi tiêu đề trùng tại một ngân hàng số
Tại một ngân hàng số ở Singapore, BA tên David cố tạo một trang "Meeting Notes" trong Space dự án, nhưng Confluence báo lỗi: "A page with this title already exists". Anh bối rối vì rõ ràng anh không thấy trang nào tên đó trong sidebar — hóa ra có một trang "Meeting Notes" cũ đã bị một đồng nghiệp lưu trữ (archive) nhưng tiêu đề vẫn chiếm chỗ trong Space.
Giải pháp của team là áp dụng quy ước đặt tên có ngày tháng và phạm vi: thay vì "Meeting Notes" chung chung, họ dùng "Meeting Notes - 2026-06-15 - Sprint Planning". Tiêu đề vừa duy nhất, vừa tự sắp xếp theo thời gian khi liệt kê, vừa dễ tìm.
Bài học rút ra: Vì tiêu đề phải duy nhất trong Space, hãy đặt tên có ngữ cảnh + ngày tháng cho các trang lặp lại theo chu kỳ (biên bản họp, retro, weekly report). Đây là một trong những lỗi phổ biến nhất khiến người mới khó chịu với Confluence.
Hướng dẫn từng bước
Phần A — Tạo một Space mới
- Đăng nhập Confluence, ở menu điều hướng phía trên hoặc sidebar trái, chọn Spaces → Create a space (Tạo không gian).
- Confluence sẽ gợi ý template Space (Blank, Team space, Documentation, Knowledge base...). Cho mục đích BA, chọn Team space hoặc Blank để toàn quyền tự thiết kế.
- Nhập Space name (ví dụ: "BA Team Knowledge"). Confluence tự sinh Space Key gợi ý — hãy sửa lại cho ngắn, viết HOA, dễ đoán (ví dụ
BATK). Lưu ý: Space Key khó đổi về sau, nên cân nhắc kỹ ngay từ đầu. - (Tùy chọn) Gán quyền truy cập ban đầu — ai được xem, ai được sửa. Chi tiết phân quyền học ở Bài 20.
- Nhấn Create. Bạn được đưa tới Space Overview — trang chủ của Space, nơi nên viết phần giới thiệu ngắn về mục đích Space và sơ đồ điều hướng.
Phần B — Tạo Page và Child Page
- Trong Space, nhấn nút Create (thường ở góc trên bên phải) để tạo trang mới ở cấp gốc.
- Đặt tiêu đề duy nhất ngay từ đầu (nhớ quy ước đặt tên ở phần trên).
- Soạn nội dung trong editor. Nhấn Publish để xuất bản (trang nháp chưa publish chỉ mình bạn thấy — chi tiết ở Bài 41).
- Tạo Child Page: di chuột vào trang cha trong sidebar trái, nhấn dấu + bên cạnh tên trang → trang mới sẽ tự động trở thành con của trang cha đó.
- Di chuyển trang: nếu lỡ tạo sai vị trí, kéo-thả (drag & drop) trang trong sidebar để đặt lại đúng nhánh, hoặc dùng menu ••• → Move.
Phần C — Tổ chức và điều hướng
- Sắp xếp thứ tự trong sidebar bằng cách kéo-thả, hoặc dùng tiền tố số như "01.", "02." nếu muốn thứ tự cố định bền vững.
- Thiết lập Space Overview thành "bảng chỉ dẫn": viết mục đích Space, danh sách link tới các khu vực chính, người chịu trách nhiệm.
- Dùng ô Search trong Space để kiểm tra trùng tiêu đề trước khi tạo trang mới (Bài 19 sẽ đào sâu về tìm kiếm).
Lỗi thường gặp & mẹo
Lỗi 1 — Gom tất cả vào một Space "cho tiện". Hệ quả là phân quyền cứng nhắc, cây phân cấp khổng lồ, tìm kiếm như mò kim đáy bể. Mẹo: chia Space theo ranh giới sở hữu/phân quyền, không theo thói quen.
Lỗi 2 — Đặt Space Key tùy tiện hoặc quá dài. Key kiểu PROJECT2026FINAL xuất hiện trong mọi URL trông rất xấu và khó nhớ. Mẹo: Key ngắn 3–5 ký tự, viết HOA, có ý nghĩa (MALL, LMS, BATK).
Lỗi 3 — Tiêu đề trang chung chung và trùng lặp. "Notes", "Document", "Untitled" gây lỗi trùng và vô dụng khi tìm kiếm. Mẹo: tiêu đề = ngữ cảnh + ngày tháng khi cần lặp lại.
Lỗi 4 — Cây phân cấp quá phẳng hoặc quá sâu. 50 trang một cấp thì loạn; sâu 7 tầng thì lạc. Mẹo: giữ 2–4 tầng, dùng trang cha làm nhãn nhóm.
Lỗi 5 — Dùng Personal Space cho tài liệu dự án chính thức. Khi người đó rời công ty, tài liệu có nguy cơ mất theo. Mẹo: tài liệu chính thức luôn nằm trong Team/Project Space.
Lỗi 6 — Quên viết Space Overview. Người mới vào không biết bắt đầu từ đâu. Mẹo: coi Overview như trang bìa + mục lục của Space.
Mẹo vàng: Trước khi tạo cả tá trang, hãy phác cây phân cấp ra giấy trước (như Mai ở Tình huống 2). 10 phút thiết kế ban đầu tiết kiệm cho bạn hàng giờ dọn dẹp về sau.
Bài tập thực hành
- Thiết kế Space: Hãy hình dung bạn là BA của một dự án "App đặt đồ ăn" (giả định công ty bạn). Viết ra giấy: tên Space, Space Key (3–5 ký tự), và một câu mô tả mục đích Space.
- Vẽ cây phân cấp: Thiết kế cây phân cấp 2–3 tầng cho Space đó, bao gồm tối thiểu các nhánh: Project Overview, Requirements (có ít nhất 2 BRD và 1 nhánh User Stories), Meeting Notes, Decisions Log. Áp dụng quy ước đặt tên có ngày tháng cho ít nhất một nhóm trang lặp lại.
- Thực hành trên Confluence (nếu có tài khoản, dùng bản free tại atlassian.com): Tạo thật Space và cây phân cấp bạn vừa thiết kế. Tạo một trang cha "02. Requirements" và hai child page bên dưới. Sau đó thử kéo-thả một trang sang nhánh khác và quan sát URL thay đổi thế nào.
- Tự kiểm lỗi: Cố tình tạo hai trang cùng tên trong một Space để thấy thông báo lỗi trùng tiêu đề. Ghi lại đúng nội dung thông báo và đề xuất cách đặt lại tên cho hợp lý.
- Viết Space Overview: Soạn phần Overview cho Space của bạn gồm: mục đích, danh sách link tới các nhánh chính, và tên người phụ trách. Mục tiêu: một thành viên mới đọc xong tự định hướng được trong 5 phút.
Tóm tắt
Confluence được tổ chức theo ba tầng: Site → Space → Page (và Child Page). Là BA, bạn làm việc chủ yếu ở tầng Space và Page.
- Space là không gian làm việc độc lập, có Space Key, trang chủ và phân quyền riêng. Hãy chia Space theo ranh giới sở hữu và phân quyền, không gom tất cả cho tiện.
- Page là đơn vị nội dung, có tiêu đề duy nhất trong Space; hãy đặt tên có ngữ cảnh và ngày tháng để tránh trùng và dễ tìm.
- Cây phân cấp (Child Page) là bản đồ điều hướng; giữ độ sâu 2–4 tầng, dùng trang cha làm nhãn nhóm, phác thảo ra giấy trước khi tạo.
- Tránh các lỗi kinh điển: gom một Space, Key tùy tiện, tiêu đề chung chung, cây quá phẳng/quá sâu, dùng Personal Space cho tài liệu chính thức.