From 39942386b1b936d73dac6ba881dfa009a380d962 Mon Sep 17 00:00:00 2001
From: Dobromir Popov <dobromir.popov@gateway.one>
Date: Mon, 26 May 2025 11:36:48 +0300
Subject: [PATCH] curorrules

---
 .cursorrules | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 .cursorrules

diff --git a/.cursorrules b/.cursorrules
new file mode 100644
index 0000000..fadf700
--- /dev/null
+++ b/.cursorrules
@@ -0,0 +1,66 @@
+# Cursor AI Coding Rules for gogo2 Trading Dashboard Project
+
+## Unicode and Encoding Rules
+- **NEVER use emoji characters in logging statements or console output**
+- **NEVER use Unicode characters that may not be supported by Windows console (cp1252)**
+- Use ASCII-only characters in all logging, print statements, and console output
+- remove emojis from the code and DO NOT replace them with text equivalents:
+
+
+## Code Structure and Versioning Rules
+- **NEVER create multiple versions of the same functionality** (e.g., _fixed, _enhanced, _v2)
+- **ALWAYS work with existing code structure** and modify in place
+- **ASK FOR EXPLICIT APPROVAL** before creating new implementations of existing features
+- When fixing issues, modify the original file rather than creating copies
+- Use descriptive commit messages but avoid creating parallel implementations
+- If major refactoring is needed, discuss the approach first
+
+## Dashboard Development Rules
+- Focus on the main scalping dashboard (`web/scalping_dashboard.py`)
+- Do not create alternative dashboard implementations unless explicitly requested
+- Fix issues in the existing codebase rather than creating workarounds
+- Ensure all callback registrations are properly handled
+- Test callback functionality thoroughly before deployment
+
+## Logging Best Practices
+- Use structured logging with clear, ASCII-only messages
+- Include relevant context in log messages without Unicode characters
+- Use logger.info(), logger.error(), etc. with plain text
+- Example: `logger.info("TRADING: Starting Live Scalping Dashboard at http://127.0.0.1:8051")`
+
+## Error Handling
+- Always include proper exception handling
+- Log errors with ASCII-only characters
+- Provide meaningful error messages without emojis
+- Include stack traces for debugging when appropriate
+
+## File Naming Conventions
+- Use descriptive names without version suffixes
+- Avoid creating multiple files for the same purpose
+- Use clear, concise names that indicate the file's purpose
+
+## Testing Guidelines
+- Create focused test files for specific functionality
+- Use temporary test files that can be easily cleaned up
+- Name test files clearly (e.g., `test_callback_registration.py`)
+- Remove or archive test files after issues are resolved
+
+## Windows Compatibility
+- Ensure all code works properly on Windows systems
+- Handle Windows-specific path separators correctly
+- Use appropriate encoding for file operations
+- Test console output compatibility with Windows Command Prompt and PowerShell
+
+## Dashboard Callback Rules
+- Ensure all Dash callbacks are properly registered
+- Use consistent callback patterns across the application
+- Handle callback errors gracefully with fallback values
+- Test callback functionality with direct HTTP requests when debugging
+
+## Code Review Checklist
+Before submitting code changes, verify:
+- [ ] No Unicode/emoji characters in logging or console output
+- [ ] No duplicate implementations of existing functionality
+- [ ] Proper error handling with ASCII-only messages
+- [ ] Windows compatibility maintained
+- [ ] Existing code structure preserved and enhanced rather than replaced 
\ No newline at end of file