Warda-DNSDocs Warda: from ward — to protect, guardian
v0.9.3

Summary of the week

Reports → Summary of the week (reports.weekly, subscription, open during the beta; internal/admin/weekly.go) shows the week going on for each person whose detailed reports may be shown: the minors, and the adults who agreed to detailed reports (the same rule as Time spent): the time on Internet against the same days of last week, the three sites most used, the time on shared devices, and for the minors the bypass alerts, the monitored sites, the requests asked and accepted.

The past weeks (from 0.8.5). Every Monday from 06:00 (the time of the box: the statistics of the night are in) the box writes the summary of the week that ended and keeps it; the task Summary of the week (reports.weekly) looks every hour whether one is due. The 52 latest are kept; the page browses them (Week: This week (so far), then each Monday), "Summary kept on … (the 52 latest weeks are kept)." They are history, as the journal: never in a backup (a restore empties them), never given to the secondary of a pair, which neither writes nor sends them while it is the secondary (its task is hidden). A summary kept is shown, counted and sent with the people whose reports may be shown today only: an adult who no longer agrees to detailed reports, or a person removed, leaves the past summaries too, not only those to come.

By e-mail (from 0.8.5; function weekly of the catalogue). On the same page, Send the summary of the week that ended every Monday morning: the recipients are chosen among the administrators (their accounts) and the adults of the household, 10 at most, each at one address (never twice the same) and in one of the 7 languages of the interface. Each receives a message in text and in HTML, without any image nor link loaded from elsewhere, through the mail server of the box only: nothing goes through the online service of Warda. Without a mail server the page says "To receive it by e-mail, first set the mail server of the box in the settings." The recipients that failed are tried again within the hour, three times at most for a week ("Not sent to every recipient: … The box tries again within the hour (three times at most)."); Send last week's now sends the summary of the week that ended at once, once every 10 minutes at most. The page shows the last sending (its date, how many recipients, the last error). The administration log writes weekly.mail (on or off, and how many recipients) and weekly.send ("week of 2026-10-05: 3 sent"): it counts the recipients, never their addresses. The recipients are in the backups (meta weekly_mail); the state of the last sending is not.

API (the reports read or written; 402 without the function after the beta): GET /api/v1/reports/weekly/history (the weeks kept, the latest first: week, its Monday YYYY-MM-DD, from, to, generated, people), GET /api/v1/reports/weekly/history/{week} (a summary: week, from, to, generated, people with total and last_total in minutes, change in %, sites, shared, bypass, sensitive, asked, accepted), GET/PUT /api/v1/reports/weekly/mail (enabled, recipients [{kind account or person, id, address, lang}]; the answer adds candidates, mail_server, status, langs) and POST /api/v1/reports/weekly/send.