Book Social Network 开源项目教程

1. 项目介绍

Book Social Network 是一个全栈应用程序，旨在帮助用户管理他们的图书收藏并与图书爱好者社区互动。该项目提供了用户注册、安全电子邮件验证、图书管理（包括创建、更新、分享和归档）、图书借阅（包括借阅检查、图书归还和归还审批）等功能。应用程序通过使用 JWT 令牌确保安全性，并遵循 REST API 设计的最佳实践。后端使用 Spring Boot 3 和 Spring Security 6 构建，前端则使用 Angular 和 Bootstrap 进行开发。

2. 项目快速启动

2.1 环境准备

在开始之前，请确保您的开发环境已经安装了以下工具：

• Java 17
• Node.js
• Docker
• Maven

2.2 克隆项目

首先，克隆项目到本地：

git clone https://github.com/ali-bouali/book-social-network.git
cd book-social-network

2.3 启动后端服务

进入后端目录并启动服务：

cd book-network
mvn clean install
mvn spring-boot:run

2.4 启动前端服务

进入前端目录并启动服务：

cd ../book-network-ui
npm install
npm start

2.5 访问应用

打开浏览器，访问 http://localhost:4200，您将看到 Book Social Network 的应用界面。

3. 应用案例和最佳实践

3.1 图书管理

用户可以通过应用创建、更新、分享和归档图书。例如，用户可以创建一个新的图书条目，填写图书的详细信息，并将其分享到社区中。

3.2 图书借阅

用户可以借阅社区中的图书，系统会自动检查图书的可用性。借阅成功后，用户可以在规定时间内归还图书，管理员可以审批归还请求。

3.3 社区互动

用户可以通过应用参与社区讨论，加入不同的图书小组，与其他书友交流阅读心得。

4. 典型生态项目

4.1 Spring Boot 3

Spring Boot 3 是该项目后端的核心框架，提供了快速开发和部署的能力。

4.2 Angular

Angular 是该项目前端的主要框架，提供了组件化开发和高效的渲染能力。

4.3 Docker

Docker 用于容器化部署，确保应用在不同环境中的一致性。

4.4 Keycloak

Keycloak 用于用户认证和授权，提供了安全的 JWT 令牌管理。

通过以上步骤，您可以快速启动并使用 Book Social Network 项目，享受图书管理和社区互动的乐趣。