azcomputerguru/claudetools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
dca6562bc54c7a8784f3f28a77ab6c7b6e965df5
claudetools/wiki/overview.md
Mike Swanson 2f99a01e7e wiki: correct GuruRMM fleet state and enrolled client list from live API 
- Remove stale BB-SERVER/RECEPTIONIST-PC laggard note (both on 0.6.38)
- Add actual laggards (15 offline agents on older versions)
- Replace 4-entry enrolled sites list with full 12-client table from live API
- Note Saturn agent not present in API (concern resolved)
- Update overview.md fleet count and client table to match

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-24 16:48:24 -07:00

176 lines
9.4 KiB
Markdown
Raw Blame History

---
type: overview
name: overview
display_name: ClaudeTools Overview
last_compiled: 2026-05-24
compiled_by: DESKTOP-0O8A1RL/claude-main
sources:
- wiki/clients/cascades-tucson.md
- wiki/projects/gururmm.md
- wiki/systems/gururmm-build.md
- wiki/systems/jupiter.md
- wiki/systems/pluto.md
- wiki/systems/uranus.md
- .claude/CLAUDE.md
---
# ClaudeTools Overview
Cold-start orientation for Arizona Computer Guru LLC. Read this first. Follow backlinks into individual wiki articles for depth.
---
## Business
**Arizona Computer Guru LLC** — managed service provider based in Tucson, AZ. Two-person operation. Primary business model: monthly MSP contracts + prepaid hour blocks. Side track: internal tooling developed for external productization (GuruRMM, GuruPSA).
---
## Team
| Person | Handle | Role | Notes |
|---|---|---|---|
| Mike Swanson | mike | Owner / President / admin | Primary developer; runs GuruRMM dev, ClaudeTools, infrastructure |
| Howard Enos | howard | Technician / employee | Field work, Cascades onsite, billing, client tickets; full system trust |
Shared Gitea push account: `azcomputerguru`. Commits tracked by author (git config per machine).
---
## Clients
| Client | Type | Status | Notes |
|---|---|---|---|
| [Cascades of Tucson](clients/cascades-tucson.md) | Corporate — prepaid block $175/hr | Active | Dept-by-dept domain migration, HIPAA, M365 relicensing. Highest-complexity engagement. 27 GuruRMM agents. |
| BirthBiologic | Corporate | Active | GuruRMM enrolled (BB-SERVER, site Main Office) |
| Dataforth Corp | Corporate | Active | GuruRMM enrolled (AD2, DF-GAGETRAK, site D1). Dataforth D2 also hosts Neptune (ACG mail server). |
| Grabb & Durando Law Office | Corporate | Active | GuruRMM enrolled (GND-SERVER, site Main Office) |
| Instrumental Music Center | Corporate | Active | GuruRMM enrolled (IMC1, site IMCMain) |
| Safesite | Corporate | Active | GuruRMM enrolled (MSI, site Glendale) |
| Sombra Residential LLC | Corporate | Active | GuruRMM enrolled (DESKTOP-UQRN4K3, Server2013) |
| Stamback Septic | Corporate | Active | GuruRMM enrolled (DESKTOP-BTR2AM3, StambackLaptopNew) |
| Key, Paul | Residential | Active | GuruRMM enrolled (KEY-MEDIA, site Home) |
| Peaceful Spirit | Residential | Active | GuruRMM enrolled (5 agents across Bridgette Home, Country Club, Mara Home sites) |
| Swanson, Len | Residential | Active | GuruRMM enrolled (LAS-GAMER, site Home) |
**Cascades** is the highest-complexity engagement. See [[clients/cascades-tucson]] for full detail. All other clients are wiki-unseed as of 2026-05-24.
---
## Internal Projects
### GuruRMM
[[projects/gururmm]] — Remote Monitoring & Management platform. Rust/Axum server + React dashboard + cross-platform Rust agent. Production-deployed. ~55 enrolled agents across client sites and ACG internal machines. Current version: **0.6.38** (2026-05-24).
| Layer | URL / Location | Tech |
|---|---|---|
| API server | http://172.16.3.30:3001 / https://rmm-api.azcomputerguru.com | Rust, Axum |
| Dashboard | https://rmm.azcomputerguru.com | React, TypeScript, Vite, shadcn/ui, Tailwind v4 |
| Database | postgres://localhost:5432/gururmm on 172.16.3.30 | PostgreSQL 14 |
| Gitea repo | http://172.16.3.20:3000/azcomputerguru/gururmm | active; `D:\claudetools\projects\msp-tools\guru-rmm` is a stale reference copy |
| Build webhook | 172.16.3.30:9000 | webhook-handler.py → per-platform build scripts |
| Windows builds | Pluto (172.16.3.36) | Rust MSVC + WiX v4 |
**Fleet (2026-05-24 live):** 55 agents across 12 clients, 37 online, 40/55 on v0.6.38. 15 laggards — all offline, self-update on reconnect.
Active development focus: tray IPC peer authorization, watchdog alerts UI (2 missing server routes), MSP360 management phase.
Critical security backlog: `credentials/:id/reveal` (horizontal privilege escalation, HIGH) and `internal_err()` (~130 raw DB error exposures, HIGH).
### ClaudeTools
MSP work-tracking system and internal tooling platform. Production-ready.
| Layer | URL / Location | Tech |
|---|---|---|
| API | http://172.16.3.30:8001 | FastAPI / Python |
| Coord API | http://172.16.3.30:8001/api/coord | FastAPI (within ClaudeTools API) |
| Database | MariaDB 10.6.22 @ 172.16.3.30:3306, DB: claudetools | MariaDB |
| Schema | 95+ endpoints, 38 tables, JWT auth, AES-256-GCM encryption | — |
Coord API is the live inter-session coordination layer — tracks project locks, component states, and cross-session messages. All Claude sessions check and write to it.
---
## ACG Infrastructure
All systems reside on ACG office LAN (`172.16.x.x`). pfSense at 172.16.0.1 is the router, DNS server, and Tailscale subnet router for remote access.
| System | IP | Role | Article |
|---|---|---|---|
| Jupiter | 172.16.3.20 | Unraid primary NAS; virsh host for all VMs; Docker: Gitea (:3000), NPM (:7818), Seafile (:8082) | [[systems/jupiter]] |
| gururmm-build | 172.16.3.30 | Linux VM on Jupiter; GuruRMM API :3001, ClaudeTools API :8001, MariaDB :3306, PostgreSQL :5432, build pipeline :9000 | [[systems/gururmm-build]] |
| Pluto / Claude-Builder | 172.16.3.36 | Windows Server 2019 VM on Jupiter; sole Windows MSI + cargo build server for GuruRMM | [[systems/pluto]] |
| Uranus | 172.16.3.21 | Unraid secondary (Dell R730xd); OwnCloud archive storage only; RAM too low for any VM hosting | [[systems/uranus]] |
| Neptune | 172.16.3.11 / 67.206.163.124 | Exchange Server 2016; ACG mail server for hosted clients; physically colocated at Dataforth D2 | *(article not yet seeded)* |
| OwnCloud VM | 172.16.3.22 | OwnCloud (cloud.acghosting.com); storage backed by Uranus SMB share `Storage` | *(article not yet seeded)* |
| Saturn | DECOMMISSIONED | Was 172.16.3.21; IP reused by Uranus, Apr 2026. Any "Saturn" reference in GuruRMM fleet is stale or actually Uranus. | — |
**Neptune note:** ACG infrastructure physically located at Dataforth D2. Dataforth's UDM uses an overlapping 172.16.x.x subnet. Internal access to Neptune from the ACG office requires routing through D2TESTNAS. **TODO:** resubnet Dataforth UDM to eliminate the overlap.
**Gitea internal URL:** Always use `http://172.16.3.20:3000` for API calls and curl. `git.azcomputerguru.com` is Cloudflare-fronted and blocks direct curl.
---
## Tooling & Stack
| Tool | Purpose | Where |
|---|---|---|
| SOPS vault | Encrypted secrets storage; wraps age-encrypted YAML files | `D:/vault/` on Windows; vault.sh wrapper reads machine path from `.claude/identity.json` |
| 1Password | Secondary credential store (service account in vault) | `op://Infrastructure/...` references |
| Gitea | Self-hosted Git; all active repos | http://172.16.3.20:3000 |
| GuruRMM | Agent deployment, command execution, fleet monitoring | https://rmm.azcomputerguru.com |
| Syncro | PSA / ticketing / billing | External SaaS; API base documented in `.claude/REFERENCE.md` |
| GrepAI | Semantic search over session logs, wiki, `.claude/` | `grepai.exe search` / MCP tools; indexes auto on file change |
| Ollama | Local LLM — prose, summaries, classification; Tier 0 model routing | localhost:11434 (DESKTOP-0O8A1RL) / 100.92.127.64:11434 (Tailscale) |
| Tailscale | Remote access and cross-machine LAN | Subnet router on pfSense (172.16.0.1) |
---
## Key URLs Quick Reference
| Resource | URL |
|---|---|
| GuruRMM dashboard | https://rmm.azcomputerguru.com |
| GuruRMM API (internal) | http://172.16.3.30:3001 |
| ClaudeTools API | http://172.16.3.30:8001 |
| Coord API | http://172.16.3.30:8001/api/coord |
| Gitea (internal) | http://172.16.3.20:3000 |
| NPM admin | http://172.16.3.20:7818 |
| Unraid (Jupiter) | http://172.16.3.20 |
| Unraid (Uranus) | http://172.16.3.21 |
| OwnCloud | https://cloud.acghosting.com |
---
## Cross-Cutting Open Action Items
These are open items that span multiple systems or clients, as of 2026-05-24. See individual articles for full detail.
| Item | Priority | Owner | Reference |
|---|---|---|---|
| Fix NPM proxy: `rmm-api.azcomputerguru.com` still points to 172.16.3.20:3001; should be 172.16.3.30:3001 | High | Mike | [[systems/jupiter]] |
| Verify and clean up "Saturn" GuruRMM agent entry | Medium | Mike | [[systems/uranus]], [[projects/gururmm]] |
| Resubnet Dataforth UDM (eliminate 172.16.x.x overlap with ACG office LAN) | Medium | Mike | [[systems/gururmm-build]] (Neptune note) |
| Cascades: exit Entra Connect from staging mode | High | Mike/Howard | [[clients/cascades-tucson]] |
| Cascades: M365 relicensing (31 SPB seats time-sensitive) | High | Mike | [[clients/cascades-tucson]] |
| Cascades: ALIS SSO — blocked on Medtelligent | Medium | Mike | [[clients/cascades-tucson]] |
| Cascades: break-glass accounts + YubiKeys | Medium | Howard | [[clients/cascades-tucson]] |
| Cascades: audit retention infra (LAW 90d + Storage 6yr) | Medium | Mike | [[clients/cascades-tucson]] |
| GuruRMM: fix `credentials/:id/reveal` privilege escalation | High | Mike | [[projects/gururmm]] |
| GuruRMM: fix `internal_err()` at ~130 call sites | High | Mike | [[projects/gururmm]] |
| GuruRMM: auto-update reliability for BB-SERVER + RECEPTIONIST-PC | Medium | Mike | [[projects/gururmm]] |
| Seed wiki articles: system:neptune, client:birthbiologic, client:key-paul | Low | — | wiki/index.md |
---
## Backlinks
- [[clients/cascades-tucson]] — primary active client
- [[projects/gururmm]] — primary active project
- [[systems/jupiter]] — Unraid primary, VM host
- [[systems/gururmm-build]] — GuruRMM + ClaudeTools API host
- [[systems/pluto]] — Windows build server
- [[systems/uranus]] — OwnCloud storage node
Reference in New Issue View Git Blame Copy Permalink