Как описывать таблицу

• Одна таблица = один файл в db/schema/
• В файле:
  • TableXxx — имя таблицы
  • XxxField — поля таблицы
• Для полей можно писать короткие комментарии, если смысл неочевиден

Пример структуры

db/schema/
  conversation.go
  topic.go

Пример файла

package schema

const TableConversation = "Conversation"

const (
	ConversationKeyHash  = "KeyHash"  // хеш ключа
	ConversationHashPuid = "HashPuid" // хеш puid
	ConversationStatus   = "Status"   // статус
	ConversationSummary  = "Summary"  // краткое описание
)

Правило именования

• таблица: TableConversation
• поля: ConversationKeyHash, ConversationStatus

Главное

• использовать только const
• не смешивать несколько таблиц в одном файле
• комментарии писать только там, где реально нужны