Installation Guide

Quick Start with Pre-installed Option

Embark on your project journey swiftly with our hassle-free pre-installed solution, in collaboration with Windows Hosting. For b

Key Advantages

• Time-saving: No need to search for hosting providers or choose a plan.
• Reliable performance: Our preinstalled hosting plan ensures fast and reliable operation of your project.
• Free trial: WinHost offers a 30-day free hosting trial for pre-installed project environments.
• Explore Hosting Plans and kickstart your project today.

Installation Process

AM Technology software is a versatile cross-platform solution compatible with both Windows and Linux. Explore two installation options: deploying the project on Microsoft Azure or opting for the pre-installed version for the quickest setup.

Setting Up with IIS (Package without the Source Code)

1. Copy the contents of the extracted project folder to an IIS virtual directory or site root.
2. Access the site using a browser.

Note: For versions 3.90 or below, configure it to run in integrated mode and configure the application pool to run no managed code.

Database Configuration

1. Create a new SQL Server database.
2. Establish SQL username and password.
3. Copy and paste the SQL script provided along with the project.

Modifying Connection String in appsettings.json

1. Open appsettings.json in Notepad.
2. Adjust the connection string with your SQL Server details:

• Host
• Database name
• Username
• Password

Uploading on Windows/Plesk

1. Utilize an FTP client to upload the project files to your server.

• Download an FTP client application of your choice.
• Locate FTP credentials in your hosting control panel.
• Set up the FTP connection using the obtained credentials.
• Upload project files to the server.

Database Creation

Before launching the project, create a new database instance in your hosting control panel to store your website data.

Connection String Update in appsettings.json

• Open appsettings.json in Notepad.
• Adjust the connection string with your SQL Server details:
  • Host
  • Database name
  • Username
  • Password

System Requirements

Supported Operating Systems

• Windows 10 Client (1607 or above)
• Windows 11 (22000 or above)
• Windows Server 2012 R2 or above

Supported Databases

• MS SQL Server 2019 or above

Supported Browsers

• Microsoft Edge
• Microsoft Internet Explorer 9 and above (IE6 and IE7 were supported in versions prior to 3.60, IE8 was supported in versions prior to 4.10)
• Mozilla Firefox 2.0 and above
• Google Chrome 1.x
• Apple Safari 2.x

Experience the efficiency and flexibility of your project installation with our user-friendly guide. For assistance, refer to our troubleshooting guide or reach out to our support team.

Contact Support

Backend Technologies:

• ASP.NET Core: Our software is built on the robust ASP.NET Core framework, which provides a high level of performance, security, and flexibility for web applications.
• MS SQL Database: We employ the Microsoft SQL Database, a highly reliable and scalable relational database system, to store and manage your data securely.
• Entity Framework: Entity Framework is utilized as an Object-Relational Mapping (ORM) tool to streamline database interactions, enabling efficient data access and management.
• C# Language: We have developed the software using the C# programming language, renowned for its efficiency and maintainability in building modern applications.

Frontend Technologies:

• Bootstrap: Our user interface is designed with Bootstrap, a responsive and mobile-first framework, ensuring a consistent and visually appealing experience across various devices.
• jQuery: We utilize jQuery to simplify complex client-side scripting and enhance the user experience by enabling dynamic interactions and user interface enhancements.
• Ajax: Asynchronous JavaScript and XML (Ajax) is employed to enable real-time data retrieval and seamless communication between the frontend and backend, resulting in a more responsive and dynamic application.

Our technology stack represents a well-balanced combination of cutting-edge and established technologies, carefully chosen to ensure the performance, security, and scalability of our software solution. If you have any questions or require further details regarding our technology stack, please feel free to reach out at your convenience.

Developer Guide

Introduction

The Double Entry Accounting System is designed to provide advanced financial management capabilities for modern businesses. This guide details the key features, additional accounting functionalities, and technical architecture of the system.

Key Features

1. Double Entry Accounting

• Balanced Entries: The system enforces strict double-entry accounting rules, ensuring that every journal entry has matching debits and credits.
• Configurable Validation:
  • Disable Double Entry Check: Users can opt to disable the double entry validation in the configuration settings, allowing flexibility in journal entries.
  • Enforced Double Entry: When enabled, the system rigorously verifies that total debits equal total credits for every journal entry, ensuring financial accuracy.

2. Customizable Chart of Accounts

• Pre-Defined Account Hierarchy: The system includes a three-level pre-defined account hierarchy based on standard accounting practices:
  • AccountType1 – Main Account Types: Assets, Liabilities, Equity, Income, and Expense.

    [
      { "ID": 1, "Name": "Assets", "ShortCode": "AS", "IsActive": true },
      { "ID": 2, "Name": "Liabilities", "ShortCode": "LI", "IsActive": true },
      { "ID": 3, "Name": "Equity", "ShortCode": "EQ", "IsActive": true },
      { "ID": 4, "Name": "Income", "ShortCode": "IC", "IsActive": true },
      { "ID": 5, "Name": "Expense", "ShortCode": "EX", "IsActive": true }
    ]
                    

  • AccountType2 – Secondary Classifications: Examples include Current Assets, Fixed Assets, and Non-Current Liabilities.

    [
      { "ID": 6, "ParentId": 1, "Name": "Non-Current / Fixed Assets", "ShortCode": "NC", "IsActive": true },
      { "ID": 7, "ParentId": 1, "Name": "Current Assets", "ShortCode": "CA", "IsActive": true },
      { "ID": 8, "ParentId": 2, "Name": "Non-Current Liabilities", "ShortCode": "NCL", "IsActive": true },
      { "ID": 9, "ParentId": 2, "Name": "Current Liabilities", "ShortCode": "CL", "IsActive": true },
      { "ID": 10, "ParentId": 3, "Name": "Equity", "ShortCode": "EQ", "IsActive": true },
      { "ID": 11, "ParentId": 4, "Name": "Income", "ShortCode": "IN", "IsActive": true },
      { "ID": 12, "ParentId": 5, "Name": "Trading Expense", "ShortCode": "TE", "IsActive": true },
      { "ID": 13, "ParentId": 5, "Name": "Operating / Administrative Expenses", "ShortCode": "OAE", "IsActive": true }
    ]
                    

  • AccountType3 – Detailed Sub-Accounts: Provides in-depth financial categorization for items such as “Property, plant, and equipment” and “Inventory Assets.”

    [
      { "ID": 14, "ParentId": 6, "Name": "Property, plant, and equipment", "ShortCode": "PPE", "IsActive": true, "IsPerson": false },
      { "ID": 15, "ParentId": 6, "Name": "Inventory Assets", "ShortCode": "IA", "IsActive": true, "IsPerson": false },
      // … additional sub-account definitions …
      { "ID": 114, "ParentId": 13, "Name": "Others", "ShortCode": "OTH", "IsActive": true, "IsPerson": false }
    ]
                    

• Custom Hierarchy Levels: Users can create a personalized chart of accounts, modifying existing account types and adding new levels as needed.

3. Multi-Entity Management

• Multiple Companies and Branches: A single user account can manage multiple companies, each with multiple branches, enabling centralized control with decentralized operations.
• Accounting Year Management: The system supports setting an opening balance for each accounting year and accommodates both opening and closing processes.

4. Journal Entries & Reporting

• Journal Entry Management: Create, edit, and post double-entry journal entries using an intuitive interface with configurable validation options.
• Standard Financial Reports: Generate essential financial reports, including:
  • Trial Balance – A snapshot of all ledger balances.
  • General Ledger – Detailed transaction records.
  • Income Statement – Multiple formats for profit and loss analysis.
  • Balance Sheet – Various layout options for reporting financial position.
  • Running Head of Accounting Balance – Displays ongoing balances for quick reviews.

5. Extensibility & Future Enhancements

• Planned Updates Include:
  • Receipt and Voucher System – Additional modules for handling receipts and vouchers.
  • Taxation – Enhanced support for accurate tax calculations and reporting.
  • CRM Integration – Integrated features for managing customer relationships within the system.

Additional Accounting Features

• Fixed Asset Management:
  • Track asset acquisition, depreciation, and disposals.
  • Automate depreciation calculations using methods like straight-line and declining balance.
  • Generate comprehensive asset-related reports.
• Budgeting and Forecasting:
  • Set budgets and track actual performance against targets.
  • Receive variance analysis reports to identify deviations and trends.
  • Utilize forecasting tools that leverage historical data for future predictions.
• Cost Accounting & Job Costing:
  • Allocate costs across projects, departments, or products.
  • Implement activity-based costing for detailed overhead allocation analysis.
  • Track project or job profitability with detailed cost breakdowns.
• Multi-Currency Support:
  • Enable transactions in multiple currencies with real-time exchange rate updates.
  • Automate currency conversion and provide consolidated reporting for international operations.
• Advanced Reporting & Analytics:
  • Create customizable dashboards featuring key performance indicators (KPIs) for rapid financial insights.
  • Generate flexible reports and visualizations, including charts and graphs with drill-down capabilities.
• Tax Management:
  • Automate tax calculations for various jurisdictions.
  • Support tax return preparation and filing.
  • Integrate with tax authorities or third-party tax software for real-time compliance.
• Audit Trail & Compliance:
  • Maintain a detailed audit log of all changes to financial data.
  • Ensure compliance with local accounting standards (GAAP, IFRS) and regulatory requirements.
  • Implement role-based access control to secure sensitive data.
• Integration Capabilities:
  • Provide APIs and built-in integrations with third-party systems (CRM, ERP, banking systems).
  • Support seamless data import/export and integration with payment gateways and e-commerce platforms.
• Mobile Access:
  • Offer mobile-responsive interfaces or dedicated mobile apps for on-the-go management.
  • Allow users to approve transactions, review reports, and manage journal entries via smartphones or tablets.
• Workflow Automation:
  • Automate routine tasks such as invoice processing, payment reminders, and reconciliation.
  • Create custom workflows for transaction approvals and escalations.
  • Implement notifications and alerts for critical accounting events.

Technical Overview

Platform & Technologies:

• Backend: .NET Core
• Database: MS SQL Server
• Frontend: AJAX, jQuery, and Bootstrap for a responsive design

Architecture:

• Code First Approach for rapid development
• Modular controller-based design for scalability and maintainability
• Separation of concerns with distinct layers for business logic, data access, and presentation

Code Structure: A detailed diagram is available as a placeholder for your code structure screenshot. Replace this section with the actual screenshot when available.