Blocks

Đầu vào là một region của một layout đã được chấp nhận, và đầu ra là 3–4 giải phẫu khối, mỗi cái là một cấu trúc JSON để thầy chọn giữa chúng — hoặc một lời từ chối nêu tên quyết định sản phẩm còn thiếu. Cũng như tầng layout, đây không phải compiler, và vì đúng lý do đó: giải phẫu nào là đúng là một quyết định sản phẩm, và trả về một đáp án là giả vờ rằng quyết định ấy đã được đưa ra.

Luật

Một giải phẫu gọi tên các phần, khối nghỉ ở mấy lần lặp, mọi trạng thái nó vẽ, và ai sở hữu dữ liệu của nó. Nó không bao giờ gọi tên một class.

Một trạng thái mà region có thể vào mà giải phẫu không vẽ là một khuyết tật, không phải chi tiết để sau. Trạng thái được liệt kê trước khi thiết kế bất cứ thứ gì, vì một giải phẫu dựng cho trường hợp có dữ liệu thì lúc trường hợp rỗng xuất hiện là phải thiết kế lại, không phải nối thêm.

Đầu vào

Bảy, không hơn.

Đầu vào số 5 tồn tại vì contract không trả lời được nó. optional: true khai sự hiện diện và không gì hơn: đang tải, thất bại và rỗng đều rơi vào cùng một cờ đó. Tách chúng ra thì phải đọc từ source của page và block, không bao giờ được suy từ registry.

Không đọc ở tầng này: mảng class, biến theme, chữ theo locale, lint.

Đọc một region đã chấp nhận

1. Đòi một hash layout đã được chấp nhận. Layout đang ở trạng thái đề xuất không phải điểm bắt đầu.
2. Liệt kê trạng thái trước. Có dữ liệu, rỗng, đang tải, thất bại, một phần, bị chặn quyền — region này thật sự vào được những cái nào? Đọc từ source; không suy từ optional.
3. Tra các phần theo why, không theo hình, và kiểm mọi tên leaf và composite với từ vựng.
4. Chọn các trục mà những giải phẫu sẽ khác nhau ở đó. Trùng bộ trục là một giải phẫu.
5. Quyết ai sở hữu dữ liệu — khối tự fetch và cha truyền vào là hai sản phẩm khác nhau, không phải hai cách viết của một thứ.
6. Từ chối thay vì bịa. Region rỗng có phải một kết cục thật hay không là quyết định của người chủ, không phải một giá trị mặc định.

Trục giải phẫu

repeats mà không có restingCount thì bị từ chối: một khối lặp không có số lần nghỉ thì không có hình nào để rà soát.

Phán quyết mỗi phần

Mỗi phần ra đúng một trong ba, đối chiếu với contract và từ vựng:

Một lời trích không kiểm được với từ vựng là một cái tên bịa ra, phán quyết của nó ghi gì cũng vậy.

Luật cho giải phẫu

Mười bốn luật mà mọi giải phẫu phải thoả. Giải phẫu phạm một luật không phải là phương án yếu hơn — nó không phải một giải phẫu.

Quy tắc

1. Giải phẫu không mang class, không mang token, không mang màu.
2. Bộ trạng thái được liệt kê trước khi thiết kế, và giải phẫu vẽ đủ bộ đó.
3. repeats phải mang restingCount.
4. Mọi phần trích một cái tên có thật, hoặc khai một tên mới kèm why.
5. Không hai giải phẫu nào trong một lô trùng cả bộ trục.
6. 3–4 giải phẫu khi region cho phép hơn một; ít hơn thì kèm lý do, không bao giờ nhồi cho đủ.
7. Quyết định sản phẩm còn thiếu thì trả về cho người chủ.
8. JSON là dạng chuẩn hoá, và hash của nó là thứ lời chấp thuận gắn vào.
9. Feedback mở một lượt mới; giải phẫu đã chấp nhận không bao giờ bị sửa tại chỗ.

Từ chối

Từ chối là một đầu ra. Dùng nó khi:

• yêu cầu không nói region rỗng có phải một kết cục thật hay không;
• không xác định được ai sở hữu dữ liệu, từ region cũng như từ source;
• số lần nghỉ không được nói ra và region không cho cơ sở nào để chọn;
• một phần cần một thành phần không tồn tại — khi đó nó là đổi contract hoặc đổi component, không phải một lựa chọn giải phẫu.

refusal: returned-to-owner
missing: <quyết định chưa ai đưa ra>
blocked: <những phần không giải được nếu thiếu nó>

Đầu ra

Đầu ra chính là JSON, và thẩm quyền của nó là schema.json nằm cạnh bản ghi này. envelope giữ những thứ đổi theo lượt — kể cả layoutHash đã được chấp nhận mà region này đến từ — và hash chỉ phủ một giải phẫu.

{
  "schema": 1,
  "envelope": {
    "session": "coding-drill-result/2026-08-18",
    "round": 1,
    "project": "starci-academy",
    "region": "criteria",
    "layoutHash": "f5534ef5e7fbe30c385108fb95702a64ac66d905414e0f7105873d67822be54c"
  },
  "anatomies": [
    {
      "id": "a",
      "axes": {"dataOwner": "parent", "repetition": "repeats", "weight": "populated", "composition": "label-value"},
      "citesPrecedent": "none",
      "states": ["populated", "empty", "pending"],
      "restingCount": 4,
      "parts": [
        {
          "name": "criterion-row",
          "cites": {"kind": "entry", "verdict": "generalize", "from": "flashcard-result-fact-row", "to": "fact-row", "callSites": 1},
          "whyMatch": "a name read against one stored value, repeated as rows on a shared baseline"
        }
      ],
      "reason": "vì sao giải phẫu này đáng để người chủ đọc"
    }
  ]
}

Validate trước khi ghi và trước khi hash:

node <trust>/scripts/validate-artifact.mjs --schema <trust>/brainstorms/blocks/schema.json --data <batch.json> --hash

Ngoài hình dạng, validator còn từ chối class token ở bất cứ đâu trong lô, hai giải phẫu trùng bộ trục, một giải phẫu repeats mà thiếu restingCount, và một lô không có giải phẫu nào trích none.

Ví dụ đã giải

Region. “Danh sách tiêu chí trên trang kết quả bài luyện coding: mỗi tiêu chí kèm điểm.”

Trạng thái được đọc từ source trước: danh sách có dữ liệu khi lượt luyện có chấm tiêu chí, rỗng khi không chấm cái nào, và đang tải trong lúc kết quả về. Ba trạng thái, nên mọi giải phẫu đều vẽ ba.

Giải phẫu a dùng lại hình đã được chấp nhận với entry được generic hoá — một call site, nên đổi tên là một lần sửa. Giải phẫu b giữ cùng cái hình nhưng cho trạng thái rỗng gánh region, vì một lượt luyện không chấm được gì là một kết cục thật, và một danh sách im lặng bị đọc thành một lượt tải không bao giờ xong. Giải phẫu c là cái rời đi: bỏ hẳn lặp, các tiêu chí thành một hình gộp kèm chú thích, trích profile-breakdown.

Vì c trích none, cả lô có cái rời đi của nó. Không có nó thì a và b chỉ khác nhau một trục, và người chủ được xem một giải phẫu hai lần.

Phạm vi

Tầng này quyết định một khối gồm những gì và nó nợ những trạng thái nào. Nó không quyết định region nằm ở đâu — đó là layout — và không quyết định một class, đó là việc của luật. Mười bốn luật mà một giải phẫu phải thoả được phát biểu ở trên dưới dạng mã BLOCK-n, nên giải phẫu được đối chiếu với một mã trích dẫn được, không phải với trí nhớ của người đọc về cây legacy.