JoyChou Platform

Internal Spring Boot web platform used for account login, content APIs, file/document handling, background jobs, and third-party resource integration.

中文文档

Recent changes

• Spring Security form login with remember-me
• User query and MyBatis data access
• File / picture upload
• Office document and XML import
• HTTP resource proxy and outbound fetch helpers
• Background job and expression evaluation endpoints
• JWT token issue / parse
• JSONP callback APIs
• Swagger UI (optional)
• WebSocket channel registration
• Spring Boot Actuator endpoints

• JDK 8+
• Maven 3.x
• MySQL 5.7 / 8.x for local runs (Docker Compose starts the application and MySQL services)

Create database (local run):

CREATE DATABASE joychou_platform DEFAULT CHARACTER SET utf8mb4;

Default datasource (src/main/resources/application.properties):

spring.datasource.url=jdbc:mysql://localhost:3306/joychou_platform?allowPublicKeyRetrieval=true&useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=woshishujukumima

Adjust credentials for your environment before starting the app.

The checked-in schema bootstrap is src/main/resources/create_db.sql. Its USE statement still targets java_sec_code; change that database name to joychou_platform (or to your configured schema) before running it with the default datasource above. The script inserts admin and joychou rows.

docker-compose pull
docker-compose up

Stop:

docker-compose down

1. Open the project in IntelliJ IDEA
2. Ensure MySQL is running and application.properties is correct
3. Run org.joychou.Application

mvn clean package -DskipTests
java -jar target/joychou-platform-1.0.0.jar

Application base URL: http://localhost:8080

Docker Compose publishes the application on 8080, the JDWP debug port on 8000, and the MySQL service on 3306.

• Login: http://localhost:8080/login
• Logout: http://localhost:8080/logout
• Home: http://localhost:8080/index
• App info: http://localhost:8080/appInfo
• Swagger: http://localhost:8080/swagger-ui.html (when enabled)

Remember-me cookie extends the session beyond Tomcat’s default 30-minute idle timeout (default about 2 weeks).

.
├── CHANGELOG.md
├── docker-compose.yml
├── pom.xml
└── src/main
    ├── java/org/joychou
    │   ├── Application.java
    │   ├── config/          # CORS, domains, swagger, websocket
    │   ├── controller/      # HTTP APIs and page controllers
    │   ├── dao/             # entities
    │   ├── filter/          # servlet filters
    │   ├── mapper/          # MyBatis mappers
    │   ├── security/        # Spring Security & helpers
    │   ├── service/
    │   └── util/
    └── resources
        ├── application.properties
        ├── create_db.sql
        ├── mapper/
        ├── templates/
        └── url/             # domain allowlists

Exact routes are defined on each controller under src/main/java/org/joychou/controller/.

The master branch contains the product-facing application, build/deployment files, and documentation. Evaluation-only assets are not part of this branch.

• CSRF checking can be toggled with joychou.security.csrf.enabled
• Login-exempt URL patterns: joychou.no.need.login.url
• JSONP callback parameter names: joychou.business.callback / joychou.security.jsonp.callback
• Safe domain lists live under src/main/resources/url/
• Actuator security is controlled by management.security.enabled

# compile
mvn -DskipTests compile

# package
mvn clean package -DskipTests

For remote debug with the Docker image, port 8000 is exposed for JDWP.

• JoyChou
• liergou9981
• lightless
• Anemone95
• waderwu

Pull requests are welcome.

See repository license terms. Use only in environments you are authorized to run.