НачалоФункцииЦениЗа насКонтактиRoadmap

Решения

Дигитално менюAR меню с 3DОнлайн поръчкиСобствена доставкаКухненски дисплей (KDS)HACCP дневнициСайт за ресторантФискални устройства (POS)
Към изтеглянето

Инсталация на каса под Windows - чеклист за техници

Само за касата с фискално устройство: инсталирайте ErpNet.FP като Windows услуга. Втора каса без фискално устройство и каса с myPOS Carbon - не е нужно.

Изтегли ErpNet.FP →

За техника, който подготвя нова каса на място. Минава се отгоре надолу; всяка стъпка завършва с проверка. Отбелязвай резултата в протокола на обекта ([x]).

> Отнася се за Windows 11 Pro 23H2 или по-нов (Windows 10 Pro 22H2 работи, но kiosk стъпката се различава). > Windows Home не поддържа kiosk (Assigned Access) — смени изданието преди да продължиш.

---

0. Преди да започнеш

  • [ ] Локален администраторски акаунт само за поддръжка (напр. fudiar-admin) със силна парола в password manager-а. Касата никога не работи под него.
  • [ ] Windows е активиран и обновен (Settings → Windows Update → всички обновления + рестарт), преди да се заключи в kiosk.
  • [ ] Интернет и LAN: касата, фискалното устройство и кухненските принтери са в една мрежа; принтерите по IP са с резервиран адрес в рутера (DHCP reservation).
  • [ ] BIOS/UEFI: Restore on AC power loss = Power On (касата тръгва сама, когато токът дойде).
  • [ ] Имаш код за сдвояване от Администрация → Каса → Устройства.

1. FudiAR POS и фискален мост

  1. [ ] Изтегли FudiAR-POS-Setup-<версия>.exe от https://fudiar.com/app (картата „FudiAR Каса“ - последната стабилна версия) и го инсталирай като администратор (инсталира се за всички потребители в C:\Program Files\FudiAR POS\). Ако Windows покаже „Windows защити компютъра Ви“ - „Още информация“ → „Стартирай въпреки това“ (докато инсталаторът не е подписан).
  2. [ ] Инсталирай ErpNet.FP и настрой фискалното устройство (COM порт / USB). Провери в браузър: http://localhost:8001/printers връща устройството.
  • Ако тази каса е hub за други каси в залата, ErpNet.FP трябва да слуша и на LAN адреса, не само на localhost (виж настройките на ErpNet.FP), и другите каси проверяват http://<IP на hub-а>:8001/printers.
  • Под kiosk потребител се стартират само разрешените програми → ErpNet.FP трябва да работи като Windows услуга. Ако не може, добави exe-то му в AllowedApps в стъпка 4.
  • Изтегли го от официалното репо (линкът е и на https://fudiar.com/app, картата „FudiAR Каса“). Нужен е само на касата с фискално устройство; втора каса без устройство и каса с myPOS Carbon - не.
  • Проверява се автоматично (POS-02). Касата пита …/printers при старт, при отключване и на 5 минути (само ако касата й има ФУ с ErpNet.FP) и показва лента, без да спира продажбите:
  • „За фискалните бонове на този компютър трябва ErpNet.FP.“ - не е инсталиран → „Изтегли ErpNet.FP“ отваря браузъра (в kiosk - адрес и QR код);
  • „ErpNet.FP е инсталиран, но не работи.“ → „Стартирай“ (без права на администратор: стартирай FudiAR POS като администратор или рестартирай компютъра);
  • „…не вижда фискалното устройство“ - кабел / захранване; „…вижда друго устройство“ - друг сериен номер;
  • „Касата с фискалното устройство (…) не отговаря“ - устройството е на друга каса (hub), провери нея. Резултатът се вижда и в админа: Устройства → Фискални → „Каса …: ErpNet.FP - работи / не е инсталиран / спрян“.
  1. [ ] Стартирай FudiAR POS веднъж като администратор и сдвои касата с кода (екранът /pos/pair).

2. Скрипт setup-windows.ps1

Скриптът е в electron/scripts/setup-windows.ps1. Идемпотентен е — пусни го отново след големи обновления на Windows или ако нещо е „помръднало".

Какво прави:

  • Захранване: план High performance; екранът не изгасва; без sleep и hibernate; изключен Fast Startup.
  • Windows Update:
  • активни часове 07–23;
  • изтегляне и инсталиране всеки ден в 03:00;
  • без известия за обновления;
  • без известия над заключения екран.
  • Интерфейс: скрита икона на touch клавиатурата.
  • Време:
  • часова зона FLE Standard Time (Europe/Sofia), изключена автоматична смяна на зоната;
  • NTP (bg.pool.ntp.org, time.windows.com) на всеки час.
  • Автостарт: FudiAR POS се пуска при вход за всички потребители.
  • Firewall: входящ TCP 8001 (ErpNet.FP), само от локалната подмрежа и само за Private мрежи.
  • RustDesk 1.4.9: инсталира го (проверен SHA-256 + подпис) и го настройва за достъп само с потвърждение на касата, без парола — виж стъпка 5.
  • По избор:
  • създава стандартния акаунт на касата;
  • автоматичен вход, като паролата се пази като LSA secret, не в registry.

Пусни от администраторски PowerShell (Windows PowerShell 5.1):

``powershell cd "C:\път\до\electron\scripts" $pw = Read-Host -AsSecureString "Парола за акаунта на касата" powershell -ExecutionPolicy Bypass -File .\setup-windows.ps1 -KioskUser fudiarpos -AutoLogin -Password $pw ``

> -Password приема SecureString. Ако не я подадеш, скриптът пита. Паролата на съществуващ акаунт не се сменя — трябва да > е текущата, иначе автоматичният вход не се включва.

Други параметри (стойностите по подразбиране са в скобите):

  • -User — акаунт за автоматичен вход, ако е различен от -KioskUser;
  • -AppPath (пътят на инсталацията);
  • -FiscalBridgePort (8001);
  • -NtpServers;
  • -TimeZoneId;
  • -ActiveHoursStart (7), -ActiveHoursEnd (23), -UpdateInstallHour (3);
  • -RustDeskInstaller <път> — локален инсталер на RustDesk за каса без интернет; -SkipRustDesk — без RustDesk.

Проверка:

  • [ ] Обобщението накрая е OK или ВНИМАНИЕ, без ГРЕШКА. Всяко ВНИМАНИЕ е прочетено и решено.
  • [ ] Логът е в C:\ProgramData\FudiAR\setup\setup-windows-<дата>.log; приложи го към протокола.
  • [ ] Ако скриптът предупреди, че мрежата е Public, а това е мрежата на ресторанта, направи я Private: Set-NetConnectionProfile -InterfaceIndex <N> -NetworkCategory Private (иначе порт 8001 остава затворен).
  • [ ] Рестарт.

Изключване на автоматичния вход по-късно (като администратор): Set-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon' AutoAdminLogon '0'.

3. Проверка след рестарт

  • [ ] Windows влиза сам като fudiarpos и FudiAR POS се отваря на цял екран на PIN екрана.
  • [ ] w32tm /query /status (като администратор) показва източник от NTP списъка и скорошна синхронизация; часът съвпада с часа на фискалното устройство.
  • [ ] След 30 минути без докосване екранът е включен.
  • [ ] Няма известия от Windows върху касата.

4. Kiosk: Assigned Access за стандартния потребител

Целта: под fudiarpos се стартира само FudiAR POS, без лента на задачите, Start менюто и файловете. Администраторският акаунт не е засегнат.

> Не ползвай Settings → Accounts → Other users → „Kiosk" — там се избират само приложения от Microsoft Store. FudiAR POS е > desktop (Win32) приложение, затова се настройва с XML през WMI bridge-а на Assigned Access CSP (multi-app kiosk с автоматично > стартиране). Първо пробвай на тестова машина със същата версия на Windows.

  1. [ ] fudiarpos е стандартен потребител (скриптът предупреждава, ако е администратор) и е влизал поне веднъж.
  2. [ ] Изтегли Sysinternals PsExec и отвори PowerShell като SYSTEM (WMI bridge-ът не приема обикновен администратор): PsExec64.exe -i -s powershell.exe
  3. [ ] В този прозорец:

``powershell $account = "$env:COMPUTERNAME\fudiarpos" $xml = @" <?xml version="1.0" encoding="utf-8"?> <AssignedAccessConfiguration xmlns="http://schemas.microsoft.com/AssignedAccess/2017/config" xmlns:rs5="http://schemas.microsoft.com/AssignedAccess/201810/config" xmlns:win11="http://schemas.microsoft.com/AssignedAccess/2022/config"> <Profiles> <Profile Id="{6b3a0f6e-2f55-4d8e-9a57-0b3c7f1d2e41}"> <AllAppsList> <AllowedApps> <App DesktopAppPath="%ProgramFiles%\FudiAR POS\FudiAR POS.exe" rs5:AutoLaunch="true" /> <!-- RustDesk: прозорецът „Приеми“ се пуска под акаунта на касата (стъпка 5) --> <App DesktopAppPath="%ProgramFiles%\RustDesk\rustdesk.exe" /> </AllowedApps> </AllAppsList> <win11:StartPins> <![CDATA[{"pinnedList":[{"desktopAppLink":"%ALLUSERSPROFILE%\\Microsoft\\Windows\\Start Menu\\Programs\\FudiAR POS.lnk"}]}]]> </win11:StartPins> <Taskbar ShowTaskbar="false" /> </Profile> </Profiles> <Configs> <Config> <Account>$account</Account> <DefaultProfile Id="{6b3a0f6e-2f55-4d8e-9a57-0b3c7f1d2e41}" /> </Config> </Configs> </AssignedAccessConfiguration> "@ $obj = Get-CimInstance -Namespace "root\cimv2\mdm\dmmap" -ClassName "MDM_AssignedAccess" $obj.Configuration = [System.Net.WebUtility]::HtmlEncode($xml) Set-CimInstance -CimInstance $obj ``

  1. [ ] Рестарт. fudiarpos влиза, FudiAR POS тръгва сам и няма лента на задачите.
  2. [ ] При грешка: Event Viewer → Applications and Services Logs → Microsoft → Windows → AssignedAccess.

Какво да знаеш:

  • Излизане за поддръжка: Ctrl+Alt+Del → Изход / Смяна на потребител → администраторът. При автоматичен вход задръж Shift докато Windows зарежда.
  • В multi-app kiosk затвореното приложение не се стартира само отново. Ctrl+Alt+Shift+Q е само за поддръжка; за рестарт на касата — изход и вход (или рестарт на компютъра).
  • Обновленията на FudiAR POS не се инсталират под kiosk потребителя: инсталерът е за всички потребители (иска администратор), а kiosk-ът блокира други exe файлове. Докато това не се реши (WP-45), обновявай като администратор: влез, стартирай FudiAR POS, изчакай изтеглянето и го затвори (инсталира се при затваряне), или пусни новия инсталер ръчно.
  • Премахване на kiosk-а (като SYSTEM): $obj = Get-CimInstance -Namespace "root\cimv2\mdm\dmmap" -ClassName "MDM_AssignedAccess"; $obj.Configuration = $null; Set-CimInstance -CimInstance $obj

5. RustDesk (отдалечена поддръжка само с потвърждение на касата)

Правилото: RustDesk на касата работи само с ръчно потвърждение на самата каса. Няма парола за достъп (нито постоянна, нито еднократна), няма запис в password manager-а и няма достъп без човек пред касата. Поддръжката се свързва само когато операторът натисне „Разреши отдалечен достъп“ на касата и след това „Приеми“ в прозореца на RustDesk.

RustDesk се инсталира и настройва от setup-windows.ps1 (стъпка „RustDesk: отдалечена поддръжка само с потвърждение“):

  • версията е фиксирана (1.4.9); инсталерът се приема само ако SHA-256 съвпада и подписът е валиден и е на O=PURSLANE (издателят на RustDesk), иначе стъпката е ГРЕШКА и нищо не се инсталира;
  • услугата RustDesk се инсталира, стартира и е Automatic;
  • approve-mode = click (в този режим RustDesk отказва вход с парола), verification-method = use-temporary-password;
  • постоянната парола се сменя със случайна, която не се показва никъде (така се обезсилва парола от стара инсталация);
  • накрая скриптът показва RustDesk ID.

Без интернет на касата: свали rustdesk-1.4.9-x86_64.exe от GitHub releases на RustDesk на друга машина и подай -RustDeskInstaller <път> — проверката е същата. -SkipRustDesk пропуска стъпката.

  1. [ ] В обобщението на скрипта стъпката за RustDesk е OK; редът проверено: approve-mode = click е в лога.
  2. [ ] Запиши в протокола само ID-то на RustDesk. Никаква парола не се записва — такава няма.
  3. [ ] Не настройвай RustDesk ръчно (Settings → Security): не задавай постоянна парола, не сменяй режима на потвърждение и не включвай „unattended access“. Ако някой го е направил, пусни скрипта отново.
  4. [ ] В kiosk XML-а (стъпка 4) rustdesk.exe е в AllowedApps — иначе прозорецът за потвърждение не може да се покаже под акаунта на касата.
  5. [ ] Проверка от друга мрежа (мобилен интернет), с касата на PIN екрана:
  • свържи се с ID-то без да е натиснато нищо на касата → на касата се показва прозорецът на RustDesk с „Приеми“;
  • натисни отказ / не прави нищо → връзката не се осъществява (RustDesk не пуска с парола);
  • на касата: „Помощ сега“ → „Разреши отдалечен достъп“ (право settings или PIN на управител) → касата показва ID-то и обратно броене; свържи се и натисни „Приеми“ → виждаш екрана;
  • прекрати връзката с „Прекъсни“ в прозореца на RustDesk, после „Прекрати достъпа“ на касата → касата се връща на цял екран (kiosk);
  • повтори след рестарт на компютъра.

6. UPS

  1. [ ] Към UPS-а са включени касата, мониторът, фискалното устройство, рутерът и суичът. Кухненските принтери могат да останат на обикновен контакт.
  2. [ ] USB кабелът на UPS-а е към касата. Windows го показва като батерия (иконата в лентата / powercfg /batteryreport).
  3. [ ] Инсталирай софтуера на производителя, ако моделът го изисква за контролирано изключване (напр. APC PowerChute Serial Shutdown, CyberPower PowerPanel Personal, Eaton UPS Companion). Ако UPS-ът се вижда като батерия, Windows може да се изключи и без него.
  4. [ ] Действие при критично ниво = Изключване (скриптът изключва hibernate, затова не избирай „Hibernate"):

``powershell powercfg /setdcvalueindex SCHEME_CURRENT SUB_BATTERY BATACTIONCRIT 3 # 3 = shut down powercfg /setdcvalueindex SCHEME_CURRENT SUB_BATTERY BATLEVELCRIT 20 # при 20 % powercfg /setactive SCHEME_CURRENT ``

  1. [ ] Тест: извади UPS-а от контакта. Касата продължава да работи, Windows показва работа на батерия, при критичното ниво се изключва чисто. След връщане на тока компютърът тръгва сам (BIOS, стъпка 0) и влиза в касата.

7. Изключение в Microsoft Defender

Сканирането в реално време забавя старта на приложението и може да даде фалшив сигнал за неподписана версия. Изключват се само папките на приложението, не процеси и не Downloads.

```powershell Add-MpPreference -ExclusionPath "$env:ProgramFiles\FudiAR POS"

Данни на приложението (логове, secure store) и кеш за обновления на акаунта на касата:

Add-MpPreference -ExclusionPath "C:\Users\fudiarpos\AppData\Roaming\FudiAR POS" Add-MpPreference -ExclusionPath "C:\Users\fudiarpos\AppData\Local\fudiar-pos-updater" Get-MpPreference | Select-Object -ExpandProperty ExclusionPath ```

  • [ ] Трите пътя са в списъка. Ако ресторантът има друг антивирус, добави същите изключения там.
  • [ ] Defender е включен — изключението не замества защитата.

8. Тест на принтерите

За всеки принтер от Администрация → Каса → Принтери:

  1. [ ] Връзка:
  • LAN: Test-NetConnection <IP> -Port 9100 → TcpTestSucceeded : True;
  • Windows принтер: името в админа е точно като в „Принтери и скенери";
  • USB/COM: портът е верен.
  1. [ ] Тест страница от админа. Командата стига до касата с heartbeat-а (до минута). Касата трябва да е отключена или поне на PIN екрана.
  2. [ ] На тест страницата са отпечатани три реда кирилица. Избери кодовата таблица на реда, който изглежда правилно, и запази. Пусни теста пак — кирилицата е четима.
  3. [ ] Хартията се реже. Касовото чекмедже се отваря, ако е вързано към този принтер.
  4. [ ] Изключи и включи принтера (и извади/върни USB кабела). Следващата тест страница минава без рестарт на касата.
  5. [ ] Кухненски/барови принтери: тест от касата, от която реално се печата.
  6. [ ] Фискалното устройство: http://localhost:8001/printers го вижда, а статусът е без грешка (хартия, капак, дата/час).

9. Предаване

  • [ ] Пълен рестарт → автоматичен вход → FudiAR POS на PIN екрана без никакво докосване.
  • [ ] Вход с PIN на служител, скан с баркод четец / карта (ако има), тест страница — всичко работи.
  • [ ] RustDesk ID (само ID-то — RustDesk няма парола) и логът от скрипта са в протокола; паролите на Windows акаунтите са в password manager-а.
  • [ ] Персоналът знае:
  • касата не се изключва от бутона;
  • при „Няма връзка" изчакват, касата опитва сама;
  • кого да търсят.