{"id":48924022,"url":"https://github.com/aadhar41/society-services","last_synced_at":"2026-04-17T06:02:33.606Z","repository":{"id":233724227,"uuid":"612508152","full_name":"aadhar41/society-services","owner":"aadhar41","description":"This repository contains the source code for a society services project built with Laravel PHP. The project aims to provide a platform for managing various services within a society or residential complex.","archived":false,"fork":false,"pushed_at":"2026-04-12T04:07:55.000Z","size":8151,"stargazers_count":2,"open_issues_count":10,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-04-12T06:11:32.417Z","etag":null,"topics":["blade-template","css3","git","github","html5","laravel","laravel12","mysql","npm","php","vite"],"latest_commit_sha":null,"homepage":"","language":"Blade","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aadhar41.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2023-03-11T06:32:29.000Z","updated_at":"2026-03-20T15:46:27.000Z","dependencies_parsed_at":"2024-04-17T08:00:10.396Z","dependency_job_id":"d6462804-acfc-495c-8d39-18336b012083","html_url":"https://github.com/aadhar41/society-services","commit_stats":null,"previous_names":["aadhar41/society-accounting","aadhar41/society-services"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/aadhar41/society-services","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aadhar41%2Fsociety-services","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aadhar41%2Fsociety-services/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aadhar41%2Fsociety-services/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aadhar41%2Fsociety-services/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aadhar41","download_url":"https://codeload.github.com/aadhar41/society-services/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aadhar41%2Fsociety-services/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31917372,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"online","status_checked_at":"2026-04-17T02:00:06.879Z","response_time":62,"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":["blade-template","css3","git","github","html5","laravel","laravel12","mysql","npm","php","vite"],"created_at":"2026-04-17T06:02:31.823Z","updated_at":"2026-04-17T06:02:33.594Z","avatar_url":"https://github.com/aadhar41.png","language":"Blade","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Society Accounting Management System\n\n![Laravel](https://img.shields.io/badge/laravel-%23FF2D20.svg?style=for-the-badge\u0026logo=laravel\u0026logoColor=white)\n![PHP](https://img.shields.io/badge/php-%23777BB4.svg?style=for-the-badge\u0026logo=php\u0026logoColor=white)\n![PostgreSQL](https://img.shields.io/badge/postgresql-%23316192.svg?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white)\n![AdminLTE](https://img.shields.io/badge/AdminLTE-%234285F4.svg?style=for-the-badge\u0026logo=adminlte\u0026logoColor=white)\n\n## 🖼️ Screenshots\n\n| Comprehensive ERP Dashboard | Society Management | Block Management |\n| :---: | :---: | :---: |\n| ![Dashboard](public/images/screens/dashboard.png) | ![Society](public/images/screens/societies.png) | ![Block](public/images/screens/blocks.png) |\n| *Modern Dashboard UI* | *Society List View* | *Block Management View* |\n\n| Plot Management | Flat Management | Maintenance Records |\n| :---: | :---: | :---: |\n| ![Plot](public/images/screens/plots.png) | ![Flat](public/images/screens/flats.png) | ![Maintenance](public/images/screens/maintenance.png) |\n| *Plot Tracking* | *Unit \u0026 Resident View* | *Billing \u0026 Payments* |\n\n| Maintenance Reports (Grid) | Outstanding Report |\n| :---: | :---: |\n| ![Grid](public/images/screens/report_grid.png) | ![Outstanding](public/images/screens/report_outstanding.png) |\n| *Financial Grid Overview* | *Defaulter Tracking* |\n\n---\n\n## 🚀 Overview\n\n**Society Accounting Management System (SAMS)** is a highly scalable, multi-tenant SaaS-based Society ERP. Built with Domain-Driven Design (DDD) principles, it provides robust accounting, automated billing, and a seamless resident experience.\n\n---\n\n## ✨ Key Features (ERP Foundation)\n\n✅ **Multi-Tenancy \u0026 Security**\n\n- Shared schema isolation using `society_id` scope.\n- Global `SocietyScope` with automated filtering.\n- JWT/Sanctum based API authentication.\n\n✅ **Professional Accounting Engine**\n\n- Double-entry bookkeeping system (balanced journal entries).\n- Dynamic Chart of Accounts tailored for Indian Societies.\n- Automated generation of Trial Balance, Balance Sheet, and P\u0026L.\n\n✅ **Automated Billing \u0026 Recovery**\n\n- Group-based charge generation (Maintenance, Sinking Fund, etc.).\n- Recurring invoice generation with balance tracking.\n- Automated late fee calculation and defaulter reports.\n\n✅ **Society Infrastructure Management**\n\n- Modular setup for Wings, Floors, Units, and Parking Slots.\n- Comprehensive Member \u0026 Resident lifecycle management.\n- Visitor management with OTP verification.\n\n---\n\n## 🛠️ Tech Stack\n\n- **Backend:** Laravel 12.x (PHP 8.2+)\n- **Database:** PostgreSQL (Core ERP)\n- **Frontend:** React + Tailwind CSS (V2) / AdminLTE (Legacy)\n- **Cache/Queue:** Redis\n- **Auth:** Sanctum / JWT\n\n---\n\n## 📦 Localhost Installation\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/aadhar41/society-services.git\n   cd society-services\n   ```\n\n2. **Setup Dependencies:**\n\n   ```bash\n   composer install\n   npm install\n   ```\n\n3. **Configure Environment:**\n   - Copy `.env.example` to `.env`\n   - Set legacy `DB_CONNECTION=pgsql` (recommended).\n   - Generate key: `php artisan key:generate`\n\n4. **Initialize Database \u0026 Demo Data:**\n\n   ```bash\n   php artisan migrate:fresh --seed\n   ```\n\n5. **Start Dev Server:**\n\n   ```bash\n   php artisan serve\n   ```\n\n---\n\n## 🎯 Usage\n\n### Basic Usage\n\n#### Creating a Society\n\n1. Navigate to the \"Societies\" section in the admin panel\n2. Click \"Add Record\" to create a new society\n3. Fill in the required details:\n   - Name\n   - Address\n   - Contact information\n   - Description\n   - Location details (country, state, city)\n\n```php\n// Example of creating a society via API\n$response = Http::post('/api/societies', [\n    'name' =\u003e 'Green Acres Society',\n    'address' =\u003e '123 Main Street, City',\n    'contact' =\u003e '1234567890',\n    'country' =\u003e 'Country ID',\n    'state' =\u003e 'State ID',\n    'city' =\u003e 'City ID',\n    'description' =\u003e 'A beautiful residential complex'\n]);\n```\n\n#### Managing Blocks\n\n1. Select a society from the dropdown\n2. Click \"Add Record\" to create a new block\n3. Enter block details:\n   - Name\n   - Total flats\n   - Description\n   - Status\n\n```php\n// Example of creating a block via API\n$response = Http::post('/api/societies/{society_id}/blocks', [\n    'name' =\u003e 'Block A',\n    'total_flats' =\u003e 50,\n    'description' =\u003e 'Main residential block'\n]);\n```\n\n#### Recording Maintenance Payments\n\n1. Navigate to the \"Maintenance\" section\n2. Select the appropriate flat\n3. Enter maintenance details:\n   - Type (monthly, lift, donation, etc.)\n   - Date\n   - Amount\n   - Description\n   - Attachments (if any)\n\n```php\n// Example of creating a maintenance record via API\n$response = Http::post('/api/societies/{society_id}/blocks/{block_id}/flats/{flat_id}/maintenance', [\n    'type' =\u003e 'monthly',\n    'date' =\u003e '2023-05-15',\n    'year' =\u003e 2023,\n    'month' =\u003e 5,\n    'amount' =\u003e 5000,\n    'description' =\u003e 'Monthly maintenance charges',\n    'attachments' =\u003e 'path/to/receipt.pdf'\n]);\n```\n\n### Advanced Usage\n\n#### Customizing the UI\n\n1. Edit the SCSS files in `resources/sass/app.scss`\n2. Modify the layout in `resources/views/layouts/app.blade.php`\n3. Update the JavaScript logic in `resources/js/app.js`\n\n#### Extending Functionality\n\n1. Create new controllers and models following the existing pattern\n2. Add new routes in `routes/web.php` and `routes/api.php`\n3. Create new views in the `resources/views` directory\n4. Add new migrations using `php artisan make:migration`\n\n```bash\nphp artisan make:controller ComplaintController --api\n```\n\n#### API Integration\n\nThe system provides a comprehensive API for mobile applications and other integrations:\n\n```php\n// Example of API authentication\n$response = Http::withHeaders([\n    'Authorization' =\u003e 'Bearer ' . $token\n])-\u003eget('/api/societies');\n```\n\n---\n\n## 📁 Project Structure\n\n```bash\nsociety-accounting/\n├── app/                  # Application source code\n│   ├── Http/             # Controllers, Middleware, etc.\n│   ├── Models/           # Eloquent models\n│   ├── Providers/        # Service providers\n│   ├── Repositories/     # Repository interfaces and implementations\n│   └── ...\n├── config/              # Configuration files\n├── database/            # Database migrations and seeders\n├── public/              # Publicly accessible files\n├── resources/           # Views, languages, assets\n│   ├── js/               # JavaScript files\n│   ├── sass/            # SCSS stylesheets\n│   └── views/           # Blade templates\n├── routes/              # Route definitions\n├── tests/               # Test cases\n├── vendor/              # Composer dependencies\n├── .env                 # Environment configuration\n├── .gitignore           # Git ignore rules\n├── artisan              # Laravel artisan CLI\n├── composer.json        # PHP dependencies\n├── package.json         # JavaScript dependencies\n└── README.md            # This file\n```\n\n---\n\n## 🔧 Configuration\n\n### Environment Variables\n\nCopy `.env.example` to `.env` and configure your environment:\n\n```env\n# Application settings\nAPP_NAME=Society Accounting\nAPP_ENV=local\nAPP_KEY=your-app-key\nAPP_DEBUG=true\nAPP_URL=http://localhost\n\n# Database settings\nDB_CONNECTION=pgsql\nDB_HOST=127.0.0.1\nDB_PORT=5432\nDB_DATABASE=your_database\nDB_USERNAME=your_username\nDB_PASSWORD=your_password\n\n# Mail settings\nMAIL_MAILER=smtp\nMAIL_HOST=mailhog\nMAIL_PORT=1025\n\n# Caching\nCACHE_DRIVER=file\n\n# Session\nSESSION_DRIVER=file\nSESSION_LIFETIME=120\n\n# Authentication\nSANCTUM_STATEFUL_DOMAINS=localhost\n```\n\n### Customization Options\n\n1. **Change the Admin Panel Theme:**\n   Edit the `resources/sass/app.scss` file to customize colors and styles\n\n2. **Modify User Roles and Permissions:**\n   Update the `app/Policies` directory and adjust the middleware in `app/Http/Kernel.php`\n\n3. **Add New Features:**\n   Follow the existing pattern to add new models, controllers, and views\n\n4. **Configure Payment Gateways:**\n   Edit the payment-related configurations in the `config/services.php` file\n\n---\n\n## 📝 License\n\n### PROPRIETARY SOFTWARE - ALL RIGHTS RESERVED\n\nThis software and its source code are the exclusive property of **Aadhar Gaur**.\n\n- **NO UNAUTHORIZED USE:** No person or organization may use, copy, modify, or distribute this software without express written permission or a valid purchase agreement.\n- **COMMERCIAL LICENSING:** For purchasing a license or commercial inquiries, contact: \u003caadhar.gaur@example.com\u003e.\n\n---\n\n## 🎨 Design System\n\nOur V2 architecture utilizes a premium design system with dynamic themes and sleek micro-animations for a high-end SaaS experience.\n\n---\n\n## 🤝 Contributing\n\nThis is a proprietary repository. Contributions are only accepted from authorized team members. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n---\n\n## 👥 Authors \u0026 Contributors\n\n- **Aadhar Gaur** ([@aadhar41](https://github.com/aadhar41)) - Lead Architect \u0026 Developer\n\n---\n\n## 🐛 Issues \u0026 Support\n\n### Reporting Issues\n\nIf you encounter any problems or have feature requests, please:\n\n1. **Check existing issues** to avoid duplicates\n2. **Create a new issue** with:\n    - Clear description of the problem\n    - Steps to reproduce\n    - Expected behavior\n    - Your environment details\n    - Any relevant error messages\n\n### Getting Help\n\n- **Community Support**: Join our [Discussion Forum](link-to-forum)\n- **Official Documentation**: \u003chttps://your-docs-url.com\u003e\n- **Email Support**: \u003csupport@societyaccounting.com\u003e\n\n### FAQ\n\n**Q: How do I reset my password?**\nA: Visit the `/forgot-password` route and follow the instructions sent to your email.\n\n**Q: Can I use this system for commercial purposes?**\nA: This is a proprietary system. Commercial use requires a valid license agreement from the author.\n\n**Q: Does this system support multi-tenancy?**\nA: Yes, each society can be considered a separate tenant with its own data.\n\n**Q: Can I customize the UI?**\nA: Absolutely! The system uses AdminLTE and SCSS, making it easy to customize the appearance.\n\n---\n\n## 🗺️ Roadmap (V2)\n\n- [ ] Multi-Gateway Payment integration (Razorpay/Stripe)\n- [ ] Mobile Resident App (Flutter/React Native)\n- [ ] AI-driven Cashflow Forecasting\n- [ ] IoT Integration for Smart Metering\n\n---\n\n## 🚀 Getting Started\n\nReady to get started with the Society Accounting Management System? Follow these steps:\n\n1. **Install the system** as described above\n2. **Set up your database** with the provided migrations\n3. **Customize the system** to fit your specific needs\n4. **Start managing your society** efficiently!\n\nJoin our community of users and developers to share experiences, ask questions, and contribute to the project's growth. Together, we can make society management easier and more efficient for everyone!\n\nThank you for choosing the **Society Accounting Management System**. We are committed to building the future of residential community management.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faadhar41%2Fsociety-services","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faadhar41%2Fsociety-services","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faadhar41%2Fsociety-services/lists"}