{"id":30896508,"url":"https://github.com/cyyau3/sales-data-automator","last_synced_at":"2026-04-17T06:03:43.904Z","repository":{"id":287992296,"uuid":"882469148","full_name":"cyyau3/sales-data-automator","owner":"cyyau3","description":"A Python tool that automates login, navigation, and data export from the UCD website using Python and Selenium.","archived":false,"fork":false,"pushed_at":"2025-09-05T15:49:11.000Z","size":341,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-05T17:49:40.463Z","etag":null,"topics":["automation","browser-automation","data-extraction","python3","selenium","web-scraping"],"latest_commit_sha":null,"homepage":"","language":"Python","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/cyyau3.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-11-02T21:22:10.000Z","updated_at":"2025-09-05T15:49:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"abc4a681-ffeb-48c6-b5ca-3f646966aa7b","html_url":"https://github.com/cyyau3/sales-data-automator","commit_stats":null,"previous_names":["cyyau3/salesdataautomator","cyyau3/sales-data-automator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cyyau3/sales-data-automator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyyau3%2Fsales-data-automator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyyau3%2Fsales-data-automator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyyau3%2Fsales-data-automator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyyau3%2Fsales-data-automator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cyyau3","download_url":"https://codeload.github.com/cyyau3/sales-data-automator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyyau3%2Fsales-data-automator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31917372,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"online","status_checked_at":"2026-04-17T02:00:06.879Z","response_time":62,"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":["automation","browser-automation","data-extraction","python3","selenium","web-scraping"],"created_at":"2025-09-08T23:08:36.197Z","updated_at":"2026-04-17T06:03:43.877Z","avatar_url":"https://github.com/cyyau3.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sales Data Automator\n\nAutomates the process of extracting sales and inventory data from UCD website. This tool automatically logs in, navigates through the UCD interface, and exports data to Excel files.\n\n## Features\n\n- Automated login to UCD website\n- Extracts inventory data\n- Extracts monthly supply reports\n- Exports data to Excel files\n- Automatic ChromeDriver management\n- Error screenshots for troubleshooting\n\n## Prerequisites\n\n- Python 3.8 or higher\n- Google Chrome browser\n- macOS or Windows operating system\n- UCD member account credentials\n\n## Installation\n\n1. Clone this repository:\n```bash\ngit clone [your-repository-url]\ncd Sales_Data_Automation\n```\n\n2. Set up configuration:\n```bash\ncd config\ncp sample.ini config.ini\n```\n\n3. Edit `config.ini` with your credentials:\n```ini\n[Credentials]\nwebsite_url = https://www.ucd.com.tw\nusername = YOUR_UCD_USERNAME # Replace with your UCD username\npassword = YOUR_UCD_PASSWORD # Replace with your UCD password\n[Settings]\ntimeout = 30 # Increase if you have slow internet\nbrowser = chrome\n```\n\n4. Set proper file permissions (macOS only):\n```bash\nchmod 600 config/config.ini\n```\n\n## Usage\n\n1. Activate the virtual environment:\n```bash\n#On macOS\n./activate.sh\n#On Windows\n.\\activate.bat # You'll need to create this for Windows \n```\n\n2. Run the program:\n```bash\npython3 src/main.py\n``` \n\n3. The program will:\n   - Log in to UCD website\n   - Extract inventory data\n   - Extract monthly supply data\n   - Export data to Excel files in the `exports/` directory\n   - Keep the browser open for manual interaction\n   - Type 'q' in the terminal to quit and close the browser\n\n## Project Structure\n\n```\nSales_Data_Automation/\n├── config/\n│   ├── sample.ini\n│   ├── config.ini (created by user)\n│   └── urls.py\n├── src/\n│   ├── main.py\n│   ├── web_navigator.py\n│   └── logger_config.py\n├── exports/\n│   └── (generated Excel files)\n├── error_screenshots/\n│   └── (error screenshots if any)\n├── venv/\n├── activate.sh\n└── README.md\n```\n\n## Security Notes\n\n- Never commit `config.ini` to version control\n- Keep your UCD credentials secure\n- The program uses incognito mode and clears browser data after use\n- Screenshots are saved locally for troubleshooting\n\n## Troubleshooting\n\n1. **Configuration Issues**:\n   - Verify your UCD credentials\n   - Check file permissions on `config.ini`\n   - Ensure config file is in the correct location\n\n2. **Browser Issues**:\n   - Ensure Chrome is installed\n   - Check internet connection\n   - Look for error screenshots in `error_screenshots/` directory\n\n3. **Virtual Environment Issues**:\n   - Delete `venv` folder and rerun `activate.sh`\n   - Verify Python version: `python --version`\n\n## Error Handling\n\n- Screenshots are automatically saved when errors occur\n- Check the terminal output for error messages\n- Screenshots are saved in `error_screenshots/` with timestamps\n\n## Maintenance\n\n- Regular updates to ChromeDriver are automatic\n- Check for Python package updates periodically\n- Monitor UCD website changes that might affect automation\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch\n3. Commit your changes\n4. Push to the branch\n5. Create a new Pull Request\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyyau3%2Fsales-data-automator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyyau3%2Fsales-data-automator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyyau3%2Fsales-data-automator/lists"}