Commit Graph
6 Commits
Author SHA1 Message Date
pnoker 1c11831cbc docs: comprehensive documentation overhaul across English and Chinese sites 2026-06-26 13:17:41 +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 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 8c0f1b00ac docs: overhaul site with bilingual i18n, mermaid, and expanded guides 2026-06-23 19:34:22 +08:00
Vickey 48f5d2f0e9 docs(site): import legacy operation manual from dc3-docs
The dc3-docs VuePress 1.x source repository has the original
Markdown for the operation manual. Migrate four pages whose
content survives unchanged in the current product flow:
driver / template / device / data, plus a hand-written
operation/index.md as the section landing page. Add the
corresponding Web UI screenshots under docs/public/images/legacy/
(the full assets/images tree from the old site, ~169 files).

- Replace the Ant Design Vue <a-alert> component in data.md with
  a VitePress ::: tip container.
- Rewrite /assets/images/ to /images/legacy/ so paths resolve
  under VitePress's public/ static-asset convention with the
  /iot-dc3/ base.
- Add a "操作手册" entry to the top nav and a per-section sidebar
  in .vitepress/config.mts.

Skipped from dc3-docs:
- operation/0-index.md - "待开发中" placeholder.
- function/{api,driver}.md - "🚧施工中🚧" placeholders.
- function/0-directory.md - obsolete (refers to dc3-common as a
  separate repo and lists mongo/redis/mysql common modules that
  no longer exist).
- function/storage.md - lists mongodb/influxdb/opentsdb as
  supported storage; the project ships PostgreSQL only.

Verification: pnpm docs:build passes (5.26s). The five operation
pages render; image src attributes resolve to
/iot-dc3/images/legacy/operation/<page>/<uuid>.png and the files
exist in dist/.
2026-05-18 20:50:56 +08:00
Vickey 476799e513 refactor(api): rename gRPC SelectBy* RPCs to GetBy*/ListBy*
Apply the new naming convention to .proto contracts so the verb on
each RPC reflects the cardinality of its result:

  - get*  for single-record returns (RPCs returning a single DTO)
  - list* for multi-record returns (RPCs returning a Page or List DTO)

23 RPCs renamed across 9 .proto files. Returns-single -> Get*:
  user.proto                 SelectById        -> GetById
  user_login.proto           SelectByName      -> GetByName
  tenant.proto               SelectByCode      -> GetByCode
  driver_device.proto        SelectById        -> GetById
  driver_point.proto         SelectById        -> GetById
  manager_point.proto        SelectById        -> GetById
  manager_device.proto       SelectByDeviceId  -> GetByDeviceId
  manager_driver.proto       SelectByDriverId  -> GetByDriverId
  manager_driver.proto       SelectByDeviceId  -> GetByDeviceId
  manager_profile.proto      SelectByProfileId -> GetByProfileId

Returns-multi -> List*:
  driver_device.proto        SelectByPage         -> ListByPage
  driver_point.proto         SelectByPage         -> ListByPage
  manager_device.proto       SelectByPage         -> ListByPage
  manager_device.proto       SelectByDriverId     -> ListByDriverId
  manager_device.proto       SelectByProfileId    -> ListByProfileId
  manager_device.proto       SelectByDeviceIds    -> ListByDeviceIds
  manager_driver.proto       SelectByPage         -> ListByPage
  manager_driver.proto       SelectByDriverIds    -> ListByDriverIds
  manager_point.proto        SelectByPage         -> ListByPage
  manager_point.proto        SelectByIds          -> ListByIds
  manager_profile.proto      SelectByPage         -> ListByPage
  manager_profile.proto      SelectByProfileIds   -> ListByProfileIds
  manager_profile.proto      SelectByDeviceId     -> ListByDeviceId

This is a wire-level breaking change: gRPC clients and servers must
upgrade in lockstep. Server impls, facade clients, and Java callers
are aligned in subsequent commits.
2026-05-18 19:19:40 +08:00