================================================================================
SELGORITHM — POINT OF SALE SYSTEM
USER MANUAL
Version 2026
================================================================================
--------------------------------------------------------------------------------
TABLE OF CONTENTS
--------------------------------------------------------------------------------
1. Introduction & System Overview
2. Key Benefits
3. Getting Started
4. Core Features
4.1 Product Entry & Barcode Scanning
4.2 Shopping Cart Management
4.3 Payment & Sales Processing
4.4 Customer Management (Accounts)
4.5 Order Hold
4.6 Product Management
4.7 Type Code System
4.8 Loyalty Cards & Points
4.9 Reports
4.10 Profit Report
4.11 Sale Cancellation & Correction
4.12 Movements Report
4.13 Finance & Personnel Module
4.14 Warehouse Exit List
4.15 Data Import / Export
4.16 Receipt Printing
4.17 Barcode Label Printing
5. Administration
5.1 User Management
5.2 Settings & Themes
6. Keyboard Shortcuts
7. Data Security & Backup
8. Technical Notes
================================================================================
1. INTRODUCTION & SYSTEM OVERVIEW
================================================================================
Selgorithm is a professional, offline-capable Point of Sale (POS) application
designed specifically for bookstores and retail businesses. Built on a modern
web-based interface running locally on Windows, it combines the flexibility of
a browser-based UI with the reliability and speed of a desktop application.
Selgorithm requires no internet connection for daily operations. All data is
stored locally in an encrypted SQLite database, ensuring your business data
remains private and immediately accessible even without network connectivity.
The application supports 8 languages, 13 visual themes, and multiple currency
formats — making it suitable for both domestic and international operations.
================================================================================
2. KEY BENEFITS
================================================================================
SPEED & EFFICIENCY
——————————————————
Barcode scanning completes a sale in seconds. Keyboard shortcuts eliminate
the need to reach for the mouse during peak hours, dramatically reducing
transaction time and cashier fatigue.
DATA OWNERSHIP
——————————————
Your data never leaves your device. No subscription fees, no cloud dependency,
no risk of service interruption. Full ownership of your sales history,
customer data, and inventory at all times.
PROFIT VISIBILITY
—————————————————
The built-in Profit Report calculates net profit per day, week, month, and
year by comparing sale prices against purchase costs. This allows owners to
identify high-margin periods and make informed stocking decisions.
CUSTOMER RELATIONSHIPS
——————————————————————
The loyalty card and points system encourages repeat customers. Detailed
account tracking (veresiye/credit sales) helps manage credit customers and
outstanding balances transparently.
MULTI-USER ACCESS CONTROL
——————————————————————————
Role-based access (admin vs. staff) ensures cashiers can only perform
permitted operations, while managers retain full control over sensitive
functions such as cancellations, reports, and configuration.
INVENTORY CONTROL
—————————————————
Automatic stock updates on every sale and cancellation. Low-stock alerts
prevent stockouts on popular titles. The Warehouse Exit List produces a
printable PDF showing all sold items in any date range.
================================================================================
3. GETTING STARTED
================================================================================
FIRST LAUNCH
————————————
On first launch, you will be guided through a setup wizard to configure:
- Company name and logo emoji
- Default language and currency
- Admin username and password
LOGGING IN
——————————
Navigate to the login page and enter your credentials. Use the "Remember Me"
option on shared devices only if appropriate for your security policy.
DEVICE COMPATIBILITY
—————————————————————
Selgorithm automatically detects your device type and loads an optimized
layout:
- Desktop: Full-featured dual-panel layout
- Tablet: Adapted layout with slide-out drawer navigation
- Mobile: Compact touch-optimized interface
================================================================================
4. CORE FEATURES
================================================================================
4.1 PRODUCT ENTRY & BARCODE SCANNING
——————————————————————————————————————
Scan a product barcode using a USB or Bluetooth barcode scanner, or type
the barcode manually into the barcode input field. The product is instantly
retrieved from the database and added to the cart.
BENEFIT: Barcode scanning eliminates manual price entry errors and reduces
transaction time to under 2 seconds per item, even with large inventories.
- Press F4 at any time to instantly return focus to the barcode input.
- Press F3 to search products by name when a barcode is unavailable.
4.2 SHOPPING CART MANAGEMENT
——————————————————————————————
The cart displays all scanned items with editable quantity, discount, and
unit price fields. Click any cell to edit inline.
BENEFIT: Real-time cart editing allows cashiers to apply custom discounts,
correct quantities, and adjust prices without restarting the transaction.
- Select a row and press F2 to open the full product edit modal.
- Use Ctrl+↓ / Ctrl+↑ to navigate between cart rows from the keyboard.
- Right-click any row for context menu options (edit / delete).
4.3 PAYMENT & SALES PROCESSING
—————————————————————————————————
Selgorithm supports three payment methods:
CASH (F8) — Immediate cash payment. Stock is reduced, daily
revenue counter is updated.
CARD (F9) — Credit/debit card payment. Same process as cash.
CREDIT (F6) — Deferred payment assigned to a customer account.
Automatically creates a debt entry in the customer's
ledger. Only available when a customer is selected.
BENEFIT: Flexible payment options support all retail scenarios. Credit sales
enable formal account management without external accounting software.
4.4 CUSTOMER MANAGEMENT (ACCOUNTS)
——————————————————————————————————
Add and manage customer accounts (cari) for credit tracking. Each customer
has a ledger showing all credit sales, payments, and balances.
BENEFIT: Replace paper ledger books with a searchable, always-accurate
digital record of every customer's outstanding balance and transaction history.
- Rename or delete customers from the settings menu.
- Customer accounts integrate directly with credit (veresiye) sales.
4.5 ORDER HOLD (F7)
————————————————————
Save a partially completed cart to the Hold queue while serving another
customer. Held orders are listed in the right panel and can be restored
at any time.
BENEFIT: Eliminate lost sales due to customer interruptions. Cashiers can
handle multiple transactions simultaneously without data loss.
4.6 PRODUCT MANAGEMENT
—————————————————————————
Each product record contains:
- Barcode, title, publisher
- List price (cover price)
- Purchase discount (cost basis for profit calculation)
- Reseller discount
- Customer discount
- Current stock level
- Type code (category)
- Cover image
Right-click any scanned product to edit its details.
BENEFIT: Centralized product data ensures consistent pricing across all
transactions. Purchase discount integration enables automatic profit tracking
without manual cost entries.
4.7 TYPE CODE SYSTEM
——————————————————————
Assign 1–3 character type codes to categorize products (e.g., R = Novel,
T = Test/Study, C = Children). Create unlimited custom codes with custom
colors via Settings → Manage Type Codes.
BENEFIT: Type codes enable filtered warehouse exit lists, allowing warehouse
staff to see only the product categories relevant to their work area.
4.8 LOYALTY CARDS & POINTS
—————————————————————————————
Issue physical loyalty cards with unique card numbers. Points are earned
automatically based on a configurable earning rate per purchase. View each
customer's total points and transaction history in the Finance module.
BENEFIT: Loyalty programs increase repeat purchase rates. The automated
points system requires no manual tracking and integrates seamlessly with
sales processing.
4.9 REPORTS — DATE RANGE SALES REPORT
————————————————————————————————————————
Access via Reports → Date Range Report. Select any start and end date to
generate a full list of sales including: date, barcode, title, publisher,
quantity, unit price, discount, total, customer, and payment type.
BENEFIT: Instant access to historical sales data for any period. Export to
Excel for further analysis or accounting integration. Print directly from
the browser for physical records.
4.10 PROFIT REPORT
———————————————————
Access via Reports → Profit Report. View aggregated profit data across four
time scales: Daily, Weekly, Monthly, Yearly.
Each row shows: Period | Qty | Revenue | Cost | Profit | Margin%
Summary cards display total revenue, cost, net profit, and average margin.
Profit = Revenue − (Qty × List Price × (1 − Purchase Discount%))
BENEFIT: Real-time profitability data without an accountant. Identify which
periods, seasons, or months generate the highest margins. Compare weekly
performance to optimize ordering and staffing decisions.
4.11 SALE CANCELLATION & CORRECTION
——————————————————————————————————
CANCEL: Search a past sale by barcode. Review the sale details and confirm
cancellation. The cancelled record is archived, stock is automatically
restored, and revenue is adjusted.
CORRECT: Moves a past sale's items back into the active cart for repricing
or re-scanning before re-selling at corrected values.
BENEFIT: Audit-safe corrections without permanent data deletion. Cancelled
sales are preserved in a separate archive for compliance and review.
4.12 MOVEMENTS REPORT
———————————————————————
Access via Reports → Movements. Scan or enter a barcode to view the last
7 days of sales activity for that specific product, including quantity
sold per day.
BENEFIT: Quickly identify fast-moving stock to prioritize reordering before
a stockout occurs.
4.13 FINANCE & PERSONNEL MODULE
—————————————————————————————————
Access via Admin → Finance & Personnel (/finans).
Features:
- Staff management: add staff, track working hours (overtime support)
- Salary payments: record and track payment history per employee
- Expense tracking: log business expenses by category
- Daily financial summary: revenue, expenses, net balance
- Customer accounts: full debit/credit ledger per customer
- Export finance data to Excel
BENEFIT: A complete small-business finance overview in a single screen.
No need for separate payroll or expense software for small teams.
4.14 WAREHOUSE EXIT LIST (eksik-listesi)
——————————————————————————————————————————
Access via Admin → Missing List. Select a date range and product type
filters to generate a printable PDF showing all sold items (warehouse
exit/pick list).
BENEFIT: Provides warehouse staff with a clear, type-filtered pick list
directly from sales data — eliminating manual list preparation and reducing
fulfillment errors.
4.15 DATA IMPORT / EXPORT
——————————————————————————
Access via Data menu.
EXPORT:
- Stock list to Excel (.xlsx)
- Sales report to Excel for any date range
- Full database backup (.db file)
IMPORT:
- Bulk product import via Excel template
- Preview mode shows potential issues before applying
- Database restore from backup
BENEFIT: Seamless integration with Excel-based workflows. Bulk product entry
dramatically reduces setup time for new stores. Regular backups protect
against data loss.
4.16 RECEIPT PRINTING
———————————————————————
Configure your thermal receipt printer in Settings → Receipt Settings.
Receipts include company name, sub-header, itemized cart, totals, discount
summary, and customer information.
BENEFIT: Professional receipts enhance customer trust and provide a physical
record of every transaction for both parties.
4.17 BARCODE LABEL PRINTING
——————————————————————————
From the product edit modal, click the print button to open the barcode
label designer. Choose label size, quantity, and layout. Print directly
to any connected printer.
BENEFIT: In-house label printing eliminates dependency on pre-printed labels
and allows immediate re-labelling when prices change.
================================================================================
5. ADMINISTRATION
================================================================================
5.1 USER MANAGEMENT
———————————————————————
Admin users can create, edit, and delete staff accounts at /admin/users.
Two roles are available:
ADMIN — Full access to all features including reports, cancellations,
user management, and configuration.
STAFF — Access to sales, cart, holds, and customer selection only.
BENEFIT: Role separation prevents unauthorized access to sensitive functions
such as financial reports and sale cancellations.
5.2 SETTINGS & THEMES
—————————————————————————
Access via Admin → Settings.
- Company name and logo emoji
- Display language (8 options)
- Visual theme (13 options)
- Currency symbol
- Low stock alert threshold
- Default customer name
- Type code management
BENEFIT: Full personalization ensures the interface reflects your brand and
feels familiar to your team from day one.
================================================================================
6. KEYBOARD SHORTCUTS
================================================================================
KEY ACTION
—————————— ————————————————————————————————————————
F1 Open keyboard shortcuts reference
F2 Edit selected product (cart row must be selected)
F3 Open product search by name
F4 Focus barcode input field (select all)
F5 Reload page
F6 Process credit (veresiye) sale
F7 Hold current order
F8 Process cash sale
F9 Process card payment sale
F11 Toggle fullscreen mode
Ctrl+↓ Move selection to next cart row
Ctrl+↑ Move selection to previous cart row
Enter Confirm barcode / confirm cell edit
Escape Cancel inline edit / close modal
↑ / ↓ Navigate within editable cell
================================================================================
7. DATA SECURITY & BACKUP
================================================================================
All data is stored locally at:
%LOCALAPPDATA%\Selgorithm_Web\
Session secrets are auto-generated on first launch and stored locally.
No data is transmitted to external servers.
RECOMMENDED BACKUP SCHEDULE:
- Daily: Export database backup via Data → Backup
- Weekly: Copy the Selgorithm_Web folder to an external drive or cloud
storage service of your choice.
RESTORE: Use Data → Restore Database to load a previous backup file.
================================================================================
8. TECHNICAL NOTES
================================================================================
- Runs on Python 3.10+ with Flask web framework
- Database: SQLite (single .db file, portable)
- Interface: WebView2 (Windows built-in) rendering a local web server
- Minimum OS: Windows 10 (64-bit)
- No internet connection required for operation
- Multi-device operation possible on a local network (contact your reseller)
================================================================================
© 2026 Selgorithm. All rights reserved.
================================================================================
User Manual
Selgorithm User Manual
Read the manual in your language. Use the buttons below to switch.