# RBAC-System-Cpp

**Repository Path**: hzh5480248/RBAC-System-Cpp

## Basic Information

- **Project Name**: RBAC-System-Cpp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-17
- **Last Updated**: 2025-11-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RBAC System (C++)

A modular and extensible **Role-Based Access Control (RBAC)** system built with modern C++20. It models hierarchical permissions, custom and standard actions, and user-level overrides.

Designed with SOLID principles, this system enables flexible and fine-grained access control for applications that require complex permission logic.

---

## 📦 Features

- ✅ Standard CRUD Actions (`Create`, `Read`, `Update`, `Delete`)
- ✅ Custom Actions (e.g., `AssignRole`, `ResetPassword`)
- ✅ Hierarchical structure: `Role → PermissionGroup → Entity`
- ✅ Per-user permission overrides
- ✅ JSON-driven configuration
- ✅ Clear code separation: headers + source files
- ✅ Unit tested with GoogleTest
- ✅ CMake-based build system (Linux-first, Arch verified)

---

## 🗂 Project Structure

```
rbac-system/
├── include/                   # Header files (API, data structures)
│   ├── ActionSet.hpp
│   ├── Entity.hpp
│   ├── PermissionGroup.hpp
│   ├── Role.hpp
│   ├── Override.hpp
│   ├── Evaluator.hpp
│   └── JsonLoader.hpp
├── src/                       # Implementations
│   ├── ActionSet.cpp
│   ├── Entity.cpp
│   ├── PermissionGroup.cpp
│   ├── Role.cpp
│   ├── Override.cpp
│   ├── Evaluator.cpp
│   └── JsonLoader.cpp
├── tests/                     # GTest-based unit tests
│   └── test_permissions.cpp
├── main.cpp                   # Example usage / demo
├── CMakeLists.txt             # Build configuration
└── README.md                  # You are here
```

---

## ⚙️ Build Instructions (Linux / Arch)

1. **Install dependencies**:

```bash
sudo pacman -S cmake gtest nlohmann-json
```

2. **Build the project**:

```bash
mkdir build && cd build
cmake ..
make
```

3. **Run the demo**:

```bash
./rbac-system
```

4. **Run unit tests**:

```bash
ctest
```

---

## 🧪 Example Output

```json
{
  "standard": ["Create"],
  "custom": ["ResetPassword"]
}
```

This result shows that for the `Employees` entity, the user has a custom override granting only `Create` and `ResetPassword`, despite their default role having broader access.

---

## TODO

- [ ] Add more testing coverage

---

## 🔍 Future Improvements

- [ ] CLI tool or REST API wrapper
- [ ] Persistence layer for user/role storage
- [ ] Web-based management UI
- [ ] More comprehensive test coverage
- [ ] Permission inheritance or rule engine

---

## 🤝 Contributions

Pull requests and suggestions are welcome. If you're interested in extending this into a complete access control service, feel free to fork and evolve!

---

## 🧠 License

MIT — free to use and modify.