openhpc-webui 0.2.0__tar.gz

openhpc_webui-0.2.0/.github/workflows/python-publish.yml

@@ -0,0 +1,85 @@
+# This workflow will upload a Python Package to PyPI when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+concurrency:
+  group: pypi-publish
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out release source
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: "3.11"
+
+      - name: Verify release version
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: |
+          PACKAGE_VERSION="$(python -c 'from openhpc_webui import __version__; print(__version__)')"
+          if [ "$RELEASE_TAG" != "v$PACKAGE_VERSION" ]; then
+            echo "Release tag $RELEASE_TAG does not match package version $PACKAGE_VERSION" >&2
+            exit 1
+          fi
+
+      - name: Install build and test dependencies
+        run: python -m pip install "build==1.3.0" .
+
+      - name: Run tests
+        run: python -m unittest discover -s tests
+
+      - name: Build release distributions
+        run: python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: release-dists
+          path: dist/
+          if-no-files-found: error
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+
+    # Dedicated environments with protections for publishing are strongly recommended.
+    # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
+    environment:
+      name: pypi
+      url: https://pypi.org/project/openhpc-webui/
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
+        with:
+          packages-dir: dist/

openhpc_webui-0.2.0/.gitignore

@@ -0,0 +1,5 @@
+.env
+__pycache__/
+.venv
+.Ds_Store
+.playwright-cli 

openhpc_webui-0.2.0/.python-version

@@ -0,0 +1 @@
+3.9

openhpc_webui-0.2.0/AGENTS.md

@@ -0,0 +1,37 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- `openhpc_webui/application.py` contains the FastAPI application factory and route layer.
+- Core integrations live in `openhpc_webui/services/`; request models and settings live in `openhpc_webui/schemas.py` and `openhpc_webui/config.py`.
+- UI templates are in `templates/` (with shared layout/components in `templates/base.html` and `templates/components/`).
+- Frontend static assets are in `static/` (offline Tailwind CSS bundle plus page scripts).
+- Operations/deployment docs are in `README.md`, `docs/DEPLOYMENT.md`, and `docs/USER_MANUAL.md`.
+
+## Build, Test, and Development Commands
+- `uv sync` installs Python dependencies into the project environment.
+- `uvicorn openhpc_webui.application:app --reload --port 6827` starts local development server with auto-reload.
+- `uvicorn openhpc_webui.application:app --host 127.0.0.1 --port 6827 --proxy-headers --forwarded-allow-ips=127.0.0.1` runs a production-style local binding behind Nginx.
+- `python -m compileall -q openhpc_webui` performs a quick syntax validation pass.
+- `bash update_offline.sh` refreshes offline assets/content for disconnected deployment scenarios.
+
+## Coding Style & Naming Conventions
+- Target Python `>=3.9`; follow PEP 8 and keep 4-space indentation.
+- Use `snake_case` for modules, functions, and variables; use clear action-based names (for example, `create_user`, `get_partition_status`).
+- Prefer type hints for public functions and API helpers.
+- Keep route handlers thin; place LDAP/Slurm logic in manager modules.
+- Templates and static files should use feature-oriented names (for example, `jobs.html`, `nodes.js`).
+
+## Testing Guidelines
+- Automated tests live under `tests/`; extend them when introducing non-trivial logic.
+- Name test files `test_<module>.py` and test functions `test_<behavior>()`.
+- Before opening a PR, run syntax checks and manually verify key flows: login, user/group CRUD, partition/node/jobs pages.
+
+## Commit & Pull Request Guidelines
+- Follow the repository’s existing style: short, imperative, task-focused subjects (examples: `Add auth toggle`, `修复节点数据异常问题`).
+- Keep each commit scoped to one logical change.
+- PRs should include: purpose, changed modules/templates, manual verification steps, related issue/task, and UI screenshots for template/static changes.
+
+## Security & Configuration Tips
+- Never commit real credentials; keep `.env` local and start from `env.example`.
+- Rotate `SECRET_KEY` and LDAP admin credentials in production.
+- Validate Slurm command permissions and run behind internal network controls.

openhpc_webui-0.2.0/CLAUDE.md

@@ -0,0 +1,112 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a lightweight web management portal for HPC centers, built to run in offline intranet environments. It manages LDAP identity systems, Slurm cluster resources, and job status.
+
+**Key Characteristics:**
+- All-Chinese UI interface (全中文界面)
+- Theme color: #dc3023 (China Red / Research Red)
+- Offline deployment: All static resources must be localized (no external CDNs)
+- Minimalist, professional admin dashboard aesthetic
+- Target environment: Python 3.9+
+
+## Development Commands
+
+### Running the Application
+```bash
+# Development server (from project root)
+uvicorn openhpc_webui.application:app --reload --port 6827
+
+# Production server
+uvicorn openhpc_webui.application:app --host 127.0.0.1 --port 6827 --proxy-headers --forwarded-allow-ips=127.0.0.1
+```
+
+### Package Management
+This project uses `uv` for dependency management:
+```bash
+# Install dependencies
+uv sync
+
+# Add a new dependency
+uv add <package-name>
+
+# Activate virtual environment
+source .venv/bin/activate
+```
+
+## Architecture Overview
+
+### Technology Stack
+- **Backend:** FastAPI (Python 3.9+)
+- **Frontend:** Native HTML/JS + Tailwind CSS (must be localized)
+- **Authentication:** LDAP Admin binding
+- **Dependencies:** python-ldap, pyslurm (or subprocess-based Slurm CLI parsing), uvicorn
+
+### Planned Module Structure
+
+1. **LDAP User & Group Management** (`/users`)
+   - User CRUD operations (list, create with UID/GID/home/shell, password change, delete)
+   - Group management with user assignment
+   - LDAP connection health checks
+
+2. **Slurm Resource Management** (`/partitions`)
+   - Partition overview (name, node status: Alloc/Idle/Down, quotas)
+   - Node monitoring (status, CPU/VRAM usage)
+   - Partition control (Up/Down operations)
+
+3. **Job Management** (`/jobs`)
+   - Real-time job queue from `squeue` (JobID, user, partition, status, runtime, nodes)
+   - Job details (submission script, output paths)
+   - Admin job cancellation via `scancel`
+
+4. **Dashboard** (`/dashboard`)
+   - Overview metrics: total users, active jobs, idle nodes
+
+### UI/UX Guidelines
+- **Layout:** Fixed left sidebar navigation, top breadcrumb, main content area on right
+- **Colors:**
+  - Primary: #dc3023 (navigation, buttons, logo)
+  - Background: #f8f9fa (light gray)
+  - Text: #1a1a1a
+- **Components:**
+  - Card-style containers with subtle shadows
+  - Compact tables with column sorting
+  - Status badges: Running (green), Queued (yellow), Completed/Failed (gray/red)
+- **Fonts:** System sans-serif (PingFang SC, Microsoft YaHei)
+
+### Offline Requirements (Critical)
+- **NO external CDN dependencies** (Tailwind, FontAwesome, Google Fonts)
+- All CSS/JS must be in `static/` directory
+- Use system fonts only
+
+## Development Guidelines
+
+### File Organization
+- `openhpc_webui/application.py` - FastAPI application factory and route layer
+- `openhpc_webui/services/` - LDAP, Slurm, quota, and system integrations
+- `openhpc_webui/schemas.py` - API request models
+- `openhpc_webui/config.py` - environment settings and runtime paths
+- `templates/` - HTML templates (Jinja2)
+- `static/` - All CSS, JS, and static assets (must be self-contained)
+- `requirement.md` - Complete project requirements in Chinese
+
+### Slurm Integration Notes
+- Parse Slurm commands via subprocess: `sinfo --json`, `squeue`, `sacct`
+- Implement proper error handling for LDAP connection failures
+- All Slurm operations require admin privileges verification
+
+### Security Considerations
+- LDAP admin credentials must be securely configured
+- Validate all user inputs before LDAP/Slurm operations
+- Implement proper session management for admin authentication
+- Add confirmation modals for destructive operations (delete user, cancel job)
+
+## Important Context
+
+- This is designed for **internal network deployment only** - no internet access assumed
+- All UI text should be in **Chinese**
+- When implementing Slurm features, prefer JSON output formats where available (`sinfo --json`)
+- Use Tailwind utility classes but ensure the CSS file is bundled locally in `static/`

openhpc_webui-0.2.0/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.5
+Name: openhpc_webui
+Version: 0.2.0
+Summary: openhpc_webui
+Requires-Python: >=3.9
+Requires-Dist: fastapi[standard]<0.129,>=0.128.0
+Requires-Dist: itsdangerous>=2.2.0
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: ldap3>=2.9.1
+Requires-Dist: python-dotenv>=1.2.1
+Description-Content-Type: text/markdown
+
+# openhpc_webui
+
+`openhpc_webui` 是面向高校、科研机构和企业智算中心的轻量级中文管理门户。项目将 OpenLDAP 身份管理、Slurm 账户与关联、分区和节点配置、作业状态及输出查看集中到同一个 Web 界面，适合内网和离线环境。
+
+当前版本：`0.2.0`
+
+## 功能概览
+
+| 模块 | 主要能力 |
+| --- | --- |
+| 系统总览 | LDAP 用户数、活动作业、空闲节点、近期作业和分区状态 |
+| 用户管理 | LDAP 用户增删改、禁用、SSH 密钥、存储配额、核时/卡时和作业报表 |
+| 组管理 | LDAP 组创建、编辑、删除及成员信息查看 |
+| 账户管理 | Slurm 账户创建、编辑和删除 |
+| 集群用户 | Slurm Association、QOS、默认 QOS、分区和 TRES Minutes 管理 |
+| 分区管理 | Slurm 分区配置、节点状态统计及配置重载 |
+| 节点管理 | 节点配置维护、Drain、Resume 和状态查看 |
+| 作业管理 | 活动作业、近期完成作业、详情、取消及标准输出/错误查看 |
+| 权限管理 | 门户管理员授权与撤销 |
+
+页面资源随项目提供，不依赖外部 CDN。列表采用固定表头、对齐的数字和状态列，并在内容溢出时提供横向滚动。
+
+## 权限模型
+
+| 能力 | 管理员 | 普通用户 |
+| --- | :---: | :---: |
+| 系统总览和管理页面 | 是 | 否 |
+| 查看全部活动及近期完成作业 | 是 | 是 |
+| 查看作业详情 | 是 | 是 |
+| 查看作业输出 | 任意作业 | 仅自己的作业 |
+| 取消作业 | 任意作业 | 仅自己的作业 |
+| 修改自己的 LDAP 密码 | 是 | 是 |
+
+管理员由 `ADMIN_USERS` 配置，也可以在权限管理页面在线维护。普通用户访问管理员页面时会被重定向到作业页面。
+
+## 界面预览
+
+### 登录
+
+![openhpc_webui 登录界面](./docs/login.png)
+
+### 系统总览
+
+![openhpc_webui 系统总览](./docs/dashboard.png)
+
+### 用户管理
+
+![openhpc_webui 用户管理](./docs/user.png)
+
+### 作业管理
+
+![openhpc_webui 作业管理](./docs/job.png)
+
+## 技术栈
+
+- Python 3.9+
+- FastAPI、Jinja2 和 Uvicorn
+- ldap3 / OpenLDAP
+- Slurm CLI：`sinfo`、`squeue`、`sacct`、`scontrol`、`sacctmgr`、`scancel`
+- uv 依赖与环境管理
+- Tailwind CSS CLI 4.x（仅在修改模板或前端脚本中的工具类后重新构建）
+
+## 项目结构
+
+```text
+openhpc_webui/
+├── openhpc_webui/
+│   ├── application.py      # FastAPI 路由与接口
+│   ├── cli.py              # 命令行入口
+│   ├── core/               # 配置、认证和公共能力
+│   ├── models/             # 请求与响应模型
+│   └── services/           # LDAP、Slurm 和系统集成
+├── templates/              # Jinja2 页面模板
+├── static/                 # 离线 CSS、JavaScript 和图标
+├── tests/                  # 自动化测试
+├── docs/                   # 使用、部署和运维文档
+├── env.example             # 环境变量示例
+└── pyproject.toml          # 项目元数据与依赖
+```
+
+## 环境要求
+
+运行门户的主机需要：
+
+- 能够访问 OpenLDAP 服务；
+- 安装 Slurm 客户端命令，并能连接 Slurm 控制端；
+- 对节点和分区配置文件具有业务所需的读写权限；
+- 使用 NFS 配额时安装并配置 `quota` / `setquota`；
+- 生产环境具备 Nginx、Supervisor 或等效的进程管理能力。
+
+Web 管理员身份不会绕过 Linux 文件权限或 Slurm 权限。
+
+## 快速开始
+
+```bash
+uv sync
+cp env.example .env
+uv run uvicorn openhpc_webui.application:app --reload --port 6827
+```
+
+浏览器访问 `http://127.0.0.1:6827`。也可以使用项目命令启动监听在 `0.0.0.0:6827` 的服务：
+
+```bash
+uv run openhpc_webui
+```
+
+### 最小配置
+
+编辑 `.env`，至少确认以下配置：
+
+| 配置项 | 用途 |
+| --- | --- |
+| `LDAP_URI` | LDAP 服务地址 |
+| `LDAP_BASE_DN` | LDAP Base DN |
+| `LDAP_DEFAULT_BIND_DN` | 管理 Bind DN |
+| `LDAP_DEFAULT_AUTHTOK` | 管理 Bind 密码 |
+| `SECRET_KEY` | Session 签名密钥，生产环境不少于 32 个随机字符 |
+| `AUTHORIZED` | 是否启用登录认证，生产环境必须为 `True` |
+| `ADMIN_USERS` | 管理员用户名，多个值使用英文逗号分隔 |
+| `SLURM_DEFAULT_ACCOUNT` | 创建 LDAP 用户时使用的默认 Slurm 账户 |
+| `SLURM_CONFIG_DIR` | 节点与分区配置文件目录，默认 `/etc/slurm` |
+
+完整配置说明见[技术指南](./docs/TECHNICAL_GUIDE.md)。
+
+## 生产部署
+
+生产环境建议由 Supervisor 管理 Uvicorn，并仅监听 `127.0.0.1:6827`；由 Nginx 提供 HTTPS 和反向代理。不要直接将开发服务器暴露到公网。
+
+部署步骤、自签发证书、服务管理和升级方法见[生产部署指南](./docs/DEPLOYMENT.md)。
+
+## 文档
+
+- [用户使用手册](./docs/USER_MANUAL.md)：管理员和普通用户的页面操作说明
+- [技术指南](./docs/TECHNICAL_GUIDE.md)：配置、运行、架构、测试与故障排查
+- [生产部署指南](./docs/DEPLOYMENT.md)：Supervisor、Nginx、HTTPS 和升级
+- [磁盘配额指南](./docs/DISK_QUOTA.md)：XFS `/home` 配额启用、验证和 Web UI 配置
+- [核时统计与额度拨付](./docs/SLURM_USAGE_AND_CREDITS.md)：统计口径、Slurm 命令、拨付算法和登录提示脚本
+- [Rocky Linux 9 LDAP 部署](./docs/LDAP_ROCKY9.md)：OpenLDAP 安装与初始化
+- [Rocky Linux 9 SSSD 接入](./docs/SSSD_LDAP_ROCKY9.md)：计算节点接入 LDAP 身份
+
+## 验证与开发
+
+```bash
+./scripts/build_tailwind.sh
+uv run python -m unittest discover -s tests
+uv run python -m compileall -q openhpc_webui
+```
+
+Tailwind 构建入口为 `tailwind.css`，只扫描 `templates/` 和 `static/*.js` 中实际使用的类，并将压缩后的离线样式写入 `static/all-tailwind-classes-full-min.css`。
+
+提交界面变更前，还应手动检查登录、用户、组、账户、集群用户、分区、节点、作业和权限页面，并附上桌面与窄屏截图。
+
+## 安全建议
+
+- 仅在受控内网开放门户，并使用防火墙限制来源。
+- 生产环境启用 HTTPS，并将 `SESSION_HTTPS_ONLY` 设为 `True`。
+- 不要提交 `.env`、LDAP 管理密码、Session 密钥或真实用户数据。
+- 仅授予运行账户完成 LDAP、Slurm 和配置文件操作所需的最小权限。
+- 定期审计管理员列表、Slurm 操作和应用日志。
+
+本项目是集群管理辅助工具，不替代 Slurm、LDAP、监控平台或审计系统本身。

openhpc_webui-0.2.0/README.md

@@ -0,0 +1,161 @@
+# openhpc_webui
+
+`openhpc_webui` 是面向高校、科研机构和企业智算中心的轻量级中文管理门户。项目将 OpenLDAP 身份管理、Slurm 账户与关联、分区和节点配置、作业状态及输出查看集中到同一个 Web 界面，适合内网和离线环境。
+
+当前版本：`0.2.0`
+
+## 功能概览
+
+| 模块 | 主要能力 |
+| --- | --- |
+| 系统总览 | LDAP 用户数、活动作业、空闲节点、近期作业和分区状态 |
+| 用户管理 | LDAP 用户增删改、禁用、SSH 密钥、存储配额、核时/卡时和作业报表 |
+| 组管理 | LDAP 组创建、编辑、删除及成员信息查看 |
+| 账户管理 | Slurm 账户创建、编辑和删除 |
+| 集群用户 | Slurm Association、QOS、默认 QOS、分区和 TRES Minutes 管理 |
+| 分区管理 | Slurm 分区配置、节点状态统计及配置重载 |
+| 节点管理 | 节点配置维护、Drain、Resume 和状态查看 |
+| 作业管理 | 活动作业、近期完成作业、详情、取消及标准输出/错误查看 |
+| 权限管理 | 门户管理员授权与撤销 |
+
+页面资源随项目提供，不依赖外部 CDN。列表采用固定表头、对齐的数字和状态列，并在内容溢出时提供横向滚动。
+
+## 权限模型
+
+| 能力 | 管理员 | 普通用户 |
+| --- | :---: | :---: |
+| 系统总览和管理页面 | 是 | 否 |
+| 查看全部活动及近期完成作业 | 是 | 是 |
+| 查看作业详情 | 是 | 是 |
+| 查看作业输出 | 任意作业 | 仅自己的作业 |
+| 取消作业 | 任意作业 | 仅自己的作业 |
+| 修改自己的 LDAP 密码 | 是 | 是 |
+
+管理员由 `ADMIN_USERS` 配置，也可以在权限管理页面在线维护。普通用户访问管理员页面时会被重定向到作业页面。
+
+## 界面预览
+
+### 登录
+
+![openhpc_webui 登录界面](./docs/login.png)
+
+### 系统总览
+
+![openhpc_webui 系统总览](./docs/dashboard.png)
+
+### 用户管理
+
+![openhpc_webui 用户管理](./docs/user.png)
+
+### 作业管理
+
+![openhpc_webui 作业管理](./docs/job.png)
+
+## 技术栈
+
+- Python 3.9+
+- FastAPI、Jinja2 和 Uvicorn
+- ldap3 / OpenLDAP
+- Slurm CLI：`sinfo`、`squeue`、`sacct`、`scontrol`、`sacctmgr`、`scancel`
+- uv 依赖与环境管理
+- Tailwind CSS CLI 4.x（仅在修改模板或前端脚本中的工具类后重新构建）
+
+## 项目结构
+
+```text
+openhpc_webui/
+├── openhpc_webui/
+│   ├── application.py      # FastAPI 路由与接口
+│   ├── cli.py              # 命令行入口
+│   ├── core/               # 配置、认证和公共能力
+│   ├── models/             # 请求与响应模型
+│   └── services/           # LDAP、Slurm 和系统集成
+├── templates/              # Jinja2 页面模板
+├── static/                 # 离线 CSS、JavaScript 和图标
+├── tests/                  # 自动化测试
+├── docs/                   # 使用、部署和运维文档
+├── env.example             # 环境变量示例
+└── pyproject.toml          # 项目元数据与依赖
+```
+
+## 环境要求
+
+运行门户的主机需要：
+
+- 能够访问 OpenLDAP 服务；
+- 安装 Slurm 客户端命令，并能连接 Slurm 控制端；
+- 对节点和分区配置文件具有业务所需的读写权限；
+- 使用 NFS 配额时安装并配置 `quota` / `setquota`；
+- 生产环境具备 Nginx、Supervisor 或等效的进程管理能力。
+
+Web 管理员身份不会绕过 Linux 文件权限或 Slurm 权限。
+
+## 快速开始
+
+```bash
+uv sync
+cp env.example .env
+uv run uvicorn openhpc_webui.application:app --reload --port 6827
+```
+
+浏览器访问 `http://127.0.0.1:6827`。也可以使用项目命令启动监听在 `0.0.0.0:6827` 的服务：
+
+```bash
+uv run openhpc_webui
+```
+
+### 最小配置
+
+编辑 `.env`，至少确认以下配置：
+
+| 配置项 | 用途 |
+| --- | --- |
+| `LDAP_URI` | LDAP 服务地址 |
+| `LDAP_BASE_DN` | LDAP Base DN |
+| `LDAP_DEFAULT_BIND_DN` | 管理 Bind DN |
+| `LDAP_DEFAULT_AUTHTOK` | 管理 Bind 密码 |
+| `SECRET_KEY` | Session 签名密钥，生产环境不少于 32 个随机字符 |
+| `AUTHORIZED` | 是否启用登录认证，生产环境必须为 `True` |
+| `ADMIN_USERS` | 管理员用户名，多个值使用英文逗号分隔 |
+| `SLURM_DEFAULT_ACCOUNT` | 创建 LDAP 用户时使用的默认 Slurm 账户 |
+| `SLURM_CONFIG_DIR` | 节点与分区配置文件目录，默认 `/etc/slurm` |
+
+完整配置说明见[技术指南](./docs/TECHNICAL_GUIDE.md)。
+
+## 生产部署
+
+生产环境建议由 Supervisor 管理 Uvicorn，并仅监听 `127.0.0.1:6827`；由 Nginx 提供 HTTPS 和反向代理。不要直接将开发服务器暴露到公网。
+
+部署步骤、自签发证书、服务管理和升级方法见[生产部署指南](./docs/DEPLOYMENT.md)。
+
+## 文档
+
+- [用户使用手册](./docs/USER_MANUAL.md)：管理员和普通用户的页面操作说明
+- [技术指南](./docs/TECHNICAL_GUIDE.md)：配置、运行、架构、测试与故障排查
+- [生产部署指南](./docs/DEPLOYMENT.md)：Supervisor、Nginx、HTTPS 和升级
+- [磁盘配额指南](./docs/DISK_QUOTA.md)：XFS `/home` 配额启用、验证和 Web UI 配置
+- [核时统计与额度拨付](./docs/SLURM_USAGE_AND_CREDITS.md)：统计口径、Slurm 命令、拨付算法和登录提示脚本
+- [Rocky Linux 9 LDAP 部署](./docs/LDAP_ROCKY9.md)：OpenLDAP 安装与初始化
+- [Rocky Linux 9 SSSD 接入](./docs/SSSD_LDAP_ROCKY9.md)：计算节点接入 LDAP 身份
+
+## 验证与开发
+
+```bash
+./scripts/build_tailwind.sh
+uv run python -m unittest discover -s tests
+uv run python -m compileall -q openhpc_webui
+```
+
+Tailwind 构建入口为 `tailwind.css`，只扫描 `templates/` 和 `static/*.js` 中实际使用的类，并将压缩后的离线样式写入 `static/all-tailwind-classes-full-min.css`。
+
+提交界面变更前，还应手动检查登录、用户、组、账户、集群用户、分区、节点、作业和权限页面，并附上桌面与窄屏截图。
+
+## 安全建议
+
+- 仅在受控内网开放门户，并使用防火墙限制来源。
+- 生产环境启用 HTTPS，并将 `SESSION_HTTPS_ONLY` 设为 `True`。
+- 不要提交 `.env`、LDAP 管理密码、Session 密钥或真实用户数据。
+- 仅授予运行账户完成 LDAP、Slurm 和配置文件操作所需的最小权限。
+- 定期审计管理员列表、Slurm 操作和应用日志。
+
+本项目是集群管理辅助工具，不替代 Slurm、LDAP、监控平台或审计系统本身。