update first - 84

This commit is contained in:
thanhnv
2026-06-30 02:21:39 +09:00
commit 07ac1bdcdd
561 changed files with 88164 additions and 0 deletions
@@ -0,0 +1,11 @@
# BD-MOD-01 OKR Management
## Screen Layout
- SCR-00 Login: centered sign-in form without sidebar.
- SCR-01 Dashboard: fixed sidebar, fixed header, filter bar, OKR list.
- SCR-02 Detail: objective overview, tabs, key result list.
- SCR-03 Create Objective: title, description, owner, quarter, save.
- SCR-04 Key Result Detail: current progress, progress input, comment, save.
## API Boundary
Frontend calls backend only through src/lib/api.ts and uses cookie/JWT auth.
@@ -0,0 +1,10 @@
# DD-MOD-01 OKR Management
## Backend Design
Controllers are thin and call AuthService, UsersService, ObjectivesService, KeyResultsService. PrismaService is the only database access layer.
## Authorization
JwtAuthGuard verifies Bearer/cookie token. Employees are constrained to ownerId == user.sub. Managers/Admins read all objectives.
## Progress Calculation
KeyResultsService updates progress in a transaction, writes ProgressUpdate, then recalculates objective status.
@@ -0,0 +1,28 @@
# SRS-MOD-01 OKR Management
## TABLE OF CONTENTS
- [1. Purpose](#1-purpose)
- [2. Scope](#2-scope)
- [3. Functional Requirements](#3-functional-requirements)
- [4. Non Functional Requirements](#4-non-functional-requirements)
## 1. Purpose
Hệ thống quản lý OKR hỗ trợ đăng nhập, tạo Objective, tạo Key Result, cập nhật tiến độ và dashboard theo tài liệu yêu cầu.
## 2. Scope
Module bao gồm SCR-00 đến SCR-04, ba vai trò Admin, Manager, Employee, và dữ liệu User, Objective, Key Result.
## 3. Functional Requirements
- FR-01 Login: xác thực username/password và phát hành JWT.
- FR-02 Create Objective: tạo Objective có title, description, owner, quarter.
- FR-03 Create Key Result: tạo Key Result gắn với Objective.
- FR-04 Update Progress: cập nhật progress 0-100 và ghi lịch sử cập nhật.
- FR-05 Dashboard: hiển thị danh sách OKR theo quyền truy cập.
## 4. Non Functional Requirements
- Authentication required.
- API response target dưới 2 giây.
- SQLite được chọn cho kiểm thử không cần Docker.
## Metrics
Functional requirements extracted: 5.
@@ -0,0 +1,8 @@
# Test Cases MOD-01
- TC-01 login rejects wrong password.
- TC-02 employee list returns only own objectives.
- TC-03 manager list returns all seeded objectives.
- TC-04 invalid objective payload returns 400.
- TC-05 progress patch updates a key result and stores progress.
- TC-06 golden manager objective response fails on drift.