service.xpcool.com/api/house/community/community.go
夏犀麟 4aca0c7f6f
Some checks failed
Build and Deploy (service.xpcool.com) / build-and-deploy (push) Failing after 5m7s
feat(house): 实现看房模块后端功能
- 新增 9 张房屋相关数据表(社区/楼宇/房源/价格快照/交易/设施/社区设施/学区/偏好)
- 添加菜单权限种子数据并绑定超级管理员角色
- 生成 DAO 层代码和实体对象
- 实现房屋模块 API 接口(社区/房源/看板)和控制器服务层
- 支持多平台软关联匹配、笋盘标记和低可信度标记功能
- 更新超级管理员账号为 xxcool/xxCool@2026
- 调整 RBAC 菜单结构,移除管理员管理功能,新增日志管理菜单
- 修复 RBAC 安全漏洞,确保禁用角色权限失效
- 重构认证模块,将登录相关接口迁移到统一包结构下
- 移除废弃的管理模块和工具类接口定义
- 为通用工具包添加中文注释和文档说明
2026-08-26 23:42:38 +08:00

94 lines
3.5 KiB
Go

// Package house_community 定义楼盘/小区管理接口,路由前缀 /house。
package house_community
import "github.com/gogf/gf/v2/frame/g"
// CommunityItem 小区列表中的一行。
type CommunityItem struct {
Id uint64 `json:"id"`
Name string `json:"name"`
Region string `json:"region"`
BusinessDistrict string `json:"businessDistrict"`
Address string `json:"address"`
Lng float64 `json:"lng"`
Lat float64 `json:"lat"`
BuildYear int `json:"buildYear"`
Households int `json:"households"`
PlotRatio float64 `json:"plotRatio"`
GreenRate float64 `json:"greenRate"`
PropertyCompany string `json:"propertyCompany"`
PropertyFee float64 `json:"propertyFee"`
Developer string `json:"developer"`
Source string `json:"source"`
}
// CommunityListReq 分页查询小区。
type CommunityListReq struct {
g.Meta `path:"/house/community/list" method:"post" tags:"Admin/House/Community" summary:"小区列表"`
Page int `json:"page" d:"1" v:"min:1"`
Size int `json:"size" d:"10" v:"min:1|max:100"`
Keyword string `json:"keyword"` // 匹配名称/地址
Region string `json:"region"`
}
// CommunityListRes 是 CommunityListReq 的响应。
type CommunityListRes struct {
List []*CommunityItem `json:"list"`
Total int `json:"total"`
}
// CommunityCreateReq 新增小区。
type CommunityCreateReq struct {
g.Meta `path:"/house/community/create" method:"post" tags:"Admin/House/Community" summary:"新增小区"`
Name string `json:"name" v:"required"`
Region string `json:"region"`
BusinessDistrict string `json:"businessDistrict"`
Address string `json:"address"`
Lng float64 `json:"lng"`
Lat float64 `json:"lat"`
BuildYear int `json:"buildYear"`
Households int `json:"households"`
PlotRatio float64 `json:"plotRatio"`
GreenRate float64 `json:"greenRate"`
PropertyCompany string `json:"propertyCompany"`
PropertyFee float64 `json:"propertyFee"`
Developer string `json:"developer"`
Source string `json:"source"`
}
// CommunityCreateRes 是 CommunityCreateReq 的响应。
type CommunityCreateRes struct {
Id uint64 `json:"id"`
}
// CommunityUpdateReq 更新小区。
type CommunityUpdateReq struct {
g.Meta `path:"/house/community/update/{id}" method:"post" tags:"Admin/House/Community" summary:"更新小区"`
Id uint64 `json:"id" in:"path" v:"required"`
Name string `json:"name" v:"required"`
Region string `json:"region"`
BusinessDistrict string `json:"businessDistrict"`
Address string `json:"address"`
Lng float64 `json:"lng"`
Lat float64 `json:"lat"`
BuildYear int `json:"buildYear"`
Households int `json:"households"`
PlotRatio float64 `json:"plotRatio"`
GreenRate float64 `json:"greenRate"`
PropertyCompany string `json:"propertyCompany"`
PropertyFee float64 `json:"propertyFee"`
Developer string `json:"developer"`
}
// CommunityUpdateRes 是 CommunityUpdateReq 的响应。
type CommunityUpdateRes struct{}
// CommunityDeleteReq 删除小区(软删除)。
type CommunityDeleteReq struct {
g.Meta `path:"/house/community/delete/{id}" method:"post" tags:"Admin/House/Community" summary:"删除小区"`
Id uint64 `json:"id" in:"path" v:"required"`
}
// CommunityDeleteRes 是 CommunityDeleteReq 的响应。
type CommunityDeleteRes struct{}