Super Admin — Vinana

Quyền tự quản lý — admin salon làm thay Super Admin

Bật từng cờ → admin salon tự sửa nhóm cấu hình đó trên web salon-admin (mục Cấu hình app). Super Admin vẫn có thể sửa mọi thứ tại đây.

Hạn mức upload ảnh (mỗi mục)

Super Admin đặt số ảnh tối đa. Salon admin upload qua web/app — server tự nén WebP chất lượng cao.

Gallery app Bảng màu Bảng giá Ưu đãi Gallery web đặt lịch Logo brand Ảnh chào QR

Brand Studio — theme native từ website salon

Nhập URL web salon (Median, Wix, site riêng…) → Phân tích thương hiệu tự lấy màu + logo → app Flutter native (app bar, tab, nút) đổi theo salon. Các nút chức năng (đặt lịch, thẻ, gallery…) giữ layout app Vinana.

URL website salon (nguồn phân tích)

Primary (theme.primary_color)

Secondary

Tertiary (tab / accent phụ)

Nền app (background_color)

Accent (FAB, CTA phụ)

Logo mặc định / fallback (theme.logo_url) Dùng khi chưa điền logo riêng từng vị trí bên dưới. Không ảnh hưởng web đặt lịch /book.

Logo theo vị trí trong app khách (kích thước gợi ý — PNG/JPG, URL HTTPS):

① Màn hero / đầu app (không có website nhúng) Ngang ~800×400 px, nền trong suốt hoặc trùng màu app. ② Menu 3 gạch (drawer) Vuông ~512×512 px (logo tròn OK). ③ Thẻ thành viên — Apple Wallet / Google Wallet Ngang ~1125×369 px (tối đa Apple Wallet). Không dùng link Google có =w144-h144 (ảnh thumbnail nhỏ). Nên PNG ngang, logo phủ rộng, nền hồng hoặc trong suốt. Màu nền thẻ Wallet (wallet_card_background_color)

Vùng nền pass Apple Wallet. Gợi ý vàng gold: #D4AF37. Sau khi đổi → Lưu cấu hình app → xóa pass cũ trên iPhone → thêm lại.

App bar gradient (3 màu trái → phải):

App bar 1

App bar 2

App bar 3

Xem trước theme native trong app:

Salon

Termin buchen

Thẻ khách · Gallery · native buttons

SalonThẻLịchTài khoản

Website khách trong app (WebView)

Nhúng trang web salon làm màn hình chính trong app (giống xem web trên điện thoại). Các chức năng native (gallery, đặt lịch, thẻ khách, tài khoản…) nằm trong menu 3 gạch góc phải. Chế độ lưu: embedded_website.display = website_shell. Không có URL web: bật ô dưới, để trống URL → app hiển thị logo salon to + lời chào (thay vì WebView).

Bật website nhúng (WebView) cho salon này URL website khách (embedded_website.url)

Tên nút trang chủ (mặc định: Website) Ảnh nền nút (home_button_images.website, tuỳ chọn)

UI động app khách (`customer_ui`)

Mặc định backend tự sinh layout từ Brand Studio + Website khách + ảnh nút. Đổi kiểu hiển thị mục Home bên dưới (1 ảnh / 1+3 / banner…) — app bản 1.0.25+, không cần build lại mỗi lần đổi.

Trang chủ WebView (customer_web_home) — C1 hybrid: đổi giao diện home qua web, game/booking vẫn native

Layout mục dưới logo / Home (logo-hero)

standard = 1 ảnh to + 3 nhỏ · single_image = chỉ 1 ảnh · banner = ảnh full + chữ đè · compact = tiêu đề + ảnh 16:9 · tile = hàng ngang · booking_promo = khối đặt lịch

Ghi đè thêm app_config.customer_ui (JSON nâng cao) Override JSON (tuỳ chọn)

UI động mục Đặt lịch app khách (`booking_ui`)

App khách native đọc JSON này để vẽ màn đặt lịch (tiêu đề, list/cards, màn chi tiết dịch vụ, nhãn nút…). Không nhúng trang web /book/…. Đổi nhãn / ẩn field / layout list↔cards qua JSON — không sửa code Flutter mỗi lần.

Ghi đè app_config.booking_ui (JSON) Override JSON

Salon & chỉ đường (Google Maps)

Tên salon Điện thoại Email liên hệ Địa chỉ hiển thị Thị trường pháp lý — ngôn ngữ thẻ / pháp lý theo nước

Có thể đổi lại sau khi tạo (vd: eu-de Đức, eu-cz Séc). Thẻ thành viên (portal/Wallet) theo thị trường này. Web đặt lịch / app khách chưa khóa theo ô này.

Từ khóa Maps (map_query) — nếu trống app có thể dùng địa chỉ Lưu lịch quá khứ (ngày) — salon-admin · mặc định 15

Lịch có giờ hẹn cũ hơn số ngày này (tính từ bây giờ) sẽ tự xóa khi admin mở tab Lịch hẹn. Lịch tương lai luôn giữ. VD: Queen Nails = 3.

Ảnh nền nút trang chủ (URL)

Ảnh nền portal: hiện full màn hình sau khi khách đăng nhập trên vinana.chu-nail.com. Upload tại đây hoặc từ Salon Admin → Ảnh nền nút trang chủ. Kích thước: upload ảnh nào cũng được — portal tự phủ kín khung (giữ tỉ lệ, cắt phần thừa, không méo). Muốn đẹp hơn: nền full màn ~1080×1920 (dọc) hoặc 1920×1080 (ngang); nút Home ảnh ngang (~1200×400). Ảnh nền nút Home: Loyalty / Review / Prices / Gallery / Colors / Game hiện trên portal sau khung Termin buchen. Ưu đãi: ảnh trong app lấy từ Salon Admin → Dịch vụ → URL ảnh. Nền nút Ưu đãi tự slideshow các ảnh dịch vụ; ô promotions bên dưới chỉ là ảnh dự phòng khi chưa có dịch vụ kèm ảnh.

Ảnh nền portal khách (portal_background)

Đặt lịch (booking) Bảng màu (color_board) Thư viện (gallery) Bảng giá (price_board) Ưu đãi (promotions) Game (game) Loyalty card (loyalty) Đánh giá (review)

Mạng xã hội (mở trong app — không phải ảnh)

Link Facebook / Instagram / TikTok của tiệm. Khách bấm nút trong Thư viện hình ảnh (Bildergalerie). Không dán link mạng xã hội vào ô «Thư viện salon» bên dưới (chỉ URL ảnh .jpg / .png).

Facebook Instagram TikTok

Web đặt lịch — mẫu champagne (tự bật khi tạo salon)

Layout giống Cindy / Aylin. Tên, địa chỉ, SĐT, giờ, ngôn ngữ lấy từ mục Salon & thị trường pháp lý phía trên (không gõ lại). Bạn chỉ upload ảnh theo vị trí dưới đây, rồi bấm Lưu cấu hình nếu ô báo «nhớ Lưu». Salon cũ (Sofia, Nails Bui, Euro, Leon, Queen, Anna) giữ theme riêng — không bị ghi đè khi lưu các ô này.

Logo — góc trái thanh menu (hình tròn) + badge.
Ảnh 1 · Hero — ảnh lớn đầu trang (nên mặt tiền hoặc nội thất).
Ảnh 2 · Hygiene — mục vệ sinh / sạch sẽ.
Ảnh 3 · Beauty & Pflege — ảnh cạnh đoạn mô tả dịch vụ (nên móng tay).
Galerie — các ảnh còn lại (móng, mặt tiền, nội thất).

1. Logo — góc trái menu 2. Ảnh 1 · Hero (đầu trang) 3. Ảnh 2 · Hygiene (mục vệ sinh) 4. Ảnh 3 · Beauty & Pflege (cạnh mô tả dịch vụ) 5. Galerie — ảnh còn lại (mỗi dòng một URL, tối đa 100)

0 URL (tối đa 100)

· Sau upload nhớ bấm Lưu cấu hình nếu chưa tự áp dụng.

Tiêu đề (tuỳ chọn) — để trống = tên salon Dòng mô tả đặt lịch — để trống = mặc định theo thị trường

QR cửa kính — Web đặt lịch

In và dán tại cửa salon. Khách quét → trang đặt lịch (không cần cài app). Mã salon: — · QR mặc định dùng link path (salon cũ không đổi).

Link trong QR (mặc định — path) Link Setmore-style (song song — subdomain)

Salon chưa có mã code — lưu mã salon trước khi in QR.

Reserve with Google (Actions Center)

Sau khi Google duyệt partner: nhập Place ID khớp Google Business Profile của tiệm (Thụy Điển). Lấy Place ID: Place ID Finder hoặc Google Maps → Chia sẻ → embed (dạng ChIJ…).

Google Place ID Merchant ID (feed — để trống = dùng salon code) Trạng thái RwG

Danh sách ảnh (một URL mỗi dòng)

Bảng màu — gallery Thư viện salon Bảng giá — price_board_images Ưu đãi — promotion_board_images

Ảnh trong app khi khách bấm nút Ưu đãi. Nếu để trống, app dùng ảnh từ Salon Admin → Dịch vụ (có URL ảnh).

Ảnh chào sau quét QR mời (app khách)

Tối đa 5 URL (một dòng mỗi ảnh). Khách quét QR vào app sẽ vuốt ngang fullscreen trước khi vào trang chủ. Để trống = bỏ qua bước này.

invite_onboarding_images

Freunde einladen — 2 mã QR

Mã 1 — ảnh cố định vinanaqr-code.png (tải app iOS + Android). Mã 2 — mời vào salon này (quét trong app sau khi đã cài). Giống màn Mời bạn bè trong app khách.

QR 1 — app_download_qr_image_url

QR 2 — Salon-Einladung (tự sinh theo salon)

QR thành viên portal (in tại quầy) — mọi salon

Một mã QR riêng cho từng salon — khách quét → vinana.chu-nail.com/register?invite=salon:#id (đăng ký đúng salon). Salon admin cũng tự xem/in trong app: Thêm → QR thành viên.

Salon đang cấu hình: —

Link trong QR (register?invite=salon:#id)

Mã QR thẻ (chuỗi — app hiển thị QR)

Tay (hand) Chân (foot) Mi (lash)

Doanh thu NV (app đóng dấu)

Khi bật: admin salon quản lý NV/trợ lý; NV ghi tiền → QR chờ duyệt trên thẻ khách; trợ lý/admin quét QR → đóng dấu + chốt doanh thu. Salon chưa bật cờ này thì tính năng ẩn hoàn toàn. Chỉ Super Admin được bật/tắt — admin salon không tự kích hoạt.

Kích hoạt doanh thu NV / trợ lý (experimental revenue ops)

Đóng dấu thẻ — salon-admin web

Salon-admin luôn hiện ô Giá tiền khi đóng dấu (tuỳ chọn). Khi bật ô dưới: giá bắt buộc trước khi mở camera.

Bắt nhập giá tiền mỗi lần đóng dấu (web admin)

Nhân viên đặc biệt (ẩn tên NV khách)

Bật khi salon có ≥ 2 nhân viên nhưng không muốn khách chọn tên. App khách + web đặt lịch chỉ thấy «Nhân viên đặc biệt»; hệ thống tự gán NV còn trống (cân bằng lịch). Salon-admin vẫn thấy tên NV thật.

Kích hoạt nhân viên đặc biệt

Salon tự quản lý nhân viên đặt lịch

Bật khi admin salon được tự thêm/xóa tên NV trên web salon-admin — không cần Super Admin sửa từng lần. Tương thích với nhân viên đặc biệt.

Cho phép admin salon tự quản lý danh sách NV

Thẻ khách — số ô đóng dấu & phần thưởng

Mỗi lịch đặt hẹn có một thẻ khách tương ứng (vd. massage). Số ô đóng dấu — app hiển thị thêm 1 ô quà ở cuối. Tối thiểu 2. Cột Giá trị ô cuối = phần thưởng ô quà cuối (vd. 30 + % → 30%). Cột Phần thưởng các ô — tick từng ô (1…N) và nhập giá trị quà (dùng cùng ký hiệu % / € như ô cuối). Mỗi salon tự chọn ô nào có quà. Bật Trước số nếu muốn hiển thị kiểu $15 thay vì 15$. Cột Ảnh nền = URL hình nền thẻ trong app.

Loại thẻ	Số ô đóng dấu	Giá trị ô cuối	Phần thưởng các ô	Ảnh nền (URL)

JSON đầy đủ (`customer_cards`)

type, title, qr_data, stamp_slot_count, discount_percent, reward_unit, reward_unit_before, reward_label, slot_rewards, background_image_url

Giờ mở cửa (`salon_admin_calendar`)

Chỉ Super Admin đặt giờ hiển thị trên lịch hẹn (app khách + admin salon + web đặt lịch). Mặc định 09:00–19:00, mỗi ô lưới 20 phút (có thể đổi theo salon).

Mở cửa Đóng cửa Mỗi ô lưới (phút)

Ngày nghỉ / đóng cửa (`closed_weekdays`)

Chọn ngày salon không nhận đặt lịch (app khách, web-book, admin). 0 = Chủ nhật, 1 = Thứ hai … 6 = Thứ bảy. Đức / Thụy Sĩ thường đóng Chủ nhật; salon khác có thể mở cả tuần.

Lịch đặt hẹn động (`booking_calendars`)

Mỗi dòng = một loại lịch trong app (tay, chân, mi, hoặc loại mới). ID phải duy nhất (chỉ chữ thường, số, gạch dưới — vd. hand, hand_2, brows). Nhãn hiển thị được phép trùng (hai lịch cùng tên «Maniküre» nhưng ID khác nhau). Trùng ID khi lưu sẽ bị đổi thành …_2, …_3 (không ghi đè im lặng). App chỉ hiện lịch bật. Salon chưa thêm nhân viên thì hệ thống dùng NV tượng trưng Team để web đặt lịch vẫn chạy (có thể đổi/xóa khi salon thêm NV thật). Mỗi lịch cần bảng dịch vụ (tên + thời gian; tuỳ chọn giá / ảnh / mô tả cho gói web). Cột giá theo thị trường pháp lý phía trên (Séc eu-cz → Kč, Đức → €) — không cần điền tay. Tick cột Ab? (hoặc From / Od… theo thị trường) để khách thấy «Ab 25 €» thay vì giá cố định. Salon id ≥ 47: thời lượng dịch vụ chọn theo bước 5 phút (ô lưới vẫn 10/15/20…).

Web đặt lịch: chọn gói dịch vụ trước ngày/giờ (không dùng logic loại trừ). Mặc định bật toàn Vinana — bỏ tick để dùng luồng classic (ngày → giờ → dịch vụ). Web đặt lịch: waitlist + nhắc email (mặc định bật toàn Vinana — bỏ tick để tắt salon này; cần SMTP).

In toàn bộ 4 mã QR — salon mới (khổ A4)

Một tờ in cho tiệm mới mở — gồm đủ 4 mã QR: mục 12 (2 mã nằm ngang trên cùng) · mục 13 (giữa, to hơn chút) · mục 9 (dưới cùng, to nhất + dòng Booking Online). Có 3 đường kẻ cắt ngang (nét đứt + ✂) — xén thành 3 tờ: mục 12 · mục 13 · mục 9.