Ari pick

.gitignore

@@ -33,6 +33,7 @@ out/
 /dist/
 /nbdist/
 /.nb-gradle/
+DS_Store
 
 ### VS Code ###
 .vscode/

ari_pick_api_spec.md

@@ -0,0 +1,168 @@
+# AriPick 제안 시스템 API 명세서
+
+아리픽(AriPick)에서 학생들이 상품을 제안하고, 목록을 조회하고, 승인/검토 상태 관리 및 좋아요 기능을 수행하기 위한 REST API 명세서입니다.
+
+---
+
+# 1. 제안(Proposals) API
+
+## 1.1 제안 생성  
+### `POST /api/proposals`
+
+### Request Body
+```json
+{
+  "title": "상품명",
+  "reason": "상품을 제안하는 이유",
+  "writerId": 1
+}
+```
+
+### Response
+```json
+{
+  "id": 12,
+  "title": "상품명",
+  "reason": "제안 이유",
+  "writerId": 1,
+  "createdAt": "2025-12-31T10:20:30",
+  "status": "PENDING"
+}
+```
+
+---
+
+## 1.2 제안 목록 조회  
+### `GET /api/proposals`
+
+### Query Parameters
+- `status` (optional: `PENDING`, `APPROVED`, `REJECTED`)
+- `page`
+- `size`
+
+### Response
+```json
+{
+  "content": [
+    {
+      "id": 1,
+      "title": "상품명",
+      "reason": "이유 설명",
+      "createdAt": "2025-12-31",
+      "status": "APPROVED",
+      "likes": 999
+    }
+  ],
+  "page": 0,
+  "size": 10,
+  "totalElements": 42
+}
+```
+
+---
+
+## 1.3 제안 상세 조회  
+### `GET /api/proposals/{proposalId}`
+
+### Response
+```json
+{
+  "id": 1,
+  "title": "상품명",
+  "reason": "이유 설명",
+  "writerId": 1,
+  "createdAt": "2025-12-31T00:00:00",
+  "status": "APPROVED",
+  "likes": 999
+}
+```
+
+---
+
+## 1.4 제안 상태 변경 (관리자)  
+### `PATCH /api/proposals/{proposalId}/status`
+
+### Request Body
+```json
+{
+  "status": "APPROVED"
+}
+```
+
+### Response
+```json
+{
+  "id": 1,
+  "status": "APPROVED"
+}
+```
+
+---
+
+## 1.5 제안 삭제  
+### `DELETE /api/proposals/{proposalId}`  
+
+### Response
+204 No Content
+
+---
+
+# 2. 좋아요(Like) API
+
+## 2.1 좋아요 등록  
+### `POST /api/proposals/{proposalId}/like`
+
+### Response
+```json
+{
+  "proposalId": 1,
+  "liked": true,
+  "likeCount": 1000
+}
+```
+
+---
+
+## 2.2 좋아요 취소  
+### `DELETE /api/proposals/{proposalId}/like`
+
+### Response
+```json
+{
+  "proposalId": 1,
+  "liked": false,
+  "likeCount": 999
+}
+```
+
+---
+
+# 3. 통계(옵션)
+
+## 3.1 제안 통계 조회  
+### `GET /api/proposals/stats`
+
+### Response
+```json
+{
+  "totalProposals": 120,
+  "approved": 45,
+  "pending": 65,
+  "rejected": 10
+}
+```
+
+---
+
+# 4. API 요약표
+
+| 기능 | 메서드 | URL |
+|------|--------|-------------|
+| 제안 등록 | POST | `/api/proposals` |
+| 제안 목록 조회 | GET | `/api/proposals` |
+| 제안 상세 조회 | GET | `/api/proposals/{id}` |
+| 제안 상태 변경 | PATCH | `/api/proposals/{id}/status` |
+| 제안 삭제 | DELETE | `/api/proposals/{id}` |
+| 좋아요 등록 | POST | `/api/proposals/{id}/like` |
+| 좋아요 취소 | DELETE | `/api/proposals/{id}/like` |
+| 통계 조회 | GET | `/api/proposals/stats` |