lab-resource-manager 1.1.0

GPU and room resource management system with Google Calendar and Slack integration
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

# lab-resource-manager

[![Crates.io](https://img.shields.io/crates/v/lab-resource-manager)](https://crates.io/crates/lab-resource-manager)
[![Documentation](https://docs.rs/lab-resource-manager/badge.svg)](https://docs.rs/lab-resource-manager)
[![License](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue)](README.md#license)

A resource reservation management system for laboratories.

[日本語 README](README_ja.md)

## Overview

- **Resource Reservation Management**: Manage schedules for resources such as GPU servers and rooms
- **Change Notifications**: Get notified when reservations are created, updated, or deleted
- **Identity Linking**: Map user identities across different systems for enhanced notifications

### Default Implementations

| Component | Implementation |
|-----------|----------------|
| Resource Repository | Google Calendar |
| Notifications | Slack |
| User Interface | Slack Bot |
| Access Control | Google Calendar ACL |

## Quick Start

- **Users**: See [User Guide](docs/USER_GUIDE.md)
- **Administrators**: See [Admin Guide](docs/ADMIN_GUIDE.md)

## Architecture

This project follows Clean Architecture (DDD + Hexagonal Architecture):

```text
src/
├── domain/                  # Domain layer (business logic)
│   ├── aggregates/          # Aggregates (ResourceUsage, IdentityLink)
│   ├── common/              # Shared Kernel (EmailAddress, etc.)
│   ├── ports/               # Ports (Repository, Notifier traits)
│   └── errors.rs            # Domain errors
├── application/             # Application layer (use cases)
│   └── usecases/            # Notify, GrantAccess use cases
├── infrastructure/          # Infrastructure layer (implementations)
│   ├── repositories/        # Repository implementations
│   ├── notifier/            # Notification implementations
│   ├── resource_collection_access/  # Access control implementations
│   └── config/              # Configuration management
├── interface/               # Interface layer
│   └── slack/               # Slack bot interface
└── bin/
    └── lab-resource-manager.rs  # Entry point
```

## Development

### Prerequisites

- Rust 1.90+

### Build & Test

```bash
cargo build
cargo test
cargo fmt
cargo clippy
```

## Roadmap

- [x] Resource-based notification routing
- [x] Identity Linking
- [x] Access management interface
- [x] Reservation creation via Slack commands
- [ ] Natural language resource management (LLM agent)

## License

Licensed under either of

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or <http://opensource.org/licenses/MIT>)

at your option.

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.