#!/bin/bash
# generate-all.sh
# Master generator for ALL documentation, JS modules, and learning app scaffolding
DOCS_DIR="./docs"
JS_DIR="./js"
echo "๐ Creating directories..."
mkdir -p "$DOCS_DIR"
mkdir -p "$JS_DIR"
###############################################
# DOCUMENTATION GENERATION
###############################################
echo "๐ Generating documentation..."
cat << 'EOF' > "$DOCS_DIR/README.md"
# ๐ Diagnostics & Learning Platform โ README
A modular PHP diagnostics + learning system with:
- Debug engine
- Perf engine
- DB connection module
- Bootstrap 5 UI
- DataTables
- Learning app with steps, quizzes, notes, progress, dark mode
EOF
cat << 'EOF' > "$DOCS_DIR/DEVELOPER_GUIDE.md"
# ๐งโ๐ป Developer Guide
Coding standards, module responsibilities, error handling rules, architecture flow.
EOF
cat << 'EOF' > "$DOCS_DIR/ARCHITECTURE_GUIDE.md"
# ๐ Architecture Guide
System layers, module boundaries, error flow, perf/debug integration.
EOF
cat << 'EOF' > "$DOCS_DIR/CODING_STANDARDS.md"
# ๐งพ Coding Standards
Strict types, PSR-12, safe SQL, debug groups, perf usage, UI rules.
EOF
cat << 'EOF' > "$DOCS_DIR/MYSQL_GUIDE.md"
# ๐๏ธ MySQL Schema Guide
Expected schema, indexing strategy, query patterns, profiling interpretation.
EOF
cat << 'EOF' > "$DOCS_DIR/ROADMAP.md"
# ๐งญ Project Roadmap
Phases 1โ8: learning platform, diagnostics tools, UI/UX, interactive features, maintenance.
EOF
cat << 'EOF' > "$DOCS_DIR/TASKS.md"
# ๐ Task List
All actionable tasks for learning app, diagnostics framework, UI/UX, docs, tools.
EOF
cat << 'EOF' > "$DOCS_DIR/LEARN_DEBUG.md"
# ๐ง Learn Debug System
Debug levels, groups, formatting, logging.
EOF
cat << 'EOF' > "$DOCS_DIR/LEARN_PERF.md"
# โก Learn Performance System
Timers, SQL profiling, function profiling, perf summary.
EOF
cat << 'EOF' > "$DOCS_DIR/LEARN_SQL.md"
# ๐งฉ Learn SQL Diagnostics
Schema validation, SQL errors, profiling, indexes.
EOF
cat << 'EOF' > "$DOCS_DIR/LEARN_UI.md"
# ๐จ Learn UI System
Bootstrap 5, responsive design, DataTables.
EOF
cat << 'EOF' > "$DOCS_DIR/LEARN_ERRORS.md"
# ๐จ Learn Error Handling
Module-level catching, app-level SQL handling, DB errors.
EOF
cat << 'EOF' > "$DOCS_DIR/AI_GUIDE.md"
# ๐ค AI Integration Guide
AI-assisted docs, code review, SQL optimization, perf tuning.
EOF
cat << 'EOF' > "$DOCS_DIR/TROUBLESHOOTING.md"
# ๐ Troubleshooting Guide
Common DB, SQL, perf, debug, UI issues.
EOF
cat << 'EOF' > "$DOCS_DIR/SECURITY_GUIDE.md"
# ๐ Security Guide
SQL injection prevention, safe SELECT builder, error sanitization.
EOF
cat << 'EOF' > "$DOCS_DIR/RELEASE_NOTES.md"
# ๐ Release Notes
v1.0 โ Core modules, learning app, documentation generator.
EOF
echo "๐ Documentation generated."
###############################################
# JS MODULE GENERATION
###############################################
echo "๐ Generating JS modules..."
cat << 'EOF' > "$JS_DIR/markdown-viewer.js"
async function loadStepDoc(stepId) {
const config = await (await fetch('learning-config.json')).json();
const step = config.steps.find(s => s.id == stepId);
if (!step) return;
const response = await fetch('docs/' + step.doc);
const text = await response.text();
document.getElementById('docViewer').textContent = text;
localStorage.setItem('activeStep', stepId);
loadNotes(stepId);
updateProgressUI(stepId);
}
EOF
cat << 'EOF' > "$JS_DIR/progress.js"
function updateProgressUI(activeStepId) {
const cards = document.querySelectorAll('.step-card');
let completed = 0;
cards.forEach(card => {
const id = card.dataset.step;
const status = document.getElementById('status-' + id);
const done = !!localStorage.getItem('completed-' + id);
if (id == activeStepId) {
card.classList.add('step-active');
status.textContent = done ? 'Completed (Active)' : 'Active';
} else if (done) {
card.classList.add('step-complete');
status.textContent = 'Completed';
completed++;
} else {
card.classList.add('step-pending');
status.textContent = 'Pending';
}
});
const percent = Math.round((completed / cards.length) * 100);
const bar = document.getElementById('globalProgress');
bar.style.width = percent + '%';
bar.textContent = percent + '%';
}
EOF
cat << 'EOF' > "$JS_DIR/quiz-engine.js"
const QUIZZES = {
2: {
question: "What does debug.php handle?",
options: ["DB connections", "Perf profiling", "Debug formatting/logging", "UI rendering"],
answerIndex: 2
}
};
EOF
cat << 'EOF' > "$JS_DIR/theme.js"
document.addEventListener('DOMContentLoaded', () => {
const body = document.getElementById('body');
const toggle = document.getElementById('toggleTheme');
const saved = localStorage.getItem('theme') || 'light';
if (saved === 'dark') body.classList.add('dark-mode');
toggle.onclick = () => {
body.classList.toggle('dark-mode');
localStorage.setItem('theme', body.classList.contains('dark-mode') ? 'dark' : 'light');
};
});
EOF
echo "๐ JS modules generated."
###############################################
# LEARNING CONFIG GENERATION
###############################################
echo "๐ Generating learning-config.json..."
cat << 'EOF' > "learning-config.json"
{
"title": "Diagnostics Framework Learning Path",
"steps": [
{ "id": 1, "title": "Setup Environment", "description": "Install PHP, configure .env, run test apps.", "doc": "LEARN_SETUP_TASKS.md" },
{ "id": 2, "title": "Learn Debug System", "description": "Debug levels, groups, formatting.", "doc": "LEARN_DEBUG.md" },
{ "id": 3, "title": "Learn Performance System", "description": "SQL profiling, timers.", "doc": "LEARN_PERF.md" },
{ "id": 4, "title": "Learn SQL Diagnostics", "description": "Schema validation, SQL errors.", "doc": "LEARN_SQL.md" },
{ "id": 5, "title": "Learn Architecture", "description": "Module boundaries, error flow.", "doc": "ARCHITECTURE_GUIDE.md" }
]
}
EOF
###############################################
# LEARNING APP SCAFFOLDING
###############################################
echo "๐ Generating learning-app.php..."
cat << 'EOF' > "learning-app.php"
<?= htmlspecialchars($title) ?>
EOF
echo "๐ ALL FILES GENERATED SUCCESSFULLY!"