Imported from acmadu/givorpartners (AGENTS.md). Install upstream with npx skills add acmadu/givorpartners. Copyright stays with the author.

Agent Instructions

MongoDB-backed PyQt5 POS system with two desktop apps: center/ (dealer/product/stock management) and pos/ (checkout screen). Both import shared code from common/ and talk to each other only through MongoDB — there is no direct RPC between the two apps. See README.md for install, config.json format, and DB schema.

Architecture

• Entry points: start_center.py, start_pos.py. Each calls common/mongo_startup.py (tries to auto-start MongoDB via Podman/systemd) then connects via common/database.py.
• Both apps use a QStackedWidget page-navigation pattern: see center/main_window.py / pos/main_window.py for how pages are registered and switched (pages.setCurrentWidget(page)).
• common/database.py auto-migrates legacy Turkish field/collection names (e.g. barkod→barcode, bayi_kodu→dealer_code) to English on first connection — don't reintroduce Turkish field names in new schema code.
• common/settings.py manages config.json (git-ignored; config.json.example is the template copied on first run). The default mongo_uri in settings.py points to the production GivorPartners MongoDB Atlas cluster — be careful not to run destructive DB scripts against it; point config.json at a local/test Mongo instance instead.
• common/remote_config.py lets center push per-dealer settings (theme, font_scale, auto-update flag) into a remote_configs collection.
• common/style.py holds the single "Night Mint" dark theme (build_qss() / set_theme()); apply new UI through this, not ad-hoc stylesheets.
• Auto-update lives in common/updater.py (checks version.json from the URL in version.py, verifies SHA-256 before running the installer). common/auto_updater.py is a legacy compatibility shim — don't add new logic there.

Conventions

• UI text and error messages are Turkish; code identifiers (variables, DB fields) are English. Files use # -*- coding: utf-8 -*- and JSON I/O uses ensure_ascii=False.

Build and Test

• Tests use unittest, not pytest: python -m unittest tests.test_product_pricing.
• Packaging is PyInstaller (yazarkasa-kasa.spec, yazarkasa-merkez.spec) + Inno Setup for Windows installers. Build via build_center.bat/.sh, build_pos.bat/.sh, build_all.bat/.sh, build_setup.bat; Linux packaging via installer/build_appimage.sh / installer/build_deb.sh. Full details in BUILD_EXE.md.
• Deployment/versioning workflow: DAGITIM_REHBERI.md, BAYILERE_DEPLOYMENT_REHBERI.md, DEPLOYMENT_OZET.md. System/architecture background: SISTEM.md, TEKNIK_ANALIZ.md.