# InformationSystem **Repository Path**: PaperDog/information-system ## Basic Information - **Project Name**: InformationSystem - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-22 - **Last Updated**: 2026-10-25 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 企业知识库管理系统前端 基于 Vue 3、TypeScript、Vite、Tailwind CSS 4 和 Pinia 的企业知识库界面。系统不单独校验员工密码,登录认证和有效权限均由 RBAC 统一权限管理平台提供。 ## 本地运行 Windows 用户可以直接双击项目根目录的 `启动知识库系统.cmd`。首次运行会自动安装依赖,随后打开: ```text http://127.0.0.1:4173/login ``` 也可以使用命令行: ```bash npm install npm run dev ``` 生产构建: ```bash npm run typecheck npm run build ``` 默认请求前缀为 `/api`,可通过环境变量调整: ```env VITE_API_BASE_URL=/api ``` ## 登录与 JWT 流程 1. 用户在 `/login` 输入员工用户名或手机号及用户密码。 2. 前端调用 `POST /api/auth/login`,请求体为 `{ account, password, remember }`。 3. RBAC 校验通过后返回 JWT、用户信息和权限版本。 4. 前端使用 `Authorization: Bearer ` 调用 `GET /api/users/{userId}/effective-permissions` 加载知识库有效权限。 5. JWT 和员工会话写入 `knowledge-hub-auth-v2` 本地存储;密码不会写入本地存储。 6. 进入知识库路由前执行登录状态、JWT 会话和页面权限校验。 如果用户名、手机号或密码错误,系统停留在登录页并弹窗显示: ```text 用户名/手机号/密码错误,请重试 ``` 网络不可用时会单独提示无法连接 RBAC 权限管理系统,不会误报为密码错误。 ## 演示账号 登录页提供六个可一键登录的演示账号,点击后会自动填写用户名和密码,并继续执行相同的 RBAC/JWT 登录流程。 | 角色 | 用户名 | 密码 | 数据范围 | | --- | --- | --- | --- | | 系统管理员 | `SG000012` | `123456` | 全部公司 | | 部门管理员 | `SG000198` | `123456` | 本部门及下级 | | 普通员工 | `SG000196` | `123456` | 本人 | | 公司领导 | `SG000001` | `123456` | 全部公司 | | 部门经理 | `SG000011` | `123456` | 本部门及下级 | | 项目经理 | `SG000281` | `123456` | 本部门 | 开发环境默认启用 `scripts/rbac-demo-plugin.ts`,提供与真实接口相同结构的 `/api/auth/login` 和有效权限响应。演示 JWT 使用 HS256 签名。生产环境接入真实 RBAC 时配置: ```env VITE_ENABLE_DEMO_RBAC=false VITE_API_BASE_URL=/api VITE_RBAC_PROXY_TARGET=http://127.0.0.1:8080 ``` ## 业务与权限设计成果 - [业务与权限建模](docs/business-permission-model.md) - [界面设计复核](docs/ui-design-review.md) - [API 设计说明](api/API设计说明.md) - [RBAC 集成契约](api/RBAC集成契约.md) - [OpenAPI 契约](api/openapi.json) - [知识库数据库结构与演示数据](database/README.md) - 原始设计数据副本位于 `design-data/` 员工表包含 10,101 名有效员工、10 家公司、110 个有员工归属的部门和 19 个岗位。RBAC 角色包括系统管理员、部门管理员、公司领导、部门经理、项目经理和普通员工。 ## 页面与功能映射 | Excel 功能点 | 权限编码 | 页面 | | --- | --- | --- | | 知识分类体系配置 | `KNOWLEDGE.M001.F001` | `/taxonomy` | | 知识模板管理 | `KNOWLEDGE.M001.F002` | `/templates` | | 专家库管理 | `KNOWLEDGE.M001.F003` | `/experts` | | 文档上传与编辑 | `KNOWLEDGE.M002.F001` | `/documents` | | 文档审核与发布 | `KNOWLEDGE.M002.F002` | `/review` | | 文档归档与销毁 | `KNOWLEDGE.M002.F003` | `/archive` | | 全文检索 | `KNOWLEDGE.M003.F001` | `/search`、`/overview` | | 知识分享与互动 | `KNOWLEDGE.M003.F002` | `/community` | | 知识统计分析 | `KNOWLEDGE.M003.F003` | `/analytics` | | 工程规范库 | `KNOWLEDGE.M004.F001` | `/library/standards` | | 项目复盘库 | `KNOWLEDGE.M004.F002` | `/library/retrospectives` | | 政策法规库 | `KNOWLEDGE.M004.F003` | `/library/policies` | ## RBAC 接口约定 登录接口沿用现有 RBAC 契约: ```http POST /api/auth/login Content-Type: application/json { "account": "SG000012", "password": "123456", "remember": true } ``` 成功响应: ```json { "code": 0, "message": "success", "data": { "token": "", "tokenType": "Bearer", "expiresIn": 7200, "permissionVersion": "v2026.10.22-8", "user": { "id": "SG000012", "name": "马顺", "username": "SG000012", "companyName": "总公司", "departmentName": "工程技术部", "roleCodes": ["KNOWLEDGE_ADMIN"], "roleNames": ["知识库管理员"], "dataScope": "ALL", "permissionVersion": "v2026.10.22-8", "roleMode": "system" } } } ``` 有效权限接口: ```http GET /api/users/SG000012/effective-permissions Authorization: Bearer ``` 前端从 `functionPermissions` 中筛选 `systemCode = KNOWLEDGE` 或 `resourceCode` 以 `KNOWLEDGE.` 开头的资源,并将 `VIEW`、`CREATE`、`EDIT`、`APPROVE`、`EXPORT`、`ALL` 等操作码映射为页面和按钮权限。 ## 目录结构 ```text src/ api/ RBAC 登录与有效权限接口 components/ 文档抽屉、编辑弹窗、导航与反馈组件 data/ 业务演示数据 layouts/ 登录后的主工作台布局 router/ 登录守卫、页面权限与数据加载 stores/ JWT 会话、RBAC 权限与全局提示 types/ 知识领域类型 utils/ 状态与展示映射 views/ 登录页及 13 个业务功能页面 ``` ## 设计约束 - 设计令牌集中在 `src/style.css` 的 Tailwind `@theme` 中。 - 主色为深松石绿,正文使用冷白档案纸色,赭黄表示审核与时效风险,印章红表示密级与销毁风险。 - 标题使用宋体类展示字体,正文使用中文无衬线字体;表格与权限编码使用等宽字体。 - 桌面端使用固定工作侧栏和密集表格,移动端将文档列表与权限矩阵切换为可读卡片。 - 页面具备键盘焦点、禁用态、空状态、错误弹窗和明确的中文反馈。 ## 后端 后端位于 [`backend/`](backend/README.md),采用 TypeScript、Fastify 和 MySQL 8。 默认地址为 `http://127.0.0.1:8080/api`,包含 RBAC 登录与权限代理、分类、文档、 审核、归档销毁、社区、专家、模板、统计、文件和权限变更回调。 启动方式: ```bash cd backend npm install npm run dev ``` 前端联调时设置: ```env VITE_ENABLE_DEMO_RBAC=false VITE_API_BASE_URL=/api VITE_RBAC_PROXY_TARGET=http://127.0.0.1:8080 ``` ## 说明 前端演示数据仍保留在 `src/data/mock.ts`,用于未启动后端时预览界面。接入后端后, 认证和有效权限由 RBAC 提供,业务数据来自 `knowledge_db`。