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,9 @@
# API Contract
POST /auth/login
GET /objectives
GET /objectives/:id
POST /objectives
GET /key-results/:id
POST /key-results
PATCH /key-results/:id/progress
@@ -0,0 +1,3 @@
# Data Model
User 1:N Objective. Objective 1:N KeyResult. KeyResult 1:N ProgressUpdate. Role/status are SQLite strings constrained in service/types.
@@ -0,0 +1,19 @@
# Implementation Plan: OKR Web App
## Stack
NestJS, Prisma Client, SQLite, React, Vite, Tailwind, Zod, TanStack Query.
## Backend Modules
- auth: JWT login and cookie issuance.
- users: admin/manager user list.
- objectives: role-filtered list, detail, create.
- key-results: detail, create, progress update.
## Tests
- Backend service tests.
- Backend HTTP e2e tests.
- Golden regression test compares seeded manager objectives with backend/test/golden/objectives.manager.json.
- Rollback strategy restores changed artifacts from backups through rollback-manager.sh.
## Build
Run npm test and npm run build for backend and frontend.
@@ -0,0 +1,7 @@
# Quickstart
1. npm install
2. npm run db:setup -w backend
3. npm run seed -w backend
4. npm run dev -w backend
5. npm run dev -w frontend
@@ -0,0 +1,3 @@
# Research
SQLite selected to satisfy no Docker/Postgres e2e. Prisma Client remains application ORM. Node built-in sqlite applies migration SQL because Prisma schema-engine push fails in this Node 24 local environment.
@@ -0,0 +1,20 @@
# Feature Specification: OKR Web App
## Feature ID
001-okr-web-app
## Requirements
- FR-01: Login authenticates username/email plus password and returns standard envelope.
- FR-02: Objective creation validates title, owner, and quarter.
- FR-03: Key Result creation validates objective, title, values, deadline, and progress.
- FR-04: Progress update accepts 0-100 and stores a ProgressUpdate record.
- FR-05: Dashboard list filters by role: ADMIN and MANAGER see all; EMPLOYEE sees own objectives.
## Acceptance Criteria
- Employee cannot read or update another employee objective or key result.
- Manager can read all seeded objectives.
- Invalid quarter format returns validation error.
- Golden objective response fails on drift.
## Source Trace
Requirement characters read: 14212. Architecture characters read: 23558.
@@ -0,0 +1,9 @@
# Tasks
- [X] Backend auth module with JWT and bcrypt.
- [X] Backend users/objectives/key-results modules.
- [X] Prisma schema, SQLite migration SQL, idempotent seed.
- [X] Frontend login, dashboard, objective detail, create objective, key result detail.
- [X] Backend service and e2e tests.
- [X] Golden regression fixture and deliberate failure evidence.
- [X] Build/test logs captured.