https://github.com/longwater1234/wedemyserver
Udemy Clone. (Backend) Springboot 3, Java, Spring Session, Braintree Payments, PayPal, MySQL 8, Hibernate, Redis, Google OAuth
https://github.com/longwater1234/wedemyserver
braintree e-learning google-sign-in hibernate java mysql paypal redis-cache spring-boot springsecurity udemy
Last synced: about 1 year ago
JSON representation
Udemy Clone. (Backend) Springboot 3, Java, Spring Session, Braintree Payments, PayPal, MySQL 8, Hibernate, Redis, Google OAuth
- Host: GitHub
- URL: https://github.com/longwater1234/wedemyserver
- Owner: Longwater1234
- License: mit
- Created: 2021-06-06T00:32:22.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2025-04-29T10:26:36.000Z (about 1 year ago)
- Last Synced: 2025-04-29T11:30:35.962Z (about 1 year ago)
- Topics: braintree, e-learning, google-sign-in, hibernate, java, mysql, paypal, redis-cache, spring-boot, springsecurity, udemy
- Language: Java
- Homepage: https://longwater1234.github.io/WedemyServer/
- Size: 1.84 MB
- Stars: 31
- Watchers: 3
- Forks: 17
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WedemyServer
[](https://longwater1234.github.io/WedemyServer/)
[](https://github.com/Longwater1234/WedemyServer/graphs/commit-activity)
[](https://github.com/Longwater1234/WedemyServer/blob/master/LICENSE)
[](HELP.md)
(Backend repo). Clone of Udemy, an e-learning platform, built using SpringBoot 3 + Vue 3 + Typescript. With CreditCard
and
PayPal checkout (both powered by **Braintree Payments**). Uses Spring Security & Spring Session Redis (via cookies[^1]
or sessionID Headers) for auth, instead of stateless JWT Tokens. CSRF protection is enabled. You can easily customize
these settings in [SecurityConfig](src/main/java/com/davistiba/wedemyserver/config/SecurityConfig.java). By default, the
app runs on port 9000.
## Frontend & Live Demo
Click to view [Frontend Repo](https://github.com/Longwater1234/WedemyClient) and live Demo built using Vue 3, Vite and
Typescript. However, you may use any other frontend stack with this project. See
the [OpenAPI Docs](https://longwater1234.github.io/WedemyServer/) for this project.
## Requirements
- Java 17 or newer
- MySQL 8.0.x or newer
- Redis Server (latest stable)
- [Google OAuth Credentials](https://developers.google.com/identity/gsi/web/guides/get-google-api-clientid) (for Google
Login)
- [Braintree Developer](https://developer.paypal.com/braintree/docs) Account + API Keys. (for Payments)
- (OPTIONAL) Free PayPal Business Account.
### Environmental Variables
You MUST set these variables on your Local or Cloud ENV before you launch this SpringBoot app. **💡TIP**: During
dev/test, you can pass them via `args`, OR store inside your IDE: e.g. In either Eclipse or IntelliJ IDE, in the top
toolbar, find the **"Run"** menu > **Edit/Run Configuration** > **Environment** > **Environmental Variables**. Add (+)
each key and its value, then click **Apply**. If using Docker CLI, please follow this quick
[official guide.](https://docs.docker.com/engine/reference/commandline/run/#env)
```properties
MYSQL_PASSWORD=
# below are for Google OAuth
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
# below are for Braintree Payments
BT_MERCHANT_ID=
BT_PUBLIC_KEY=
BT_PRIVATE_KEY=
# For production, set these:
SPRING_PROFILES_ACTIVE=prod
PORT=#{for Spring server}
```
## Important ⚠
Please examine the files [application.yml](src/main/resources/application.yml) (default),
and [application-prod.yml](src/main/resources/application-prod.yml) (meant for _production_). Replace all the necessary
Spring Application properties with yours. But for sensitive info (like Passwords or API Keys), **DON'T PASTE THEM IN
THERE DIRECTLY**❌ . It's safer to store them as Environmental Variables instead (see section above), then either
declare them as `property.name = ${ENV_KEY_NAME}`, OR refer them directly in your source code as shown
in [BraintreeConfig](src/main/java/com/davistiba/wedemyserver/config/BraintreeConfig.java).
## Database Setup
Using any MySQL client, CREATE new database called `wedemy` (any name is OK), with charset `utf8mb4`. Then, follow
carefully instructions in [HELP.md](HELP.md#database-setup-info), for both MySQL and Redis. I have attached a mysqldump
file with [sample data](src/main/resources/data_wedemy.sql) for testing.
## Quick Start 🚀
### With Maven (directly)
Assuming you have requirements listed above, and both your Dbs are running. Using your Terminal, execute the commands
below. That's it! Server will be available at http://localhost:9000
```bash
./mvnw clean package
java -jar target/wedemyserver.jar
```
### With Docker
I have attached [Dockerfile](Dockerfile) for the Springboot server only. You will need to set up MySQL &
Redis separately. Refer to official Docker docs on how to pass ENV variables listed above.
```bash
docker build -t wedemyserver ./
docker run --name "wedemy" -d -p9000:9000 wedemyserver
```
**Tip** 💡 : If using Docker Desktop (latest), before starting container, you can fill in the ENV vars in the GUI
directly.
See [screenshot](src/main/resources/docker_env.PNG)
## Deploying your App 🌍
This App can be easily deployed within few minutes, straight from GitHub to your Cloud PaaS of choice. You can either
use the [Dockerfile](Dockerfile) provided, or as a pure Java app. Popular PaaS with CI/CD for Java (without Dockerfile)
include: Heroku, AWS ElasticBeanstalk, Google App Engine, Azure Web Apps. The following may **require** a Dockerfile:
Dokku, Railway, Render.com, Fly.io. Please note, you will also need a **separate** MySQL & Redis instance!
## Payments Handling
All payments are securely handled by **Braintree Payments** (owned by PayPal), which supports cards, PayPal, Apple Pay,
GooglePay, Venmo and many other methods. This project implements Credit-Card and PayPal Checkout only, in _Sandbox_
mode: **No actual money is deducted at Checkout**. Make sure you obtain a set of 3 API Keys from
your own Braintree Dev Account and store them as ENV variables: `BT_MERCHANT_ID`, `BT_PUBLIC_KEY` and `BT_PRIVATE_KEY`.
For Braintree tutorials and samples, please check their [official docs](https://developer.paypal.com/braintree/docs).
## License
[MIT License](LICENSE) © 2021 - present, Davis T
---
[^1]: In production, for Browser clients, ensure both your Backend and Frontend share the same _ROOT_ domain (same-site
policy), AND set property `session.cookie.Secure=true` (strictly https) for Session Cookies to work properly. Learn
more at [WebDev](https://web.dev/samesite-cookies-explained/). Alternatively, you can replace Cookies **entirely** with
special Header X-AUTH-TOKEN (by Spring; expires too). See file SecurityConfig.java.