> ## Documentation Index
> Fetch the complete documentation index at: https://learn.cleeksy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inner loop: Chu kỳ triển khai

> Triển khai giải pháp theo trình Define -> Design -> Build -> Test -> Adopt.

Inner loop là **chu kỳ triển khai (delivery cycle)** trong SDD. Mục tiêu là đưa một lát cải tiến vào vận hành **an toàn, đo được, và có thể lặp lại**.

Chu kỳ gồm 5 bước:

1. Define → 2) Design → 3) Build → 4) Test → 5) Adopt

Điểm quan trọng: mỗi bước đều tạo ra **artifact** (đầu ra) rõ ràng và có “điểm rơi” tương ứng trong Cleeksy DOP.

Liên quan:

* [SDD là gì](/sdd/overview)
* [Outer loop: scenario backlog (lập kế hoạch theo kịch bản)](/sdd/outer-loop-scenario-backlog)
* [Khái niệm & đầu ra cốt lõi (Core concepts & key artifacts)](/sdd/core-concepts-artifacts)

***

## Tổng quan: bước → artifacts → điểm rơi trong Cleeksy

| Bước   | Mục tiêu                                         | Artifacts tối thiểu                                    | Điểm rơi trong Cleeksy DOP                                               |
| ------ | ------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------------------------ |
| Define | Chốt “đang làm gì” và “xong là như thế nào”      | Scenario rõ + tiêu chí hoàn thành + dữ liệu tối thiểu  | Entity/Field nháp, Role/đối tượng người dùng, tiêu chí đo                |
| Design | Chốt “sẽ vận hành như thế nào”                   | Future-state flow + trạng thái + ranh giới app/dữ liệu | Views/Record layout, Workflow design, publish/consume & data source plan |
| Build  | Cấu hình để chạy được end-to-end                 | App skeleton chạy được                                 | Data modeling, Views & UI, Workflows, Roles/permissions, Data sources    |
| Test   | Kiểm tra đúng kịch bản, đúng quyền, đúng dữ liệu | Test cases theo scenario + kết quả                     | App review checklist, lỗi & cách sửa, điều chỉnh config                  |
| Adopt  | Đưa vào vận hành và đo hiệu quả                  | Hướng dẫn sử dụng + số đo + backlog cải tiến           | Onboarding người dùng, Analytics Hub, vòng cải tiến                      |

> Nếu một bước chưa tạo ra artifact tối thiểu, thường nên dừng để làm rõ trước khi đi tiếp.

***

## 1) Define

### Mục tiêu

* Chốt 1–3 **scenario** cho increment (happy path trước)
* Chốt **definition of done** (DoD): chạy end-to-end + tiêu chí đo
* Chốt dữ liệu tối thiểu cần có để kịch bản chạy được

### Artifacts tối thiểu

* **Scenario card** (thẻ kịch bản) gồm:
* Vai trò (role) liên quan
* Trigger và mục tiêu
* Các bước chính (5–10 bước)
* Dữ liệu cần nhập/xem/cập nhật
* Ngoại lệ tối thiểu (nếu có)
* **Acceptance criteria** (tiêu chí chấp nhận)
* **Data checklist**: field bắt buộc để chạy kịch bản

### Mapping sang Cleeksy

* Xác định Entity chính và các field cốt lõi: [Thực thể dữ liệu (Entity)](/build-apps/data-modeling/entities), [Kiểu trường dữ liệu (Field types)](/build-apps/data-modeling/field-types)
* Xác định role và phạm vi quyền: [Mô hình phân quyền (Permissions model)](/reference/permissions-model-public)
* Xác định kênh vào/ra dữ liệu (nếu có): [Cổng dữ liệu (Data source)](/build-apps/integrations/data-sources-overview)

***

## 2) Design

### Mục tiêu

* Chốt **future state**: quy trình và trải nghiệm vận hành sau khi có hệ thống
* Chốt **trạng thái (status)** và các chuyển trạng thái
* Chốt ranh giới app và ownership dữ liệu (đặc biệt khi có nhiều app)

### Artifacts tối thiểu

* **Process sketch**: các bước và trạng thái (as-is → to-be ở mức tối thiểu)
* **State model**: status + điều kiện chuyển trạng thái
* **UI sketch**: view nào cho ai (operational view vs requester view)
* **Data boundary note**: dữ liệu thuộc app nào, có cần publish/consume không

### Mapping sang Cleeksy

* Views/Record layout theo vai trò:
* [Tổng quan giao diện](/build-apps/ui-views/views-overview)
* [Bố cục bản ghi (Record layout)](/build-apps/ui-views/record-layout)
* Workflow thiết kế theo trạng thái:
* [Thiết kế quy trình (Process Builder)](/build-apps/workflows/process-builder)
* [Phê duyệt (Approvals)](/build-apps/workflows/approvals)
* Chia sẻ dữ liệu giữa app:
* [Chia sẻ dữ liệu (Publish/Consume)](/build-apps/integrations/publish-consume-overview)
* [Kết nối dữ liệu một chiều (Data Connection one-way)](/build-apps/data-modeling/data-connection-one-way)
* [Kết nối dữ liệu hai chiều (Data Connection two-way)](/build-apps/data-modeling/data-connection-two-way)

***

## 3) Build

### Mục tiêu

* Cấu hình đủ để kịch bản chạy end-to-end
* Giữ phạm vi đúng như Define/Design (tránh “tiện thì làm thêm”)

### Artifacts tối thiểu

* App skeleton:
* Entity/Field đủ dùng
* 2–3 view tối thiểu theo vai trò
* Workflow tối thiểu để chuyển trạng thái
* Role/permission tối thiểu để chạy kịch bản
* Data source cần thiết (nếu có intake/submit/integration)

### Mapping sang Cleeksy

* Data modeling: [Bản ghi (Record)](/build-apps/data-modeling/records), [Kiểu trường dữ liệu (Field types)](/build-apps/data-modeling/field-types)
* Views & UI: [Dạng bảng (Grid view)](/build-apps/ui-views/grid-view), [Dạng thẻ (Kanban view)](/build-apps/ui-views/kanban-view)
* Workflow: [Luật tự động (Automation rules)](/build-apps/workflows/automation-rules)
* Permissions: [Cơ bản về App](/build-apps/app-basics)

***

## 4) Test

### Mục tiêu

* Kiểm thử theo scenario (không chỉ kiểm thử tính năng)
* Kiểm tra quyền (ai thấy gì, ai làm gì)
* Kiểm tra dữ liệu (đúng nguồn, đúng trạng thái)

### Artifacts tối thiểu

* **Scenario test cases**:
* Happy path
* 1–2 ngoại lệ quan trọng (thiếu dữ liệu, bị reject, quá hạn…)
* **Permission check** theo role
* Danh sách lỗi + quyết định sửa (fix/adjust/scope out)

### Mapping sang Cleeksy

* Dùng view vận hành để kiểm tra flow
* Dùng [Rà soát & vận hành (App review)](/build-apps/app-review) làm checklist:
* workflow chạy đúng?
* trạng thái rõ?
* thông báo/giao việc đúng?
* dữ liệu không bị lệch?

***

## 5) Adopt

### Mục tiêu

* Đưa increment vào vận hành thực tế
* Thiết lập nhịp theo dõi và phản hồi
* Tạo vòng cải tiến trở lại outer loop

### Artifacts tối thiểu

* Hướng dẫn ngắn theo vai trò (Requester/Approver/Operator)
* “Operational dashboard” tối thiểu (hoặc báo cáo đơn giản)
* Danh sách phản hồi + quyết định cải tiến (đưa vào backlog)

### Mapping sang Cleeksy

* Thông báo và giao việc: [Thông báo & giao việc](/build-apps/notifications-tasks)
* Báo cáo: [Tổng quan phân tích dữ liệu](/build-apps/analytics-hub/overview)
* Vòng cải tiến: [Vòng lặp cải tiến (Improve loop)](/foundations/improve-loop)

***

## Guardrails để inner loop “nhỏ mà chạy được”

* Chỉ chọn 1–3 scenario cho một vòng triển khai
* Happy path trước, ngoại lệ mở rộng theo dữ liệu vận hành
* Chốt ranh giới dữ liệu và app trước khi làm cross-app
* Mọi thay đổi phải map được về scenario và tiêu chí đo

***

## Bước tiếp theo

* Xem cách map tổng thể: [Khái niệm & đầu ra cốt lõi (Core concepts & key artifacts)](/sdd/core-concepts-artifacts)
