{"id":29275282,"url":"https://github.com/nightdevilpt/warranty-management","last_synced_at":"2026-06-29T12:31:42.119Z","repository":{"id":316991171,"uuid":"1065185091","full_name":"NightDevilPT/warranty-management","owner":"NightDevilPT","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-07T12:23:11.000Z","size":462,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-07T14:14:07.299Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/NightDevilPT.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing-guide.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-27T08:06:53.000Z","updated_at":"2026-06-07T12:23:15.000Z","dependencies_parsed_at":"2025-09-28T05:36:46.636Z","dependency_job_id":"9fd463c7-9347-41ba-955f-c6c76f54fa2f","html_url":"https://github.com/NightDevilPT/warranty-management","commit_stats":null,"previous_names":["nightdevilpt/warranty-management"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/NightDevilPT/warranty-management","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NightDevilPT%2Fwarranty-management","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NightDevilPT%2Fwarranty-management/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NightDevilPT%2Fwarranty-management/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NightDevilPT%2Fwarranty-management/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NightDevilPT","download_url":"https://codeload.github.com/NightDevilPT/warranty-management/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NightDevilPT%2Fwarranty-management/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34927675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-29T02:00:05.398Z","response_time":58,"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":[],"created_at":"2025-07-05T06:08:54.764Z","updated_at":"2026-06-29T12:31:42.113Z","avatar_url":"https://github.com/NightDevilPT.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Warranty Management System (WMS)\n\nA multi-tenant, configurable warranty management platform built with modern web technologies and a monorepo architecture.\n\n## 🎯 Overview\n\nThe Warranty Management System (WMS) streamlines warranty operations for manufacturers, retailers, and service providers with:\n\n- **Multi-tenancy** with isolated company portals\n- **Dynamic form schemas** for products, claims, and registrations\n- **Custom warranty templates** with validation rules\n- **Hierarchical partner management** (dealers, retailers, service centers)\n- **Role-based access control** with company-defined permission sets\n\n## 📁 Project Structure\n\n```\nwarranty-management/\n├── apps/\n│   ├── admin/                 # Platform admin interface (SYSTEM_ADMIN)\n│   ├── server/                # Backend API \u0026 business logic (NestJS + Prisma)\n│   ├── company/              # Company management portal\n│   └── consumer/             # End-customer self-service portal\n├── packages/\n│   ├── ui/                   # Shared UI components (shadcn/ui + custom)\n│   ├── eslint-config/        # Shared ESLint configuration\n│   └── typescript-config/    # Shared TypeScript configuration\n├── docs/\n│   └── Warranty-Management-System-Specification.md\n└── package.json              # Root package.json with Turborepo scripts\n```\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js \u003e= 20\n- pnpm 10.4.1+\n- CockroachDB\n- Docker \u0026 Docker Compose (optional)\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone \u003crepository-url\u003e\ncd warranty-management-system\n\n# Install dependencies\npnpm install\n\n# Set up environment variables\ncp .env.example .env\n# Edit .env with your configuration\n\n# Generate Prisma client\npnpm prisma:generate\n\n# Start development servers\npnpm dev\n```\n\n### Development Commands\n\n| Command                | Description                               |\n| ---------------------- | ----------------------------------------- |\n| `pnpm dev`             | Start all apps in development mode        |\n| `pnpm build`           | Build all apps for production             |\n| `pnpm lint`            | Run ESLint on all apps                    |\n| `pnpm format`          | Format code with Prettier                 |\n| `pnpm docker:dev`      | Start development environment with Docker |\n| `pnpm prisma:generate` | Generate Prisma client                    |\n\n### Running Specific Apps\n\n```bash\n# Run individual apps\ncd apps/admin \u0026\u0026 pnpm dev\ncd apps/company \u0026\u0026 pnpm dev\ncd apps/consumer \u0026\u0026 pnpm dev\ncd apps/server \u0026\u0026 pnpm dev\n\n# Or using Turbo\npnpm --filter admin dev\npnpm --filter server dev\n```\n\n## 🏗️ Architecture\n\n### **Portal Structure**\n\n| Portal       | Path                   | Target Users  | Framework |\n| ------------ | ---------------------- | ------------- | --------- |\n| **Admin**    | `/admin/*`             | SYSTEM_ADMIN  | Next.js   |\n| **Company**  | `/{companySlug}/app/*` | COMPANY Users | Next.js   |\n| **Consumer** | `/{companySlug}/app/*` | CONSUMER      | Next.js   |\n| **Server**   | `/api/*`               | All portals   | NestJS    |\n\n### **Core Services**\n\n- **Authentication**: JWT with refresh token rotation\n- **Database**: CockroachDB with Prisma ORM\n- **File Storage**: Cloud-based storage for attachments\n- **Email**: Transactional email service\n- **Caching**: Redis for session and data caching\n\n## 📦 Packages\n\n### **Shared UI (`packages/ui`)**\n\n- Reusable React components built with shadcn/ui\n- Design tokens and theme configuration\n- Form components with validation\n- Layout components for all portals\n\n### **Configurations**\n\n- `@workspace/eslint-config`: ESLint rules for TypeScript/React\n- `@workspace/typescript-config`: TypeScript configurations\n\n## 🛠️ Development\n\n### Adding Dependencies\n\n```bash\n# Add to specific app\npnpm --filter admin add \u003cpackage-name\u003e\n\n# Add to all apps\npnpm -r add \u003cpackage-name\u003e\n\n# Add dev dependency to root\npnpm add -D \u003cpackage-name\u003e\n```\n\n### Database Management\n\n```bash\n# Generate Prisma client (after schema changes)\npnpm prisma:generate\n\n# Run migrations (from server app)\ncd apps/server\npnpm prisma:migrate dev\n\n# View database\npnpm prisma studio\n```\n\n### Docker Development\n\n```bash\n# Start all services (CockroachDB, Redis, etc.)\npnpm docker:dev\n\n# View logs\ndocker-compose logs -f\n\n# Stop services\ndocker-compose down\n```\n\n## 🔧 Environment Setup\n\nCreate a `.env` file in the root with:\n\n```env\n# Database\nDATABASE_URL=\"postgresql://user:password@localhost:26257/warranty_db\"\n\n# Redis\nREDIS_URL=\"redis://localhost:6379\"\n\n# Authentication\nJWT_SECRET=\"your-jwt-secret\"\nJWT_REFRESH_SECRET=\"your-refresh-secret\"\n\n# Email\nSMTP_HOST=\"smtp.example.com\"\nSMTP_PORT=587\nSMTP_USER=\"user\"\nSMTP_PASS=\"pass\"\n\n# Storage\nAWS_ACCESS_KEY_ID=\"your-access-key\"\nAWS_SECRET_ACCESS_KEY=\"your-secret-key\"\nAWS_S3_BUCKET=\"your-bucket\"\n```\n\n## 🧪 Testing\n\n```bash\n# Run tests for all apps\npnpm test\n\n# Run tests for specific app\npnpm --filter admin test\npnpm --filter server test\n\n# Run tests in watch mode\npnpm --filter admin test:watch\n```\n\n## 📚 Documentation\n\n- **[System Specification](./docs/overview.md)** - Complete system requirements and flows\n- **[API Documentation](./docs/api.md)** - Backend API reference\n- **[Deployment Guide](./docs/deployment.md)** - Production deployment instructions\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/\u003cfeature-name\u003e`)\n3. Commit your changes (`git commit -m 'Add \u003cfeature name\u003e'`)\n4. Push to the branch (`git push origin feature/\u003cfeature name\u003e`)\n5. Open a Pull Request\n\n### Commit Convention\n\nWe follow [Conventional Commits](https://www.conventionalcommits.org/):\n\n- `feat:` New features\n- `fix:` Bug fixes\n- `docs:` Documentation changes\n- `style:` Code style changes\n- `refactor:` Code refactoring\n- `test:` Test-related changes\n- `chore:` Maintenance tasks\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 📞 Support\n\n- **Issues**: [GitHub Issues](link-to-issues)\n- **Documentation**: [System Specification](./docs/Warranty-Management-System-Specification.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnightdevilpt%2Fwarranty-management","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnightdevilpt%2Fwarranty-management","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnightdevilpt%2Fwarranty-management/lists"}