This repository contains the project developed for the Design and Implementation of Mobile Applications (DIMA) course at Politecnico di Milano (A.Y. 2023–2024). The goal of the project is to design and implement a cross-platform mobile application using one of the technologies introduced during the course. For this project, we chose Flutter, a framework developed by Google to create cross-platform applications. Course Instructor: Prof. Luciano Baresi

AgorApp is a versatile social application designed to bring together individuals with common interests across different categories. Users can join groups focused on specific topics, facilitating meaningful interactions and exchanges of ideas. Beyond its chat functionalities, AgorApp offers comprehensive event management features and keeps users informed by providing news updates related to their areas of interest.

This repository is structured as follows:

• agorapp/ – Contains the full source code of the AgorApp mobile application.

• docs/ – Includes the Design Document and Presentation Presentation slides.

• images/ – Stores all images used in this README.

• 🔐 Login & Registration: Sign in using your email or Google Single Sign-On (SSO).

• 📰 Search News: Find relevant news articles by entering keywords.

• 👥 Create/Edit Groups: Customize groups with names, descriptions, categories, and profile images.

• 📅 Create/Edit Events: Organize and manage events seamlessly.

• 📤 Share News & Events: Easily share content with your groups or followers.

• ➕➖ Follow/Unfollow Users: Manage your connections and stay updated.

• 👥 Join/Leave Groups: Join communities or leave them as needed.

• 📬 Subscribe/Unsubscribe Events: Stay updated on events or opt out anytime.

• 💬 Chatting: Enjoy group and private messaging features.

• 🖼️ View Content: Browse shared news, events, and images within chats.

• 🛠️ Message Actions: Delete, copy, or check read receipts for messages.

• 🔔 Manage Notifications: Choose to enable or disable notifications based on your preferences.

• 📆 View Calendar: Browse a calendar with events joined or created.

• 🙋 User Profiles: View and update your own profile, or explore other profiles.

• ⚙️ Profile Settings: Update profile details or delete your account.

• 🗞️ Push News Notifications: Receive alerts on news related to your interests.

AgorApp is developed with Flutter, an open-source framework created by Google that allows for the development of natively compiled, cross-platform applications using a single codebase. The application follows a Model-View-Controller (MVC) design pattern, which provides a clear separation of concerns between different components of the application.

• 🔥 Cloud Firestore: A scalable, NoSQL database optimized for storing and managing application data with high efficiency.
• ☁️ Cloud Storage: Used to store and deliver user-generated images, including profile pictures, event photos, group profile images, and chat images.

• 🔐 Firebase Authentication & Google Sign-In: Secure user authentication and seamless login via Google.

• 📩 Firebase Cloud Functions: Manage and deliver push notifications to users.

• 📰 News API: Access and deliver curated, up-to-date news stories.

• 🗺️ OpenStreetMaps & GraphHopper APIs: Provide location services and map functionality.

• 🔔 Firebase Cloud Messaging: Enable real-time push notifications for enhanced user engagement.

The user interface of AgorApp is designed to be intuitive and user-friendly. The application adapts to different screen sizes to enhance usability and improve the overall look and feel.

Key screens include:

• 🔑 Login: The first screen displayed when the application is opened.

• 📰 News Page: Features the most recent news and allows users to search for news articles.

• 💬 Chat Page: Displays the chat interface, featuring a list of group and private chats.

• 📅 Calendar Page: Features a calendar that allows users to view events.

• 🔍 Search Page: Allows users to search for other users, groups, and events.

• 🙍‍♂️ User Profile Page: Displays the user profile, including the username, full name, and preferred categories.

📸 More screenshots of the app are available in the Design Document.

• ➕ Create Event Page: Allows users to create events by providing event details.
• 📍 Event Page: Displays the event details, including the name, description, and location.
• 📄 Detail Page: Provides detailed information about an event.
• ⚙️ Setting Page: Allows users to manage their profile settings.

The application satisfies the following requirements:

• Support user login and registration.
• Allow registered users to edit their personal information.
• Allow registered users to send messages in both group chats and private chats.
• Send push notifications for chat messages if enabled by the user.
• Allow users to create and delete groups.
• Allow registered users to create and delete events.
• Allow registered users to view a list of joined and created events.
• Allow registered users to follow and unfollow other registered users.
• Send push notifications to registered users for new news items related to their categories of interest.
• Allow users to log out from the application.
• Allow users to permanently delete their accounts.

The testing strategy for the application comprises three distinct types:

• Unit Testing: Verifies that individual software components function according to the specific requirements.
• Widget Testing: Focuses on the user interface and interaction of widgets within the application.
• Integration Testing: Ensures that the combined components of the system work together as intended.

The following table summarizes the test coverage achieved when running all tests together:

Planned improvements for AgorApp include:

• Implement a recommender system to suggest relevant news to users.
• Replace the current Firebase-based backend with a custom solution.
• Expand Android support to fully utilize the cross-platform capabilities of Flutter.
• Integrate bots into group chats to act as moderators.

The development of the application required the use of some APIs. The keys used are not present in the repository and they need to be regenerated. The APIs key can be generated from the following links:

• https://www.graphhopper.com/
• https://newsapi.org/

The backend of the application is hosted on Firebase. The configuration files are empty and need to be regenerated.