ateeq1999 / akpoho-invoicing-software

Akpoho Invoicing Software is an open-source software which provides quotation, invoicing, and receipt functionalities for small businesses.

Akpoho Invoicing Software

Akpoho Invoicing Software is an open-source software which provides quotation, invoicing, and receipt functionalities for small businesses. Akpoho means money in Annang language spoken by the Annang people of Akwa Ibom state, Nigeria.

The software is open-sourced in order the form a reference point for the development of a full-stack web application using Adonisjs and Vuejs. When fully-developed, you can use it for managing your invoices, receipts, and quotations for your business.

Technology Stack

Akpoho Invoicing Software is developed with the following technologies:

1. The frontend is developed with the Quasar Framework (a Vuejs framework),
2. The backend is developed with the Adonisjs framework (a Nodejs framework),
3. MySQL is used for data persistence on the backend,
4. Redis is used for data caching and caching of authentication tokens

Pre-requisites for Installation

1. Make sure that you have fully setup MySQL on your preferred environment. Please research how to install MySQL on your preferred environment (Windows, MacOS, or Linux).
2. Make sure that you have fully installed and setup Redis on your preferred environment. Please research how to install Redis on your preferred environment.
3. Make sure that you have installed git on your preferred environment.
4. Make sure that you have installed Nodejs on your preferred environment.
5. Make sure that you have installed yarn package manager on your preferred environment

How to Install

1. Launch your preferred terminal application. It could be the Windows Powershell, Git Bash, or Windows Command Prompt.

2. Change into your preferred directory on your environment

   cd /home/dev

3. Clone this repository

   git clone https://github.com/ndianabasi/akpoho-invoicing-software.git

4. After cloning, change into the application directory. You will see two sub-directories: backend and frontend.

   cd akpoho-invoicing-software

5. Change into the frontend folder and install all dependencies for the frontend.

   cd frontend
   yarn install

6. When completed, change into the backend directory and install all dependencies for the backend.

   cd ../backend
   yarn install

7. When the backend installation is completed, launch the backend server.

   yarn serve

8. Open a new terminal and launch the frontend server.

   cd /home/dev/akpoho-invoicing-software/frontend
   yarn serve

9. A browser window will open when the frontend is launched.

10. You won't be able to log in because there are no users. So, it is time to seed the database.

11. To prepare (seed) the database with mock data:

    1. First, let's migrate the database.

       node ace migration:run

    2. Next, Let's seed important tables on the database. Run the seeder command below:

       node ace db:seed -i

       1. On the prompt, select database\seeders\Role to create roles for authorisation.
       2. After the roles table is seeded. Run the seeder command again and select database\seeders\Permission to create permissions for authorisation.
       3. Run the seeder command again and select database\seeders\PermissionRole to associate roles with permissions.
       4. Run the seeder command again and select database\seeders\Company to create companies, users, customers, and customer addresses. Please, take note of the user credentials logged to the console.
       5. Run the seeder command again and select database\seeders\UserExtraCompany to associate each existing user with two more companies. This ensures that the user belongs to one than one company.

12. Take note of the user credentials logged to the console when you seeded database\seeders\Company. Only users with full access can log in. That is:

    {
        ...,
        login_status: true, 
        is_account_activated: true, 
        is_email_verified: true
    }

13. Copy the email and password of a user with full access from the console and log in.

14. Congratulations. You have successfully set up the Akpoho Invoicing Software.