Files
Aemeath ac90575b0b
Build packages / CI (push) Blocked by required conditions
Build packages / Version (push) Waiting to run
CI / Web (format, types, tests, bundles) (push) Blocked by required conditions
CI / ShellCheck (push) Blocked by required conditions
CI / Backend (Go: vet, tests, a real ubusd and uhttpd) (push) Blocked by required conditions
CI / Package files (push) Blocked by required conditions
Dawnline 0.20.0
- **Backend rewritten in Go.** One daemon, `dawnlined`, replaces the whole ucode backend: the rpcd plugin, the agent, the CLI and the updater. The package no longer depends on ucode.
- **Per-architecture builds.** The release carries the backend for arm64, ARMv7, mips, mipsle and amd64; the router fetches its own after the package is installed and checks its sha256. Dawnline does not run on other architectures (older ARM, 32-bit x86, RISC-V).
- **Faster on the router.** A firewall sync takes 0.06 s instead of 0.9 s; a full apply takes about 300 ms. The portal is served by the daemon itself, without a CGI process per request.
- **Live pages.** The admin and the portal follow a live stream from the router instead of re-fetching the whole state every 30 seconds.
- **Admin redesigned in the portal's style.** Three sections (Overview · Log · Settings); a server is a page of its own with People, Places and Settings; a device opens as a dialog over its person.
- **Changes wait for «Apply».** Every setting, and a person's access, is staged in one dock before it reaches the router.
- **Configuration rollout.** After a change that makes devices fetch their configuration again, the admin shows how many have fetched it and who has not. Every setting shows beforehand (⟳N) how many devices it will touch.
- **Waiting for a decision.** Overview and People put first the people who need one (access ended, limit reached, a device that does not connect), each with its one action a tap away.
- **Bulk actions on people.** «Select» (or a long press on a card) picks several people to extend by a month, pause or resume at once.
- **Undo.** An action done from a card or a request is undone from its toast.
- **Update dialogs redesigned.** An update is one view from its question to its result; Dawnline's own update runs in it like every other, and the page reloads itself once the new version answers. Other versions are a list, each with its notes and Install on a page of its own.
- **Site to site: networks behind a router.** A router connected as a device can have networks behind it (up to eight, /16 to /30): the server routes them and applies the router's access to them. A network that shares addresses with a tunnel, the router's own networks or another site is refused by name.
- **Routers from the portal.** People can add a router and name its networks on their own page; the admin accepts or declines with a reason, or lets them through without asking.
- **Check access and Health know the networks behind routers.**
- **Usage limits reworked.** A monthly limit no longer follows the calendar. A person's month starts with their first traffic and ends a month later; the next one starts only when they connect again, so time away uses up none of it. Before, everyone's limit reset on the 1st.
- Extra data lasts until that person's month ends; «Reset usage» starts the month anew.
- A limit is for a month or for the whole term; the admin and the portal show when it resets.
- Charts that said «this month» show the last 30 days.
- After the update nobody loses what was counted: the month that was running becomes the person's first and ends on the 1st.
- **Access by time of day removed.** The Hours limit is gone from the admin, the portal and the backend; saved hours are dropped.
- **Expiry simplified.** An end date always stops access, with a heads-up three days before; the per-person choice is gone.
- **No false disconnects from sleeping phones.** A phone or a tablet stays online through ten minutes of silence.
- **Mobile Safari fixes.** Pressing a control no longer sends the page to its top; tab tracks that do not fit scroll; switches animate after a press.
2026-11-13 09:43:50 +03:00

4.1 KiB

Backend (Go: backend/)

Read with code-standards.md (it applies whole: one job per package, layers one way, validate at the boundary, one writer, fail closed) and docs/backend.md (where the backend is going and the stream's protocol).

Packages

  • One package, one job, named after it, with a package comment that says what it owns, what it does not and what callers rely on. backend/version.go lists them and the layers.
  • Layers: ubus and hub know nothing of Dawnline or of each other; api, bridge (and later the producers) join them; daemon runs them; only cmd/dawnlined knows the router's paths.
  • One door per outside system. Only ubus speaks ubus; when they come, only one package runs awg, one talks nftables, one writes UCI. A new version of the thing behind a door is one package to change.
  • Seams are interfaces declared by the user (bridge.Caller, api.Notifier), so a test hands in a stand-in. No package-level state.
  • No dependency without a reason written in the change that adds it. The standard library covers the stream; nftables and netlink will need libraries.
  • Not copied from podkop-exp (GPL; Dawnline is MIT): its patterns, never its code.

The stream

  • A producer puts whole documents (hub.Put) and never builds a patch; it may put as often as it likes.
  • Documents hold no null and publish lists of things with ids as keyed lists ({ order, items }).
  • What costs something to produce runs only under a lease (Audience.Wants).
  • A new topic or method is added to docs/backend.md, and a method to the rpcd ACL (acl.d/luci-app-dawnline.json) in the same change.
  • Text people read is not put into topics: the page translates (i18n.md). A topic carries codes and values.

Failures

  • A refusal is a sentence for a person, capital first, in English through the catalog (access.Said, said, github.Failure, w.die), listed in i18n/messages.js. An error Go or a library wrote for programmers (lower-case first, by Go's convention: «open /etc/config/dawnline: no such file») is never sent to a page: methods.wordsOf sends the plain sentence (methods.Unworded) and puts the error itself in the system log. The page holds the same line (web/src/admin/failure.ts).

Cost on the router

  • Nothing periodic without a measurement on the router. What was measured there: nft reads the router's whole ruleset to change a set in place (0.9 s beside a proxy's lists) and nothing to replace our own table (0.06 s), so a sync replaces the table; auto-merge on an interval set costs the same 0.9 s, so networks are collapsed before they are written.
  • A goroutine per job, not per event; channels that can fill say what happens when they do (the hub lets a slow follower go).

Checks

  • The goldens are the ucode backend's own answers. backend/*/testdata/*.json were made by the ucode backend (0.18.0) from the fixtures beside them, before it was removed; nothing regenerates them. A test that compares with one holds Go to what that backend did. Changing behaviour on purpose means editing the golden by hand in the same change, and saying why in it.
  • scripts/backend-container.sh (needs docker): gofmt, go vet (all build tags), the unit tests, then the tests against a real ubusd, rpcd and uhttpd in the OpenWrt 24.10 and 25.12 rootfs images.
  • A pure function gets a table test beside it; what speaks to the router gets a case in a tagged test (ubusd, e2e) that the script runs.
  • Local time is the router's, asked of zone.Local(), never time.Local: OpenWrt keeps the zone in /etc/TZ, where Go does not look, so a Go program there is in UTC unless told (backend/zone). A golden made with TZ=UTC cannot see a mistake here: test what counts days or hours in a zone east of Greenwich.
  • There is no second backend to fall back to. What changes how the router is kept is tried first where it changes nothing (ubus call dawnline apply_plan and sync_plan say what an apply or a sync would do), and on the real router only on objects made for the try. A person's link code is never logged, printed or put in an error.