robotech 0.3.0

Backend service implementation for the RoboTech platform, providing RESTful APIs and business logic for web applications.
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

# RoboTech-RS

[中文](README_zh.md)

RoboTech-RS is a backend service toolkit written in Rust. This project provides commonly used tools for RESTful controller layer and business logic layer.

## Project Structure

This project organizes functional modules through Rust's feature flags mechanism:

- `api` feature (enabled by default): Contains API interfaces and data transfer objects, providing a unified response object (RO) structure
- `svr` feature: Implements server-side business logic, including controller (ctrl), service (svc), and constant (cst) modules

## Tech Stack

- Rust 2024 edition
- Actix-web as Web framework (in svr feature)
- SeaORM as database ORM (in svr feature)
- Utoipa for OpenAPI documentation generation (in api feature)
- Serde for serialization/deserialization (in api feature)
- Chrono for time processing (in api feature)

## Feature Flags

This project uses feature flags to control dependencies and functionality:

- `api` (default): Enables API-related features, including response objects (RO) and data transfer
- `svr`: Enables server-side features, including controllers, services, and database operations

The `api` feature is enabled by default. To use server-side features, you can enable both features:

```toml
[dependencies.robotech]
version = "0.1.0"
features = ["api", "svr"]
```

## API Response Format

This project adopts a unified response format, where all API responses follow this structure:

- `result`: Response result (Success, IllegalArgument, Warn, Fail)
- `msg`: Response message
- `timestamp`: Timestamp
- `extra`: Optional extra data
- `detail`: Optional detailed information
- `code`: Optional business code

## Quick Start

### Prerequisites

- Rust 1.70 or higher
- PostgreSQL database (if using SeaORM)

### Build Project

```bash
# Build with default features (api)
cargo build

# Build with all features
cargo build --features api,svr
```

### Run Service

```bash
# Run service (requires svr feature)
cargo run --features svr
```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.