Bỏ qua nội dung
VNexus VNexus Requirement

Về tài liệu này

Bộ tài liệu này là gì?

Đây là nguồn requirement tập trung cho dự án V-Nexus (Frontend + Backend).

Phạm vi tài liệu:

  • Mô tả chức năng, luồng nghiệp vụ và điều kiện chấp nhận.
  • Quản lý phụ thuộc giữa các feature.
  • Tập trung vào nội dung tài liệu, không chứa phân công nhân sự.

Tài liệu này không bao gồm

  • Kế hoạch implement code chi tiết.
  • Thiết kế DB schema kỹ thuật.
  • Chữ ký API endpoint implementation-level.
  • Phân công thành viên, ownership cá nhân, audit log thao tác người dùng.

Cấu trúc chính

Khu vựcMục đích
/ (Tổng quan)Dashboard nhanh: KPI, điểm cần chú ý, feature mới cập nhật
/features/Danh sách toàn bộ feature, lọc theo status/priority/platform
/impact/Bản đồ phụ thuộc giữa feature
/system/*Yêu cầu hệ thống (RBAC, Rate Limit, Redis, Address Reference, …) — sidebar nhóm Thiết kế hệ thống

Quy ước vận hành

  • Mỗi feature có status, priority, last_reviewed trong meta.json.
  • Tổng quan gợi ý feature cần chú ý: draft lâu, P0 còn draft, in-development không cập nhật.

Nguồn dữ liệu

  • Dữ liệu feature: docs/features/<id>/spec.md, docs/features/<id>/meta.json.
  • Yêu cầu hệ thống: docs/system/<slug>.mdx (frontmatter sidebar.label, sidebar.order).
  • Build/sync tự động: site/scripts/sync-content.mjs.
  • Chỉ số tổng hợp: docs/INDEX.md, docs/impact-map.json, docs/llms.txt, docs/llms-full.txt.
  • Feature: bắt buộc meta.module (không rõ thì hỏi PO/Dev, không tự gán) → npm run generate:sidebar → nhóm Features trên sidebar theo module.
  • System: docs/system/<slug>.mdx + sidebar.order → nhóm Thiết kế hệ thống (autogenerate).
  • Quy tắc tạo feature (module + sidebar): .claude/commands/new-spec.md trong repo.