{"id":50300134,"url":"https://github.com/freedy237/robot-medical","last_synced_at":"2026-05-28T12:04:41.612Z","repository":{"id":333352443,"uuid":"1137005750","full_name":"freedy237/robot-medical","owner":"freedy237","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-10T21:52:55.000Z","size":132,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-11T00:35:02.240Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/freedy237.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-18T18:41:20.000Z","updated_at":"2026-02-10T21:52:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/freedy237/robot-medical","commit_stats":null,"previous_names":["freedy237/robot-medical"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/freedy237/robot-medical","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freedy237%2Frobot-medical","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freedy237%2Frobot-medical/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freedy237%2Frobot-medical/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freedy237%2Frobot-medical/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/freedy237","download_url":"https://codeload.github.com/freedy237/robot-medical/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freedy237%2Frobot-medical/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33607431,"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-05-28T02:00:06.440Z","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":[],"created_at":"2026-05-28T12:04:38.050Z","updated_at":"2026-05-28T12:04:41.600Z","avatar_url":"https://github.com/freedy237.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Robot Medical - Real-Time Medical Monitoring System\n\nModern web application for real-time monitoring of patient medical parameters.\n\n## Features\n\n- Real-time dashboard with medical metrics\n- Patient management with RFID tracking\n- Parameter monitoring (temperature, heart rate, SpO2, weight)\n- Automatic alerts for critical values\n- Responsive and accessible interface\n- Secure authentication\n\n## Technologies\n\n- **Frontend**: React 18, Vite, Tailwind CSS, Lucide Icons\n- **Backend**: PHP 8+, MySQL\n- **API Server**: Node.js/Express (ESP32 data collection)\n- **Security**: JWT, CORS, Security Headers\n- **Performance**: useReducer, useMemo, Optimized Polling\n\n## Prerequisites\n\n- Node.js 18+\n- PHP 8.0+\n- MySQL 8.0+\n- Web server (Apache/Nginx)\n\n## Platform-Specific Notes\n\n### Windows\n\nFor Windows users, ensure the following are installed:\n- Download PHP from [php.net](https://www.php.net/downloads)\n- Download MySQL from [mysql.com](https://dev.mysql.com/downloads/)\n- Use `cmd.exe` or PowerShell for commands\n- Replace `sudo` with Administrator privileges (right-click and \"Run as administrator\")\n- Use backslashes `\\` for file paths or double slashes `\\\\`\n\n### macOS / Linux\n\nStandard Unix commands apply. Use `sudo` for system-level operations.\n\n## Quick Start with XAMPP\n\nIf you're using XAMPP (includes Apache, PHP, and MySQL), follow these simplified steps:\n\n### 1. Start XAMPP Services\n\n1. Open XAMPP Control Panel\n2. Start: Apache, MySQL, and PHP (if available)\n3. Open MySQL Admin to configure the database\n\n### 2. Setup Database in XAMPP\n\n```sql\n-- In phpMyAdmin or MySQL command line\nCREATE DATABASE robot_medical;\nCREATE USER 'dark-linux'@'localhost' IDENTIFIED BY 'password';\nGRANT ALL PRIVILEGES ON robot_medical.* TO 'dark-linux'@'localhost';\nFLUSH PRIVILEGES;\n\n-- Import the schema\n-- Upload backend/databases/robot_medical.sql through phpMyAdmin\n-- Or use: mysql -u dark-linux -p robot_medical \u003c backend/databases/robot_medical.sql\n```\n\n### 3. Configure .env for XAMPP\n\n```bash\ncp .env.example .env\n```\n\nEdit `.env`:\n```\nVITE_API_BASE_URL=http://localhost:8000\nDB_HOST=localhost\nDB_USER=dark-linux\nDB_PASS=password\nDB_NAME=robot_medical\n```\n\n### 4. Start Everything\n\n**Option A - Separate terminals:**\n\nTerminal 1 - Frontend:\n```bash\nnpm install\nnpm run dev\n```\n\nTerminal 2 - Backend (if not using Apache):\n```bash\nphp -S 0.0.0.0:8000\n```\n\nTerminal 3 - API Server:\n```bash\ncd robot-api\nnpm install\nnpm start\n```\n\n**Option B - All in one npm command:**\n\nUpdate `package.json` scripts to:\n```json\n{\n  \"scripts\": {\n    \"dev\": \"concurrently \\\"npm run dev:frontend\\\" \\\"npm run dev:backend\\\" \\\"npm run dev:api\\\"\",\n    \"dev:frontend\": \"vite\",\n    \"dev:backend\": \"php -S 0.0.0.0:8000\",\n    \"dev:api\": \"cd robot-api \u0026\u0026 npm start\"\n  }\n}\n```\n\nThen install concurrently:\n```bash\nnpm install --save-dev concurrently\n```\n\nAnd run:\n```bash\nnpm run dev\n```\n\nThis will start all three services in parallel.\n\n## Installation \u0026 Setup\n\n### 1. Database Configuration\n\n**Linux/macOS:**\n```bash\n# Create the database\nsudo mysql -e \"CREATE DATABASE IF NOT EXISTS robot_medical;\"\n\n# Create the user\nsudo mysql -e \"CREATE USER IF NOT EXISTS 'dark-linux'@'localhost'; GRANT ALL PRIVILEGES ON robot_medical.* TO 'dark-linux'@'localhost'; FLUSH PRIVILEGES;\"\n\n# Import the schema\nsudo mysql robot_medical \u003c backend/databases/robot_medical.sql\n```\n\n**Windows (PowerShell or CMD as Administrator):**\n```powershell\n# Open MySQL and run commands\nmysql -u root -p\n\n# In MySQL prompt:\nCREATE DATABASE IF NOT EXISTS robot_medical;\nCREATE USER IF NOT EXISTS 'dark-linux'@'localhost' IDENTIFIED BY 'password';\nGRANT ALL PRIVILEGES ON robot_medical.* TO 'dark-linux'@'localhost';\nFLUSH PRIVILEGES;\n\n# Exit MySQL\nEXIT;\n\n# Import the schema\nmysql -u dark-linux -p robot_medical \u003c backend\\databases\\robot_medical.sql\n```\n\n### 2. Environment Setup\n\n```bash\n# Copy environment file\ncp .env.example .env\n\n# Edit configuration\nnano .env\n```\n\n### 3. Frontend Installation\n\n```bash\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run dev\n```\n\nFrontend will be available at `http://localhost:5173`\n\n### 4. Backend Configuration\n\n**Linux/macOS:**\n```bash\n# Start PHP built-in server (from root directory)\nphp -S 0.0.0.0:8000\n```\n\n**Windows (PowerShell or CMD):**\n```powershell\n# Navigate to root directory if not already there\ncd path\\to\\robot-medical\n\n# Start PHP built-in server\nphp -S 0.0.0.0:8000\n```\n\nBackend will be available at `http://localhost:8000`\n\n### 5. API Server (ESP32 Data Collection)\n\n```bash\n# Navigate to API server\ncd robot-api\n\n# Install dependencies\nnpm install\n\n# Start the server\nnpm start\n```\n\nAPI Server will be available at `http://localhost:3001`\n\n### 6. Full Production Build\n\n```bash\n# Build the application\nnpm run build\n\n# Preview production build\nnpm run preview\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `VITE_API_BASE_URL` | Backend URL | `http://localhost:8000` |\n| `DB_HOST` | MySQL host | `localhost` |\n| `DB_NAME` | Database name | `robot_medical` |\n| `DB_USER` | MySQL user | `dark-linux` |\n| `JWT_SECRET` | JWT secret key | (to be defined) |\n\n### Ports Used\n\n- Frontend: 5173 (development)\n- Backend: 8000 (PHP server)\n- API Server: 3001 (Express server)\n- Database: 3306 (MySQL)\n\n## Usage\n\n1. Access the application at `http://localhost:5173`\n2. View real-time metrics on the dashboard\n3. Manage patient records\n4. Monitor medical measurements\n5. Check critical value alerts\n\n## Security\n\n- JWT authentication\n- CORS security headers\n- Data validation\n- SQL injection protection\n- Rate limiting (to be implemented)\n\n## Responsive Design\n\nThe application is optimized for:\n- Desktop (1024px+)\n- Tablet (768px - 1023px)\n- Mobile (\u003c 768px)\n\n## Troubleshooting\n\n### Common Issues\n\n1. **CORS Error**\n   - Verify backend is listening on the correct port\n   - Check CORS headers in `backend/config/cors.php`\n\n2. **MySQL Connection Failed**\n   - Verify `dark-linux` user exists\n   - Confirm permissions on `robot_medical` database\n\n3. **Frontend Won't Load**\n   - Verify Node.js 18+ is installed\n   - Run `npm install` to install dependencies\n\n### Logs\n\n- Frontend: Browser console\n- Backend: File specified in `LOG_FILE`\n- Database: MySQL logs\n\n## Monitoring\n\nThe application includes:\n- Performance metrics\n- Structured logging\n- Automatic alerts\n- Loading skeletons\n\n## Contributing\n\n1. Fork the project\n2. Create a feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## License\n\nThis project is under the MIT License. See the `LICENSE` file for details.\n\n## Support\n\nFor questions or issues:\n1. Check the documentation\n2. Review error logs\n3. Open an issue on GitHub\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreedy237%2Frobot-medical","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffreedy237%2Frobot-medical","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreedy237%2Frobot-medical/lists"}