electricity_bill_calc_service/Readme.md

转供电电费服务项目（后端项目）

该项目为华昌宝能发布的采用众包模式承接的小型Web服务系统项目。

项目采用以下技术框架：

• Golang 1.19
• Gin
• Xorm

项目详细设计方案见详细设计方案，该设计方案未经许可，禁止私自修改。

项目任务分配与状态概览表见任务概况。

项目代码编写要点

数据库访问

项目所式的数据库框架采用的是Bun，该框架采用贴近SQL语句的数据库方式，但是在使用过程中需注意以下几点。

1. 要执行一个语句，必须提供一个context.Context类型的上下文，推荐采用context.WithTimeout()生成。上下文中携带的超时时间应该能覆盖超时时间所需要运行的全部语句。
2. 语句中用来指定操作目标数据表的Model()方法，其接受的是一个目标变量的地址，如果传入的是一个slice，那么就一定需要使用&获取其地址，如果是使用&struct{}或者new()初始化的，则可以直接作为参数传入。
3. 数据库中的时间字段都是带有时区的，但是bun中都是使用UTC时间的，对于数据库中timestamptz类型的字段，可以正常的按照数据库配置的时区保存时间，但是对于没有携带时区的date类型，就不能直接向其中传入time.Time类型的参数了，必须手工将其转化为字符串形式。
4. 使用Relation关联获取其他数据表内容的时候，被Relation()提及的数据表中配置的alias名称将不起作用，语句中的数据别名实际上是被关联字段名称的snake_case形式。
5. 需要进行嵌套Relation选择的时候，嵌套的Relation可以采用Relation("A.B")的形式来指示使用数据模型A中的Relation B。
6. 如果需要只从Relation关联数据表中选择一部分字段，不能直接在主查询语句中使用Column()方法，必须在Relation()方法的第二个参数中声明。
7. 如果需要对Relation关联表中的字段设置Where条件子句，那么就必须使用relation_name__column_name的双下划线字段选择形式，直接在Relation()方法中设定Where子句行不通。
8. 定义数据模型的时候，数据字段尽可能不要提供默认值，如果确实需要默认值，要首先考虑在数据库中定义默认值约束，其次选择使用Hook来赋予默认值。直接定义在struct tag中的默认值可能会造成bun形成查询语句时意外的空值。