Complete project organization: move all DOS files to projects/dataforth-dos, create client folders, update Claude config
This commit is contained in:
211
PROJECT_ORGANIZATION.md
Normal file
211
PROJECT_ORGANIZATION.md
Normal file
@@ -0,0 +1,211 @@
|
||||
# ClaudeTools - Project Organization Index
|
||||
|
||||
**Last Updated:** 2026-01-20
|
||||
**Purpose:** Master index for all projects, clients, and session data
|
||||
|
||||
---
|
||||
|
||||
## Folder Structure
|
||||
|
||||
```
|
||||
D:\ClaudeTools/
|
||||
├── clients/ # Client-specific information
|
||||
│ ├── dataforth/ # Dataforth client (DOS project)
|
||||
│ └── horseshoe-management/ # Horseshoe Management client
|
||||
│
|
||||
├── projects/ # Project-specific work
|
||||
│ ├── dataforth-dos/ # Dataforth DOS Update System
|
||||
│ │ ├── batch-files/ # DOS .BAT files (17 files)
|
||||
│ │ ├── deployment-scripts/ # PowerShell deployment scripts (33 files)
|
||||
│ │ ├── documentation/ # Technical docs (8 files)
|
||||
│ │ └── session-logs/ # DOS-specific session logs
|
||||
│ │
|
||||
│ └── claudetools-api/ # ClaudeTools MSP API
|
||||
│ ├── api/ # FastAPI application
|
||||
│ ├── migrations/ # Alembic database migrations
|
||||
│ └── session-logs/ # API-specific session logs
|
||||
│
|
||||
├── session-logs/ # General cross-project session logs
|
||||
│ └── YYYY-MM-DD-session.md # Daily session logs
|
||||
│
|
||||
├── .claude/ # Claude Code configuration
|
||||
│ ├── commands/ # Custom commands (/save, /context, etc.)
|
||||
│ ├── skills/ # Custom skills
|
||||
│ └── templates/ # Templates
|
||||
│
|
||||
├── credentials.md # Centralized credentials (UNREDACTED)
|
||||
├── SESSION_STATE.md # Overall project state tracker
|
||||
└── PROJECT_ORGANIZATION.md # This file
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Quick Navigation
|
||||
|
||||
### By Client
|
||||
|
||||
**Dataforth:**
|
||||
- Client Folder: `clients/dataforth/`
|
||||
- Project: `projects/dataforth-dos/`
|
||||
- Index: `projects/dataforth-dos/PROJECT_INDEX.md`
|
||||
|
||||
**Horseshoe Management:**
|
||||
- Client Folder: `clients/horseshoe-management/`
|
||||
- Info: `clients/horseshoe-management/CLIENT_INFO.md`
|
||||
|
||||
### By Project Type
|
||||
|
||||
**Infrastructure/Hardware:**
|
||||
- Dataforth DOS Update System → `projects/dataforth-dos/`
|
||||
|
||||
**Software Development:**
|
||||
- ClaudeTools MSP API → `projects/claudetools-api/`
|
||||
- Original code: `api/`, `migrations/`, etc.
|
||||
|
||||
### By Date/Session
|
||||
|
||||
**Session Logs:**
|
||||
- General: `session-logs/YYYY-MM-DD-session.md`
|
||||
- Dataforth DOS: `projects/dataforth-dos/session-logs/`
|
||||
- ClaudeTools API: `projects/claudetools-api/session-logs/`
|
||||
|
||||
---
|
||||
|
||||
## Projects Status
|
||||
|
||||
### Dataforth DOS Update System
|
||||
**Status:** Production Ready - Awaiting Pilot Testing
|
||||
**Last Work:** 2026-01-20
|
||||
**Next:** Test on TS-4R, then full rollout
|
||||
**Files:** 17 BAT files, 33 deployment scripts, 8 docs
|
||||
**See:** `projects/dataforth-dos/PROJECT_INDEX.md`
|
||||
|
||||
### ClaudeTools MSP API
|
||||
**Status:** Phase 5 Complete
|
||||
**Last Work:** Prior to 2026-01-19
|
||||
**Endpoints:** 95+ across 17 entities
|
||||
**Database:** MariaDB @ 172.16.3.30
|
||||
**See:** `.claude/claude.md` and `SESSION_STATE.md`
|
||||
|
||||
---
|
||||
|
||||
## Clients Status
|
||||
|
||||
### Dataforth
|
||||
**Services:** DOS machine management, update system, QC automation
|
||||
**Active Projects:** DOS Update System
|
||||
**Infrastructure:** AD2 server, D2TESTNAS, ~30 DOS machines
|
||||
|
||||
### Horseshoe Management
|
||||
**Services:** Remote support, QuickBooks/Intuit assistance
|
||||
**Recent:** Glance screen sharing version mismatch (2026-01-20)
|
||||
**Status:** Active support client
|
||||
|
||||
---
|
||||
|
||||
## Context Recovery
|
||||
|
||||
When searching for previous work:
|
||||
|
||||
1. **Check Project Index:**
|
||||
- `projects/[project-name]/PROJECT_INDEX.md`
|
||||
|
||||
2. **Check Client Info:**
|
||||
- `clients/[client-name]/CLIENT_INFO.md`
|
||||
|
||||
3. **Check Session Logs:**
|
||||
- `session-logs/YYYY-MM-DD-session.md` (general)
|
||||
- `projects/[project]/session-logs/` (project-specific)
|
||||
|
||||
4. **Check Credentials:**
|
||||
- `credentials.md` (infrastructure access)
|
||||
|
||||
5. **Check Overall State:**
|
||||
- `SESSION_STATE.md` (ClaudeTools API phases)
|
||||
|
||||
---
|
||||
|
||||
## File Counts (2026-01-20)
|
||||
|
||||
### Dataforth DOS Project
|
||||
- Batch Files: 17
|
||||
- Deployment Scripts: 33
|
||||
- Documentation: 8
|
||||
- Total: 58 files
|
||||
|
||||
### Clients
|
||||
- Dataforth: (files in DOS project)
|
||||
- Horseshoe Management: 1 info file
|
||||
|
||||
### ClaudeTools API
|
||||
- Source Files: 100+ (api/, migrations/, etc.)
|
||||
- Documentation: 10+
|
||||
|
||||
---
|
||||
|
||||
## Recent Work Summary
|
||||
|
||||
### 2026-01-20: Dataforth DOS Fixes
|
||||
- Fixed 8 major DOS 6.22 compatibility issues
|
||||
- Deployed 9 production BAT files
|
||||
- 39+ deployments to AD2 and NAS
|
||||
- All files organized into `projects/dataforth-dos/`
|
||||
|
||||
### 2026-01-20: Horseshoe Management Support
|
||||
- Glance screen sharing troubleshooting
|
||||
- Documented in `clients/horseshoe-management/`
|
||||
|
||||
---
|
||||
|
||||
## Context Search Examples
|
||||
|
||||
**Find DOS deployment info:**
|
||||
```
|
||||
Look in: projects/dataforth-dos/PROJECT_INDEX.md
|
||||
Or: projects/dataforth-dos/documentation/DOS_DEPLOYMENT_GUIDE.md
|
||||
```
|
||||
|
||||
**Find Dataforth infrastructure credentials:**
|
||||
```
|
||||
Look in: credentials.md (search for "Dataforth" or "AD2" or "D2TESTNAS")
|
||||
```
|
||||
|
||||
**Find previous DOS session work:**
|
||||
```
|
||||
Look in: projects/dataforth-dos/session-logs/
|
||||
Or: session-logs/2026-01-19-session.md (original work)
|
||||
```
|
||||
|
||||
**Find Horseshoe Management history:**
|
||||
```
|
||||
Look in: clients/horseshoe-management/CLIENT_INFO.md
|
||||
```
|
||||
|
||||
**Find ClaudeTools API status:**
|
||||
```
|
||||
Look in: SESSION_STATE.md
|
||||
Or: .claude/claude.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Maintenance
|
||||
|
||||
**Update Frequency:**
|
||||
- PROJECT_ORGANIZATION.md: After major folder changes
|
||||
- PROJECT_INDEX.md: After project milestones
|
||||
- CLIENT_INFO.md: After client interactions
|
||||
- Session logs: Daily via `/save` command
|
||||
|
||||
**Organization Rules:**
|
||||
1. Project files go in `projects/[project-name]/`
|
||||
2. Client info goes in `clients/[client-name]/`
|
||||
3. Shared credentials stay in root `credentials.md`
|
||||
4. General session logs in root `session-logs/`
|
||||
5. Project-specific logs in project's `session-logs/` folder
|
||||
|
||||
---
|
||||
|
||||
**Created:** 2026-01-20
|
||||
**Purpose:** Enable efficient context recovery and project navigation
|
||||
**Maintained By:** Claude Code via user direction
|
||||
Reference in New Issue
Block a user