{"id":33319423,"url":"https://github.com/albahranimazin-commits/mazoon-platform","last_synced_at":"2026-05-01T23:34:24.613Z","repository":{"id":323899273,"uuid":"1095131358","full_name":"albahranimazin-commits/mazoon-platform","owner":"albahranimazin-commits","description":"A comprehensive platform for every Omani","archived":false,"fork":false,"pushed_at":"2025-11-12T18:49:39.000Z","size":121,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-12T19:12:08.887Z","etag":null,"topics":["arabic","flask","oman","python","rest-api","sqlite"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/albahranimazin-commits.png","metadata":{"files":{"readme":"README .md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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-11-12T16:24:19.000Z","updated_at":"2025-11-12T18:49:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/albahranimazin-commits/mazoon-platform","commit_stats":null,"previous_names":["albahranimazin-commits/mazoon-platform"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/albahranimazin-commits/mazoon-platform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/albahranimazin-commits%2Fmazoon-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/albahranimazin-commits%2Fmazoon-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/albahranimazin-commits%2Fmazoon-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/albahranimazin-commits%2Fmazoon-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/albahranimazin-commits","download_url":"https://codeload.github.com/albahranimazin-commits/mazoon-platform/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/albahranimazin-commits%2Fmazoon-platform/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285319005,"owners_count":27151474,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-19T02:00:05.673Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["arabic","flask","oman","python","rest-api","sqlite"],"created_at":"2025-11-19T20:00:45.025Z","updated_at":"2025-11-19T20:02:54.611Z","avatar_url":"https://github.com/albahranimazin-commits.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌟 Mazoon Platform | منصة مزون\n\n\u003cdiv align=\"center\"\u003e\n\n![Mazoon Logo](https://via.placeholder.com/200x200/667eea/ffffff?text=مزون)\n\n**A Comprehensive Platform for Every Omani**  \n**منصة شاملة لكل عماني**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)\n[![Flask](https://img.shields.io/badge/flask-3.0.0-green.svg)](https://flask.palletsprojects.com/)\n[![Tests Passing](https://img.shields.io/badge/tests-17%2F17%20passing-brightgreen.svg)](test_all_crud.py)\n[![Made in Oman](https://img.shields.io/badge/made%20in-Oman%20🇴🇲-red.svg)](https://en.wikipedia.org/wiki/Oman)\n\n[Features](#-features) • [Quick Start](#-quick-start) • [API Docs](#-api-documentation) • [Contributing](#-contributing) • [License](#-license)\n\n\u003c/div\u003e\n\n---\n\n## 📋 Table of Contents | المحتويات\n\n- [About](#-about)\n- [Features](#-features)\n- [Quick Start](#-quick-start)\n- [Project Structure](#-project-structure)\n- [API Documentation](#-api-documentation)\n- [Database Schema](#-database-schema)\n- [Testing](#-testing)\n- [Frontend Integration](#-frontend-integration)\n- [Deployment](#-deployment)\n- [Contributing](#-contributing)\n- [License](#-license)\n- [Contact](#-contact)\n\n---\n\n## 🎯 About | نبذة\n\nMazoon (مزون) is a comprehensive web platform designed to serve the Omani community by bringing together news, events, jobs, tourism information, and much more in one unified platform.\n\nمزون هي منصة ويب شاملة مصممة لخدمة المجتمع العماني من خلال جمع الأخبار والفعاليات والوظائف ومعلومات السياحة والمزيد في منصة موحدة.\n\n### Why Mazoon? | لماذا مزون؟\n\n- 🇴🇲 **Built for Omanis** - Designed with Omani culture and needs in mind\n- 🌐 **Bilingual** - Full support for Arabic and English\n- 📱 **Modern** - RESTful API, responsive design, modern tech stack\n- 🔓 **Open Source** - Free to use, modify, and contribute\n- 📊 **Comprehensive** - 11 major systems in one platform\n\n---\n\n## ✨ Features | المميزات\n\n### 📰 **News System** | نظام الأخبار\n- 7 categories covering local, world, economy, sports, tech, health, and culture\n- Full CRUD operations\n- View tracking\n- Arabic and English support\n\n### 📅 **Events System** | نظام الفعاليات\n- 6 categories: festivals, exhibitions, workshops, sports, culture, education\n- Event registration\n- Calendar integration\n- Free and paid events\n\n### 💼 **Jobs System** | نظام التوظيف\n- 8 job categories\n- Company profiles\n- Application tracking\n- Salary ranges in OMR\n\n### 🏖️ **Tourism System** | نظام السياحة\n- Tourist attractions database\n- Reviews and ratings\n- Interactive maps\n- Opening hours and fees\n\n### 👨‍🍳 **Recipes System** | نظام الوصفات\n- Traditional Omani recipes\n- Step-by-step instructions\n- Ingredient lists\n- Cooking times\n\n### 🏢 **Business Directory** | دليل الأعمال\n- Local business listings\n- Reviews and ratings\n- Contact information\n- Categories and filters\n\n### 💬 **Community Forums** | المنتديات\n- Discussion topics\n- User engagement\n- Moderation system\n\n### 🔍 **Global Search** | البحث الشامل\n- Search across all content types\n- Fast and efficient\n- Relevant results\n\n### 📊 **Statistics** | الإحصائيات\n- Real-time platform stats\n- Usage analytics\n- Growth tracking\n\n---\n\n## 🚀 Quick Start | البدء السريع\n\n### Prerequisites | المتطلبات\n\n- Python 3.7 or higher\n- pip (Python package manager)\n- Modern web browser\n\n### Installation | التثبيت\n\n```bash\n# Clone the repository\ngit clone https://github.com/mazoon-platform/mazoon.git\ncd mazoon\n\n# Install dependencies\npip install -r requirements.txt\n\n# Initialize the database\npython init_database.py\n\n# Verify database\npython verify_database.py\n```\n\n### Running the API | تشغيل الواجهة البرمجية\n\n```bash\n# Start the API server\npython api.py\n\n# API will be available at:\n# http://localhost:5000\n```\n\n### Testing | الاختبار\n\n```bash\n# Option 1: Open interactive test interface\nopen test_api.html\n\n# Option 2: Run automated tests\npython test_all_crud.py\n\n# Option 3: Manual testing with curl\ncurl http://localhost:5000/health\n```\n\n---\n\n## 📁 Project Structure | هيكل المشروع\n\n```\nmazoon-platform/\n├── 📄 README.md                    # This file\n├── 📄 LICENSE                      # MIT License\n├── 📄 CONTRIBUTING.md              # Contribution guidelines\n├── 📄 CHANGELOG.md                 # Version history\n├── 📄 .gitignore                   # Git ignore rules\n│\n├── 📊 DATABASE/\n│   ├── mazoon_database.sql         # SQL schema (37 tables)\n│   ├── mazoon.db                   # SQLite database\n│   ├── init_database.py            # Database initialization\n│   └── verify_database.py          # Database verification\n│\n├── 🔌 API/\n│   ├── api.py                      # Main API server\n│   └── api_example.py              # API usage examples\n│\n├── ✅ TESTS/\n│   ├── test_api.html               # Interactive test UI\n│   └── test_all_crud.py            # Automated tests\n│\n├── 📚 DOCS/\n│   ├── API_TESTING_GUIDE.md        # API documentation\n│   ├── DATABASE_README.md          # Database guide\n│   ├── PROJECT_SUMMARY.md          # Project overview\n│   └── FILES_OVERVIEW.txt          # File descriptions\n│\n└── 📦 requirements.txt             # Python dependencies\n```\n\n---\n\n## 📖 API Documentation | توثيق الواجهة البرمجية\n\n### Base URL\n```\nhttp://localhost:5000/api\n```\n\n### Endpoints Summary\n\n#### News Endpoints\n```http\nGET    /api/news                    # List all news\nGET    /api/news/\u003cslug\u003e             # Get single article\nPOST   /api/news                    # Create article\nPUT    /api/news/\u003cid\u003e               # Update article\nDELETE /api/news/\u003cid\u003e               # Delete article\nGET    /api/news/categories         # Get categories\n```\n\n#### Events Endpoints\n```http\nGET    /api/events                  # List all events\nGET    /api/events/\u003cslug\u003e           # Get single event\nPOST   /api/events                  # Create event\nPUT    /api/events/\u003cid\u003e             # Update event\nDELETE /api/events/\u003cid\u003e             # Delete event\nGET    /api/events/categories       # Get categories\n```\n\n#### Jobs Endpoints\n```http\nGET    /api/jobs                    # List all jobs\nGET    /api/jobs/\u003cslug\u003e             # Get single job\nPOST   /api/jobs                    # Create job\nPUT    /api/jobs/\u003cid\u003e               # Update job\nDELETE /api/jobs/\u003cid\u003e               # Delete job\nGET    /api/jobs/categories         # Get categories\n```\n\n#### Other Endpoints\n```http\nGET    /api/search?q=query          # Global search\nGET    /api/stats                   # Platform statistics\nGET    /health                      # Health check\n```\n\n### Example Request\n\n```bash\n# Get all news\ncurl http://localhost:5000/api/news?limit=10\n\n# Create news article\ncurl -X POST http://localhost:5000/api/news \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"category_id\": 1,\n    \"title_ar\": \"خبر جديد\",\n    \"slug\": \"new-article\",\n    \"content_ar\": \"محتوى الخبر\"\n  }'\n```\n\n### Response Format\n\n```json\n{\n  \"success\": true,\n  \"message\": \"Success\",\n  \"data\": {\n    // Response data here\n  }\n}\n```\n\n📚 **Full API documentation:** [API_TESTING_GUIDE.md](API_TESTING_GUIDE.md)\n\n---\n\n## 🗄️ Database Schema | مخطط قاعدة البيانات\n\n### Overview | نظرة عامة\n\n- **37 Tables** across 11 major systems\n- **48+ Indexes** for optimized performance\n- **Automatic Triggers** for data integrity\n- **Full Arabic \u0026 English** support\n\n### Main Tables\n\n| System | Tables | Description |\n|--------|--------|-------------|\n| Users | 2 | User accounts and preferences |\n| News | 4 | Articles, categories, tags |\n| Events | 3 | Events, categories, registrations |\n| Jobs | 4 | Jobs, companies, categories, applications |\n| Marketplace | 3 | Listings, categories, images |\n| Tourism | 4 | Places, categories, images, reviews |\n| Recipes | 2 | Recipes, categories |\n| Education | 2 | Institutions, programs |\n| Business | 3 | Directory, categories, reviews |\n| Forums | 3 | Topics, replies, categories |\n| Weather | 2 | Locations, data |\n\n📚 **Full database documentation:** [DATABASE_README.md](DATABASE_README.md)\n\n---\n\n## ✅ Testing | الاختبار\n\n### Test Coverage\n\n- **17 Tests** covering all major operations\n- **100% Success Rate** on all CRUD operations\n- **Automated** and **Interactive** testing options\n\n### Test Results\n\n```\n✅ CREATE Operations - News, Events, Jobs\n✅ READ Operations - All entities with pagination\n✅ UPDATE Operations - All entities\n✅ DELETE Operations - All entities\n✅ CATEGORIES - All entity types\n✅ SEARCH - Global search functionality\n✅ STATISTICS - Platform-wide stats\n\n🎉 17/17 Tests Passed\n```\n\n### Running Tests\n\n```bash\n# Interactive web interface\nopen test_api.html\n\n# Automated test suite\npython test_all_crud.py\n\n# Database verification\npython verify_database.py\n```\n\n---\n\n## 💻 Frontend Integration | ربط الواجهة الأمامية\n\n### React Example\n\n```javascript\nimport axios from 'axios';\n\nconst API_BASE = 'http://localhost:5000/api';\n\n// Fetch news\nconst fetchNews = async () =\u003e {\n  const response = await axios.get(`${API_BASE}/news`);\n  return response.data.data.articles;\n};\n\n// Create news\nconst createNews = async (newsData) =\u003e {\n  const response = await axios.post(`${API_BASE}/news`, newsData);\n  return response.data;\n};\n```\n\n### Vue.js Example\n\n```javascript\n// In your Vue component\nexport default {\n  data() {\n    return {\n      news: [],\n      apiBase: 'http://localhost:5000/api'\n    }\n  },\n  async mounted() {\n    const response = await fetch(`${this.apiBase}/news`);\n    const data = await response.json();\n    this.news = data.data.articles;\n  }\n}\n```\n\n### Vanilla JavaScript\n\n```javascript\n// Fetch news\nfetch('http://localhost:5000/api/news')\n  .then(res =\u003e res.json())\n  .then(data =\u003e {\n    const articles = data.data.articles;\n    // Display articles\n  });\n```\n\n---\n\n## 🚀 Deployment | النشر\n\n### Development\n\n```bash\npython api.py\n```\n\n### Production\n\n```bash\n# Using Gunicorn\npip install gunicorn\ngunicorn -w 4 -b 0.0.0.0:5000 api:app\n\n# Using uWSGI\npip install uwsgi\nuwsgi --http :5000 --wsgi-file api.py --callable app\n```\n\n### Docker (Coming Soon)\n\n```bash\ndocker build -t mazoon-api .\ndocker run -p 5000:5000 mazoon-api\n```\n\n### Environment Variables\n\n```bash\nexport FLASK_ENV=production\nexport DATABASE_URL=sqlite:///mazoon.db\nexport SECRET_KEY=your-secret-key\n```\n\n---\n\n## 🤝 Contributing | المساهمة\n\nWe welcome contributions from the community! Please read our [Contributing Guidelines](CONTRIBUTING.md) before submitting pull requests.\n\nنرحب بالمساهمات من المجتمع! يرجى قراءة [إرشادات المساهمة](CONTRIBUTING.md) قبل تقديم طلبات السحب.\n\n### How to Contribute\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n### Areas for Contribution\n\n- 🔐 Authentication \u0026 Authorization\n- 📸 Image upload\n- 🔔 Real-time notifications\n- 📊 Analytics dashboard\n- 🌐 Internationalization\n- 📱 Mobile optimization\n- 🐛 Bug fixes\n- 📚 Documentation\n- ✅ Tests\n\n---\n\n## 📄 License | الترخيص\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\nهذا المشروع مرخص بموجب ترخيص MIT - راجع ملف [LICENSE](LICENSE) للحصول على التفاصيل.\n\n---\n\n## 📞 Contact | التواصل\n\n- **Website:** https://mazoon.om\n- **Email:** support@mazoon.om\n- **GitHub:** https://github.com/mazoon-platform/mazoon\n- **Issues:** https://github.com/mazoon-platform/mazoon/issues\n\n---\n\n## 🙏 Acknowledgments | شكر وتقدير\n\n- Thanks to all contributors who help make Mazoon better\n- Built with ♥ for the Omani community\n- Inspired by the vision of a connected Oman\n\n---\n\n## 📊 Project Statistics | إحصائيات المشروع\n\n- **37** Database Tables\n- **17** API Endpoints\n- **11** Major Systems\n- **100%** Test Coverage\n- **2** Languages (Arabic \u0026 English)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ♥ in Oman | صُنع بكل ♥ في عُمان**\n\n⭐ Star us on GitHub if you find this project useful!\n\n[⬆ Back to Top](#-mazoon-platform--منصة-مزون)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falbahranimazin-commits%2Fmazoon-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falbahranimazin-commits%2Fmazoon-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falbahranimazin-commits%2Fmazoon-platform/lists"}