{"id":31666029,"url":"https://github.com/rafiqmia65/zentro-server","last_synced_at":"2026-05-05T19:32:50.492Z","repository":{"id":317548106,"uuid":"1067709278","full_name":"rafiqmia65/zentro-server","owner":"rafiqmia65","description":"Zentro is a backend service for a modern real estate application, built with Node.js, Express.js, and MongoDB (Mongoose). It powers the core functionalities of the Zentro platform such as property management, user authentication, and API endpoints for the frontend.","archived":false,"fork":false,"pushed_at":"2025-10-01T16:36:51.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-01T16:36:58.056Z","etag":null,"topics":["bcrypt","cors","dotenv","expressjs","jwt","mogodb","mongoose","nodejs"],"latest_commit_sha":null,"homepage":"https://zentro-server.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rafiqmia65.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-01T09:13:06.000Z","updated_at":"2025-10-01T16:31:48.000Z","dependencies_parsed_at":"2025-10-01T16:37:01.025Z","dependency_job_id":null,"html_url":"https://github.com/rafiqmia65/zentro-server","commit_stats":null,"previous_names":["rafiqmia65/zentro-server"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/rafiqmia65/zentro-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafiqmia65%2Fzentro-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafiqmia65%2Fzentro-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafiqmia65%2Fzentro-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafiqmia65%2Fzentro-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rafiqmia65","download_url":"https://codeload.github.com/rafiqmia65/zentro-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafiqmia65%2Fzentro-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32664945,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-05T11:29:49.557Z","status":"ssl_error","status_checked_at":"2026-05-05T11:29:48.587Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bcrypt","cors","dotenv","expressjs","jwt","mogodb","mongoose","nodejs"],"created_at":"2025-10-07T22:55:59.525Z","updated_at":"2026-05-05T19:32:50.486Z","avatar_url":"https://github.com/rafiqmia65.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏡 Zentro - Real Estate Application Backend\n\nZentro is a backend service for a modern **real estate application**, built with **Node.js**, **Express.js**, and **MongoDB (Mongoose)**.  \nIt powers the core functionalities of the Zentro platform such as property management, user authentication, and API endpoints for the frontend.\n\n---\n\n## 📁 Project Structure\n\n```bash\nzentro-server/\n├── src/\n│   ├── config/         # Database connection \u0026 environment configs\n│   ├── controllers/    # Business logic \u0026 request handlers\n│   ├── middlewares/    # Authentication, error handling, etc.\n│   ├── models/         # Mongoose schemas and models\n│   ├── routes/         # API routes\n│   ├── app.js          # Express application setup\n│   └── index.js        # Entry point of the backend server\n├── .env                # Environment variables (not committed)\n├── .env.example        # Environment variables template\n├── .gitignore          # Git ignore rules\n├── package.json        # Dependencies and scripts\n├── vercel.json         # Vercel deployment config\n└── README.md           # Project documentation\n```\n\n---\n\n## 🚀 Getting Started\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/rafiqmia65/zentro-server.git\ncd zentro-server\n```\n\n### 2. Install Dependencies\n\n```bash\nnpm install\n```\n\n### 3. Setup Environment Variables\n\nCopy the example environment file and update with your values:\n\n```bash\ncp .env.example .env\n```\n\nEdit the `.env` file:\n\n```env\nPORT=5000\nMONGO_URI=your_mongodb_connection_string\nJWT_SECRET=your_jwt_secret_key_here\nNODE_ENV=development\n```\n\n### 4. Run the Server\n\n```bash\n# Development mode (with auto-reload)\nnpm run dev\n\n# Production mode\nnpm start\n```\n\nServer will start at:  \n👉 `http://localhost:5000`\n\n---\n\n## 📦 Available Scripts\n\n| Command       | Description                   |\n| ------------- | ----------------------------- |\n| `npm run dev` | Run server with nodemon (dev) |\n| `npm start`   | Run server in production mode |\n| `npm test`    | Run test suite (if available) |\n\n---\n\n## 🛠️ Tech Stack\n\n- **Node.js** – JavaScript runtime\n- **Express.js** – Web framework\n- **MongoDB** – NoSQL database\n- **Mongoose** – ODM for MongoDB\n- **JWT** – Authentication tokens\n- **bcryptjs** – Password hashing\n- **cors** – Cross-origin resource sharing\n- **dotenv** – Environment variables\n- **helmet** – Security headers\n\n---\n\n## 🔐 API Features\n\n### Authentication \u0026 Users\n\n- User registration \u0026 login\n- JWT-based authentication\n- Protected routes\n- User profile management\n\n### Property Management\n\n- Create, read, update, delete properties\n- Property search and filtering\n- Image upload support\n- Property categories and types\n\n### Advanced Features\n\n- Favorites system\n- Property reviews and ratings\n- Advanced search with filters\n- Pagination support\n\n---\n\n## 🧭 Future Enhancements\n\n- 📊 Admin dashboard APIs\n- 📍 Location-based search\n- 💬 Real-time chat system\n- 📱 Push notifications\n- 💳 Payment integration\n- 📈 Analytics and reporting\n- 🔍 Advanced search with AI recommendations\n\n---\n\n## 👨‍💻 Development Team - Alpha\n\n| Role           | Name / GitHub Profile                                |\n| -------------- | ---------------------------------------------------- |\n| 🧠 Team Leader | [Arun Roy](https://github.com/ArunRoy404)            |\n| 🤝 Co-Leader   | [Md Rafiq Mia](https://github.com/rafiqmia65)        |\n| 👨‍💻 Core Member | [Abdul Al Roman](https://github.com/Abdulal-Roman09) |\n\n---\n\n## 🌿 Team Workflow \u0026 Branching Strategy\n\nTo maintain code quality and avoid conflicts, **every team member must work on feature branches**.\n\n### 🪄 Step-by-Step Development Guide:\n\n1. **Always start with the latest main branch:**\n\n   ```bash\n   git checkout main\n   git pull origin main\n   ```\n\n2. **Create a new feature branch:**\n\n   ```bash\n   git checkout -b feature/your-feature-name\n   # or\n   git checkout -b fix/issue-description\n   ```\n\n3. **Make your changes and commit:**\n\n   ```bash\n   git add .\n   git commit -m \"feat: add property search functionality\"\n   # Use conventional commit messages:\n   # feat: for new features\n   # fix: for bug fixes\n   # docs: for documentation\n   # style: for formatting\n   # refactor: for code refactoring\n   ```\n\n4. **Push your branch to GitHub:**\n\n   ```bash\n   git push origin feature/your-feature-name\n   ```\n\n5. **Create a Pull Request (PR):**\n\n   - Go to GitHub repository\n   - Create PR from your branch to `main`\n   - Add description of changes\n   - Request review from team members\n\n6. **After PR approval:**\n   - Team lead will merge the PR\n   - Delete the feature branch\n\n### 🔄 Sync Your Local Repository:\n\n```bash\n# Fetch latest changes from main\ngit fetch origin\n\n# Rebase your feature branch\ngit checkout feature/your-feature-name\ngit rebase origin/main\n\n# Resolve any conflicts if they occur\n```\n\n---\n\n## 🐛 Issue Reporting\n\nFound a bug? Please create an issue with:\n\n- Clear description of the problem\n- Steps to reproduce\n- Expected vs actual behavior\n- Screenshots if applicable\n\n---\n\n## 🌐 Project Links\n\n- **Backend Repository:** [https://github.com/rafiqmia65/zentro-server](https://github.com/rafiqmia65/zentro-server)\n- **Frontend Repository:** [https://github.com/ArunRoy404/zentro-client](https://github.com/ArunRoy404/zentro-client)\n- **API Deployment:** [https://zentro-server.vercel.app](https://zentro-server.vercel.app)\n- **Frontend Application:** [https://zentro-place.vercel.app](https://zentro-place.vercel.app)\n\n---\n\n## 📜 License\n\nThis project is licensed under the **ISC License**.\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Please:\n\n1. Fork the repository\n2. Create your feature branch\n3. Follow the coding standards\n4. Add tests if applicable\n5. Submit a pull request\n\n---\n\n💡 **Zentro** — Building the future of real estate technology, one line of code at a time.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafiqmia65%2Fzentro-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frafiqmia65%2Fzentro-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafiqmia65%2Fzentro-server/lists"}