Chọn dự án học tập có thể thay đổi và khôi phục
Thiết kế bài thực hành với dữ liệu giả định, bảng trạng thái cần đặt lại và điểm gây lỗi rõ ràng trước khi thêm tác động bên ngoài.

Với dự án học tập, tôi thích những sai sót dễ kiểm tra và hoàn tác. Thường đó là dự án dùng dữ liệu giả định, ít người tham gia và ít kết nối tới dịch vụ bên ngoài. Bạn vẫn có thể học hành vi kỹ thuật khó trong phạm vi đó. Không cần thanh toán thật hay hồ sơ khách hàng để hiểu vì sao thử lại, quyền truy cập và khôi phục quan trọng.
Dự án có thể hoàn tác khi bạn khôi phục được trạng thái đã biết, giải thích được thay đổi và tiếp tục sau lần thử lỗi mà không để người khác gánh hậu quả. Dễ khôi phục không đồng nghĩa với đơn giản. Ứng dụng ghi chú cục bộ có thể làm lộ những câu hỏi về đồng thời và lưu trữ đáng tìm hiểu kỹ.
So sánh dự án theo hậu quả của sai sót
Hãy hình dung chọn giữa bản thử ghi chú và sản phẩm thanh toán nhỏ. Cả hai đều dạy biểu mẫu, gọi API và ghi cơ sở dữ liệu. Hậu quả khi lỗi khác nhau.
Với bản thử ghi chú, bạn có thể tạo tài liệu giả định và đặt lại cơ sở dữ liệu sau mỗi bài. Mất cập nhật vẫn là lỗi, nhưng ảnh hưởng dữ liệu dành cho thực hành. Sản phẩm thanh toán thêm trạng thái tài chính, quy tắc nhà cung cấp và hành động khó đảo ngược. Môi trường thử giảm một phần rủi ro, nhưng cần ranh giới rõ với thông tin xác thực và giao dịch thật.
Kho mã Collaborative Notes công khai mô tả dự án ghi chú React và TypeScript với các thư viện liên quan đến trình soạn thảo và kết nối ngang hàng. Đó là ví dụ cụ thể về một ứng dụng có quy mô phù hợp để luyện tập. Chọn một tính năng và kiểm tra trực tiếp; mô tả kho mã không chứng minh hành vi hiện tại khi chạy.
Viết rõ phần nào được phép làm hỏng
Trước khi xây bài thực hành, viết hợp đồng môi trường ngắn. Nêu dữ liệu đến từ đâu, tài khoản hoặc tiến trình cục bộ nào sở hữu nó và đặt lại nghĩa là gì. Với dịch vụ ghi chú giả định, hợp đồng có thể cho phép xóa rồi tạo lại toàn bộ ghi chú thực hành, đồng thời loại trừ tài liệu cá nhân thật.
| Phần | Lựa chọn thực hành ít hậu quả | Câu hỏi trước khi mở rộng |
|---|---|---|
| Dữ liệu | Bộ ghi chú nhỏ được bịa riêng cho bài tập | Mình có quyền dùng dữ liệu mới không? |
| Danh tính | Tài khoản giả định trong môi trường cô lập | Danh tính thử có thể truy cập tài nguyên thật không? |
| Hành động bên ngoài | Tệp cục bộ hoặc chế độ thử của nhà cung cấp | Thử lại có thể gửi, thu tiền hoặc công bố gì không? |
| Khôi phục | Quy trình đặt lại lặp được và bộ dữ liệu đã biết | Phát hiện khôi phục chưa đầy đủ thế nào? |
Cũng phải kiểm tra sự cô lập. Tiến trình cục bộ vẫn có thể dùng thông tin xác thực quá rộng hoặc ghi ngoài thư mục dự định, nên xem các kết nối đó trước khi thử tình huống phá hỏng dữ liệu.
Sơ đồ thể hiện mở rộng như các thay đổi ranh giới rõ ràng. Chẳng hạn, thêm chức năng gửi email thật làm thay đổi hậu quả của dự án dù mã chỉ tăng vài dòng.
Giữ câu hỏi khó trong dự án nhỏ
Nếu bài học là xử lý trùng, bạn có thể yêu cầu dịch vụ tạo tài liệu, làm gián đoạn phản hồi rồi gửi lại. Kiểm tra ứng dụng có tạo ghi chú khác không và hành vi có đúng hợp đồng không. Thách thức là thật dù dữ liệu giả định.
Nếu học kiểm soát truy cập, tạo hai người dùng thực hành và một ghi chú cho mỗi người. Thử yêu cầu trực tiếp mà giao diện thường không cung cấp. Nếu học khôi phục, dừng tiến trình trong lúc lưu rồi kiểm tra dữ liệu sau khởi động lại. Mỗi bài cần kết quả mong đợi trước khi thực hiện.
Tách điều quan sát được khỏi giả định. “Giao diện báo lỗi” và “thao tác ghi không xảy ra” là hai khẳng định khác nhau. Ghi cả hành vi hiển thị lẫn trạng thái lưu giúp rèn cách thu thập bằng chứng sẽ cần trong ứng dụng lớn hơn.
Mở rộng khi bài tiếp theo cần đến
Bản thử cục bộ không trả lời được mọi câu hỏi triển khai hoặc sản phẩm. Đến lúc nào đó, bạn có thể cần ranh giới mạng thật, thiết bị thứ hai hoặc dịch vụ lưu trữ được quản lý. Thêm môi trường vì nó cần cho hành vi cụ thể muốn nghiên cứu, rồi cập nhật quy tắc đặt lại và truy cập.
Lần mở rộng đầu chỉ đọc giúp giảm tác động bên ngoài. Bản demo công khai chỉ đọc có thể làm lộ vấn đề hiển thị và mạng mà chưa nhận nội dung người dùng. Nếu về sau cho tải tệp lên, sẽ có thêm câu hỏi về giới hạn tệp, quyền sở hữu, lưu giữ và lạm dụng. Chúng cần phần thiết kế riêng.
Bộ quy tắc đạo đức của ACM đề cập trách nhiệm về tác hại, quyền riêng tư và truy cập được cho phép. Với dự án học tập, tôi xem đây là lý do cân nhắc ai có thể bị ảnh hưởng trước khi coi phản hồi API thành công như quyền tiếp tục mọi thao tác.
Giữ lại bài thực hành sau khi thành công
Giữ bộ dữ liệu, hướng dẫn đặt lại và trường hợp lỗi đã tạo ra bài học. Người khác cần hiểu trạng thái nào dùng một lần rồi bỏ được và tái hiện hành vi mà không phải đoán ranh giới an toàn ở đâu.
Giới hạn của cách làm này là thực hành cô lập có thể trơn tru hơn vận hành thật. Nó thiếu quy mô, ràng buộc tổ chức và dữ liệu lộn xộn. Ghi đúng những phần thiếu đó. Dự án nhỏ, dễ khôi phục là nơi phát triển lời giải thích chính xác, rồi chọn ràng buộc thực tế nào sẽ đưa vào tiếp.
Xác định trạng thái phải khôi phục khi đặt lại
Bản mã đang mở chỉ là một phần trạng thái ứng dụng. Dự án ghi chú còn có thể có dòng dữ liệu, tệp tải lên, công việc trong hàng đợi, dữ liệu trình duyệt và thông tin xác thực trỏ tới hệ thống khác. Hoàn tác thay đổi mã không tự khôi phục những phần này.
Viết bảng trạng thái cần đặt lại cho môi trường thực hành. Bảng liệt kê những gì phải trở về mốc đã biết và ranh giới tài nguyên không được đụng tới. Với dữ liệu cục bộ, dùng hai tài khoản giả định, ba ghi chú tự tạo và hàng đợi rỗng. Chỉ lưu tệp đính kèm trong thư mục riêng cho bài tập, đồng thời ghi nhận cơ sở dữ liệu đang được cấu hình trước khi đặt lại.
| Trạng thái | Mốc ban đầu | Bằng chứng sau khi đặt lại |
|---|---|---|
| Mã nguồn | Commit xác định và thay đổi cục bộ được ghi rõ | Đúng phiên bản dự định đang được dùng |
| Cơ sở dữ liệu | Hai tài khoản và ba ghi chú mẫu | Mã, chủ sở hữu và nội dung khớp mong đợi |
| Tệp | Chỉ các tệp đính kèm mẫu | Không còn kết quả từ lần thực hiện trước |
| Hàng đợi | Không có công việc thực hành đang chờ | Lần thử cũ không bất ngờ chạy lại |
| Trình duyệt | Phiên của người dùng thử đã chọn | Danh tính hiển thị khớp danh tính trong yêu cầu |
Số lượng được giữ nhỏ để kiểm tra từng bản ghi. Quy trình báo thành công nhưng để lại công việc thử lại trong hàng đợi chưa khôi phục được bài thực hành. Công việc chậm có thể đổi trạng thái sau khi lần chạy tiếp theo bắt đầu, khiến lỗi trông như không thể dự đoán.
Tách thử nghiệm mã khỏi thử nghiệm môi trường
Git worktree cho phép một kho mã có nhiều thư mục làm việc đang được checkout. Nó giúp giữ cách triển khai gốc cạnh nhánh thử nghiệm. Tài liệu cũng nói rõ các worktree liên kết chia sẻ dữ liệu kho mã, còn một số trạng thái như HEAD và index được giữ riêng.
Vì vậy worktree hữu ích để tổ chức mã, nhưng không phải vùng cô lập ứng dụng. Hai bản checkout vẫn có thể đọc cùng biến môi trường và nối tới cùng cơ sở dữ liệu. Chúng cũng có thể dùng cùng origin trình duyệt hoặc tài khoản bên ngoài. Kiểm tra các kết nối riêng trước khi cho rằng khác thư mục nghĩa là khác môi trường.
Với bài này, ghi tên cơ sở dữ liệu và thư mục tệp trong hướng dẫn chạy. Không để thông tin xác thực trong dữ liệu mẫu. Nếu không phân biệt được môi trường với dịch vụ thật bằng kiểm tra cấu hình, dừng bài gây lỗi và làm rõ điều đó trước. Mục tiêu là nghiên cứu lần ghi thất bại, không phải phát hiện tiến trình tình cờ đã chạm tới dữ liệu thật nào.
Chọn điểm gây lỗi trước khi thực hiện
Bài xử lý trùng hữu ích làm gián đoạn phản hồi sau khi ứng dụng đã chấp nhận ghi. Thời điểm đó bộc lộ khác biệt giữa tương tác thất bại và thay đổi trạng thái thất bại. Dừng tiến trình trước khi nhận yêu cầu trả lời một câu hỏi khác.
Mô tả chuỗi bước: bắt đầu từ các ghi chú đã biết, gửi thao tác tạo, để điểm lưu đã chọn hoàn tất, ngăn bên gọi nhận phản hồi bình thường, rồi thử lại theo hợp đồng thao tác. Ghi mã ghi chú đã lưu và kết quả trả về. Một hay hai ghi chú có chấp nhận được không phụ thuộc chính sách xử lý trùng, nên nêu chính sách trước khi thử.
Điểm kiểm soát dành cho kiểm thử trong bản chạy cục bộ có thể làm gián đoạn lặp được. Nó nên xác định rõ chỗ tạm dừng và nằm ngoài luồng thông thường của người dùng. Dừng tiến trình ngẫu nhiên cho tới khi lỗi có thể tìm ra vấn đề, nhưng cung cấp bằng chứng yếu hơn về ranh giới gây lỗi.
Tính đến tác động không thể đặt lại cục bộ
Xóa bản ghi hàng đợi cục bộ không thu hồi được email nhà cung cấp đã chấp nhận gửi. Khôi phục ảnh chụp cơ sở dữ liệu không làm bài đăng công khai biến mất khỏi những bản sao bên ngoài ứng dụng. Vì vậy trạng thái bên ngoài sau đặt lại có thể khác điều cơ sở dữ liệu mô tả.
Dùng nơi nhận giả cục bộ hoặc môi trường thử cô lập rõ ràng của nhà cung cấp nếu bài chưa cần gửi thật. Nếu bước sau cần tác động bên ngoài, thêm quy trình kiểm chứng và dọn dẹp cho nhà cung cấp đó thay vì giả định đặt lại cơ sở dữ liệu đã bao quát. Một số tác động cần hành động bù trừ thay vì đảo ngược chính xác.
Câu hỏi hữu ích là bài thực hành đã chọn có trạng thái bắt đầu rõ, hậu quả được giới hạn và đường khôi phục quan sát được về trạng thái cần cho lần sau hay không. Không cần dự án hoàn tác hoàn hảo theo mọi nghĩa. Khi câu trả lời thay đổi, cập nhật hợp đồng môi trường trước khi mở rộng bài thực hành.