aitbc/docs/development/DEV_LOGS_QUICK_REFERENCE.md

# AITBC Development Logs - Quick Reference

## 🎯 **Problem Solved:**
- ✅ **wget-log** moved from project root to `/opt/aitbc/dev/logs/tools/`
- ✅ **Prevention measures** implemented to avoid future scattered logs
- ✅ **Log organization system** established

## 📁 **New Log Structure:**
```
/opt/aitbc/dev/logs/
├── archive/          # Old logs organized by date
├── current/          # Current session logs
├── tools/            # Download logs, wget logs, curl logs
├── cli/              # CLI operation logs
├── services/         # Service-related logs
└── temp/             # Temporary logs
```

## 🛡️ **Prevention Measures:**

### **1. Environment Configuration:**
```bash
# Load log environment (automatic in .env.dev)
source /opt/aitbc/.env.dev.logs

# Environment variables available:
$AITBC_DEV_LOGS_DIR      # Main logs directory
$AITBC_CURRENT_LOG_DIR   # Current session logs
$AITBC_TOOLS_LOG_DIR     # Tools/download logs
$AITBC_CLI_LOG_DIR       # CLI operation logs
$AITBC_SERVICES_LOG_DIR  # Service logs
```

### **2. Log Aliases:**
```bash
devlogs              # cd to main logs directory
currentlogs          # cd to current session logs
toolslogs            # cd to tools logs
clilogs              # cd to CLI logs
serviceslogs         # cd to service logs

# Logging commands:
wgetlog <url>        # wget with proper logging
curllog <url>        # curl with proper logging
devlog "message"     # add dev log entry
cleanlogs            # clean old logs (>7 days)
archivelogs          # archive current logs (>1 day)
```

### **3. Management Tools:**
```bash
# View logs
./dev/logs/view-logs.sh tools     # view tools logs
./dev/logs/view-logs.sh current   # view current logs
./dev/logs/view-logs.sh recent    # view recent activity

# Organize logs
./dev/logs/organize-logs.sh       # organize scattered logs

# Clean up logs
./dev/logs/cleanup-logs.sh        # cleanup old logs
```

### **4. Git Protection:**
```bash
# .gitignore updated to prevent log files in project root:
*.log
*.out
*.err
wget-log
download.log
```

## 🚀 **Best Practices:**

### **DO:**
✅ Use `wgetlog <url>` instead of `wget <url>`  
✅ Use `curllog <url>` instead of `curl <url>`  
✅ Use `devlog "message"` for development notes  
✅ Store all logs in `/opt/aitbc/dev/logs/`  
✅ Use log aliases for navigation  
✅ Clean up old logs regularly  

### **DON'T:**
❌ Create log files in project root  
❌ Use `wget` without `-o` option  
❌ Use `curl` without output redirection  
❌ Leave scattered log files  
❌ Ignore log organization  

## 📋 **Quick Commands:**

### **For Downloads:**
```bash
# Instead of: wget http://example.com/file
# Use: wgetlog http://example.com/file

# Instead of: curl http://example.com/api
# Use: curllog http://example.com/api
```

### **For Development:**
```bash
# Add development notes
devlog "Fixed CLI permission issue"
devlog "Added new exchange feature"

# Navigate to logs
devlogs
toolslogs
clilogs
```

### **For Maintenance:**
```bash
# Clean up old logs
cleanlogs

# Archive current logs
archivelogs

# View recent activity
./dev/logs/view-logs.sh recent
```

## 🎉 **Results:**

### **Before:**
- ❌ `wget-log` in project root
- ❌ Scattered log files everywhere
- ❌ No organization system
- ❌ No prevention measures

### **After:**
- ✅ All logs organized in `/opt/aitbc/dev/logs/`
- ✅ Proper directory structure
- ✅ Prevention measures in place
- ✅ Management tools available
- ✅ Git protection enabled
- ✅ Environment configured

## 🔧 **Implementation Status:**

| Component | Status | Details |
|-----------|--------|---------|
| **Log Organization** | ✅ COMPLETE | All logs moved to proper locations |
| **Directory Structure** | ✅ COMPLETE | Hierarchical organization |
| **Prevention Measures** | ✅ COMPLETE | Aliases, environment, git ignore |
| **Management Tools** | ✅ COMPLETE | View, organize, cleanup scripts |
| **Environment Config** | ✅ COMPLETE | Variables and aliases loaded |
| **Git Protection** | ✅ COMPLETE | Root log files ignored |

## 🚀 **Future Prevention:**

1. **Automatic Environment**: Log aliases loaded automatically
2. **Git Protection**: Log files in root automatically ignored
3. **Cleanup Scripts**: Regular maintenance automated
4. **Management Tools**: Easy organization and viewing
5. **Documentation**: Clear guidelines and best practices

**🎯 The development logs are now properly organized and future scattered logs are prevented!**