Quản trị dự án và phân tích kiến trúc

NKLattice là CLI chạy cục bộ để đánh giá governance của dự án React. Bản đánh giá kiểm tra danh sách app, ngưỡng dependency đã duyệt, kiến trúc mã nguồn, advisory dependency, chất lượng mã, bảo mật mã và tương thích trình duyệt/mobile. Lệnh phân tích kiến trúc cục bộ cũng dùng để khám phá. Công cụ hỗ trợ Next.js, Vite + React và React trong workspace npm/pnpm hoặc repo độc lập.

Phiên bản đang phát hành trên npm là @anhcodo13/lattice@0.5.0. Gói yêu cầu Node.js 24 trở lên và cung cấp lệnh lattice. Tên sản phẩm và repository là NKLattice.

Repository lõi lưu policy và workflow CI dùng lại. Repo tiêu thụ cung cấp inventory, manifest, lockfile và source. Bản đánh giá trả lời: app nào tuân thủ các rule thực sự được policy kiểm tra, và chỗ nào chưa đủ bằng chứng?

Chọn việc cần làm

Nhu cầu	Lệnh	Kết quả
Đánh giá policy dự án trước triển khai	lattice governance collect + assess (npm 0.5.0)	Kết quả đạt, không đạt hoặc chưa đủ bằng chứng theo app ở tám miền; báo cáo JSON và HTML.
Chỉ kiểm tra phiên bản dependency	lattice governance check (npm 0.5.0)	Sai lệch theo ứng dụng/gói; mã thoát 7 nếu lệch.
Xem quan hệ import và cấu trúc component	lattice analyze	report.html mở offline và analysis.json.
Xác nhận thư mục có mã nguồn được hỗ trợ	lattice doctor	Phiên bản Node đang chạy và số tệp có thể quét.

Quản trị dự án giải thích inventory chính xác, kiểm tra package trực tiếp và gate kiến trúc trung tâm. Phân tích kiến trúc mô tả finding và lệnh khám phá cục bộ. Finding là dấu hiệu cần review, chưa khẳng định mã có lỗi.

Vị trí trong quy trình triển khai

1. Maintainer core review ngưỡng dependency và gate kiến trúc trong cùng policy.
2. Repo tiêu thụ commit inventory chính xác, đồng bộ manifest, lockfile và source.
3. PR của app chạy governance assess; vi phạm policy thất bại, thiếu bằng chứng giữ trạng thái incomplete.
4. Job deploy phụ thuộc job governance. analyze riêng vẫn dùng để khám phá và trả mã 0 dù có finding.

Workflow mẫu cho app thể hiện quan hệ giữa các job. Bản này chưa tự sửa manifest, mở PR nâng cấp hay duy trì danh mục tập trung của các repo sử dụng.

Phạm vi hiện tại

• Quét source: file ts, tsx, js, jsx, mts, mjs, cts, cjs. Việc resolve import nội bộ dùng tsconfig.json ở gốc được phân tích nếu có.
• Profile governance: next, vite-react, react; đọc trực tiếp dependencies, devDependencies, optionalDependencies.
• Lockfile: npm phiên bản 3 và pnpm phiên bản 9. Chưa hỗ trợ Yarn hoặc Bun.
• Báo cáo cục bộ: HTML có sẵn dữ liệu/script/style và file JSON đi kèm. Analyzer không tải mã nguồn lên dịch vụ.

Parser không build app production, không type-check app và không theo mọi dynamic import hoặc dependency lúc chạy. Điểm số hỗ trợ review, không phải điểm hiệu năng, bảo mật hay độ đúng của mã.

Hãy bắt đầu với hướng dẫn chạy thử, rồi đọc trang dành cho tác vụ bạn định đưa vào CI.