{"id":30450073,"url":"https://github.com/hq969/nexcom-cloud-erp","last_synced_at":"2026-04-09T02:01:51.231Z","repository":{"id":306039935,"uuid":"1024792364","full_name":"hq969/nexcom-cloud-erp","owner":"hq969","description":"NEXCOM Cloud ERP is a scalable, modular enterprise resource planning system tailored for modern organizations. It leverages microservices architecture using Node.js, enabling streamlined operations across Authentication, Inventory, Finance, HR, and centralized API Gateway services.","archived":false,"fork":false,"pushed_at":"2025-07-23T10:33:03.000Z","size":68,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-02T15:01:31.078Z","etag":null,"topics":["docker-compose","express-js","mongodb","node-js"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/hq969.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,"zenodo":null}},"created_at":"2025-07-23T08:55:09.000Z","updated_at":"2025-07-26T09:47:56.000Z","dependencies_parsed_at":"2025-07-23T10:37:10.710Z","dependency_job_id":"4e3d8bb3-ad13-4a0b-9980-a9fa1a8d9eca","html_url":"https://github.com/hq969/nexcom-cloud-erp","commit_stats":null,"previous_names":["hq969/nexcom-cloud-erp"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/hq969/nexcom-cloud-erp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hq969%2Fnexcom-cloud-erp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hq969%2Fnexcom-cloud-erp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hq969%2Fnexcom-cloud-erp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hq969%2Fnexcom-cloud-erp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hq969","download_url":"https://codeload.github.com/hq969/nexcom-cloud-erp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hq969%2Fnexcom-cloud-erp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273992821,"owners_count":25203790,"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-09-07T02:00:09.463Z","response_time":67,"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":["docker-compose","express-js","mongodb","node-js"],"created_at":"2025-08-23T13:23:25.193Z","updated_at":"2025-10-08T01:04:37.127Z","avatar_url":"https://github.com/hq969.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NEXCOM Cloud ERP System 🚀\n\nA modular, scalable, and cloud-native ERP solution designed for modern enterprises and federal deployments. Built with a microservices architecture using Node.js, Docker, and RESTful APIs, this system handles everything from user authentication to inventory, finance, and HR processes.\n\n---\n\n## 📁 Project Structure\n\n```\n\nnexcom-cloud-erp/\n├── services/\n│   ├── auth-service/          # User auth, login, roles\n│   ├── inventory-service/     # Inventory management\n│   ├── finance-service/       # Finance \u0026 billing\n│   ├── hr-service/            # HR, payroll, attendance\n│   └── gateway/               # API Gateway / routing\n├── shared/\n│   └── utils/                 # Common configs, logging\n├── docker-compose.yml         # Docker multi-container orchestration\n├── .env                       # Environment variables\n└── README.md                  # Project overview \u0026 instructions\n\n````\n\n---\n\n## 🧠 Core Features\n\n- **User Authentication \u0026 Roles (JWT-based)**\n- **Inventory Tracking \u0026 Management**\n- **Finance Transactions \u0026 Billing Logic**\n- **HR Operations: Employee Records \u0026 Payroll**\n- **Microservice Architecture with Service Discovery**\n- **RESTful APIs with Express.js**\n- **Centralized Logging, Dockerized Services**\n\n---\n\n## 🛠️ Tech Stack\n\n| Layer            | Tech                                    |\n|------------------|------------------------------------------|\n| Language         | JavaScript (Node.js)                     |\n| API Framework    | Express.js                               |\n| Authentication   | JWT, Bcrypt                              |\n| Database         | MongoDB (Mongoose ORM)                   |\n| Containerization | Docker, Docker Compose                   |\n| Gateway          | Express-based API Gateway                |\n| DevOps Ready     | .env, Config, Service-based deployment   |\n\n---\n\n## 🔧 Installation\n\n```bash\n# Clone the project\ngit clone https://github.com/your-org/nexcom-cloud-erp.git\ncd nexcom-cloud-erp\n\n# Copy environment variables\ncp .env.example .env\n\n# Start all services\ndocker-compose up --build\n````\n\n\u003e Ensure Docker and Node.js are installed on your system.\n\n---\n\n## 🔐 Auth Service\n\nHandles registration, login, JWT token issuance, and middleware role-checking.\n\n* `/register`\n* `/login`\n* Middleware: `authMiddleware.js`\n\n---\n\n## 📦 Inventory Service\n\nManage and track products or assets.\n\n* `/inventory/add`\n* `/inventory/list`\n* `/inventory/:id`\n\n---\n\n## 💰 Finance Service\n\nTrack payments, invoices, and generate billing reports.\n\n* `/transactions/create`\n* `/transactions/:id`\n* `/billing/generate`\n\n---\n\n## 👥 HR Service\n\nEmployee and attendance management with payroll processing.\n\n* `/employee/add`\n* `/attendance/record`\n* `/payroll/run`\n\n---\n\n## 🌐 API Gateway\n\nUnified entry point to route requests to respective services. All external traffic goes through this layer.\n\n* `/auth/*`\n* `/inventory/*`\n* `/finance/*`\n* `/hr/*`\n\n---\n\n## 📦 Dockerized Setup\n\nAll services are containerized and orchestrated via Docker Compose:\n\n```bash\ndocker-compose up --build\n```\n\nThis will spin up:\n\n* MongoDB container\n* All four microservices\n* Gateway service\n\n---\n\n## 📁 Environment Variables (`.env`)\n\n```env\nPORT=5000\nJWT_SECRET=your_jwt_secret_key\nMONGO_URI=mongodb://mongo:27017/nexcom_erp\n```\n\n---\n\n## 🚀 Production Checklist\n\n* [ ] Configure environment-based logging\n* [ ] Add CI/CD workflow (GitHub Actions / Jenkins)\n* [ ] Add CORS policies \u0026 rate limiting\n* [ ] Connect to production-grade DB\n* [ ] Add monitoring via Prometheus + Grafana\n\n---\n\n## 📄 License\n\nMIT License. See [`LICENSE`](LICENSE) for details.\n\n---\n\n## 🤝 Contribution\n\nWe welcome PRs and suggestions. Please fork the repo and raise a pull request, or open an issue for discussions.\n\n---\n\n## 👨‍💻 Maintainers\n\n* [Harsh Sonkar](https://github.com/hq969) — Full Stack Developer\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhq969%2Fnexcom-cloud-erp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhq969%2Fnexcom-cloud-erp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhq969%2Fnexcom-cloud-erp/lists"}