# FlowGate 开发者指南

## 项目结构

```
flowgate/
├── moon.mod              # 包元数据（name=flowgate, Apache-2.0）
├── README.md             # API 参考 + 快速开始
├── GUIDE.md              # 新手指南
├── CONTRIBUTING.md       # 本文件
├── LICENSE               # Apache-2.0
└── src/
    ├── lib/
    │   ├── moon.pkg      # 依赖声明
    │   └── flowgate.mbt  # 主库源码（~250行）
    └── main/
        ├── moon.pkg
        └── main.mbt      # Demo
```

## 构建

```bash
moon check      # 编译检查
moon test       # 运行测试（5个）
moon build      # 构建
```

## 代码规范

- MoonBit 2026 语法（`assert_eq()` 新式调用，避免 `assert_eq!()`）
- 函数文档：`///|` 注释块
- 测试放在 `src/lib/` 中，用 `test "name" { }` 块

## 可贡献方向

- 令牌桶/漏桶算法实现
- 滑动窗口计数
- 分布式限流（Redis 后端）
- `release_all()` 批量释放

## 许可证

Apache-2.0