Repository files navigation

Linkio.Space is a web application that allows you to keep all your connections with people and their business cards.
You can easily and quickly add new connections. All your business cards are stored and updated at any time.
Explore the docs »

View Demo ·Report Bug .Request Feature

The idea of this app is to save the user's business cards. When the user signs up, the system automatically generates a 4-digit code that is unique. If a user wants to give his business card to somebody, he just has to provide this code. The platform has a search system that searches other users by using this user code. After the user's business card which is searched, is found, it can be added with just one click. The application has a user`s connections board, from where the user can see all his contacts. Every user profile can be edited and the new information for a user will be updated also for the people who have been saved his business card.

The app has a blue minimalistic design and it is easy to be used by everyone.

Onhttp://localhost:8081/, there is the start page. It has welcome information with a logo, simple navigation bar, and footer with contacts.

Onhttp://localhost:8081/home, there is the home page with buttons forSign Up andLog In. The user can also use the navigation bar to sign up and log in.

The user can also use the navigation bar to sign up and login.

http://localhost:8081/register

http://localhost:8081/login

The application has two views for the administrator and for the user. Credentials for login as administrator are:

Email: admin@linkiospace.comPassword: admin123

Admin profile page (http://localhost:8081/profile) has information about the admin. The information can only be edited from the buttonEDIT YOUR INFORMATION.

After editing the information, everything should be saved from the buttonSAVE .

The admin view hasAdmin Board (http://localhost:8081/admin/users) where all users and their information is visible.

Admin can delete users from the database.

Credentials for login as user are for exaple:

Email: todor.todorov@gmail.comPassword: 12345678// The password is the same for all test users.

The user can also edit his profile as the administrator.

Every user hasConnections (http://localhost:8081/user/connections) board where can remove business cards or see details about his connections.

To search for a new business card, the user should go toSearch (http://localhost:8081/user/search), enter a code, and press the button for search. If the business card is found, the user can easily add it to his connections from the buttonADD USER TO YOUR CONNECTIONS.

• Spring Boot
• PostgreSQL
• Vue
• Vuetify

To get a local copy up and running follow these simple steps.

To run this project you first need to install and set up:

• Java 11

  java -version

• ApacheMaven v3.6.3

  mvn -v

• PostgreSQL v12.4
• pgAdmin v4.20
• Node.js v12.18

  node -v

• NPM 6.14

  npm -v

• Vue 2

  npm install vue

• Vue CLI v4.5

  npm install -g @vue/clivue -V

1. Clone the repo:

   git clone https://github.com/desi109/linkio-space.git

2. Set up the database for the project

• For Windows

In pgAdmin openServers and thenPostgreSQL Server.Go to:

Login/Group Roles -> Create -> Login/Group Role...

Create new user:

General: Name: linkio_space_userPrivileges:  Can login?        Yes.             Superuser?        No.             Create role?      Yes.             Create database?  Yes.             Update catalog?   No.             Inherit rights from the parent roles?  Yes.             Can initate streaming replication and backups? No.

In pgAdmin openServers and thenPostgreSQL Server.

Go to:Databases -> Create -> Database...

Create new database:

General: Database: linkio_space            Owner: linkio_space_user   Definition:  Tablespace:  pg_default

Create database tables and import data. Copy the two scripts (create_tables.sql andinsert_data.sql ) fromhere.Go toServers -> PostgreSQL Server -> Databases -> linkio_space -> Query Tool....Paste scripts and click buttonExecute/Refresh or cliclF5.

• For Linux

How to set up PostgreSQL server on Linux?

Start pgAdmin and run:

cd linkiospacepsql -h localhost -p 5432 -U postgres -f create_user_and_database.sqlcd linkiospace-backend/src/main/resources/db_postgresqlpsql -U linkio_space_user -d linkio_space -f create_tables.sqlpsql -U linkio_space_user -d linkio_space -f insert_data.sql

The first script set up new role and create database:

Role: linkio_space_userPassword: 1234Database: linkio_space

The other two scripts create database tables and insert all data.

3. Start the back-end of the project:

   cd linkiospace/linkiospace-backendmvn spring-boot:run

   It is running onlocalhost:8080.

   To restart, first kill the process:

   kill -9$(lsof -t -i:8080)

   And run the previous command to start it again.

4. Start the front-end of the project:

   cd linkiospace/linkiospace-uinpm run serve

   It is running onlocalhost:8081.

   To restart, first kill the process:

   kill -9$(lsof -t -i:8081)

   And run the previous command to start it again.

5. Everything is ready. Go tolocalhost:8081. Enjoy! 😉

See theopen issues for a list of proposed features (and known issues).

Distributed under the MIT License. SeeLICENSE for more information.

Project Link:https://github.com/desi109/linkio-space