Kế hoạch trang web

PLAN.md được viết ngay khi lần xây dựng đầu tiên của dự án hoàn tất, và nó luôn nhằm mô tả trang web đúng như hiện tại — không phải nhật ký mọi việc từng xảy ra với nó (đó là việc của tab Phiên bản và Nhật ký thay đổi). Màn hình Kế hoạch trang web chuyển tài liệu Markdown đó thành giao diện thực: một bảng cho các trang, một danh sách cho các mô-đun, một danh sách kiểm cho các câu hỏi còn mở, và văn bản thuần cho thông tin doanh nghiệp, thương hiệu và quyết định.

Trước khi có lần xây dựng nào hoàn tất, chưa có gì để đọc: màn hình hiển thị "Chưa có kế hoạch", giải thích rõ rằng kế hoạch được viết bởi lần xây dựng đầu tiên của dự án, và đưa liên kết quay lại trang của chính dự án thay vì hiển thị một bảng trống.

Một trang web có tệp được gửi đến mà không có kế hoạch (được đăng từ công cụ AI khác qua trình kết nối, nhập vào, hoặc tải lên) vẫn sẽ có một kế hoạch: màn hình bắt đầu kế hoạch từ bản tóm tắt dự án, các lựa chọn bộ công cụ và các trang đã đo, và một biểu ngữ, Kế hoạch này được bắt đầu cho bạn, đưa ra nút Lưu kế hoạch này, giúp nó trở thành kế hoạch thực của dự án để mọi phần có thể được chỉnh sửa. Đọc toàn bộ kế hoạch trang web sẽ đưa bạn đến tài liệu kế hoạch trên tab Kế hoạch & tóm tắt.

Các công cụ thêm sau này từ Bộ công cụ (Thêm vào kế hoạch) sẽ xuất hiện trong danh sách Mô-đun với trạng thái Đã lên kế hoạch cùng liên kết Xem trong Bộ công cụ, ngay cả khi văn bản kế hoạch được viết trước khi chúng được thêm vào.

Dưới tiêu đề, một dòng cho biết kế hoạch được cập nhật lần cuối khi nào: "Đã cập nhật kế hoạch 2 thg 10, 3:04 CH". Thời gian đó lấy từ lần cuối aiKit đo các tệp thực của trang web, việc này diễn ra sau mọi thay đổi (chỉnh sửa qua chat, ghim, thêm từ Bộ công cụ, khôi phục, chỉnh sửa kế hoạch bằng tay, hoặc đăng từ công cụ AI khác).

Ở trên cùng, khi đã có kế hoạch: một thanh phần trăm hoàn thành tổng thể, và ba ô bên dưới: Trang đã xây (trên tổng số trang đã lên kế hoạch), Mô-đun đã xây (trên tổng số mô-đun đã chọn), và Câu hỏi đã trả lời (trên tổng số câu hỏi còn mở trong kế hoạch). Mỗi ô là một nút cuộn đến phần mà nó đếm. Không có gì trong số này do văn bản kế hoạch tự khai báo: một trang chỉ được tính là đã xây khi aiKit tìm thấy nó trong các tệp thực của trang web; một mô-đun chỉ được tính là đã xây khi có trong báo cáo xây dựng đã xác minh hoặc được tìm thấy trong các tệp; và một câu hỏi được tính là đã trả lời khi dòng của nó được đánh dấu xong trong kế hoạch hoặc khách hàng đã trả lời trên trang Câu hỏi của họ.

Có hai nguyên nhân khiến kế hoạch bị chậm cập nhật, và màn hình sẽ cho biết là nguyên nhân nào: lượt xử lý AI viết lại kế hoạch sau một thay đổi chưa hoàn tất ("Kế hoạch bằng văn bản chưa được cập nhật sau thay đổi gần nhất", kèm lý do), hoặc trang web có phiên bản mới hơn phiên bản mà kế hoạch đã được đo lường ("Trang web đã thay đổi sau lần cập nhật kế hoạch gần nhất"). Trong cả hai trường hợp, một nút "Làm mới kế hoạch" sẽ xuất hiện. Trang này không tự chạy khi bạn mở nó (mở trang không bao giờ dùng AI); công cụ đã tự động đưa từng thay đổi vào kế hoạch ở chế độ nền, và nút này dành cho trường hợp việc đó bị chậm. Làm mới kế hoạch sẽ đưa thay đổi mới nhất vào kế hoạch bằng văn bản và đo lại trang web. Nếu vẫn chưa thành công, biểu ngữ sẽ giữ nguyên thông tin về lỗi, và bạn có thể nhấn Làm mới kế hoạch lần nữa hoặc tự chỉnh sửa kế hoạch.

Thẻ Sức khỏe chấm điểm trang web trên thang 100 dựa trên các quy tắc aiKit kiểm tra trong các tệp thực, không bao giờ dựa trên ý kiến của AI: thiếu hoặc lặp lại tiêu đề trang hay mô tả tìm kiếm; trang không có tiêu đề chính hoặc có nhiều hơn một; liên kết đến trang không tồn tại; trang không ai liên kết tới và menu cũng không có; hình ảnh thiếu mô tả cho trình đọc màn hình; trang quá ngắn; biểu mẫu không có nơi gửi dữ liệu; và một mô-đun mà yêu cầu có nhưng trang web chưa có. Mỗi vấn đề cho biết trang nào, vì sao quan trọng, và có nút Sửa: Sửa sẽ gửi hướng dẫn sẵn có của vấn đề như một yêu cầu và giao cho AI, nút hiển thị "Đã gửi yêu cầu sửa" trong lúc xử lý, và điểm số được đo lại khi thay đổi được áp dụng. Lọc danh sách theo mức độ nghiêm trọng bằng các số đếm Cao, Trung bình và Thấp; "Hiện tất cả" sẽ xóa bộ lọc.

Sơ đồ trang vẽ website dưới dạng cây: trang chủ ở trên cùng, tiếp theo là menu theo thứ tự, rồi đến các trang được truy cập từ những trang đó. Các trang không ai liên kết tới được xếp trong nhóm riêng; các trang có trong kế hoạch nhưng chưa xây được vẽ nét đứt và đánh dấu Đã lên kế hoạch; các trang đã xây mà kế hoạch chưa nhắc tới được đánh dấu "Không có trong kế hoạch" kèm nút "Thêm vào kế hoạch" để đưa chúng vào mục Trang.

Nhấn vào bất kỳ trang nào (trong sơ đồ trang hoặc danh sách Trang) để mở chi tiết trang bên cạnh kế hoạch. Thanh địa chỉ sẽ đổi thành ?page=/about, nên liên kết sẽ mở đúng trang đó cho bất kỳ ai trong nhóm. Chi tiết cho biết trang hiển thị thế nào trên Google (tiêu đề, địa chỉ, mô tả), các phần và tiêu đề chính, số từ, hình ảnh và bao nhiêu hình thiếu mô tả, các biểu mẫu và mô-đun nào trong bộ công cụ đang xử lý chúng, khách hàng đã duyệt trang hay chưa, và thay đổi gần nhất: khi nào, ai yêu cầu, và họ đã yêu cầu gì.

Lịch sử liệt kê các phiên bản aiKit lưu giữ (Bản gốc và 10 phiên bản mới nhất), mới nhất đứng trước: số thứ tự, loại thay đổi (Xây dựng lần đầu, Trò chuyện, Ghim, Bộ công cụ, Xuất bản, Khôi phục, Chỉnh sửa kế hoạch), thời điểm, nội dung yêu cầu, người yêu cầu, và các trang đã thay đổi (nhấn vào trang để mở chi tiết). Phiên bản mới nhất được đánh dấu Phiên bản hiện tại; mỗi phiên bản cũ hơn có "Khôi phục phiên bản này", nút này hỏi xác nhận trước và lưu trạng thái hiện tại trước khi đưa trang web trở lại, nên việc khôi phục có thể hoàn tác. Ba phiên bản đầu được hiển thị; "Hiện tất cả" sẽ liệt kê phần còn lại.

Mục Thông tin doanh nghiệp so sánh số điện thoại, email, địa chỉ và giờ làm việc trong Hồ sơ khách hàng với nội dung các trang đã xây (trang chủ và trang liên hệ được ưu tiên). Mỗi thông tin hiển thị "Có trên trang web" hoặc "Không tìm thấy trên trang web" (kèm số trang đã kiểm tra, vì trang web có thể còn hiển thị giá trị cũ), và liên kết "Sửa trong Hồ sơ khách hàng" giúp Hồ sơ khách hàng luôn là nguồn dữ liệu chính.

• Trang — một bảng gồm: Trang, Đường dẫn, Mục đích và Trạng thái (Đã xây hoặc Đã lên kế hoạch), có liên kết "Xem" đến trang trực tiếp khi trang đã được xây và website đã đưa lên mạng.
• Mô-đun và công cụ — mọi mô-đun kế hoạch liệt kê, mỗi mục có nhãn Đã xây hoặc Đã lên kế hoạch và ghi chú riêng.
• Thông tin doanh nghiệp — giờ làm việc, địa chỉ, dịch vụ, giá cả, và mọi thông tin thực tế về doanh nghiệp, viết dưới dạng văn bản thuần.
• Thương hiệu — bảng màu, giọng điệu và mọi ghi chú về phong cách mà kế hoạch đã ghi nhận.
• Quyết định — những lựa chọn thực sự đã được đưa ra và không nên bị bàn lại trong lần chỉnh sửa tiếp theo.
• Câu hỏi còn mở — danh sách kiểm tra những việc thực sự chưa được quyết định, mỗi việc hiển thị đã trả lời hoặc còn mở.

Mỗi thẻ mục đều có hai nút giống nhau. "Sửa" mở nội dung Markdown thô của mục đó trong một ô văn bản đơn giản và lưu trực tiếp vào PLAN.md — đây là thao tác ghi thật, ngay lập tức (qua điểm cuối PUT của dự án), nhưng cố ý không kích hoạt xây dựng hay triển khai; nó chỉ thay đổi những gì tài liệu kế hoạch ghi, giống như chỉnh sửa bất kỳ ghi chú nào khác.

"Yêu cầu thay đổi" thì khác có chủ ý: nó mở một biểu mẫu nhỏ ("Bạn muốn thay đổi gì trong <section>?"), và khi gửi, nó tạo một yêu cầu thật trong tab Phản hồi của dự án — có nhãn "Kế hoạch website — <Section>: …" — giống hệt mọi yêu cầu ghim hoặc Chỉnh sửa nhanh, với vòng đời trạng thái riêng và liên kết "Xem yêu cầu" sau khi đã gửi. Dùng Chỉnh sửa khi bạn tự sửa hoặc viết lại chính nội dung của kế hoạch; dùng Yêu cầu thay đổi khi bạn muốn website thực tế (và từ đó là kế hoạch) được cập nhật cho khớp.

Kế hoạch có hai lớp. Các số liệu (trang, tiêu đề, phần, liên kết, biểu mẫu, mô-đun, tình trạng) do mã nguồn lấy trực tiếp từ các tệp thật sau mỗi lần thay đổi, nên không thể lệch khỏi thực tế. Phần kế hoạch bằng văn bản (mục tiêu, thông tin doanh nghiệp, thương hiệu, quyết định, câu hỏi còn mở) được giữ cập nhật bởi một lượt xử lý AI chạy sau mỗi thay đổi, và chỉ viết lại những phần mà thay đổi đó đã tác động. Lượt này không bao giờ thêm nhật ký thay đổi hay mục ghi theo ngày; Lịch sử là nơi lưu lại các thay đổi.

Nếu lượt xử lý AI đó thất bại, kế hoạch bằng văn bản sẽ được giữ nguyên thay vì bị viết lại dở dang, lỗi được ghi lại, và màn hình hiển thị nút Làm mới kế hoạch (xem phía trên) thay vì âm thầm hiển thị một kế hoạch đã lỗi thời.

Một thanh bên cạnh kế hoạch chứa các thao tác (trên điện thoại, thanh này trở thành nút "Sao chép liên kết cho khách hàng" toàn chiều rộng ngay dưới dải tiến độ, phần còn lại được gom vào "Thao tác khác (3)"). "Chia sẻ với khách hàng" sao chép một liên kết chỉ đọc (aikit.ai/p/<project>/plan) — không có công cụ nội bộ, không có nút chỉnh sửa, không có nội dung nội bộ. "Mở trang web trực tiếp" là liên kết trực tiếp đến trang web đang hoạt động, hoặc thanh sẽ ghi rõ "Chưa đưa lên mạng" nếu chưa hoạt động. "Tệp" hiển thị số tệp thực tế cùng danh sách có thể mở rộng gồm đường dẫn và dung lượng của từng tệp. "Tải kế hoạch" tải xuống tệp PLAN.md hiện tại dưới dạng tệp .md thật, đúng từng byte mà màn hình đang đọc — không phải bản tóm tắt được tạo lại.

Trang của khách hàng mở ra ở tab Kế hoạch: cùng tài liệu kế hoạch trang web mà nhân viên xem ở tab Kế hoạch & tóm tắt (tổng quan và mục tiêu, khách hàng mục tiêu, chiến lược, sơ đồ trang, mọi công cụ cùng tác dụng với doanh nghiệp và trạng thái, kế hoạch nội dung, lịch trình, quyết định và câu hỏi còn mở), nhưng không có các phần chỉ dành cho nhân viên: không có ghi chú được nhập khi thêm công cụ, không có tên người thêm từng mục, không có liên kết vào Bộ công cụ của aiKit, và không có nút Viết kế hoạch. Tab thứ hai, Trang & phê duyệt, giữ chế độ xem từng trang bên dưới.

Ở Trang & phê duyệt, được bảo vệ bằng cùng mã truy cập mà họ đã dùng để gửi phản hồi (không cần đăng nhập riêng), khách hàng thấy cùng dải tiến độ, Sơ đồ trang của họ, danh sách Trang với các liên kết "Xem", các mô-đun, thông tin doanh nghiệp, thương hiệu, quyết định và câu hỏi còn mở, cùng dòng "Kế hoạch đã cập nhật". Họ không thấy Sức khỏe, hướng dẫn sửa lỗi, Lịch sử, ai đã yêu cầu gì, danh sách tệp, hay bất kỳ nút Chỉnh sửa hoặc Yêu cầu thay đổi nào.

Mọi nội dung nhân viên đánh dấu chỉ dành cho nội bộ đều bị xóa trên máy chủ trước khi trang được gửi đi, ở mọi phần: một dòng có "(internal)", "[internal]" hoặc "(staff only)", một dòng bắt đầu bằng "Internal:" hoặc "Staff only:", bất kỳ phần nào có tiêu đề ghi Internal hoặc Staff only, và các chú thích ẩn. Những dòng đó không bao giờ đến trình duyệt của khách hàng, kể cả trong dữ liệu mạng của trang.

Mỗi trang đã xây dựng có nút Phê duyệt. Khách hàng nhập tên (và ghi chú tùy chọn) rồi phê duyệt; việc phê duyệt được gắn với đúng nội dung của trang đó, nên nếu trang thay đổi sau này, trang sẽ hiển thị "Đã thay đổi kể từ khi bạn phê duyệt" và hỏi lại. Chỉ người dùng có mã truy cập của khách hàng mới có thể phê duyệt. Nếu bạn mở liên kết khách hàng khi đăng nhập bằng tài khoản nhân viên, bạn sẽ thấy trạng thái phê duyệt của từng trang nhưng không có nút Phê duyệt, nên không ai có thể phê duyệt thay khách hàng. Trên Kế hoạch trang web của nhân viên, các trang đã được phê duyệt hiển thị "Khách hàng đã phê duyệt" và các trang đã thay đổi hiển thị "Đã thay đổi kể từ khi phê duyệt."

Ở cuối trang có nút "Gửi phản hồi": nếu trang web đã hoạt động, nút sẽ mở trang web thật với lớp phản hồi đã được bật sẵn (bằng mã truy cập riêng của khách hàng); nếu chưa hoạt động, nút sẽ chuyển đến trang Cập nhật gần đây thay thế.