# System Overview

## Project Overview

Setting up a Lenovo ThinkPad as a rock-solid, minimal, high-performance
development environment for professional software development.

## Hardware Specifications

- **Model**: Lenovo ThinkPad (14")
- **CPU**: AMD Ryzen AI 7 PRO 350 (2.0-5.0 GHz)
- **RAM**: 96GB DDR5-5600MHz (2x 48GB)
- **Storage**: 512GB NVMe PCIe 4.0 TLC Opal SSD
- **Display**: 14" 2.8K OLED (2880x1800) @ 30-120Hz VRR, HDR 500
- **WiFi**: MediaTek Wi-Fi 7 MT7925 2x2 BE + Bluetooth 5.4
- **Dock**: USB-C dock with DisplayLink
- **External Monitors**: 2x Shenzhen KTC Q3212RUC (2560x1440 @ 59.95Hz)

## Software Stack

- **OS**: Gentoo Linux (OpenRC)
- **Kernel**: 6.12.41-gentoo-x86_64 (manual compilation - genkernel NOT used)
- **Display Server**: Wayland (no X11)
- **Window Manager**: Hyprland 0.49.0 (no XWayland)
- **Status Bar**: waybar (with Catppuccin Mocha theme)
- **Terminal**: Ghostty (pure Wayland, no X11)
- **Editor**: Neovim (with LSP support)
- **File Manager**: Midnight Commander (mc)
- **Init System**: OpenRC
- **Session Manager**: elogind
- **Network Manager**: NetworkManager
- **Bluetooth**: BlueZ
- **Dotfile Management**: chezmoi (cross-platform)
- **Theme**: Catppuccin Mocha (consistent across all applications)

## Development Focus

- **Backend**: Go services
- **Frontend**: Web applications
- **Mobile**: Kotlin-based applications
- **Systems**: C programming
- **IoT**: Embedded electronics, firmware flashing

## Design Philosophy

1. **Minimal footprint** - No bloated desktop environments (GNOME/KDE)
2. **Performance first** - Slim, fast, responsive
3. **Wayland native** - Modern display protocol
4. **Single-user system** - Optimized for alexander
5. **Rock solid** - Stability and reliability over bleeding edge
6. **Development focused** - All tools optimized for professional work

## System Health

**Overall Status**: 🟢 Excellent

**Stability**: Rock solid
**Performance**: Optimized
**Battery Life**: 30-50% improvement (power profiles) + potentially 2x
lifespan (conservation mode)
**Hardware Support**: Complete (all input/output devices working)
**Management Tools**: Complete suite of interactive scripts
**Dotfile Management**: chezmoi configured and syncing across machines
**Backup**: Automated NAS backups with network trigger
**Security**: nftables firewall running (default deny incoming)
**UI/Theme**: Professional Catppuccin Mocha theme with Nerd Font icons
**Completeness**: ~99% (all core features complete, only development tools
remaining)

**Ready for production use!** 🚀

## Documentation

For complete system information, see:

**Quick Reference & Status:**
- **USER-GUIDE.md** - Quick reference for everyday tasks
- **Feature-Status.md** - Current state, working features, session history
- **Troubleshooting.md** - Troubleshooting commands and procedures

**Complete Guides:**
- **Backup-Setup.md** - Automated NAS backups, network trigger
- **Security-Hardening.md** - Firewall, fail2ban, SSH hardening
- **Power-Management-Setup.md** - Power management configuration
- **Bluetooth-Setup.md** - Bluetooth setup and troubleshooting
- **Dotfiles-Management.md** - Managing dotfiles with chezmoi

**For Claude Code:**
- **CLAUDE.md** - Operational guidelines for working on this project