Feature/readme onboarding overhaul

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,29 @@
+---
+name: Bug Report
+about: Create a report to help us fix a bug or issue in Hayday-Bot-Pro
+title: '[BUG] '
+labels: 'bug, help wanted'
+assignees: ''
+---
+
+## 🐛 Bug Description
+A clear and concise description of what the bug is.
+
+## 🛠️ Environment Info
+- **OS**: Windows 10 / Windows 11
+- **Emulator**: MEmu / LDPlayer / Nox / BlueStacks
+- **Emulator Resolution**: e.g., 640x480 (100 DPI)
+- **Render Mode**: DirectX / OpenGL
+- **Bot Version / Commit**: (e.g. main branch at commit hash)
+
+## 🔄 Steps to Reproduce
+1. Launch emulator and set resolution to `640x480`
+2. Start `quickstart.bat` or `premium.exe`
+3. Click on '...'
+4. See error
+
+## 📉 Expected Behavior
+A clear and concise description of what you expected to happen.
+
+## 📸 Screenshots or Logs
+If applicable, add screenshots or attach log output to help explain your problem.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,24 @@
+---
+name: Feature Request
+about: Suggest an idea or feature for Hayday-Bot-Pro
+title: '[FEATURE] '
+labels: 'enhancement, good first issue'
+assignees: ''
+---
+
+## 🚀 Feature Description
+A clear and concise description of what feature or enhancement you'd like to see added.
+
+## 🎯 Problem It Solves
+Is your feature request related to a problem or manual task? Please describe.
+(e.g., "I spend too much time manually selling items in the roadside shop...")
+
+## 💡 Proposed Solution
+Describe the solution or feature implementation you'd like to see.
+
+## 📐 Alternatives Considered
+Describe any alternative solutions or features you've considered.
+
+## 🤝 Willingness to Contribute
+- [ ] I am willing to submit a Pull Request for this feature!
+- [ ] I can help test and review PRs for this feature.

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI Build Check
+
+on:
+  push:
+    branches: [ "main", "feature/*", "fix/*" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build-windows:
+    runs-on: windows-2022
+
+    steps:
+    - name: Checkout Repository
+      uses: actions/checkout@v4
+      with:
+        submodules: recursive
+
+    - name: Add MSBuild to PATH
+      uses: microsoft/setup-msbuild@v2
+
+    - name: Build C++ Bot Solution
+      run: |
+        msbuild HD/"Premium bot.sln" /p:Configuration=Release /p:Platform=x64 /maxcpucount
+
+    - name: Verify Executable Output
+      run: |
+        if (Test-Path "HD/x64/Release/premium.exe") {
+            Write-Host "Build verification successful: premium.exe created."
+        } else {
+            Write-Error "Executable not found after build!"
+            exit 1
+        }

.gitignore

@@ -65,12 +65,22 @@ HD/tools/
 HD/templates/*.png1
 HD/replace_grass.py
 
+# Private tooling & RE artifacts
+lsposed_hayday_promon_aes/
+magisk_memu_boot/
+Frida.md
+run_headless.bat
+run_proxy.bat
+SESSION_HISTORY.md
+README_SPLIT.md
+LARGE_FILES_NOT_INCLUDED.md
+MISSING_TEMPLATE_PLACEHOLDERS.md
+account_2_storage_new.xml
+asset_name_rects.generated.csv
+asset_tags.example.json
+asset_tags.generated.json
+
 # Large binary/resource/archive folders
-analysis_artifacts/
-source_packages/
-Reference_Assets/
-magisk_memu_boot/*
-!magisk_memu_boot/scripts/
 *.zip
 *.fla
 Decoded/

CONTRIBUTING.md

@@ -0,0 +1,68 @@
+# Contributing to Hayday-Bot-Pro
+
+First off, thank you for considering contributing to **Hayday-Bot-Pro**! It's contributors like you who make this tool reliable, performant, and accessible for the community.
+
+---
+
+## 🌿 Branching Policy & Pull Requests
+
+To maintain codebase stability and code quality, please adhere strictly to our branching policy:
+
+- **Branch Protection**: Never commit or push directly to the `main` branch.
+- **Feature Branches**: Create a dedicated feature or fix branch for your work:
+  - Features: `feature/your-feature-name`
+  - Bug Fixes: `fix/issue-description`
+- **Clean Commits**: Ensure commits are squashed or logical, clean, and pass local build verification before opening a Pull Request.
+- **PR Process**: Submit your PR targeting `main`. Describe your changes clearly and link any associated issues.
+
+---
+
+## 🛠️ Development Setup & Prerequisites
+
+1. **Development Environment**:
+   - Visual Studio 2022 (Community or higher) with the **Desktop development with C++** workload.
+   - Windows 10 / 11 64-bit.
+   - C++20 language standard support.
+2. **Android Emulator**:
+   - MEmu Play or LDPlayer.
+   - Emulator config: `640x480` resolution, `100 DPI`, **DirectX** render mode, **Root** enabled.
+
+### Building Locally
+
+- **Option A (One-Command Quickstart)**: Run [`quickstart.bat`](file:///d:/02_Projects/HD/HaydayMod/quickstart.bat) from the root directory.
+- **Option B (Visual Studio)**:
+  1. Open [`HD/Premium bot.sln`](file:///d:/02_Projects/HD/HaydayMod/HD/Premium%20bot.sln).
+  2. Set active configuration to `Release` and platform to `x64`.
+  3. Press `Ctrl+Shift+B` to build the solution.
+
+---
+
+## 🎯 Finding "Good First Issues"
+
+If you're looking for an easy place to start contributing:
+
+1. Check out issues tagged with [`good first issue`](https://github.com/issues?q=label%3A"good+first+issue") or [`help wanted`](https://github.com/issues?q=label%3A"help+wanted").
+2. Examples of great beginner contributions:
+   - UI polish for the ImGui control panel.
+   - Extra OCR dataset training or alignment tweaks in [`HD/tessdata/`](file:///d:/02_Projects/HD/HaydayMod/HD/tessdata).
+   - Logging, error reporting, and ADB recovery routine improvements.
+   - Documentation additions or localized guides.
+
+---
+
+## 🎨 Code Style Guidelines
+
+- **Standard**: C++20 standard syntax.
+- **Architecture**:
+  - Keep UI rendering (ImGui) strictly decoupled from background bot loop operations (`HD/cpp/bot` vs `HD/cpp/app`).
+  - Account security & storage logic (`.Ahjie` DPAPI/AES-256 encryption) must remain isolated in `HD/cpp/infra`.
+- **Naming Conventions**:
+  - `PascalCase` for Class names and struct types.
+  - `camelCase` for local variables and parameters.
+  - `m_memberVar` for private/protected class member fields.
+
+---
+
+## ❓ Need Help?
+
+Feel free to open a discussion, leave comments on issues, or refer to [docs/COMMUNITY_OUTREACH.md](file:///d:/02_Projects/HD/HaydayMod/docs/COMMUNITY_OUTREACH.md) for community discussions.