Skip to content

DenisVargaeu/OBJSIS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

30 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿฝ๏ธ OBJSIS V2 โ€” FINAL FULL RELEASE ๐ŸŽ‰

Version PHP MySQL CSS JavaScript License

GitHub Stars GitHub Forks Last Commit Open Issues

A Modern, Full-Featured Restaurant Management & POS System โ€” FINAL FULL VERSION ๐ŸŽ‰

Quick Start โ€ข Features โ€ข Installation โ€ข Documentation โ€ข License


๐Ÿ“Œ Overview

OBJSIS V2 is a professional-grade restaurant management system built with PHP, CSS, and JavaScript. Designed for independent restaurants, cafes, and small restaurant chains, it provides comprehensive order management, real-time kitchen displays, inventory tracking, employee management, and a powerful modular addon ecosystem.

Perfect for: Restaurants seeking an affordable, self-hosted alternative to expensive POS systems.


โœจ Features

๐ŸŽฏ Core Features

Feature Description
๐Ÿ”Œ Modular Addon System Extend functionality with one-click installable plugins without modifying core code
๐Ÿ“Š Real-time Dashboard Live business metrics with Chart.js analytics and flicker-free updates
๐Ÿ‘จโ€๐Ÿณ Elite KDS (Kitchen Display) High-visibility kitchen mode with urgency alerts and audio notifications
๐Ÿ”‘ API Manager PRO Enterprise REST API with multi-key management and IP whitelisting
๐Ÿ’ป Terminal Pro Ultra Full-screen interactive CLI with system monitoring and diagnostics
๐ŸŒ“ Glassmorphic UI Premium, modern design across 15+ admin pages with responsive layouts
๐Ÿช™ Multi-Currency Real-time price conversion (EUR, USD, GBP, HUF) for international guests
๐Ÿ”” Smart Notifications Real-time alerts for orders, low stock, and critical system events
โšก Quick Actions Floating speed-dial for frequent administrative tasks
๐Ÿ“ฑ Table Management Digital table assignments with seating arrangements
๐Ÿ“ฆ Inventory Control Stock tracking, recipe management, and automatic deduction
๐Ÿ‘ฅ Employee Management Role-based access, shift tracking, and performance monitoring
๐Ÿ“ˆ Advanced Reports Sales analytics, employee performance, and business insights
๐Ÿ›ก๏ธ Role Permission Editor Per-role page-access control โ€” admins can fine-tune which menu pages each role may use

๐Ÿ› ๏ธ Tech Stack

PHP Badge MySQL Badge CSS Badge JavaScript Badge Chart.js Badge Apache Badge


๐Ÿ“‹ System Requirements

Requirement Specification
PHP Version 7.4 or higher (8.0+ recommended)
MySQL 5.7+ or MariaDB 10.3+
Web Server Apache 2.4+ (with mod_rewrite) or Nginx
Server Stack XAMPP, WAMP, Docker, or dedicated hosting
Browser Support Chrome, Firefox, Safari, Edge (modern versions)
Disk Space ~500MB (with data)
RAM 512MB minimum, 1GB recommended

โœ… Quick Start

๐ŸŽฎ Try Demo First

No installation needed โ€” test the full version live at: https://objsis.denisvarga.eu

Default demo credentials: PIN 1234

Self-Hosted Installation (5 Minutes)

Step 1: Deploy Files

# Extract to your web root
C:\xampp\htdocs\objsis-v2\
# or
/var/www/html/objsis-v2/

Step 2: Configure Database

Edit config/db.php:

<?php
define('DB_HOST', 'localhost');
define('DB_NAME', 'objsis_v2');
define('DB_USER', 'main_app');
define('DB_PASS', 'YourSecurePassword123!');
define('DB_CHARSET', 'utf8mb4');
?>

Step 3: Create Database

Run in phpMyAdmin or MySQL Console:

CREATE DATABASE objsis_v2 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'main_app'@'localhost' IDENTIFIED BY 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON objsis_v2.* TO 'main_app'@'localhost';

FLUSH PRIVILEGES;

Step 4: Run Installer

Navigate to: http://localhost/objsis-v2/install.php

Follow the setup wizard to:

  • โœ… Initialize database schema
  • โœ… Create admin account
  • โœ… Configure restaurant details

Step 5: Enable Addons

Go to: Admin Panel โ†’ Settings โ†’ Addons

Step 6: Secure Installation

# Delete installer
rm install.php

# Set proper permissions
chmod 755 objsis-v2/
chmod 644 config/db.php

Done! Your system is ready at http://localhost/objsis-v2/


๐Ÿ“ Project Architecture

OBJSIS V2/
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ admin/ # Admin Dashboard
โ”‚   โ”œโ”€โ”€ dashboard.php    # Main analytics hub
โ”‚   โ”œโ”€โ”€ addons.php       # Addon management
โ”‚   โ”œโ”€โ”€ settings.php     # System configuration
โ”‚   โ”œโ”€โ”€ menu.php         # Menu & item management
โ”‚   โ”œโ”€โ”€ orders.php       # Order management
โ”‚   โ”œโ”€โ”€ new_order.php    # Create new order
โ”‚ โ”œโ”€โ”€ tables.php # Section layout + table management
โ”‚ โ”œโ”€โ”€ receipt_editor.php # Receipt template settings
โ”‚   โ”œโ”€โ”€ inventory.php    # Inventory & Stock
โ”‚   โ”œโ”€โ”€ recipes.php      # Recipe management
โ”‚   โ”œโ”€โ”€ users.php        # Staff management
โ”‚   โ”œโ”€โ”€ employees.php    # Employee management
โ”‚   โ”œโ”€โ”€ shifts.php       # Shift management
โ”‚   โ”œโ”€โ”€ kitchen.php      # Kitchen Display (KDS)
โ”‚   โ”œโ”€โ”€ reports.php      # Analytics & reports
โ”‚   โ”œโ”€โ”€ coupons.php      # Coupon management
โ”‚   โ”œโ”€โ”€ categories.php   # Menu categories
โ”‚   โ”œโ”€โ”€ history.php      # Order history
โ”‚   โ”œโ”€โ”€ import_menu.php  # Menu import
โ”‚   โ”œโ”€โ”€ profile.php      # User profile
โ”‚   โ”œโ”€โ”€ receipt.php      # Receipt generation
โ”‚   โ”œโ”€โ”€ print_coupon.php # Print coupons
โ”‚   โ”œโ”€โ”€ stats.php        # Statistics
โ”‚   โ””โ”€โ”€ updates.php      # Software updates
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ addons/ # Plugin System
โ”‚   โ”œโ”€โ”€ activity_log_pro/
โ”‚   โ”œโ”€โ”€ analytics_pro/
โ”‚   โ”œโ”€โ”€ api_manager/
โ”‚   โ”œโ”€โ”€ global_search/
โ”‚   โ”œโ”€โ”€ kds_pro/
โ”‚   โ”œโ”€โ”€ maintenance_mode/
โ”‚   โ”œโ”€โ”€ multi_currency/
โ”‚   โ”œโ”€โ”€ quick_actions/
โ”‚   โ”œโ”€โ”€ staff_notes/
โ”‚   โ”œโ”€โ”€ system_health/
โ”‚   โ”œโ”€โ”€ system_info/
โ”‚   โ”œโ”€โ”€ system_notifications/
โ”‚   โ”œโ”€โ”€ terminal_pro/
โ”‚   โ””โ”€โ”€ voice_control/
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ api/ # API Endpoints
โ”‚   โ”œโ”€โ”€ addons.php
โ”‚   โ”œโ”€โ”€ addons_api.php
โ”‚   โ”œโ”€โ”€ admin_actions.php
โ”‚   โ”œโ”€โ”€ check_coupon.php
โ”‚   โ”œโ”€โ”€ create_order.php
โ”‚   โ”œโ”€โ”€ dashboard_fetch.php
โ”‚   โ”œโ”€โ”€ get_active_orders_fragment.php
โ”‚   โ”œโ”€โ”€ get_api_key.php
โ”‚   โ”œโ”€โ”€ import_actions.php
โ”‚   โ”œโ”€โ”€ inventory_logs.php
โ”‚   โ”œโ”€โ”€ kitchen_fetch.php
โ”‚   โ”œโ”€โ”€ migrate_inventory.php
โ”‚   โ”œโ”€โ”€ mock_update_server.php
โ”‚   โ”œโ”€โ”€ order_status.php
โ”‚   โ”œโ”€โ”€ order_status_update.php
โ”‚   โ”œโ”€โ”€ recipe_actions.php
โ”‚   โ”œโ”€โ”€ shift_actions.php
โ”‚   โ”œโ”€โ”€ software_update.php
โ”‚   โ””โ”€โ”€ verify_coupon.php
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ assets/ # Static Resources
โ”‚   โ”œโ”€โ”€ css/
โ”‚   โ”‚   โ”œโ”€โ”€ style.css           # Core styles
โ”‚   โ”‚   โ”œโ”€โ”€ kiosk_improvements.css
โ”‚   โ”‚   โ”œโ”€โ”€ page_coupons.css
โ”‚   โ”‚   โ”œโ”€โ”€ page_menu.css
โ”‚   โ”‚   โ”œโ”€โ”€ page_shifts.css
โ”‚   โ”‚   โ”œโ”€โ”€ page_stats.css
โ”‚   โ”‚   โ”œโ”€โ”€ page_tables.css
โ”‚   โ”‚   โ””โ”€โ”€ page_users.css
โ”‚   โ””โ”€โ”€ js/
โ”‚       โ”œโ”€โ”€ app.js    # Main application logic
โ”‚       โ””โ”€โ”€ theme.js  # Theme management
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ includes/ # Core Functions
โ”‚   โ”œโ”€โ”€ functions.php      # Helper functions
โ”‚   โ”œโ”€โ”€ addon_loader.php   # Addon system loader
โ”‚   โ”œโ”€โ”€ addon_helper.php   # Addon helper utilities
โ”‚   โ”œโ”€โ”€ sidebar.php        # Sidebar rendering
โ”‚   โ””โ”€โ”€ updater_helper.php # Update system helper
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ config/ # System Configuration
โ”‚   โ””โ”€โ”€ version.php        # Version & build info
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ sql/ # Database Files
โ”‚   โ””โ”€โ”€ schema.sql         # Full database schema
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ docs/ # Documentation
โ”‚   โ”œโ”€โ”€ RELEASE_NOTES.md
โ”‚   โ””โ”€โ”€ development_plan.txt
โ”‚
โ”œโ”€โ”€ login.php              # Login page
โ”œโ”€โ”€ logout.php             # Logout handler
โ”œโ”€โ”€ install.php            # Setup wizard (delete after setup)
โ””โ”€โ”€ index.php              # Application entry point

๐Ÿ‘ฅ User Roles & Permissions

Role-Based Access Control (RBAC)

Role Permissions Use Case
๐Ÿ‘‘ Admin Full system access, addon management, API configuration, user creation, backup/restore Restaurant owner, IT manager
๐Ÿ‘จโ€๐Ÿณ Cook KDS view, order urgency alerts, recipe details, inventory visibility Kitchen staff
๐Ÿšถ Waiter Place/modify orders, table management, order status tracking, guest requests Wait staff, servers
๐Ÿ“Š Manager Inventory management, supplier details, detailed reports, sales analytics Operations manager
๐Ÿ‘๏ธ Supervisor View-only access to all dashboards and reports Quality assurance

๐Ÿ” Security Features

Built-in Security Mechanisms

Feature Description
๐Ÿ”‘ API Key Authentication Multiple API keys with per-key permissions
๐ŸŒ IP Whitelisting Restrict API access to trusted IP addresses
๐Ÿ”’ Session Security Secure session management with timeout protection
๐Ÿ“ Activity Logging Complete audit trail of all system actions
๐Ÿšจ Failed Login Alerts Automatic alerts after suspicious activity
๐Ÿ” Password Hashing bcrypt password encryption (salted & hashed)
๐Ÿ›ก๏ธ SQL Injection Protection Prepared statements & input validation
๐Ÿšซ CSRF Protection Token-based CSRF prevention

Security Checklist

  • Change default admin PIN immediately
  • Create strong database user password
  • Enable API IP whitelisting
  • Delete install.php after setup
  • Set proper file permissions (644/755)
  • Enable HTTPS in production
  • Regular backup strategy in place
  • Monitor activity logs weekly

๐Ÿ“Š Database Schema

Core Tables

-- Users & Authentication
users (id, username, email, password_hash, role, created_at)

-- Orders
orders (id, table_id, status, total_amount, created_at, updated_at)
order_items (id, order_id, menu_item_id, quantity, price, notes)

-- Menu Management
menu_items (id, name, price, category_id, description, available)
menu_categories (id, name, display_order)

-- Inventory
inventory (id, item_name, quantity, unit, min_level, supplier_id)
recipes (id, menu_item_id, ingredient_id, quantity_needed)

-- Restaurant Operations
tables (id, table_number, capacity, status, section)
employees (id, user_id, position, hire_date, active)

-- API & Integration
api_keys (id, key_hash, created_by, rate_limit, ip_whitelist, last_used)
addons (id, name, version, enabled, config_json)

-- Monitoring
activity_logs (id, user_id, action, details, timestamp)

๐Ÿ”Œ API Integration

Getting Started with API

Generate API Key

  1. Log in as Admin
  2. Go to: Settings โ†’ API Manager
  3. Click: Generate New Key
  4. Copy key and IP whitelist if needed

Make API Request

curl -X GET "http://localhost/objsis-v2/api/v2/orders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Available Endpoints

Endpoint Method Purpose
/api/v2/orders GET List all orders
/api/v2/orders POST Create new order
/api/v2/orders/{id} PUT Update order
/api/v2/inventory GET Get inventory levels
/api/v2/inventory/{id} PUT Update stock
/api/v2/analytics/sales GET Sales metrics
/api/v2/tables GET Table status

๐ŸŽจ Themes & Customization

Glassmorphic Design System

OBJSIS V2 features a modern Glassmorphic UI with:

  • โœจ Frosted glass effects
  • ๐ŸŽฏ Smooth animations
  • ๐Ÿ“ฑ Fully responsive design
  • ๐ŸŒ“ Light/Dark mode support
  • โ™ฟ Accessibility optimized

Custom Themes

Customize colors in assets/css/theme-v2.css:

:root {
  --primary-color: #FF6B35;
  --secondary-color: #004E89;
  --accent-color: #1A7F64;
  --background: #F5F5F5;
  --text-dark: #212121;
}

๐Ÿงฉ Addon System

Available Addons

Addon Description
๐Ÿ”ฅ Activity Log PRO Comprehensive event logging & audit trail
๐Ÿ“Š Analytics PRO Advanced business analytics & reporting
๐Ÿ”‘ API Manager REST API key management with IP whitelisting
๐Ÿ” Global Search Unified search across orders, menu, staff
๐Ÿ‘จโ€๐Ÿณ KDS PRO Kitchen Display System with audio alerts
๐Ÿ’ฑ Multi Currency Real-time price conversion (EUR, USD, GBP, HUF)
โšก Quick Actions Floating speed-dial for frequent admin tasks
๐Ÿ“ Staff Notes Internal notes & memo system for employees
๐Ÿฉบ System Health Server & system diagnostics monitoring
โ„น๏ธ System Info Environment & configuration overview
๐Ÿ”” System Notifications Real-time in-app alerts & notifications
๐Ÿ’ป Terminal PRO Full-screen system terminal & diagnostics
๐ŸŽค Voice Control Voice-command support for hands-free operation
๐Ÿ”ง Maintenance Mode Block non-admin users, schedule downtime, content updates

๐Ÿ“ˆ Roadmap

๐ŸŽ‰ Version 4.0.0 โ€” FINAL FULL RELEASE (no beta!)

  • Restaurant Section / Room layout editor
  • Visual section columns โ€” drag tables between rooms
  • Per-section add table, rename, delete
  • Tables now have sort_order for layout positioning
  • Receipt editor with live preview
  • Occupation status dropdown (free/occupied/reserved) on every card
  • Kitchen KDS bugfix โ€” Run Kitchen button works
  • Role Permission Editor โ€” per-role page-access control
  • Training mode implementation
  • Multi-language support (SK, EN, DE, CZ)
  • Mobile staff application
  • QR code menu system
  • Payment gateway integration

Planned Features

  • ๐Ÿ”ฎ Advanced BI dashboards
  • ๐Ÿ”ฎ Loyalty program system
  • ๐Ÿ”ฎ Table pre-ordering
  • ๐Ÿ”ฎ SMS/WhatsApp notifications
  • ๐Ÿ”ฎ Delivery management
  • ๐Ÿ”ฎ Recipe cost calculation

๐Ÿ› Troubleshooting

Common Issues & Solutions

1. "Access Denied" on Installation

# Fix file permissions
chmod -R 755 objsis-v2/
chmod 644 config/db.php

2. Database Connection Failed

  • Verify MySQL is running
  • Check credentials in config/db.php
  • Ensure database user has proper permissions:
GRANT ALL PRIVILEGES ON objsis_v2.* TO 'main_app'@'localhost';

3. Addons Not Appearing

  • Check addons/ folder exists and is writable
  • Verify addon structure matches template
  • Check PHP error logs: tail -f /var/log/php-errors.log

4. API Returning 401 Unauthorized

  • Verify API key is active in Admin Panel
  • Check IP whitelist settings
  • Ensure key is included in request header:
-H "Authorization: Bearer YOUR_API_KEY"

5. KDS Audio Not Working

  • Check browser audio permissions
  • Verify speaker volume
  • Test in browser console: new Audio('assets/sounds/alert.mp3').play()

๐Ÿ“ž Support & Contact

Getting Help

Channel Details
๐Ÿ› Bug Reports GitHub Issues
๐Ÿ’ฌ Discussions GitHub Discussions
๐Ÿ“– Wiki Documentation Wiki
๐Ÿ“ง Email Contact developer for support inquiries

๐Ÿ“„ License

License: All Rights Reserved

Copyright ยฉ 2026 Denis Varga

This source code is proprietary and confidential. It may NOT be:

  • โŒ Copied or reproduced
  • โŒ Modified or altered
  • โŒ Distributed or shared
  • โŒ Used commercially without permission
  • โŒ Sublicensed or resold

Unauthorized use is strictly prohibited and may result in legal action.

For licensing inquiries, please contact the author directly.


๐ŸŒŸ Contributing

While this is a proprietary project, we welcome bug reports and feature suggestions!


๐Ÿ“ Release Notes

๐ŸŽ‰ v4.0.0 FINAL FULL RELEASE โ€” 2026-06-28

This is the complete, production-ready release. No beta. No placeholders. Everything works out of the box.

๐Ÿ  Restaurant Section / Room Layout

  • New sections table โ€” create and manage unlimited restaurant rooms (Main Hall, Terrace, Bar, Private Roomโ€ฆ)
  • Tables now store section_id + sort_order for true visual layout positioning
  • admin/tables.php rebuilt as Section Layout Manager:
    • Each section shown as its own card/column with icon and live table-count badge
    • Add, rename, reorder, or delete sections from the page directly
    • Add table straight into the chosen section from its column
    • Full edit modal โ€” change name, capacity, section, and sort order
    • Occupation dropdown on every card: ๐ŸŸข Free / ๐Ÿ”ด Occupied / ๐ŸŸก Reserved
    • Tables with active orders show a lock icon
    • Unassigned tables shown in a dashed-border "Unassigned" column
  • 6 new API actions: add_section, edit_section, delete_section, update_table_section
  • add_table, edit_table accept section_id and sort_order

๐Ÿ“‹ Receipt Settings Editor

  • New admin/receipt_editor.php
  • Live preview sidebar updates as you type
  • Editable: restaurant name, address, phone, VAT ID, company reg. ID
  • Editable: header text, footer message, currency, tax rate, tax label
  • Toggles: restaurant name badge, QR placeholder
  • Save and Reset to defaults
  • Permission: manage_menu

๐Ÿ‘ฎ Role Permission Editor

  • Full CRUD page for roles (admin/roles.php)
  • Per-role page-access control through grouped checkboxes + granular tags
  • Protected admin role, safe delete with user-disassociation warning
  • 4 new API actions with CSRF validation and proper error handling

๐Ÿ‘จโ€๐Ÿณ Kitchen KDS Fix

  • "Run Kitchen" and "Done / Ready" buttons now work correctly
  • CSRF token and PHP variable fixes in admin/kitchen.php

  • Role Permission Editor โ€” per-role page-access control
  • KDS bugfix: "Run Kitchen" button now works
  • CSRF token fix on kitchen status updates

v2.6.0

  • Modular addon system
  • API Manager PRO
  • Terminal Pro Ultra
  • Real-time dashboard
  • KDS with audio alerts
  • Glassmorphic UI
  • Multi-currency support

๐ŸŽ‰ Acknowledgments

  • Chart.js - Beautiful data visualization
  • PHP Community - Amazing framework and tools
  • Bootstrap Icons - Quality icon set
  • All Contributors - Bug reports and feature suggestions

โค๏ธ Developed with passion for restaurant efficiency

โฌ† Back to Top

GitHub Repo Stars Follow on GitHub

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages