truanayangi README

The project's README from github.com/truanayangi-com/truanayangi. As one markdown file: README.md.

Trưa Nay Ăn Gì 🍜

Tiếng Việt · English

Website chính thức: truanayangi.com

Chưa biết ăn gì trưa nay? Mở hòm, quay món và để bữa trưa có chút bất ngờ.

Đây là phiên bản cộng đồng chạy trên máy của bạn, không cần đăng nhập hay backend. Bạn có thể lọc món, thêm danh sách món riêng và lưu sở thích ngay trong trình duyệt.

Chạy trên máy

Cần Node.js 22.12+ và phiên bản pnpm ghi trong package.json.

git clone https://github.com/truanayangi-com/truanayangi.git
cd truanayangi
pnpm install --frozen-lockfile
pnpm start

Mở 127.0.0.1:5173. Không cần tạo .env hay cấu hình dịch vụ bên ngoài. Nếu cổng đang bận, chạy pnpm start --port 5188.

Các lệnh phát triển:

pnpm test       # Chạy kiểm tra
pnpm build      # Tạo bản build
pnpm preview    # Xem bản build tại http://127.0.0.1:4173

Máy chủ chỉ lắng nghe trên 127.0.0.1. Sau khi cài dependencies, ứng dụng tải tài nguyên từ máy; các liên kết bên ngoài chỉ mở khi bạn bấm vào.

Dữ liệu của bạn

Sở thích, danh sách món và lượt quay tự lưu bằng cookie trong trình duyệt hiện tại. Xóa cookie sẽ đặt lại dữ liệu; dữ liệu không đồng bộ giữa các thiết bị. Lượt quay hiển thị là của riêng trình duyệt này.

Nếu cookie bị chặn hoặc danh sách món quá lớn, ứng dụng sẽ báo chưa lưu.

GitHub Pages và website chính

GitHub Pages chỉ chuyển hướng đến https://truanayangi.com/. Đây là cách giữ chức năng đồng nhất: người truy cập luôn dùng cùng frontend production, API và cookie đăng nhập cùng origin, thay vì một ứng dụng tĩnh thứ hai dễ lệch tính năng hoặc mất đăng nhập khi tải lại. Chỉ xuất bản pages-redirect/ lên gh-pages; không đưa bản build local lên đó. Các sửa đổi UI tĩnh và chuyển động vòng quay dùng chung cần được cập nhật đồng thời ở repo này và frontend production riêng tư.

Đóng góp

Chào đón mọi người báo lỗi, đề xuất ý tưởng hoặc fork repo và gửi PR vào main. Bạn có thể dùng tiếng Việt hoặc tiếng Anh, mở draft PR để trao đổi, không cần được duyệt issue trước hay tham gia tổ chức.

Chỉ cần mô tả rõ thay đổi và cách đã kiểm tra. Với thay đổi code, hãy chạy test và build khi có thể; maintainer sẽ hỗ trợ và review trước khi merge. Giữ thông tin bí mật ngoài repo và ghi công nguồn sử dụng.

Nguồn gốc

Repo được chuyển từ nagisanzenin/truanayangi, giữ nguyên lịch sử Git và đóng góp cộng đồng. Xem ghi công tác giả và tài nguyên.

GitHub Pages chuyển hướng đến website chính thức. Chỉ thư mục pages-redirect/ được xuất bản lên gh-pages; mã ứng dụng trong repo dành cho việc chạy trên máy.

truanayangi (truanayangi-com/truanayangi)

Searching Database…

Что это?«Trưa Nay Ăn Gì» (Что съесть на обед) — веб-приложение, помогающее решить, что поесть: вы открываете коробку и прокручиваете список блюд ради маленькой неожиданности.
Это размещённый сайт или то, что я запускаю сам?Эта комьюнити-версия рассчитана на запуск на вашей собственной машине, без размещения где-либо; ей не нужны ни логин, ни бэкенд-сервер.
Как её запустить?Клонируйте репозиторий, установите зависимости через pnpm, затем выполните «pnpm dev» (или «pnpm start»), чтобы открыть приложение на 127.0.0.1:5173. Если порт занят, используйте «pnpm start --port 5188».
Что нужно установить заранее?Нужны только Node.js 22.12 или новее и версия pnpm, зафиксированная в package.json — файл .env или настройка внешних сервисов не требуются.
Синхронизируются ли мои данные между устройствами?Нет — ваши настройки, собственные списки блюд и счётчик прокруток сохраняются только как cookies в текущем браузере, поэтому очистка cookies сбрасывает всё, и на другое устройство ничего не переносится.
Уходят ли какие-то мои данные с компьютера?Нет — здесь нет ни логина, ни бэкенда, ни облачного сервиса; dev-сервер слушает только 127.0.0.1, а внешние ссылки открываются только по вашему клику.
Почему сайт на GitHub Pages просто перенаправляет, а не хостит приложение?GitHub Pages лишь перенаправляет на официальный сайт truanayangi.com, и на gh-pages публикуется только папка pages-redirect/; так продакшен-фронтенд, API и cookies логина остаются на одном origin вместо поддержки второго статического приложения, которое могло бы разойтись с основным.
Можно настроить список блюд, из которых она выбирает?Да, можно фильтровать блюда, добавить собственный список блюд и сохранить настройки прямо в браузере.
Что будет, если cookies заблокированы или список станет слишком большим?Приложение просто покажет, что ваши данные не удалось сохранить.
Откуда взялся этот проект?Он передан из оригинального репозитория nagisanzenin/truanayangi с сохранением полной git-истории и вкладов сообщества.
Size
12.5 MB
Stars
638
Updated
CommitSep 10
Age
1mo
Commits · 90 Days