# Infrastructure Documentation

Internal documentation for the `sweet.home` homelab. Contains full topology, network
details, credentials catalog (names only), and operational runbooks.

## Quick links

- [Architecture](architecture.md) — host map and service relationships
- [Network Topology](network-topology.md) — VLANs, IPs, firewall rules
- [Implementation Plan](implementation-plan.md) — phased rollout roadmap
- [Host Inventory](generated/host-inventory.md) — auto-generated from Ansible inventory
- [Service Catalog](generated/service-catalog.md) — auto-generated from compose files

## Repo structure

```
infrastructure/
├── terraform/     Infrastructure state (Proxmox VMs, DNS, Pi-hole)
├── ansible/       Configuration management (non-NixOS hosts)
├── nixos/         NixOS flake (all NixOS hosts)
├── stacks/
│   ├── docker/    Main app stack (Traefik, Nextcloud, Passbolt, Gitea…)
│   └── raspi/     Raspberry Pi edge monitoring stack
└── docs/          This documentation
```