# app-server

**Repository Path**: heralink/app-server

## Basic Information

- **Project Name**: app-server
- **Description**: Heralink app example Go backend service
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-14
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Demo 后端

Demo 后端是第三方开发者接入 GO Message 平台的参考实现。

## 快速启动

```bash
cd demo/backend
go mod tidy
go run .
```

或者双击 `start.bat`（Windows）。

## 配置

编辑 `config.yaml`，主要配置项：

| 配置 | 默认值 | 说明 |
|------|--------|------|
| `server.port` | `9090` | HTTP 端口 |
| `app.id` | `demo_app` | 平台分配的 AppID |
| `app.api_key` | `demo_key` | API 密钥 |
| `app.secret` | `demo_secret` | 签名密钥 |
| `app.ws_url` | `ws://localhost:8181/ws` | 平台 WebSocket 地址 |
...
| `storage.type` | `memory` | 存储类型：`memory` / `mysql` / `sqlite` |

## 存储模式

### 内存存储（默认）

```yaml
storage:
  type: "memory"
```
无需任何依赖，重启后数据丢失。适合开发和测试。

### MySQL 存储

需要先创建数据库：
```sql
CREATE DATABASE IF NOT EXISTS heralink_demo CHARACTER SET utf8mb4;
```

```yaml
storage:
  type: "mysql"
mysql:
  host: "127.0.0.1"
  port: 3307
  database: "heralink_demo"
  username: "root"
  password: "root"
```

### SQLite 存储

当前构建中 SQLite 驱动未启用。如需使用，需在 `database.go` 中添加 `gorm.io/driver/sqlite` 依赖。

## 内置账号

启动后自动创建以下测试账号：

| 用户ID | 昵称 | 密码 |
|--------|------|------|
| admin | 管理员 | 123456 |
| user1 | 用户一 | 123456 |
| user2 | 用户二 | 123456 |

管理员账号（用于 Demo 管理后台）：

| 用户名 | 密码 | 角色 |
|--------|------|------|
| admin | 123456 | super |

## 消息与频道

App Server 负责用户、好友、群组、房间、主题和消息持久化，并通过 SDK 将消息转发到 Heralink Platform。

- 单聊使用 `to_id`。
- 群聊使用 `group_id`，发送时向群成员推送。
- 房间使用 `room_id`，可附带 `faction_id`。
- 主题使用 `topic_id`，向订阅者推送。
- 前端统一在 `/chat` 页面展示这些类型的消息；管理页面只负责管理数据。

消息历史接口为 `GET /app-api/message/history`，支持 `to_id`、`group_id`、`room_id` 和 `topic_id` 查询。

## 依赖

- Go 1.25+
- 平台后端 `:8180`（如果连接平台功能需要）
- MySQL（如果使用 MySQL 存储）

---

**作者**: yichen · **邮箱**: 2782268022@qq.com · **技术交流 Q 群**: 714566447