https://github.com/roshhellwett/projectpaynix
ʟɪɢʜᴛᴡᴇɪɢʜᴛ ᴄ++ ʙɪʟʟɪɴɢ ꜱᴏꜰᴛᴡᴀʀᴇ
https://github.com/roshhellwett/projectpaynix
projectpaynix zenithopensourceprojects
Last synced: 15 days ago
JSON representation
ʟɪɢʜᴛᴡᴇɪɢʜᴛ ᴄ++ ʙɪʟʟɪɴɢ ꜱᴏꜰᴛᴡᴀʀᴇ
- Host: GitHub
- URL: https://github.com/roshhellwett/projectpaynix
- Owner: roshhellwett
- License: mit
- Created: 2026-01-17T16:25:42.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2026-04-20T17:13:35.000Z (2 months ago)
- Last Synced: 2026-05-30T10:23:34.733Z (27 days ago)
- Topics: projectpaynix, zenithopensourceprojects
- Language: C++
- Homepage: https://zenithopensourceprojects.vercel.app
- Size: 1.77 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
- Security: security.md
Awesome Lists containing this project
README
# PROJECT PAYNIX
PayNix is a highly robust, terminal-based Point of Sale (POS) and inventory management application. Engineered with a "security-first" mindset, PayNix features encrypted data storage, strict buffer-overflow protections, atomic financial transactions, and role-based access control.
---
## ✨ Key Features
### 🔐 Security & Data Integrity
* **Role-Based Access Control (RBAC):** Distinct administrative and employee interfaces.
* **Brute-Force Lockout Gates:** Progressive time delays on failed login attempts.
* **Safe Memory Management:** Custom `SafeString` implementation prevents buffer overflows and mitigates scanner-paste injection attacks.
* **Binary File Protection:** All database files feature Magic Number validation (`PNIX`), strict schema versioning, and cryptographic checksums to prevent data tampering.
* **Schema Desync Gate:** Graceful schema migration and automatic legacy data archiving.
* **Graceful OS Intercepts:** Traps `SIGINT` and `SIGTERM` to safely flush buffers and lock vaults during unexpected shutdowns.
### 💰 Financial & Billing Engine
* **Integer Cent Math:** Eliminates floating-point inaccuracies for absolute financial safety.
* **Atomic Transactions:** "Reality Gate" validates inventory stock *before* processing to prevent race conditions or negative stock.
* **Live "Blind Biller" Terminal:** Real-time cart editing, stock viewing, and interactive quantity management.
* **JSON Export:** Automatically exports all finalized transactions to a secure JSON format.
* **Z-Reports:** Automated end-of-day gross revenue and audit report generation.
### 📦 Inventory Management
* Full CRUD operations for items (Add, Update, Soft-Delete).
* Stock validation and automated deductions.
## 🛠️ Prerequisites
To build and run PayNix, you will need:
* **CMake:** Version 3.20 or higher.
* **C++ Compiler:** C++20 compatible compiler (GCC, Clang, or MSVC).
* **Threads:** OS-level threading support (pthreads/Windows threads).
## 🚀 Build Instructions
PayNix uses CMake for cross-platform compilation. Follow these steps to build from source:
1. **Clone the repository:**
```bash
git clone [https://github.com/yourusername/projectpaynix.git](https://github.com/yourusername/projectpaynix.git)
cd projectpaynix
```
---
## 📂 Project Structure
```
projectpaynix/
├── CMakeLists.txt # Build configuration
├── security.md # Vulnerability reporting & supported versions
├── include/ # Header files
│ ├── Core.hpp # System constants, types, and logging
│ ├── Data.hpp # Secure binary repository patterns
│ ├── Logic.hpp # Business logic (Auth, Inventory, Billing)
│ ├── Models.hpp # Data structures and SafeStrings
│ ├── Security.hpp # Cryptography, hashing, and sanitization
│ └── UI.hpp # Terminal rendering and inputs
└── src/ # Implementation files
├── Logic.cpp
├── UI.cpp
└── main.cpp # Application entry point & OS traps
```
---
© 2026 [Zenith Open Source Projects](https://zenithopensourceprojects.vercel.app/). All Rights Reserved. Zenith is a Open Source Project Idea's by @roshhellwett