{"id":31287742,"url":"https://github.com/maugus0/yushan-backend","last_synced_at":"2026-03-17T21:35:12.618Z","repository":{"id":314204856,"uuid":"1053834307","full_name":"maugus0/yushan-backend","owner":"maugus0","description":"Backend API for Yushan - A gamified web novel reading platform built with Spring Boot, PostgreSQL, and modern Java practices.","archived":false,"fork":false,"pushed_at":"2025-11-11T12:16:57.000Z","size":671,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-11T13:14:01.842Z","etag":null,"topics":["gamification","java","jwt-authentication","maven","postgresql","rest-api","spring-boot","webnovel"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maugus0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-10T02:12:28.000Z","updated_at":"2025-11-11T12:16:54.000Z","dependencies_parsed_at":"2025-09-11T07:02:26.880Z","dependency_job_id":"1ddb0bff-efe7-4231-9a8d-4cd60ad5f6bb","html_url":"https://github.com/maugus0/yushan-backend","commit_stats":null,"previous_names":["maugus0/yushan-backend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/maugus0/yushan-backend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maugus0%2Fyushan-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maugus0%2Fyushan-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maugus0%2Fyushan-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maugus0%2Fyushan-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maugus0","download_url":"https://codeload.github.com/maugus0/yushan-backend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maugus0%2Fyushan-backend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30632033,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-17T17:32:55.572Z","status":"ssl_error","status_checked_at":"2026-03-17T17:32:38.732Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gamification","java","jwt-authentication","maven","postgresql","rest-api","spring-boot","webnovel"],"created_at":"2025-09-24T11:06:12.101Z","updated_at":"2026-03-17T21:35:12.593Z","avatar_url":"https://github.com/maugus0.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Yushan Backend\n\n\u003e 📚 **Backend API for Yushan** - A gamified web novel reading platform that transforms reading into an engaging, social experience.\n\n## 🚀 Tech Stack\n\n- **Framework**: Spring Boot 3.x\n- **Language**: Java 17+\n- **Database**: PostgreSQL (Production) | H2 (Development)\n- **Build Tool**: Maven\n- **Security**: Spring Security with JWT\n- **Testing**: JUnit 5, Testcontainers\n\n## ✨ Key Features\n\n### 📖 Core Platform\n- Novel management and chapter organization\n- User authentication and authorization\n- Full-text search across novels and content\n- Reading progress tracking\n- Bookmarks and favorites system\n\n### 🎮 Gamification\n- XP and leveling system\n- Achievement and badge system\n- Reading streaks and milestones\n- Leaderboards and competitions\n- Social features (following, reviews)\n\n### 🔧 Technical Features\n- RESTful API design\n- JWT-based authentication\n- Database migration support\n- Comprehensive error handling\n- API documentation with OpenAPI\n- Caching for performance optimization\n\n## 🏗️ Project Structure\n\n```\ncom.yushan.backend/\n├── controller/          # REST API endpoints\n├── service/            # Business logic layer\n├── repository/         # Data access layer\n├── entity/            # JPA entities (database models)\n├── dto/               # Data Transfer Objects\n├── config/            # Application configuration\n└── exception/         # Custom exception handling\n```\n\n## 🚦 Getting Started\n\n### Prerequisites\n- Java 17 or higher\n- Maven 3.6+\n- PostgreSQL (for production)\n\n### Quick Setup\n```bash\n# Clone the repository\ngit clone https://github.com/your-username/yushan-backend.git\ncd yushan-backend\n\n# Run with H2 database (development)\n./mvnw spring-boot:run\n\n# Run tests\n./mvnw test\n```\n\n### Database Configuration\n```properties\n# Development (H2 - auto-configured)\nspring.profiles.active=dev\n\n# Production (PostgreSQL)\nspring.profiles.active=prod\nspring.datasource.url=jdbc:postgresql://localhost:5432/yushan\n```\n\n## 📡 API Endpoints\n\n### Authentication\n- `POST /api/auth/register` - User registration\n- `POST /api/auth/login` - User login\n- `POST /api/auth/refresh` - Token refresh\n\n### Novels\n- `GET /api/novels` - List novels\n- `POST /api/novels` - Create novel\n- `GET /api/novels/{id}` - Get novel details\n- `GET /api/novels/{id}/chapters` - Get chapters\n\n### User \u0026 Gamification\n- `GET /api/users/profile` - User profile\n- `GET /api/users/progress` - Reading progress\n- `GET /api/leaderboard` - User rankings\n\n## 🧪 Development\n\n### Running Tests\n```bash\n# Unit tests\n./mvnw test\n\n# Integration tests with Testcontainers\n./mvnw verify\n```\n\n### Database Migration\n```bash\n# Generate migration scripts\n./mvnw flyway:migrate\n```\n\n## 🛠️ Built With\n\n- [Spring Boot](https://spring.io/projects/spring-boot) - Application framework\n- [Spring Security](https://spring.io/projects/spring-security) - Authentication \u0026 authorization\n- [Spring Data JPA](https://spring.io/projects/spring-data-jpa) - Data persistence\n- [PostgreSQL](https://www.postgresql.org/) - Primary database\n- [H2 Database](https://www.h2database.com/) - Development database\n- [Maven](https://maven.apache.org/) - Dependency management\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🌟 Roadmap\n\n- [ ] Advanced search with filters\n- [ ] Real-time notifications\n- [ ] Social features (comments, discussions)\n- [ ] Mobile app API support\n- [ ] Advanced analytics dashboard\n- [ ] Multi-language support\n\n---\n\n**Yushan Backend** - Powering the future of gamified reading experiences 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaugus0%2Fyushan-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaugus0%2Fyushan-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaugus0%2Fyushan-backend/lists"}