{"id":20493235,"url":"https://github.com/exios66/survey-calculator","last_synced_at":"2025-10-26T13:36:20.499Z","repository":{"id":261007508,"uuid":"882972269","full_name":"Exios66/Survey-Calculator","owner":"Exios66","description":"Python Survey Calculator -- Introductory Survey to Chatbot Presets.","archived":false,"fork":false,"pushed_at":"2024-11-04T10:09:41.000Z","size":21775,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-16T05:55:35.633Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://exios66.github.io/Survey-Calculator/","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/Exios66.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}},"created_at":"2024-11-04T06:29:13.000Z","updated_at":"2024-12-18T20:52:32.000Z","dependencies_parsed_at":"2024-11-04T07:26:03.985Z","dependency_job_id":"db14387a-ddf7-44b5-b0fd-7cf9ddb5e9d0","html_url":"https://github.com/Exios66/Survey-Calculator","commit_stats":null,"previous_names":["exios66/survey-calculator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exios66%2FSurvey-Calculator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exios66%2FSurvey-Calculator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exios66%2FSurvey-Calculator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exios66%2FSurvey-Calculator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Exios66","download_url":"https://codeload.github.com/Exios66/Survey-Calculator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242074986,"owners_count":20068155,"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","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":"2024-11-15T17:33:57.726Z","updated_at":"2025-10-26T13:36:15.458Z","avatar_url":"https://github.com/Exios66.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Survey Calculator\n\nA web application that helps determine the most suitable chatbot interaction style based on user preferences through a survey interface.\n\n## Overview\n\nThe Survey Calculator is a full-stack web application that allows users to:\n- Take a survey rating their preferences for different chatbot interaction styles\n- Get personalized recommendations for chatbot presets based on their scores\n- View detailed documentation about the different preset options\n- Toggle between light and dark themes\n\n## Features\n\n### Frontend (index.html)\n- Clean, modern UI built with HTML, CSS and vanilla JavaScript\n- Responsive design that works on mobile and desktop\n- Interactive survey form with real-time validation\n- Loading states and error handling\n- Dark/light theme toggle with CSS variables for consistent theming\n- Tab navigation between survey and documentation\n- Animated transitions and hover effects\n- Custom Google Fonts integration (Roboto)\n- Accessibility features including proper ARIA labels\n- Error and success message handling\n\n### Backend (app.py \u0026 evaluator.py)\n- Flask REST API endpoint (/api/process-survey) for handling survey submissions\n- CORS enabled for cross-origin requests\n- Comprehensive error handling and logging\n- Survey evaluation logic with configurable thresholds\n- Score validation (0-100 range)\n- Detailed logging of all operations with both file and console output\n- Type hints and documentation for better code maintainability\n\n### Chatbot Presets\nThree distinct interaction styles are evaluated:\n\n1. **Supportive and Empathetic**\n   - Threshold: 70\n   - Focuses on emotional support and understanding\n   - Ideal for users seeking compassionate interaction\n\n2. **Direct and Analytical**\n   - Threshold: 50\n   - Emphasizes logical problem-solving\n   - Best for users preferring straightforward communication\n\n3. **Playful and Casual**\n   - Threshold: 30\n   - Maintains a light, informal tone\n   - Suitable for casual conversations and engagement\n\n## Setup\n\n1. **Create and activate a virtual environment**:\n    ```bash\n    python3 -m venv venv\n    source venv/bin/activate  # On Windows: venv\\Scripts\\activate\n    ```\n\n2. **Install the required dependencies**:\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n## Usage\n\n1. **Start the Flask server**:\n    ```bash\n    python app.py\n    ```\n\n2. **Open index.html in your browser** to access the survey interface\n\n3. **Complete the survey** by rating your preferences for different interaction styles\n\n4. **View your results** to see your recommended chatbot preset\n\n## Contributing\n\nWe welcome contributions from the community. To contribute:\n\n1. **Fork the repository**\n\n2. **Create a new branch** for your feature or bugfix:\n    ```bash\n    git checkout -b feature-name\n    ```\n\n3. **Commit your changes**:\n    ```bash\n    git commit -m \"Description of your changes\"\n    ```\n\n4. **Push to the branch**:\n    ```bash\n    git push origin feature-name\n    ```\n\n5. **Open a pull request** and describe your changes\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Contributors\n\n- **[Exios66](https://github.com/Exios66)**: The main contributor and maintainer of the project.\n\n## Contact\n\nFor any questions or feedback, feel free to open an issue or contact [Exios66](https://github.com/Exios66).\n\n## Additional Resources\n\n- **Project Homepage**: [Survey-Calculator](https://exios66.github.io/Survey-Calculator/)\n- **Repository URL**: [Survey-Calculator on GitHub](https://github.com/Exios66/Survey-Calculator)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexios66%2Fsurvey-calculator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexios66%2Fsurvey-calculator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexios66%2Fsurvey-calculator/lists"}