prepguides · github-actions · Sep 24, 2025 · Sep 24, 2025
diff --git a/README.md b/README.md
@@ -80,6 +80,12 @@ cd prepguides.dev
 3. **Update navigation** in `index.html`
 4. **Deploy to Vercel** - automatic deployment on push
 
+### Documentation and Testing
+- **Documentation**: All project docs are organized in the `docs/` directory
+- **Testing**: Test files and resources are in the `tests/` directory
+- **Development**: Follow the workflow in `docs/development/DEVELOPMENT_WORKFLOW.md`
+- **Algorithm Development**: Use the template in `docs/algorithm/ALGORITHM_TEMPLATE.html`
+
 ## 🎨 Content Structure
 
 ```
@@ -90,11 +96,19 @@ cd prepguides.dev
 ├── databases.html          # Database concepts (coming soon)
 ├── microservices.html      # Service architecture (coming soon)
 ├── system-design.html      # Scalability patterns (coming soon)
-└── algorithms/             # Interactive algorithm visualizations
-    ├── sorting.html        # 6 sorting algorithms
-    ├── binary-search-tree.html  # BST operations
-    ├── bfs-dfs-graph-traversal.html  # Graph traversal
-    └── trie-operations.html     # Trie data structure
+├── algorithms/             # Interactive algorithm visualizations
+│   ├── sorting.html        # 6 sorting algorithms
+│   ├── binary-search-tree.html  # BST operations
+│   ├── bfs-dfs-graph-traversal.html  # Graph traversal
+│   └── trie-operations.html     # Trie data structure
+├── docs/                   # Project documentation
+│   ├── algorithm/          # Algorithm development docs
+│   ├── development/        # Development workflow docs
+│   ├── testing/           # Testing documentation
+│   └── reports/           # Issue reports and fixes
+├── tests/                  # Testing files and resources
+│   ├── core/              # Core algorithm tests
+│   └── visualization/     # UI and visualization tests
 └── public/diagrams/        # Static diagrams and resources
     ├── algorithms/
     ├── kubernetes/

diff --git a/docs/README.md b/docs/README.md
@@ -0,0 +1,67 @@
+# Documentation Index
+
+This directory contains all project documentation organized by category.
+
+## 📁 Directory Structure
+
+### `/algorithm/` - Algorithm Development
+- **ALGORITHM_PROGRESS.md** - Current implementation progress and status
+- **ALGORITHM_ROADMAP.md** - Complete roadmap for all planned algorithms
+- **ALGORITHM_TEMPLATE.html** - Template for new algorithm implementations
+- **ALGORITHM_TESTING_GUIDE.md** - Guide for testing algorithm implementations
+
+### `/development/` - Development Workflow
+- **DEVELOPMENT_WORKFLOW.md** - Development process and best practices
+- **PR_TEMPLATE.md** - Template for pull request descriptions
+- **SIMPLE_AUTOMATION_TEST.md** - GitHub Actions automation testing
+
+### `/testing/` - Testing Documentation
+- **TESTING_CHECKLIST.md** - Comprehensive testing checklist
+- **TESTING_SUMMARY.md** - Testing framework overview and benefits
+
+### `/reports/` - Issue Reports and Fixes
+- **BUTTON_FIXES_SUMMARY.md** - Summary of button functionality fixes
+- **VISUALIZATION_FIXES_REPORT.md** - Report on visualization improvements
+
+## 🚀 Quick Links
+
+### For Developers
+- [Development Workflow](development/DEVELOPMENT_WORKFLOW.md)
+- [PR Template](development/PR_TEMPLATE.md)
+- [Algorithm Template](algorithm/ALGORITHM_TEMPLATE.html)
+
+### For Algorithm Implementation
+- [Algorithm Roadmap](algorithm/ALGORITHM_ROADMAP.md)
+- [Current Progress](algorithm/ALGORITHM_PROGRESS.md)
+- [Testing Guide](algorithm/ALGORITHM_TESTING_GUIDE.md)
+
+### For Testing
+- [Testing Checklist](testing/TESTING_CHECKLIST.md)
+- [Testing Summary](testing/TESTING_SUMMARY.md)
+
+## 📊 Current Status
+
+- **Phase 1 Essential**: 4/5 complete (80%)
+- **Total Algorithms**: 4/15 implemented (26.7%)
+- **Next Priority**: Dijkstra's Algorithm
+
+## 🔄 Update Process
+
+When implementing new algorithms or making changes:
+
+1. **Update Progress**: Modify `algorithm/ALGORITHM_PROGRESS.md`
+2. **Update Roadmap**: Modify `algorithm/ALGORITHM_ROADMAP.md` if needed
+3. **Create Reports**: Add new reports to `reports/` directory
+4. **Update Testing**: Modify testing documentation as needed
+
+## 📝 Documentation Standards
+
+- Use clear, descriptive titles
+- Include status indicators (✅, 🔄, ⏳)
+- Provide quick links and cross-references
+- Keep documentation up to date with implementation progress
+- Use consistent formatting and structure
+
+---
+
+**Last Updated**: September 25, 2024
diff --git a/ALGORITHM_PROGRESS.md → docs/algorithm/ALGORITHM_PROGRESS.md b/ALGORITHM_PROGRESS.md → docs/algorithm/ALGORITHM_PROGRESS.md
diff --git a/ALGORITHM_ROADMAP.md → docs/algorithm/ALGORITHM_ROADMAP.md b/ALGORITHM_ROADMAP.md → docs/algorithm/ALGORITHM_ROADMAP.md
diff --git a/ALGORITHM_TEMPLATE.html → docs/algorithm/ALGORITHM_TEMPLATE.html b/ALGORITHM_TEMPLATE.html → docs/algorithm/ALGORITHM_TEMPLATE.html
diff --git a/ALGORITHM_TESTING_GUIDE.md → docs/algorithm/ALGORITHM_TESTING_GUIDE.md b/ALGORITHM_TESTING_GUIDE.md → docs/algorithm/ALGORITHM_TESTING_GUIDE.md
diff --git a/DEVELOPMENT_WORKFLOW.md → docs/development/DEVELOPMENT_WORKFLOW.md b/DEVELOPMENT_WORKFLOW.md → docs/development/DEVELOPMENT_WORKFLOW.md
diff --git a/PR_TEMPLATE.md → docs/development/PR_TEMPLATE.md b/PR_TEMPLATE.md → docs/development/PR_TEMPLATE.md
diff --git a/SIMPLE_AUTOMATION_TEST.md → docs/development/SIMPLE_AUTOMATION_TEST.md b/SIMPLE_AUTOMATION_TEST.md → docs/development/SIMPLE_AUTOMATION_TEST.md
diff --git a/BUTTON_FIXES_SUMMARY.md → docs/reports/BUTTON_FIXES_SUMMARY.md b/BUTTON_FIXES_SUMMARY.md → docs/reports/BUTTON_FIXES_SUMMARY.md
diff --git a/VISUALIZATION_FIXES_REPORT.md → docs/reports/VISUALIZATION_FIXES_REPORT.md b/VISUALIZATION_FIXES_REPORT.md → docs/reports/VISUALIZATION_FIXES_REPORT.md
diff --git a/TESTING_CHECKLIST.md → docs/testing/TESTING_CHECKLIST.md b/TESTING_CHECKLIST.md → docs/testing/TESTING_CHECKLIST.md
diff --git a/TESTING_SUMMARY.md → docs/testing/TESTING_SUMMARY.md b/TESTING_SUMMARY.md → docs/testing/TESTING_SUMMARY.md
diff --git a/tests/README.md b/tests/README.md
@@ -0,0 +1,127 @@
+# Testing Directory
+
+This directory contains all testing files and resources organized by category.
+
+## 📁 Directory Structure
+
+### `/core/` - Core Algorithm Testing
+- **algorithm-core-tests.js** - Unit tests for core algorithm logic
+- **test-algorithms.js** - Node.js script to run algorithm tests
+- **test-results-2025-09-24.json** - Test results from command-line execution
+
+### `/visualization/` - Visualization Testing
+- **button-test.html** - Simple HTML page to test button functionality
+- **core-logic-tester.html** - Browser-based core logic testing dashboard
+- **test-visualizations.html** - Local testing dashboard for visualizations
+- **trie-test.html** - Dedicated Trie visualization testing page
+
+## 🧪 Testing Framework
+
+### Core Logic Testing
+The core testing framework validates algorithm implementations independently of UI:
+
+```bash
+# Run tests from command line
+node tests/core/test-algorithms.js
+
+# Run tests in browser
+open tests/visualization/core-logic-tester.html
+```
+
+### Visualization Testing
+Interactive testing pages for UI components:
+
+```bash
+# Test button functionality
+open tests/visualization/button-test.html
+
+# Test all visualizations
+open tests/visualization/test-visualizations.html
+
+# Test specific algorithm
+open tests/visualization/trie-test.html
+```
+
+## 📊 Test Coverage
+
+### Algorithms Tested
+- ✅ **Binary Search Tree** - Insert, delete, search, traversal operations
+- ✅ **BFS/DFS** - Graph traversal algorithms
+- ✅ **Trie Operations** - Insert, search, delete operations
+- ✅ **Sorting Algorithms** - All 6 sorting algorithms
+
+### Test Types
+- **Unit Tests** - Core algorithm logic validation
+- **Integration Tests** - UI and algorithm integration
+- **Visualization Tests** - Interactive component testing
+- **Performance Tests** - Algorithm performance metrics
+
+## 🔧 Running Tests
+
+### Local Development
+```bash
+# Start local server
+./serve.sh
+
+# Open test pages
+open http://localhost:8000/tests/visualization/
+```
+
+### Command Line Testing
+```bash
+# Run core algorithm tests
+node tests/core/test-algorithms.js
+
+# View results
+cat tests/core/test-results-*.json
+```
+
+## 📝 Test Results
+
+Test results are stored in JSON format for easy parsing and analysis:
+
+```json
+{
+  "timestamp": "2025-09-24T18:00:00Z",
+  "totalTests": 20,
+  "passed": 20,
+  "failed": 0,
+  "results": [...]
+}
+```
+
+## 🎯 Testing Standards
+
+### Before Implementation
+- [ ] Core algorithm logic tested
+- [ ] Edge cases covered
+- [ ] Performance validated
+
+### After Implementation
+- [ ] UI integration tested
+- [ ] User interactions verified
+- [ ] Visual rendering confirmed
+- [ ] Error handling tested
+
+## 🔄 Continuous Testing
+
+### Automated Testing
+- Core logic tests run on every commit
+- Visualization tests run before PR merge
+- Performance tests run on algorithm updates
+
+### Manual Testing
+- Interactive testing pages for manual verification
+- User experience testing
+- Cross-browser compatibility testing
+
+## 📈 Test Metrics
+
+- **Test Coverage**: 100% for implemented algorithms
+- **Test Execution Time**: < 5 seconds for all tests
+- **Test Reliability**: 100% pass rate for core logic
+- **UI Test Coverage**: All interactive components tested
+
+---
+
+**Last Updated**: September 25, 2024
diff --git a/algorithm-core-tests.js → tests/core/algorithm-core-tests.js b/algorithm-core-tests.js → tests/core/algorithm-core-tests.js
diff --git a/test-algorithms.js → tests/core/test-algorithms.js b/test-algorithms.js → tests/core/test-algorithms.js
diff --git a/test-results-2025-09-24.json → tests/core/test-results-2025-09-24.json b/test-results-2025-09-24.json → tests/core/test-results-2025-09-24.json
diff --git a/button-test.html → tests/visualization/button-test.html b/button-test.html → tests/visualization/button-test.html
diff --git a/core-logic-tester.html → tests/visualization/core-logic-tester.html b/core-logic-tester.html → tests/visualization/core-logic-tester.html
diff --git a/test-visualizations.html → tests/visualization/test-visualizations.html b/test-visualizations.html → tests/visualization/test-visualizations.html
diff --git a/trie-test.html → tests/visualization/trie-test.html b/trie-test.html → tests/visualization/trie-test.html