🤝 YoteAyudo Marketplace Project

Note

🌐 Description:

YoteAyudo is a marketplace that offers a variety of services for young and middle-aged adults who are open to trying new things and enjoying cultural diversity. From language exchanges to pet care and companionship, YoteAyudo connects people with similar interests and promotes collaboration and social connection.

🏚️ Services Offered:

• Service Exchange: Can I help you? / Can you help me?
• Today I Cook!: Multicultural meal exchange
• Pet Care: I walk your dog / I care for your cat while you travel
• Companionship: I listen to you / I accompany you / Conversations with the elderly
• Assistance: I water your plants / I take care of your little one / Storytime for your little one over Zoom

👩‍💻🧑‍💻 Technologies Used:

Front-end:

• JavaScript
• HTML
• CSS (Tailwind CSS)
• React.js
• Next.js
• Jest
• React Library test

Back-end:

• Java
• Spring
• Mysql
• Vitest

Other tools:

• Figma (UI/UX)
• Trello (Organizaton)
• Discord (Comunication)

📁 File Structure:

• .next: Contains automatically generated files by Next.js during the build process, including configurations and optimized code. Manual editing of these files isn't necessary.
• /node_modules: Stores all project dependencies installed via npm. Direct editing isn't required as npm manages these dependencies.
• public/: Holds static files accessible directly from the browser, such as images, CSS styles, and other resources.
• src/:
  • app/: Contains main application files, such as the entry point or core logic.
  • components/: Houses reusable React components used within the interface.
  • utils/: Holds helper functions or utilities for the application.
• test/: Stores files related to the project's testing, such as configurations and test suites. Used for performing unit and integration tests on the codebase.

📚 Features:

For Users:

• View Ads: List of ads with filters by category, location, price, etc.
• View Ad Details: Photos, description, price, location, seller information, etc.
• Post Ads: Form to create ads with photos, description, price, category, etc.
• Advanced Search: Filter ads by keywords, categories, price, location, etc.
• Contact Seller: Send messages to the seller through the marketplace.
• Favorites: Save ads to access later.
• Log In: Register or log in to access personalized features and manage their data.

For Customers:

• Post Ads: Post ads to promote their products or services.
• Manage Ads: Edit, delete, or pause their published ads.

For Administrators:

• User Management: Create, edit, and delete marketplace users.
• Ad Management: Approve, reject, or delete published ads.
• Content Moderation: Monitor marketplace content and remove inappropriate content.

Important

🛠 Installation Instructions:

1. Open a terminal and navigate to the project folder.

   Clone this repository into the desired folder using the git clone command: https://github.com/YoteAyudo-project/YoteAyudo-frontend.git

2. Navigate to the project directory and install dependencies:

cd YoteAyudo-frontend
npm install

3. Once the dependencies are installed, you can run the tests using the command:

npm test

4. Finally go again to the terminal and open the interface on the browser:

npm run dev

📝 Usage Instructions:

1. Start the development server:
2. Open your web browser and navigate to http://localhost:3000 to access the YoteAyudo application.

🔎 Page Demo

(picture an website navigation video)

👥 Project team Organization:

• Product Owner: Gabriel Pastor
• Scrum Master: Stephanie Céspedes
• Backend team: Natalia García,Stephanie Céspedes
• Frontend team: Gabriel Pastor, David Altamirano,Elle,Stephanie Céspedes.
• UI/UX:Gabriel Pastor

👩‍💻🧑‍💻 LinkedIn:

• Stephanie Céspedes - Linkedin profile
• David Altamirano - Linkedin profile
• Gabriel Pastor - Linkedin profile
• Elle - Linkedin profile
• Nuria -
• Natalia -

Tip

🚀 Development and Contributions

🎖 Contribute to the development of this application by following these steps!

1. Fork the repository.
2. Clone your forked repository locally.
3. Create a new branch: git checkout -b branch-name.
4. Make changes and commit descriptive messages.
5. Push the branch to your forked repository: git push origin branch-name.
6. Open a pull request in the original repository.
7. Thank you for your contribution!

---