🌐 SaaS Web Builder

템플릿 기반 웹사이트를 빠르게 제작하는 SaaS 플랫폼입니다.

🎯 목적: 빠른 납품과 유지보수를 위한 템플릿 시스템 + 플러그인 구조

---

📁 프로젝트 구조

siteai/
├── site-ai-client/     # Vue 3 + Quasar 프론트엔드
├── site-ai-server/     # Node.js + Koa 백엔드
└── README.md           # 이 파일

---

🚀 빠른 시작

1. 클라이언트 실행

cd site-ai-client
npm install
npm run dev

2. 서버 실행

cd site-ai-server
npm install
cp .env.example .env
# .env 파일 편집하여 환경 변수 설정
docker compose up -d db
npx sequelize-cli db:migrate
npm run dev

---

⚙️ 기술 스택

영역	기술
프론트엔드	Vue 3 + Quasar Framework + Pinia
백엔드	Node.js 20 + Koa 2 + Sequelize
데이터베이스	MySQL 8.x
인증	JWT + Social OAuth
컨테이너	Docker + Docker Compose

---

🔒 보안 가이드라인

⚠️ 중요 보안 주의사항

1. 환경 변수 관리

   • .env 파일을 절대 Git에 커밋하지 마세요
   • 모든 민감한 정보는 환경 변수로 관리
   • 프로덕션 환경에서는 환경 변수를 안전하게 설정

2. 데이터베이스 보안

   • 강력한 비밀번호 사용
   • 최소 권한 원칙 적용
   • 정기적인 백업 및 보안 업데이트

3. API 보안

   • HTTPS 사용 필수
   • JWT 토큰 만료 시간 적절히 설정
   • 입력 데이터 검증 및 sanitization

4. 의존성 보안

   • 정기적으로 npm audit 실행
   • 알려진 보안 취약점이 있는 패키지 업데이트

---

📚 주요 기능

• 템플릿 시스템: HTML/CSS/JS 기반 웹사이트 템플릿
• 플러그인 구조: 모듈식 기능 확장
• 멀티테넌트: SaaS 기반 다중 사용자 지원
• 실시간 편집: 코드 에디터를 통한 실시간 웹사이트 편집
• 버전 관리: 프로젝트 게시 및 버전 추적
• 활동 로깅: 사용자 활동 및 통계 추적

---

🛠️ 개발 환경

필수 요구사항

• Node.js 20.x 이상
• MySQL 8.x
• Docker & Docker Compose
• Git

권장 개발 도구

• VS Code + 확장 프로그램
• MySQL Workbench 또는 DBeaver
• Postman 또는 Insomnia
• Chrome DevTools

---

📖 상세 문서

• 클라이언트 문서
• 서버 문서

---

🚨 보안 이슈 신고

보안 취약점을 발견하신 경우, 즉시 개발팀에 연락해주세요. 공개적으로 이슈를 등록하지 마시고, 비공개 채널을 통해 연락해주세요.

⚠️ 중요: 이 저장소는 공개 저장소이므로 민감한 정보를 포함하지 마세요.

---

📝 라이선스

이 프로젝트는 비공개 SaaS 사업 기반의 코드로, 별도 허가 없이 복제·배포·상업적 이용을 금합니다.

---

📅 로드맵

• 멀티테넌트 스코프 완성
• 결제 시스템 통합
• 플러그인 SDK 개발
• 모니터링 대시보드 구축
• 보안 강화 및 취약점 점검
• 성능 최적화