gandalf/secubox-openwrt
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
107 Commits 4 Branches 293 Tags 320 MiB
58a6bcba73
Commit Graph

2 Commits

Author SHA1 Message Date
CyberMind-FR
58a6bcba73 docs: add critical pre-deployment checks and common error solutions 
Added comprehensive pre-deployment verification to prevent common issues:

🔍 Pre-Deployment Checks (CRITICAL)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Disk Space Verification
   - Check overlay usage before deployment
   - Stop if ≥90% full
   - Emergency cleanup procedures

2. Permissions Verification (Prevent HTTP 403)
   - RPCD: 755 (rwxr-xr-x)
   - CSS/JS: 644 (rw-r--r--)
   - Common error: Files created with 600 instead of 644
   - Symptom: HTTP 403 Forbidden on resource loading

3. Post-Deployment Verification
   - 6-point checklist script
   - Verify disk space, permissions, ubus objects
   - Automated validation

4. Common Deployment Errors Table
   - HTTP 403 Forbidden → Permission fix
   - No space left → Cleanup procedure
   - Object not found → RPCD permission check
   - Module not appearing → Cache clearing
   - Changes not visible → Browser cache

5. Emergency Disk Space Recovery
   - Analysis commands
   - Cleanup procedures
   - Netdata web UI removal option (saves 22MB)

📝 Files Updated:
- DEVELOPMENT-GUIDELINES.md: Added ~175 lines at section 9
- QUICK-START.md: Added rules #4 and #5

Based on real deployment issues encountered:
- Router overlay 100% full (98.8M/98.8M)
- HTTP 403 on netdata-dashboard (permissions 600 vs 644)
- Common.css deployment failures due to space

These checks are now MANDATORY before any deployment.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-26 20:40:28 +01:00
CyberMind-FR
8e53825ad5 release: v0.2.2 - Design System v0.3.0 & Comprehensive Documentation 
🎨 Design System v0.3.0 (Demo-inspired)
- New dark palette: #0a0a0f, #6366f1→#8b5cf6 gradients
- Typography: Inter + JetBrains Mono
- Compact stats grid (130px min)
- Gradient text effects with background-clip
- Sticky navigation tabs
- Enhanced card borders and hover effects

📚 Comprehensive Documentation Suite
- DEVELOPMENT-GUIDELINES.md (33KB, 900+ lines)
  - 9 major sections: Design, Architecture, RPCD, ACL, JS, CSS, Errors, Validation, Deployment
  - Complete code templates and best practices
  - Common error diagnostics and solutions
- QUICK-START.md (6.4KB)
  - 8 critical rules for immediate reference
  - Quick code templates
  - Error quick fixes table
- deploy-module-template.sh (8.1KB)
  - Standardized deployment with automatic backup
  - Permission fixes, cache clearing, verification
- Updated CLAUDE.md, README.md with documentation index
- Updated .claude/README.md to v2.0

🔄 Version Updates
- luci-app-secubox: 0.1.2 → 0.2.2
- luci-app-system-hub: 0.1.1 → 0.2.2
- Updated all version strings (api.js, overview.js, CSS files)

🎯 CSS Enhancements
- common.css: Complete rewrite with demo palette
- overview.css: Dashboard header with gradient
- services.css: Updated version to 0.2.2
- components.css: Updated version to 0.2.2

🔧 Critical Rules Documented
1. RPCD naming: file = ubus object (luci. prefix)
2. Menu path = view file location
3. Permissions: 755 (RPCD), 644 (CSS/JS)
4. ALWAYS run validate-modules.sh
5. CSS variables only (no hardcode)
6. Dark mode mandatory
7. Typography: Inter + JetBrains Mono
8. Gradients: --sh-primary → --sh-primary-end

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-26 18:55:19 +01:00