README.vi.md

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

<div align="center">

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

# Hi.Events

### Nền tảng bán vé và quản lý sự kiện mã nguồn mở

Bán vé trực tuyến cho hội nghị, sự kiện về đêm, buổi hòa nhạc, đêm club, workshop và lễ hội.<br>
Tự lưu trữ hoặc trên cloud. Sự kiện của bạn, thương hiệu của bạn, dữ liệu của bạn.

[Dùng thử Cloud →](https://app.hi.events/auth/register?utm_source=gh-readme) · [Demo trực tiếp](https://app.hi.events/event/2/hievents-conference-2030?utm_source=gh-readme) · [Tài liệu](https://hi.events/docs?utm_source=gh-readme) · [Enterprise & giấy phép](https://hi.events/licensing?utm_source=gh-readme) · [Trang web](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 đã ra mắt** với sự kiện định kỳ, chỗ ngồi đặt trước, quầy vé, trang đội hình và lịch trình,
> đăng nhập một lần, phân quyền nhóm và khóa API. [Xem có gì mới →](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>

## Tại sao chọn Hi.Events?

Hầu hết các nền tảng bán vé đều thu phí trên mỗi vé và nắm giữ dữ liệu khách hàng của bạn. **Hi.Events là giải pháp mã nguồn mở
thay thế Eventbrite, Tickettailor, Dice.fm và các nền tảng bán vé khác**, giúp bạn toàn quyền kiểm soát thương hiệu,
quy trình thanh toán và dữ liệu.

Được hàng nghìn nhà tổ chức sự kiện trên khắp thế giới tin dùng — từ các nhà tổ chức tiệc đêm, lễ hội đến địa điểm, cộng đồng
và đơn vị tổ chức hội nghị. Tự vận hành, hoặc để chúng tôi vận hành giúp bạn trên Hi.Events Cloud.

<br>

## Tính năng

**📅 Sự kiện**
- Sự kiện một lần và định kỳ, với giá, sức chứa và giờ riêng cho từng ngày
- Nhân bản sự kiện chỉ với một cú nhấp
- Lưu địa điểm và sự kiện trực tuyến
- Trình thiết kế trang chủ sự kiện và trang nhà tổ chức mang thương hiệu riêng
- Trang đội hình và lịch trình

**🎟️ Vé & sản phẩm**
- Vé trả phí, miễn phí, quyên góp và vé theo hạng
- Chỗ ngồi đặt trước <sup>Enterprise</sup>
- Sản phẩm bổ sung và merchandise
- Vé ẩn mở khóa bằng mã khuyến mãi
- Giới hạn mỗi đơn hàng và lên lịch thời gian mở bán
- Sức chứa dùng chung và danh sách chờ tự động

**🛒 Bán hàng**
- Mã nhúng tùy biến cho trang web của bạn: widget bán vé, nút, danh sách sự kiện, đội hình và lịch trình
- Mã khuyến mãi và giảm giá
- Liên kết theo dõi cho nhà quảng bá và đối tác liên kết
- Câu hỏi đăng ký tùy chỉnh
- Đồng ý nhận tin tiếp thị khi thanh toán
- Theo dõi qua Meta, TikTok, Google Analytics và Tag Manager

**💳 Thanh toán**
- Nhận tiền trực tiếp vào tài khoản Stripe của bạn
- Thuế và phí, đã bao gồm hoặc cộng thêm khi thanh toán
- Xuất hóa đơn và thanh toán ngoại tuyến
- Hoàn tiền toàn bộ hoặc một phần

**🚪 Người tham dự & cửa vào**
- Quầy vé bán tại cửa <sup>Enterprise</sup>
- Check-in bằng camera điện thoại hoặc máy quét USB
- Danh sách check-in có thể chia sẻ, đếm số lượng theo thời gian thực
- Nhắn tin cho người tham dự và mẫu email tùy chỉnh
- Vé PDF mang thương hiệu riêng
- Thêm người tham dự thủ công
- Báo cáo doanh số, thuế và mã khuyến mãi

<br>

## Xây dựng cho tổ chức

**🔐 Bảo mật & truy cập**
- Đăng nhập một lần
- Xác thực hai yếu tố
- Vai trò và phân quyền nhóm
- Nhiều nhà tổ chức trong một tài khoản

**🔌 Tích hợp**
- REST API và khóa API
- Webhooks
- Xuất CSV và XLSX

**🗄️ Dữ liệu của bạn**
- Tự lưu trữ với Docker
- Xóa và ẩn danh hóa tài khoản
- Hỗ trợ 21 ngôn ngữ

**✅ Được kiểm thử**
- Bộ kiểm thử toàn diện chạy trên mọi thay đổi

<br>

## Bắt đầu nhanh

Xây dựng với **Laravel 13** (PHP >=8.3) · **React 19** với SSR · **TypeScript** · **PostgreSQL** · **Redis** · **Docker**.

### Triển khai một cú nhấp

[![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]
> **Người dùng Windows:** Xem `./docker/all-in-one/README.md` để biết cách tạo khóa.

Mở `http://localhost:8123` và tạo tài khoản của bạn.

📖 [Hướng dẫn cài đặt đầy đủ](https://hi.events/docs/getting-started?utm_source=gh-readme)

> [!IMPORTANT]
> **Nâng cấp từ 1.x?** Hãy đọc [ghi chú phát hành](https://github.com/HiEventsDev/hi.events/releases) trước khi nâng cấp.

### REST API

Tạo khóa API trong **Cài đặt → Khóa API**, nơi bạn cũng sẽ tìm thấy Tài liệu tham khảo API.

<br>

## Ngôn ngữ

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, 简体中文, 繁體中文, 日本語 và 한국어.

Chúng tôi luôn hoan nghênh các bản sửa lỗi dịch và ngôn ngữ mới — xem [hướng dẫn đóng góp](CONTRIBUTING.md).

<br>

## Hi.Events Cloud

Không muốn tự lưu trữ? **[Hi.Events Cloud](https://app.hi.events/auth/register?utm_source=gh-readme)** là phiên bản được quản lý
hoàn toàn, do chính đội ngũ phát triển Hi.Events vận hành.

[Bắt đầu ngay →](https://app.hi.events/auth/register?utm_source=gh-readme)

<br>

## Giấy phép

Hi.Events được cấp phép theo **AGPL-3.0 kèm các điều khoản bổ sung**. Các điều khoản bổ sung yêu cầu giữ lại dòng ghi nhận "Powered by Hi.Events"
trên các trang và email do phần mềm tạo ra — xem [LICENCE](LICENCE) để biết nội dung chính xác.

Chỗ ngồi đặt trước và quầy vé thuộc phạm vi [Hi.Events Enterprise Licence](backend/ee/LICENCE) và cần
giấy phép khi sử dụng trong môi trường production.

**Chúng tôi cung cấp giấy phép thương mại** nếu bạn muốn gỡ dòng ghi nhận hoặc cần điều khoản phù hợp cho triển khai
white-label. [Các lựa chọn giấy phép](https://hi.events/licensing?utm_source=gh-readme) ·
[hello@hi.events](mailto:hello@hi.events)

<br>

## Đóng góp

Chúng tôi luôn hoan nghênh đóng góp — xem [hướng dẫn đóng góp](CONTRIBUTING.md) để bắt đầu. Vui lòng mở một issue hoặc
thảo luận trước khi bắt tay vào thay đổi lớn để chúng ta thống nhất cách tiếp cận. Người đóng góp cần ký
một [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>

## Bảo mật

Phát hiện lỗ hổng bảo mật? Vui lòng báo cáo riêng qua [security@hi.events](mailto:security@hi.events) thay vì mở
issue công khai. Xem [chính sách bảo mật](SECURITY.md) của chúng tôi.

<br>

## Hỗ trợ

📖 [Tài liệu](https://hi.events/docs?utm_source=gh-readme) ·
🐛 [GitHub Issues](https://github.com/HiEventsDev/hi.events/issues) ·
💬 [Thảo luận](https://github.com/HiEventsDev/hi.events/discussions) ·
📧 [hello@hi.events](mailto:hello@hi.events)

Các tính năng mới và cải tiến được liệt kê trên
[trang phát hành](https://github.com/HiEventsDev/hi.events/releases).

<br>

<div align="center">

**[Trang web](https://hi.events)** · **[Tài liệu](https://hi.events/docs)** · **[Cloud](https://app.hi.events/auth/register?utm_source=gh-readme)** · **[Giấy phép](https://hi.events/licensing)**

Được làm với ☘️ tại Ireland

</div>