docs: improve developer setup guide with troubleshooting and OS-specific prerequisites

[HritikRaj2]

Closes #66

Summary

This PR addresses the developer onboarding issues identified in #66 by improving the README documentation with comprehensive setup guidance.

Changes Made

1. Expanded Troubleshooting Section

• Added specific solutions for common build failures
• Included platform-specific troubleshooting for macOS and Linux
• Added service-specific debugging steps (port conflicts, MongoDB issues)
• Documented error messages and their solutions

2. Enhanced Prerequisites Section

• Added OS-specific installation commands for:
  • Ubuntu/Debian (apt-based)
  • CentOS/RHEL (yum-based)
  • macOS (Homebrew)
• Added verification commands to confirm successful installation
• Listed all required software versions explicitly

3. Added Quick Component Reference Table

• Clear overview of all services with ports and purposes
• Technology stack information for each component
• Helps new developers understand the architecture

Impact

✅ New contributors can set up the project on any major OS
✅ Reduces support burden with comprehensive troubleshooting
✅ Faster onboarding with clear component explanations
✅ Fewer setup-related issues and questions

Testing

• Verified markdown rendering
• Confirmed all code blocks use correct syntax highlighting
• Tested table formatting displays correctly

Related Issues

Addresses all documentation concerns raised in #66:

• ✅ Troubleshooting section for common build failures
• ✅ Prerequisites for different operating systems
• ✅ Component explanations
• ✅ Common build errors and solutions

[HritikRaj2]

Hi @axmsoftware @AkarshSahlot! This PR adds troubleshooting guides and OS-specific setup instructions to help new contributors get started faster. Would appreciate your review when you have time. Thanks!

[axmsoftware]

@HritikRaj2 Thank you for the detailed documentation of the PR and the added features for the README.me file!