﻿================================================================================
WebRep Sync - r_keeper 7 MS SQL un CardServ PDS Sinhronizacijas Agents
Versija: v1.211.0 | Izstradats: kuriet.lv / UCS WebRep komanda
================================================================================

1. KAS IR WEBREP SYNC?
--------------------------------------------------------------------------------
WebRep Sync ir viegls, autonoms Windows serviss un vadibas riks, kas tiek uzstadits 
uz ta pasha Windows datora vai servera, kur darbojas restorana r_keeper 7 sistema.
Tas automatiski nolasa tirdzniecibas datus (cekus, mainas, edienus, atlaides, maksajumus)
no vietejas r_keeper MS SQL datubazes, ka ari nodrosina divvirzienu lojalitates karsu 
un bilances sinhronizaciju ar UCS CardServ (PDS).

2. KAPEEC NAV NEPIECIESAMI AREJIE PORTI VAI DDNS?
--------------------------------------------------------------------------------
Tradicionalajiem attalinatajiem pieslegumiem bija nepieciesams:
  - Statiska areja publiska IP adrese vai Dinamiskais DNS (DynDNS / No-IP).
  - Rutera portu paradresacija (Port Forwarding) portam 1433 vai 3052.
  - Drosibas riski, paklaujot datubazes portus interneta uzbrukumiem.

AR WEBREP SYNC SIS PROBLEMAS IR 100% ATRISINATAS:
  * Serviss atrodas lokali uz ta pasha Windows datora vai servera un piesledzas pie 
    MS SQL caur lokalo savienojumu: (local), (local)\SQLEXPRESS vai 127.0.0.1.
  * Ugunsmuri un ruteri NAV jaatver neviens ienakossais ports (ports 1433 paliek slegts).
  * Visi dati tiek nosutiti no iekspuses uz aru (Outbound HTTPS) caur drosu sifretu kanalu 
    ar API atslegas autorizaciju uz centralo atskaisu serveri.

3. UZSTADISANAS GAITA (WEBREPSYNCSETUP.EXE)
--------------------------------------------------------------------------------
1. solis: Palaidiet failu WebRepSyncSetup.exe ka administrators.
2. solis: Izvelieties instalacijas mapi (nokluseti C:\Apps\WebRepSync) un valodu.
3. solis: Konfigurejiet parametrus trijas sadalas:
   A) Makona Web Atskaites:
      - Servera URL: https://rieksti.lv/orderTaker/api/loyalty/sync-cards
      - Restorana ID: piem., DIWALLI vai JURMALA
      - Sinhronizacijas intervāls: 5 minutes
      - Drosibas API atslega: rk7_loyalty_...
   B) r_keeper 7 MS SQL Datubaze:
      - SQL Server / Instance: (local) vai (local)\SQLEXPRESS
      - Datubazes nosaukums: rk7 vai izmantojiet pogu 'Skenet DB'
      - Autentifikacija: Windows integrata (Trusted) vai SQL lietotajs (sa / parole)
      - Poga 'Parbaudit SQL savienojumu' lauj parliecinaties par pieslegumu pirms instalacijas.
   C) UCS CardServ (PDS) Lojalitātes kartes:
      - CardServ Host un ports (nokluseti 192.168.1.15:3052)
      - Mape ar card.udb failu (datubāzes fails netiek blokets).
4. solis: Diagnostikas soli vednis automatiski parbauda visus 3 savienojumus.
5. solis: Pec instalacijas pabeigsanas Windows serviss WebRepSyncService tiek palaists 
   automatiski fona rezima ar atiestates aizsardzibu pie klumem.

4. DIAGNOSTIKAS TIMEKLA LAPA (LOCAL TESTER)
--------------------------------------------------------------------------------
Uz darbvirsmā tiek izveidota saisne 'WebRep Sync Local Tester', kas atver:
  http://127.0.0.1:8999/

Saja lapa reallaika redzams:
  - Servisa statuss (Online/Offline) un sistemas pulss.
  - r_keeper MS SQL statusa panelis: pedēja sinhronizacija, atrasto ceku un mainu skaits.
  - Pogas: 'Testet SQL savienojumu', 'Sinhronizet SQL datus tagad', 'Skenet DB'.
  - Karsu meklešana un lasisana ar visiem 18 r_keeper PCards laukiem.
  - Karsu bilances papildinasana, norakstisana un blokēšana.
  - Pilns sistemas zurnals (Live Logs).

5. GRAFISKA LIETOTNE (WEB_REP_SYNC_APP.PY / WEB_REP_SYNC.EXE)
--------------------------------------------------------------------------------
Grafiskaja saskarne funkcijas ir sadalitas skaidras, neatkarigas cilnes:
  1. cilne: [r_keeper SQL Konfigurācija] - SQL instance, datubaze, autorizacija, intervali.
  2. cilne: [SQL Testešana & Diagnostika] - tiesais savienojuma tests, tabulu parbaude, manuala sinhronizacija.
  3. cilne: [Karsu Testešana & PDS Bridge] - lojalitates karsu 18 lauku parbaude, bilance, ligzdas tests.
  4. cilne: [Sistemas Zurnali (Live Logs)] - reallaika zurnals ar limenu filtriem (INFO/WARN/ERROR/SQL) un eksportu.
  5. cilne: [Pamatkonfigurācija & Serviss] - Web URL, API atslega, servisa instalesana/startesana.

================================================================================
Tehniskais atbalsts un jautajumi: kuriet.lv / UCS WebRep
