Compare commits

...

41 Commits

Author SHA1 Message Date
0a0f7a5058 docs: refresh UI registry contract 2026-08-10 11:32:24 +09:00
c99dd39790 docs: adopt AI agent harness 2026-08-07 15:41:59 +09:00
ea5d1744a7 260708_01_ENH: 전체 차트에 차트 최소 표기 값 3.99로 지정 2026-07-08 10:58:12 +09:00
5502415825 260701_02_ENH: 사이트 접근 허용 IP추가 2026-07-01 14:17:23 +09:00
85f2b99345 260701_01_ENH: 사이트 접근 시 허용 IP만 접근하도록 수정 2026-07-01 14:15:05 +09:00
632b4d3de4 260618_01_ENH: 사이트 타이틀 변경 2026-06-18 18:18:16 +09:00
e55ba7ac01 260617_01_ENH: Comment Table의 현재 높이를 최소 높이로 지정 최대 높이는 쓰여지는 글에 따라 유동적으로 증가하도록 수정 2026-06-17 10:40:01 +09:00
5e53663b24 260609_01_ENH: 메인 페이지 안내문 /기준으로 앞뒤 띄어쓰기 1개씩 추가 및 안내문 1줄 추가
Comment 테이블에서 plan26 제거 및 label 수정, 테이블 width 조정, 안내문 추가
전체 현황 외 차트 테이블의 차트 시작 위치 수정
2026-06-09 16:48:19 +09:00
24d917ac7b 260528_01_ENH: 28일 수정 사항 적용 2026-05-28 17:30:43 +09:00
d88b388912 260522_01_ENH: 사이트 타이틀 변경 2026-05-22 09:54:32 +09:00
6d79a3be1e 260521_01_ENH: 페이지별 오타 수정, 일부 테이블 높이 수정, gap에서 0.00은 "-"가 아닌 연한 회색의 0.00 표기, 자기 자신과의 비교는 null 2026-05-21 16:52:37 +09:00
dd95d04298 260518_04_ENH: Gap 연산 시 반올림 후 진행하도록 수정 2026-05-18 17:11:38 +09:00
972d5baef5 260518_03_ENH: 전체현황 테이블 넓이 조정 2026-05-18 16:57:10 +09:00
9f0cc7d7e3 260518_02_ENH: 전체현황, 안전점검에 지역본부 평균 대비 row 추가 2026-05-18 15:35:08 +09:00
eddf9da03e 260518_01_ENH: 순위 테이블, 코멘트 테이블에 타이틀 추가 및
섹션 타이틀에 SUFFIX 추가
2026-05-18 09:22:08 +09:00
c197fbcde9 260515_04_ENH: 조사 및 지역에 대한 노출 config 기준으로 되도록 수정 2026-05-15 15:53:11 +09:00
bab36848af 260515_03_ENH: SectionTitle 글자크기 확대 MainLayout padding 조정 2026-05-15 15:15:21 +09:00
ba81aaa8a5 260515_02_ENH: 기존 프로젝트 전용 util file명 오타 수정 및 추가로 필요한 util 추가 2026-05-15 14:39:15 +09:00
b041a25e47 260515_01_ENH: 클라이언트 수정사항 반영 및 다른 조사들 data 연결 2026-05-15 14:36:58 +09:00
fcca4a0be7 260508_20_ENH: 메인 페이지에서 이동 할 때도 파라미터 유지하도록 수정 2026-05-08 12:24:39 +09:00
c558369b10 260508_19_ENH: 안쓰는 메뉴 숨김 2026-05-08 12:18:47 +09:00
b884c5e998 260508_18_ENH: 이전 커밋 누락파일 2026-05-08 12:16:51 +09:00
f37e2923e9 260508_17_ENH: 클라이언트 강력 요청으로 로그인 아예 걷고 파라미터 기반으로 admin 기능 우회 2026-05-08 12:16:35 +09:00
fc1074cf4e 260508_16_ENH: 암복호화 key에 대한 검증 로직 추가 2026-05-08 11:54:13 +09:00
4a30758d7f 260508_15_ENH: 필요없는 로그 걷어냄 2026-05-08 11:36:20 +09:00
e93f6c8f41 260508_14_ENH: 새로고침 시 로그인 풀리는 문제 수정 중 2026-05-08 11:34:10 +09:00
b73d5d55fb 260508_13_ENH: 새로고침 시 로그인 풀리는 문제 수정 중 2026-05-08 11:30:58 +09:00
4a06fc7e83 260508_12_ENH: 새로고침 시 로그인 풀리는 문제 수정 중 2026-05-08 11:27:20 +09:00
b9642961ac 260508_11_ENH: 새로고침 시 로그인 풀리는 문제 수정 중 2026-05-08 11:23:54 +09:00
e528f6a67e 260508_10_ENH: 새로고침 시 로그인 풀리는 문제 수정 중 2026-05-08 11:12:44 +09:00
e224455dea 260508_09_ENH: 새로고침 시 로그인 풀리는 문제 수정 중 2026-05-08 11:08:22 +09:00
c7b0655ec2 260508_08_ENH: 새로고침 시 로그인 풀리는 문제 수정 중 2026-05-08 11:04:18 +09:00
8c0b19d542 260508_07_ENH: 새로고침 시 로그인 풀리는 문제 수정 중 2026-05-08 10:59:44 +09:00
b3c9a8f6ee 260508_06_ENH: 새로고침 시 로그인 풀리는 문제 수정 중 2026-05-08 10:57:59 +09:00
5fe38e1c90 260508_05_ENH: 새로고침 시 로그인 풀리는 문제 수정 2026-05-08 10:54:18 +09:00
295b914f0f 260508_04_ENH: 새로고침 시 로그인 풀리는 문제 수정 2026-05-08 10:44:58 +09:00
4c4ef662fd 260508_03_ENH: 새로고침 시 로그인 풀리는 문제 수정 2026-05-08 10:32:58 +09:00
b9fa6255b7 260508_02_ENH: 새로고침 시 로그인 풀리는 문제 수정 2026-05-08 10:23:02 +09:00
6c2399b283 260508_01_ENH: 잘못된 스타일 제거 및 코드 정리 2026-05-08 09:17:01 +09:00
393fd36c95 260507_05_ENH: 갭에 스타일 적용 2026-05-07 18:51:18 +09:00
57752ba87b 260507_04_ENH: total에 지역본수 순서 맞춤 2026-05-07 18:41:05 +09:00
64 changed files with 2743 additions and 1017 deletions

18
.agent/profile.yml Normal file
View File

@@ -0,0 +1,18 @@
schema_version: 1
project:
id: kfpa-cx-dash-front
name: KFPA CX Dashboard Frontend
type: requested-project
layer: frontend
legacy: false
stack:
- typescript
- react
- nextjs
shared_contracts:
consumes:
- kri-front-common
- kri-ui-registry

20
.agent/project.md Normal file
View File

@@ -0,0 +1,20 @@
## KFPA CX Dashboard Frontend Repository Rules
### Deliverable and User Experience
- This Next.js frontend visualizes KFPA CSI summaries, ranks, business and object-type comparisons, comments, and related survey results.
- Treat approved planning and acceptance material as the scope boundary. Preserve section navigation, survey-date context, filters, labels, chart/table values, rankings, comment workflows, and export behavior.
- A visual change must not silently alter the represented score, denominator, rank, tie handling, ordering, rounding, tooltip meaning, or empty-data behavior.
- Keep customer survey data, comments, exported workbooks, and planning material out of logs, fixtures, screenshots, and external services.
### Frontend Implementation
- Use the consumed KRI frontend common and UI registry contracts. Prefer an existing shadcn/ui or registry component before creating a new foundational component.
- Do not create new TypeScript type or interface names ending in `Dto` or `DTO`.
- Preserve accessibility, responsive layout, loading, empty, error, unauthorized, confirmation, success, and administrative-edit states.
- Coordinate API request, response, authentication, statistics, comment, and error changes with the backend without requiring an unsafe simultaneous deployment.
### Harness and Verification
- `AGENTS.md` and `CLAUDE.md` are generated. Edit `.agent/profile.yml` or `.agent/project.md`, then recompose instead of editing generated files.
- Use existing npm scripts and focused lint, type-check, test, or production build checks. Do not call production APIs, modify real comments, or export customer data during validation.

View File

@@ -3,3 +3,4 @@ NEXT_PUBLIC_API_BASE=https://test-kfpa-dash.kric.com/api
ENV=prod
API_BACK_SERVER=http://127.0.0.1:6103/api/v1
IP_WHITELIST=127.0.0.1,::1,211.37.10.198,211.254.145.130,1.235.195.3

View File

@@ -3,3 +3,4 @@ NEXT_PUBLIC_API_BASE=http://localhost:6102/api
ENV=local
API_BACK_SERVER=http://localhost:6103/api/v1
IP_WHITELIST=127.0.0.1,::1

View File

@@ -3,3 +3,4 @@ NEXT_PUBLIC_API_BASE=https://kfpa-dash.kric.com/api
ENV=prod
API_BACK_SERVER=http://127.0.0.1:6103/api/v1
IP_WHITELIST=127.0.0.1,::1,211.37.10.198,211.254.145.130,1.235.195.3

4
.gitattributes vendored Normal file
View File

@@ -0,0 +1,4 @@
/.gitattributes text eol=lf
/.agent/** text eol=lf
/AGENTS.md text eol=lf
/CLAUDE.md text eol=lf

306
AGENTS.md Normal file
View File

@@ -0,0 +1,306 @@
<!--
GENERATED BY KRI AGENT HARNESS. DO NOT EDIT DIRECTLY.
Project: kfpa-cx-dash-front
Schema version: 1
Edit the source fragments or repository .agent files, then recompose.
-->
# KRI Development Base Instructions
This document defines the shared working rules for KRI development repositories.
Keep project-specific facts and commands in the project profile and project rules.
## Instruction Resolution
Apply repository instructions in this order:
1. Base rules
2. Project-type rules
3. Technology-stack rules
4. Shared consumer contracts
5. Project-specific rules
6. The explicitly approved task scope
Later and more specific instructions may override earlier general instructions only within their stated scope.
- Apply a shared consumer contract only when `.agent/profile.yml` declares it.
- Do not silently resolve a material instruction conflict. Report the conflicting rules and request a decision before changing files.
- Rules involving destructive actions, credentials, external systems, production, deployment, databases, or Git publication require explicit authorization even when a later rule is less restrictive.
## Communication
- Respond to the user in Korean unless the user requests another language.
- Keep code identifiers, commands, paths, protocol names, and external API terms in their original form.
- Follow the repository's existing language conventions for code comments and user-facing messages.
- Lead with the result or decision, then provide only the detail needed to verify it.
- Do not create or retain a full session transcript.
## Work Authorization
- The default workflow is discussion first and explicit execution approval second.
- During discussion, perform only read-only investigation needed to understand the task and propose a concrete plan, unless the user prohibits inspection.
- Read-only investigation may include file inspection, code search, encoding checks, `git status`, `git diff`, `git log`, and sanitized official-documentation lookup.
- Before execution approval, do not edit files, install dependencies, run builds or tests, start services, connect to databases, or change local or external state.
- Before requesting approval, describe the intended scope, affected areas, validation plan, and material risks.
- Treat approval as limited to the presented scope. Pause and discuss again if the work materially expands.
- If the user explicitly requests immediate execution without prior discussion, the discussion gate may be skipped for the stated scope.
- Fast-track authorization does not implicitly authorize protected operations such as destructive commands, production changes, deployments, database mutations, Git publication, or external messages.
## Local Development Environment
- Primary OS: Windows 11.
- Primary shell: PowerShell.
- Use Git Bash only when the repository already depends on Bash or POSIX shell behavior.
- Prefer repository-provided wrappers and scripts over globally installed commands.
- Do not assume that GNU utilities, WSL, Docker, or a Unix-compatible shell are available unless the project profile confirms them.
- Detect Java, Node.js, .NET, Python, package-manager, and database-tool versions from repository configuration.
- Do not install or modify global toolchains as part of a project task.
Preferred human-facing tools:
- Classic ASP: Visual Studio Code
- Java and Spring Boot: IntelliJ IDEA
- C# and .NET: JetBrains Rider
- JavaScript, TypeScript, and Next.js: JetBrains WebStorm
- Python: JetBrains PyCharm
- Microsoft SQL Server: SQL Server Management Studio
- Other databases: JetBrains DataGrip
- These preferences do not authorize launching or controlling a GUI application.
- Prefer IDE-independent commands that can also run in CI.
- Do not modify global IDE settings.
- Do not create or modify `.idea`, `.vscode`, workspace, or run-configuration files unless the approved task requires it.
- Preserve existing shared IDE configuration when it is already tracked.
## PowerShell and Path Safety
- Quote paths containing spaces, brackets, parentheses, Korean characters, or PowerShell metacharacters.
- Prefer `-LiteralPath` when operating on an exact filesystem path.
- Use project-relative paths in committed configuration and documentation. Do not commit machine-specific paths such as `D:\_____Dev\...`.
- Do not pass filesystem targets between PowerShell, `cmd.exe`, and Bash for destructive or recursive operations.
- Keep a filesystem operation within one shell from target resolution through execution.
- Before a recursive delete or move, resolve and verify every absolute target.
- Never use a drive root, workspace root, user profile, unresolved variable, wildcard, or broad glob as a recursive delete target.
- Prefer recoverable operations when practical.
## Change Discipline
- Preserve all existing user changes, including uncommitted and untracked work.
- Keep changes minimal but complete for the approved objective.
- Avoid unrelated cleanup, formatting, renaming, dependency upgrades, and architectural refactoring.
- Do not overwrite or revert unrelated changes.
- Stop and report when the requested change overlaps existing work in a way that cannot be handled safely.
- Prefer changing an authoritative source over editing generated output.
- Treat files marked as generated as read-only unless regeneration is part of the approved plan.
- Do not edit vendored dependencies, build outputs, caches, or generated clients unless explicitly required.
- Do not regenerate a broad set of files for a narrow change without first explaining the expected output scope.
## Text Encoding and Korean Content Safety
- Treat the existing file encoding, BOM state, and line-ending style as part of the file's contract.
- Preserve Korean comments, user-facing messages, error messages, identifiers, and documentation exactly unless the task explicitly requires changing them.
- Do not assume that garbled terminal output means the file itself is corrupted. Verify bytes and encoding before modifying suspicious text.
- Before editing an existing text file, determine its current encoding and BOM state when repository configuration does not already guarantee them.
- Do not convert encoding, add or remove a BOM, or normalize line endings as a side effect of an unrelated change.
- Avoid whole-file rewrites for small changes.
- Do not rewrite source files through `Get-Content | Set-Content`, `Out-File`, shell redirection, or another method whose encoding behavior is implicit.
- Do not use a patching or formatting tool on a non-UTF-8 file unless it is known to preserve that file's encoding.
- Treat a console display problem and an on-disk encoding problem as separate issues.
- After editing Korean text, inspect the diff for replacement characters (`<60>`), mojibake, unexpected escapes, BOM changes, and unrelated line-ending changes.
- Run `.agent/tools/check-encoding.ps1` when it is available and the change touches Korean text or a non-default encoding.
- If encoding cannot be identified confidently, stop before writing and report the affected file and evidence.
- For a new text file, follow repository configuration. If no rule exists, use UTF-8 without BOM.
## Git Safety
- Use `git status`, `git diff`, and `git log` for read-only investigation.
- Do not run `commit`, `push`, `pull`, `fetch`, `merge`, `rebase`, `reset`, `checkout`, `switch`, `stash`, `clean`, `tag`, or force operations unless that specific operation is explicitly approved.
- Source-edit approval does not include commit or push approval.
- Never amend an existing commit unless explicitly requested.
- Before an approved commit, show the intended files, validation results, and proposed commit message.
- Never push directly to a protected branch unless the user names the target branch and explicitly authorizes the push.
## Dependencies and External Actions
- Use the package manager, lockfile, and toolchain already selected by the repository.
- Do not install global packages.
- Do not add, remove, or upgrade a dependency unless it was included in the approved plan.
- Pause for approval if an unplanned dependency becomes necessary.
- Keep lockfiles synchronized with approved dependency changes.
- Do not deploy, publish packages, create releases, send messages or email, call business APIs, or modify external services unless explicitly requested.
- Never upload proprietary source code, internal documents, credentials, customer data, or database contents to an external service.
- Remove secrets and unnecessary internal identifiers from external search queries.
## Database Safety
- Treat writing or reviewing SQL as source code separately from executing SQL against a database.
- SQL files, migrations, schema proposals, and query drafts may be created within an approved source-change scope.
- Do not connect to a shared, staging, or production database without explicit authorization for that environment.
- Read-only queries against a non-local database also require authorization because results may contain sensitive data.
- Do not execute DDL, DML, stored procedures, migrations, administrative commands, or data-correction scripts against a non-disposable database without separate authorization for the exact target and operation.
- Source-change approval does not authorize migration execution.
- Use a disposable local or test database for approved validation only after verifying its identity and disposable nature.
- Never place credentials, connection strings, or sensitive query results in source files, logs, generated documents, or chat output.
## Secrets and Sensitive Data
- Never add credentials, tokens, passwords, private keys, connection strings, session identifiers, or production data to source control.
- Read sensitive files only when the approved task requires it and no safer source exists.
- Prefer inspecting configuration keys and schemas without displaying secret values.
- Never echo secrets into terminal output, chat responses, logs, diffs, generated documents, test fixtures, or screenshots.
- Redact sensitive values when reporting errors or command output.
- If a possible secret is discovered, do not repeat it. Report only its location, type, and recommended containment action.
- Do not rotate, revoke, copy, or otherwise modify credentials unless that exact action is explicitly authorized.
## Validation
- Discover supported build, test, lint, type-check, and formatting commands from repository files and project instructions. Do not invent commands.
- Include intended validation in the discussion-phase plan.
- After approved changes, run the narrowest relevant validation first, then broader checks when appropriate.
- Limit formatting to files within the approved scope.
- Do not run tests that require a shared database, production service, paid external API, or sensitive data unless separately authorized.
- Do not claim that a check passed unless it was executed successfully.
- If a check cannot be run, state the exact reason.
- Distinguish a current-change failure from a pre-existing failure or an undetermined failure.
- Do not fix unrelated failures without expanding the approved scope.
- Inspect the worktree after validation for unexpected generated files, formatting churn, encoding changes, or lockfile changes.
## Artifacts and Session Records
- Do not create full-session transcripts, automatic HTML copies, analysis reports, or extra documentation unless explicitly requested.
- Store durable information in the repository's existing documentation structure.
- Do not place generated reports or temporary analysis files in the repository root.
- Remove task-specific temporary files created by the current task after validation when removal is safe.
## Completion Report
When implementation is complete, report in Korean:
- what changed and why;
- the main affected files or components;
- validation commands actually executed and their results;
- checks not executed and the reason;
- remaining risks, assumptions, or follow-up work;
- database, deployment, dependency, encoding, and compatibility impact when applicable.
- Do not report completion while required validation is failing or known encoding corruption is unresolved.
- Keep the report concise and do not include a full session transcript.
## Requested Project Rules
- Treat the approved requirements, acceptance criteria, and recorded decisions as the primary scope boundary.
- Do not infer a requirement solely from a file name, folder date, or apparently newer document.
- When requirements conflict, report the exact sources and request a decision.
- Preserve original customer, partner, and planning documents as read-only evidence unless document editing is explicitly approved.
- Summarize durable implementation requirements inside the repository rather than relying only on files outside the repository.
- Do not expand the deliverable with speculative features, infrastructure, or architectural changes.
- Record material assumptions and unresolved decisions in the project-specific rules or existing project documentation.
- Define observable acceptance criteria before implementation.
- Treat separately managed Frontend and Backend repositories as independent deliverables with a coordinated contract.
- Protect customer, partner, survey, and field data as sensitive information.
- Keep handoff, operation, configuration, and validation instructions usable by the requesting team.
- Report deviations from the requested scope and obtain approval before proceeding.
## TypeScript
- Treat the repository's current TypeScript version, `tsconfig` files, module system, path aliases, and package manager as authoritative.
- Preserve or strengthen existing strictness. Do not weaken compiler options or hide errors with broad `any`, `@ts-ignore`, or unsafe assertions.
- Prefer narrow domain types, discriminated unions, and explicit boundary types over duplicated or overly generic shapes.
- Validate untrusted runtime input even when a compile-time type exists.
- Keep imports, exports, aliases, and generated-code boundaries consistent with the repository.
- Do not introduce a JavaScript-to-TypeScript conversion outside the approved scope.
- Run the repository's focused type-check, lint, test, and build commands as applicable.
## React
- Treat the current React version, component style, state management, routing, styling, and test approach as authoritative.
- Do not perform unrelated class-to-hook, JavaScript-to-TypeScript, state-library, styling-system, or React-to-Next.js migrations.
- Keep components focused and follow the repository's established split between presentation, state, data access, and side effects.
- Keep effects dependency-correct and clean up subscriptions, timers, listeners, and in-flight work where applicable.
- Use stable semantic keys and preserve accessibility, loading, empty, error, disabled, and success states.
- Preserve public component props and shared UI contracts unless a coordinated breaking change is explicitly approved.
- Treat any planned Next.js migration as a separate policy and task; the current React application remains authoritative until that migration slice is approved.
## Next.js
- Treat the repository's current Next.js and React versions, routing model, rendering model, and package manager as authoritative.
- Preserve server and client component boundaries. Add `use client` only when browser APIs, state, effects, or client-only libraries require it.
- Keep secrets, privileged data access, and server-only modules out of client bundles.
- Preserve established route, layout, middleware, authentication, authorization, caching, revalidation, and error-handling conventions.
- Validate request parameters, payloads, headers, cookies, and external responses at runtime.
- Do not create new frontend TypeScript type or interface names ending in `Dto` or `DTO`. Use domain- or purpose-specific names such as `User`, `UserInput`, `UserRequest`, or `UserResponse`; do not rename existing types solely to enforce this rule outside the approved scope.
- Use the approved KRI frontend and UI contracts when the project profile includes them; do not copy shared implementations into an application.
- Avoid incidental routing-model or rendering-strategy migrations.
- Run the repository's focused lint, type-check, test, and production build commands as applicable.
## KriFrontCommon Consumer Contract
### Package Usage
- Consume this contract through the published `@kri/common` package and only through entry points declared in its `package.json` `exports` map.
- Use the package root for runtime-neutral object, URL, date, string, and shared type utilities.
- Use a focused subpath such as `@kri/common/http`, `@kri/common/browser`, `@kri/common/server`, `@kri/common/security`, `@kri/common/hooks`, `@kri/common/query`, `@kri/common/config`, `@kri/common/jotai`, or `@kri/common/noti-hub` for the corresponding capability.
- Do not import from `@kri/common/src/*`, `@kri/common/dist/*`, or another undeclared deep path.
- Do not copy or fork a shared utility locally merely to avoid using an available public entry point. Propose a backward-compatible library addition when the shared contract is genuinely missing.
### Runtime and Optional Integrations
- Keep browser, server, and runtime-neutral imports on their intended side of the application boundary.
- A consumer that uses React hooks, TanStack Query, or Jotai integrations must provide the compatible optional peer dependency required by its selected entry point.
- Preserve the project's established HTTP client, authentication, error-policy, query-client, storage, and environment conventions when adopting a shared helper.
- Validate external data at runtime; a shared TypeScript type alone does not validate an API response or persisted value.
- Prefer named public exports and retain the consumer project's current module system and bundler conventions.
### Change Safety
- Pin or constrain the package version according to the consumer repository's dependency policy and commit its lockfile changes.
- Review release notes and the actual affected API before upgrading. Run the consumer's focused type-check, test, and build commands after an upgrade.
- Do not modify KriFrontCommon or another consumer repository unless it is explicitly included in the approved task scope.
## KriUiRegistry Consumer Contract
### UI Component Selection
When implementing or changing frontend UI, use this order:
1. Reuse an existing shared component in the project when it already meets the requirement.
2. Prefer an approved component from KriUiRegistry.
3. Otherwise, prefer a suitable shadcn/ui component.
4. Create a new custom component only when the preceding options cannot meet the requirement without an unsafe or misleading adaptation.
### Installation and Ownership
- Inspect the registry item and its dependencies before installation. Use the shadcn CLI with the approved registry endpoint under `https://ui-registry.kric.com/r/` instead of copying files from `dist/r` manually.
- `kri-data-table` uses the TanStack Table v8 API. Keep `@tanstack/react-table` within the supported `^8.21.3` range and do not upgrade it to v9 until KriUiRegistry provides an explicitly migrated component contract.
- Respect the consumer project's component aliases, target paths, package manager, styling system, React version, and existing design tokens.
- The shadcn workflow copies component source into the consumer repository. After installation, treat that copy as project-owned code; do not assume registry updates propagate automatically.
- Do not overwrite an existing project component without reviewing the diff and confirming that local behavior and accessibility are preserved.
- Keep package and lockfile changes produced by an installation within the approved scope.
### Adaptation and Verification
- Adapt business data and application behavior outside the shared component when possible. Avoid embedding project-specific API, route, authentication, or environment logic into a reusable component.
- Preserve the installed component's public props, accessibility, keyboard behavior, responsive layout, and loading, empty, error, and disabled states unless the task explicitly changes them.
- If the registry lacks a generally reusable capability, propose it in KriUiRegistry; do not modify that repository unless it is explicitly in scope.
- Run the consumer repository's focused type-check, lint, tests, and build after installation or upgrade.
## KFPA CX Dashboard Frontend Repository Rules
### Deliverable and User Experience
- This Next.js frontend visualizes KFPA CSI summaries, ranks, business and object-type comparisons, comments, and related survey results.
- Treat approved planning and acceptance material as the scope boundary. Preserve section navigation, survey-date context, filters, labels, chart/table values, rankings, comment workflows, and export behavior.
- A visual change must not silently alter the represented score, denominator, rank, tie handling, ordering, rounding, tooltip meaning, or empty-data behavior.
- Keep customer survey data, comments, exported workbooks, and planning material out of logs, fixtures, screenshots, and external services.
### Frontend Implementation
- Use the consumed KRI frontend common and UI registry contracts. Prefer an existing shadcn/ui or registry component before creating a new foundational component.
- Do not create new TypeScript type or interface names ending in `Dto` or `DTO`.
- Preserve accessibility, responsive layout, loading, empty, error, unauthorized, confirmation, success, and administrative-edit states.
- Coordinate API request, response, authentication, statistics, comment, and error changes with the backend without requiring an unsafe simultaneous deployment.
### Harness and Verification
- `AGENTS.md` and `CLAUDE.md` are generated. Edit `.agent/profile.yml` or `.agent/project.md`, then recompose instead of editing generated files.
- Use existing npm scripts and focused lint, type-check, test, or production build checks. Do not call production APIs, modify real comments, or export customer data during validation.

1
CLAUDE.md Normal file
View File

@@ -0,0 +1 @@
@AGENTS.md

View File

@@ -3,7 +3,8 @@
"version": "0.1.0",
"private": true,
"scripts": {
"dev": "next dev -p 6102",
"clean:next": "powershell -NoProfile -Command \"Remove-Item -Recurse -Force .next -ErrorAction SilentlyContinue\"",
"dev": "npm run clean:next && next dev -p 6102",
"build": "next build",
"start": "next start -p 6102",
"lint": "eslint"

BIN
public/KRi_full_logo.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

View File

@@ -1,9 +1,21 @@
'use client'
"use client";
import { useLayoutFilter } from "@/components/layout/LayoutCategoryContext";
import CustomerSatisfactionTotal from "@/components/kfpa/CustomerSatisfactionTotal";
import CustomerSatisfactionDetail from "@/components/kfpa/CustomerSatisfactionDetail";
import { COMMENT_TABLE_TITLE } from "@/config/kfpa.config";
const BridgePlatformPage = () => {
return (
<div>BridgePlatformPage</div>
)
}
const { selectedDiv } = useLayoutFilter();
return selectedDiv === "-1"
? <CustomerSatisfactionTotal />
: <CustomerSatisfactionDetail
selectedDiv={selectedDiv}
viewSubTitle={false}
sectionTitleSuffix={COMMENT_TABLE_TITLE}
widthClassName="w-[1200px]"
/>;
};
export default BridgePlatformPage;

View File

@@ -1,9 +1,13 @@
'use client'
"use client";
import { useLayoutFilter } from "@/components/layout/LayoutCategoryContext";
import CustomerSatisfactionTotal from "@/components/kfpa/CustomerSatisfactionTotal";
import CustomerSatisfactionDetail from "@/components/kfpa/CustomerSatisfactionDetail";
const ConsultingPage = () => {
return (
<div>ConsultingPage</div>
)
}
const { selectedDiv } = useLayoutFilter();
return selectedDiv === "-1" ? <CustomerSatisfactionTotal /> : <CustomerSatisfactionDetail selectedDiv={selectedDiv} widthClassName="w-[1200px]"/>;
};
export default ConsultingPage;

View File

@@ -1,10 +1,13 @@
"use client";
'use client'
import { useLayoutFilter } from "@/components/layout/LayoutCategoryContext";
import CustomerSatisfactionTotal from "@/components/kfpa/CustomerSatisfactionTotal";
import CustomerSatisfactionDetail from "@/components/kfpa/CustomerSatisfactionDetail";
const FireInvestigationPage = () => {
return (
<div>FireInvestigationPage</div>
)
}
const { selectedDiv } = useLayoutFilter();
return selectedDiv === "-1" ? <CustomerSatisfactionTotal /> : <CustomerSatisfactionDetail selectedDiv={selectedDiv} widthClassName="w-[1200px]"/>;
};
export default FireInvestigationPage;

View File

@@ -1,9 +1,13 @@
'use client'
"use client";
const InsuranceOperationPage = () => {
return (
<div>InsuranceOperationPage</div>
)
}
import { useLayoutFilter } from "@/components/layout/LayoutCategoryContext";
import CustomerSatisfactionTotal from "@/components/kfpa/CustomerSatisfactionTotal";
import CustomerSatisfactionDetail from "@/components/kfpa/CustomerSatisfactionDetail";
export default InsuranceOperationPage;
const InsuranceOperationsPage = () => {
const { selectedDiv } = useLayoutFilter();
return selectedDiv === "-1" ? <CustomerSatisfactionTotal /> : <CustomerSatisfactionDetail selectedDiv={selectedDiv} widthClassName="w-[1200px]"/>;
};
export default InsuranceOperationsPage;

View File

@@ -1,7 +1,9 @@
import {redirect} from "next/navigation";
"use client"
import CustomerSatisfactionSummary from "@/components/kfpa/CustomerSatisfactionSummary";
const MainPage = () => {
redirect("/safety-inspection");
return <CustomerSatisfactionSummary />
}
export default MainPage;

View File

@@ -1,15 +1,18 @@
'use client'
"use client";
import {useLayoutFilter} from "@/components/layout/LayoutCategoryContext";
import SafetyInspectionTotal from "./sub/SafetyInspectionTotal";
import SafetyInspectionDivDetail from "./sub/SafetyInspectionDivDetail";
import { useLayoutFilter } from "@/components/layout/LayoutCategoryContext";
import CustomerSatisfactionTotal from "@/components/kfpa/CustomerSatisfactionTotal";
import CustomerSatisfactionDetail from "@/components/kfpa/CustomerSatisfactionDetail";
const SafetyInspectionPage = () => {
const { selectedDiv } = useLayoutFilter();
return (
selectedDiv === "-1" ? <SafetyInspectionTotal /> : <SafetyInspectionDivDetail selectedDiv={selectedDiv} />
)
}
return selectedDiv === "-1"
? <CustomerSatisfactionTotal />
: <CustomerSatisfactionDetail
selectedDiv={selectedDiv}
//widthClassName="w-[1553px]"
/>;
};
export default SafetyInspectionPage;

View File

@@ -1,302 +0,0 @@
"use client";
import { useEffect, useMemo, useState } from "react";
import { useQueryClient } from "@tanstack/react-query";
import { toast } from "sonner";
import DataTable from "@/components/table/DataTable";
import type { DataColumn } from "@/components/table/types";
import { Button } from "@/components/ui/button";
import { DIV_KEY_MAP } from "@/config/kfpaConfig";
import { useAuth } from "@/hooks/useAuth";
import { formatKoreanBaseDate } from "@/lib/utils";
import { useWriteDivCommentMutation } from "@/query/admin";
import { statisticsQueryKeys } from "@/query/key/keys";
import { useDivDetailDataQuery } from "@/query/statistics";
import type { CommentValue, DivDetailData } from "@/types/kfpa";
import { Pencil, Save, X } from 'lucide-react';
import SectionTitle from "@/components/common/SectionTitle";
export type SafetyInspectionDivDetailProps = {
selectedDiv: string;
};
type RankRow = {
type: string;
csi: number | null;
rank: string;
};
type CommentField = keyof CommentValue;
type CommentRow = {
label: string;
importance: string;
field: CommentField;
};
type CommentTableRow = CommentRow & Record<string, unknown>;
const DEFAULT_COMMENT_COLUMNS = [
{ key: "performance25", label: "25년 성과" },
{ key: "plan26", label: "26년 업무계획" },
{ key: "performance26", label: "26년 업무계획 진행률 및 성과" },
];
const COMMENT_ROWS: CommentRow[] = [
{ label: "고객 직접 체감", importance: "★★★", field: "directExperience" },
{ label: "고객 간접 체감", importance: "★★", field: "indirectExperience" },
{ label: "내부역량 강화 등", importance: "★", field: "capability" },
];
const RANK_ROWS = [
{ key: "90", label: "일반" },
{ key: "4", label: "공장" },
{ key: "12", label: "아파트" },
];
const getSelectedDetail = (data: Record<string, DivDetailData> | undefined, selectedDiv: string) => {
if (!data) return undefined;
return data[selectedDiv] ?? Object.values(data)[0];
};
const getCommentColumns = (commentValues?: Record<string, CommentValue>) => {
const keys = Object.keys(commentValues ?? {});
const selectedKeys = keys.length > 0 ? keys : DEFAULT_COMMENT_COLUMNS.map((column) => column.key);
return selectedKeys.map((key, index) => ({
key,
label: DEFAULT_COMMENT_COLUMNS[index]?.label ?? key,
}));
};
const createEmptyCommentValue = (): CommentValue => ({
directExperience: "",
indirectExperience: "",
capability: "",
});
const createDraft = (columns: Array<{ key: string }>, source?: Record<string, CommentValue>) =>
columns.reduce<Record<string, CommentValue>>((acc, column) => {
acc[column.key] = {
...createEmptyCommentValue(),
...(source?.[column.key] ?? {}),
};
return acc;
}, {});
const SafetyInspectionDivDetail = ({ selectedDiv }: SafetyInspectionDivDetailProps) => {
const { auth } = useAuth();
const queryClient = useQueryClient();
const { data, isLoading, isError } = useDivDetailDataQuery(selectedDiv, selectedDiv !== "-1");
const writeMutation = useWriteDivCommentMutation();
const detail = useMemo(() => getSelectedDetail(data, selectedDiv), [data, selectedDiv]);
const commentColumns = useMemo(() => getCommentColumns(detail?.commentValues), [detail?.commentValues]);
const [isEditing, setIsEditing] = useState(false);
const [draft, setDraft] = useState<Record<string, CommentValue>>(() =>
createDraft(commentColumns, detail?.commentValues)
);
useEffect(() => {
setIsEditing(false);
setDraft(createDraft(commentColumns, detail?.commentValues));
}, [commentColumns, detail?.commentValues, selectedDiv]);
const baseDateLabel = useMemo(() => formatKoreanBaseDate(), []);
const isAuthenticated = auth.user != null;
const rankRows: RankRow[] = useMemo(() => {
const ranks = detail?.csiRanks ?? {};
return RANK_ROWS.map(({ key, label }) => ({
type: label,
csi: ranks[key]?.csi ?? 0,
rank: `${ranks[key]?.divRank ?? 0}/6`,
}));
}, [detail?.csiRanks]);
const rankColumns: DataColumn<RankRow>[] = useMemo(
() => [
{ key: "type", header: "물건 유형", align: "center" },
{
key: "csi",
header: "고객만족지수",
align: "center",
render: (row) => (typeof row.csi === "number" ? row.csi.toFixed(2) : "-"),
},
{ key: "rank", header: "지역본부순위", align: "center" },
],
[]
);
const updateDraft = (columnKey: string, field: CommentField, value: string) => {
setDraft((prev) => ({
...prev,
[columnKey]: {
...createEmptyCommentValue(),
...(prev[columnKey] ?? {}),
[field]: value,
},
}));
};
const commentRows: CommentTableRow[] = useMemo(
() =>
COMMENT_ROWS.map((row) => ({
...row,
...Object.fromEntries(commentColumns.map((column) => [column.key, draft[column.key]?.[row.field] ?? ""])),
})),
[commentColumns, draft]
);
const commentTableColumns: DataColumn<CommentTableRow>[] = useMemo(
() => [
{
key: "label",
header: "",
rowHead: true,
width: 170,
align: "center",
cellClassName: "bg-red-50 text-center font-bold",
},
{
key: "importance",
header: "중요도(난이도)",
width: 110,
align: "center",
cellClassName: "font-bold",
},
...commentColumns.map<DataColumn<CommentTableRow>>((column) => ({
key: column.key,
header: column.label,
align: "left",
cellClassName: "align-top",
render: (row) => {
const value = String(draft[column.key]?.[row.field] ?? "");
if (!isEditing) {
return <div className="min-h-24 whitespace-pre-wrap text-left">{value || "-"}</div>;
}
return (
<textarea
className="min-h-28 w-full resize-y border border-gray-300 bg-background p-2 text-sm outline-none focus:border-primary"
value={value}
onChange={(event) => updateDraft(column.key, row.field, event.target.value)}
/>
);
},
})),
],
[commentColumns, draft, isEditing]
);
const handleSave = () => {
writeMutation.mutate(
{
divId: Number(selectedDiv),
commentValues: draft,
},
{
onSuccess: () => {
setIsEditing(false);
queryClient.invalidateQueries({ queryKey: statisticsQueryKeys.divDetail(selectedDiv) });
toast.success("저장되었습니다.");
},
onError: () => {
toast.error("저장하지 못했습니다.");
},
}
);
};
const handleEditToggle = () => {
if (!isAuthenticated) return;
if (isEditing) {
handleSave();
return;
}
setIsEditing(true);
};
const handleCancelEdit = () => {
setDraft(createDraft(commentColumns, detail?.commentValues));
setIsEditing(false);
};
if (isLoading) {
return <div className="content-text-sm text-muted-foreground">데이터를 불러오는 중입니다.</div>;
}
if (isError) {
return <div className="content-text-sm text-destructive">지역본부 상세 데이터를 불러오지 못했습니다.</div>;
}
return (
<div className="flex w-full flex-col gap-8">
<div>
<SectionTitle title={DIV_KEY_MAP[selectedDiv] ?? ""} />
<div className="mt-6 mb-2 max-w-[360px]">
<div className="mb-2 text-right content-text-base">{baseDateLabel}</div>
<DataTable
columns={rankColumns}
rows={rankRows}
tableClassName="kfpa-table"
wrapperClassName="w-full"
minWidth={360}
/>
</div>
</div>
<div>
{isAuthenticated && (
<div className="mb-2 flex justify-end gap-2">
<Button
type="button"
className={
isEditing
? "gap-2 border border-transparent bg-red-600 text-white w-25 shadow-sm hover:bg-red-500 hover:text-white"
: "gap-2 border border-transparent bg-green-600 text-white w-25 shadow-sm hover:bg-green-500 hover:text-white"
}
disabled={writeMutation.isPending}
onClick={handleEditToggle}
>
{isEditing ? (
<>
<Save className="w-4 h-4" />
<span className="hidden sm:inline">{"저장"}</span>
</>
) : (
<>
<Pencil className="w-4 h-4" />
<span className="hidden sm:inline">{"수정"}</span>
</>
)}
</Button>
{isEditing && (
<Button
type="button"
className="gap-2 border border-transparent bg-black-400 text-white w-25 shadow-sm hover:bg-black-200 hover:text-white"
disabled={writeMutation.isPending}
onClick={handleCancelEdit}
>
<X className="w-4 h-4" />
<span className="hidden sm:inline">{"취소"}</span>
</Button>
)}
</div>
)}
<DataTable
columns={commentTableColumns}
rows={commentRows}
tableClassName="kfpa-table"
subheadRowClassName="bg-red-50"
wrapperClassName="w-full"
/>
</div>
</div>
);
};
export default SafetyInspectionDivDetail;

View File

@@ -1,262 +0,0 @@
"use client";
import { type ReactNode, useMemo } from "react";
import type { ChartData } from "@/components/chart/types";
import TopChartTable from "@/components/combo/TopChartTable";
import type { TopChartTableRow } from "@/components/combo/types";
import { formatKoreanBaseDate } from "@/lib/utils";
import { useCsiDataQuery } from "@/query/statistics";
import type { CsiData, CsiDataMap } from "@/types/kfpa";
import VerticalBar from "@/components/chart/VerticalBar";
import {SignStyle} from "@/components/table/types";
import {GAP_WORDING} from "@/const/kfpa.const";
export const signStyleGapRow: SignStyle<TopChartTableRow> = {
rowSelector: (row) => row.label === GAP_WORDING,
display: "arrow",
arrowWithNumber: true,
paint: "text",
};
const DIV_COLUMNS = [
{ key: "-1", label: "전체" },
{ key: "1", label: "서울" },
{ key: "2", label: "경기" },
{ key: "3", label: "부산" },
{ key: "4", label: "대구" },
{ key: "5", label: "대전" },
{ key: "6", label: "광주" },
] as const;
const METRICS: Array<{
key: keyof Omit<CsiData, "wave">;
label: ReactNode;
group?: "direct" | "indirect";
}> = [
{ key: "csi", label: "고객만족지수(CSI)" },
{
key: "safeHelp",
label: (
<>
① 현장 안전점검이
<br />
도움되는 정도
</>
),
group: "direct",
},
{
key: "recHelp",
label: (
<>
② 위험 개선 권고사항이
<br />
도움되는 정도
</>
),
group: "direct",
},
{ key: "staffProf", label: "③ 점검직원 전문성", group: "indirect" },
{ key: "staffAtt", label: "④ 점검직원 태도", group: "indirect" },
];
const getWaveLabel = (wave: number) => {
const text = String(wave);
return `${wave >= 100 ? text.slice(-2) : text}년`;
};
const getDataByWave = (dataMap: CsiDataMap | undefined, divKey: string, wave: number) =>
dataMap?.[divKey]?.find((item) => item.wave === wave);
const getMetricValue = (
dataMap: CsiDataMap | undefined,
divKey: string,
wave: number,
metricKey: keyof Omit<CsiData, "wave">
) => getDataByWave(dataMap, divKey, wave)?.[metricKey] ?? null;
const getGapValue = (
dataMap: CsiDataMap | undefined,
divKey: string,
previousWave: number,
currentWave: number,
metricKey: keyof Omit<CsiData, "wave">
) => {
const previousValue = getMetricValue(dataMap, divKey, previousWave, metricKey);
const currentValue = getMetricValue(dataMap, divKey, currentWave, metricKey);
if (previousValue == null || currentValue == null) return null;
return currentValue - previousValue;
};
const getPreAppendCells = (
metric: (typeof METRICS)[number],
metricIndex: number,
waveIndex: number,
rowCountPerMetric: number
): TopChartTableRow["preAppendCells"] => {
if (waveIndex !== 0) return undefined;
if (metric.key === "csi") {
return [
{
content: "고객만족지수(CSI)",
colSpan: 2,
rowSpan: rowCountPerMetric,
width: 240,
className: "bg-red-100 text-center align-middle font-bold content-text-base",
},
];
}
const cells: TopChartTableRow["preAppendCells"] = [];
if (metric.group === "direct" && metricIndex === 1) {
cells.push({
content: "직접 요소",
rowSpan: rowCountPerMetric * 2,
width: 60,
className: "bg-red-50 text-center align-middle font-bold content-text-base",
});
}
if (metric.group === "indirect" && metricIndex === 3) {
cells.push({
content: "간접 요소",
rowSpan: rowCountPerMetric * 2,
width: 60,
className: "bg-green-200 text-center align-middle font-bold content-text-base",
});
}
cells.push({
content: metric.label,
rowSpan: rowCountPerMetric,
width: 170,
className:
metric.group === "indirect"
? "bg-green-200 text-left align-middle font-bold content-text-base"
: "bg-red-50 text-left align-middle font-bold content-text-base",
});
return cells;
};
const SafetyInspectionTotal = () => {
const { data, isLoading, isError } = useCsiDataQuery();
const baseDateLabel = useMemo(() => formatKoreanBaseDate(), []);
const { categories, rows, verticalChartData } = useMemo(() => {
const waves = Array.from(
new Set(
Object.values(data ?? {})
.flat()
.map((item) => item.wave)
.filter((wave) => Number.isFinite(wave))
)
).sort((a, b) => a - b);
const latestWave = waves[waves.length - 1];
const selectedWaves = latestWave == null ? [] : [latestWave - 1, latestWave];
const categories = DIV_COLUMNS.map((div) => div.label);
const rows: TopChartTableRow[] =
selectedWaves.length === 0
? []
: METRICS.flatMap((metric, metricIndex) =>
[
{
label: GAP_WORDING,
values: DIV_COLUMNS.map((div) =>
getGapValue(data, div.key, selectedWaves[0], selectedWaves[1], metric.key)
),
},
...selectedWaves.map((wave) => ({
label: getWaveLabel(wave),
values: DIV_COLUMNS.map((div) => getMetricValue(data, div.key, wave, metric.key)),
})),
].map((row, rowIndex) => ({
...row,
preAppendCells: getPreAppendCells(metric, metricIndex, rowIndex, selectedWaves.length + 1),
labelClassName:
metric.key === "csi"
? "bg-red-100 text-center font-bold"
: metric.group === "indirect"
? "bg-green-200 text-center font-bold"
: metric.group === "direct"
? "bg-red-50 text-center font-bold"
: "text-center font-bold",
labelWidth: 90,
}))
);
const verticalChartData: ChartData = {
categories,
series: selectedWaves.map((wave) => ({
name: getWaveLabel(wave),
data: DIV_COLUMNS.map((div) => getDataByWave(data, div.key, wave)?.csi ?? null),
})),
};
return {
categories,
rows,
verticalChartData,
};
}, [data]);
if (isLoading) {
return <div className="content-text-sm text-muted-foreground">데이터를 불러오는 중입니다.</div>;
}
if (isError) {
return <div className="content-text-sm text-destructive">고객만족도 데이터를 불러오지 못했습니다.</div>;
}
if (rows.length === 0) {
return <div className="content-text-sm text-muted-foreground">표시할 고객만족도 데이터가 없습니다.</div>;
}
return (
<div className="w-full">
<TopChartTable
title="안전점검 특관관계자 만족도조사"
categories={categories}
rows={rows}
subLabelHeader={baseDateLabel}
minWidth={1120}
chartHeight={260}
chart={
<VerticalBar
data={verticalChartData}
height="100%"
paletteVarNames={["--chart-5", "--chart-7"]}
valueFormatter={(value) => value.toFixed(2)}
barMaxWidth={30}
showFocusLabel="all"
labelOptions={{ position: "top", distance: 4 }}
grid={{ left: 0, right: 0, top: 40, bottom: 5 }}
xAxis={{
type: "category",
data: categories,
axisLabel: { show: false },
axisTick: { show: false },
axisLine: { show: false },
}}
yAxis={{
type: "value",
min: 0,
max: 5,
axisLabel: { show: false },
axisTick: { show: false },
axisLine: { show: false },
splitLine: { show: false },
}}
/>
}
/>
</div>
);
};
export default SafetyInspectionTotal;

View File

@@ -1,9 +1,21 @@
'use client'
"use client";
const BridgePage = () => {
return (
<div>test</div>
)
}
import { useLayoutFilter } from "@/components/layout/LayoutCategoryContext";
import CustomerSatisfactionTotal from "@/components/kfpa/CustomerSatisfactionTotal";
import CustomerSatisfactionDetail from "@/components/kfpa/CustomerSatisfactionDetail";
import { COMMENT_TABLE_TITLE } from "@/config/kfpa.config";
export default BridgePage;
const UcisPage = () => {
const { selectedDiv } = useLayoutFilter();
return selectedDiv === "-1"
? <CustomerSatisfactionTotal />
: <CustomerSatisfactionDetail
selectedDiv={selectedDiv}
viewSubTitle={false}
sectionTitleSuffix={COMMENT_TABLE_TITLE}
widthClassName="w-[1200px]"
/>;
};
export default UcisPage;

21
src/app/403/page.tsx Normal file
View File

@@ -0,0 +1,21 @@
import type { Metadata } from "next";
export const metadata: Metadata = {
title: "403 Forbidden",
};
const ForbiddenPage = () => {
return (
<main className="flex min-h-dvh items-center justify-center bg-background px-6">
<section className="w-full max-w-md border border-border bg-card p-8 text-center shadow-sm">
<p className="text-sm font-semibold text-primary">403</p>
<h1 className="mt-3 text-2xl font-bold text-foreground">외부에서 접속할 수 없습니다.</h1>
<p className="mt-4 text-sm leading-6 text-muted-foreground">
해당 사이트는 외부의 접근을 허용하지 않습니다.
</p>
</section>
</main>
);
};
export default ForbiddenPage;

View File

@@ -1,7 +1,7 @@
import {NextRequest, NextResponse} from "next/server";
import {RouteContext} from "@/types/common";
import {createBackApi} from "@/lib/server-api";
import {CsiDataMap, DivDetailDataMap} from "@/types/kfpa";
import {CsiDataMap, CsiSummaryMap, DivDetailDataMap} from "@/types/kfpa";
import {errorToResponse} from "@/lib/http-util";
export const GET = async (
@@ -12,13 +12,20 @@ export const GET = async (
const {slug = []} = await context.params;
const [action] = slug;
const backApi = await createBackApi();
const pkey = req.nextUrl.searchParams.get("pkey") ?? undefined;
const dt = req.nextUrl.searchParams.get("dt") ?? undefined;
const query = { pkey, dt };
if(action === "csi") {
const result = await backApi.get<CsiDataMap>("/statistics/csi");
if(action === "csi-summary"){
const result = await backApi.get<CsiSummaryMap>("/statistics/csi-summary", { query });
return NextResponse.json(result, { status: 200 });
}
else if(action === "csi") {
const result = await backApi.get<CsiDataMap>("/statistics/csi", { query });
return NextResponse.json(result, { status: 200 });
}
else if(action === "div-detail" && slug.length === 2) {
const result = await backApi.get<DivDetailDataMap>(`/statistics/div-detail/${slug[1]}`);
const result = await backApi.get<DivDetailDataMap>(`/statistics/div-detail/${slug[1]}`, { query });
return NextResponse.json(result, { status: 200 });
}

View File

@@ -90,15 +90,22 @@
--kfpa-black-400: #555152;
--kfpa-black-300: #7b7879;
--kfpa-black-200: #a7a4a5;
--kfpa-black-150: #a6a6a6;
--kfpa-black-100: #d4d2d3;
--kfpa-gray-600: #d1d2d2;
--kfpa-gray-500: #dcdddd;
--kfpa-gray-400: #e5e6e6;
--kfpa-gray-400: #e7e6e6;
--kfpa-gray-300: #eceeee;
--kfpa-gray-200: #f3f4f4;
--kfpa-gray-100: #fafafa;
--kfpa-summary: #9dc3e6;
--kfpa-default: #deebf7;
--kfpa-csi: #ffc000;
--kfpa-direct: #fff2cc;
--kfpa-indirect: #e2f0d9;
--kfpa-green-600: #00803e;
--kfpa-green-500: #159151;
--kfpa-green-400: #34a369;
@@ -115,6 +122,8 @@
--kfpa-red-100: #f2a8b5;
--kfpa-red-50: #fae6ea;
--kfpa-null: #9a9a9a;
/* =============================
Surface
============================= */
@@ -349,6 +358,9 @@
.border-border { border-color: var(--border); }
.text-zero { color: var(--kfpa-black-150) !important; }
.text-null { color: var(--kfpa-null) !important; }
/* KFPA neutral scale */
.bg-black-600 { background-color: var(--kfpa-black-600) !important; }
.bg-black-500 { background-color: var(--kfpa-black-500) !important; }
@@ -396,6 +408,13 @@
.bg-green-100 { background-color: var(--kfpa-green-100) !important; }
.bg-green-50 { background-color: var(--kfpa-green-50) !important; }
.bg-summary { background-color: var(--kfpa-summary) !important; }
.bg-default { background-color: var(--kfpa-default) !important; }
.bg-csi { background-color: var(--kfpa-csi) !important; }
.bg-direct { background-color: var(--kfpa-direct) !important; }
.bg-indirect { background-color: var(--kfpa-indirect) !important; }
.bg-null { background-color: var(--kfpa-null) !important; }
/* =============================
Content Text Size Utilities
============================= */
@@ -444,8 +463,8 @@
.text-header-color { color: var(--kfpa-black-600); }
.text-header-primary {
color: var(--kfpa-black-600);
font-weight: 600;
color: var(--kfpa-red-600);
font-weight: 800;
position: relative;
padding-bottom: 4px;
}
@@ -469,6 +488,7 @@
.text-header-secondary-hover:hover {
color: var(--kfpa-black-600) !important;
font-weight: 800;
}
.bg-kfpa-main-body {
@@ -494,7 +514,7 @@
border-collapse: collapse;
table-layout: fixed;
border: 0px !important;
border-bottom: 3px solid var(--kfpa-gray-200) !important;
border-bottom: 1px solid var(--kfpa-black-600) !important;
background-color: #fff;
}
@@ -505,9 +525,9 @@
.kfpa-table th,
.kfpa-table td {
border: 1px solid var(--kfpa-gray-200) !important;
border: 1px solid var(--kfpa-black-600) !important;
background-color: inherit;
padding: 10px 12px;
padding: 6px 12px;
font-size: 13px;
line-height: 1.15;
text-align: center;
@@ -515,16 +535,54 @@
word-break: auto-phrase;
}
.kfpa-table tbody th,
.kfpa-table tbody td {
padding: 6px 12px;
}
.kfpa-table thead tr.kfpa-table__chart-row > th,
.kfpa-table thead tr.kfpa-table__chart-row > td {
border: 0 !important;
}
.kfpa-table thead tr.kfpa-table__after-chart-row > th,
.kfpa-table thead tr.kfpa-table__after-chart-row > td {
border-top: 1px solid var(--kfpa-black-600) !important;
}
.kfpa-table thead tr.kfpa-table__after-chart-row > th.kfpa-table-border-none,
.kfpa-table thead tr.kfpa-table__after-chart-row > td.kfpa-table-border-none {
border: 0 !important;
}
.kfpa-table thead th.kfpa-table-border-none,
.kfpa-table thead td.kfpa-table-border-none {
border: 0 !important;
background: transparent !important;
}
.kfpa-table thead th.kfpa-table-blank-head,
.kfpa-table thead td.kfpa-table-blank-head {
background: var(--background) !important;
border-top: 1px solid var(--background) !important;
border-left: 1px solid var(--background) !important;
}
.kfpa-table tbody th.kfpa-table-border-none,
.kfpa-table tbody td.kfpa-table-border-none {
border: 0 !important;
}
.kfpa-table thead tr.kfpa-table__group th,
.kfpa-table thead tr.lg-table__group th {
.kfpa-table thead tr.kfpa-table__group th {
background-color: var(--kfpa-gray-400);
color: var(--kfpa-black-600);
font-weight: 700;
}
.kfpa-table thead tr.kfpa-table__subhead th,
.kfpa-table thead tr.lg-table__subhead th {
background-color: var(--kfpa-gray-600);
.kfpa-table thead tr.kfpa-table__subhead th {
background-color: var(--kfpa-default);
color: var(--kfpa-black-600);
font-weight: 700;
}
@@ -538,22 +596,54 @@
word-break: auto-phrase;
}
.kfpa-table .kfpa-table__sep-l {
border-left: 3px solid var(--kfpa-gray-200) !important;
.kfpa-table tbody td.kfpa-table__section-row {
padding: 7px 12px;
color: var(--kfpa-black-600);
}
.kfpa-table .kfpa-table__sep-r {
border-right: 3px solid var(--kfpa-gray-200) !important;
.kfpa-detail-table {
--kfpa-detail-table-head-height: 56px;
--kfpa-detail-table-row-height: 56px;
--kfpa-detail-comment-table-row-height: 112px;
}
.kfpa-detail-rank-table {
min-width: 285px !important;
}
.kfpa-detail-table thead tr,
.kfpa-detail-table thead th {
height: var(--kfpa-detail-table-head-height);
}
.kfpa-detail-table tbody th,
.kfpa-detail-table tbody td {
vertical-align: middle;
height: var(--kfpa-detail-table-row-height);
}
.kfpa-detail-comment-table tbody td {
min-height: var(--kfpa-detail-comment-table-row-height);
vertical-align: top;
}
.kfpa-detail-comment-table tbody td.kfpa-detail-importance-cell {
vertical-align: middle !important;
}
.kfpa-detail-importance-content {
display: flex;
min-height: 96px;
align-items: center;
justify-content: center;
}
.kfpa-num-pos {
color: var(--destructive);
font-weight: 700;
}
.kfpa-num-neg {
color: #1d4ed8;
font-weight: 700;
}
.kfpa-tab-content {
@@ -602,4 +692,3 @@
border-color: var(--kfpa-gray-600) !important;
}
}

View File

@@ -15,8 +15,8 @@ const geistMono = Geist_Mono({
});
export const metadata: Metadata = {
title: "화재보험협회 대시보드",
description: "화재보험협회 CX 대시보드",
title: "고객 관점 성과관리 대시보드",
description: "고객 관점 성과관리 대시보드",
};
export default function RootLayout({

View File

@@ -30,13 +30,57 @@ type Props = {
yAxis?: EChartsOption["yAxis"];
barMaxWidth?: number;
showFocusLabel?:ShowLabel;
onEvents?: Record<string, (params: unknown) => void>;
labelOptions?: {
position?: "top" | "insideTop" | "right" | "insideRight";
color?: string;
distance?: number;
minPositionValue?: number;
};
};
type ChartCallbackParam = {
data?: unknown;
value?: unknown;
axisValueLabel?: string;
name?: string;
marker?: string;
seriesName?: string;
};
const isRecord = (value: unknown): value is Record<string, unknown> =>
typeof value === "object" && value !== null && !Array.isArray(value);
const toChartCallbackParam = (value: unknown): ChartCallbackParam =>
isRecord(value) ? value : {};
const getActualValue = (param: unknown) => {
const data = toChartCallbackParam(param).data;
if (isRecord(data) && "actualValue" in data) {
return data.actualValue;
}
return toChartCallbackParam(param).value;
};
const createLabelPositionTooltip = (fmt: ValueFormatter): EChartsOption["tooltip"] => ({
trigger: "axis",
axisPointer: { type: "shadow" },
formatter: (params: unknown) => {
const items = (Array.isArray(params) ? params : [params]).map(toChartCallbackParam);
const title = items[0]?.axisValueLabel ?? items[0]?.name ?? "";
const lines = items.map((item) => {
const value = getActualValue(item);
const text = typeof value === "number" ? fmt(value) : value == null ? "-" : String(value);
return `${item.marker ?? ""}${item.seriesName} ${text}`;
});
return [title, ...lines].join("<br/>");
},
});
const VerticalBar = ({
data,
height,
@@ -50,27 +94,38 @@ const VerticalBar = ({
yAxis,
barMaxWidth,
showFocusLabel = "all",
onEvents,
labelOptions,
}: Props) => {
const palette = useMemo(() => buildLgPalette(paletteVarNames), [paletteVarNames]);
const option: EChartsOption = useMemo(() => {
const fmt = valueFormatter ?? ((v: number) => String(v));
const minPositionValue = labelOptions?.minPositionValue;
return {
color: palette,
tooltip: tooltip ?? createDefaultTooltip(fmt),
tooltip: tooltip ?? (typeof minPositionValue === "number" ? createLabelPositionTooltip(fmt) : createDefaultTooltip(fmt)),
legend: legend ?? createDefaultLegend(),
grid: grid ?? createDefaultGrid(),
xAxis: xAxis ?? createCategoryAxis(data.categories, false, { axisTick: { alignWithLabel: true } }),
yAxis: yAxis ?? createValueAxis(),
series: data.series.map((s, index) => {
const showLabel = getIsShowLabel(showFocusLabel, index, data.series.length);
const seriesData = s.data.map((value) =>
typeof minPositionValue === "number" &&
typeof value === "number" &&
Number.isFinite(value) &&
value > 0.00 &&
value < minPositionValue
? { value: minPositionValue, actualValue: value }
: value
);
return {
name: s.name,
type: "bar",
data: s.data,
data: seriesData,
emphasis: { disabled: true },
barMaxWidth: barMaxWidth ?? BAR_WIDTHS.DEFAULT,
label: showLabel
@@ -79,7 +134,10 @@ const VerticalBar = ({
position: labelOptions?.position ?? "right",
color: labelOptions?.color,
distance: labelOptions?.distance,
formatter: (p: any) => (typeof p?.value === "number" ? fmt(p.value) : (p?.value ?? "")) as any,
formatter: (p: unknown) => {
const value = getActualValue(p);
return typeof value === "number" ? fmt(value) : value == null ? "" : String(value);
},
}
: undefined,
}
@@ -87,7 +145,7 @@ const VerticalBar = ({
};
}, [data, palette, valueFormatter, tooltip, legend, grid, xAxis, yAxis, barMaxWidth, showFocusLabel, labelOptions]);
return <BaseEChart option={option} height={height} className={className} />;
return <BaseEChart option={option} height={height} className={className} onEvents={onEvents} />;
}
export default VerticalBar;

View File

@@ -1,22 +1,30 @@
"use client";
import React, { useMemo } from "react";
import { cn, parseNumber } from "@/lib/utils";
import React, {useMemo} from "react";
import {cn, parseNumber} from "@/lib/utils";
import BaseTableHeader from "../table/core/BaseTableHeader";
import {
formatSignedValue, getSignTextClass,
resolveSignStyle,
toCssSize,
toRoundedNumber
} from "../table/core/table-core.helpers";
import {TopChartTablePreAppendCell, TopChartTablePreAppendCellConfig, TopChartTableRow} from "./types";
import {
TopChartTablePreAppendCell,
TopChartTablePreAppendCellConfig,
TopChartTableRow,
TopChartTableSectionRow
} from "./types";
import {ChartData} from "../chart/types";
import {CHART_HEIGHTS, TABLE_DIMENSIONS} from "../chart/chart.config";
import {SignStyle} from "@/components/table/types";
import type {DataColumn, SignStyle} from "@/components/table/types";
import {KFPA_DECIMAL_POINT} from "@/config/kfpa.config";
export type TopChartTableProps = {
title?: string;
categories: string[];
columns: DataColumn<Record<string, unknown>>[];
rows: TopChartTableRow[];
sectionRows?: TopChartTableSectionRow[];
chart?:
| React.ReactNode
| ((ctx: {
@@ -25,16 +33,16 @@ export type TopChartTableProps = {
chartHeight?: number | string;
minWidthPx?: number;
minWidth?: number;
maxWidth?: number;
subLabelHeader?: string;
rowHeaderWidth?: number | string;
categoryColumnWidth?: number | string;
categoryColumnWidths?: Array<number | string | undefined>;
tableClassName?: string;
wrapperClassName?: string;
signStyle?: SignStyle<TopChartTableRow>;
};
const toCssSize = (value?: number | string) =>
typeof value === "number" ? `${value}px` : value;
const isPreAppendCellConfig = (
cell: TopChartTablePreAppendCell
): cell is TopChartTablePreAppendCellConfig =>
@@ -54,7 +62,7 @@ const renderPreAppendCell = (cell: TopChartTablePreAppendCell, index: number) =>
className={cell.className}
colSpan={cell.colSpan}
rowSpan={cell.rowSpan}
style={{ width: toCssSize(cell.width), minWidth: toCssSize(cell.width) }}
style={{width: toCssSize(cell.width), minWidth: toCssSize(cell.width)}}
>
{cell.content}
</td>
@@ -85,25 +93,36 @@ const getLeadingColumnWidths = (rows: TopChartTableRow[], preAppendColumnCount:
const getLabelColumnWidth = (rows: TopChartTableRow[]) =>
rows.map((row) => toCssSize(row.labelWidth)).find(Boolean);
const getColumnKey = (column: DataColumn<Record<string, unknown>>) =>
String(column.id ?? ("key" in column ? column.key : column.header));
const getColumnLabel = (column: DataColumn<Record<string, unknown>>) =>
typeof column.header === "string" ? column.header : getColumnKey(column);
export default function TopChartTable({
title,
rows,
categories,
sectionRows = [],
columns,
chart,
chartHeight = CHART_HEIGHTS.DEFAULT,
minWidthPx = TABLE_DIMENSIONS.MIN_WIDTH.STANDARD,
minWidth,
maxWidth,
subLabelHeader = "",
rowHeaderWidth,
categoryColumnWidth,
categoryColumnWidths,
tableClassName,
wrapperClassName,
signStyle,
}: Readonly<TopChartTableProps>) {
}: Readonly<TopChartTableProps>) {
const resolvedSignStyle = resolveSignStyle(signStyle, {
positiveTextClassName: "kfpa-num-pos",
negativeTextClassName: "kfpa-num-neg",
zeroTextClassName: "",
zeroTextClassName: "text-zero",
arrowWithNumber: true,
valueFormatter: (value) => value.toFixed(KFPA_DECIMAL_POINT),
});
const maxPreAppendCellCount = useMemo(
@@ -115,83 +134,113 @@ export default function TopChartTable({
() => [...getLeadingColumnWidths(rows, maxPreAppendCellCount), getLabelColumnWidth(rows)],
[maxPreAppendCellCount, rows]
);
const columnLabels = useMemo(() => columns.map(getColumnLabel), [columns]);
const chartData: ChartData = useMemo(
() => ({
categories,
categories: columnLabels,
series: rows.map((row) => ({
name: row.label,
data: row.values.map((value) => parseNumber(value) ?? null),
})),
}),
[categories, rows]
[columnLabels, rows]
);
const chartNode = useMemo(() => {
if (!chart) {
return null;
}
return typeof chart === "function" ? chart({ chartData }) : chart;
return typeof chart === "function" ? chart({chartData}) : chart;
}, [chart, chartData]);
const rowHeaderStyle = useMemo(() => {
const width = toCssSize(rowHeaderWidth);
return width ? { width, minWidth: width } : undefined;
return width ? {width, minWidth: width} : undefined;
}, [rowHeaderWidth]);
const hasCategoryHeaderRow = useMemo(
() => subLabelHeader.trim().length > 0 || columns.some((column) => getColumnLabel(column).trim().length > 0),
[columns, subLabelHeader]
);
return (
<div className={cn("w-full", wrapperClassName)}>
<BaseTableHeader title={title} />
<BaseTableHeader title={title}/>
<div className="overflow-x-auto">
<table className={cn("lg-table kfpa-table", tableClassName)} style={{ minWidth: `${minWidth ?? minWidthPx}px` }}>
<table className={cn("kfpa-table kfpa-table", tableClassName)} style={{
minWidth: `${minWidth ?? minWidthPx}px`,
maxWidth: maxWidth ? `${maxWidth}px` : undefined
}}>
<colgroup>
{leadingColumnWidths.map((width, index) => (
<col key={`leading-col-${index}`} style={width ? { width, minWidth: width } : undefined} />
))}
{categories.map((category) => (
<col key={`category-col-${category}`} />
<col key={`leading-col-${index}`}
style={width ? {width, minWidth: width} : undefined}/>
))}
{columns.map((column, index) => {
const width = toCssSize(categoryColumnWidths?.[index] ?? column.width ?? categoryColumnWidth);
return (
<col
key={`category-col-${getColumnKey(column)}`}
style={width ? {width, minWidth: width} : undefined}
/>
);
})}
</colgroup>
<thead>
<tr>
<tr className="kfpa-table__chart-row border-none">
<th
colSpan={leadingColumnCount}
className={rowHeaderWidth ? undefined : "w-44"}
style={{ whiteSpace: "nowrap", ...rowHeaderStyle }}
className={cn(rowHeaderWidth ? undefined : "w-44", "border-none")}
style={{whiteSpace: "nowrap", ...rowHeaderStyle}}
/>
<td colSpan={categories.length} style={{ padding: 0, height: chartNode ? chartHeight : 0 }}>
{chartNode ? <div style={{ width: "100%", height: "100%" }}>{chartNode}</div> : null}
<td colSpan={columns.length}
style={{padding: 0, height: chartNode ? chartHeight : 0}}>
{chartNode ? <div style={{width: "100%", height: "100%"}}>{chartNode}</div> : null}
</td>
</tr>
<tr className="lg-table__subhead kfpa-table__subhead">
{hasCategoryHeaderRow && (
<tr className="kfpa-table__subhead kfpa-table__subhead kfpa-table__after-chart-row">
<th
colSpan={leadingColumnCount}
className="lg-table__sep-r kfpa-table__sep-r content-text-base"
className={"kfpa-table-border-none content-text-base bg-transparent"}
style={rowHeaderStyle}
>
{subLabelHeader}
</th>
{categories.map((category) => (
<th key={category} className="content-text-base">
{category}
{columns.map((column) => {
return (
<th
key={getColumnKey(column)}
className={cn(column.headerClassName, "content-text-base")}
style={{textAlign: column.align}}
>
{column.header}
</th>
))}
)
})}
</tr>
)}
</thead>
<tbody>
{rows.map((row, rowIndex) => {
const signRow = !!signStyle?.rowSelector?.(row, rowIndex);
const preAppendCells = row.preAppendCells ?? [];
const sectionRowsAfterCurrentRow = sectionRows.filter(
(sectionRow) => sectionRow.afterRowIndex === rowIndex
);
return (
<tr key={`${row.label}-${rowIndex}`}>
<React.Fragment key={`${row.label}-${rowIndex}`}>
<tr>
{preAppendCells.map(renderPreAppendCell)}
<th
scope="row"
className={cn(
"lg-table__rowhead kfpa-table__rowhead lg-table__sep-r kfpa-table__sep-r content-text-base",
"kfpa-table__rowhead kfpa-table__sep-r kfpa-table__sep-r content-text-base",
row.labelClassName
)}
style={{
@@ -202,30 +251,55 @@ export default function TopChartTable({
{row.label}
</th>
{categories.map((_, categoryIndex) => {
{columns.map((column, categoryIndex) => {
const rawValue = row.values?.[categoryIndex];
const roundedValue = toRoundedNumber(rawValue, 2);
const decimalPlaces = row.decimalPlaces ?? KFPA_DECIMAL_POINT;
const roundedValue = toRoundedNumber(rawValue, decimalPlaces);
if (roundedValue === null) {
return <td key={categoryIndex}>-</td>;
return <td key={getColumnKey(column)}
className={cn(column.cellClassName, row.cellClassName, column.nullCellClassName)}
style={{textAlign: column.align}}>-</td>;
}
if(!signRow) {
if (!signRow) {
return (
<td key={categoryIndex}>
{roundedValue}
<td key={getColumnKey(column)}
className={cn(column.cellClassName, row.cellClassName)}
style={{textAlign: column.align}}>
{roundedValue.toFixed(decimalPlaces)}
</td>
);
}
return (
<td key={categoryIndex} className={getSignTextClass(roundedValue, resolvedSignStyle)}>
<td
key={getColumnKey(column)}
className={cn(column.cellClassName, row.cellClassName, getSignTextClass(roundedValue, resolvedSignStyle))}
style={{textAlign: column.align}}
>
{formatSignedValue(roundedValue, resolvedSignStyle)}
</td>
);
})}
</tr>
{sectionRowsAfterCurrentRow.map((sectionRow, sectionRowIndex) => (
<tr key={`section-row-${rowIndex}-${sectionRowIndex}`}>
<td
colSpan={leadingColumnCount}
className={cn("kfpa-table__section-row content-text-base", sectionRow.className)}
>
{sectionRow.content}
</td>
<td
colSpan={columns.length}
className={cn("kfpa-table__section-row content-text-base", sectionRow.bodyClassName)}
/>
</tr>
))}
</React.Fragment>
);
})}
</tbody>

View File

@@ -15,7 +15,16 @@ export type TopChartTablePreAppendCell =
export type TopChartTableRow = {
label: string;
labelClassName?: string;
cellClassName?: string;
labelWidth?: number | string;
decimalPlaces?: number;
preAppendCells?: TopChartTablePreAppendCell[];
values: Array<number | string | null | undefined>;
};
export type TopChartTableSectionRow = {
afterRowIndex: number;
content: React.ReactNode;
className?: string;
bodyClassName?: string;
};

View File

@@ -0,0 +1,10 @@
const SectionSubTitle = ({title}:{title:string}) => {
return (
<div className="font-semibold flex items-center gap-2 content-text-lg mb-1">
<span className="w-3 h-3 bg-black-600" />
{title}
</div>
);
}
export default SectionSubTitle;

View File

@@ -1,6 +1,6 @@
const SectionTitle = ({title}:{title:string}) => {
return (
<div className="font-semibold flex items-center gap-2">
<div className="font-semibold flex items-center gap-2 content-text-2xl">
<span className="w-3 h-3 bg-primary" />
{title}
</div>

View File

@@ -0,0 +1,9 @@
const CommentNote = () => {
return (
<p className="mt-3 content-text-base">
▶ : 완료&nbsp;&nbsp;/&nbsp;&nbsp;▷ : 진행 중
</p>
);
};
export default CommentNote;

View File

@@ -0,0 +1,25 @@
const CsiFormulaNote = () => {
return (
<>
<p className="mt-3 content-text-base">
※ 고객만족지수(CSI, Customer Satisfaction Index) = 고객 만족도조사 직접요소 항목 점수 X 가중치 + 고객
만족도조사 간접요소 항목 점수 X 가중치
</p>
<p className="mt-3 content-text-base">
※ 주요 고객 대상 : 안전점검(특수건물 관계자)
&nbsp;/&nbsp;&nbsp;UCIS(사원사 등)
&nbsp;/&nbsp;&nbsp;Bridge 플랫폼(사원사, 일반회원 등)
&nbsp;/&nbsp;&nbsp;방재컨설팅(발주처 관계자 약 20명)
&nbsp;/&nbsp;&nbsp;보험업무(보험 계약 담당자 약 300명)
&nbsp;/&nbsp;&nbsp;화재조사(사원사 손해사정부서 총 11명)
</p>
<p className="mt-3 content-text-base">
※ 응답 데이터 업데이트 주기 : 안전점검(매일 실시간)
&nbsp;/&nbsp;&nbsp;UCIS, Bridge플랫폼, 보험업무, 화재조사(매월 말)
&nbsp;/&nbsp;&nbsp;방재컨설팅(각 용역이 완료되는 하반기에 진행 예정)
</p>
</>
);
};
export default CsiFormulaNote;

View File

@@ -0,0 +1,106 @@
"use client";
import DataTable from "@/components/table/DataTable";
import type { DataColumn } from "@/components/table/types";
import { cn } from "@/lib/utils";
import type { CommentColumn, CommentField, CommentValue, DashboardCommentRowConfig } from "@/types/kfpa";
import CommentNote from "@/components/kfpa/CommentNote";
type CommentTableRow = DashboardCommentRowConfig & Record<string, unknown>;
type CustomerSatisfactionCommentTableProps = {
columns: CommentColumn[];
rows: readonly DashboardCommentRowConfig[];
draft: Record<string, CommentValue>;
isEditing: boolean;
onChange: (columnKey: string, field: CommentField, value: string) => void;
};
const CustomerSatisfactionCommentTable = ({
columns,
rows,
draft,
isEditing,
onChange,
}: CustomerSatisfactionCommentTableProps) => {
const tableRows: CommentTableRow[] = rows.map((row) => ({
...row,
...Object.fromEntries(columns.map((column) => [column.key, draft[column.key]?.[row.field] ?? ""])),
}));
const tableColumns: DataColumn<CommentTableRow>[] = [
{
key: "label",
header: "",
rowHead: true,
width: 115,
align: "center",
headerClassName: "kfpa-table-blank-head",
cellClassName: "text-center font-bold",
},
{
key: "importance",
header: (
<>
중요도
<br />
(난이도)
</>
),
width: 75,
align: "center",
cellClassName: "kfpa-detail-importance-cell font-bold",
render: (row) => (
<div className="kfpa-detail-importance-content">
{row.importance}
</div>
),
},
...columns.map<DataColumn<CommentTableRow>>((column) => ({
key: column.key,
header: column.label,
align: "left",
cellClassName: "align-top",
render: (row) => {
const value = String(draft[column.key]?.[row.field] ?? "");
if (!isEditing) {
return (
<div className={cn(
"min-h-24 whitespace-pre-wrap text-left",
"leading-[1.5] content-text-lg"
)}>
{value || "-"}
</div>
);
}
return (
<textarea
className={cn(
"h-24 w-full resize-y border border-gray-300 bg-background p-2",
"leading-[1.5] content-text-lg outline-none focus:border-primary"
)}
value={value}
onChange={(event) => onChange(column.key, row.field, event.target.value)}
/>
);
},
})),
];
return (
<>
<DataTable
columns={tableColumns}
rows={tableRows}
tableClassName="kfpa-table kfpa-detail-table kfpa-detail-comment-table"
subheadRowClassName="bg-red-50"
wrapperClassName="w-full"
/>
<CommentNote/>
</>
);
};
export default CustomerSatisfactionCommentTable;

View File

@@ -0,0 +1,195 @@
"use client";
import { useEffect, useMemo, useState } from "react";
import { useSearchParams } from "next/navigation";
import { useQueryClient } from "@tanstack/react-query";
import { toast } from "sonner";
import { Button } from "@/components/ui/button";
import { useWriteDivCommentMutation } from "@/query/admin";
import { statisticsQueryKeys } from "@/query/key/keys";
import { useDivDetailDataQuery } from "@/query/statistics";
import type { CommentField, CommentValue } from "@/types/kfpa";
import { Pencil, Save, X } from "lucide-react";
import SectionTitle from "@/components/common/SectionTitle";
import { hasAdminRouteParam } from "@/lib/admin-route";
import { useLayoutFilter } from "@/components/layout/LayoutCategoryContext";
import { useAuth } from "@/hooks/useAuth";
import { cn } from "@/lib/utils";
import {
COMMENT_TABLE_TITLE,
getDashboardCommentRows,
getDashboardRankRows,
getSideMenuLabel,
RANK_TABLE_TITLE,
} from "@/config/kfpa.config";
import CustomerSatisfactionRankTable from "./CustomerSatisfactionRankTable";
import CustomerSatisfactionCommentTable from "./CustomerSatisfactionCommentTable";
import {
createCommentDraft,
createEmptyCommentValue,
getCommentColumns,
getSelectedDetail,
} from "@/lib/kfpa-util";
import SectionSubTitle from "@/components/common/SectionSubTitle";
export type CustomerSatisfactionDetailProps = {
selectedDiv: string;
sectionTitleSuffix?: string;
viewSubTitle?: boolean;
widthClassName?: string;
};
const CustomerSatisfactionDetail = ({
selectedDiv,
sectionTitleSuffix,
viewSubTitle = true,
widthClassName = "w-full",
}: CustomerSatisfactionDetailProps) => {
const searchParams = useSearchParams();
const queryClient = useQueryClient();
const { auth } = useAuth();
const { statisticsParams } = useLayoutFilter();
const categoryKey = statisticsParams.pkey;
const { data, isLoading, isError } = useDivDetailDataQuery(selectedDiv, statisticsParams, selectedDiv !== "-1");
const writeMutation = useWriteDivCommentMutation();
const detail = useMemo(() => getSelectedDetail(data, selectedDiv), [data, selectedDiv]);
const commentColumns = useMemo(() => getCommentColumns(detail?.commentValues), [detail?.commentValues]);
const commentRows = useMemo(() => getDashboardCommentRows(categoryKey), [categoryKey]);
const rankRows = useMemo(() => getDashboardRankRows(categoryKey), [categoryKey]);
const shouldShowRankTable = rankRows.length > 0;
const [isEditing, setIsEditing] = useState(false);
const [draft, setDraft] = useState<Record<string, CommentValue>>(() =>
createCommentDraft(commentColumns, detail?.commentValues)
);
useEffect(() => {
setIsEditing(false);
setDraft(createCommentDraft(commentColumns, detail?.commentValues));
}, [commentColumns, detail?.commentValues, selectedDiv]);
const canEdit = hasAdminRouteParam(searchParams) && !!auth.user;
const tableHeaderClassName = "mb-1 flex min-h-9 items-center gap-3 [&>div]:mb-0";
const updateDraft = (columnKey: string, field: CommentField, value: string) => {
setDraft((prev) => ({
...prev,
[columnKey]: {
...createEmptyCommentValue(),
...(prev[columnKey] ?? {}),
[field]: value,
},
}));
};
const handleSave = () => {
writeMutation.mutate(
{
divId: Number(selectedDiv),
commentValues: draft,
},
{
onSuccess: () => {
setIsEditing(false);
queryClient.invalidateQueries({ queryKey: statisticsQueryKeys.divDetail(selectedDiv, statisticsParams) });
toast.success("저장되었습니다.");
},
onError: () => {
toast.error("저장하지 못했습니다.");
},
}
);
};
const handleEditToggle = () => {
if (!canEdit) return;
if (isEditing) {
handleSave();
return;
}
setIsEditing(true);
};
const handleCancelEdit = () => {
setDraft(createCommentDraft(commentColumns, detail?.commentValues));
setIsEditing(false);
};
if (isLoading) {
return <div className="content-text-sm text-muted-foreground">데이터를 불러오는 중입니다.</div>;
}
if (isError) {
return <div className="content-text-sm text-destructive">상세 데이터를 불러오지 못했습니다.</div>;
}
return (
<div className={widthClassName}>
<SectionTitle title={`${getSideMenuLabel(categoryKey, selectedDiv)} ${sectionTitleSuffix ?? '상세 내역'}`} />
<div className="mt-4 flex w-full items-start gap-16 overflow-x-auto pb-2">
{shouldShowRankTable && (
<div className="shrink-0 w-[285px]">
<div className={tableHeaderClassName}>
{viewSubTitle && <SectionSubTitle title={RANK_TABLE_TITLE} />}
</div>
<CustomerSatisfactionRankTable detail={detail} rankRows={rankRows} />
</div>
)}
<div className={cn("min-w-[760px] flex-1", !shouldShowRankTable && "w-full")}>
<div className={cn(tableHeaderClassName, viewSubTitle ? "justify-between" : "justify-end")}>
{viewSubTitle && <SectionSubTitle title={COMMENT_TABLE_TITLE} />}
{canEdit && (
<div className="flex shrink-0 justify-end gap-2">
<Button
type="button"
className={
isEditing
? "gap-2 border border-transparent bg-red-600 text-white w-25 shadow-sm hover:bg-red-500 hover:text-white"
: "gap-2 border border-transparent bg-green-600 text-white w-25 shadow-sm hover:bg-green-500 hover:text-white"
}
disabled={writeMutation.isPending}
onClick={handleEditToggle}
>
{isEditing ? (
<>
<Save className="w-4 h-4" />
<span className="hidden sm:inline">저장</span>
</>
) : (
<>
<Pencil className="w-4 h-4" />
<span className="hidden sm:inline">수정</span>
</>
)}
</Button>
{isEditing && (
<Button
type="button"
className="gap-2 border border-transparent bg-black-400 text-white w-25 shadow-sm hover:bg-black-200 hover:text-white"
disabled={writeMutation.isPending}
onClick={handleCancelEdit}
>
<X className="w-4 h-4" />
<span className="hidden sm:inline">취소</span>
</Button>
)}
</div>
)}
</div>
<CustomerSatisfactionCommentTable
columns={commentColumns}
rows={commentRows}
draft={draft}
isEditing={isEditing}
onChange={updateDraft}
/>
</div>
</div>
</div>
);
};
export default CustomerSatisfactionDetail;

View File

@@ -0,0 +1,59 @@
"use client";
import { useMemo } from "react";
import DataTable from "@/components/table/DataTable";
import type { DataColumn } from "@/components/table/types";
import { cn } from "@/lib/utils";
import type { DivDetailData, RankRowConfig } from "@/types/kfpa";
type RankRow = {
type: string;
csi: number | null;
rank: string;
headerClassName?: string;
};
type CustomerSatisfactionRankTableProps = {
detail?: DivDetailData;
rankRows: readonly RankRowConfig[];
};
const rankColumns: DataColumn<RankRow>[] = [
{ key: "type", header: "물건 유형", align: "center", width: 80 },
{
key: "csi",
header: "고객만족지수",
align: "center",
decimalPlaces: 2,
width: 100,
},
{ key: "rank", header: "지역본부순위", align: "center", width: 100 },
];
const CustomerSatisfactionRankTable = ({ detail, rankRows }: CustomerSatisfactionRankTableProps) => {
const rows: RankRow[] = useMemo(() => {
const ranks = detail?.csiRanks ?? {};
return rankRows.map(([key, label]) => ({
type: label,
csi: ranks[key]?.csi ?? 0,
rank: `${ranks[key]?.divRank ?? 0}/6`,
headerClassName: cn(key === "-1" ? "bg-csi" : "bg-gray-400", "font-bold"),
}));
}, [detail?.csiRanks, rankRows]);
return (
<DataTable
columns={rankColumns}
rows={rows}
tableClassName="kfpa-table kfpa-detail-table kfpa-detail-rank-table"
wrapperClassName="w-full"
minWidth={285}
getCellClassName={(row, column) =>
column.key === "type" ? row.headerClassName : undefined
}
/>
);
};
export default CustomerSatisfactionRankTable;

View File

@@ -0,0 +1,193 @@
"use client";
import { useMemo } from "react";
import type { ChartData } from "@/components/chart/types";
import TopChartTable from "@/components/combo/TopChartTable";
import type { TopChartTableRow } from "@/components/combo/types";
import VerticalBar from "@/components/chart/VerticalBar";
import type { DataColumn } from "@/components/table/types";
import {
KFPA_DECIMAL_POINT,
KFPA_GAP_SIGN_STYLE,
DASHBOARD_METRIC_GROUP_LABEL_MAP,
DASHBOARD_TOTAL_TITLE_BY_CATEGORY,
DIV_KEYS,
SUMMARY_CATEGORY_KEYS,
getDashboardTotalTableLayout, GAP_WORDING, SUMMARY_AVERAGE_GAP_WORDING, REGION_KEY_MAP,
} from "@/config/kfpa.config";
import { useLayoutFilter } from "@/components/layout/LayoutCategoryContext";
import { useCsiSummaryQuery } from "@/query/statistics";
import {
getAverageGapValue,
getSummaryColumnLabel,
getSummaryCsiValue,
getSummaryDataKey,
getSummaryGapValue,
getSummarySampleCount,
getWaveLabel,
} from "@/lib/kfpa-util";
import CsiFormulaNote from "@/components/kfpa/CsiFormulaNote";
const CustomerSatisfactionSummary = () => {
const { statisticsParams } = useLayoutFilter();
const { data, isLoading, isError } = useCsiSummaryQuery({ dt: statisticsParams.dt });
const tableLayout = getDashboardTotalTableLayout("-1");
const { columns, categories, rows, chartData } = useMemo(() => {
const summaryColumns = [...DIV_KEYS, ...SUMMARY_CATEGORY_KEYS];
const waves = Array.from(
new Set(
Object.values(data ?? {})
.flat()
.map((item) => item.wave)
.filter((wave) => Number.isFinite(wave))
)
).sort((a, b) => a - b);
const latestWave = waves.at(-1);
const selectedWaves = latestWave == null ? [] : [latestWave - 1, latestWave];
const columns: DataColumn<Record<string, unknown>>[] = summaryColumns.map((key) => ({
key,
header: getSummaryColumnLabel(key),
headerClassName: key === "-1" || SUMMARY_CATEGORY_KEYS.includes(key)
? "bg-summary"
: undefined,
align: "center",
}));
columns
.filter((column) => SUMMARY_CATEGORY_KEYS.includes(column.key ?? ""))
.forEach((column) => {
column.nullCellClassName = "bg-null text-null"
})
const categories = summaryColumns.map(getSummaryColumnLabel);
const rows: TopChartTableRow[] =
selectedWaves.length === 0 || latestWave == undefined
? []
: [
{
label: "응답건수",
values: summaryColumns.map((key) => getSummarySampleCount(data, getSummaryDataKey(key), latestWave)),
preAppendCells: [
{
content: "",
width: 140,
className: "kfpa-table-border-none bg-transparent",
},
],
labelClassName: "bg-gray-300 text-center font-bold",
cellClassName: "bg-gray-300",
decimalPlaces: 0,
},
{
label: GAP_WORDING,
values: summaryColumns.map((key) =>
getSummaryGapValue(data, getSummaryDataKey(key), selectedWaves[0], latestWave) ?? 0
),
preAppendCells: [
{
content: DASHBOARD_METRIC_GROUP_LABEL_MAP.csi,
rowSpan: selectedWaves.length + 2,
width: 140,
className: "bg-csi text-center align-middle font-bold content-text-base",
},
],
labelClassName: "bg-csi text-center font-bold",
cellClassName: "h-12",
},
...selectedWaves.map((wave) => ({
label: getWaveLabel(wave),
values: summaryColumns.map((key) => getSummaryCsiValue(data, getSummaryDataKey(key), wave) ?? 0),
labelClassName: "bg-csi text-center font-bold",
cellClassName: "h-12",
})),
{
label: SUMMARY_AVERAGE_GAP_WORDING,
values: summaryColumns.map((key) =>
REGION_KEY_MAP[key]
? getAverageGapValue(data, getSummaryDataKey(DIV_KEYS[0]), getSummaryDataKey(key), latestWave)
: null
),
labelClassName: "bg-csi text-center font-bold",
cellClassName: "h-12",
}
];
const chartData: ChartData = {
categories,
series: selectedWaves.map((wave) => ({
name: getWaveLabel(wave),
data: summaryColumns.map((key) => getSummaryCsiValue(data, getSummaryDataKey(key), wave) ?? 0),
})),
};
return {
columns,
categories,
rows,
chartData,
};
}, [data]);
if (isLoading) {
return <div className="content-text-sm text-muted-foreground">데이터를 불러오는 중입니다.</div>;
}
if (isError) {
return <div className="content-text-sm text-destructive">고객만족도 데이터를 불러오지 못했습니다.</div>;
}
if (rows.length === 0) {
return <div className="content-text-sm text-muted-foreground">표시할 고객만족도 데이터가 없습니다.</div>;
}
return (
<div className="w-full">
<TopChartTable
title={DASHBOARD_TOTAL_TITLE_BY_CATEGORY["-1"] ?? "화재보험협회 주요 고객 만족도"}
columns={columns}
rows={rows}
signStyle={KFPA_GAP_SIGN_STYLE}
minWidth={tableLayout.tableWidth}
maxWidth={tableLayout.tableWidth}
chartHeight={280}
chart={
<VerticalBar
data={chartData}
height="100%"
paletteVarNames={["--chart-5", "--chart-7"]}
valueFormatter={(value) => value.toFixed(KFPA_DECIMAL_POINT)}
barMaxWidth={30}
showFocusLabel="all"
labelOptions={{ position: "top", distance: 4, minPositionValue: 3.99 }}
legend={{top:50}}
grid={{ left: 0, right: 0, top: 120, bottom: 5 }}
xAxis={{
type: "category",
data: categories,
axisLabel: { show: false },
axisTick: { show: false },
axisLine: { show: false },
}}
yAxis={{
type: "value",
min: 3.95,
max: 5,
axisLabel: { show: false },
axisTick: { show: false },
axisLine: { show: false },
splitLine: { show: false },
}}
/>
}
/>
<CsiFormulaNote />
</div>
);
};
export default CustomerSatisfactionSummary;

View File

@@ -0,0 +1,254 @@
"use client";
import { useCallback, useMemo } from "react";
import type { ChartData } from "@/components/chart/types";
import TopChartTable from "@/components/combo/TopChartTable";
import type { TopChartTableRow } from "@/components/combo/types";
import { cn } from "@/lib/utils";
import { useCsiDataQuery } from "@/query/statistics";
import type { DashboardMetricConfig, DashboardMetricGroup } from "@/types/kfpa";
import VerticalBar from "@/components/chart/VerticalBar";
import type { DataColumn } from "@/components/table/types";
import {
KFPA_GAP_SIGN_STYLE,
DASHBOARD_METRIC_GROUP_LABEL_MAP,
DASHBOARD_TOTAL_TITLE_BY_CATEGORY,
REGION_KEY_MAP,
getDashboardMetricConfigs,
getDashboardTotalColumnEntries,
getDashboardTotalTableLayout, GAP_WORDING, AVERAGE_GAP_WORDING, DIV_KEYS,
} from "@/config/kfpa.config";
import type { DashboardTotalTableLayout } from "@/config/kfpa.config";
import { useLayoutFilter } from "@/components/layout/LayoutCategoryContext";
import {
getAverageGapValue,
getCsiDataByWave,
getCsiMetricGapValue,
getCsiMetricValue, getSummaryDataKey,
getWaveLabel,
} from "@/lib/kfpa-util";
const getGroupMetricCount = (metrics: readonly DashboardMetricConfig[], group: DashboardMetricGroup) =>
metrics.filter((metric) => metric.group === group).length;
const isFirstMetricInGroup = (
metrics: readonly DashboardMetricConfig[],
metricIndex: number,
group: DashboardMetricGroup
) => metrics.findIndex((metric) => metric.group === group) === metricIndex;
const getPreAppendCells = (
metrics: readonly DashboardMetricConfig[],
metric: DashboardMetricConfig,
metricIndex: number,
waveIndex: number,
rowCountPerMetric: number,
tableLayout: DashboardTotalTableLayout
): TopChartTableRow["preAppendCells"] => {
if (waveIndex !== 0) return undefined;
if (metric.group === "csi") {
return [
{
content: DASHBOARD_METRIC_GROUP_LABEL_MAP.csi,
colSpan: 2,
rowSpan: rowCountPerMetric,
width: tableLayout.csiLabelWidth,
className: "bg-csi text-center align-middle font-bold content-text-base",
},
];
}
const cells: TopChartTableRow["preAppendCells"] = [];
if (isFirstMetricInGroup(metrics, metricIndex, metric.group)) {
cells.push({
content: DASHBOARD_METRIC_GROUP_LABEL_MAP[metric.group],
rowSpan: rowCountPerMetric * getGroupMetricCount(metrics, metric.group),
width: tableLayout.groupLabelWidth,
className: cn(`bg-${metric.group}`, "text-center align-middle font-bold content-text-base"),
});
}
cells.push({
content: metric.label,
rowSpan: rowCountPerMetric,
width: tableLayout.metricLabelWidth,
className: cn(`bg-${metric.group}`, "whitespace-pre-wrap text-left align-middle font-bold content-text-base"),
});
return cells;
};
const CustomerSatisfactionTotal = () => {
const { selectMenu, statisticsParams } = useLayoutFilter();
const categoryKey = statisticsParams.pkey;
const { data, isLoading, isError } = useCsiDataQuery(statisticsParams);
const metrics = useMemo(() => getDashboardMetricConfigs(categoryKey), [categoryKey]);
const tableLayout = useMemo(() => getDashboardTotalTableLayout(categoryKey), [categoryKey]);
const divisionColumns = useMemo(
() =>
getDashboardTotalColumnEntries(categoryKey).map(([key, label]) => ({
key,
label: key === "-1" ? label : REGION_KEY_MAP[key] ?? label,
})),
[categoryKey]
);
const addAverageGapRow = useMemo(() => categoryKey === "2601009_A", [categoryKey]);
const { categoryColumns, categories, rows, chartData } = useMemo(() => {
const waves = Array.from(
new Set(
Object.values(data ?? {})
.flat()
.map((item) => item.wave)
.filter((wave) => Number.isFinite(wave))
)
).sort((a, b) => a - b);
const latestWave = waves.at(-1);
const selectedWaves = latestWave == null ? [] : [latestWave - 1, latestWave];
const categoryColumns: DataColumn<Record<string, unknown>>[] = divisionColumns.map((div) => ({
key: div.key,
header: div.label,
headerClassName: div.key === "-1" && div.label ? "bg-summary" : undefined,
align: "center",
}));
const categories = divisionColumns.map((div) => div.label);
const rows: TopChartTableRow[] =
selectedWaves.length === 0 || latestWave == undefined
? []
: metrics.flatMap((metric, metricIndex) =>
[
{
label: GAP_WORDING,
values: divisionColumns.map((div) =>
getCsiMetricGapValue(data, div.key, selectedWaves[0], selectedWaves[1], metric.key)
),
},
...selectedWaves.map((wave) => ({
label: getWaveLabel(wave),
values: divisionColumns.map((div) => getCsiMetricValue(data, div.key, wave, metric.key)),
})),
...(addAverageGapRow && metric.group === "csi"
? [{
label: AVERAGE_GAP_WORDING,
values: divisionColumns.map((div) => getAverageGapValue(data, DIV_KEYS[0], div.key, latestWave)),
}]
: []
),
].map((row, rowIndex) => ({
...row,
preAppendCells: getPreAppendCells(
metrics,
metric,
metricIndex,
rowIndex,
selectedWaves.length + (addAverageGapRow && metric.group === "csi"? 2 : 1),
tableLayout
),
labelClassName: cn(`bg-${metric.group}`, "text-center", row.label !== GAP_WORDING && "font-bold"),
labelWidth: tableLayout.waveLabelWidth,
}))
);
const chartData: ChartData = {
categories,
series: selectedWaves.map((wave) => ({
name: getWaveLabel(wave),
data: divisionColumns.map((div) => getCsiDataByWave(data, div.key, wave)?.csi ?? 0),
})),
};
return {
categoryColumns,
categories,
rows,
chartData,
};
}, [data, divisionColumns, metrics, tableLayout]);
const handleChartClick = useCallback(
(params: unknown) => {
if (divisionColumns.length <= 1) return;
const dataIndex = typeof params === "object" && params !== null && "dataIndex" in params
? Number((params as { dataIndex?: unknown }).dataIndex)
: NaN;
const divKey = divisionColumns[dataIndex]?.key;
if (divKey && divKey !== "-1") {
selectMenu(divKey);
}
},
[divisionColumns, selectMenu]
);
if (isLoading) {
return <div className="content-text-sm text-muted-foreground">데이터를 불러오는 중입니다.</div>;
}
if (isError) {
return <div className="content-text-sm text-destructive">고객만족도 데이터를 불러오지 못했습니다.</div>;
}
if (rows.length === 0) {
return <div className="content-text-sm text-muted-foreground">표시할 고객만족도 데이터가 없습니다.</div>;
}
return (
<div className="w-full">
<TopChartTable
title={DASHBOARD_TOTAL_TITLE_BY_CATEGORY[categoryKey ?? ""] ?? "고객 만족도"}
columns={categoryColumns}
rows={rows}
sectionRows={[
{
afterRowIndex: addAverageGapRow? 3 : 2,
content: "고객만족지수 세부 항목",
className: "bg-gray-400 text-center font-bold",
bodyClassName: "bg-gray-400 text-center",
},
]}
signStyle={KFPA_GAP_SIGN_STYLE}
minWidth={divisionColumns.length > 1 ? 1120 : 900}
maxWidth={tableLayout.tableWidth}
chartHeight={200}
chart={
<VerticalBar
data={chartData}
height="100%"
paletteVarNames={["--chart-5", "--chart-7"]}
valueFormatter={(value) => value.toFixed(2)}
barMaxWidth={30}
showFocusLabel="all"
labelOptions={{ position: "top", distance: 4 , minPositionValue: 3.99}}
grid={{ left: 0, right: 0, top: 30, bottom: 5 }}
xAxis={{
type: "category",
data: categories,
axisLabel: { show: false },
axisTick: { show: false },
axisLine: { show: false },
}}
yAxis={{
type: "value",
min: 3.95,
max: 5,
axisLabel: { show: false },
axisTick: { show: false },
axisLine: { show: false },
splitLine: { show: false },
}}
onEvents={{ click: handleChartClick }}
/>
}
/>
</div>
);
};
export default CustomerSatisfactionTotal;

View File

@@ -0,0 +1,24 @@
import Image from "next/image";
const Footer = () => {
return (
<footer className="shrink-0 border-t border-[rgba(35,31,32,0.08)] bg-white px-4 pt-1 pb-2 text-center shadow-[0_-4px_14px_rgba(35,31,32,0.06)] content-text-base">
<p className="flex items-center justify-center gap-2 font-bold">
<span>만족도 조사수행 및 Web 대시보드 제공자 :</span>
<Image
src="/KRi_full_logo.png"
alt="코리아리서치"
width={190}
height={28}
className="h-7 w-auto object-contain"
/>
</p>
<p>
본 조사는 화재보험협회의 의뢰로 실시하는 「2026년 화재보험협회 주요 고객 만족도 조사」이며, 실시간
고객 응답 데이터를 기반으로 고객만족지수(CSI)를 제공합니다.
</p>
</footer>
);
};
export default Footer;

View File

@@ -4,14 +4,16 @@ import Image from "next/image";
import {Button} from "@/components/ui/button";
import {LogIn, LogOut} from "lucide-react";
import {cn} from "@/lib/utils";
import {SITE_TITLE} from "@/config/kfpaConfig";
import {SITE_TITLE} from "@/config/kfpa.config";
import {TopMenuItem} from "@/config/menu.type";
import {usePathname} from "next/navigation";
interface HeaderProps {
topMenus: TopMenuItem[];
userName: string;
isAdmin: boolean;
isAuthenticated: boolean;
baseDateLabel: string;
onNavigate: (path: string) => void;
onLogin: () => void;
onLogout: () => void;
@@ -20,7 +22,9 @@ interface HeaderProps {
const Header = ({
topMenus,
userName,
isAdmin,
isAuthenticated,
baseDateLabel,
onNavigate,
onLogin,
onLogout,
@@ -29,21 +33,52 @@ const Header = ({
return (
<header className="app-header sticky top-0 z-40">
<div className="grid grid-cols-[minmax(0,1fr)_auto_minmax(0,1fr)] items-center gap-4 px-4 h-16">
<div className="flex min-w-0 items-center gap-4">
<div className="flex items-center gap-2 cursor-pointer w-37 h-15 justify-center">
<div className="relative grid h-[4rem] grid-cols-[10rem_minmax(0,1fr)_minmax(12rem,auto)] grid-rows-[2rem_2rem] items-center gap-x-4 px-4">
<div className="row-span-2 flex h-full min-w-0 items-center">
<button
type="button"
className="flex h-full w-37 cursor-pointer items-center justify-center gap-2 bg-transparent p-0"
onClick={() => onNavigate("/")}
>
<Image
src="/head_logo.png"
alt="logo"
width={150}
height={90}
className="object-contain"
onClick={() => onNavigate("/safety-inspection")}
priority
/>
</button>
</div>
<nav className="flex min-w-0 items-center gap-3 ml-5 overflow-hidden">
<div className="pointer-events-none absolute left-1/2 top-0 flex h-10 -translate-x-1/2 items-center justify-center">
<h1 className="font-bold content-text-2xl text-header-color">{SITE_TITLE}</h1>
</div>
<div className="col-start-3 row-start-1 flex min-w-0 items-center justify-end gap-4">
{isAdmin && (
<>
<span className="content-text-base text-header-color hidden max-w-40 truncate sm:inline font-bold">
{userName}
</span>
<Button
className="gap-2 border border-transparent bg-green-600 text-white w-25 shadow-sm hover:bg-green-500 hover:text-white"
onClick={isAuthenticated ? onLogout : onLogin}
>
{isAuthenticated ? (
<>
<LogOut className="w-4 h-4" />
<span className="hidden sm:inline">로그아웃</span>
</>
) : (
<>
<LogIn className="w-4 h-4" />
<span className="hidden sm:inline">로그인</span>
</>
)}
</Button>
</>
)}
</div>
<nav className="col-start-2 row-start-2 flex min-w-0 items-center gap-3 overflow-hidden pb-1.5">
{topMenus.map((topMenu) => {
const active = topMenu.match?.(pathname) ?? pathname === topMenu.path;
return (
@@ -52,7 +87,7 @@ const Header = ({
type="button"
onClick={() => onNavigate(topMenu.path)}
className={cn(
"relative h-8 inline-flex items-center font-bold transition-colors cursor-pointer",
"relative inline-flex h-5 cursor-pointer items-center font-bold transition-colors",
"content-text-lg bg-transparent px-1",
active
? "text-header-primary"
@@ -64,32 +99,8 @@ const Header = ({
);
})}
</nav>
</div>
<div className="flex items-center justify-center">
<h1 className="font-bold content-text-2xl text-header-color">{SITE_TITLE}</h1>
</div>
<div className="flex min-w-0 items-center justify-end gap-4">
{isAuthenticated && (
<span className="content-text-base text-header-color hidden max-w-40 truncate sm:inline font-bold">
{userName}
</span>
)}
<Button
className="gap-2 border border-transparent bg-green-600 text-white w-25 shadow-sm hover:bg-green-500 hover:text-white"
onClick={isAuthenticated ? onLogout : onLogin}
>
{isAuthenticated ? (
<>
<LogOut className="w-4 h-4" />
<span className="hidden sm:inline">{"로그아웃"}</span>
</>
) : (
<>
<LogIn className="w-4 h-4" />
<span className="hidden sm:inline">{"로그인"}</span>
</>
)}
</Button>
<div className="col-start-3 row-start-2 flex min-w-0 items-center justify-end gap-4 content-text-base font-bold text-header-color">
{baseDateLabel}
</div>
</div>
</header>

View File

@@ -2,11 +2,14 @@
import React, { createContext, useCallback, useContext, useMemo, useRef } from "react";
import {DivKey} from "@/types/kfpa";
import type {StatisticsQueryParams} from "@/query/statistics";
type ExcelExporter = (ctx: DivKey) => void | Promise<void>;
type LayoutCategoryContextValue = {
selectedDiv: DivKey;
statisticsParams: StatisticsQueryParams;
selectMenu: (menuId: string) => void;
registerExcelExporter: (exporter: ExcelExporter | null) => void;
requestExcelExport: () => Promise<void>;
};
@@ -15,9 +18,13 @@ const LayoutCategoryContext = createContext<LayoutCategoryContextValue | null>(n
export const LayoutCategoryProvider = ({
selectedDiv,
statisticsParams,
onSelectMenu,
children,
}: {
selectedDiv: DivKey;
statisticsParams: StatisticsQueryParams;
onSelectMenu: (menuId: string) => void;
children: React.ReactNode;
}) => {
const exporterRef = useRef<ExcelExporter | null>(null);
@@ -38,10 +45,12 @@ export const LayoutCategoryProvider = ({
const ctxValue = useMemo<LayoutCategoryContextValue>(
() => ({
selectedDiv,
statisticsParams,
selectMenu: onSelectMenu,
registerExcelExporter,
requestExcelExport,
}),
[selectedDiv, registerExcelExporter, requestExcelExport]
[selectedDiv, statisticsParams, onSelectMenu, registerExcelExporter, requestExcelExport]
);
return <LayoutCategoryContext.Provider value={ctxValue}>{children}</LayoutCategoryContext.Provider>;

View File

@@ -1,17 +1,20 @@
"use client"
import {ReactNode, useEffect, useState} from "react";
import {useRouter} from "next/navigation";
import {ReactNode, useEffect, useMemo, useRef, useState} from "react";
import {usePathname, useRouter, useSearchParams} from "next/navigation";
import {DivKey} from "@/types/kfpa";
import {useAuth} from "@/hooks/useAuth";
import {LayoutCategoryProvider} from "./LayoutCategoryContext";
import Header from "@/components/layout/Header";
import {useMounted} from "@/hooks/useMounted";
import {Sidebar} from "@/components/layout/Sidebar";
import {TOP_MENUS, SIDE_MENUS} from "@/config/menu.data";
import {TOP_MENUS, SIDE_MENUS_BY_TOP_MENU} from "@/config/menu.data";
import {useLogoutMutation} from "@/query/auth";
import {useDialog} from "@/hooks/useDialog";
import LoginDialog from "@/components/dialog/loginDialog";
import { appendAdminRouteParam, hasAdminRouteParam } from "@/lib/admin-route";
import {useLayoutSelectedMenu} from "@/hooks/useLayoutSelectedMenu";
import Footer from "@/components/layout/Footer";
type MainLayoutProps = {
children: ReactNode;
@@ -21,18 +24,65 @@ const getDivKey = () => {
return "-1";
}
const padDatePart = (value: number) => String(value).padStart(2, "0");
const formatStatisticsDt = (date: Date) =>
[
date.getFullYear(),
padDatePart(date.getMonth() + 1),
padDatePart(date.getDate()),
padDatePart(date.getHours()),
padDatePart(date.getMinutes()),
padDatePart(date.getSeconds()),
].join("");
const formatBaseDateLabel = (date: Date) =>
`최종 업데이트 일시 : ${String(date.getFullYear()).slice(-2)}년 ${date.getMonth() + 1}월 ${date.getDate()}일 ${padDatePart(date.getHours())}시 ${padDatePart(date.getMinutes())}분`;
const MainLayout = ({ children }: MainLayoutProps) => {
const { auth, logout } = useAuth();
const { showDialog } = useDialog();
const logoutMutation = useLogoutMutation();
const router = useRouter();
const pathname = usePathname();
const searchParams = useSearchParams();
const isMounted = useMounted();
const { selectedMenusByTopMenu, selectMenu } = useLayoutSelectedMenu();
const previousTopMenuIdRef = useRef<string | null>(null);
const [menuOpen, setMenuOpen] = useState(true);
const [selectedDiv, setSelectedDiv] = useState<DivKey>(getDivKey());
const [dataBaseDate, setDataBaseDate] = useState(() => new Date());
const isRouteAdmin = hasAdminRouteParam(searchParams);
const activeTopMenu = useMemo(
() => TOP_MENUS.find((topMenu) => topMenu.match?.(pathname) ?? pathname === topMenu.path) ?? TOP_MENUS[0],
[pathname]
);
const activeTopMenuId = activeTopMenu?.id ?? "";
const sideMenus = useMemo(
() => SIDE_MENUS_BY_TOP_MENU[activeTopMenuId] ?? [],
[activeTopMenuId]
);
const selectedMenuId = useMemo(() => {
if (!sideMenus.length) return getDivKey();
const storedMenuId = activeTopMenuId ? selectedMenusByTopMenu[activeTopMenuId] : undefined;
if (storedMenuId && sideMenus.some((menu) => menu.id === storedMenuId)) {
return storedMenuId;
}
return sideMenus[0].id;
}, [activeTopMenuId, selectedMenusByTopMenu, sideMenus]);
const statisticsParams = useMemo(
() => ({
pkey: activeTopMenuId,
dt: formatStatisticsDt(dataBaseDate),
}),
[activeTopMenuId, dataBaseDate]
);
const baseDateLabel = useMemo(() => formatBaseDateLabel(dataBaseDate), [dataBaseDate]);
const movePage = (path: string) => {
router.push(path);
router.push(appendAdminRouteParam(path, searchParams));
};
const openLoginDialog = () => {
@@ -43,6 +93,11 @@ const MainLayout = ({ children }: MainLayoutProps) => {
logoutMutation.mutate();
};
const handleSelectMenu = (menuId: string) => {
if (!activeTopMenuId) return;
selectMenu(activeTopMenuId, menuId);
};
useEffect(() => {
const handleAuthExpired = () => {
logout();
@@ -52,31 +107,60 @@ const MainLayout = ({ children }: MainLayoutProps) => {
return () => window.removeEventListener("auth:expired", handleAuthExpired);
}, [logout]);
useEffect(() => {
if (!activeTopMenuId) return;
setDataBaseDate(new Date());
}, [activeTopMenuId, selectedMenuId]);
useEffect(() => {
if (!activeTopMenuId) return;
if (previousTopMenuIdRef.current === null) {
previousTopMenuIdRef.current = activeTopMenuId;
return;
}
if (previousTopMenuIdRef.current === activeTopMenuId) return;
previousTopMenuIdRef.current = activeTopMenuId;
selectMenu(activeTopMenuId, getDivKey());
}, [activeTopMenuId, selectMenu]);
if(!isMounted) return null;
return (
<div className="flex h-dvh flex-col overflow-hidden bg-transparent">
<LayoutCategoryProvider selectedDiv={selectedDiv}>
<LayoutCategoryProvider
selectedDiv={selectedMenuId as DivKey}
statisticsParams={statisticsParams}
onSelectMenu={handleSelectMenu}
>
<Header
topMenus={TOP_MENUS}
userName={auth.user?.userName || ""}
isAuthenticated={auth.user != null}
isAdmin={isRouteAdmin}
isAuthenticated={!!auth.user}
baseDateLabel={baseDateLabel}
onNavigate={movePage}
onLogin={openLoginDialog}
onLogout={handleLogout}
/>
<div className="flex h-[calc(100dvh-4rem)] min-h-0 overflow-hidden">
<div className="flex min-h-0 flex-1 overflow-hidden">
<Sidebar
sideMenus={SIDE_MENUS}
sideMenus={sideMenus}
isOpen={menuOpen}
selectedDiv={selectedDiv}
onChangeDiv={setSelectedDiv}
selectedMenuId={selectedMenuId}
onChangeMenu={handleSelectMenu}
/>
<div className="h-full min-h-0 flex-1 overflow-y-scroll overscroll-contain p-4">
<main className="h-full min-h-0 flex-1">
<div className="flex min-h-0 flex-1 flex-col">
<div className="min-h-0 flex-1 overflow-y-auto overscroll-contain px-4 pt-2 pb-1">
<main className="min-h-full">
{children}
</main>
</div>
<Footer />
</div>
</div>
<LoginDialog />

View File

@@ -2,20 +2,19 @@
import { cn } from "@/lib/utils";
import {SideMenuItem} from "@/config/menu.type";
import {DivKey} from "@/types/kfpa";
interface SidebarProps {
sideMenus: SideMenuItem[];
isOpen: boolean;
selectedDiv: DivKey;
onChangeDiv: (div: DivKey) => void;
selectedMenuId: string;
onChangeMenu: (menuId: string) => void;
}
export const Sidebar = ({
sideMenus,
isOpen,
selectedDiv,
onChangeDiv,
selectedMenuId,
onChangeMenu,
}: SidebarProps) => {
const activeMenuClassName =
"text-foreground bg-muted shadow-[inset_4px_0_0_#ed1c24]";
@@ -35,13 +34,13 @@ export const Sidebar = ({
<div className="py-4 overflow-y-auto h-full">
<nav className="space-y-0.5 pl-2">
{sideMenus.map((item) => {
const active = selectedDiv === item.id;
const active = selectedMenuId === item.id;
return (
<button
key={item.id}
type="button"
onClick={() => onChangeDiv(item.id as DivKey)}
onClick={() => onChangeMenu(item.id)}
aria-current={active ? "true" : undefined}
className={cn(
"w-full flex items-center gap-2.5 px-3 py-2 rounded-md",

View File

@@ -8,11 +8,12 @@ import {
appendCellMarker,
getColumnAlign,
getLeafColumns,
toCssSize,
toRoundedNumber,
toTableCellContent,
} from "./core/table-core.helpers";
import {DataColumn} from "@/components/table/types";
import {isGapRow} from "@/lib/kfpa-utill";
import {isGapRow} from "@/lib/kfpa-util";
export type MergedTableCell<T> = {
key: keyof T;
@@ -29,6 +30,7 @@ export type PreAppendTableCell =
className?: string;
colSpan?: number;
rowSpan?: number;
width?: number | string;
};
type Props<T extends Record<string, unknown>> = {
@@ -66,6 +68,7 @@ const renderPreAppendCell = (cell: PreAppendTableCell, index: number) => {
className={cell.className}
colSpan={cell.colSpan}
rowSpan={cell.rowSpan}
style={cell.width === undefined ? undefined : { width: toCssSize(cell.width), minWidth: toCssSize(cell.width) }}
>
{cell.content}
</td>
@@ -128,15 +131,16 @@ export default function BaseDataTable<T extends Record<string, unknown>>({
const rawValue = row[column.key];
const align = getColumnAlign(column);
const defaultContent = column.render ? column.render(row) : toTableCellContent(rawValue);
const defaultContent = column.render ? column.render(row) : toTableCellContent(rawValue, column.decimalPlaces);
const numericValue = "numeric" in column && column.numeric ? parseNumber(rawValue ?? defaultContent) ?? 0 : 0;
if (column.rowHead) {
const rowHeaderClassName = row.headerClassName ?? "";
return (
<th
key={String(column.key)}
scope="row"
className={cn("lg-table__rowhead", column.cellClassName, dynamicCellClassName, fillGapClass)}
className={cn("kfpa-table__rowhead", column.cellClassName, rowHeaderClassName, dynamicCellClassName, fillGapClass)}
style={{ textAlign: align }}
>
{defaultContent}

View File

@@ -13,6 +13,7 @@ type Props<T extends Record<string, unknown>> = {
subheadRowClassName?: string;
minWidth?: number | string;
fillGapRow?: boolean;
getCellClassName?: (row: T, column: DataColumn<T>, rowIndex: number) => string | undefined;
};
const DataTable = <T extends Record<string, unknown>>({
@@ -25,6 +26,7 @@ const DataTable = <T extends Record<string, unknown>>({
subheadRowClassName,
minWidth,
fillGapRow = false,
getCellClassName,
}: Props<T>) => {
return (
<BaseDataTable
@@ -36,6 +38,7 @@ const DataTable = <T extends Record<string, unknown>>({
subheadRowClassName={subheadRowClassName}
minWidth={minWidth}
fillGapRow={fillGapRow}
getCellClassName={getCellClassName}
/>
);
};

View File

@@ -4,7 +4,7 @@ import type React from "react";
import { cn } from "@/lib/utils";
import BaseTableHeader from "./BaseTableHeader";
import { buildHeaderRows } from "./table-core.helpers";
import { buildHeaderRows, getLeafColumns, toCssSize } from "./table-core.helpers";
import {DataColumn} from "@/components/table/types";
type BaseColumn<T> = DataColumn<T>;
@@ -33,7 +33,24 @@ export default function BaseTableRenderer<T>({
children,
}: Readonly<Props<T>>) {
const headerRows = buildHeaderRows(columns);
const leafColumns = getLeafColumns(columns);
const lastHeaderRowIndex = headerRows.length - 1;
const resolvedColgroup =
colgroup ??
(leafColumns.some((column) => column.width !== undefined) ? (
<colgroup>
{leafColumns.map((column) => {
const width = toCssSize(column.width);
return (
<col
key={String(column.key)}
style={width ? { width, minWidth: width } : undefined}
/>
);
})}
</colgroup>
) : undefined);
return (
<div className={cn("w-full", wrapperClassName)}>
@@ -41,16 +58,16 @@ export default function BaseTableRenderer<T>({
<div className="overflow-x-auto">
<table
className={cn("lg-table", tableClassName)}
className={cn("kfpa-table", tableClassName)}
style={minWidth === undefined ? undefined : { minWidth: typeof minWidth === "number" ? `${minWidth}px` : minWidth }}
>
{colgroup}
{resolvedColgroup}
<thead>
{renderHeaderPrefix}
{headerRows.map((row, rowIndex) => (
<tr
key={`header-row-${rowIndex}`}
className={cn(rowIndex === lastHeaderRowIndex ? "lg-table__subhead" : "lg-table__group", rowIndex === lastHeaderRowIndex ? subheadRowClassName : undefined)}
className={cn(rowIndex === lastHeaderRowIndex ? "kfpa-table__subhead" : "kfpa-table__group", rowIndex === lastHeaderRowIndex ? subheadRowClassName : undefined)}
>
{row.map((cell) => (
<th key={cell.id} colSpan={cell.colSpan} rowSpan={cell.rowSpan} className={cell.className}>

View File

@@ -13,7 +13,7 @@ export type TableColumnLeaf<T> = DataColumnLeaf<T>;
export type GroupHeaderCell = {
id: string;
label: string;
label: React.ReactNode;
colSpan: number;
rowSpan: number;
className?: string;
@@ -38,6 +38,9 @@ export type ResolvedSignStyle = {
const defaultValueFormatter: ValueFormatter = (value) =>
Number.isInteger(value) ? String(roundNumber(value)) : value.toLocaleString();
export const toCssSize = (value?: number | string) =>
typeof value === "number" ? `${value}px` : value;
function isColumnLeaf<T>(column: TableColumnNode<T>): column is TableColumnLeaf<T> {
return !("children" in column) || !column.children?.length;
}
@@ -135,7 +138,12 @@ export function getColumnAlign<T>(column: TableColumnLeaf<T>, fallback: "left" |
return fallback;
}
export function toTableCellContent(raw: unknown): React.ReactNode {
export function toTableCellContent(raw: unknown, decimalPlaces?: number): React.ReactNode {
const formatNumber = (value: number) => {
const rounded = roundNumber(value, decimalPlaces);
return typeof decimalPlaces === "number" ? rounded?.toFixed(decimalPlaces) ?? "" : String(rounded);
};
if (raw == null) {
return "";
}
@@ -147,11 +155,11 @@ export function toTableCellContent(raw: unknown): React.ReactNode {
}
const parsed = Number(trimmed);
return Number.isNaN(parsed) ? raw : roundNumber(parsed);
return Number.isNaN(parsed) ? raw : formatNumber(parsed);
}
if (typeof raw === "number") {
return String(roundNumber(raw));
return formatNumber(raw);
}
return String(raw);
@@ -167,11 +175,11 @@ const defaultSignStyle: ResolvedSignStyle = {
display: "number",
showPlus: true,
arrowWithNumber: false,
zeroText: "-",
zeroText: "0.00",
valueFormatter: defaultValueFormatter,
positiveTextClassName: "text-primary font-semibold",
negativeTextClassName: "text-info font-semibold",
zeroTextClassName: "text-gray-600",
zeroTextClassName: "text-zero",
positiveCellBg: "hsl(var(--primary) / 0.08)",
negativeCellBg: "hsl(var(--info) / 0.08)",
zeroCellBg: "hsl(var(--lg-gray-200) / 0.6)",

View File

@@ -4,11 +4,12 @@ export type TableColumnAlign = "left" | "center" | "right";
type TableColumnShared<T> = {
id?: string;
header: string;
header: string | React.ReactNode;
width?: number | string;
align?: TableColumnAlign;
headerClassName?: string;
cellClassName?: string;
nullCellClassName?: string;
render?: (row: T) => React.ReactNode;
};
@@ -16,6 +17,7 @@ export type DataColumnLeaf<T> = TableColumnShared<T> & {
key: keyof T;
rowHead?: boolean; // 첫 컬럼 등 row header
numeric?: boolean; // 숫자열(정렬 기본값/색상 타겟 기본값에 사용)
decimalPlaces?: number;
children?: undefined;
};
@@ -24,6 +26,7 @@ export type DataColumnGroup<T> = TableColumnShared<T> & {
key?: undefined;
rowHead?: undefined;
numeric?: undefined;
decimalPlaces?: undefined;
};
export type DataColumn<T> = DataColumnLeaf<T> | DataColumnGroup<T>;

309
src/config/kfpa.config.ts Normal file
View File

@@ -0,0 +1,309 @@
import type { TopChartTableRow } from "@/components/combo/types";
import type { SignStyle } from "@/components/table/types";
export const SITE_TITLE = "고객 관점 성과관리 대시보드";
export const RANK_TABLE_TITLE = "물건 유형별 고객만족지수";
export const COMMENT_TABLE_TITLE = "고객 관점 성과 분류";
export const KFPA_DECIMAL_POINT = 2;
export const VIEW_DECIMAL_POINT = 0;
export const GAP_WORDING = "전년 대비";
export const SUMMARY_AVERAGE_GAP_WORDING = "지역본부 평균 대비";
export const AVERAGE_GAP_WORDING = "평균 대비";
export const KFPA_GAP_SIGN_STYLE: SignStyle<TopChartTableRow> = {
rowSelector: (row) =>
[GAP_WORDING, AVERAGE_GAP_WORDING, SUMMARY_AVERAGE_GAP_WORDING].includes(row.label),
display: "arrow",
arrowWithNumber: true,
paint: "text",
};
//조사에 대한 조정은 여기서
export const CATEGORY_KEY_MAP: Record<string, string> = {
"-1": "전체 현황",
"2601009_A": "안전점검",
"2604005_E": "UCIS",
"2604005_D": "Bridge플랫폼",
"2604005_C": "방재컨설팅",
"2604005_A": "보험업무",
"2604005_B": "화재조사",
};
export const CATEGORY_PATH_MAP: Record<string, string> = {
"-1": "",
"2601009_A": "safety-inspection",
"2604005_E": "ucis",
"2604005_D": "bridge-platform",
"2604005_C": "consulting",
"2604005_A": "insurance-operations",
"2604005_B": "fire-investigation",
};
type KeyLabelEntries = readonly (readonly [string, string])[];
const toKeyMap = <T extends KeyLabelEntries>(entries: T) =>
Object.fromEntries(entries) as Record<T[number][0], T[number][1]>;
const toKeys = <T extends KeyLabelEntries>(entries: T) =>
entries.map(([key]) => key) as Array<T[number][0]>;
export const CATEGORY_KEYS = Object.keys(CATEGORY_KEY_MAP);
export const CATEGORIES = Object.values(CATEGORY_KEY_MAP) as Array<string>;
export const SUMMARY_CATEGORY_KEYS = CATEGORY_KEYS.filter(
(key) => key !== "-1" && key !== "2601009_A"
);
//지역에 대한 조정은 여기서
const DIV_KEY_ENTRIES = [
["-1", "전체"],
["1", "서울인천지역본부"],
["3", "경기강원지역본부"],
["2", "부산경남지역본부"],
["5", "대구경북지역본부"],
["6", "대전충청지역본부"],
["4", "광주호남지역본부"],
] as const;
const SIDE_MENU_ENTRIES_BY_CATEGORY = {
"-1": [["-1", CATEGORY_KEY_MAP["-1"]]],
"2601009_A": DIV_KEY_ENTRIES,
"2604005_E": [
["-1", CATEGORY_KEY_MAP["2604005_E"]],
["11", "위험관리지원센터"],
],
"2604005_D": [
["-1", CATEGORY_KEY_MAP["2604005_D"]],
["21", "인슈데이터팀"],
],
"2604005_C": [["-1", CATEGORY_KEY_MAP["2604005_C"]]],
"2604005_A": [["-1", CATEGORY_KEY_MAP["2604005_A"]]],
"2604005_B": [["-1", CATEGORY_KEY_MAP["2604005_B"]]],
} as const satisfies Record<string, KeyLabelEntries>;
export const DIV_KEY_MAP: Record<string, string> = toKeyMap(DIV_KEY_ENTRIES);
export const DIV_KEYS = toKeys(DIV_KEY_ENTRIES);
export const SIDE_MENU_KEY_MAP_BY_CATEGORY = Object.fromEntries(
Object.entries(SIDE_MENU_ENTRIES_BY_CATEGORY).map(([categoryKey, entries]) => [
categoryKey,
toKeyMap(entries),
])
) as Record<string, Record<string, string>>;
export const SIDE_MENU_KEYS_BY_CATEGORY = Object.fromEntries(
Object.entries(SIDE_MENU_ENTRIES_BY_CATEGORY).map(([categoryKey, entries]) => [
categoryKey,
toKeys(entries),
])
) as Record<string, string[]>;
export const DIVS = DIV_KEYS.map((key) => DIV_KEY_MAP[key]);
export const REGION_KEY_MAP: Record<string, string> = {
"1": "서울",
"3": "경기",
"2": "부산",
"5": "대구",
"6": "대전",
"4": "광주",
};
export const DASHBOARD_TOTAL_COLUMN_ENTRIES_BY_CATEGORY: Record<string, KeyLabelEntries> = {
"-1": [["-1", ""]],
"2601009_A": DIV_KEY_ENTRIES,
"2604005_E": [["-1", ""]],
"2604005_D": [["-1", ""]],
"2604005_C": [["-1", ""]],
"2604005_A": [["-1", ""]],
"2604005_B": [["-1", ""]],
};
export const DASHBOARD_TOTAL_TITLE_BY_CATEGORY: Record<string, string> = {
"-1": "화재보험협회 주요 고객 만족도",
"2601009_A": "안전점검 특건관계자 만족도조사",
"2604005_E": "UCIS 고객 만족도",
"2604005_D": "Bridge플랫폼 고객 만족도",
"2604005_C": "방재컨설팅 고객 만족도",
"2604005_A": "보험업무 고객 만족도",
"2604005_B": "화재조사 고객 만족도",
};
export const DASHBOARD_METRIC_GROUP_LABEL_MAP: Record<string, string> = {
csi: "고객만족지수(CSI)",
direct: "직접 요소",
indirect: "간접 요소",
};
export type DashboardTotalTableLayout = {
csiLabelWidth: number | string;
groupLabelWidth: number | string;
metricLabelWidth: number | string;
waveLabelWidth: number | string;
tableWidth: number;
};
export const DEFAULT_DASHBOARD_TOTAL_TABLE_LAYOUT: DashboardTotalTableLayout = {
csiLabelWidth: 240,
groupLabelWidth: 60,
metricLabelWidth: 250,
waveLabelWidth: 90,
tableWidth: 1550,
};
export const DASHBOARD_TOTAL_TABLE_LAYOUT_BY_CATEGORY: Record<string, Partial<DashboardTotalTableLayout>> = {
"-1": {
...DEFAULT_DASHBOARD_TOTAL_TABLE_LAYOUT,
},
"2601009_A": {
...DEFAULT_DASHBOARD_TOTAL_TABLE_LAYOUT,
tableWidth: 1100,
},
"2604005_E": {
...DEFAULT_DASHBOARD_TOTAL_TABLE_LAYOUT,
metricLabelWidth: 350,
tableWidth: 900,
},
"2604005_D": {
...DEFAULT_DASHBOARD_TOTAL_TABLE_LAYOUT,
metricLabelWidth: 310,
tableWidth: 900,
},
"2604005_C": {
...DEFAULT_DASHBOARD_TOTAL_TABLE_LAYOUT,
metricLabelWidth: 290,
tableWidth: 900,
},
"2604005_A": {
...DEFAULT_DASHBOARD_TOTAL_TABLE_LAYOUT,
metricLabelWidth: 330,
tableWidth: 900,
},
"2604005_B": {
...DEFAULT_DASHBOARD_TOTAL_TABLE_LAYOUT,
metricLabelWidth: 280,
tableWidth: 900,
},
};
const TOTAL_SUMMARY_METRICS = [
{ key: "csi", label: "고객만족지수(CSI)", group: "csi" },
] as const;
const SAFETY_INSPECTION_METRICS = [
{ key: "csi", label: "고객만족지수(CSI)", group: "csi" },
{ key: "direct1", label: "① 현장 안전점검이 도움되는 정도", group: "direct" },
{ key: "direct2", label: "② 위험 개선 권고사항이 도움되는 정도\n [26년 신규 항목]", group: "direct" },
{ key: "indirect1", label: "③ 점검직원 전문성", group: "indirect" },
{ key: "indirect2", label: "④ 점검직원 태도", group: "indirect" },
] as const;
const UCIS_METRICS = [
{ key: "csi", label: "고객만족지수(CSI)", group: "csi" },
{ key: "direct1", label: "① 업무 효율성 및 비용 절감에 도움되는 정도", group: "direct"},
{ key: "direct2", label: "② UCIS 자료의 품질 및 업무 활용도에 대한 만족도", group: "direct" },
{ key: "indirect1", label: "③ 수시점검, 보험가액평가 요청 등의 결과처리의 신속성", group: "indirect" },
{ key: "indirect2", label: "④ UCIS 자료 관련 문의에 대한 협회의 대응\n [26년 신규 항목]", group: "indirect" },
] as const;
const BRIDGE_PLATFORM_METRICS = [
{ key: "csi", label: "고객만족지수(CSI)", group: "csi" },
{ key: "direct1", label: "① 비용 절감 및 리스크 관리에 도움이 되는 정도", group: "direct" },
{ key: "direct2", label: "② 업무 처리 속도와 의사결정에 도움이 되는 정도\n [26년 신규 항목]", group: "direct" },
{ key: "indirect1", label: "③ 플랫폼의 직관성 및 정보 검색 용이성", group: "indirect" },
{ key: "indirect2", label: "④ Bridge 플랫폼 관련 문의에 대한 협회의 대응", group: "indirect" },
] as const;
const CONSULTING_METRICS = [
{ key: "csi", label: "고객만족지수(CSI)", group: "csi" },
{ key: "direct1", label: "① 방재컨설팅 서비스가 업무에 도움되는 정도", group: "direct" },
{ key: "direct2", label: "② 용역결과물(보고서)의 품질 만족도", group: "direct" },
{ key: "indirect1", label: "③ 컨설팅직원의 전문성", group: "indirect" },
{ key: "indirect2", label: "④ 컨설팅직원의 수행 태도", group: "indirect" },
] as const;
const INSURANCE_OPERATIONS_METRICS = [
{ key: "csi", label: "고객만족지수(CSI)", group: "csi" },
{ key: "direct1", label: "① 협회가 제공하는 보험서비스에 만족하는 정도", group: "direct" },
{ key: "direct2", label: "② 보험계약 절차, 보험설계 내용 설명에 대한 만족도", group: "direct" },
{ key: "indirect1", label: "③ 담당 직원의 보험업무 전문성", group: "indirect" },
{ key: "indirect2", label: "④ 담당 직원의 업무 처리 및 고객 응대", group: "indirect" },
] as const;
const FIRE_INVESTIGATION_METRICS = [
{ key: "csi", label: "고객만족지수(CSI)", group: "csi" },
{ key: "direct1", label: "① 협회 화재원인조사 업무가 도움되는 정도", group: "direct" },
{ key: "direct2", label: "② 협회가 작성한 화재조사서의 품질\n [26년 신규 항목]", group: "direct" },
{ key: "indirect1", label: "③ 화재조사자의 전문성", group: "indirect" },
{ key: "indirect2", label: "④ 화재원인조사 수행 신속성 및 피드백", group: "indirect" },
] as const;
export const DASHBOARD_METRICS_BY_CATEGORY = {
"-1": TOTAL_SUMMARY_METRICS,
"2601009_A": SAFETY_INSPECTION_METRICS,
"2604005_E": UCIS_METRICS,
"2604005_D": BRIDGE_PLATFORM_METRICS,
"2604005_C": CONSULTING_METRICS,
"2604005_A": INSURANCE_OPERATIONS_METRICS,
"2604005_B": FIRE_INVESTIGATION_METRICS,
} as const;
export const DASHBOARD_COMMENT_COLUMNS = [
{ key: "performance25", label: "25년 고객 관점 주요 성과" },
//{ key: "plan26", label: "26년 업무계획" },
{ key: "performance26", label: "26년 고객 관점 주요 성과" },
] as const;
const DEFAULT_DASHBOARD_COMMENT_ROWS = [
{ label: "고객 직접 체감", importance: "★★★", field: "directExperience", headerClassName: "bg-csi" },
{ label: "고객 간접 체감", importance: "★★", field: "indirectExperience", headerClassName: "bg-direct" },
{ label: "내부역량 강화 등", importance: "★", field: "capability", headerClassName: "bg-indirect" },
] as const;
export const DASHBOARD_COMMENT_ROWS_BY_CATEGORY = {
"-1": DEFAULT_DASHBOARD_COMMENT_ROWS,
"2601009_A": DEFAULT_DASHBOARD_COMMENT_ROWS,
"2604005_E": DEFAULT_DASHBOARD_COMMENT_ROWS,
"2604005_D": DEFAULT_DASHBOARD_COMMENT_ROWS,
"2604005_C": DEFAULT_DASHBOARD_COMMENT_ROWS,
"2604005_A": DEFAULT_DASHBOARD_COMMENT_ROWS,
"2604005_B": DEFAULT_DASHBOARD_COMMENT_ROWS,
} as const;
export const DASHBOARD_RANK_ROWS_BY_CATEGORY: Record<string, KeyLabelEntries> = {
"2601009_A": [
["90", "일반"],
["4", "공장"],
["12", "아파트"],
["-1", "전체 물건"],
],
};
export const getDashboardTotalColumnEntries = (categoryKey?: string) =>
DASHBOARD_TOTAL_COLUMN_ENTRIES_BY_CATEGORY[categoryKey ?? ""] ?? [["-1", ""]];
export const getDashboardTotalTableLayout = (categoryKey?: string): DashboardTotalTableLayout => ({
...DEFAULT_DASHBOARD_TOTAL_TABLE_LAYOUT,
...(DASHBOARD_TOTAL_TABLE_LAYOUT_BY_CATEGORY[categoryKey ?? ""] ?? {}),
});
export const getDashboardMetricConfigs = (categoryKey?: string) =>
DASHBOARD_METRICS_BY_CATEGORY[categoryKey as keyof typeof DASHBOARD_METRICS_BY_CATEGORY] ?? SAFETY_INSPECTION_METRICS;
export const getDashboardCommentRows = (categoryKey?: string) =>
DASHBOARD_COMMENT_ROWS_BY_CATEGORY[categoryKey as keyof typeof DASHBOARD_COMMENT_ROWS_BY_CATEGORY] ?? DEFAULT_DASHBOARD_COMMENT_ROWS;
export const getDashboardRankRows = (categoryKey?: string) =>
DASHBOARD_RANK_ROWS_BY_CATEGORY[categoryKey ?? ""] ?? [];
export const getSideMenuLabel = (categoryKey: string | undefined, menuId: string) =>
SIDE_MENU_KEY_MAP_BY_CATEGORY[categoryKey ?? ""]?.[menuId] ?? DIV_KEY_MAP[menuId] ?? "";

View File

@@ -1,46 +0,0 @@
export const SITE_TITLE = "화재보험협회 대시보드"
export const CATEGORY_KEY_MAP: Record<string, string> = {
'2601009_A': '안전점검',
//'2604005_E': 'UCIS',
//'2604005_D': 'Bridge플랫폼',
//'2604005_C': '방재컨설팅',
//'2604005_A': '보험 공동인수',
//'2604005_B': '화재조사',
};
export const CATEGORY_PATH_MAP: Record<string, string> = {
'2601009_A': 'safety-inspection',
'2604005_E': 'ucis',
'2604005_D': 'bridge-platform',
'2604005_C': 'consulting',
'2604005_A': 'insurance-operations',
'2604005_B': 'fire-investigation',
};
export const CATEGORY_KEYS = Object.keys(CATEGORY_KEY_MAP) as Array<keyof typeof CATEGORY_KEY_MAP>;
export const CATEGORIES = Object.values(CATEGORY_KEY_MAP) as Array<string>;
export const DIV_KEY_MAP: Record<string, string> = {
'-1': '전체',
'1': '서울인천지역본부',
'3': '경기강원지역본부',
'2': '부산경남지역본부',
'5': '대구경북지역본부',
'6': '대전충청지역본부',
'4': '광주호남지역본부',
};
export const DIV_KEYS = ["-1", "1", "3", "2", "5", "6", "4"] as const;
export const DIVS = DIV_KEYS.map((key) => DIV_KEY_MAP[key]);
export const REGION_KEY_MAP: Record<string, string> = {
'1': '서울',
'3': '경기',
'2': '부산',
'5': '대구',
'6': '대전',
'4': '광주',
};

View File

@@ -1,5 +1,10 @@
import {SideMenuItem, TopMenuItem} from "@/config/menu.type";
import {CATEGORY_KEY_MAP, CATEGORY_PATH_MAP, DIV_KEY_MAP, DIV_KEYS} from "./kfpaConfig";
import {
CATEGORY_KEY_MAP,
CATEGORY_PATH_MAP,
SIDE_MENU_KEY_MAP_BY_CATEGORY,
SIDE_MENU_KEYS_BY_CATEGORY
} from "./kfpa.config";
import { Building } from 'lucide-react';
export const TOP_MENUS: TopMenuItem[] = Object.entries(CATEGORY_KEY_MAP).map(
@@ -15,9 +20,27 @@ export const TOP_MENUS: TopMenuItem[] = Object.entries(CATEGORY_KEY_MAP).map(
}
);
export const SIDE_MENUS :SideMenuItem[] = DIV_KEYS
.map((key) => ({
const buildSideMenus = (categoryKey: string): SideMenuItem[] => {
const labelMap = SIDE_MENU_KEY_MAP_BY_CATEGORY[categoryKey] ?? {
"-1": CATEGORY_KEY_MAP[categoryKey],
};
const keys = SIDE_MENU_KEYS_BY_CATEGORY[categoryKey]?.length
? SIDE_MENU_KEYS_BY_CATEGORY[categoryKey]
: ["-1"];
return keys.map((key) => ({
id: key,
label: DIV_KEY_MAP[key],
label: labelMap[key] ?? key,
icon: Building,
}));
};
export const SIDE_MENUS_BY_TOP_MENU: Record<string, SideMenuItem[]> = {
"-1": buildSideMenus("-1"),
"2601009_A": buildSideMenus("2601009_A"),
"2604005_E": buildSideMenus("2604005_E"),
"2604005_D": buildSideMenus("2604005_D"),
"2604005_C": buildSideMenus("2604005_C"),
"2604005_A": buildSideMenus("2604005_A"),
"2604005_B": buildSideMenus("2604005_B"),
};

View File

@@ -1,2 +0,0 @@
export const VIEW_DECIMAL_POINT = 0;
export const GAP_WORDING = "전년 대비";

View File

@@ -0,0 +1,24 @@
"use client";
import { useCallback } from "react";
import { useAtom } from "jotai";
import { layoutSelectedMenuAtom } from "@/store/jotai/layout";
export const useLayoutSelectedMenu = () => {
const [selectedMenusByTopMenu, setSelectedMenusByTopMenu] = useAtom(layoutSelectedMenuAtom);
const selectMenu = useCallback(
(topMenuId: string, menuId: string) => {
setSelectedMenusByTopMenu((prev) => ({
...prev,
[topMenuId]: menuId,
}));
},
[setSelectedMenusByTopMenu],
);
return {
selectedMenusByTopMenu,
selectMenu,
};
};

21
src/lib/admin-route.ts Normal file
View File

@@ -0,0 +1,21 @@
export const ADMIN_QUERY_PARAM = "admin-key";
export const ADMIN_ROUTE_KEY = "Kf7qP2x9";
type AdminSearchParams = Pick<URLSearchParams, "get" | "has">;
export const hasAdminRouteParam = (searchParams: AdminSearchParams) =>
searchParams.get(ADMIN_QUERY_PARAM) === ADMIN_ROUTE_KEY;
export const appendAdminRouteParam = (path: string, searchParams: AdminSearchParams) => {
if (!hasAdminRouteParam(searchParams)) {
return path;
}
const [pathWithoutHash, hash] = path.split("#");
const [pathname, queryString] = pathWithoutHash.split("?");
const params = new URLSearchParams(queryString);
params.set(ADMIN_QUERY_PARAM, ADMIN_ROUTE_KEY);
const query = params.toString();
return `${pathname}${query ? `?${query}` : ""}${hash ? `#${hash}` : ""}`;
};

125
src/lib/kfpa-util.ts Normal file
View File

@@ -0,0 +1,125 @@
import {
CATEGORY_KEY_MAP,
DASHBOARD_COMMENT_COLUMNS,
DIV_KEY_MAP, KFPA_DECIMAL_POINT,
REGION_KEY_MAP,
} from "@/config/kfpa.config";
import type {
CommentColumn,
CommentValue,
CsiDataMap,
CsiMetricKey,
DivDetailData,
CsiSummaryMap,
} from "@/types/kfpa";
import {roundNumber} from "@/lib/utils";
export const getWaveLabel = (wave: number) => {
const text = String(wave);
return `${wave >= 100 ? text.slice(-2) : text}년`;
};
export const getSummaryColumnLabel = (key: string) => {
if (key === "-1") return "지역본부 전체";
return REGION_KEY_MAP[key] ?? CATEGORY_KEY_MAP[key] ?? DIV_KEY_MAP[key] ?? key;
};
export const getSummaryDataKey = (key: string) =>
REGION_KEY_MAP[key] || key === "-1" ? `2601009_A_${key}` : `${key}_-1`;
export const getCsiDataByWave = (dataMap: CsiDataMap | undefined, divKey: string, wave: number) =>
dataMap?.[divKey]?.find((item) => item.wave === wave);
export const getCsiMetricValue = (
dataMap: CsiDataMap | undefined,
divKey: string,
wave: number,
metricKey: CsiMetricKey
) => getCsiDataByWave(dataMap, divKey, wave)?.[metricKey] ?? null;
export const getCsiMetricGapValue = (
dataMap: CsiDataMap | undefined,
divKey: string,
previousWave: number,
currentWave: number,
metricKey: CsiMetricKey
) => {
const previousValue = getCsiMetricValue(dataMap, divKey, previousWave, metricKey);
const currentValue = getCsiMetricValue(dataMap, divKey, currentWave, metricKey);
if (previousValue == null || currentValue == null) return null;
return currentValue - previousValue;
};
export const getSummaryByWave = (dataMap: CsiSummaryMap | undefined, key: string, wave: number) =>
dataMap?.[key]?.find((item) => item.wave === wave);
export const getSummaryCsiValue = (dataMap: CsiSummaryMap | undefined, key: string, wave: number) =>
getSummaryByWave(dataMap, key, wave)?.csi ?? null;
export const getSummarySampleCount = (dataMap: CsiSummaryMap | undefined, key: string, wave: number) =>
getSummaryByWave(dataMap, key, wave)?.sampleCount ?? null;
export const getSummaryGapValue = (
dataMap: CsiSummaryMap | undefined,
key: string,
previousWave: number,
currentWave: number
) => {
const previousValue = roundNumber(getSummaryCsiValue(dataMap, key, previousWave), KFPA_DECIMAL_POINT);
const currentValue = roundNumber(getSummaryCsiValue(dataMap, key, currentWave), KFPA_DECIMAL_POINT);
if (previousValue == null || currentValue == null) return null;
return currentValue - previousValue;
};
export const getAverageGapValue = (
dataMap: CsiSummaryMap | undefined,
averageKey: string,
key: string,
wave: number,
) => {
if(averageKey === key) return null;
const averageValue = roundNumber(getSummaryCsiValue(dataMap, averageKey, wave), KFPA_DECIMAL_POINT);
const currentValue = roundNumber(getSummaryCsiValue(dataMap, key, wave), KFPA_DECIMAL_POINT);
if (averageValue == null || currentValue == null) return null;
return currentValue - averageValue;
};
export const getSelectedDetail = (data: Record<string, DivDetailData> | undefined, selectedDiv: string) => {
if (!data) return undefined;
return data[selectedDiv] ?? Object.values(data)[0];
};
export const getCommentColumns = (commentValues?: Record<string, CommentValue>): CommentColumn[] => {
const selectedKeys = DASHBOARD_COMMENT_COLUMNS.map((column) => column.key);
return selectedKeys.map((key, index) => ({
key,
label: DASHBOARD_COMMENT_COLUMNS[index]?.label ?? key,
}));
};
export const createEmptyCommentValue = (): CommentValue => ({
directExperience: "",
indirectExperience: "",
capability: "",
});
export const createCommentDraft = (
columns: Array<{ key: string }>,
source?: Record<string, CommentValue>
) =>
columns.reduce<Record<string, CommentValue>>((acc, column) => {
acc[column.key] = {
...createEmptyCommentValue(),
...(source?.[column.key] ?? {}),
};
return acc;
}, {});
export const isGapRow = (raw: string) => raw.replace(/\s+/g, "").toUpperCase().includes("전년대비");
export const isSampleRow = (raw: string) => raw.replace(/\s+/g, "").includes("사례수");

View File

@@ -1,3 +0,0 @@
export const isGapRow = (raw: string) => raw.replace(/\s+/g, "").toUpperCase().includes("전년대비");
export const isSampleRow = (raw: string) => raw.replace(/\s+/g, "").includes("사례수");

View File

@@ -1,7 +1,32 @@
import CryptoJS from "crypto-js";
const KEY = CryptoJS.enc.Utf8.parse("kr!-Kfp@-fr0nT-CrypT0-Key-STR");
const IV = CryptoJS.enc.Utf8.parse("kr!-Kfp@-IVST");
const KEY = CryptoJS.enc.Utf8.parse("kr!-Kfp@-fr0nT-CrypT0-Key-STR!!!");
const IV = CryptoJS.enc.Utf8.parse("kr!-Kfp@Dash-IV!");
const VALID_AES_KEY_BYTES = [16, 24, 32];
const AES_IV_BYTES = 16;
const validateAesConfig = () => {
const validKey = VALID_AES_KEY_BYTES.includes(KEY.sigBytes);
const validIv = IV.sigBytes === AES_IV_BYTES;
if (validKey && validIv) return;
const message = [
"AES 설정이 올바르지 않습니다.",
`KEY: ${KEY.sigBytes} bytes (허용: ${VALID_AES_KEY_BYTES.join(", ")})`,
`IV: ${IV.sigBytes} bytes (필수: ${AES_IV_BYTES})`,
].join("\n");
if (typeof window !== "undefined" && process.env.NEXT_PUBLIC_ENV === "local") {
const w = window as Window & { __kfpaCryptoConfigAlerted?: boolean };
if (!w.__kfpaCryptoConfigAlerted) {
w.__kfpaCryptoConfigAlerted = true;
alert(message);
}
}
};
validateAesConfig();
export type WordArray = CryptoJS.lib.WordArray;
@@ -143,17 +168,16 @@ export class Security {
}
public static encodeBase64Url(input: WordArray): string {
const base64url = CryptoJS.enc.Base64url.stringify(input);
return this.convertToSpecialChars(base64url);
return CryptoJS.enc.Base64url.stringify(input);
}
public static decodeBase64Url(input: string): WordArray {
try {
if (this.hasSpecialChars(input)) {
const base64url = this.convertFromSpecialChars(input);
return CryptoJS.enc.Base64url.parse(base64url);
} catch {
return CryptoJS.enc.Base64url.parse(input);
}
return CryptoJS.enc.Base64url.parse(input);
}
public static encodeBase64Utf8(input: string): string {
@@ -165,17 +189,20 @@ export class Security {
}
public static encodeBase64(input: WordArray): string {
const base64 = CryptoJS.enc.Base64.stringify(input);
return this.convertToSpecialChars(base64);
return CryptoJS.enc.Base64.stringify(input);
}
public static decodeBase64(input: string): WordArray {
try {
if (this.hasSpecialChars(input)) {
const base64 = this.convertFromSpecialChars(input);
return CryptoJS.enc.Base64.parse(base64);
} catch {
}
return CryptoJS.enc.Base64.parse(input);
}
private static hasSpecialChars(input: string): boolean {
return input.includes("\u200b") || input.includes("\u200c");
}
public static encodeHex(input: WordArray): string {

View File

@@ -1,6 +1,6 @@
import { clsx, type ClassValue } from "clsx"
import { twMerge } from "tailwind-merge"
import {VIEW_DECIMAL_POINT} from "@/const/kfpa.const";
import {VIEW_DECIMAL_POINT} from "@/config/kfpa.config";
export function cn(...inputs: ClassValue[]) {
return twMerge(clsx(inputs))

111
src/proxy.ts Normal file
View File

@@ -0,0 +1,111 @@
import { NextRequest, NextResponse } from "next/server";
const IP_WHITELIST_ENV = "IP_WHITELIST";
const LOCAL_IPS = new Set(["127.0.0.1", "::1"]);
const normalizeIp = (ip: string) => {
const trimmed = ip.trim();
if (!trimmed) return "";
if (trimmed.startsWith("::ffff:")) return trimmed.slice("::ffff:".length);
const withoutBrackets = trimmed.replace(/^\[|\]$/g, "");
const portSeparatorIndex = withoutBrackets.lastIndexOf(":");
if (
portSeparatorIndex > -1 &&
withoutBrackets.indexOf(":") === portSeparatorIndex &&
/^\d+$/.test(withoutBrackets.slice(portSeparatorIndex + 1))
) {
return withoutBrackets.slice(0, portSeparatorIndex);
}
return withoutBrackets;
};
const getClientIp = (request: NextRequest) => {
const forwardedFor = request.headers.get("x-forwarded-for");
if (forwardedFor) {
return normalizeIp(forwardedFor.split(",")[0]);
}
return normalizeIp(
request.headers.get("x-real-ip") ??
request.headers.get("cf-connecting-ip") ??
request.headers.get("true-client-ip") ??
""
);
};
const ipv4ToNumber = (ip: string) => {
const parts = ip.split(".");
if (parts.length !== 4) return null;
return parts.reduce<number | null>((acc, part) => {
if (acc === null || !/^\d+$/.test(part)) return null;
const value = Number(part);
if (value < 0 || value > 255) return null;
return ((acc << 8) + value) >>> 0;
}, 0);
};
const isIpv4InCidr = (ip: string, cidr: string) => {
const [rangeIp, prefixRaw] = cidr.split("/");
const prefix = Number(prefixRaw);
const target = ipv4ToNumber(ip);
const range = ipv4ToNumber(rangeIp);
if (target === null || range === null || !Number.isInteger(prefix) || prefix < 0 || prefix > 32) {
return false;
}
const mask = prefix === 0 ? 0 : (0xffffffff << (32 - prefix)) >>> 0;
return (target & mask) === (range & mask);
};
const parseWhitelist = () =>
(process.env[IP_WHITELIST_ENV] ?? "")
.split(",")
.map((ip) => normalizeIp(ip))
.filter(Boolean);
const isAllowedIp = (clientIp: string) => {
const whitelist = parseWhitelist();
if (whitelist.length === 0) {
return process.env.ENV === "local" && LOCAL_IPS.has(clientIp);
}
return whitelist.some((allowedIp) => {
if (allowedIp.includes("/")) {
return isIpv4InCidr(clientIp, allowedIp);
}
return clientIp === allowedIp;
});
};
export function proxy(request: NextRequest) {
const pathname = request.nextUrl.pathname;
if (pathname === "/403") {
return NextResponse.next();
}
const clientIp = getClientIp(request);
if (clientIp && isAllowedIp(clientIp)) {
return NextResponse.next();
}
const url = request.nextUrl.clone();
url.pathname = "/403";
url.search = "";
return NextResponse.redirect(url);
}
export const config = {
matcher: ["/((?!api|_next/static|_next/image|favicon.ico|.*\\..*).*)"],
};

View File

@@ -5,6 +5,10 @@ export const adminQueryKeys = {
export const statisticsQueryKeys = {
all: ["statistics"] as const,
csi: () => [...statisticsQueryKeys.all, "csi"] as const,
divDetail: (divId: string | number) => [...statisticsQueryKeys.all, "div-detail", String(divId)] as const,
summary: (params?: {dt?: string}) =>
[...statisticsQueryKeys.all, "summary", params?.dt ?? ""] as const,
csi: (params?: { pkey?: string; dt?: string }) =>
[...statisticsQueryKeys.all, "csi", params?.pkey ?? "", params?.dt ?? ""] as const,
divDetail: (divId: string | number, params?: { pkey?: string; dt?: string }) =>
[...statisticsQueryKeys.all, "div-detail", String(divId), params?.pkey ?? "", params?.dt ?? ""] as const,
};

View File

@@ -1,27 +1,47 @@
import {useQuery} from "@tanstack/react-query";
import {nextApi} from "@/lib/http-client";
import {CsiDataMap, DivDetailDataMap} from "@/types/kfpa";
import {CsiDataMap, CsiSummaryMap, DivDetailDataMap} from "@/types/kfpa";
import {statisticsQueryKeys} from "@/query/key/keys";
export const getCsiData = () => {
return nextApi.get<CsiDataMap>("/statistics/csi");
export type StatisticsQueryParams = {
pkey?: string;
dt?: string;
};
export const getDivDetailData = (divId: string | number) => {
return nextApi.get<DivDetailDataMap>(`/statistics/div-detail/${divId}`);
const hasStatisticsQueryParams = (params: StatisticsQueryParams) => !!params.pkey && !!params.dt;
export const getCsiSummary = (params: {dt?: string}) => {
return nextApi.get<CsiSummaryMap>("/statistics/csi-summary", { query: params });
};
export const useCsiDataQuery = () => {
export const getCsiData = (params: StatisticsQueryParams) => {
return nextApi.get<CsiDataMap>("/statistics/csi", { query: params });
};
export const getDivDetailData = (divId: string | number, params: StatisticsQueryParams) => {
return nextApi.get<DivDetailDataMap>(`/statistics/div-detail/${divId}`, { query: params });
};
export const useCsiSummaryQuery = (params?: {dt?: string}) => {
return useQuery({
queryKey: statisticsQueryKeys.csi(),
queryFn: getCsiData,
queryKey: statisticsQueryKeys.summary(params),
queryFn: () => getCsiSummary({dt: params?.dt}),
enabled: !!params?.dt,
});
}
export const useCsiDataQuery = (params: StatisticsQueryParams) => {
return useQuery({
queryKey: statisticsQueryKeys.csi(params),
queryFn: () => getCsiData(params),
enabled: hasStatisticsQueryParams(params),
});
};
export const useDivDetailDataQuery = (divId: string | number, enabled = true) => {
export const useDivDetailDataQuery = (divId: string | number, params: StatisticsQueryParams, enabled = true) => {
return useQuery({
queryKey: statisticsQueryKeys.divDetail(divId),
queryFn: () => getDivDetailData(divId),
enabled,
queryKey: statisticsQueryKeys.divDetail(divId, params),
queryFn: () => getDivDetailData(divId, params),
enabled: enabled && hasStatisticsQueryParams(params),
});
};

11
src/store/jotai/layout.ts Normal file
View File

@@ -0,0 +1,11 @@
"use client";
import { createLocalStorageAtom } from "@/store/jotai/utils";
import { StorageKeys } from "@/store/storage/storage-keys";
export type LayoutSelectedMenuState = Record<string, string>;
export const layoutSelectedMenuAtom = createLocalStorageAtom<LayoutSelectedMenuState>(
StorageKeys.LayoutSelectedMenu,
{},
);

View File

@@ -1,71 +1,50 @@
import { Security } from "@/lib/security";
import {clientEnv} from "@/lib/env.client";
import { clientEnv } from "@/lib/env.client";
type StorageValue = any; // 요청대로 any 유지
type StorageValue = any;
// --- 내부 헬퍼 함수들 ---
const getDecryptedValue = (value: string): StorageValue => {
try {
const parseStorageValue = (value: string): StorageValue => {
if (!value || value.trim() === "") {
return null;
}
const decryptValue = clientEnv.ENV ==="prod" ? Security.decryptBase64(value) : value;
if (!decryptValue || decryptValue.trim() === "") {
const rawValue = clientEnv.ENV === "prod" ? Security.decryptBase64(value) : value;
if (!rawValue || rawValue.trim() === "") {
return null;
}
return JSON.parse(decryptValue);
} catch (error) {
// 손상된 데이터인 경우 null 반환
return null;
}
return JSON.parse(rawValue);
};
const getEncryptedValue = (value: StorageValue): string => {
const stringifyValue = JSON.stringify(value);
return clientEnv.ENV ==="prod" ? Security.encryptBase64(stringifyValue) : stringifyValue;
const stringifyStorageValue = (value: StorageValue): string => {
const rawValue = JSON.stringify(value);
return clientEnv.ENV === "prod" ? Security.encryptBase64(rawValue) : rawValue;
};
// --- LocalStorage 함수들 ---
export const setLocalStorage = (key: string, value: StorageValue): void => {
try {
const encryptValue = getEncryptedValue(value);
localStorage.setItem(key, encryptValue);
} catch (error) {
// 필요하면 로깅 추가
}
localStorage.setItem(key, stringifyStorageValue(value));
} catch {}
};
export const getLocalStorage = (key: string): StorageValue => {
try {
const encryptValue: string | null = localStorage.getItem(key);
if (encryptValue === null || encryptValue === "") {
const value = localStorage.getItem(key);
if (value === null || value === "") {
return null;
}
let value: StorageValue = null;
try {
// 암호화된 값 복호화 시도
value = getDecryptedValue(encryptValue);
} catch (decryptError) {
// 복호화 실패 시 평문으로 파싱 시도 (fallback)
return parseStorageValue(value);
} catch {
try {
value = JSON.parse(encryptValue);
} catch (fallbackError) {
// 완전히 실패한 경우 저장된 데이터 제거
return JSON.parse(value);
} catch {
localStorage.removeItem(key);
return null;
}
}
return value;
} catch (error) {
} catch {
return null;
}
};
@@ -78,43 +57,30 @@ export const clearLocalStorage = (): void => {
localStorage.clear();
};
// --- SessionStorage 함수들 ---
// 세션스토리지는 테스트/실제 서버 모두 암호화 없음
export const setSessionStorage = (key: string, value: StorageValue): void => {
try {
const encryptValue = getEncryptedValue(value);
sessionStorage.setItem(key, encryptValue);
} catch (error) {
// 필요하면 로깅 추가
}
sessionStorage.setItem(key, stringifyStorageValue(value));
} catch {}
};
export const getSessionStorage = (key: string): StorageValue => {
try {
const encryptValue: string | null = sessionStorage.getItem(key);
if (encryptValue === null || encryptValue === "") {
const value = sessionStorage.getItem(key);
if (value === null || value === "") {
return null;
}
let value: StorageValue = null;
try {
// 암호화된 값 복호화 시도
value = getDecryptedValue(encryptValue);
} catch (decryptError) {
// 복호화 실패 시 평문으로 파싱 시도 (fallback)
return parseStorageValue(value);
} catch {
try {
value = JSON.parse(encryptValue);
} catch (fallbackError) {
// 완전히 실패한 경우 저장된 데이터 제거
localStorage.removeItem(key);
return JSON.parse(value);
} catch {
sessionStorage.removeItem(key);
return null;
}
}
return value;
} catch (error) {
} catch {
return null;
}
};

View File

@@ -1,5 +1,6 @@
export const StorageKeys = {
AuthState: "kfpa:authState",
LayoutSelectedMenu: "kfpa:layoutSelectedMenu",
//CategoriFilter: "kri:categoryFilter",
//SidebarCollapsed: "kri:sidebarCollapsed",
// 필요하면 여기 계속 추가
@@ -7,6 +8,7 @@ export const StorageKeys = {
export const StorageType: Record<StorageKey, "local" | "session"> = {
[StorageKeys.AuthState]: "local",
[StorageKeys.LayoutSelectedMenu]: "local",
//[StorageKeys.CategoriFilter]: "local",
};

View File

@@ -1,8 +1,12 @@
import {CATEGORY_KEY_MAP, DIV_KEY_MAP} from "@/config/kfpaConfig";
import type {
CATEGORY_KEY_MAP,
DASHBOARD_COMMENT_ROWS_BY_CATEGORY,
DASHBOARD_METRICS_BY_CATEGORY,
} from "@/config/kfpa.config";
export type CategoryKey = keyof typeof CATEGORY_KEY_MAP;
export type DivKey = keyof typeof DIV_KEY_MAP;
export type DivKey = string;
export type CommentValue = {
directExperience: string;
@@ -10,30 +14,60 @@ export type CommentValue = {
capability: string;
};
export type CommentField = keyof CommentValue;
export type CommentColumn = {
key: string;
label: string;
};
export type RequestWriteDivComment = {
divId: number;
commentValues: Record<string, CommentValue>;
};
export type CsiSummary = {
wave: number;
sampleCount: number | null;
csi: number | null;
};
export type CsiData = {
wave: number;
sampleCount: number;
csi: number;
safeHelp: number;
recHelp: number;
staffProf: number;
staffAtt: number;
direct1: number;
direct2: number;
indirect1: number;
indirect2: number;
};
export type CsiSummaryMetricKey = keyof Omit<CsiSummary, "wave">;
export type CsiMetricKey = keyof Omit<CsiData, "wave">;
export type DashboardMetricGroup = "csi" | "direct" | "indirect";
export type DashboardMetricConfig =
(typeof DASHBOARD_METRICS_BY_CATEGORY)[keyof typeof DASHBOARD_METRICS_BY_CATEGORY][number];
export type DashboardCommentRowConfig =
(typeof DASHBOARD_COMMENT_ROWS_BY_CATEGORY)[keyof typeof DASHBOARD_COMMENT_ROWS_BY_CATEGORY][number];
export type CsiRank = {
csi: number;
divRank: number;
};
export type RankRowConfig = readonly [string, string];
export type DivDetailData = {
csiRanks: Record<string, CsiRank>;
commentValues: Record<string, CommentValue>;
};
export type CsiSummaryMap = Record<string, CsiSummary[]>;
export type CsiDataMap = Record<string, CsiData[]>;
export type DivDetailDataMap = Record<string, DivDetailData>;