{"id":26484589,"url":"https://github.com/hossein-falah/task-management","last_synced_at":"2026-04-14T04:02:30.206Z","repository":{"id":283267437,"uuid":"950853091","full_name":"Hossein-Falah/task-management","owner":"Hossein-Falah","description":"A powerful and scalable task management system built with NestJS, TypeORM, and MySql. This API allows users to manage their tasks efficiently, with features like authentication, task creation, updates, deletions, and pagination.","archived":false,"fork":false,"pushed_at":"2025-03-21T22:55:23.000Z","size":9917,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-01T01:40:10.153Z","etag":null,"topics":["jwt","mysql","nestjs","typeorm"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/Hossein-Falah.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}},"created_at":"2025-03-18T19:29:56.000Z","updated_at":"2025-04-28T12:29:48.000Z","dependencies_parsed_at":"2025-03-19T11:38:29.506Z","dependency_job_id":null,"html_url":"https://github.com/Hossein-Falah/task-management","commit_stats":null,"previous_names":["hossein-falah/task-management"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Hossein-Falah/task-management","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hossein-Falah%2Ftask-management","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hossein-Falah%2Ftask-management/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hossein-Falah%2Ftask-management/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hossein-Falah%2Ftask-management/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hossein-Falah","download_url":"https://codeload.github.com/Hossein-Falah/task-management/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hossein-Falah%2Ftask-management/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31781292,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: 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":["jwt","mysql","nestjs","typeorm"],"created_at":"2025-03-20T05:32:04.780Z","updated_at":"2026-04-14T04:02:30.189Z","avatar_url":"https://github.com/Hossein-Falah.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Task Management API\n\nA powerful and scalable task management system built with **NestJS**, **TypeORM**, and **MySql**. This API allows users to manage their tasks efficiently, with features like authentication, task creation, updates, deletions, and pagination.\n\n## Features\n\n- **Authentication \u0026 Authorization**: Secure user registration and login with JWT authentication.\n- **User Management**: Role-based access control, profile management, and admin functionalities.\n- **Task Management**:\n  - Create, read, update, and delete personal tasks.\n  - Attachment upload support with secure file storage.\n  - Ownership validation to prevent unauthorized modifications.\n- **Pagination**: Optimized pagination for retrieving users and tasks.\n\n## Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/Hossein-Falah/task-management.git\n   ```\n2. Navigate to the project directory:\n   ```bash\n   cd task-management\n   ```\n3. Install dependencies:\n   ```bash\n   npm install\n   ```\n4. Create a **.env** file and configure your environment variables:\n   ```env\n    APP_PORT=3000\n    DOC_PATH=/api/docs\n    APP_URL=http://localhost:3000\n\n    DB_PORT=3306\n    DB_HOST=localhost\n    DB_NAME=task_management\n    DB_USERNAME=root\n    DB_PASSWORD=******\n\n    JWT_ACCESS_SECRET=your-secret-key\n    JWT_ACCESS_EXPIRES_IN=1h\n    JWT_REFRESH_SECRET=your-secret-key\n    JWT_REFRESH_EXPIRES_IN=7d\n   \n   ```\n\n6. Start the application:\n   ```bash\n   npm run start:dev\n   ```\n\n## Preview Task Management Api\n\n![screen shot](./screencapture-min.png)\n\n## API Documentation\n\nSwagger API documentation is available at:\n```\nhttp://localhost:3000/api/docs\n```\n\n## Usage\n\n- **User Registration \u0026 Authentication**: Register new users and generate access tokens.\n- **Task CRUD Operations**:\n  - `POST /tasks` - Create a new task\n  - `GET /tasks` - Retrieve user's tasks with pagination\n  - `GET /tasks/:id` - Retrieve a specific task (ownership validated)\n  - `PUT /tasks/:id` - Update a task\n  - `DELETE /tasks/:id` - Delete a task\n\n## Contributing\n\n1. Fork the repository.\n2. Create a new feature branch: `git checkout -b feature/your-feature`\n3. Commit your changes: `git commit -m 'feat: add new feature'`\n4. Push the branch: `git push origin feature/your-feature`\n5. Open a pull request.\n\n## License\n\nThis project is licensed under the **MIT License**. Feel free to use and modify it.\n\n## Author\n\nDeveloped by **Hossein-Falah** 🚀\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhossein-falah%2Ftask-management","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhossein-falah%2Ftask-management","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhossein-falah%2Ftask-management/lists"}