remotestate/precium-server

Precium 酒店收益管理系统

镜像概述

Precium是一个专为酒店行业设计的收益管理系统，提供完整的API服务架构，用于处理酒店收益相关的核心业务逻辑，包括价格计算、数据管理及用户认证等功能。该系统采用模块化设计，便于维护和扩展，适合酒店运营方进行收益优化与管理。

核心功能与特性

• API服务架构：包含完整的请求处理（handlers）和路由（routes）管理
• 价格计算模块：基于乘数（Multipliers）算法实现动态价格计算
• 数据库管理：支持数据库迁移及数据模型定义
• 身份验证：内置中间件处理用户认证与会话管理
• 模块化设计：各功能模块独立划分，便于开发与维护
• 环境配置：提供实用工具处理环境变量等配置

使用场景

• 酒店日常收益管理与价格优化
• 酒店预订系统的动态定价支持
• 酒店运营数据的集中管理与分析
• 需要API服务的酒店收益相关业务集成

使用方法

本地运行与构建

运行项目

bash
make run

构建项目

bash
make build

Docker部署

构建Docker镜像

bash
docker build -t remotestate/precium-server -f Dockerfile .

运行Docker容器

bash
docker run -d --name precium-server -p 80:8091 -v ${PWD}/.env:/.env --restart always remotestate/precium-server

参数说明：

• -d：后台运行容器
• --name precium-server：指定容器名称
• -p 80:8091：端口映射（主机80端口映射到容器8091端口）
• -v ${PWD}/.env:/.env：挂载环境变量文件
• --restart always：容器退出时自动重启

文件结构说明

api

包含API处理相关的两个子目录：

1. handlers：存放所有API请求处理程序
2. routes：定义所有API处理程序的路由配置

bin

存放项目二进制文件及其他相关可执行文件

calculation

包含使用乘数（Multipliers）进行价格计算的相关文件

cmd

存放项目入口文件，即main.go

db

包含数据库相关文件，如数据库迁移脚本

global

存放可在整个项目中访问的全局文件

middlewares

存放中间件处理程序，如用于创建会话的身份验证处理程序

models

定义数据库不同关系（表）的数据模型

util

包含项目所有实用工具文件，如环境变量处理文件