From ClasseViva to Home Assistant: a dashboard architecture in practice / Da ClasseViva a Home Assistant: architettura di una dashboard in pratica

ClasseViva is a school information system that displays various data across different screens. To bring this information into Home Assistant, the CVV Dashboard project was created, which consists of two main components. The first component is a Home Assistant integration that exposes the data, while the second component is a Lovelace card that presents the data. The Lovelace card automatically discovers the integration's entities, so users do not have to manually copy entity_id in the configuration.

The Lovelace card is versatile and can display a variety of information, such as averages, grades, the noticeboard, agenda, notes, reports, and homework. It can also display a combined view of these different data types. This allows the dashboard to focus on one kind of information at a time while maintaining consistent YAML configuration.

Each student is assigned four Home Assistant calendars: Agenda, Homework, Teacher notes, and Room bookings. Keeping these calendars separate allows users to independently select each calendar and assign a color to it in Home Assistant. The card also features a school-year selector that fetches data for a specific year on demand.

When the data for a year is not already configured, it retrieves the data using the active login and caches it for 30 minutes. This feature enables users to browse previous years without needing to add the same account multiple times.