Wesal App

A social networking mobile application designed for connecting workplace colleagues. Wesal (Arabic for "connection") enhances communication and collaboration among division members.

Features

• Social Feed: Create, view, like, and comment on posts
• Invitations: Create and manage event invitations with RSVP functionality
• Daily Puzzles: Timed daily challenges with leaderboards (9AM-11AM)
• Push Notifications: Stay engaged with real-time updates

Quick Start with Docker

1. Clone and setup:

   git clone https://git.bubshait.me/sBubshait/wesal.git
   cd wesal
   chmod +x install.py
   sudo ./install.py
   

2. Run the application:

   docker compose up --build
   

3. Access the services:

   • Frontend: http://localhost:6060
   • Backend API: http://localhost:4044
   • API Docs: http://localhost:4044/docs
   • Database Admin: http://localhost:8100

Technology Stack

• Frontend: Flutter 3.8.1+
• Backend: Spring Boot 3.5.3 (Java 21)
• Database: PostgreSQL
• Authentication: JWT tokens
• Notifications: Firebase Cloud Messaging
• Deployment: Docker containerization

Documentation

For detailed technical documentation, installation guides, development setup, and troubleshooting, see: 📖 Complete Documentation

Development

See the full documentation for:

• Manual setup instructions
• Development commands
• Testing procedures
• API documentation
• Troubleshooting guide

Support

Contact COD/DPSD for application support and maintenance information.