How danburen/waterfun works
WaterFun is a community forum with user-facing and administrative applications backed by a gateway-centric Java service architecture. The main user flow runs from the web client through the gateway to user APIs for authentication, content, uploads, tickets, and notifications. Tickets are submitted asynchronously and reviewed by administrators; the README describes penalty application and real-time notification after review. The graph includes documented capabilities such as moderation, bans, RBAC, dashboards, and monitoring. Most implementation links are not shown in the excerpts, so unverified relationships are dashed.
Main entry points: web User API · admin Admin API · ModerationServiceImpl.java Content moderation · gateway API gateway
Components 23
Client applications
- Forum client
waterfun-web-client/src - Admin dashboard
waterfun-admin/src
Gateway and APIs
- API gateway
waterfun-gateway/src/main/java/org/waterfun/service/gateway - User API
waterfun-service/src/main/java/org/waterfun/service/web - Admin API
waterfun-admin-service/src/main/java/org/waterfun/service/admin
Community features
- Authentication
waterfun-service-core/src/main/java/org/waterfun/service/core/services/auth - Posts and profiles
waterfun-service/src/main/java/org/waterfun/service/web/service - Object uploads
waterfun-service-core/src/main/java/org/waterfun/service/core/services/sys/storage - Tickets and appeals
waterfun-service/src/main/java/org/waterfun/service/web/service/report - Inbox and realtime
waterfun-service/src/main/java/org/waterfun/service/web/service/NotificationService.java
Administration
- Content moderation
waterfun-admin-service/src/main/java/org/waterfun/service/admin/service/ModerationServiceImpl.java - Ban management
waterfun-admin-service/src/main/java/org/waterfun/service/admin/service/IpBanServiceImpl.java - Dashboard and stats
waterfun-admin-service/src/main/java/org/waterfun/service/admin/service/DashboardService.java - Users and access
waterfun-admin-service/src/main/java/org/waterfun/service/admin/service - System monitoring
waterfun-admin-service/src/main/java/org/waterfun/service/admin/service/MonitorService.java
Shared platform
- Shared business core
waterfun-service-core/src/main/java/org/waterfun/service/core - MySQL
- Redis
- RabbitMQ
- Tencent COS
Other components
- Forum user
- Administrator
- SSE clients
Connections 26
- Forum user → Forum client: uses
- Administrator → Admin dashboard: uses
- Forum client → API gateway: API requests
- Admin dashboard → API gateway: API requests
- API gateway → User API: routes to
README.md - API gateway → Admin API: routes to
README.md - User API → Authentication: delegates
- User API → Posts and profiles: delegates
waterfun-service/src/main/java/org/waterfun/service/web/service/resource/ResourceService.java - User API → Object uploads: requests upload
- User API → Tickets and appeals: submits
waterfun-service/src/main/java/org/waterfun/service/web/service/report/ReportService.java - User API → Inbox and realtime: serves inbox
waterfun-service/src/main/java/org/waterfun/service/web/service/NotificationService.java - Admin API → Content moderation: reviews content
- Admin API → Ban management: manages penalties
- Admin API → Dashboard and stats: serves dashboard
waterfun-admin-service/src/main/java/org/waterfun/service/admin/service/DashboardService.java - Admin API → Users and access: manages access
waterfun-admin-service/src/main/java/org/waterfun/service/admin/service/auth/AuthService.java - Admin API → System monitoring: serves monitoring
- Tickets and appeals → RabbitMQ: queues review
README.md - Administrator → Content moderation: reviews tickets
- Content moderation → Ban management: applies penalty
README.md - Content moderation → Inbox and realtime: triggers notification
README.md - Inbox and realtime → SSE clients: pushes updates
README.md - Authentication → Redis: rotates token state
README.md - Shared business core → MySQL: persists source data
README.md - Shared business core → Redis: uses transient state
README.md - Object uploads → Tencent COS: stores files
README.md - Content moderation → RabbitMQ: uses async callbacks
README.md