docs: add struct field documentation and fix semantic issues

internal/handlers/handlers.go

@@ -892,6 +892,24 @@ func (s *Service) LogProjectileEvent(data []string) (model.ProjectileEvent, erro
 		}
 	}
 
+	// [17] sim - simulation type (optional, may not be present in older data)
+	if len(data) > 17 {
+		projectileEvent.SimulationType = data[17]
+	}
+
+	// [18] isSub - is submunition (optional)
+	if len(data) > 18 {
+		isSub, err := strconv.ParseBool(data[18])
+		if err == nil {
+			projectileEvent.IsSubmunition = isSub
+		}
+	}
+
+	// [19] magazineIcon - magazine icon path (optional)
+	if len(data) > 19 {
+		projectileEvent.MagazineIcon = data[19]
+	}
+
 	return projectileEvent, nil
 }
 
@@ -1361,11 +1379,11 @@ func (s *Service) LogAce3UnconsciousEvent(data []string) (model.Ace3UnconsciousE
 	}
 	unconsciousEvent.SoldierObjectID = uint16(ocapID)
 
-	isAwake, err := strconv.ParseBool(data[2])
+	isUnconscious, err := strconv.ParseBool(data[2])
 	if err != nil {
-		return unconsciousEvent, fmt.Errorf(`error converting isAwake to bool: %v`, err)
+		return unconsciousEvent, fmt.Errorf(`error converting isUnconscious to bool: %v`, err)
 	}
-	unconsciousEvent.IsAwake = isAwake
+	unconsciousEvent.IsUnconscious = isUnconscious
 
 	return unconsciousEvent, nil
 }

internal/model/convert/convert.go

@@ -324,12 +324,12 @@ func Ace3DeathEventToCore(e model.Ace3DeathEvent) core.Ace3DeathEvent {
 // Ace3UnconsciousEventToCore converts a GORM Ace3UnconsciousEvent to a core.Ace3UnconsciousEvent
 func Ace3UnconsciousEventToCore(e model.Ace3UnconsciousEvent) core.Ace3UnconsciousEvent {
 	return core.Ace3UnconsciousEvent{
-		ID:           e.ID,
+		ID:            e.ID,
 		MissionID:    e.MissionID,
 		SoldierID:    uint(e.SoldierObjectID), // ObjectID -> uint for core model
 		Time:         e.Time,
 		CaptureFrame: e.CaptureFrame,
-		IsAwake:      e.IsAwake,
+		IsUnconscious: e.IsUnconscious,
 	}
 }
 

internal/model/convert/convert_test.go

@@ -551,21 +551,21 @@ func TestAce3UnconsciousEventToCore(t *testing.T) {
 	now := time.Now()
 
 	gormEvent := model.Ace3UnconsciousEvent{
-		ID:            1,
-		MissionID:     1,
+		ID:              1,
+		MissionID:       1,
 		SoldierObjectID: 5,
-		Time:          now,
-		CaptureFrame:  100,
-		IsAwake:       false,
+		Time:            now,
+		CaptureFrame:    100,
+		IsUnconscious:   true, // Unit went unconscious
 	}
 
 	coreEvent := Ace3UnconsciousEventToCore(gormEvent)
 
 	if coreEvent.SoldierID != 5 {
 		t.Errorf("expected SoldierID=5, got %d", coreEvent.SoldierID)
 	}
-	if coreEvent.IsAwake {
-		t.Error("expected IsAwake=false")
+	if !coreEvent.IsUnconscious {
+		t.Error("expected IsUnconscious=true")
 	}
 }
 

internal/model/core/events.go

@@ -109,12 +109,12 @@ type Ace3DeathEvent struct {
 
 // Ace3UnconsciousEvent represents ACE3 unconscious state change
 type Ace3UnconsciousEvent struct {
-	ID           uint
-	MissionID    uint
-	SoldierID    uint
-	Time         time.Time
-	CaptureFrame uint
-	IsAwake      bool
+	ID            uint
+	MissionID     uint
+	SoldierID     uint
+	Time          time.Time
+	CaptureFrame  uint
+	IsUnconscious bool // true = went unconscious, false = regained consciousness
 }
 
 // TimeState represents mission time synchronization data