{"id":18317666,"url":"https://github.com/datarohit/django-apartment-management","last_synced_at":"2025-07-24T17:11:51.843Z","repository":{"id":249681169,"uuid":"826608166","full_name":"DataRohit/Django-Apartment-Management","owner":"DataRohit","description":"Alpha Apartments is a comprehensive web portal designed to streamline apartment management and communication for tenants and non-tenants (technicians). The platform features user-friendly interfaces and robust backend support to ensure a seamless experience.","archived":false,"fork":false,"pushed_at":"2024-08-17T13:52:36.000Z","size":890,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-05T21:35:08.584Z","etag":null,"topics":["boto3","celery","celerybeat","django","django-filter","django-rest-framework","django-taggit","djangorestframework-simplejwt","djoser","drf-spectacular","flower","mailpit","minio","nginx","postgresql","redis","werkzeug"],"latest_commit_sha":null,"homepage":"","language":"Python","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/DataRohit.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"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}},"created_at":"2024-07-10T03:27:47.000Z","updated_at":"2025-02-19T04:59:18.000Z","dependencies_parsed_at":"2024-08-17T15:04:35.838Z","dependency_job_id":null,"html_url":"https://github.com/DataRohit/Django-Apartment-Management","commit_stats":null,"previous_names":["datarohit/django-apartment-management"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DataRohit/Django-Apartment-Management","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataRohit%2FDjango-Apartment-Management","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataRohit%2FDjango-Apartment-Management/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataRohit%2FDjango-Apartment-Management/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataRohit%2FDjango-Apartment-Management/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DataRohit","download_url":"https://codeload.github.com/DataRohit/Django-Apartment-Management/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataRohit%2FDjango-Apartment-Management/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266876455,"owners_count":23999250,"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-07-24T02:00:09.469Z","response_time":99,"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":["boto3","celery","celerybeat","django","django-filter","django-rest-framework","django-taggit","djangorestframework-simplejwt","djoser","drf-spectacular","flower","mailpit","minio","nginx","postgresql","redis","werkzeug"],"created_at":"2024-11-05T18:07:03.755Z","updated_at":"2025-07-24T17:11:51.814Z","avatar_url":"https://github.com/DataRohit.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **🏢 Alpha Apartments**\n\n**Alpha Apartments is a comprehensive web portal designed to streamline apartment management and communication for tenants and non-tenants (technicians). The platform features user-friendly interfaces and robust backend support to ensure a seamless experience.**\n\n## **🚀 Features**\n\n### **Authentication**\n- Google OAuth login\n- User email/password registration\n- User email/password login\n- User logout\n- JWT Cookie authentication\n\n### **Profiles**\n- View all tenants' profiles\n- View all non-tenants' (technicians) profiles\n- Get the logged-in user's profile\n- Update user profile\n- Upload image for user avatar\n\n### **Apartments**\n- Add apartment\n- View all apartments for the logged-in user\n\n### **Issues**\n- List all issues\n- List all assigned issues\n- View all issues created by the logged-in user\n- Create a new issue for a specified apartment\n- View details of an issue\n- Update an issue\n- Delete an issue\n\n### **Reports**\n- Create a new report for another tenant\n- View reports created about the logged-in user\n- **Note:** First report serves as a warning, and if a user accumulates 5 reports, the account will be deactivated\n\n### **Ratings**\n- Create a rating for non-tenants (technicians)\n- Display average rating for technicians\n\n### **Posts**\n- List all posts\n- Get list of posts by tags\n- Get top posts (most replies and content views)\n- List popular tags (most used tags)\n- Create a new post\n- List logged-in user's posts\n- View details of a post\n- Update a post\n- Bookmark a post\n- Unbookmark a post\n- View list of bookmarked posts\n- Add a reply to a post\n- Get all replies for a post\n- Upvote a post\n- Downvote a post\n\n## **🛠️ Tech Stack**\n\n### **Backend**\n- **Django**: Web framework\n- **Django REST Framework**: API development\n- **PostgreSQL**: Database\n- **Celery**: Asynchronous task queue\n- **Redis**: Message broker for Celery\n- **MinIO**: Object storage for static and media files\n\n### **Frontend**\n- **NextJS**: Frontend Web Framework\n- **Heroicons**: Icon Library\n- **TailwindCSS**: CSS Utility Class Package\n- **Redux**: Statement Management\n- **Zod**: Data and Schema Validation\n- **Axios**: HTTP Request and Response Package\n\n## **📦 Deployment**\n\n### **Docker**\n**The application is containerized using Docker for easy deployment and management. Below is a brief overview of the Docker setup:**\n\n- **Services**: \n  - `server`: Django backend\n  - `client`: NextJS frontend\n  - `postgres`: PostgreSQL database\n  - `minio`: MinIO object storage\n  - `mailpit`: Mail server for development\n  - `redis`: Redis message broker\n  - `celeryworker`: Celery worker\n  - `celerybeat`: Celery beat scheduler\n  - `flower`: Celery monitoring tool\n  - `nginx`: Reverse proxy server\n\n### **Volumes**\n- `local_postgres_data`\n- `local_postgres_data_backups`\n- `local_minio_data`\n- `local_mailpit_data`\n- `local_redis_data`\n- `local_logs_nginx`\n\n### **Networks**\n- `alpha_apartments_network`\n\n## **🔧 Setup and Installation**\n\n### **Prerequisites**\n- **Docker and Docker Compose installed on your system**\n\n### **Installation**\n1. **Clone the repository:**\n    ```bash\n    git clone https://github.com/DataRohit/Django-Apartment-Management.git\n    cd alpha-apartments\n    ```\n\n2. **Build and start the container:**\n    ```bash\n    docker-compose -f docker-compose.local.yml up --build\n    ```\n\n3. **Access the application:**\n    - **Backend:** `http://localhost:8080/api/v1/`\n    - **Frontend** `http://localhost:8080/`\n    - **Swagger Redoc:** `http://localhost:8080/api/v1/redoc/`\n    - **Swagger Playground:** `http://localhost:8080/api/v1/swagger/`\n    - **Minio:** `http://localhost:9090/`\n    - **Mailpit:** `http://localhost:8025/`\n    - **Flower:** `http://localhost:5555/`\n\n## **📝 License**\n**This project is licensed under the MIT License - see the [LICENSE](https://github.com/DataRohit/Django-Apartment-Management/blob/master/license) file for details.**\n\n## 📞 Contact\n**For any inquiries or support, please reach out to [rohit.vilas.ingole@gmail.com](mailto:rohit.vilas.ingole@gmail.com).**\n\n---\n\nMade with ❤️ by [Rohit Vilas Ingole](https://github.com/datarohit)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatarohit%2Fdjango-apartment-management","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatarohit%2Fdjango-apartment-management","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatarohit%2Fdjango-apartment-management/lists"}