货物物流操作人员管理系统（cloud-lucky）- 用于跟踪和管理物流订单的各个环节

本软件仅限个人学习、研究和非商业用途使用。任何商业使用行为均属禁止。

1. 个人使用：允许个人用户免费使用本软件进行学习、练习和技术研究
2. 禁止商用：严禁将本软件用于任何商业目的，包括但不限于：
   • 企业内部使用
   • 对外提供服务
   • 二次开发后销售
   • 集成到商业产品中
   • 以任何形式获取经济利益

1. 如用户违反本协议将软件用于商业用途，开发者保留追究法律责任的权利
2. 用户需承担因商业使用造成的所有法律责任和经济损失
3. 开发者有权要求违规使用者停止使用并赔偿损失

本软件著作权归开发者所有，保留一切未明确授予的权利。

---

• 📦 订单全流程管理（订舱、建档、放舱、拖车、截单、报关、VGM、舱单、账单、放单）
• 🎨 可视化进度跟踪（颜色区分完成状态）
• 👥 责任方区分（我方/客户操作）
• 📤 一键导出订单数据
• 📝 订单备注和详情编辑
• 🔐 用户认证与权限管理
• 📊 数据可视化看板
• 🚀 支持Docker一键部署

• Docker 和 Docker Compose（推荐）
• 或：Go 1.19+、Node.js 18+、npm

# 克隆项目
git clone <repository-url>
cd cloud-lucky

# 直接拉取制品镜像运行
docker compose -f docker-compose.pull.yml up -d

# 查看日志
docker compose -f docker-compose.pull.yml logs -f

服务启动后：

• 前端：http://localhost:86
• 后端：http://localhost:85

# 克隆项目
git clone <repository-url>
cd cloud-lucky

# 本地构建并启动
make docker-up
# 或: docker compose up -d --build

服务启动后：

• 前端：http://localhost
• 后端：http://localhost/api

# 安装依赖
make install

# 启动开发环境
make dev

服务启动后：

• 前端：http://localhost:5173
• 后端：http://localhost:8081

首次部署/首次启动时没有默认管理员账号，系统会引导创建管理员账号：

• 打开前端后会自动跳转到初始化页面（/init）
• 按页面提示创建管理员账号后即可正常登录

查看 DEPLOYMENT.md 了解更多部署选项。

• 前端: Vue 3 + TypeScript + Vite + Element Plus
• 后端: Go + Gin + GORM
• 数据库: SQLite（文件存储）
• 部署: Docker + Docker Compose

├── backend/           # Go后端代码
├── frontend/          # Vue前端代码
├── docker-compose.yml # Docker配置
├── Makefile          # 自动化命令
└── docs/             # 详细文档
    ├── DEPLOYMENT.md # 部署指南
    └── DEVELOPMENT.md # 开发文档

• 部署指南 - 详细部署说明
• 开发文档 - API接口、目录结构、开发规范
• 数据库配置 - 数据库设置（可选）

重要提醒：本项目仅限个人学习、研究和非商业用途。详细条款请参见开头的用户协议与免责声明部分。

使用本软件即表示您同意遵守上述协议条款。

本项目采用 个人学习许可协议，详细条款请参见开头的用户协议与免责声明部分。

重要提醒：使用本软件即表示您同意遵守上述协议条款。如有任何疑问，请联系作者。