init projectmycelium

docs/dev/guides/troubleshooting-json-errors.md

@@ -0,0 +1,57 @@
+# Quick Troubleshooting: JSON Parsing Errors
+
+## 🚨 Emergency Fix
+
+If you see JSON parsing errors in logs, run this immediately:
+
+```bash
+cd projectmycelium
+python3 scripts/fix_user_data.py
+cargo run
+```
+
+## Common Error Patterns
+
+### Missing Field Errors
+```
+missing field `field_name` at line X column Y
+```
+**Quick Fix:** Run `python3 scripts/fix_user_data.py` - it handles most missing fields automatically.
+
+### Invalid Enum Variant
+```
+unknown variant `OldVariantName`
+```
+**Quick Fix:** The Python script maps old variants to new ones automatically.
+
+### Structure Mismatch
+```
+invalid type: map, expected a sequence
+```
+**Manual Fix Required:** Check the data structure against `src/models/user.rs` definitions.
+
+## Step-by-Step Resolution
+
+1. **Stop the application** if it's running
+2. **Run the fix script:**
+   ```bash
+   python3 scripts/fix_user_data.py
+   ```
+3. **Check the output** for what was fixed
+4. **Test the application:**
+   ```bash
+   cargo run
+   ```
+5. **If errors persist,** check the detailed guide: [`data-validation-guide.md`](./data-validation-guide.md)
+
+## Prevention
+
+- Run `python3 scripts/fix_user_data.py` after pulling schema changes
+- Monitor application logs for new parsing errors
+- Backup user data before making manual edits
+
+## Need Help?
+
+1. Check [`data-validation-guide.md`](./data-validation-guide.md) for detailed information
+2. Look at `src/models/user.rs` for current schema requirements
+3. Use the Rust validator in `src/utils/data_validator.rs` for detailed analysis