[DEPLOY] v1.0.0

.github/ISSUE_TEMPLATE/♻️--refactor--코드-리팩토링.md

@@ -0,0 +1,17 @@
+---
+name: "♻️ [refactor] 코드 리팩토링"
+about: 리팩토링을 위한 템플릿
+title: "♻️ [refactor] "
+labels: "♻️ refactor"
+assignees: ''
+
+---
+
+## 📝 개요
+- 자세한 개요 작성
+
+## ✔️ To-Do
+- [ ] 투두 내용 작성
+
+## 👀 ETC
+- 참고자료 등 기타 내용 작성

.github/ISSUE_TEMPLATE/✨--feat--기능-추가.md

@@ -0,0 +1,17 @@
+---
+name: "✨ [feat] 기능 추가"
+about: 새로운 기능 추가 템플릿
+title: "✨ [feat] "
+labels: "✨ feature"
+assignees: ''
+
+---
+
+## 📝 개요
+- 자세한 개요 작성
+
+## ✔️ To-Do
+- [ ] 투두 내용 작성
+
+## 👀 ETC
+- 참고자료 등 기타 내용 작성

.github/ISSUE_TEMPLATE/🐛--fix--버그-수정.md

@@ -0,0 +1,17 @@
+---
+name: "\U0001F41B [fix] 버그 수정"
+about: 버그 수정을 위한 템플릿
+title: "\U0001F41B [fix] "
+labels: "\U0001F41B fix"
+assignees: ''
+
+---
+
+## 📝 개요
+- 자세한 개요 작성
+
+## ✔️ To-Do
+- [ ] 투두 내용 작성
+
+## 👀 ETC
+- 참고자료 등 기타 내용 작성

.github/ISSUE_TEMPLATE/🚀--chore--기타-변경사항.md

@@ -0,0 +1,17 @@
+---
+name: "\U0001F680 [chore] 기타 변경사항"
+about: 기타 변경사항을 위한 템플릿
+title: "\U0001F680 [chore] "
+labels: "\U0001F680 chore"
+assignees: ''
+
+---
+
+## 📝 개요
+- 자세한 개요 작성
+
+## ✔️ To-Do
+- [ ] 투두 내용 작성
+
+## 👀 ETC
+- 참고자료 등 기타 내용 작성

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,26 @@
+## 📍 PR 타입 (하나 이상 선택)
+- [ ] 기능 추가
+- [ ] 버그 수정
+- [ ] 의존성, 환경 변수, 빌드 관련 코드 업데이트
+- [ ] 기타 사소한 수정
+
+## ❗️ 관련 이슈 링크
+Close #
+
+## 📌 개요
+- 
+
+## 🔁 변경 사항
+
+## 📸 스크린샷 (선택)
+
+## 👀 기타 더 이야기해볼 점 (선택)
+
+## 💬 리뷰 요구사항 (선택)
+
+## ✅ 체크 리스트
+- [ ] PR 템플릿에 맞추어 작성했어요.
+- [ ] 변경 내용에 대한 테스트를 진행했어요.
+- [ ] 프로그램이 정상적으로 동작해요.
+- [ ] PR에 적절한 라벨을 선택했어요.
+- [ ] 불필요한 코드는 삭제했어요.

.github/workflows/deploy.yml

@@ -0,0 +1,35 @@
+name: Build and Deploy on Self-Hosted Runner
+
+on:
+  push:
+    branches:
+      - develop
+
+jobs:
+  deploy:
+    runs-on: self-hosted
+
+    steps:
+      - name: 코드 가져오기 (pull)
+        run: |
+          cd /home/tokkit/Tokkit-Client
+          git pull origin develop
+
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+
+      - name: Docker Compose Down
+        run: |
+          cd /home/tokkit
+          docker compose down
+
+      - name: Docker Compose Build
+        run: |
+          cd /home/tokkit
+          docker compose build
+
+      - name: Docker Compose Up
+        run: |
+          cd /home/tokkit
+          docker compose up -d
+

.gitignore

@@ -35,7 +35,7 @@ yarn-error.log*
 
 # vercel
 .vercel
-
+.idea
 # typescript
 *.tsbuildinfo
 next-env.d.ts

Dockerfile

@@ -0,0 +1,13 @@
+
+FROM node:20 AS builder
+WORKDIR /app
+COPY . .
+RUN npm install
+RUN npm run build
+
+FROM node:20
+WORKDIR /app
+COPY --from=builder /app .
+EXPOSE 3000
+CMD ["npm", "run", "start"]
+

README.md

@@ -1,36 +1,75 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/cea3445b-9f02-44b9-925c-dff472d896ae" width="180" alt="Tokkit Logo"/>
+</p>
+<p align="center"><i>“토큰이 있으면, 토킷이 있다.”</i></p>
 
-## Getting Started
+# 🐰 Tokkit-Client
 
-First, run the development server:
+_“토큰이 있으면, 토킷이 있다.”_  
+**Tokkit**은 우리은행 예금 토큰 기반의 전자지갑 서비스입니다.  
+이 저장소는 **프론트엔드(Next.js)** 클라이언트 코드로, 사용자 인터페이스와 이벤트형 UX 구현을 담당합니다.
+
+---
+
+
+## ✨ 주요 기능 (프론트 주석 기준)
+
+- `/wallet` : 예금 토큰 잔액 확인 및 입출금 기능
+- `/store` : 바우처 카테고리별 탐색, 구매, 사용
+- `/mission` : 미션 달성 시 보상 시스템
+- `/admin` : 관리자용 바우처 및 사용자 관리
+- `/event` : 출석, 룰렛, 친구 초대 등 인터랙티브 이벤트
+
+---
 
-```bash
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-# or
-bun dev
-```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
 
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+## 🌿 브랜치 규칙
 
-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+- `main` : 배포 브랜치
+- `dev` : 개발 통합 브랜치
+- `feat/#{ISSUE_NUMBER}-작업 내용 (한글)` : 기능 개발 브랜치 
+- `fix/#{ISSUE_NUMBER}-작업 내용 (한글)` : 버그 수정 브랜치
+- `hotfix/#{ISSUE_NUMBER}-작업 내용 (한글)` : 긴급 핫픽스
+
+---
+
+## 🧾 커밋 메시지 규칙
+
+```bash
+태그:  작업 내용 (한글)
+
+예:
+feat: 로그인 화면 UI 구현
+fix: 바우처 미표시 버그 수정
+```
 
-## Learn More
+---
 
-To learn more about Next.js, take a look at the following resources:
+### ✅ 주요 태그
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+| 태그 | 의미 |
+|------|------|
+| `Feat` | 기능 추가 |
+| `Fix` | 버그 수정 |
+| `Style` | 스타일, 포맷팅 |
+| `Refactor` | 코드 리팩토링 |
+| `Chore` | 설정, 의존성 작업 |
+| `Docs` | 문서 작업 |
+| `Test` | 테스트 코드 추가 |
 
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+---
 
-## Deploy on Vercel
+### 🏷️ 라벨 체계
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+| 라벨 | 설명 | 
+|------|--------|
+| `FEAT` | 기능 추가 관련 PR/이슈 |
+| `FIX` | 버그 수정 관련 | 
+| `STYLE` | UI/스타일/레이아웃 관련 | 
+| `REFACTOR` | 리팩토링 관련 | 
+| `CHORE` | 기타 설정 및 패키지 |
+| `TEST` | 테스트 코드 작업 | 
+| `DOCS` | 문서/주석 관련 |
 
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+---

app/MainLayout.tsx

@@ -0,0 +1,14 @@
+"use client";
+
+import type React from "react"
+import { usePathname } from "next/navigation"
+
+// 클라이언트 컴포넌트
+export function MainLayout({ children }: { children: React.ReactNode }) {
+  "use client"
+
+  const pathname = usePathname()
+  const isAdmin = pathname.startsWith("/admin")
+
+  return <div className={isAdmin ? "w-full" : "max-w-md mx-auto"}>{children}</div>
+}

app/dashboard/api/fetch-notice-preview.ts

@@ -0,0 +1,41 @@
+import { getApiUrl } from "@/lib/getApiUrl";
+import { getCookie } from "@/lib/cookies";
+import {fetchWithAuth} from "@/lib/fetchWithAuth";
+
+const API_URL = getApiUrl();
+
+export interface NoticePreview {
+    id: number;
+    title: string;
+    content: string;
+    createdAt: string;
+    isNew: boolean;
+}
+
+export async function fetchNoticePreview(limit: number = 3): Promise<NoticePreview[]> {
+    const res = await fetchWithAuth(`${API_URL}/api/users/notice?page=0`, {
+        method: "GET",
+        credentials: "include",
+    });
+
+    if (!res.ok) throw new Error("공지사항을 불러오는 데 실패했습니다.");
+
+    const data = await res.json();
+    const raw = data.result.content || [];
+
+    const now = new Date();
+    const formattedNotices = raw.map((n: any) => {
+        const createdAt = new Date(n.createdAt);
+        const diffInDays = (now.getTime() - createdAt.getTime()) / (1000 * 60 * 60 * 24);
+
+        return {
+            id: n.id,
+            title: n.title,
+            content: n.content,
+            createdAt: n.createdAt,
+            isNew: diffInDays <= 3,
+        };
+    });
+
+    return formattedNotices.slice(0, limit);
+}

app/dashboard/api/fetch-recent-transactions.ts

@@ -0,0 +1,31 @@
+import { getApiUrl } from "@/lib/getApiUrl";
+import {fetchWithAuth} from "@/lib/fetchWithAuth";
+
+const API_URL = getApiUrl();
+
+export interface Transaction {
+    id: number;
+    type: string;
+    amount: number;
+    createdAt: string;
+    displayDescription?: string;
+}
+
+export async function fetchRecentTransactions(limit: number = 3): Promise<Transaction[]> {
+    const res = await fetchWithAuth(`${API_URL}/api/users/wallet/transactions`, {
+        credentials: "include",
+    });
+
+    if (!res.ok) {
+        throw new Error("거래내역 요청 실패");
+    }
+
+    const data = await res.json();
+    console.log(data);
+
+    if (!data.isSuccess) {
+        throw new Error(data.message || "응답 실패");
+    }
+
+    return data.result.slice(0, limit);
+}

app/dashboard/api/wallet-info.ts

@@ -0,0 +1,21 @@
+import { getApiUrl } from "@/lib/getApiUrl";
+import { fetchWithAuth } from "@/lib/fetchWithAuth";
+import {getCookie} from "@/lib/cookies";
+
+const API_URL = getApiUrl();
+
+export async function fetchWalletInfo() {
+  const res = await fetchWithAuth(`${API_URL}/api/users/wallet/balance`, {
+    method: "GET",
+    credentials: "include",
+  });
+
+  if (!res.ok) throw new Error("지갑 정보를 불러오지 못했습니다.");
+
+  const data = await res.json();
+
+  const parsedResult =
+    typeof data.result === "string" ? JSON.parse(data.result) : data.result;
+
+  return parsedResult;
+}