|
1 | | -# CBRMS |
| 1 | +# CBRMS - Community-Based Resource Management System |
2 | 2 | ## Overview |
3 | 3 |
|
4 | | -<p align="center"><a href="https://laravel.com" target="_blank"><img src="https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg" width="400" alt="Laravel Logo"></a></p> |
| 4 | +A comprehensive Community-Based Resource Management System (CBRMS) built with Laravel framework. This system facilitates efficient management of community resources, member coordination, and administrative oversight for community-driven organizations and local governance. |
5 | 5 |
|
6 | | -<p align="center"> |
7 | | -<a href="https://github.com/laravel/framework/actions"><img src="https://github.com/laravel/framework/workflows/tests/badge.svg" alt="Build Status"></a> |
8 | | -<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/dt/laravel/framework" alt="Total Downloads"></a> |
| 6 | +## ✨ Key Features |
| 7 | + |
| 8 | +- **Resource Management:** Track and manage community assets, facilities, and equipment |
| 9 | +- **Member Directory:** Comprehensive community member database and profiles |
| 10 | +- **Event Coordination:** Community event planning, scheduling, and management |
| 11 | +- **Financial Tracking:** Budget management and community fund administration |
| 12 | +- **Communication Hub:** Internal messaging and community announcements |
| 13 | +- **Reporting System:** Generate reports on resource usage and community activities |
| 14 | +- **Role-Based Access:** Multi-level user permissions for different community roles |
| 15 | +- **Document Management:** Store and organize community documents and policies |
| 16 | + |
| 17 | +## 🛠️ Technology Stack |
| 18 | + |
| 19 | +### Primary Technologies |
| 20 | +- **Framework:** Laravel (PHP Framework) |
| 21 | +- **Backend:** PHP (93.9%) |
| 22 | +- **Frontend:** CSS (3.0%), JavaScript (2.4%), Blade (0.3%) |
| 23 | +- **Database:** MySQL with Laravel Eloquent ORM |
| 24 | +- **Additional:** Hack (0.4%) for enhanced functionality |
| 25 | + |
| 26 | +### Laravel Architecture |
| 27 | +- **MVC Pattern:** Model-View-Controller architecture |
| 28 | +- **Eloquent ORM:** Database relationships and migrations |
| 29 | +- **Blade Templating:** Dynamic view rendering |
| 30 | +- **RESTful APIs:** Clean API structure for data operations |
| 31 | +- **Authentication:** Multi-role authentication system |
| 32 | + |
| 33 | +## 📂 Project Information |
| 34 | + |
| 35 | +### Repository Details |
| 36 | +- **GitHub:** https://github.com/syed-reza98/CBRMS |
| 37 | +- **Primary Language:** PHP |
| 38 | +- **Languages:** PHP (93.9%), CSS (3.0%), JavaScript (2.4%), Hack (0.4%), Blade (0.3%) |
| 39 | +- **Last Updated:** 26/12/2023 |
| 40 | +- **Repository Size:** ~81MB |
| 41 | + |
| 42 | +### Project Status |
| 43 | +- **Status:** ✅ Active |
| 44 | +- **Visibility:** 🌐 Public |
| 45 | +- **Category:** Community Management System |
| 46 | +- **Tags:** #laravel #php #community-management #resource-management #web-application |
| 47 | + |
| 48 | +## 🚀 Getting Started |
| 49 | + |
| 50 | +### Prerequisites |
| 51 | +- PHP 8.0 or higher |
| 52 | +- Composer for dependency management |
| 53 | +- MySQL 5.7 or higher |
| 54 | +- Web server (Apache/Nginx) |
| 55 | +- Node.js and npm for frontend assets |
| 56 | + |
| 57 | +### Installation |
| 58 | + |
| 59 | +1. **Clone the repository** |
| 60 | + ```bash |
| 61 | + git clone https://github.com/syed-reza98/CBRMS.git |
| 62 | + cd CBRMS |
| 63 | + ``` |
| 64 | + |
| 65 | +2. **Install dependencies** |
| 66 | + ```bash |
| 67 | + composer install |
| 68 | + npm install |
| 69 | + ``` |
| 70 | + |
| 71 | +3. **Environment configuration** |
| 72 | + ```bash |
| 73 | + cp .env.example .env |
| 74 | + php artisan key:generate |
| 75 | + ``` |
| 76 | + |
| 77 | +4. **Database setup** |
| 78 | + ```bash |
| 79 | + # Configure database credentials in .env |
| 80 | + php artisan migrate |
| 81 | + php artisan db:seed |
| 82 | + ``` |
| 83 | + |
| 84 | +5. **Compile frontend assets** |
| 85 | + ```bash |
| 86 | + npm run dev |
| 87 | + ``` |
| 88 | + |
| 89 | +6. **Run the application** |
| 90 | + ```bash |
| 91 | + php artisan serve |
| 92 | + ``` |
| 93 | + |
| 94 | +## 🏘️ Community Management Features |
| 95 | + |
| 96 | +### Resource Management |
| 97 | +- **Asset Inventory:** Track community equipment, facilities, and resources |
| 98 | +- **Booking System:** Schedule and manage resource reservations |
| 99 | +- **Maintenance Logs:** Record maintenance activities and schedules |
| 100 | +- **Usage Analytics:** Monitor resource utilization patterns |
| 101 | + |
| 102 | +### Member Management |
| 103 | +- **Member Profiles:** Comprehensive member information and contact details |
| 104 | +- **Role Assignment:** Define community roles and responsibilities |
| 105 | +- **Skill Directory:** Track member skills and expertise for project matching |
| 106 | +- **Communication Preferences:** Manage member notification settings |
| 107 | + |
| 108 | +### Administrative Tools |
| 109 | +- **Dashboard Analytics:** Overview of community activities and metrics |
| 110 | +- **Financial Management:** Track community funds, expenses, and budgets |
| 111 | +- **Event Calendar:** Community event planning and coordination |
| 112 | +- **Document Library:** Centralized storage for community documents |
| 113 | + |
| 114 | +## 👥 User Roles & Permissions |
| 115 | + |
| 116 | +### Community Roles |
| 117 | +- **Administrator:** Full system access and community oversight |
| 118 | +- **Coordinator:** Manage events, resources, and member coordination |
| 119 | +- **Member:** Access to community resources and participation in activities |
| 120 | +- **Guest:** Limited access to public community information |
| 121 | + |
| 122 | +### Permission System |
| 123 | +- **Resource Access:** Role-based resource booking and management |
| 124 | +- **Financial Control:** Restricted access to financial data and transactions |
| 125 | +- **Administrative Functions:** Limited to authorized community leaders |
| 126 | +- **Communication Rights:** Controlled messaging and announcement capabilities |
| 127 | + |
| 128 | +## 👥 Contributors |
| 129 | + |
| 130 | +- **Lead Developer:** [Syed Salman Reza](https://github.com/syed-reza98) |
| 131 | +- **Community Input:** Based on real community management requirements |
| 132 | +- **Framework:** Laravel by Taylor Otwell |
| 133 | + |
| 134 | +## 📄 Documentation & Links |
| 135 | + |
| 136 | +- **Repository:** [GitHub Repository](https://github.com/syed-reza98/CBRMS) |
| 137 | +- **Laravel Documentation:** [Official Laravel Docs](https://laravel.com/docs) |
| 138 | +- **Community Management:** Best practices for community resource coordination |
| 139 | + |
| 140 | +## 🤝 Contributing |
| 141 | + |
| 142 | +We welcome contributions to improve community management features: |
| 143 | + |
| 144 | +1. Fork the repository |
| 145 | +2. Create a feature branch for community enhancements |
| 146 | +3. Follow Laravel coding standards |
| 147 | +4. Test thoroughly with community use cases |
| 148 | +5. Submit pull request with detailed description |
| 149 | + |
| 150 | +Areas for contribution: |
| 151 | +- Enhanced reporting features |
| 152 | +- Mobile-responsive improvements |
| 153 | +- Integration with external community tools |
| 154 | +- Advanced analytics and insights |
| 155 | + |
| 156 | +--- |
| 157 | + |
| 158 | +**Created:** December 26, 2023 |
| 159 | +**Last Updated:** September 30, 2025 |
| 160 | +**Focus:** Community Resource Management |
9 | 161 |
|
10 | 162 | ## Code & Repository |
11 | 163 |
|
|
0 commit comments