eagle-friends

byHamza Shk

app for friends no need of number just login with any thing and make community and group and add a ai for study and we can ask any thing to ai

LandingGroup ChatLogin
Landing

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirement Document
Page 1 of 6

System Requirements Document (SRD)

Project Name: eagle-friends

1. Introduction

The eagle-friends project is a community-building application designed to foster connections among friends without the need for phone numbers. Users can log in exclusively using Gmail, create communities and groups, engage in private username-based direct messaging (DMs), and leverage an integrated AI assistant for academic support and general knowledge queries. This platform prioritizes user privacy, ensuring no personal information such as phone numbers is exposed, and aims to provide a seamless, user-friendly experience for collaboration and learning.

This document outlines the system requirements for eagle-friends, including functional and non-functional requirements, user personas, design concepts, and technical specifications.

Page 2 of 6

2. System Overview

The eagle-friends application is a hybrid social and educational platform. Its primary goals are:

  • To simplify user onboarding by allowing Gmail-only login.
  • To enable users to create and manage communities and groups for collaboration.
  • To provide private username-based direct messaging (DMs) for secure communication.
  • To integrate an AI assistant capable of answering academic and general knowledge queries.
  • To ensure all user interactions and data remain private, with no exposure of phone numbers or personal information.

The system will be developed with a clean and modern design aesthetic, ensuring accessibility and ease of use for all users. The platform will prioritize privacy, security, scalability, and responsiveness to accommodate a growing user base.

3. Functional Requirements

As User:

  • I should be able to log in using Gmail without needing a phone number.
  • I should be able to create and join communities and groups.
  • I should be able to chat with other group members.
  • I should be able to ask the AI assistant study-related questions.
  • I should be able to ask the AI assistant general knowledge questions.
  • I should be able to send and receive private direct messages (DMs) using usernames.
  • I should be able to interact with the platform without exposing my phone number or personal data.
  • I should be able to manually trigger selective re-run capability for SRD regeneration.

4. User Personas

Page 3 of 6

1. Regular User

  • Description: A general user who logs in using Gmail to join communities and interact with friends.
  • Goals: To connect with friends, participate in group activities, send private DMs, and use the AI assistant for study and knowledge purposes.

2. Group Admin

  • Description: A user who creates and manages groups or communities.
  • Goals: To organize group activities, moderate discussions, and ensure a positive environment for members.

3. AI User

  • Description: Any user interacting with the AI assistant for academic or general queries.
  • Goals: To receive accurate and helpful responses from the AI assistant.

5. Visuals Colors and Theme

Unique Color Palette for eagle-friends:

  • Background: #F3F8FF (soft sky blue)
  • Surface: #FFFFFF (pure white)
  • Text: #2C3E50 (deep slate blue)
  • Accent: #FF6F61 (vibrant coral red)
  • Muted: #B0BEC5 (soft gray-blue)

This palette reflects a clean, modern, and approachable aesthetic, aligning with the app's purpose of fostering community, privacy, and learning.

6. Signature Design Concept

Page 4 of 6

"Interactive Galaxy Map" Landing Page

The homepage of eagle-friends will feature an interactive galaxy map design. Each star in the galaxy represents a core feature of the app:

  • Login Star: A glowing Gmail icon star that pulses, inviting users to log in.
  • Community Star: A cluster of stars representing groups and communities, with animated avatars orbiting the central star.
  • AI Star: A futuristic, radiant star that emits light waves, symbolizing the AI assistant.
  • DM Star: A private, shimmering star with a lock icon, representing secure direct messaging.

Animations and Interactions:

  • The galaxy will rotate gently, creating a sense of exploration and wonder.
  • Hovering over a star will trigger micro-interactions, such as subtle color shifts, glowing effects, or orbiting animations.
  • Clicking on a star will zoom into its respective feature, transitioning smoothly to the relevant section of the app.

This design concept ensures a memorable first impression, blending creativity with functionality while emphasizing the app's core features and privacy-first approach.

7. Non-Functional Requirements

  • Performance: The app must load within 2 seconds on a standard 4G connection.
  • Scalability: The system should support up to 1 million concurrent users.
  • Security: All user data, including Gmail credentials and DMs, must be encrypted and comply with GDPR and Indian IT Act regulations.
  • Privacy: No user phone numbers or personal data will be displayed or shared.
  • Availability: The app should maintain 99.9% uptime.
  • Accessibility: The app must meet WCAG 2.1 AA standards for accessibility.

8. Tech Stack

Page 5 of 6

Frontend

  • React for Web
  • React Native for Mobile App

Backend

  • Python
  • FastAPI

Database

  • MySQL (with Alembic for migrations)

AI Models

  • GPT 5.4 for user-friendly responses
  • Claude 4.6 Opas for academic or coding work

AI Tools

  • LangChain
  • LiteLLM for LLM Routing

Orchestration

  • Docker and docker-compose for local development
  • Kubernetes for server-side orchestration

9. Assumptions and Constraints

Page 6 of 6

Assumptions

  • Users will have access to Gmail accounts for login.
  • The AI assistant will primarily handle English queries, with potential for multilingual support in the future.
  • The app will initially target users in India, with plans for global expansion.

Constraints

  • The app must comply with Indian data privacy laws.
  • Development will prioritize mobile-first design, given the high mobile usage in the target demographic.
  • All user interactions and data will remain private, with no exposure of phone numbers or personal information.

10. Glossary

  • AI Assistant: An integrated feature that provides academic and general knowledge support.
  • Community: A group of users collaborating on shared interests or goals.
  • Direct Messaging (DM): A private messaging feature allowing users to communicate securely using usernames.
  • Gmail Login: A login mechanism using Gmail credentials.
  • Selective Re-run Capability: A feature allowing users to manually trigger regeneration of the System Requirements Document (SRD).
  • WCAG: Web Content Accessibility Guidelines, ensuring usability for people with disabilities.
Landing design preview
Landing: View Islands
Login: Sign In Gmail
Home: Browse Features
AI Assistant: Ask Study Query
AI Assistant: View Response
AI Assistant: Ask Follow Up
AI Assistant: Ask General Query