CNPERP Local Server — Quick Start
================================

This ZIP contains a folder named CNPERP. Extract it so the app lives at:

  Windows:  C:\CNPERP\app\main.py
  Linux:    /opt/CNPERP/app/main.py   (or ~/CNPERP on a small office PC)
  macOS:    ~/CNPERP/app/main.py

The local server runs on this PC and serves your LAN. Sales, invoices, and
journal entries sync to the CNP cloud hub in near real time (seconds).

── Windows ──────────────────────────────────────────────────────────
1. Extract ZIP to C:\  →  you get C:\CNPERP\
2. PowerShell as Administrator:
     cd C:\CNPERP
     Set-ExecutionPolicy -Scope Process Bypass
     .\deploy\local-server\Install-CNPERP-Local.ps1
3. Desktop shortcut "CNPERP Server" — keep the window open
4. "CNPERP Setup Wizard" — license key, then company setup

── Linux (Ubuntu) ───────────────────────────────────────────────────
1. sudo unzip cnperp-local-install-*.zip -d /opt
2. cd /opt/CNPERP/deploy/local-server
     chmod +x *.sh
     sudo ./install-cnperp-local.sh --install-service
   Or without systemd: ./install-cnperp-local.sh
3. ./start-cnperp-server.sh   (or: sudo systemctl start cnperp-local)
4. Browser: http://localhost:8010/setup

── macOS ────────────────────────────────────────────────────────────
1. unzip cnperp-local-install-*.zip -d ~
2. cd ~/CNPERP/deploy/local-server && chmod +x *.sh
     ./install-cnperp-local.sh
3. ./start-cnperp-server.sh
4. Browser: http://localhost:8010/setup

── Cloud link (all platforms) ───────────────────────────────────────
After setup, add license_key to deploy/license-node.json, then:
  Windows: .\deploy\local-server\Connect-Cloud.ps1
  Linux/Mac: ./deploy/local-server/connect-cloud.sh

Requirements: Python 3.10+, PostgreSQL 14+, 4 GB RAM
LAN users: http://<server-ip>:8010

CNP Solutions — https://erp.cnpsolutions.co.bw
