Rename the architecture diagram to docs/architecture.*

docs/logstream-schema-logique.{png,excalidraw} become docs/architecture.{png,excalidraw}; the README image and source link follow. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Architecture diagram: version 2 from the project
2026-10-02 09:32:56 +02:00 · 2026-10-02 09:18:17 +02:00 · 2026-10-02 09:17:52 +02:00 · 2026-10-02 09:09:08 +02:00
3 changed files with 3759 additions and 0 deletions
@@ -10,6 +10,24 @@ devices ──514 udp/tcp──▶ logstream (Go) ──HTTP batches──▶ Vi
                              └──── API / UI ◀─────────┘
 ```

+## Architecture
+
+![Schéma logique de Logstream](docs/architecture.png)
+
+- **Ingestion**: syslog (UDP/TCP) and Docker container logs both go through `sink()` (reverse DNS
+  on IP hosts), then the `Store` queue, which sends them in batches to VictoriaLogs.
+- **Live view**: `sink()` also publishes each message to the `Hub`, which streams it to the
+  browsers over SSE.
+- **Search**: the HTTP API turns the UI filters into LogsQL queries sent to VictoriaLogs.
+- **Timeline**: `/api/histogram` (`histogram.go`) counts the logs per interval and severity,
+  aligned on the local time; the zoom bounds (`from`/`to`) also apply to the list and the export.
+- **State**: tags and source settings live in `/data` (`logstream-data` volume); the logs
+  themselves in the `vlogs-data` volume.
+
+The editable source of the diagram is
+[`docs/architecture.excalidraw`](docs/architecture.excalidraw)
+(open it on [excalidraw.com](https://excalidraw.com)).
+
 ## Getting started

 ```bash
Author	SHA1	Message	Date
cedricandClaude Opus 5.5	556d5ee767	Rename the architecture diagram to docs/architecture.* docs/logstream-schema-logique.{png,excalidraw} become docs/architecture.{png,excalidraw}; the README image and source link follow. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>	2026-10-02 09:32:56 +02:00
cedricandClaude Opus 5.5	eb51eb15b4	Architecture diagram: version 2 from the project Replaces the diagram with the corrected version 2 (title without commit hash, Query with the from/to zoom bounds, Histogram box linked to the API and VictoriaLogs, arrow labels on a white background), and adds a Timeline bullet to the README legend. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>	2026-10-02 09:18:17 +02:00
cedricandClaude Opus 5.5	459d5cb79b	Architecture diagram: current main, timeline histogram - Title without the commit hash (the hand-drawn font turned "32593b9" into "3259369"); the subtitle dates the diagram instead. - New Histogram (histogram.go) box: API -> histogram -> VictoriaLogs (stats). - Query mentions the from/to range (zoom); the web UI mentions the timeline, columns and live view. - Multi-segment arrows drawn straight, routed between the containers. - PNG regenerated from the .excalidraw source (Excalidraw 0.18 renderer). - README: histogram.go in the Search flow. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>	2026-10-02 09:17:52 +02:00
cedricandClaude Opus 5.5	b3b7041ee9	README: architecture diagram Adds the logical diagram of the project (PNG and its editable Excalidraw source in docs/) and an Architecture section after the introduction, with a short description of the data flows. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>	2026-10-02 09:09:08 +02:00