AtampsPOS – Point of Sale Business Management

AtampsPOS is a modern Point of Sale and Business Management System for managing sales, inventory, purchases, customers, credit sales, repayments, expenses, finance, reports and everyday business operations from one powerful dashboard.

Features

Key Features

📊 Business Dashboard

Get an instant overview of your business performance from a single dashboard.

• Today's Net Sales
• Today's Collected Amount
• Today's Credit Sales
• Today's Repayments
• Items Sold Today
• Weekly Sales
• Today's Expenses
• Outstanding Customer Credit
• Sales growth indicator
• Today's Sales Velocity chart
• Recent Transactions
• Top Selling Products
• Quick access to New Sale
• Quick access to Purchase
• Quick access to Expense

The dashboard is designed to help business owners understand what is happening in their business without having to navigate through multiple pages.

🛒 Point of Sale / Sales Management

Manage your daily sales transactions quickly and efficiently.

• Create new sales
• Process cash sales
• Process customer credit sales
• Generate invoice numbers
• Record sold products
• Track transaction amounts
• Track payment status
• View recent sales
• View transaction details
• Customer-based sales tracking
• Sales history
• Sales and repayment tracking

💳 Credit Sales & Customer Repayments

AtampsPOS includes customer credit management for businesses that allow customers to buy now and pay later.

• Record credit sales
• Track customer balances
• Record repayments
• View repayment transactions
• Track outstanding credit
• Monitor total credit sales
• Monitor repayments received
• Link credit transactions to customers

This makes it easier to know which customers owe money and how much has been paid back.

📦 Product & Inventory Management

Manage the products your business sells from a centralized inventory section.

• Add products
• Edit products
• Manage product information
• Organize products
• Track products used in sales
• Monitor quantities
• Product-based sales reporting
• Identify top-selling products

The inventory module provides the foundation for managing products throughout the sales process.

🧾 Purchase Management

Keep track of products purchased for your business.

• Record purchases
• Add purchased products
• Track purchase transactions
• Maintain purchase records
• Monitor purchasing activity
• Connect purchases with inventory management

👥 Customer Management

Maintain organized customer records and monitor customer transactions.

• Customer list
• Add customers
• Edit customer information
• View customer records
• Track customer sales
• Track customer credit
• Track customer repayments
• Monitor outstanding balances
• Walk-in customer support

AtampsPOS can support both regular registered customers and walk-in customers.

💰 Expense Management

Keep business expenses organized and separate from sales transactions.

• Record expenses
• Track expense amounts
• View expense records
• Monitor today's expenses
• Compare expenses against sales
• Expense reporting

🏦 Finance Management

The finance section provides tools for managing important business money movements.

• Accounts
• Income / Deposits
• Transfers
• Expenses
• Financial transaction tracking
• Business cash-flow visibility

📈 Reports

Use business reports to understand sales and financial performance.

• Sales reports
• Purchase reports
• Expense reports
• Customer-related reports
• Product sales information
• Transaction reports
• Financial summaries
• Business performance analysis

Reports help business owners make better decisions using actual transaction data.

🔄 Transfers

Manage transfers between business accounts or financial points.

• Record transfers
• Track transfer amounts
• Maintain transfer history
• Monitor business fund movements

👤 User Management

Manage the users who have access to the system.

• Create users
• Manage user accounts
• Edit user information
• Control system access
• User profile management

This is useful for businesses where multiple employees or sales representatives need access to the POS.

🔔 Notifications

The system includes a notification area for displaying important system and business notifications.

• Notification management
• View notifications
• Notification status
• Centralized notification access

💾 Backup

Protect important business information using the backup functionality.

• Backup management
• Access backup section from the administration menu
• Support routine data protection procedures

⚙️ System Settings

Manage important system configuration from a dedicated settings section.

• Business configuration
• System settings
• Operational preferences
• Administrative settings

Requirements

1. System Requirements

Before installing AtampsPOS, make sure your server meets the following requirements:

• PHP 8.1 or higher
• MySQL 5.7 or higher
• Apache or another compatible web server
• PHP PDO extension
• PHP JSON extension
• PHP Mbstring extension
• PHP OpenSSL extension
• PHP Fileinfo extension
• PHP cURL extension
• PHP ZIP extension
• PHP GD extension
• Writable application directories
• MySQL database

Recommended Environment

• PHP 8.2+
• MySQL 8.x
• Apache
• Linux hosting
• cPanel or equivalent hosting control panel

Instructions

2. Download and Extract AtampsPOS

After purchasing AtampsPOS:

1. Download the main package.
2. Extract the ZIP file on your computer.
3. Locate the application files.
4. Upload the complete AtampsPOS application to your web server.

For a live website, the application can normally be uploaded to:

public_html/

For a subdirectory installation:

public_html/atampspos/

3. Create a MySQL Database

Create a new MySQL database using your hosting control panel or phpMyAdmin. For example:

Database Name: atampspos
Database User: atampspos_user
Database Password: YOUR_DATABASE_PASSWORD

On cPanel hosting, your actual database name may automatically receive your cPanel username prefix, for example username_atampspos.

Make sure the database user has full privileges on the newly created database.

4. Import the Database

The database structure and initial data are included with the application package. The SQL file is located at:

db/database.sql

Using phpMyAdmin

1. Log in to cPanel.
2. Open phpMyAdmin.
3. Select the database you created for AtampsPOS.
4. Click Import.
5. Select:

db/database.sql

1. Click Import or Go.
2. Wait for the import to complete.

After a successful import, the AtampsPOS database tables will be available in the selected database.

Do not import database.sql into an existing production database unless you are sure that you want to create or replace the included AtampsPOS database structure.

5. Configure the Database Connection

Open the following file from your AtampsPOS installation:

config/database.php

Inside this file, locate the database configuration section:

// ============================================================
// DATABASE
// ============================================================
define('DB_HOST', 'localhost');
define('DB_USER', 'root');
define('DB_PASS', '');
define('DB_NAME', 'atampspos');

Update the values to match the MySQL database you created.

Localhost Example

For a local XAMPP/WAMP installation:

// ============================================================
// DATABASE
// ============================================================
define('DB_HOST', 'localhost');
define('DB_USER', 'root');
define('DB_PASS', '');
define('DB_NAME', 'atampspos');

Live Hosting Example

For cPanel or other hosting:

// ============================================================
// DATABASE
// ============================================================
define('DB_HOST', 'localhost');
define('DB_USER', 'YOUR_DATABASE_USER');
define('DB_PASS', 'YOUR_DATABASE_PASSWORD');
define('DB_NAME', 'YOUR_DATABASE_NAME');

Replace:

• YOUR_DATABASE_USER with your MySQL database username.
• YOUR_DATABASE_PASSWORD with your MySQL database password.
• YOUR_DATABASE_NAME with your actual database name.

For example:

define('DB_HOST', 'localhost');
define('DB_USER', 'username_atampspos');
define('DB_PASS', 'YourStrongPassword');
define('DB_NAME', 'username_atampspos');

Important: Do not use the example username or password above. Replace them with the credentials created on your own server.

6. Verify the Database Configuration

Before opening the application, verify that:

• ###li/li######li/li######li/li######li/li######li/li######li/li###
• config/database.php contains the correct credentials.
• db/database.sql was successfully imported.

A common cause of database connection errors is an incorrect database name, username, or password.

7. Upload the Application

Upload the complete AtampsPOS application to your hosting account. The final structure should retain the important application directories, including:

atampspos/
├── config/
│   └── database.php
├── db/
│   └── database.sql
├── ...

Do not move or rename the config or db directories unless you also update the application accordingly.

8. Configure File Permissions

Make sure the web server can read the application files. Directories that require write access should also have appropriate permissions for your hosting environment. Avoid setting all files and directories to 777 unless your hosting provider specifically requires it. Use the permissions recommended by your hosting provider.

9. Open AtampsPOS

After completing the database configuration and upload, open the application URL in your browser. For example:

https://yourdomain.com/

Or, if installed in a subdirectory:

https://yourdomain.com/atampspos/

For a local installation:

http://localhost/atampspos/