# admin-web

**Repository Path**: agingai-open/admin-web

## Basic Information

- **Project Name**: admin-web
- **Description**: 后台管理端 — 数据看板/统计监控（Ant Design Vue 4.x + TypeScript + ECharts）
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-26
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AgingAI 后台管理端

> 数据看板 / 统计监控 — Coral 色系 · Ant Design Vue 4.x + TypeScript

## 技术栈

- Vue 3 + TypeScript + Vite
- Ant Design Vue 4.x（UI 组件库）
- ECharts 5.x（数据可视化）
- Pinia（状态管理）
- Axios（HTTP 客户端）
- JWT 鉴权（medical-portal BFF）

## 功能

- **数据看板**：双域摘要（老人健康 + 护理质量）+ ECharts 评估趋势柱状图 + 风险分布饼图（BFF overview/stats 真实数据；三维度均分待 BFF 提供独立字段，无数据时显示"暂无数据"）
- **老人健康**：分页列表 + 老人详情（护理计划 / 风险点 / 基础服务 / 照顾措施 / 慢病 / 用药 / 既往病史 / 评估报告，全量接入 BFF 聚合端点）
- **护理质量**：执行总览 + 各病区执行率（BFF 真实数据）；五类措施 / 护理员 / 执行异常待 BFF 提供对应端点（保留空状态 + TODO）
- **系统设置**：员工管理（BFF 真实 API）+ 老人档案（elderly-health 真实列表）+ 机构设置（待 BFF 端点，只读占位 + TODO）
- **JWT 登录鉴权**：路由守卫 + Token 管理（BFF 真实鉴权）

## 快速开始

```bash
npm install
npm run dev        # :3000，自动 proxy /api → :8000 (BFF)
npm run build      # 生产构建
npm run typecheck  # TypeScript 类型检查
```

## 项目结构

```
src/
├── api/           # API 层（core/request.ts + modules/）
│   └── modules/   # admin, auth, care-quality, dashboard, elderly-health, nurse, patient
├── components/    # 共享组件（PageContainer, StatCard, RiskCard...）
├── composables/   # 组合式函数（useChart, useRiskLabel）
├── layout/        # 布局框架（BasicLayout, AuthLayout）
├── router/        # Vue Router（守卫 + 路由表）
├── stores/        # Pinia stores（app, auth, dashboard, care-quality, elderly-health, admin）
├── styles/        # 设计令牌 + 全局样式
├── types/         # TypeScript 类型定义（api, patient, dashboard, care-quality, elderly-health, admin）
└── views/         # 页面组件
    ├── admin/         # 系统设置（员工管理连 API）
    ├── alerts/        # 告警管理（待开发）
    ├── auth/          # 登录页（BFF 鉴权）
    ├── care-quality/  # 护理质量（BFF 真实数据）
    ├── dashboard/     # 数据看板（BFF 真实数据）
    ├── elderly-health/# 老人健康（BFF 真实数据）
    ├── error/         # 404 页
    ├── patients/      # 老人详情
    └── system/        # 用户管理/系统设置
```

## 设计规范

| Token | 值 | 说明 |
|-------|-----|------|
| 主色 | `#c96048` | Coral |
| 侧边栏背景 | `#1e293b` | Dark Slate |
| sidebar-active | `#334155` | Slate |
| sidebar-hover | `#273549` | Darker Slate |
| 文字色 | `#1e293b` | Slate 900 |
| 辅助文字 | `#64748b` | Slate 500 |
| 边框色 | `#e2e8f0` | Slate 200 |
| 背景 | `#f0f2f5` | Light Gray |

## 相关文档

- [OpenSpec 规格](openspec/specs/) — 8 个能力规格


---

> 医疗免责声明：本系统为研究用途技术探索，不是医疗器械，输出不得用于临床诊断——完整声明见[父仓 DISCLAIMER.zh.md](../DISCLAIMER.zh.md)。

---

## 许可

本项目代码采用 [Apache License 2.0](LICENSE)；许可边界说明见[父仓 NOTICE](../NOTICE.md)。