From 41cadbebee6b791181b42fc57a42a13fd2aed70a Mon Sep 17 00:00:00 2001
From: Ilia Denisov <ilia.denissov@gmail.com>
Date: Fri, 13 Feb 2026 09:32:51 +0200
Subject: [PATCH] docs: add todos

---
 internal/controller/command.go    | 13 +++++++++++++
 internal/controller/ship_group.go |  8 ++++++++
 internal/util/string.go           |  2 +-
 3 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/internal/controller/command.go b/internal/controller/command.go
index 287a381..c546f93 100644
--- a/internal/controller/command.go
+++ b/internal/controller/command.go
@@ -1,5 +1,18 @@
 package controller
 
+/*
+TODO: Препроцессинг и сохранение приказов
+
+Когда приказ (последовательность команд) поступает на сервер, игрок получает
+уведомление о том, что его команды приняты к производству. Каждая команда из
+приказа проверяется на корректность и получает отдельное подтверждение. Игрок
+может послать любое количество приказов по своему усмотрению, однако, каждый
+новый приказ отменяет предыдущий. Таким образом, можно исправить неверно
+составленный приказ, но при этом необходимо повторить те команды, которые
+были отданы верно. К счастью, программа-клиент помогает игроку не запутаться
+в этом процессе и берёт на себя контроль за целостностью приказов.
+*/
+
 import (
 	"strings"
 
diff --git a/internal/controller/ship_group.go b/internal/controller/ship_group.go
index 72b76ab..1bea4c7 100644
--- a/internal/controller/ship_group.go
+++ b/internal/controller/ship_group.go
@@ -510,6 +510,14 @@ func (c *Cache) validateShipGroupIndex(i int) {
 	}
 }
 
+/*
+TODO: Точность тех. уровней корабля
+
+В целях избежания неточностей в расчетах, технологические уровни кораблей
+округляются до третьего знака после запятой в момент постройки или
+модернизации. Поэтому в отчетах у кораблей всегда указываются действительные,
+а не округлённые уровни технологий.
+*/
 func (c *Cache) unsafeCreateShips(ri int, classID uuid.UUID, planet uint, quantity uint) {
 	c.appendShipGroup(ri, &game.ShipGroup{
 		OwnerID:     c.g.Race[ri].ID,
diff --git a/internal/util/string.go b/internal/util/string.go
index 407ffcc..ff467b5 100644
--- a/internal/util/string.go
+++ b/internal/util/string.go
@@ -6,7 +6,7 @@ import (
 )
 
 /*
-TODO:
+TODO: валидация имён
 
 Произвольные наименования, выбираемые игроком, могут иметь классы кораблей,
 планеты, флоты и науки. Имена не могут быть длиннее 30 символов. Символы