Costrict-Web

AI Agent 平台，整合 Casdoor 的组织管理能力和 buildwithclaude 的技能市场功能。

技术栈

• 前端: Next.js 16 + React 19 + TypeScript + Tailwind CSS
• 后端: Go + Gin + GORM
• 认证: Casdoor (OAuth 2.0)
• 数据库: PostgreSQL + GORM
• 容器化: Docker + Docker Compose

项目结构

costrict-web/
├── server/           # Go 后端服务
│   ├── internal/
│   │   ├── config/      # 配置管理
│   │   ├── database/    # 数据库连接
│   │   ├── handlers/    # HTTP 处理器
│   │   └── middleware/  # 中间件
│   ├── main.go       # 应用入口
│   └── Dockerfile    # 后端 Docker 镜像
├── web/             # 前端应用（buildwithclaude）
│   ├── web-ui/       # Next.js 前端应用
│   ├── plugins/       # 插件资源
│   ├── scripts/       # 构建脚本
│   └── tests/         # 测试文件
├── docker-compose.yml # Docker Compose 配置
├── package.json     # 根目录脚本
└── .env.example    # 环境变量示例

快速开始

开发模式（推荐）

开发模式下，前端和后端在本地运行，只有 PostgreSQL 和 Casdoor 使用容器。

启动基础服务

# 启动 PostgreSQL 和 Casdoor
podman-compose up -d

# 或使用 Docker
docker-compose up -d

前端开发

# 进入前端目录
cd web/web-ui

# 安装依赖
npm install

# 启动开发服务器
npm run dev

后端开发

cd server

# 安装依赖
go mod tidy

# 运行应用
go run main.go

同时启动前后端

# 安装根目录依赖
npm install

# 同时启动前后端
npm run dev

生产部署

使用 Docker 或 Podman

注意：本项目同时支持 Docker 和 Podman。

使用 Docker

在 Windows 上运行 Docker 需要管理员权限。

# 启动所有服务（PostgreSQL, Casdoor, Go 后端, Next.js 前端）
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止所有服务
docker-compose down

# 清理所有数据（包括数据库）
docker-compose down -v

使用 Podman

Podman 使用 rootless 模式，不需要管理员权限。

# 启动所有服务
podman-compose up -d

# 查看日志
podman-compose logs -f

# 停止所有服务
podman-compose down

# 清理所有数据（包括数据库）
podman-compose down -v

注意：

• docker-compose.yml 文件格式与 Podman Compose 兼容
• 卷挂载路径已针对 Podman 进行优化

服务端口

• 前端: http://localhost:3000
• 后端 API: http://localhost:8080
• Casdoor: http://localhost:8000
• PostgreSQL: localhost:5432

文档

• 系统设计文档
• 开发进度

参考项目

• buildwithclaude - Claude 技能市场参考实现（submodule，可跟踪上游更新）

许可证

MIT