idcu-go 组织介绍

一句话定位

idcu-go 是一个 Go 通用模块组织，为多个业务项目沉淀并统一可复用的 Go 能力，避免每个系统重复造轮子、各写一套轮子。

我们为什么存在

越是常见的需求，越容易被塞进各自项目里，于是相同的能力被反复实现、行为各异、维护分散。idcu-go 把这些通用能力抽出来，统一命名与约定，供整个组织复用。模块面向通用场景设计，不预设某个系统是唯一用户；业务通过 adapter 接入即可，公共模块不感知业务。

模块体系

组织按三层组织仓库：

• 基础设施：transport（上报客户端）、server-core（服务端会话/心跳/配置/拓扑）、monitor（探测状态机）、agent-core（探针上报适配）、retry（指数退避重试）、idgen（UUID/节点标识）、notify（多渠道告警）、cfgutil（配置热更新）、sqlstore（无 cgo 本地存储）、kvstore/kvlease/kvsync（可插拔 KV 会话与锁）。
• 能力引擎：统一身份 identity、空间占用 space、在场状态 presence、通用账户 wallet、支付渠道 payment、可配置计费 billing、收费台/交易终端 paypoint、进出控制 access。
• 收敛原语：跨节点收敛 versionvector、发件箱 outbox、限流 ratelimit、幂等守卫 idempotency。

设计约定

• 中立入库：任一模块必须至少两个不同领域跑通才进入组织，禁止为一个系统量身定做。
• 中性命名：类型与字段用通用语汇，不出现任何系统的领域术语。
• 接线适配：业务项目通过 adapter 接入，公共模块保持零领域依赖。
• 统一标准：命名、错误模型、配置、可观测性、测试、CI、文档、版本在所有仓库统一，见 standards/module-standard.md。

谁在使用

基于 idcu-go 构建的第一个应用是 realtime-ping（对目标做持续探测与状态监控），用以验证共性能力在真实业务上能用、够用。停车管理平台是后续应用之一，复用基础设施底座，并以能力引擎组合出计费、支付、收费台与进出控制。门禁道闸、充电桩、共享空间等场景后续以同一套标准打包与消费，任何 Go 业务项目都可接入。

接入与协作

• 统一托管于 Gitee（org idcu-go），CI、镜像与依赖统一走 Gitee，契约变更经 review 与版本化发布。
• 新能力先在业务里写好接线用例，证明中立且双领域可复用，再进入组织落地。
• 欢迎通过 Issue 提出能力缺口或使用反馈；变更以 PR 提交，通过 idcu-alignment 编译期对齐校验后合入，按语义化版本发布。

仓库地址

• 组织：https://gitee.com/idcu-go
• 信息中枢（本仓库）：https://gitee.com/idcu-go/meta