refactor(repo): reorganize repository structure for improved navigation and maintainability

Implement comprehensive directory reorganization to improve discoverability,
logical grouping, and separation of concerns across documentation, scripts,
and infrastructure snapshots.

Major Changes:

1. Documentation Reorganization:
   - Created start-here-docs/ for onboarding documentation
     * Moved QUICK-START.md, START-HERE.md, GIT-SETUP-GUIDE.md
     * Moved GIT-QUICK-REFERENCE.md, SCRIPT-USAGE.md, SETUP-COMPLETE.md
   - Created troubleshooting/ directory
     * Moved BUGFIX-SUMMARY.md for centralized issue resolution
   - Created mcp/ directory for Model Context Protocol configurations
     * Moved OBSIDIAN-MCP-SETUP.md to mcp/obsidian/

2. Scripts Reorganization:
   - Created scripts/crawlers-exporters/ for infrastructure collection
     * Moved collect*.sh scripts and collection documentation
     * Consolidates Proxmox homelab export tooling
   - Created scripts/fixers/ for operational repair scripts
     * Moved fix_n8n_db_*.sh scripts
     * Isolated scripts with embedded credentials (templates tracked)
   - Created scripts/qol/ for quality-of-life utilities
     * Moved git-aliases.sh and git-first-commit.sh

3. Infrastructure Snapshots:
   - Created disaster-recovery/ for active infrastructure state
     * Moved latest homelab-export-20251202-204939/ snapshot
     * Contains current VM/CT configurations and system state
   - Created archive-homelab/ for historical snapshots
     * Moved homelab-export-*.tar.gz archives
     * Preserves point-in-time backups for reference

4. Agent Definitions:
   - Created sub-agents/ directory
     * Added backend-builder.md (development agent)
     * Added lab-operator.md (infrastructure operations agent)
     * Added librarian.md (git/version control agent)
     * Added scribe.md (documentation agent)

5. Updated INDEX.md:
   - Reflects new directory structure throughout
   - Updated all file path references
   - Enhanced navigation with new sections
   - Added agent roles documentation
   - Updated quick reference commands

6. Security Improvements:
   - Updated .gitignore to match reorganized file locations
   - Corrected path for scripts/fixers/fix_n8n_db_c_locale.sh exclusion
   - Maintained template-based credential management pattern

Infrastructure State Update:
   - Latest snapshot: 2025-12-02 20:49:54
   - Removed: VM 101 (gitlab), CT 112 (Anytype)
   - Added: CT 113 (n8n)
   - Total: 9 VMs, 3 Containers

Impact:
   - Improved repository navigation and discoverability
   - Logical separation of documentation, scripts, and snapshots
   - Clearer onboarding path for new users
   - Enhanced maintainability through organized structure
   - Foundation for multi-agent workflow support

Files changed: 90 files (+935/-349)
   - 3 modified, 14 new files, 73 renames/moves

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-12-02 21:39:33 -07:00
parent eec4c4b298
commit 4f69420aaa
90 changed files with 935 additions and 349 deletions

View File

@@ -0,0 +1 @@
[{"cpu":0.0145668121932816,"disk":0,"diskread":8754925056,"diskwrite":98623655936,"id":"qemu/100","maxcpu":4,"maxdisk":107374182400,"maxmem":8598323200,"mem":8118095872,"name":"docker-hub","netin":10940443180,"netout":433401918,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":5471864,"vmid":100},{"cpu":0.000396259427189655,"disk":756023296,"diskread":56942592,"diskwrite":0,"id":"lxc/102","maxcpu":1,"maxdisk":2147483648,"maxmem":2147483648,"mem":111960064,"name":"nginx","netin":6466470348,"netout":1025645316,"node":"serviceslab","status":"running","template":0,"type":"lxc","uptime":6223975,"vmid":102},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"lxc/103","maxcpu":2,"maxdisk":4294967296,"maxmem":2147483648,"mem":0,"name":"netbox","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"community-script;network","template":0,"type":"lxc","uptime":0,"vmid":103},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/104","maxcpu":2,"maxdisk":34359738368,"maxmem":5242880000,"mem":0,"name":"ubuntu-dev","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"template","template":1,"type":"qemu","uptime":0,"vmid":104},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/105","maxcpu":4,"maxdisk":34359738368,"maxmem":16777216000,"mem":0,"name":"dev","netin":0,"netout":0,"node":"serviceslab","status":"stopped","template":0,"type":"qemu","uptime":0,"vmid":105},{"cpu":0.00859680719603501,"disk":0,"diskread":20044764516,"diskwrite":44196287488,"id":"qemu/106","maxcpu":2,"maxdisk":34359738368,"maxmem":4294967296,"mem":3740889088,"name":"Ansible-Control","netin":8096398402,"netout":77216446,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2712772,"vmid":106},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/107","maxcpu":2,"maxdisk":53687091200,"maxmem":4294967296,"mem":0,"name":"ubuntu-docker","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"template","template":1,"type":"qemu","uptime":0,"vmid":107},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/108","maxcpu":4,"maxdisk":107374182400,"maxmem":33554432000,"mem":0,"name":"CML","netin":0,"netout":0,"node":"serviceslab","status":"stopped","template":0,"type":"qemu","uptime":0,"vmid":108},{"cpu":0.0315216263854617,"disk":0,"diskread":572292626,"diskwrite":1008925696,"id":"qemu/109","maxcpu":1,"maxdisk":34359738368,"maxmem":2147483648,"mem":209444864,"name":"web-server-01","netin":4917297893,"netout":3941494,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2697856,"vmid":109},{"cpu":0.00477600399779723,"disk":0,"diskread":5130442360,"diskwrite":21638925824,"id":"qemu/110","maxcpu":1,"maxdisk":34359738368,"maxmem":4294967296,"mem":2422759424,"name":"web-server-02","netin":6548190260,"netout":24100161,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2692898,"vmid":110},{"cpu":0.00668640559691612,"disk":0,"diskread":4973196920,"diskwrite":22098824704,"id":"qemu/111","maxcpu":1,"maxdisk":34359738368,"maxmem":4294967296,"mem":2348294144,"name":"db-server-01","netin":6555995304,"netout":20880204,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2691960,"vmid":111},{"cpu":0.000594389140784483,"disk":2294022144,"diskread":0,"diskwrite":114688,"id":"lxc/113","maxcpu":2,"maxdisk":21474836480,"maxmem":4294967296,"mem":498679808,"name":"n8n","netin":1092635479,"netout":20852346,"node":"serviceslab","status":"running","template":0,"type":"lxc","uptime":201526,"vmid":113},{"cgroup-mode":2,"cpu":0.00678020181071272,"disk":6814695424,"id":"node/serviceslab","level":"","maxcpu":24,"maxdisk":46104727552,"maxmem":185885036544,"mem":84348379136,"node":"serviceslab","status":"online","type":"node","uptime":6224083},{"content":"images,rootdir","disk":7064466,"id":"storage/serviceslab/local-lvm","maxdisk":70644662272,"node":"serviceslab","plugintype":"lvmthin","shared":0,"status":"available","storage":"local-lvm","type":"storage"},{"content":"images,rootdir","disk":499600146432,"id":"storage/serviceslab/Vault","maxdisk":4655744548864,"node":"serviceslab","plugintype":"zfspool","shared":0,"status":"available","storage":"Vault","type":"storage"},{"content":"iso","disk":47877980160,"id":"storage/serviceslab/iso-share","maxdisk":3377758994432,"node":"serviceslab","plugintype":"nfs","shared":1,"status":"available","storage":"iso-share","type":"storage"},{"content":"vztmpl,backup,iso","disk":6814699520,"id":"storage/serviceslab/local","maxdisk":46104727552,"node":"serviceslab","plugintype":"dir","shared":0,"status":"available","storage":"local","type":"storage"},{"content":"backup","disk":251594371072,"id":"storage/serviceslab/PBS-Backups","maxdisk":1033536913408,"node":"serviceslab","plugintype":"pbs","shared":1,"status":"available","storage":"PBS-Backups","type":"storage"},{"id":"sdn/serviceslab/localnetwork","node":"serviceslab","sdn":"localnetwork","status":"ok","type":"sdn"}]