마감일

Coddy Node.js 여정의 REST API 섹션에 포함된 레슨. 25개 중 25번째.

작업에는 마감일이 설정되고, 보드에는 어떤 작업이 기한을 넘겼는지 표시됩니다. 시간이 없는 날짜는 ISO 문자열 2026-03-15로 전달되며, zod는 z.iso.date()로 이를 검사합니다.

z.iso.date().safeParse('2026-07-01').success   // true
z.iso.date().safeParse('2026-02-30').success   // false: 해당 날짜는 존재하지 않음
'2026-03-01' < '2026-03-15'                    // true

ISO 날짜는 길이가 같고 연도가 앞에 오므로 문자열로 비교하면 시간 순서대로 정렬됩니다. /overdue와 같은 고정 경로는 라우터에서 /:id보다 먼저 와야 합니다. Express는 경로를 순서대로 확인하며, /:id는 어떤 단어와도 일치하기 때문입니다.

챌린지

쉬움

보드에는 기한이 지난 작업이 표시됩니다. 작업에 선택적 마감일을 추가하고, 기한이 지난 작업 목록을 추가하세요.

routes/tasks.js에서 Task 스키마에 선택적 due 필드를 추가하고, z.iso.date()로 검사하세요. 실제 날짜를 YYYY-MM-DD 형식으로 쓴 값만 허용됩니다. "2026-03-15"는 유효하지만, "15/03/2026", "2026-02-30" 및 "tomorrow"는 일반적인 400 invalid_body 오류를 반환합니다. POST 요청이 새 작업에 due를 저장하도록 하세요.
라우터에 GET /api/v1/tasks/overdue를 추가하세요. /:id 경로보다 위에 선언하지 않으면 Express가 overdue를 /:id의 id로 처리합니다.
경로는 비교할 날짜를 ?today=에서 읽습니다. 예를 들어 ?today=2026-03-20과 같습니다. today가 없으면 현재 날짜를 YYYY-MM-DD 형식으로 사용합니다. ?today=soon처럼 실제 날짜가 아닌 today 값은 다음과 같이 상태 코드 400을 반환합니다:
```
{ "error": { "code": "invalid_query", "message": "today must be a date like 2026-03-10" } }
```
이 경로는 목록 경로가 반환하는 페이지 객체가 아니라 작업의 일반 배열을 반환합니다. 다음 세 조건을 모두 만족하는 작업은 기한이 지난 작업입니다. 완료되지 않았고, due 날짜가 있으며, 그 날짜가 today보다 이전이어야 합니다. today 당일이 마감일인 작업은 아직 기한이 지난 것이 아닙니다. 배열은 due를 기준으로 가장 이른 날짜가 먼저 오도록 정렬하세요.

직접 해 보기: 새 Run에서 { "title": "Renew the lease", "due": "2026-03-15" }를 POST한 다음 { "title": "File the taxes", "due": "2026-03-01" }를 /api/v1/tasks로 POST하세요. 두 요청 모두 due가 포함된 201 응답을 반환합니다. 그런 다음 GET /api/v1/tasks/overdue?today=2026-03-20은 마감일이 더 이른 작업을 먼저 반환합니다(createdAt 시간은 달라질 수 있습니다):

[
  { "id": 5, "title": "File the taxes", "done": false, "labels": [], "due": "2026-03-01", "createdAt": "2026-10-30T09:15:02.118Z" },
  { "id": 4, "title": "Renew the lease", "done": false, "labels": [], "due": "2026-03-15", "createdAt": "2026-10-30T09:14:40.006Z" }
]

GET /api/v1/tasks/overdue?today=2026-03-15는 "File the taxes"만 반환합니다. GET /api/v1/tasks/overdue?today=soon은 코드 invalid_query와 함께 400을 반환합니다.

직접 해보기

import { Router } from 'express';
import { z } from 'zod';
import { config } from '../config.js';
import { sendError, sendInvalid } from '../errors.js';
import { nextId, tasks } from '../store.js';

const router = Router();

// PUT이 보내는 완전한 작업입니다. .strict()는 명시되지 않은 필드를 거부합니다.
const Task = z
    .object({
        title: z.string().trim().min(1).max(100),
        done: z.boolean(),
        labels: z.array(z.string().trim().min(1).max(20)).max(5).optional(),
    })
    .strict();
const NewTask = Task.partial({ done: true });
const TaskChanges = Task.partial();
const SORT_FIELDS = ['title', 'createdAt'];

// 대소문자에 관계없이 다른 작업에 이미 이 제목이 있으면 true입니다.
const titleTaken = (title, exceptId) =>
    tasks.some((t) => t.id !== exceptId && t.title.toLowerCase() === title.toLowerCase());

router.get('/', (req, res) => {
    const { done, q, sort, label } = req.query;
    let list = tasks;
    if (done !== undefined) {
        if (done !== 'true' && done !== 'false') {
            return sendError(res, 400, 'invalid_query', 'done must be true or false');
        }
        list = list.filter((t) => t.done === (done === 'true'));
    }
    if (q !== undefined) {
        const words = String(q).toLowerCase();
        list = list.filter((t) => t.title.toLowerCase().includes(words));
    }
    if (label !== undefined) {
        list = list.filter((t) => t.labels.includes(String(label)));
    }
    if (sort !== undefined) {
        const field = String(sort).startsWith('-') ? String(sort).slice(1) : String(sort);
        if (!SORT_FIELDS.includes(field)) {
            return sendError(
                res,
                400,
                'invalid_query',
                'sort must be title or createdAt, with - in front to reverse',
            );
        }
        const direction = String(sort).startsWith('-') ? -1 : 1;
        list = list.toSorted((a, b) => a[field].localeCompare(b[field]) * direction);
    }
    const page = req.query.page === undefined ? 1 : Number(req.query.page);
    const limit = req.query.limit === undefined ? config.pageSize : Number(req.query.limit);
    if (!Number.isInteger(page) || page < 1) {
        return sendError(res, 400, 'invalid_query', 'page must be a whole number from 1');
    }
    if (!Number.isInteger(limit) || limit < 1 || limit > 50) {
        return sendError(res, 400, 'invalid_query', 'limit must be a whole number from 1 to 50');
    }
    const start = (page - 1) * limit;
    res.json({
        items: list.slice(start, start + limit),
        page,
        total: list.length,
        pages: Math.ceil(list.length / limit),
    });
});

router.get('/:id', (req, res) => {
    const task = tasks.find((t) => t.id === Number(req.params.id));
    if (!task) {
        return sendError(res, 404, 'not_found', 'Task not found');
    }
    res.json(task);
});

router.post('/', (req, res) => {
    const result = NewTask.safeParse(req.body);
    if (!result.success) {
        return sendInvalid(res, result.error);
    }
    const { title, done = false, labels = [] } = result.data;
    if (titleTaken(title)) {
        return sendError(res, 409, 'conflict', 'A task with this title already exists');
    }
    const task = { id: nextId(), title, done, labels, createdAt: new Date().toISOString() };
    tasks.push(task);
    res.status(201).location(`/api/v1/tasks/${task.id}`).json(task);
});

router.patch('/:id', (req, res) => {
    const task = tasks.find((t) => t.id === Number(req.params.id));
    if (!task) {
        return sendError(res, 404, 'not_found', 'Task not found');
    }
    const result = TaskChanges.safeParse(req.body);
    if (!result.success) {
        return sendInvalid(res, result.error);
    }
    if (result.data.title !== undefined && titleTaken(result.data.title, task.id)) {
        return sendError(res, 409, 'conflict', 'A task with this title already exists');
    }
    Object.assign(task, result.data);
    res.json(task);
});

router.put('/:id', (req, res) => {
    const index = tasks.findIndex((t) => t.id === Number(req.params.id));
    if (index === -1) {
        return sendError(res, 404, 'not_found', 'Task not found');
    }
    const result = Task.safeParse(req.body);
    if (!result.success) {
        return sendInvalid(res, result.error);
    }
    const { id, createdAt } = tasks[index];
    if (titleTaken(result.data.title, id)) {
        return sendError(res, 409, 'conflict', 'A task with this title already exists');
    }
    tasks[index] = { id, ...result.data, labels: result.data.labels ?? [], createdAt };
    res.json(tasks[index]);
});

router.delete('/:id', (req, res) => {
    const index = tasks.findIndex((t) => t.id === Number(req.params.id));
    if (index === -1) {
        return sendError(res, 404, 'not_found', 'Task not found');
    }
    tasks.splice(index, 1);
    res.status(204).end();
});

export default router;