Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[P1] frontend: Complete ADR-007 feature route mapping

Đang mở
  • Có gì không ổn?
#222 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
30/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
typescript
Lĩnh vực
api, frontend

Hướng nghiên cứu

Bắt đầu với docs/adr/007-frontend-modernization.md, frontend/README.md, frontend/app/evaluation/page.tsx và frontend/components/Configuration/Cases.tsx; lập bản đồ điều hướng hiện có và các phụ thuộc dịch vụ/API trước khi thay đổi các route. Kiểm tra các issue liên quan #123, #147 và #143 để nắm các ràng buộc. Công việc được xem là hoàn tất khi các route và surface bắt buộc đã được triển khai hoặc được chủ ý loại bỏ, tài liệu đã được cập nhật, và pnpm --dir frontend lint cùng build chạy thành công.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

frontend priority:P1 type:feature

Problem inventory

ADR-007 defines required frontend capabilities that are only partially mapped today. Some routes redirect to utility/config pages, some expected routes are absent, and one configuration component is empty.

Type: feature gap / integration regression risk

Evidence

  • docs/adr/007-frontend-modernization.md specifies /evaluation, /evaluation/[runId], and /avatar/settings.
  • frontend/app/evaluation/page.tsx only redirects to /configuration/evaluation; there is no dedicated EvalDashboard or /evaluation/[runId] run viewer.
  • frontend/app/avatar/settings is absent, while ADR-007 expects avatar parameter selection persisted through PUT /api/avatar/config.
  • frontend/components/Configuration/Cases.tsx is an empty stub while configuration navigation exposes cases.
  • frontend/README.md says the UI covers Avatar, Chat, Essays, Questions, Configuration, Upskilling, Evaluation, LMS Gateway, and APIM-routed backend traffic, so route mapping must be complete and trustworthy.

Impact assessment

User impact: high. New functionality appears present in documentation/navigation but is not consistently reachable as mature product UI.
Blast radius: frontend routes, workspace navigation, API client integration, and service-contract expectations.

Acceptance criteria

  • Produce a route-to-capability map for all public, workspace, and configuration routes, including which backend service/API path each route depends on.
  • Implement or finalize a mature /evaluation dashboard for run history, quality trends, dataset visibility, and degraded-state status.
  • Implement /evaluation/[runId] for per-run details using the evaluation service contract.
  • Implement /avatar/settings with voice, language, speaking style, avatar style, response length, and expertise level controls; persist with PUT /api/avatar/config when the backend route is available or define the exact backend contract if missing.
  • Replace the empty cases stub with a mature cases management surface or remove the entry from navigation with documented rationale.
  • Ensure every workspace navigation item resolves to a real page with role-appropriate copy and no unexpected redirect to a configuration utility page unless intentionally documented.
  • Update frontend README or modernization docs with the completed route map and any deferred gaps.
  • pnpm --dir frontend lint and build pass.

Agent assignment

Primary specialist: TypeScriptDeveloper
Architecture validation: SystemArchitect
UI validation: UIDesigner

Dependency notes

This should precede broad UI cleanup where route removal/retirement is being considered.

Related backlog

  • #123 avatar restructuring may affect the settings implementation.
  • #147 avatar runtime incident is related to service readiness, not the settings UI itself.
  • #143 touches frontend evaluation/history display quality.
Ngôn ngữ chính
Python
Star
17
Fork
8
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của Azure-Samples/tutor

Tất cả issue của Azure-Samples/tutor

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.