pnoker
03492ab5e9
Fix calcDate second remainder, drop dead storage helpers, follow the i18n locale for numeric formatting, rename order to sortAsc and expand abbreviated identifiers, and remove the unused English dashboard empty default.
DC3 Web
dc3-web is the Vue and TypeScript management frontend for IoT DC3. It communicates with the backend exclusively
through dc3-gateway.
Prerequisites
- Node.js 22 or newer, as declared by
enginesinpackage.json. - Corepack enabled.
- The pnpm version declared by
packageManagerinpackage.json.
corepack enable
pnpm install
Use pnpm only. Do not generate npm or Yarn lockfiles. When changing the package-manager version, keep package.json and
the Dockerfile toolchain pin aligned.
Develop
pnpm dev
The development server uses the port and API proxy configured by vite.config.ts and src/config/env/. Its defaults
are http://localhost:8080 for the UI and http://localhost:8000 for the gateway. The UI can start without the backend,
but login and data requests require a running gateway and center services.
Build and verify
pnpm check
pnpm lint:check
pnpm test:guard
pnpm test:ci
pnpm build
Run focused suites with pnpm test:unit, pnpm test:api, pnpm test:component, or pnpm test:views. Browser workflows
use pnpm test:e2e; see tests/README.md for the test layers and fixture policy.
Project conventions
- Vite environment files live under
src/config/env/and use theAPP_prefix. - Java 64-bit IDs are represented as strings and decoded with the existing JSONBigInt support.
- Type-only imports must use
import typebecauseverbatimModuleSyntaxis enabled. - API wrapper names mirror backend cardinality:
getXxxfor one result andlistXxxfor collections/pages/maps. - Every router-guard branch must settle navigation.
Repository-wide architecture, commit, and verification rules are in ../AGENTS.md.