# ali-bouali/book-social-network

BSN is a social network platform to exchange books between the members.

Repository: https://github.com/ali-bouali/book-social-network
Canonical: https://ross.abutalabs.com/products/book-social-network
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: angular, docker, java, java-mail, jwt-authentication, spring-boot, thymeleaf-template-engine
Last push: 2024-09-10T10:53:22+00:00

## Health v2 (maintenance only)
Score: 25/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 66
- inputs: {"age_days": 932, "days_push": 722, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1057, forks 241 (observed 2026-08-28T04:03:24.937769+00:00)

## What it is
Book Social Network (BSN) is a full-stack social network application for exchanging and borrowing books among members. It combines a Spring Boot 3 / Spring Security 6 backend with JWT authentication and an Angular frontend with Bootstrap styling.

## Use cases
- build a social network for exchanging books
- learn Spring Boot 3 and Spring Security with JWT authentication
- practice full-stack development with Angular and Spring Boot
- implement book borrowing and return workflows with availability checks
- set up email-based account activation and validation
- document REST APIs with OpenAPI and Swagger UI
- containerize a full-stack app with Docker and CI/CD with GitHub Actions
- study a monorepo setup for backend and frontend

## When to choose
- you want a reference full-stack project combining Spring Boot and Angular
- you are learning JWT-based authentication and Spring Security 6
- you need a working example of REST API best practices, validation, and pagination
- you want a template for Dockerized deployment with GitHub Actions pipelines

## When to avoid
- you need a production-grade book exchange platform with payments or shipping integration
- you require a different frontend stack than Angular
- you need high scalability or multi-tenancy beyond a learning-oriented design

## Facets
- artifact type: application
- maturity: active
- function: auth, web-framework, api-framework, email, orm, http-server, frontend-framework, ui-components, state-management, form-handling, routing, middleware, sdk, developer-tools, self-hosted
- domain: web-development, backend, frontend, apis, education, social-media, self-hosted, tutorials
- platform: jvm, cross-platform
- tags: book-sharing, social-network, spring-security, jwt-authentication, keycloak, openapi, swagger, learning-project, full-stack, monorepo, email-validation, book-borrowing, docker, angular, spring-boot, typescript, web-server

## Member repositories
- ali-bouali/book-social-network (main) score 25

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:24.937769+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:57:55.323064+00:00, confidence not recorded.
  - readme: https://github.com/ali-bouali/book-social-network (fetched 2026-08-28T04:03:24.937769+00:00, sha c1c67850d6c7)
- Data as of 2026-08-30T08:39:29.467469+00:00.