# g2rain-department-app（部门管理子应用）

g2rain-department-app 是基于 Vue 3 + TypeScript + Vite + Element Plus + qiankun 的 部门管理 微前端子应用：用于租户内部门树维护、用户归属、数据权限模型与 分组授权 等控制台能力；既可被主应用（Shell）加载，也可独立运行。

能力会持续迭代，以仓库内架构文档与代码为准。

源码仓库：github.com/g2rain/g2rain-department-app (opens new window)

# 与平台能力的衔接

主应用：g2rain-main-shell 负责装载子应用、SSO 与 Token 传递。
后端 API：g2rain-department 提供部门与数据权限 REST 接口；VITE_BACKEND_ORIGIN 通常指向平台网关。
模板与脚手架：g2rain-app-template、g2rain-app-cli。
数据权限落地：控制台在此配置的策略，由 g2rain-starter-mybatis-extensions 在业务库查询时自动生效。

# 环境要求

Node.js ≥ 18、npm ≥ 9

# 安装与启动

git clone https://github.com/g2rain/g2rain-department-app.git
cd g2rain-department-app
npm install
npm run dev

# `.env` 最小示例

VITE_APPLICATION_CODE=g2rain-department-app
VITE_BASE_URL=/test/
VITE_BACKEND_ORIGIN=http://localhost:8080
VITE_APPLICATION_CONTEXT=/test
VITE_IAM_ORIGIN=http://localhost:8080
VITE_REFRESH_TOKEN_URL=/auth/refresh-token
VITE_GENERATE_TOKEN_URL=/auth/token
VITE_SSO_BASE_URL=https://sso.example.com
VITE_AUTH_END_POINT=/auth/authorize
VITE_REDIRECT_URI=http://localhost:3000/test/sso_callback
VITE_SERVER_PORT=3000

环境变量含义与快速开始一致；路径须与主应用、Nginx 分配规则对齐。

# 构建与预览

npm run build
npm run preview

仓库提供 Dockerfile 与 build.sh 时可按 README 构建镜像。

# 代码与配置生成

npm run build:generate -- --tables=dict
npm run build:config

生成物目录与忽略规则见仓库 src/shared/config-util/README.md。

# 贡献与问题跟踪

建议在 g2rain/g2rain/issues (opens new window) 集中提交并注明 g2rain-department-app。