{"id":50717975,"url":"https://github.com/ramon3k/field-service-plugins","last_synced_at":"2026-06-09T20:31:04.631Z","repository":{"id":321098527,"uuid":"1084456162","full_name":"ramon3k/field-service-plugins","owner":"ramon3k","description":"Field service management system with plugin architecture. Includes ticket management, customer tracking, and deployment guides for local, Azure, and AWS hosting.","archived":false,"fork":false,"pushed_at":"2025-11-16T14:32:12.000Z","size":31225,"stargazers_count":1,"open_issues_count":7,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-16T16:16:41.518Z","etag":null,"topics":["aws","azure","customer-tracking","field-service-ticketing","free","nodejs","plugin-system","react","service","service-management","sql-server"],"latest_commit_sha":null,"homepage":"https://workzown.com/","language":"TypeScript","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/ramon3k.png","metadata":{"files":{"readme":"README-DISTRIBUTION.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/security/bfg-replace.txt","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-10-27T17:48:21.000Z","updated_at":"2025-11-16T14:31:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"26f21017-3591-4194-9d7e-33ce7e1436ba","html_url":"https://github.com/ramon3k/field-service-plugins","commit_stats":null,"previous_names":["ramon3k/field-service-plugins"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/ramon3k/field-service-plugins","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramon3k%2Ffield-service-plugins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramon3k%2Ffield-service-plugins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramon3k%2Ffield-service-plugins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramon3k%2Ffield-service-plugins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ramon3k","download_url":"https://codeload.github.com/ramon3k/field-service-plugins/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramon3k%2Ffield-service-plugins/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34125332,"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-09T02:00:06.510Z","response_time":63,"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":["aws","azure","customer-tracking","field-service-ticketing","free","nodejs","plugin-system","react","service","service-management","sql-server"],"created_at":"2026-06-09T20:31:03.404Z","updated_at":"2026-06-09T20:31:04.624Z","avatar_url":"https://github.com/ramon3k.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Field Service Management System\n## Complete Business Solution for Service Companies\n\n### 🎯 Overview\nThis Field Service Management System is a comprehensive solution designed for service-based companies to manage customers, sites, technicians, service tickets, and assets. Built with modern web technologies, it provides real-time tracking, user management, and detailed reporting capabilities.\n\n### ✨ Key Features\n- **Customer \u0026 Site Management** - Track all customer locations and contact information\n- **Service Ticket Management** - Create, assign, and track service requests\n- **Technician Management** - Manage field technicians and contractor vendors\n- **Asset Tracking** - Monitor equipment, warranties, and maintenance schedules\n- **User Role Management** - Admin, Coordinator, and Technician access levels\n- **Activity Logging** - Complete audit trail of all system activities\n- **CSV Export** - Export data for reporting and analysis\n- **Real-time Dashboard** - Live updates and status tracking\n- **Mobile-Friendly** - Works on tablets and mobile devices\n\n---\n\n## 🚀 Quick Start Guide\n\n### System Requirements\n- **Operating System**: Windows 10/11 or Windows Server 2019+\n- **Database**: SQL Server Express 2019+ (included in setup)\n- **Runtime**: Node.js 18+ (will be installed automatically)\n- **Browser**: Chrome, Firefox, Safari, or Edge (latest versions)\n- **Hardware**: 4GB RAM minimum, 8GB recommended\n- **Storage**: 5GB free space for application and database\n\n### Installation Steps\n\n#### 1. Download and Extract\n```\n1. Extract the FieldServiceSystem-v1.0.zip file to your desired location\n2. Example: C:\\Programs\\FieldServiceSystem\\\n```\n\n#### 2. Run the Installer\n```batch\n1. Right-click on \"SETUP.bat\" and select \"Run as Administrator\"\n2. Follow the on-screen prompts\n3. The installer will:\n   - Install SQL Server Express (if not present)\n   - Install Node.js dependencies\n   - Create the database\n   - Configure the application\n```\n\n#### 3. First-Time Login\n```\n1. Open your web browser\n2. Navigate to: http://localhost:5000\n3. Login with default admin credentials:\n   - Username: admin\n   - Password: admin123\n4. IMPORTANT: Change the admin password immediately after login\n```\n\n---\n\n## 🔧 Configuration\n\n### Company Setup\nAfter first login, configure your company information:\n\n1. **Company Details**\n   - Navigate to Settings → Company Profile\n   - Update company name, contact information\n   - Upload your company logo\n   \n2. **User Management**\n   - Add your staff members (Admin → User Management)\n   - Assign appropriate roles (Admin, Coordinator, Technician)\n   - Set up vendor/contractor accounts\n\n3. **Initial Data Setup**\n   - Import your customers (CSV template provided)\n   - Add customer sites and locations\n   - Set up your asset inventory\n   - Configure service categories\n\n### Database Configuration\nThe system uses SQL Server Express by default. Configuration file location:\n```\nserver\\.env\n```\n\nDefault database settings:\n```\nDB_SERVER=localhost\\SQLEXPRESS\nDB_NAME=FieldServiceDB\nDB_USER=(Windows Authentication)\n```\n\n---\n\n## 👥 User Roles \u0026 Permissions\n\n### Administrator\n- Full system access\n- User management\n- Company configuration\n- System settings\n- All reports and exports\n\n### Coordinator\n- View all tickets and customers\n- Assign tickets to technicians\n- Create and edit customer information\n- Generate reports\n- Monitor technician activity\n\n### Technician\n- View assigned tickets\n- Update ticket status and notes\n- View customer and site information\n- Upload photos and documents\n- Clock in/out for service calls\n\n---\n\n## 📊 Using the System\n\n### Customer Management\n1. **Add New Customers**\n   - Navigate to \"Customers\" tab\n   - Click \"Add Customer\"\n   - Fill in company details and contact information\n\n2. **Manage Customer Sites**\n   - Select a customer\n   - Add multiple service locations\n   - Include GPS coordinates for routing\n\n### Service Ticket Workflow\n1. **Create Service Request**\n   - Customers call in or submit online requests\n   - Coordinator creates ticket in system\n   - Assigns priority and category\n\n2. **Assign Technician**\n   - Select available technician\n   - Consider location and expertise\n   - System sends notification\n\n3. **Field Service**\n   - Technician receives assignment\n   - Updates status (En Route, On Site, Complete)\n   - Adds notes and photos\n   - Records time and materials used\n\n4. **Completion \u0026 Billing**\n   - Technician marks complete\n   - Coordinator reviews work\n   - Generate service report\n   - Export to billing system\n\n### Asset Management\n- Track equipment at customer sites\n- Monitor warranty expiration dates\n- Schedule preventive maintenance\n- Maintain service history\n\n---\n\n## 🔒 Security \u0026 Backup\n\n### Security Features\n- **User Authentication** - Secure login with password encryption\n- **Role-Based Access** - Users only see permitted information\n- **Activity Logging** - Complete audit trail of all actions\n- **Session Management** - Automatic timeout for security\n- **Data Encryption** - Sensitive data encrypted in database\n\n### Backup Procedures\n1. **Automatic Backups**\n   - Daily database backups at 2:00 AM\n   - Stored in: `C:\\FieldServiceBackups\\`\n   - 30-day retention policy\n\n2. **Manual Backup**\n   ```batch\n   # Run this command as Administrator\n   cd C:\\Programs\\FieldServiceSystem\\scripts\\\n   backup-database.bat\n   ```\n\n3. **Restore from Backup**\n   ```batch\n   cd C:\\Programs\\FieldServiceSystem\\scripts\\\n   restore-database.bat [backup-file-name]\n   ```\n\n---\n\n## 📱 Mobile Access\n\n### Tablet/Mobile Usage\n- Fully responsive design works on tablets and smartphones\n- Technicians can use tablets in the field\n- Touch-friendly interface\n- Works offline with sync when connected\n\n### Recommended Devices\n- **Tablets**: iPad, Surface, Android tablets (10\" screen minimum)\n- **Phones**: iPhone, Samsung Galaxy, Google Pixel\n- **Rugged Options**: Panasonic Toughbook, Getac tablets\n\n---\n\n## 🛠 Troubleshooting\n\n### Common Issues\n\n#### \"Cannot connect to database\"\n```\n1. Check if SQL Server Express service is running\n2. Windows Services → SQL Server (SQLEXPRESS) → Start\n3. Verify Windows Firewall allows SQL Server\n4. Check connection string in server\\.env file\n```\n\n#### \"Application won't start\"\n```\n1. Ensure Node.js is installed: node --version\n2. Check if port 5000 is available\n3. Run: cd server \u0026\u0026 npm install\n4. Check Windows Event Viewer for errors\n```\n\n#### \"Users can't login\"\n```\n1. Verify database connectivity\n2. Check user account status in User Management\n3. Clear browser cache and cookies\n4. Reset password if needed\n```\n\n### Performance Optimization\n- **Regular Database Maintenance**: Run monthly cleanup scripts\n- **Monitor Disk Space**: Ensure adequate free space for logs\n- **Update Browsers**: Keep browsers updated for best performance\n- **Network**: Stable internet connection for cloud sync features\n\n---\n\n## 📞 Support \u0026 Training\n\n### Getting Help\n- **Documentation**: Complete user manuals in `/docs` folder\n- **Video Tutorials**: Available at [your-support-website]\n- **Email Support**: support@yourcompany.com\n- **Phone Support**: 1-800-XXX-XXXX (Business hours)\n\n### Training Options\n1. **Self-Service**\n   - User manual and video tutorials\n   - Sample data for practice\n   - Online knowledge base\n\n2. **Remote Training**\n   - 2-hour setup and configuration session\n   - User training for all roles\n   - Best practices guidance\n\n3. **On-Site Training**\n   - Full day implementation workshop\n   - Custom workflow setup\n   - Staff training for all users\n\n### Support Tiers\n- **Basic**: Email support, documentation access\n- **Professional**: Phone support, priority response\n- **Enterprise**: Dedicated support manager, custom features\n\n---\n\n## 🔄 Updates \u0026 Maintenance\n\n### Software Updates\n- Automatic update notifications\n- Download updates from customer portal\n- Backup recommended before applying updates\n- Release notes provided with each update\n\n### System Maintenance\n- **Daily**: Automatic database cleanup\n- **Weekly**: Review system logs\n- **Monthly**: Performance optimization\n- **Quarterly**: Full system backup verification\n\n---\n\n## 📋 Customization Options\n\n### Branding\n- Replace company logo\n- Customize color scheme\n- Modify email templates\n- Custom report headers\n\n### Workflow Customization\n- Add custom fields to tickets\n- Create custom service categories\n- Modify user roles and permissions\n- Integration with existing systems\n\n### Advanced Features (Available)\n- API integration with accounting software\n- Mobile app development\n- Custom reporting dashboards\n- Multi-location management\n- Advanced analytics and insights\n\n---\n\n## 📄 License \u0026 Legal\n\n### Software License\nThis software is licensed for use by the purchasing organization. See LICENSE.txt for complete terms.\n\n### Data Ownership\n- Your company owns all data entered into the system\n- Data export tools available at any time\n- No vendor lock-in policies\n\n### Compliance\n- Suitable for most business compliance requirements\n- GDPR-friendly data handling\n- SOC 2 Type II hosting available (cloud option)\n\n---\n\n## 📚 Additional Resources\n\n### File Locations\n```\nApplication Files: C:\\Programs\\FieldServiceSystem\\\nDatabase Files: C:\\SQL\\Data\\FieldServiceDB\\\nBackup Files: C:\\FieldServiceBackups\\\nLog Files: C:\\Programs\\FieldServiceSystem\\logs\\\n```\n\n### Important Files\n- `server\\.env` - Configuration settings\n- `docs\\user-manual.pdf` - Complete user guide\n- `docs\\admin-guide.pdf` - Administrator instructions\n- `scripts\\backup-database.bat` - Manual backup script\n- `scripts\\reset-admin-password.bat` - Emergency admin reset\n\n### Default Ports\n- Web Application: http://localhost:5000\n- Database: localhost\\SQLEXPRESS (Windows Auth)\n- API Endpoints: http://localhost:5000/api/\n\n---\n\n## 🆘 Emergency Procedures\n\n### Reset Admin Password\n```batch\n1. Open Command Prompt as Administrator\n2. cd C:\\Programs\\FieldServiceSystem\\scripts\\\n3. run: reset-admin-password.bat\n4. Follow prompts to set new password\n```\n\n### Database Recovery\n```batch\n1. Stop the application\n2. Restore from backup using restore-database.bat\n3. Restart application\n4. Verify data integrity\n```\n\n### Complete Reinstall\n```batch\n1. Backup your database first!\n2. Uninstall via Control Panel\n3. Delete installation directory\n4. Run SETUP.bat again\n5. Restore database from backup\n```\n\n---\n\n**Installation Support**: If you encounter any issues during setup, please contact our support team at support@yourcompany.com or call 1-800-XXX-XXXX.\n\n**Version**: 1.0  \n**Last Updated**: October 2025  \n**Next Recommended Update Check**: 3 months from installation","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Framon3k%2Ffield-service-plugins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Framon3k%2Ffield-service-plugins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Framon3k%2Ffield-service-plugins/lists"}