Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kapil7982/sunbase
This application allows users to manage customers, including adding, editing, deleting, and searching for customer records. The application includes a login system and utilizes JWT tokens for authentication.
https://github.com/kapil7982/sunbase
css hibernate-jpa html java-8 javascript maven mysql-database spring-boot swagger-ui
Last synced: 19 days ago
JSON representation
This application allows users to manage customers, including adding, editing, deleting, and searching for customer records. The application includes a login system and utilizes JWT tokens for authentication.
- Host: GitHub
- URL: https://github.com/kapil7982/sunbase
- Owner: Kapil7982
- Created: 2024-07-26T11:01:14.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-08-04T10:59:49.000Z (6 months ago)
- Last Synced: 2024-11-19T10:57:09.084Z (3 months ago)
- Topics: css, hibernate-jpa, html, java-8, javascript, maven, mysql-database, spring-boot, swagger-ui
- Language: Java
- Homepage:
- Size: 91.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Customer Management Application
This application allows users to manage customers, including adding, editing, deleting, and searching for customer records. The application includes a login system and utilizes JWT tokens for authentication.
## Table of Contents
- [Features](#features)
- [Technologies Used](#technologies-used)
- [Installation](#installation)
- [Usage](#usage)
- [API Endpoints](#api-endpoints)
- [Frontend Functionality](#frontend-functionality)
- [Images](#images)
## Features
- User authentication with JWT tokens
- Add, edit, delete customer records
- Search customer records
- Sync customer records with backend
- Responsive design
## Technologies Used
- **Frontend**: HTML, CSS, JavaScript
- **Backend**: Spring Boot, Java
- **Database**: MySQL
- **Authentication**: JWT (JSON Web Tokens)
## Installation
### Prerequisites
- Java 8 or above
- Maven
- Spring
### Backend Setup
1. Clone the repository:
```sh
git clone https://github.com/Kapil7982/sunbase.git
```
2. Navigate to the backend directory:
```sh
cd SpringSecurityWithJwt
```
3. Build the project with Maven:
```sh
mvn clean install
```
4. Run the application:
```sh
mvn spring-boot:run
```
### Frontend
1. HTML
2. CSS
3. JavaScript
## Usage
### Login
1. Open the application in your web browser.
2. Navigate to the login page.
3. Enter your login credentials.
4. Upon successful login, you will be redirected to the customer list page.
### Managing Customers
- **Add Customer**: Click the "Add Customer" button and fill out the form.
- **Edit Customer**: Click the edit button next to the customer you want to edit.
- **Delete Customer**: Click the delete button next to the customer you want to delete.
- **Search Customers**: Use the search bar to filter customers by keyword.
## API Endpoints
### Authentication
- `GET /signIn` - Login endpoint (Basic Auth)
### Customers
- `GET /customers` - Get all customers
- `POST /customers` - Add a new customer
- `GET /customers/search` - Search customers by keyword
- `DELETE /{customerId}` - Delete a customer by ID
### Sync
- `POST /fetch-and-save-customers` - Sync customers with the backend
## Frontend Functionality
### Event Listeners
- **Login Form**: Handles user login and stores JWT token.
- **Add Customer Form**: Submits new customer data to the backend.
- **Sync Button**: Syncs customer data with the backend.
- **Search Input**: Filters customer list based on search keyword.
### Functions
- **loadCustomers**: Fetches and displays customer data.
- **displayCustomers**: Renders customer data in the table.
- **editCustomer**: Redirects to the edit customer page.
- **deleteCustomer**: Deletes a customer and reloads the customer list.
- **logout**: Clears the JWT token and redirects to the login page.
## Images
-
-
-
