# hierp

**Repository Path**: artlongs/hierp

## Basic Information

- **Project Name**: hierp
- **Description**: Human-ERP ，一个以AI为大脑中枢的ERP系统。
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HiERP

AI驱动的智能ERP系统 — 以AI Agent为中枢大脑的新一代企业资源计划系统。

## 技术栈

| 层次 | 技术 |
|------|------|
| 后端 | Python 3.10+ / FastAPI / SQLAlchemy / PostgreSQL |
| 前端 | htmx 2.0 / Jinja2 / AlpineJS / Tailwind CSS |
| 认证 | JWT / RBAC 权限控制 |
| AI | Hermes Agent（规划中） |

## 脚本总览

| 脚本 | 用途 | 命令 |
|------|------|------|
| `setup.sh` | 初始化项目环境（数据库、依赖、管理员） | `./setup.sh` |
| `start.sh` | 启动项目服务 | `./start.sh` |
| `test.sh` | 运行测试用例 | `./test.sh` |

### setup.sh 执行流程

1. 检查 Python 版本（要求 3.10+）
2. 检查 PostgreSQL 连接
3. 创建 `hierp` 数据库（如已存在则跳过）
4. 创建 Python 虚拟环境 `backend/venv`
5. 安装项目依赖包 + 开发依赖（pytest、httpx 等）
6. 初始化数据库表
7. 创建管理员账号 admin / admin123

### 快速开始

```bash
# 首次部署，一键初始化
./setup.sh

# 启动服务
./start.sh

# 运行全部测试
./test.sh

# 运行指定模块测试
./test.sh tests/api/test_auth.py
```

### 访问信息

- 服务地址：http://127.0.0.1:8000
- 管理员账号：`admin` / `admin123`

## 已实现模块

- **认证管理** — 用户登录/登出、JWT令牌、修改密码
- **用户管理** — 用户增删改查、角色分配
- **权限管理** — RBAC角色权限控制
- **库存管理** — 产品管理、仓库管理、入库/出库、库存查询

## 项目结构

```
hierp/
├── backend/                # 后端代码
│   ├── app/
│   │   ├── api/v1/         # API路由
│   │   ├── core/           # 核心配置（安全、日志、常量）
│   │   ├── models/         # 数据库模型
│   │   ├── schemas/        # Pydantic Schema
│   │   ├── services/       # 业务服务层
│   │   └── utils/          # 工具函数
│   └── tests/              # 测试用例
├── frontend/
│   ├── templates/          # Jinja2模板
│   └── static/             # 静态资源
├── docs/                   # 项目文档
├── setup.sh                # 环境初始化脚本
├── start.sh                # 启动服务脚本
└── test.sh                 # 测试运行脚本
```