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 或更新版本,以及 package.json 里固定的那个 pnpm 版本——不需要 .env 文件,也不用配置外部服务。
我的数据能在多台设备间同步吗?不能——你的偏好、自定义菜品列表和转动次数只以 Cookie 形式存在当前浏览器里,清掉 Cookie 就全部重置,也带不到别的设备上。
我的数据会离开我的电脑吗?不会——没有登录、后端或云服务的参与;开发服务器只监听 127.0.0.1,外部链接只有你点了才会打开。
为什么 GitHub Pages 站点只做跳转而不托管应用?GitHub Pages 只重定向到官方的 truanayangi.com 站点,而且只有 pages-redirect/ 文件夹发布到 gh-pages;这样生产环境的前端、API 和登录 Cookie 都保持在同一个源上,不用再维护一个可能不同步的第二套静态应用。
能自定义它抽选的菜品列表吗?能,你可以筛选菜品、添加自己的自定义菜品列表,还能直接在浏览器里保存偏好。
如果 Cookie 被拦截,或者列表太大,会怎么样?应用只会提示你的数据没能保存。
这个项目是从哪儿来的?它从原仓库 nagisanzenin/truanayangi 转移过来,保留了完整的 git 历史和社区贡献。
Size
12.5 MB
Stars
638
Updated
CommitSep 10
Age
1mo
Commits · 90 Days