Update README.md
This commit is contained in:
Amit Kumar Nandi
GitHub
parent
9174948645
commit
a20c6f24b8
1 changed files with 102 additions and 71 deletions
143
README.md
143
README.md
|
|
@ -1,28 +1,21 @@
|
|||
# Enterprise-Grade URL Shortener and Bio Page Application
|
||||
## Enterprise-Grade URL Shortener and Bio Page Application
|
||||
|
||||
[](https://travis-ci.org/yourusername/your-repo)
|
||||
[](LICENSE.md)
|
||||
[](https://github.com/yourusername/your-repo/commits/main)
|
||||
[](https://github.com/yourusername/your-repo/issues)
|
||||
[](https://github.com/yourusername/your-repo/pulls)
|
||||
[](https://github.com/yourusername/your-repo/graphs/contributors)
|
||||
[](https://travis-ci.org/yourusername/your-repo)[](LICENSE.md)[](https://github.com/yourusername/your-repo/commits/main)[](https://github.com/yourusername/your-repo/issues)[](https://github.com/yourusername/your-repo/pulls)[](https://github.com/yourusername/your-repo/graphs/contributors)
|
||||
[](https://twitter.com/intent/tweet?url=https%3A%2F%2Fgithub.com%2Fyourusername%2Fyour-repo&text=Check%20out%20this%20awesome%20URL%20Shortener%20and%20Bio%20Page%20Application&via=yourtwitterhandle)
|
||||
|
||||
|
||||
|
||||
A powerful and scalable URL shortener with integrated bio pages built using Spring Boot.
|
||||
|
||||
## Table of Contents
|
||||
|
||||
- [Overview](#overview)
|
||||
- [Features](#features)
|
||||
- [Getting Started](#getting-started)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Local Setup](#local-setup)
|
||||
- [Deployment](#deployment)
|
||||
- [Usage](#usage)
|
||||
- [Contributing](#contributing)
|
||||
- [License](#license)
|
||||
* [Overview](#overview)
|
||||
* [Features](#features)
|
||||
* [Getting Started](#getting-started)
|
||||
* [Prerequisites](#prerequisites)
|
||||
* [Local Setup](#local-setup)
|
||||
* [Deployment](#deployment)
|
||||
* [Usage](#usage)
|
||||
* [Contributing](#contributing)
|
||||
* [License](#license)
|
||||
|
||||
## Overview
|
||||
|
||||
|
|
@ -30,14 +23,14 @@ This project is an enterprise-grade URL shortener and bio page application devel
|
|||
|
||||
## Features
|
||||
|
||||
- Shorten URLs and create custom short URLs
|
||||
- Integrated bio pages for users
|
||||
- Analytics tracking for each shortened URL
|
||||
- User management with registration, login, and profile updates
|
||||
- Subscription plans for premium features
|
||||
- Rate limiting to prevent abuse
|
||||
- Forgot password and username recovery functionality
|
||||
- ...
|
||||
* Shorten URLs and create custom short URLs
|
||||
* Integrated bio pages for users
|
||||
* Analytics tracking for each shortened URL
|
||||
* User management with registration, login, and profile updates
|
||||
* Subscription plans for premium features
|
||||
* Rate limiting to prevent abuse
|
||||
* Forgot password and username recovery functionality
|
||||
* ...
|
||||
|
||||
## Getting Started
|
||||
|
||||
|
|
@ -45,64 +38,102 @@ This project is an enterprise-grade URL shortener and bio page application devel
|
|||
|
||||
Before you begin, ensure you have the following installed:
|
||||
|
||||
- Java (JDK 11 or later)
|
||||
- Maven
|
||||
- MySQL
|
||||
- Your favorite IDE (IntelliJ, Eclipse, etc.)
|
||||
* Java (JDK 11 or later)
|
||||
* Maven
|
||||
* MySQL
|
||||
* Your favorite IDE (IntelliJ, Eclipse, etc.)
|
||||
|
||||
### Local Setup
|
||||
|
||||
1. Clone the repository:
|
||||
1. Clone the repository:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/yourusername/your-repo.git
|
||||
```plaintext
|
||||
git clone https://github.com/yourusername/your-repo.git
|
||||
```
|
||||
|
||||
2. Create a MySQL database:
|
||||
2. **Apply the Database Schema:**
|
||||
|
||||
```sql
|
||||
CREATE DATABASE url_shortener_db;
|
||||
Execute the provided **db\_schema.sql** file to set up the necessary tables and schema for the application. This script will also create the required database.
|
||||
|
||||
2. Update the application.properties file:
|
||||
3. ```plaintext
|
||||
mysql -u your_username -p < path/to/db_schema.sql
|
||||
```
|
||||
|
||||
>Update the application.properties file in the src/main/resources directory with your database configuration.
|
||||
4. Update the application.properties file:
|
||||
|
||||
> Update the application.properties file in the src/main/resources directory with your database configuration.
|
||||
|
||||
4. Build and run the application:
|
||||
1. Build and run the application:
|
||||
|
||||
```bash
|
||||
Ccd your-repo
|
||||
mvn spring-boot:run
|
||||
```plaintext
|
||||
Ccd your-repo
|
||||
mvn spring-boot:run
|
||||
```
|
||||
|
||||
5. Access the application at http://localhost:8080
|
||||
2. Access the application at http://localhost:8080
|
||||
|
||||
### Deployment
|
||||
|
||||
1. Build a deployable JAR:
|
||||
1. **Build a deployable WAR:**
|
||||
|
||||
```bash
|
||||
mvn clean install
|
||||
```plaintext
|
||||
mvn clean install
|
||||
```
|
||||
|
||||
2. Deploy the JAR:
|
||||
2. **Deploy the WAR:**
|
||||
* **Option 1: Manual Deployment**
|
||||
|
||||
>Deploy the generated JAR file to your cloud provider of choice (AWS, GCP, Azure, etc.).
|
||||
Deploy the generated WAR file to your Tomcat server. Copy the WAR file to the `webapps` directory of your Tomcat installation.
|
||||
|
||||
3.Configure environment variables:
|
||||
```plaintext
|
||||
cp target/shorten.war /path/to/tomcat/webapps/
|
||||
```
|
||||
|
||||
>Set environment variables for cloud-specific settings.
|
||||
* **Option 2: Web Interface Upload**
|
||||
|
||||
Alternatively, if your Tomcat server provides a web interface for WAR file deployment, follow these steps:
|
||||
|
||||
4. Start the application on the cloud server:
|
||||
* Access the Tomcat Manager web interface at `http://localhost:8080/manager/html` (replace with your Tomcat server address).
|
||||
* Log in with your Tomcat manager credentials.
|
||||
* Navigate to the "WAR file to deploy" section.
|
||||
* Choose the `shorten.war` file using the file upload button.
|
||||
* Click the "Deploy" button.
|
||||
3. **Configure environment variables:**
|
||||
|
||||
Set environment variables for cloud-specific settings.
|
||||
|
||||
4. **Adjust Tomcat Configuration (Important):**
|
||||
|
||||
To ensure proper functionality, it's important to run the application on the root of the servlet container. If you're using Tomcat, add the following line to your `server.xml` configuration file within the `<Host>` section:
|
||||
|
||||
```xml
|
||||
<Context path="" docBase="shorten" reloadable="true"></Context>
|
||||
```
|
||||
|
||||
This ensures that the application runs on the root context path. Adjust the `docBase` attribute according to your deployment directory.
|
||||
|
||||
5. **Start Tomcat:**
|
||||
|
||||
Start your Tomcat server.
|
||||
|
||||
```plaintext
|
||||
/path/to/tomcat/bin/startup.sh # for Linux
|
||||
/path/to/tomcat/bin/startup.bat # for Windows
|
||||
```
|
||||
|
||||
Access the application at `http://localhost:8080/`.
|
||||
|
||||
```bash
|
||||
java -jar your-repo.jar
|
||||
|
||||
### Usage
|
||||
1. Shorten URLs by visiting the URL Shortener page.
|
||||
2. Access analytics for each shortened URL.
|
||||
3. Create and manage bio pages in the Bio section.
|
||||
|
||||
1. Shorten URLs by visiting the URL Shortener page.
|
||||
2. Access analytics for each shortened URL.
|
||||
3. Create and manage bio pages in the Bio section.
|
||||
|
||||
### Contributing
|
||||
|
||||
Contributions are welcome! Please follow the contribution guidelines.
|
||||
|
||||
### License
|
||||
|
||||
This project is licensed under the MIT License - see the LICENSE.md file for details.
|
||||
|
|
|
|||
Loading…
Reference in a new issue