# rs-mams

**Repository Path**: micro-applet/rs-mams

## Basic Information

- **Project Name**: rs-mams
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-09
- **Last Updated**: 2025-06-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# rs-mams

这是一个基于 Rust 的项目，主要用于提供与微信应用相关的功能，包括获取访问令牌、消息加解密等。该项目使用 Actix Web 框架构建服务，并通过 Docker 容器化部署。

## 目录结构

- `src/`：主程序源码目录，包含服务器、日志、处理函数等模块。
- `wx/wx_app/`：微信应用相关功能，如获取访问令牌、错误处理等。
- `wx/wx_official/`：微信官方账号相关功能，包括消息加解密、回调处理等。
- `Dockerfile`：Docker 配置文件，用于构建镜像。
- `local.sh` / `remote.sh`：脚本文件，用于配置环境变量和启动应用。
- `log4rs.yml`：日志配置文件。

## 功能模块

### 微信应用模块 (`wx/wx_app`)

- **访问令牌**：提供获取微信应用访问令牌的功能。
- **错误处理**：定义了统一的错误类型 `WeChatError`，支持多种错误构造方式。
- **宏定义**：提供日志、计时、错误处理等实用宏。

### 微信官方账号模块 (`wx/wx_official`)

- **消息加解密**：提供 AES 加密和解密功能，支持微信官方账号的消息安全传输。
- **回调处理**：实现微信官方账号的 GET 和 POST 回调接口。
- **消息结构体**：定义了微信官方账号回调参数和消息结构。

## 服务启动

项目使用 Actix Web 框架构建服务，主函数位于 `src/main.rs`，服务启动逻辑在 `src/server.rs` 中定义。

## 日志系统

项目集成了自定义日志系统，使用 `src/logger.rs` 中的 `TraceSpanBuilder` 来记录请求的生命周期信息。

## Docker 部署

项目可以通过 Docker 部署，使用 `Dockerfile` 构建镜像并运行服务。服务监听端口为 `10001`。

## 使用说明

1. **构建项目**：使用 `cargo build` 构建项目。
2. **运行服务**：使用 `cargo run` 或通过 Docker 启动服务。
3. **访问接口**：根据需要访问相应的 API 接口，如 `/cgi-bin/token` 获取访问令牌。

## 脚本说明

- `local.sh`：本地开发环境配置脚本。
- `remote.sh`：生产环境或远程部署配置脚本。

## 许可证

本项目遵循 MIT 许可证，请参见 `LICENSE` 文件。