IMHO nothing beats a good UML class diagram to grasp a system architecture. But I guess it’s not agile enough Sometimes I’m tempted of creating them with Enterprise Architect (my favourite tool) but it requires a license. I think we need at least:
- a domain model diagram (persistent entities)
- a diagram showing controllers, services and DAOs and its relationships
For complex processes sequence or activity diagrams would be useful too.