프로젝트 개요 (Project Overview)

사전 요구 사항 (Prerequisites)
...

Express를 사용한 Node.js (v20+)

Mongoose ODM을 사용한 MongoDB
...

Node.js v20+ 설치됨

MongoDB 설치 및 실행 중
...

Linux 서버 (Ubuntu 22.04 LTS 권장)

Root 권한 또는 sudo 권한
...

const mongoose = require('mongoose');

const SkillSchema = new mongoose.Schema({
  user: {
    type: mongoose.Schema.Types.ObjectId,
    ref: 'User',
    required: true
  },
  title: {
    type: String,
    required: true,
    trim: true,
    maxlength: 100
  },
  description: {
    type: String,
    required: true,
    maxlength: 2000
  },
  category: {
    type: String,
    required: true,
    enum: [
      'Manutenzione', 'Bellezza', 'Informatica',
      'Giardinaggio', 'Pulizie', 'Insegnamento',
      'Arte', 'Salute', 'Altro'
    ]
  },
  zone: {
    type: String,
    required: true
  },
  pricePerHour: {
    type: Number,
    default: 0
  },
  fixedPrice: {
    type: Number,
    default: 0
  },
  pricingType: {
    type: String,
    enum: ['hourly', 'fixed'],
    default: 'hourly'
  },
  isActive: {
    type: Boolean,
    default: true
  }
}, {
  timestamps: true
});

SkillSchema.index({ user: 1 });
SkillSchema.index({ category: 1 });
SkillSchema.index({ zone: 1 });
SkillSchema.index({ title: 'text', description: 'text' });

module.exports = mongoose.model('Skill', SkillSchema);

curl -X POST [http://localhost:3000/api/skills](http://localhost:3000/api/skills) \
-H "Content-Type: application/json" \
-d '{  
"user": "USER_ID_HERE",  
"title": "Professional Plumber",  
"description": "Fixing pipes, faucets, and boilers",  
"category": "Manutenzione",  
"zone": "Rimini Centro",  
"pricePerHour": 0.5  
}'

curl -X POST [http://localhost:3000/api/ai/matchmaking](http://localhost:3000/api/ai/matchmaking) \
-H "Content-Type: application/json" \
-d '{  
"request": "Looking for a plumber to fix my boiler, Rimini Centro area"
}'

const aiService = require('../services/aiService');

// 매칭 (Matchmaking)
const professionals = await aiService.findBestMatch(userRequest, professionalsList);

// 챗봇 (Chatbot)
const response = await aiService.chatAssistant(userMessage);

// 설명 생성 (Generate Description)
const description = await aiService.generateDescription(title, category, zone, price);

매칭 (Matchmaking) 지능화: 사용자 요청을 분석하고 관련성에 따라 전문가를 순위화합니다.

챗봇 어시스턴트 (Chatbot Assistant): 자주 묻는 질문(FAQs)에 답변하고 탐색을 지원합니다.
...

platform.deepseek.com으로 이동합니다.

계정을 생성하거나 로그인합니다.
...

💳 6. 결제 시스템 (Mock)
6.1 Mock 결제 서비스

`services/paymentService.js`에 위치한 Mock (모의) 서비스는 다음과 같은 기능을 수행합니다:

6.2 실제 결제로 전환하기

실제 Monero 결제를 활성화하려면 `.env` 파일에 다음과 같이 설정하십시오:
env

PAYMENT_MODE=real

그 후, Monero RPC를 사용하여 `services/realPaymentService.js`를 구현하십시오.

6.3 결제 API 엔드포인트 (Endpoints)
javascript

POST /api/payments/create
Body: { orderId, amount, currency }
Response: { success: true, data: { id, address, qrCode, amount, status } }

GET /api/payments/status/:paymentId
Response: { success: true, data: { status, confirmedAt, ... } }

POST /api/payments/confirm/:paymentId
Response: { success: true, data: { status: 'confirmed', ... } }

☁️ 7. VPS에 배포하기
7.1 초기 VPS 설정

VPS에 접속합니다:
bash

ssh root@your_vps_ip

시스템을 업데이트합니다:
bash

apt update && apt upgrade -y

7.2 Node.js (v20+) 설치
bash

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
apt install -y nodejs
node -v # v20.x가 표시되어야 합니다

7.3 MongoDB 설치
bash

# MongoDB GPG 키 추가

wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -

# MongoDB 저장소(Repository) 추가

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

# MongoDB 설치

apt update
apt install -y mongodb-org

# MongoDB 시작

systemctl start mongod
systemctl enable mongod
systemctl status mongod

7.4 Git 및 PM2 설치
bash

apt install -y git
npm install -g pm2

7.5 VPS에 저장소(Repository) 클론하기
bash

git clone https://github.com/DanielIoni-creator/MyZubsterGateway.git
cd MyZubsterGateway

7.6 Git 인증 구성

옵션 A: 개인 액세스 토큰 (Personal Access Token)을 사용한 HTTPS 방식
```bash
git remote set-url origin https://YOUR_USERNAME@github.com/DanielIoni-creator/MyZubsterGateway.git

ssh-keygen -t ed25519 -C "your-email@example.com"
cat ~/.ssh/id_ed25519.pub

# 키를 복사하여 GitHub > Settings > SSH Keys에 추가하세요.

npm install
nano .env

PORT=3001 node server.js # 먼저 수동으로 테스트하세요

# 정상 작동한다면, Ctrl+C를 누른 후 다음을 실행하세요:

pm2 start server.js --name myzubster-gateway -- --PORT=3001
pm2 save
pm2 status

pm2 startup

# PM2가 표시하는 명령어를 실행하세요 (예: sudo env PATH=...)

# 모든 프로세스 목록 표시
pm2 list

# 프로세스 시작
pm2 start server.js --name myzubster-gateway -- --PORT=3001

# 프로세스 중지
pm2 stop myzubster-gateway

# 프로세스 재시작
pm2 restart myzubster-gateway

# 프로세스 삭제
pm2 delete myzubster-gateway

# 현재 프로세스 목록 저장
pm2 save

# 로그 표시
pm2 logs myzubster-gateway
pm2 logs myzubster-gateway --lines 50

# 실시간 모니터링
pm2 monit

# 프로세스 상태
pm2 status

lsof -i :3000
ss -tulpn | grep 3000
ps aux | grep node

kill -9 [PID]

# 또는 모든 Node 프로세스 종료
pkill -9 node

GitHub에서 토큰을 생성합니다 (Settings → Developer settings → Personal access tokens)

비밀번호를 입력하라는 메시지가 뜨면 생성한 토큰을 사용하세요.

git remote set-url origin [https://YOUR_USERNAME@github.com/DanielIoni-creator/MyZubsterGateway.git](https://YOUR_USERNAME@github.com/DanielIoni-creator/MyZubsterGateway.git)

9.3 MongoDB 연결 문제 (MongoDB Connection Issues)

MongoDB가 실행 중인지 확인합니다:
```bash
systemctl status mongodb  
systemctl start mongodb  
systemctl enable mongodb

MONGODB_URI=mongodb://localhost:27017/myzubster

# 프로세스 시작
pm2 start server.js --name myzubster-gateway -- --PORT=3001  
pm2 save

# 또는 모두 종료 후 재시작
pm2 kill  
pm2 start server.js --name myzubster-gateway -- --PORT=3001  
pm2 save

// 스키마 필드에서 unique: true 제거  
username: { type: String, required: true, trim: true }  
email: { type: String, required: true, trim: true, lowercase: true } 

// 인덱스 정의만 유지  
UserSchema.index({ email: 1 }, { unique: true });  
UserSchema.index({ username: 1 }, { unique: true });

node cleanup.js

pm2 status  
lsof -i :3001

pm2 logs myzubster-gateway

curl [http://localhost:3001/api/health](http://localhost:3001/api/health)

apt install -y nginx