Commit Graph
15 Commits
Author SHA1 Message Date
pnoker 1c11831cbc docs: comprehensive documentation overhaul across English and Chinese sites 2026-06-26 13:17:41 +08:00
pnokerandClaude Opus 4.8 5f1ab36ade docs(site): apply verification fixes to remaining driver and foundation pages
Source-checked corrections from the verification pass that were not captured
in the prior commit: mqtt default broker (dc3-rabbitmq:1883), snmp/can/http/
ble/zigbee command vs point attribute read sources and honest capability
labels, opc-ua/opc-da/modbus-rtu/fins/listening-virtual wording, and the
fieldbus/iot-protocols foundations chapters. Bilingual, all within drivers/
and foundations/, no scope creep.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:55:41 +08:00
pnokerandClaude Opus 4.8 c291c6f0aa docs(site): fix factual issues flagged by independent source verification
Apply source-checked corrections across driver and foundations pages:
- mqtt/snmp/can/http/ble/zigbee/listening-virtual: command-attribute vs
  point-attribute read sources, default broker (dc3-rabbitmq:1883, not EMQX
  localhost:31883), dead driver-level properties, capability matrix alignment
  (CAN write ✓→—), and honest skeleton/partial labels.
- aiot: MCP catalog refresh is manual (POST /mcp/tool/catalog/refresh), not
  scheduled PT5M; AGENTIC_MEMORY_ENABLED dual default clarified.
- edge-cloud: connection/state management sits on the data center, not the
  manager center; soften the four-centers ↔ four-capabilities 1:1 wording.
- security: salt is stateless (no server-enforced 5-min timeout);
  DC3_SECURITY_KEY has a "must exist" startup check but no weak-value rejection.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:42:07 +08:00
pnokerandClaude Opus 4.8 dbe4d6bc83 docs(site): link data-plane, auth-rbac and ai hubs to their foundations chapters
Add foundations back-links (data-plane → time-series, auth-rbac → security,
ai → aiot) to complete the theory-to-implementation loop across both locales.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 11:28:32 +08:00
pnokerandClaude Opus 4.8 93b111e3fb docs(site): deepen all 28 driver pages and add foundations back-links
Rewrite every protocol driver page (zh+en) into a four-section structure
— protocol background, attribute config, troubleshooting, and how it lands
in DC3 — cross-linked to the foundations network-layer chapters and the
driver capability matrix. Implementation status is verified against each
driver's source and labeled honestly (skeleton: ethernet-ip, iec104, dlms,
can, zigbee; partial: fins, mqtt, lwm2m, virtual). Add foundations
back-links from the concepts and drivers hubs to close the theory↔practice
loop.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 11:04:07 +08:00
pnokerandClaude Opus 4.8 0a33fb47d9 docs(site): add IoT foundations pillar — four-layer knowledge woven with DC3
Add the Foundations pillar (nav position 2) as a structured IoT primer
organized by the classic four-layer reference architecture (perception,
network, platform, application) plus cross-cutting security. One overview
(2.0) with a bespoke FourLayers SVG mapping each layer to its DC3
implementation, and eight chapters (sensing, identification, fieldbus,
iot-protocols, edge-cloud, data-pipeline, aiot, security), bilingual and
fully original. Every chapter closes with a verified "in IoT DC3" section
and cross-links into the product docs. Add the sixth homepage card.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 23:48:00 +08:00
pnokerandClaude Opus 4.8 147368a7ee docs(site): fix language switcher, restyle mermaid, add bespoke flow diagrams
Drop the gate "Languages" locale so the switcher shows only zh/en; keep the
/ redirect gate for no-JS fallback. Deepen the global mermaid theme (softer
on-brand palette, rounded nodes, cleaner edges) so all 156 diagrams read
cleaner. Add a reusable .dc3-diagram palette and three hand-built SVG
components (DataPlane, CommandPlane, AuthFlow) replacing the keystone
diagrams on the data-plane, command-plane and auth-rbac pages, bilingual
and theme-aware.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 23:18:57 +08:00
pnokerandClaude Opus 4.8 cfd5a2a857 docs(site): refine top nav into five pillars, add glossary and driver matrix
Collapse the flat 10-section navigation into five pillars (Overview,
Architecture, Connectivity, Operations, Develop) plus a Community dropdown,
via a pillar model in config.mts. Legacy dirs (modules, guide, ai,
automation, device-onboarding) aggregate into pillars through multi-path
sidebars and longest-prefix matching, with zero file moves and zero dead
links. Adds a bilingual glossary and driver capability matrix, and aligns
the homepage feature cards.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 21:07:54 +08:00
pnoker f6990019be docs(site): live hero logo, unified architecture component, grouped sidebar
- hero: rebuild the homepage logo as a live canvas particle system faithfully
  reconstructed from logo.svg (54 dots, solid #1296db) instead of a static image;
  the dots animate with a clockwise, inward-converging wave along the three spiral
  arms — no whole-image rotation, no extra particles or glow haze.
- architecture: render the homepage/architecture diagram via a single
  theme-reactive Architecture.vue component (renamed from Dc3Architecture.vue);
  drop the static SVG/HTML drawings.
- cleanup: remove ~23MB of unused images (legacy/ 167 files, architecture-cn.png,
  iot-dc3-architecture-{zh,en}.svg, diagrams/iot-dc3-architecture.html).
- sidebar: group drivers/concepts/architecture into collapsible sections;
  fix a pre-existing dead-link bug in cross-section link generation.
- nav: brand-blue site title.
- chore: bump packageManager to pnpm@11.9.0.
2026-06-25 15:30:22 +08:00
pnoker e61b620399 docs: fix tenant-isolation fiction + data-plane schema/compression + MCP endpoint
Whole-site QA pass (concepts + drivers + architecture + operation + home) with adversarial verification against source. Fixed:
- Remove fabricated 'MyBatis-Plus tenant-line interceptor auto-appends WHERE tenant_id' (no such interceptor exists; isolation is controller-layer requireTenant/filterTenant) across architecture/index, auth-rbac, modules, tenant concept (zh+en).
- data-plane: add dc3_history schema qualifier + compression (7d) / retention (180d) lifecycle policies (zh+en).
- operation/index: MCP endpoint is gateway-root POST /mcp, not /api/v3/agentic/mcp (zh+en).
Concept pages (9), drivers (28), services/domain-model/command-plane/device-onboarding/data-commands/alarms verified accurate against source.
2026-06-25 10:54:07 +08:00
pnoker c470de529e docs(drivers): add bilingual reference pages for all 28 drivers + catalog
Per-driver onboarding pages (protocol intro, driver/point/command config tables, collection & health, minimal example, pitfalls), config tables taken verbatim from each driver application.yml. Drivers catalog + 'Drivers' nav entry. Adversarial pass verified every attribute row against the yml and corrected behavioral drift (JDBC executeQuery path, dlms fail-fast, listening-virtual name-based parse, modbus-rtu per-device connection, opc-ua auto cert, fins 16-bit read, etc.).
2026-06-24 21:43:13 +08:00
pnoker 77273d2b24 docs(concepts): add 9 bilingual core-concept reference pages
Device, Driver, Profile (thing model), Point, PointValue, Command, Event, Tenant, Attribute&Config — each grounded in source BOs + maintainer design docs, beginner-friendly with analogies, cross-linked. Field tables/enums/table names/APIs verified against source (adversarial pass caught & fixed design-doc drift: dc3_event_history not _record, EventLevelEnum LOW/MEDIUM/HIGH/CRITICAL, tenant isolation is controller-layer not a DB interceptor).
2026-06-24 21:19:40 +08:00
pnoker 11d2d0176f docs(home): add recolored logo hero image (azure gradient + soft glow), floating instead of bordered card 2026-06-24 19:40:09 +08:00
pnoker a6846212fc docs(site): logo-blue retheme, grouped sidebar, frosted header, flat cards; relocate vitepress project under docs/
Theme: brand palette to logo azure (#1296db family) with AA-tuned links, neutralized backgrounds/shadows, per-section sidebar group headers with pill active state, borderless frosted nav, flat translucent feature cards; mermaid + theme-color recolored to blue.

Build: move package.json/pnpm-lock/pnpm-workspace/node_modules under docs/; scripts to 'vitepress dev/build/preview'; CI docs.yml uses working-directory docs + cache-dependency-path docs/pnpm-lock.yaml.
2026-06-24 16:12:03 +08:00
pnoker 8c0f1b00ac docs: overhaul site with bilingual i18n, mermaid, and expanded guides 2026-06-23 19:34:22 +08:00