관리자 기능과 태그 표시 설정 추가

docs/spec.md

@@ -141,6 +141,8 @@ components/content/
 | name | String | 태그명 |
 | slug | String | URL 슬러그 |
 | description | String | 설명 |
+| sort_order | Integer | 사용자 화면 표시 순서 |
+| color | String | 태그 색상 코드 |
 | created_at | DateTime | 생성일 |
 | updated_at | DateTime | 수정일 |
 
@@ -179,15 +181,31 @@ components/content/
 ### 관리자 API (`/admin/api/`)
 
 - `POST /admin/api/auth/login` - 로그인
+- `POST /admin/api/auth/logout` - 로그아웃
+- `GET /admin/api/auth/me` - 현재 관리자 세션 조회
 - `GET /admin/api/posts` - 글 목록
 - `POST /admin/api/posts` - 글 작성
+- `GET /admin/api/posts/:id` - 글 상세
 - `PUT /admin/api/posts/:id` - 글 수정
 - `DELETE /admin/api/posts/:id` - 글 삭제
-- `POST /admin/api/posts/:id/publish` - 글 발행
 - `GET /admin/api/tags` - 태그 목록
 - `POST /admin/api/tags` - 태그 생성
+- `GET /admin/api/tags/:id` - 태그 상세
+- `PUT /admin/api/tags/:id` - 태그 수정
 - `DELETE /admin/api/tags/:id` - 태그 삭제
 
+> 글 발행/초안/비공개 전환은 현재 `PUT /admin/api/posts/:id`의 `status` 값으로 처리한다.
+> 태그 삭제 시 `post_tags` 연결도 데이터베이스 외래 키 규칙에 따라 함께 삭제된다.
+> 태그 목록은 `sort_order ASC, name ASC` 기준으로 정렬한다.
+> 태그 `color`는 `#RRGGBB` 형식이며 사용자 화면 태그 색상 표시와 배지 배경색에 사용한다.
+
+### 관리자 인증
+
+- 초기 관리자 인증은 `ADMIN_EMAIL`, `ADMIN_PASSWORD` 환경 변수를 사용
+- 로그인 성공 시 httpOnly 세션 쿠키를 `/admin` 경로에 설정
+- 관리자 페이지 접근은 `/admin/api/auth/me` 확인 후 허용
+- 세션 토큰은 `ADMIN_PASSWORD` 기반 HMAC 서명으로 검증
+
 ---
 
 ## 미디어 관리