chore: prepare release v0.3.0

docs/architecture.md

@@ -20,7 +20,7 @@ server-rendered admin for editing them.
 - **Markdown-first** — the visual editor round-trips through the same renderer
   that powers the public API, so stored content is always Markdown.
 
-## Components (planned layout)
+## Components
 
 ```
 lib/volumen/
@@ -28,27 +28,38 @@ lib/volumen/
   config.rb        # loads /etc/volumen/config.toml, applies CLI overrides
   frontmatter.rb   # parse/serialise the `+++ … +++` TOML block
   post.rb          # Post model: metadata + raw body + rendered HTML
-  store.rb         # reads the content directory into Post objects
-  markdown.rb      # kramdown wrapper (render + sanitise)
-  server.rb        # Sinatra app: JSON API + admin routes
+  store.rb         # reads the content directory into Post objects (mtime-cached)
+  markdown.rb      # kramdown wrapper (render + <figure>/<figcaption> for titled images)
+  feed_helpers.rb  # RSS / JSON Feed / sitemap generation
+  users.rb         # users.toml + admin/author roles
+  password.rb      # scrypt hashing/verification (OpenSSL::KDF)
+  api_routes.rb    # /api/volumen/* (Sinatra routes)
+  admin_routes.rb  # /admin/* (Sinatra routes)
+  server.rb        # Sinatra app: composes the two route modules, shared helpers
+  cli.rb           # command dispatcher
   web/
     views/         # ERB templates for the admin
-    public/        # admin CSS + the visual-editor JS island
+    public/        # static assets (volumen-logo.svg, volumen-icon.svg)
 exe/volumen        # CLI: serve, hash-password, version, help
 ```
 
-## Request flow (planned)
+## Request flow
 
 ```mermaid
 graph TD
   A[HTTP request] --> B{Route}
-  B -->|/api/volumen/*| C[JSON API]
-  B -->|/admin/*| D[Admin: session + CSRF]
+  B -->|/api/volumen/*| C[api_routes.rb]
+  B -->|/admin/*| D[admin_routes.rb + CSRF + CSP]
   C --> E[Store]
   D --> E
-  E --> F[(content_dir/*.md)]
+  D --> U[Users]
+  C --> F[FeedHelpers]
   C --> G[Markdown renderer]
-  D --> G
+  E --> H[(content_dir/*.md)]
+  E --> I[(content_dir/media/*)]
+  U --> J[(users.toml)]
+  F --> E
+  G --> K[<figure> for titled images]
 ```
 
 ## Public site integration