websoft9dev/webox-base repository overview

api-service/
├── main.go                 # 应用程序入口点
├── go.mod                  # Go模块依赖管理
├── go.sum                  # Go模块校验和
├── Makefile               # 构建和开发工具
├── Dockerfile             # Docker容器构建文件
├── test_api.sh            # API测试脚本
├── cmd/                   # 命令行工具
│   └── server/           # 服务器启动命令
├── configs/              # 配置文件目录
│   └── config.yaml       # 主配置文件
├── data/                 # 数据存储目录
├── docs/                 # 文档目录
│   └── i18n-standardization.md
├── internal/             # 内部应用代码(不对外暴露)
│   ├── config/          # 配置管理
│   ├── constants/       # 常量定义
│   ├── controller/      # HTTP控制器层
│   │   ├── user.go     # 用户相关API
│   │   └── i18n.go     # 国际化API
│   ├── dto/            # 数据传输对象
│   │   ├── common.go   # 通用DTO
│   │   ├── request/    # 请求DTO
│   │   └── response/   # 响应DTO
│   ├── interface/      # 接口定义(依赖倒置)
│   │   ├── repository/ # 存储层接口
│   │   └── service/    # 服务层接口
│   ├── middleware/     # 中间件
│   │   ├── auth.go    # JWT认证中间件
│   │   ├── cors.go    # 跨域中间件
│   │   ├── error.go   # 错误处理中间件
│   │   ├── i18n.go    # 国际化中间件
│   │   └── logger.go  # 日志中间件
│   ├── model/         # 数据模型定义
│   ├── repository/    # 数据访问层实现
│   ├── router/        # 路由配置
│   └── service/       # 业务逻辑层实现
├── pkg/                  # 可复用的公共包
│   ├── auth/            # JWT认证工具
│   ├── errors/          # 统一错误处理
│   │   ├── codes.go    # 错误码定义
│   │   ├── errors.go   # 错误类型定义
│   │   └── handler.go  # 错误处理器
│   ├── i18n/           # 国际化支持
│   │   └── locales/    # 多语言文件
│   ├── logger/         # 结构化日志
│   ├── response/       # 统一响应格式
│   ├── utils/          # 工具函数
│   └── validator/      # 参数验证
└── scripts/            # 工具脚本

┌─────────────────┐
│   Controller    │ ← HTTP请求处理，参数验证，响应格式化
├─────────────────┤
│    Service      │ ← 业务逻辑处理，数据转换，规则验证
├─────────────────┤
│   Repository    │ ← 数据访问抽象，查询封装，事务管理
├─────────────────┤
│     Model       │ ← 数据模型定义，数据库映射
└─────────────────┘

Client ──HTTP──> API Service ──gRPC──> Websoft9 Agent
   │                  │                       │
   │                  │                       │
   └──WebSocket───────┘                       │
                      │                       │
                   Database              Docker Engine
                   (SQLite)              System Commands