np-dms/lcbp3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
268f34198b86cb9726eff9d0a8aed6242eab0003
lcbp3/specs/200-fullstacks/224-intent-classification/tasks.md
T
admin ea5499123e
CI / CD Pipeline / build (push) Failing after 3m57s
Details
CI / CD Pipeline / deploy (push) Has been skipped
Details
690519:1631 224 to 226 AI #01
2026-05-19 16:31:50 +07:00

14 KiB
Raw Blame History

Tasks: Intent Classification System

Input: Design documents from /specs/200-fullstacks/224-intent-classification/ Prerequisites: plan.md, spec.md, data-model.md, contracts/, research.md, quickstart.md

Organization: Tasks grouped by user story to enable independent implementation

Format: [ID] [P?] [Story] Description

  • [P]: Can run in parallel (different files, no dependencies)
  • [Story]: User story label (US1, US2, US3, US4)
  • Include exact file paths in descriptions

Phase 1: Setup (Shared Infrastructure)

Purpose: Database schema และ seed ข้อมูลเริ่มต้น

  • T001 สร้าง SQL Delta file สำหรับตาราง ai_intent_definitions และ ai_intent_patterns ที่ specs/03-Data-and-Storage/deltas/16-add-intent-classification.sql
  • T002 [P] สร้าง Seed file สำหรับ 12 Intent Definitions ที่ backend/src/database/seeds/ai-intent.seed.ts
  • T003 [P] เพิ่ม Configuration สำหรับ Ollama และ Intent Classification ใน backend/.env.example
  • T004 [P] เพิ่ม TypeScript interfaces สำหรับ Classification Result ที่ backend/src/modules/ai/intent-classifier/interfaces/classification-result.interface.ts

Phase 2: Foundational (Blocking Prerequisites)

Purpose: Core infrastructure ที่ต้องเสร็จก่อน User Stories

⚠️ CRITICAL: ต้องเสร็จก่อนถึงจะเริ่ม User Stories ได้

  • T005 สร้าง IntentDefinition Entity ที่ backend/src/modules/ai/intent-classifier/entities/intent-definition.entity.ts
  • T006 [P] สร้าง IntentPattern Entity ที่ backend/src/modules/ai/intent-classifier/entities/intent-pattern.entity.ts
  • T007 สร้าง IntentPatternCache Service (Redis) ที่ backend/src/modules/ai/intent-classifier/services/intent-pattern-cache.service.ts
  • T008 สร้าง Ollama Client Service ที่ backend/src/modules/ai/intent-classifier/services/ollama-client.service.ts พร้อม timeout และ error handling
  • T009 สร้าง LLM Semaphore (Promise-based) ที่ backend/src/modules/ai/intent-classifier/services/llm-semaphore.service.ts
  • T010 [P] Regex Validation — embedded ใน IntentPatternService.validateRegex() (ไม่แยก helper file)
  • T011 สร้าง IntentClassifierService (Core Logic) ที่ backend/src/modules/ai/intent-classifier/services/intent-classifier.service.ts รวม Pattern Match + LLM Fallback
  • T012 สร้าง IntentClassifierModule ที่ backend/src/modules/ai/intent-classifier/intent-classifier.module.ts
  • T013 Update AiModule เพื่อ import IntentClassifierModule ที่ backend/src/modules/ai/ai.module.ts

Checkpoint: Foundation ready — พร้อมเริ่ม User Story implementation

Phase 3: User Story 1 - Admin จัดการ Intent Definitions และ Patterns (Priority: P1) 🎯 MVP

Goal: Admin สามารถสร้าง Intent และ Patterns ผ่าน API และใช้งานได้ภายใน 5 นาที

Independent Test: สร้าง Intent → เพิ่ม Pattern → ทดสอบ Classification → Pattern Match ต้องทำงาน

Tests for User Story 1

  • T014 [P] [US1] Unit test สำหรับ IntentDefinitionService — intent-definition.service.spec.ts (9 tests)
  • T015 [P] [US1] Unit test สำหรับ IntentPatternService — intent-pattern.service.spec.ts (12 tests)
  • T016 [P] [US1] Integration test สำหรับ Admin API — intent-admin.controller.spec.ts (10 tests)

Implementation for User Story 1

  • T017 [P] [US1] สร้าง DTOs สำหรับ Admin API ที่ backend/src/modules/ai/intent-classifier/dto/
  • T018 [P] [US1] สร้าง IntentDefinitionService (CRUD) ที่ backend/src/modules/ai/intent-classifier/services/intent-definition.service.ts
  • T019 [P] [US1] สร้าง IntentPatternService (CRUD + Regex validation + intentCode existence check) ที่ backend/src/modules/ai/intent-classifier/services/intent-pattern.service.ts
  • T020 [US1] สร้าง IntentAdminController (Admin endpoints) ที่ backend/src/modules/ai/intent-classifier/controllers/intent-admin.controller.ts
  • T021 [US1] เพิ่ม JwtAuthGuard + RbacGuard บน Admin endpoints
  • T022 [US1] เพิ่ม Audit logging สำหรับการแก้ไข Intent และ Patterns — @Audit decorator on admin endpoints

Checkpoint: User Story 1 complete — Admin จัดการ Intent/Patterns ได้

Phase 4: User Story 2 - User สอบถามข้อมูลผ่าน AI Chat (Priority: P1)

Goal: User ถามคำถามธรรมชาติ → ระบบ Classify เป็น Intent ที่ถูกต้อง

Independent Test: ส่งคำถาม "สรุปเอกสารนี้" → ต้องได้ Intent SUMMARIZE_DOCUMENT ด้วย Pattern Match (< 10ms)

Tests for User Story 2

  • T023 [P] [US2] Unit test สำหรับ Pattern Matching logic ที่ backend/src/modules/ai/intent-classifier/services/pattern-matcher.service.spec.ts
  • T024 [P] [US2] Unit test สำหรับ LLM Semaphore ที่ backend/src/modules/ai/intent-classifier/services/llm-semaphore.service.spec.ts
  • T025 [P] [US2] Unit test สำหรับ IntentClassifierService ที่ backend/src/modules/ai/intent-classifier/services/intent-classifier.service.spec.ts
  • T026 [P] [US2] Integration test สำหรับ Classification API — intent-classify.controller.spec.ts (3 tests)

Implementation for User Story 2

  • T027 [P] [US2] สร้าง PatternMatcher Service ที่ backend/src/modules/ai/intent-classifier/services/pattern-matcher.service.ts
  • T028 [P] [US2] LLM Fallback — implemented ใน ollama-client.service.ts + intent-classifier.service.ts (ไม่แยก service)
  • T029 [US2] สร้าง Classification API POST /ai/intent/classify ที่ backend/src/modules/ai/intent-classifier/controllers/intent-classify.controller.ts + @Throttle(30/min)
  • T030 [US2] เพิ่ม Input validation (max 200 chars, trim) ใน classify-query.dto.ts
  • T031 [US2] สร้าง Audit logging สำหรับทุก Classification request — ClassificationAuditService (FR-010)
  • T032 [US2] Seed initial patterns สำหรับ 12 intents (v1) — deltas/17-seed-intent-patterns.sql

Checkpoint: User Story 2 complete — Classification ทำงานได้ (Pattern + LLM Fallback)

Phase 5: User Story 3 - ตรวจสอบและวิเคราะห์ประสิทธิภาพ (Priority: P2)

Goal: Admin สามารถดู Analytics และวิเคราะห์ประสิทธิภาพของ Intent Classification

Independent Test: ดูหน้า Analytics → แสดง Hit Rate, Confidence Distribution, Latency ได้

Tests for User Story 3

  • T033 [P] [US3] Unit test สำหรับ Analytics Service — intent-analytics.service.spec.ts (8 tests)

Implementation for User Story 3

  • T034 [P] [US3] สร้าง IntentAnalyticsService ที่ backend/src/modules/ai/intent-classifier/services/intent-analytics.service.ts
  • T035 [US3] สร้าง Analytics API endpoint GET /admin/ai/intent-analytics ที่ controllers/intent-analytics.controller.ts
  • T036 [US3] สร้าง Analytics UI Components ที่ frontend/components/ai/intent-classification/analytics/ (4 components)
  • T037 [US3] สร้างหน้า Analytics Dashboard ที่ frontend/app/(admin)/admin/ai/intent-classification/analytics/page.tsx

Checkpoint: User Story 3 complete — Analytics แสดงผลได้

Phase 6: User Story 4 - Test Console สำหรับทดสอบ Intent (Priority: P2)

Goal: Admin/Developer สามารถทดสอบคำถามแบบ Real-time ผ่าน UI

Independent Test: พิมพ์คำถามใน Test Console → แสดงผล Classification Result พร้อม Method และ Confidence

Tests for User Story 4

  • T038 [P] [US4] Unit test สำหรับ Test Console Hook ที่ frontend/hooks/ai/__tests__/use-intent-classification.test.ts (9 tests)

Implementation for User Story 4

  • T039 [P] [US4] สร้าง useIntentClassification hook ที่ frontend/hooks/ai/use-intent-classification.ts
  • T040 [P] [US4] สร้าง TestConsolePanel component ที่ frontend/components/ai/intent-classification/test-console-panel.tsx
  • T041 [P] [US4] สร้าง ClassificationResultCard component ที่ frontend/components/ai/intent-classification/classification-result-card.tsx
  • T042 [US4] สร้างหน้า Test Console ที่ frontend/app/(admin)/admin/ai/intent-classification/test-console/page.tsx

Checkpoint: User Story 4 complete — Test Console ใช้งานได้

Phase 7: User Story 5 - Admin UI สำหรับจัดการ Intent และ Patterns (Priority: P2)

Goal: Admin สามารถจัดการ Intent Definitions และ Patterns ผ่าน UI

Independent Test: สร้าง Intent ใหม่ผ่าน UI → เพิ่ม Pattern → ทดสอบ Classification → ต้องทำงาน

Implementation for User Story 5

  • T043 [P] [US5] สร้าง AI Intent Service (API client) ที่ frontend/lib/services/ai-intent.service.ts
  • T044 [P] [US5] สร้าง IntentForm component ที่ frontend/components/ai/intent-classification/intent-form.tsx
  • T045 [P] [US5] สร้าง PatternForm component ที่ frontend/components/ai/intent-classification/pattern-form.tsx
  • T046 [US5] สร้างหน้า Intent Definitions List ที่ frontend/app/(admin)/admin/ai/intent-classification/page.tsx
  • T047 [US5] สร้างหน้า Intent Detail + Patterns ที่ frontend/app/(admin)/admin/ai/intent-classification/[intentCode]/page.tsx

Checkpoint: User Story 5 complete — Admin UI ครบถ้วน

Phase 8: Polish & Cross-Cutting Concerns

Purpose: Improvements ที่กระทบทุก User Stories

  • T048 [P] เพิ่ม i18n keys สำหรับ Intent Classification UI ที่ frontend/public/locales/th/ai.json และ frontend/public/locales/en/ai.json
  • T049 [P] เพิ่ม Documentation สำหรับ Intent Classification API ที่ docs/ai-knowledge-base/playbooks/intent-classification.md
  • T050 รัน quickstart.md validation — ตรวจสอบ: 44 backend tests + 9 frontend tests pass
  • T051 [P] Performance testing สำหรับ Pattern Match latency (< 10ms target) ที่ backend/tests/performance/pattern-matcher.perf-spec.ts
  • T052 Security review: ตรวจสอบ Regex injection, CASL guards, Rate limiting (@Throttle added)
  • T053 [P] Code review และ refactoring (@Exclude on id, intentCode validation, error handling)

Dependencies & Execution Order

Phase Dependencies

  • Setup (Phase 1): No dependencies — เริ่มได้ทันที
  • Foundational (Phase 2): ขึ้นกับ Phase 1 — BLOCKS ทุก User Stories
  • User Stories (Phase 3-7): ขึ้นกับ Phase 2
    • US1, US2 (P1): ทำก่อน (MVP)
    • US3, US4, US5 (P2): ทำทีหลัง
  • Polish (Phase 8): ขึ้นกับทุก User Stories ที่ต้องการ

User Story Dependencies

  • US1 (Admin Management): ไม่มี dependency — เริ่มได้หลัง Foundational
  • US2 (Classification): ไม่มี dependency — เริ่มได้หลัง Foundational
  • US3 (Analytics): ขึ้นกับ US2 (ต้องมี Classification data ก่อน)
  • US4 (Test Console): ขึ้นกับ US2 (ต้องมี Classification API ก่อน)
  • US5 (Admin UI): ขึ้นกับ US1 (ใช้ API เดียวกัน)

Parallel Opportunities

  • ภายใน Phase 1: T002-T004 ทำ parallel ได้
  • ภายใน Phase 2: T006, T010, T013 ทำ parallel ได้
  • หลัง Phase 2 เสร็จ: US1 และ US2 ทำ parallel ได้
  • หลัง US1 + US2 เสร็จ: US3, US4, US5 ทำ parallel ได้

Implementation Strategy

MVP First (US1 + US2 Only)

  1. ✅ Phase 1: Setup — DONE (T001-T004)
  2. ✅ Phase 2: Foundational — DONE (T005-T013)
  3. ✅ Phase 3: US1 (Admin Management) — DONE (T017-T021, tests deferred)
  4. ✅ Phase 4: US2 (Classification) — DONE (T023-T030, audit deferred)
  5. ✅ Phase 6: US4 (Test Console) — DONE (T039-T042)
  6. ✅ Phase 7: US5 (Admin UI) — DONE (T043-T047)
  7. ✅ Phase 8: i18n + Security + Code Review — DONE (T048, T052, T053)
  8. ✅ Remaining tasks (T014-T015, T022, T031-T032, T038, T049-T051) — DONE
  9. ✅ All remaining tasks (T016, T026, T033-T037) — DONE
  10. 🎉 ALL 52 TASKS COMPLETE — Ready for deploy/demo

Incremental Delivery

  1. Phase 1 + 2 → Foundation ready
  2. US1 + US2 → Test → Deploy (MVP!)
  3. US3 (Analytics) → Test → Deploy
  4. US4 (Test Console) → Test → Deploy
  5. US5 (Admin UI) → Test → Deploy

Parallel Team Strategy

ด้วยทีมหลายคน:

  • Developer A: US1 + US5 (Admin ทั้ง Backend + Frontend)
  • Developer B: US2 (Classification Core)
  • Developer C: US3 + US4 (Analytics + Test Console)

Summary

Phase Tasks Description
1 Setup 4 SQL Delta, Seed, Config, Interfaces
2 Foundational 9 Entities, Services, Module
3 US1 (P1) 9 Admin Management API
4 US2 (P1) 10 Classification Core
5 US3 (P2) 4 Analytics
6 US4 (P2) 5 Test Console
7 US5 (P2) 5 Admin UI
8 Polish 6 i18n, Docs, Performance, Security
Total 52

MVP Scope: T001-T032 (Phase 1-4) = 35 tasks

Reference in New Issue View Git Blame Copy Permalink