# Design performance budget thực chiến cho team frontend

Performance budget giúp đội ngũ đưa ra quyết định dựa trên dữ liệu thay vì cảm tính. Bài viết hướng dẫn thiết lập budget phù hợp từng flow và biến nó thành guardrail tự động.

## Bối cảnh & vấn đề cần giải quyết

Khi sản phẩm phát triển, bundle size và thời gian phản hồi tăng nhanh nếu không có giới hạn rõ ràng. Performance budget đảm bảo mỗi tính năng mới không phá vỡ trải nghiệm hiện tại.

## Các nguyên tắc cốt lõi

### Budget phải dựa trên dữ liệu RUM

Không nên lấy số liệu synthetic làm chuẩn duy nhất. Kết hợp dữ liệu thực tế từ Web Vitals để xác định baseline chính xác.

### Phân loại budget theo độ quan trọng của flow

Checkout, onboarding, search cần budget khắt khe hơn so với trang blog hoặc profile.

### Budget phải được theo dõi liên tục

Đưa metric vào dashboard chung, thiết lập cảnh báo khi vượt ngưỡng thay vì kiểm tra thủ công.

## Quy trình triển khai chi tiết

### Bước 1: Thu thập dữ liệu baseline

Kết hợp Lighthouse CI, WebPageTest và RUM để ghi lại LCP, INP, bundle size, số request. Chọn median làm baseline ban đầu.

### Bước 2: Thiết lập Guardrail trong CI/CD

Thêm bước Lighthouse CI với config budget. Nếu vượt, pipeline chuyển sang màu đỏ và blocking merge cho tới khi xử lý.

### Bước 3: Đưa budget vào dashboard chung

Sử dụng Looker/Metabase để tổng hợp dữ liệu RUM theo tuần. Chia sẻ dashboard cho Product và Engineering để có trách nhiệm chung.

### Bước 4: Đánh giá và tinh chỉnh hàng quý

Sau mỗi quý, đánh giá lại budget, điều chỉnh theo nhu cầu kinh doanh. Không quá khắt khe khiến team bế tắc, cũng không quá lỏng lẻo.

## Ví dụ triển khai thực tế

Một công ty thương mại điện tử đã giảm 22% thời gian LCP trung bình sau khi performance budget được áp dụng triệt để vào pipeline.

### Mẫu mã nguồn minh họa

Cấu hình Lighthouse CI với performance budget cụ thể, tích hợp vào pipeline CI của dự án.





```yaml
ci:
  performance:
    script:
      - npx @lhci/cli autorun --config=./lighthouse.config.js

# lighthouse.config.js
module.exports = {
  ci: {
    collect: {
      numberOfRuns: 3,
      url: [
        'https://preview.devblog.com/',
        'https://preview.devblog.com/checkout',
      ],
    },
    assert: {
      preset: 'lighthouse:no-pwa',
      assertions: {
        'categories:performance': ['error', { minScore: 0.9 }],
        'largest-contentful-paint': ['error', { maxNumericValue: 2300 }],
        'total-byte-weight': ['warn', { maxNumericValue: 350000 }],
      },
    },
  },
};

```

## Bộ KPI cần theo dõi

- LCP trung bình < 2.3s trên 75% traffic
- Bundle impact của mỗi PR < 40KB gzip
- Tỷ lệ pipeline bị block bởi budget < 10% (phản ánh chất lượng quy trình)

## Case study thực tế

Một publisher lớn đưa budget vào pipeline, thời gian hiển thị trang chủ giảm 1.4s và doanh thu quảng cáo tăng 6%.

## Checklist rà soát cuối cùng

- [ ] Thiết lập baseline từ dữ liệu thực tế
- [ ] Định nghĩa budget riêng cho flow quan trọng
- [ ] Tích hợp kiểm tra vào CI/CD
- [ ] Xây dashboard chia sẻ cho toàn bộ stakeholders

## Câu hỏi thường gặp

### Budget nên cập nhật bao lâu một lần?

Nên đánh giá tối thiểu mỗi quý, hoặc khi có thay đổi lớn về kiến trúc (ví dụ chuyển framework, thêm tính năng nặng).

### Nếu pipeline liên tục bị fail vì budget?

Xem lại baseline và quy trình develop. Có thể cần chia nhỏ bundle hoặc áp dụng code splitting. Đừng nới lỏng budget ngay lập tức.

## Kết luận & bước tiếp theo

Performance budget là cam kết chung giữa Product, UX và Engineering. Khi được vận hành đúng, nó giữ cho sản phẩm nhanh, ổn định và dễ mở rộng.


Tag: #Observability

Design performance budget thực chiến cho team frontend