HHostingByteSoftware
Ctrl K
ComunidadGuías…

README.ko.md

Rama develop · réplica de lectura del repositorio original.

Archivo original ↗Preguntar a KiBot
<div align="center">

<img src=".github/assets/readme-banner.png" alt="Hi.Events - Open-source event ticketing and management platform" width="100%">

# Hi.Events

### 오픈소스 이벤트 티켓 판매 및 관리 플랫폼

컨퍼런스, 나이트라이프 이벤트, 콘서트, 클럽 나이트, 워크숍, 페스티벌 티켓을 온라인으로 판매하세요.<br>
셀프 호스팅 또는 클라우드. 나의 이벤트, 나의 브랜드, 나의 데이터.

[Cloud 체험하기 →](https://app.hi.events/auth/register?utm_source=gh-readme) · [라이브 데모](https://app.hi.events/event/2/hievents-conference-2030?utm_source=gh-readme) · [문서](https://hi.events/docs?utm_source=gh-readme) · [엔터프라이즈 및 라이선스](https://hi.events/licensing?utm_source=gh-readme) · [웹사이트](https://hi.events?utm_source=gh-readme)

[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://github.com/HiEventsDev/hi.events/blob/develop/LICENCE)
[![GitHub Release](https://img.shields.io/github/v/release/HiEventsDev/hi.events?include_prereleases)](https://github.com/HiEventsDev/hi.events/releases)
[![GitHub Stars](https://img.shields.io/github/stars/HiEventsDev/hi.events?style=flat)](https://github.com/HiEventsDev/hi.events)
[![Docker Pulls](https://img.shields.io/docker/pulls/daveearley/hi.events-all-in-one)](https://hub.docker.com/r/daveearley/hi.events-all-in-one)
[![E2E Tests](https://github.com/HiEventsDev/hi.events/actions/workflows/e2e.yml/badge.svg?event=push)](https://github.com/HiEventsDev/hi.events/actions/workflows/e2e.yml)

<a href="https://trendshift.io/repositories/10563" target="_blank">
  <img src="https://trendshift.io/api/badge/repositories/10563" alt="HiEventsDev%2Fhi.events | Trendshift" width="250" height="55"/>
</a>

<p>
<a href="README.md">English</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.it.md">Italiano</a> · <a href="README.nl.md">Nederlands</a> · <a href="README.es.md">Español</a> · <a href="README.pt.md">Português</a> · <a href="README.pt-br.md">Português (Brasil)</a> · <a href="README.pl.md">Polski</a> · <a href="README.cs.md">Čeština</a> · <a href="README.sk.md">Slovenčina</a> · <a href="README.hu.md">Magyar</a> · <a href="README.sv.md">Svenska</a> · <a href="README.fi.md">Suomi</a> · <a href="README.el.md">Ελληνικά</a> · <a href="README.tr.md">Türkçe</a> · <a href="README.vi.md">Tiếng Việt</a> · <a href="README.zh-cn.md">简体中文</a> · <a href="README.zh-hk.md">繁體中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a>
</p>

</div>

<br>

> [!NOTE]
> **Hi.Events 2.0이 출시되었습니다.** 반복 이벤트, 지정 좌석, 박스 오피스, 라인업 및 일정표, 싱글
> 사인온(SSO), 팀 권한, API 키를 지원합니다. [새로운 기능 보기 →](https://github.com/HiEventsDev/hi.events/releases)

<br>

<img alt="Hi.Events event dashboard on desktop and an event page on mobile" src=".github/assets/readme-showcase.png" width="100%"/>

<br>

## 왜 Hi.Events인가요?

대부분의 티켓 판매 플랫폼은 티켓마다 수수료를 떼어 가고 고객 데이터를 가져갑니다. **Hi.Events는 Eventbrite, Tickettailor, Dice.fm 등
티켓 판매 플랫폼을 대체하는 오픈소스 솔루션**으로, 브랜딩과 결제, 데이터를
완벽하게 직접 관리할 수 있습니다.

나이트라이프 프로모터와 페스티벌부터 공연장, 커뮤니티 단체,
컨퍼런스 주최자까지 전 세계 수천 명의 이벤트 주최자가 신뢰합니다. 직접 운영하거나, Hi.Events Cloud에서 저희에게 맡기세요.

<br>

## 주요 기능

**📅 이벤트**
- 단일 및 반복 이벤트, 날짜별 가격·수용 인원·시간 설정
- 클릭 한 번으로 이벤트 복제
- 저장된 장소 및 온라인 이벤트
- 이벤트 홈페이지 디자이너 및 브랜드 주최자 페이지
- 라인업 및 일정표 페이지

**🎟️ 티켓 및 상품**
- 유료, 무료, 기부 및 등급별 티켓
- 지정 좌석 <sup>Enterprise</sup>
- 추가 옵션 및 굿즈
- 프로모션 코드로 공개되는 숨김 티켓
- 주문당 구매 한도 및 판매 기간 예약
- 공유 수용 인원 및 자동 대기자 명단

**🛒 판매**
- 내 사이트에 맞춤형 임베드: 티켓 위젯, 버튼, 이벤트 목록, 라인업, 일정표
- 프로모션 코드 및 할인
- 프로모터 및 제휴 파트너용 추적 링크
- 맞춤 등록 질문
- 결제 시 마케팅 수신 동의
- Meta, TikTok, Google Analytics, Tag Manager 추적

**💳 결제**
- 내 Stripe 계정으로 직접 정산
- 세금 및 수수료, 가격에 포함하거나 결제 시 추가
- 인보이스 발행 및 오프라인 결제
- 전액 및 부분 환불

**🚪 참석자 및 현장 입장**
- 현장 판매용 박스 오피스 <sup>Enterprise</sup>
- 휴대폰 카메라 또는 USB 스캐너로 체크인
- 실시간 인원이 표시되는 공유용 체크인 목록
- 참석자 메시지 및 맞춤 이메일 템플릿
- 브랜드 PDF 티켓
- 참석자 수동 추가
- 판매, 세금, 프로모션 코드 보고서

<br>

## 조직을 위한 설계

**🔐 보안 및 접근 관리**
- 싱글 사인온(SSO)
- 2단계 인증
- 팀 역할 및 권한
- 하나의 계정에서 여러 주최자 관리

**🔌 연동**
- REST API 및 API 키
- 웹훅
- CSV 및 XLSX 내보내기

**🗄️ 나의 데이터**
- Docker로 셀프 호스팅
- 계정 삭제 및 익명화
- 21개 언어 지원

**✅ 철저한 테스트**
- 모든 변경 사항에 대해 포괄적인 테스트 스위트 실행

<br>

## 빠른 시작

**Laravel 13** (PHP >=8.3) · SSR 지원 **React 19** · **TypeScript** · **PostgreSQL** · **Redis** · **Docker** 기반으로 구축되었습니다.

### 원클릭 배포

[![Deploy on DigitalOcean](https://www.deploytodo.com/do-btn-blue.svg)](https://github.com/HiEventsDev/hi.events-digitalocean)
[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://github.com/HiEventsDev/hi.events-render.com)
[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/8CGKmu?referralCode=KvSr11)
[![Deploy on Zeabur](https://zeabur.com/button.svg)](https://zeabur.com/templates/8DIRY6)

### Docker

```bash
git clone https://github.com/HiEventsDev/hi.events.git
cd hi.events/docker/all-in-one

cp .env.example .env

# Generate keys (Linux/macOS)
echo "APP_KEY=base64:$(openssl rand -base64 32)" >> .env
echo "JWT_SECRET=$(openssl rand -base64 32)" >> .env

docker compose up -d
```

> [!TIP]
> **Windows 사용자:** 키 생성 방법은 `./docker/all-in-one/README.md`를 참고하세요.

`http://localhost:8123`을 열고 계정을 만드세요.

📖 [전체 설치 가이드](https://hi.events/docs/getting-started?utm_source=gh-readme)

> [!IMPORTANT]
> **1.x에서 업그레이드하시나요?** 업그레이드 전에 [릴리스 노트](https://github.com/HiEventsDev/hi.events/releases)를 확인하세요.

### REST API

**설정 → API 키**에서 API 키를 생성할 수 있으며, 같은 곳에서 API 레퍼런스도 확인할 수 있습니다.

<br>

## 지원 언어

English, Deutsch, Français, Italiano, Nederlands, Español, Português, Português (Brasil),
Polski, Čeština, Slovenčina, Magyar, Svenska, Suomi, Ελληνικά, Türkçe, Tiếng Việt, 简体中文, 繁體中文, 日本語 및 한국어.

번역 수정과 새로운 언어 추가를 환영합니다. [기여 가이드](CONTRIBUTING.md)를 참고하세요.

<br>

## Hi.Events Cloud

셀프 호스팅이 부담스러우신가요? **[Hi.Events Cloud](https://app.hi.events/auth/register?utm_source=gh-readme)는**
Hi.Events를 개발하는 팀이 직접 운영하는 완전 관리형 버전입니다.

[시작하기 →](https://app.hi.events/auth/register?utm_source=gh-readme)

<br>

## 라이선스

Hi.Events는 **AGPL-3.0 및 추가 조항**에 따라 라이선스가 부여됩니다. 추가 조항에 따라 소프트웨어가 생성하는 페이지와 이메일에 "Powered by Hi.Events"
표기를 유지해야 합니다. 정확한 문구는 [LICENCE](LICENCE)를 참고하세요.

지정 좌석과 박스 오피스는 [Hi.Events Enterprise Licence](backend/ee/LICENCE)가 적용되며, 프로덕션 환경에서 사용하려면
라이선스가 필요합니다.

표기를 제거하거나 화이트 라벨 배포에 맞는 조건이 필요하다면 **상업용 라이선스를 이용할 수 있습니다**.
[라이선스 옵션](https://hi.events/licensing?utm_source=gh-readme) ·
[hello@hi.events](mailto:hello@hi.events)

<br>

## 기여하기

기여를 환영합니다. 시작하려면 [기여 가이드](CONTRIBUTING.md)를 참고하세요. 규모가 큰 작업을 시작하기 전에는 이슈나
토론을 먼저 열어 방향을 함께 맞춰 주세요. 기여자는
[CLA](CLA.md)에 서명해야 합니다.

<a href="https://github.com/HiEventsDev/hi.events/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=HiEventsDev/hi.events" alt="Hi.Events contributors" />
</a>

<br>

## 보안

취약점을 발견하셨나요? 공개 이슈를 여는 대신 [security@hi.events](mailto:security@hi.events)로 비공개로
제보해 주세요. 자세한 내용은 [보안 정책](SECURITY.md)을 참고하세요.

<br>

## 지원

📖 [문서](https://hi.events/docs?utm_source=gh-readme) ·
🐛 [GitHub Issues](https://github.com/HiEventsDev/hi.events/issues) ·
💬 [토론](https://github.com/HiEventsDev/hi.events/discussions) ·
📧 [hello@hi.events](mailto:hello@hi.events)

새로운 기능과 개선 사항은
[릴리스 페이지](https://github.com/HiEventsDev/hi.events/releases)에서 확인할 수 있습니다.

<br>

<div align="center">

**[웹사이트](https://hi.events)** · **[문서](https://hi.events/docs)** · **[Cloud](https://app.hi.events/auth/register?utm_source=gh-readme)** · **[라이선스](https://hi.events/licensing)**

아일랜드에서 ☘️와 함께 만들었습니다

</div>