Analytical Panel

Frontend-приложение аналитической панели карты компетенций.

Stack

• Vue 3 + <script setup>
• Vite
• Bun
• TypeScript
• Vue Router
• Pinia
• TanStack Vue Query
• Orval
• Zod / Vee Validate
• Tailwind CSS
• Local shadcn/reka-based UI-kit
• ESLint
• Prettier
• Steiger FSD lint
• Vitest
• Playwright

Quick Start

bun install
cp .env.example .env
bun run dev

Dev server uses Vite proxy for /api and /health.

Environment

VITE_DEV_API_PROXY_TARGET=https://anal-back.dev.nii-ecos.ru

Optional UI-kit map components may read VITE_MAPTILER_KEY, but the current analytical panel flow does not require it.

Commands

bun run dev            # local Vite dev server
bun run build          # typecheck + production build
bun run preview        # preview production build
bun run lint           # ESLint
bun run lint:fsd       # Steiger FSD lint
bun run format:check   # Prettier check
bun run test:unit      # Vitest
bun run test:e2e       # Playwright
bun run check          # lint + FSD lint + unit + build
bun run check:full     # check + Playwright E2E
bun run apigen         # regenerate API clients from openapi.json

Before handoff use:

bun run format:check
bun run check:full

Architecture

The project follows Feature-Sliced Design in a pragmatic form.

Main docs:

• docs/review.md - detailed review, refactoring plan and current status.
• docs/architecture.md - FSD structure and import rules.
• docs/generated-api.md - Orval/generated API workflow.
• docs/testing.md - test policy and remaining coverage gaps.

Key source areas:

src/app/                         # router, providers, app styles
src/pages/auth/                  # auth page
src/pages/dashboard/             # dashboard page, model, API wrappers, UI
src/widgets/protected-app-layout/ # protected shell, sidebar behavior, logout orchestration
src/entities/user/               # current user entity model
src/shared/api/                  # API client, token/session primitives, generated API facade
src/shared/ui/                   # pure shared UI
src/shared/ui-kit/               # local design system/vendor UI-kit

Generated API

Generated files live in:

src/shared/api/generated-api/
src/shared/model/generated-zod/

Do not edit them manually. Update openapi.json, then run:

bun run apigen

Application code should import API functions and DTO types through @/shared/api, not directly from generated-api.

Known Build Warnings

Production build currently passes with warnings:

• INVALID_ANNOTATION from node_modules/@vueuse/core/dist/index.js;
• main index-*.js chunk is larger than 500 kB.

These warnings are documented in docs/testing.md and should be handled in a separate bundle/performance pass.