feat: add critical slot positions and shots-per-ton to API

Add `slots` field to LoadoutEntry (1-indexed critical slot positions from
MTF location sections) and `shotsPerTon` field to Equipment (ammo rounds
per ton). Both nullable for backward compatibility.

Scraper now parses per-slot placement from MTF files instead of
aggregating by quantity. Equipment seed extended with 57 ammo types.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: graylikeme

…96705dd670443c50fc31ac4d12760504db5.json …0549f382c45b7c687f17a20a662ab2930bf.json.sqlx/query-555c8ed119971815050920c16e49c96705dd670443c50fc31ac4d12760504db5.json renamed to .sqlx/query-bb0f4db64be3de8427bde03de5d6d0549f382c45b7c687f17a20a662ab2930bf.json .sqlx/query-555c8ed119971815050920c16e49c96705dd670443c50fc31ac4d12760504db5.json renamed to .sqlx/query-bb0f4db64be3de8427bde03de5d6d0549f382c45b7c687f17a20a662ab2930bf.json

@@ -5,7 +5,7 @@ A GraphQL API serving BattleTech unit, equipment, faction, and era data sourced
 ## Stack
 
 - **API:** Rust · axum 0.8 · async-graphql 7 · sqlx 0.8 · PostgreSQL 16
-- **Scraper:** imports from MegaMek unit files (MTF + BLK formats), the Master Unit List (BV, roles, availability, clan names), and equipment stats seed data
+- **Scraper:** imports from MegaMek unit files (MTF + BLK formats) including per-slot critical hit tables, the Master Unit List (BV, roles, availability, clan names), and equipment stats seed data (including ammo shots-per-ton)
 - **Ops:** Prometheus metrics at `/metrics`, Dockerfile (musl/Alpine), IP rate limiting
 
 ## Quick start

README.md

@@ -10,7 +10,7 @@ pub async fn get_by_slug(pool: &PgPool, slug: &str) -> Result<Option<DbEquipment
                   tonnage, crits, damage, heat,
                   range_min, range_short, range_medium, range_long, bv, intro_year,
                   source_book, description,
-                  observed_locations, ammo_for_id, stats_source,
+                  observed_locations, ammo_for_id, stats_source, shots_per_ton,
                   NULL::bigint AS total_count
            FROM equipment WHERE slug = $1"#,
     )
@@ -60,7 +60,7 @@ pub async fn search(
                   rules_level::text AS rules_level, tonnage, crits, damage, heat,
                   range_min, range_short, range_medium, range_long, bv, intro_year,
                   source_book, description,
-                  observed_locations, ammo_for_id, stats_source,
+                  observed_locations, ammo_for_id, stats_source, shots_per_ton,
                   COUNT(*) OVER() AS total_count
            FROM equipment WHERE TRUE"#,
     );

crates/api/src/db/equipment.rs

@@ -113,6 +113,7 @@ pub struct DbEquipment {
     pub observed_locations: Option<Vec<String>>,
     pub ammo_for_id: Option<i32>,
     pub stats_source: Option<String>,
+    pub shots_per_ton: Option<i32>,
     pub total_count: Option<i64>,
 }
 
@@ -135,6 +136,7 @@ pub struct DbLoadoutEntry {
     pub quantity: i32,
     pub is_rear_facing: bool,
     pub notes: Option<String>,
+    pub slots: Option<Vec<i32>>,
     // Joined from equipment
     pub equipment_slug: String,
     pub equipment_name: String,

crates/api/src/db/models.rs

@@ -310,7 +310,7 @@ pub async fn get_loadout(pool: &PgPool, unit_id: i32) -> Result<Vec<DbLoadoutEnt
         DbLoadoutEntry,
         r#"SELECT ul.id, ul.unit_id, ul.equipment_id,
                   ul.location::text AS location,
-                  ul.quantity, ul.is_rear_facing, ul.notes,
+                  ul.quantity, ul.is_rear_facing, ul.notes, ul.slots,
                   e.slug AS equipment_slug, e.name AS equipment_name
            FROM unit_loadout ul
            JOIN equipment e ON e.id = ul.equipment_id

crates/api/src/db/units.rs

@@ -47,7 +47,7 @@ impl Loader<i32> for AmmoForLoader {
                       tonnage, crits, damage, heat,
                       range_min, range_short, range_medium, range_long, bv, intro_year,
                       source_book, description,
-                      observed_locations, ammo_for_id, stats_source,
+                      observed_locations, ammo_for_id, stats_source, shots_per_ton,
                       NULL::bigint AS total_count
                FROM equipment WHERE id = ANY($1)"#,
         )
@@ -79,7 +79,7 @@ impl Loader<i32> for AmmoTypesLoader {
                       tonnage, crits, damage, heat,
                       range_min, range_short, range_medium, range_long, bv, intro_year,
                       source_book, description,
-                      observed_locations, ammo_for_id, stats_source,
+                      observed_locations, ammo_for_id, stats_source, shots_per_ton,
                       NULL::bigint AS total_count
                FROM equipment WHERE ammo_for_id = ANY($1)
                ORDER BY name"#,

crates/api/src/graphql/loaders.rs

@@ -115,6 +115,11 @@ impl EquipmentGql {
         self.0.stats_source.as_deref()
     }
 
+    /// Number of rounds of ammunition per ton. Null for non-ammo equipment.
+    async fn shots_per_ton(&self) -> Option<i32> {
+        self.0.shots_per_ton
+    }
+
     /// The weapon this ammo is compatible with. Null for non-ammo equipment.
     #[graphql(complexity = 3)]
     async fn ammo_for(&self, ctx: &Context<'_>) -> Result<Option<EquipmentGql>, AppError> {

crates/api/src/graphql/types/equipment.rs

@@ -64,6 +64,10 @@ pub struct LoadoutEntryGql {
     pub is_rear_facing: bool,
     /// Additional notes about this loadout entry, if any.
     pub notes: Option<String>,
+    /// 1-indexed critical slot positions this equipment occupies within its location.
+    /// For example, a 5-crit LRM 20 starting at slot 4 would be [4, 5, 6, 7, 8].
+    /// Null for non-mech units or legacy data without slot information.
+    pub slots: Option<Vec<i32>>,
 }
 
 // ── Unit Chassis ───────────────────────────────────────────────────────────
@@ -452,6 +456,7 @@ impl UnitGql {
                 quantity: e.quantity,
                 is_rear_facing: e.is_rear_facing,
                 notes: e.notes,
+                slots: e.slots,
             })
             .collect())
     }

crates/api/src/graphql/types/unit.rs

@@ -31,6 +31,8 @@ GET {base_url}/schema.graphql
 - **Tonnage**: weight in metric tons (20–100 for mechs, up to 500,000+ for jumpships)
 - **Range values**: measured in tabletop hexes
 - **Crits**: number of critical hit slots an equipment item occupies
+- **Slots**: 1-indexed critical slot positions within a location. For a 5-crit weapon starting at slot 4: `[4, 5, 6, 7, 8]`. Null for non-mech units or legacy data. Slot numbers may have gaps where structural components (actuators, engine, gyro) occupy slots
+- **Shots per ton** (`shotsPerTon`): number of rounds of ammunition per ton of ammo. Standard BattleTech values (e.g. AC/20 ammo = 5, SRM-2 ammo = 50). Null for non-ammo equipment
 - **Resolved component types**: `mechData` provides both raw MegaMek strings (e.g. `engineTypeRaw`) and resolved references (e.g. `engine`) with full construction properties (weight multipliers, crit slots, etc.)
 - **Construction reference**: prescriptive data for unit builders — component types with weights, crit slots, and rules; engine weight table; internal structure table
 
@@ -129,6 +131,7 @@ To paginate: pass `endCursor` from the previous response as `after` in the next
       location
       quantity
       isRearFacing
+      slots
     }}
     locations {{
       location
@@ -315,6 +318,7 @@ To paginate: pass `endCursor` from the previous response as `after` in the next
       name
       tonnage
       bv
+      shotsPerTon
     }}
   }}
 }}

crates/api/src/handlers/llms_txt.rs

@@ -233,15 +233,16 @@ pub async fn replace_loadout(
 
         sqlx::query(
             r#"
-            INSERT INTO unit_loadout (unit_id, equipment_id, location, quantity, is_rear_facing)
-            VALUES ($1, $2, $3::location_name_enum, $4, $5)
+            INSERT INTO unit_loadout (unit_id, equipment_id, location, quantity, is_rear_facing, slots)
+            VALUES ($1, $2, $3::location_name_enum, $4, $5, $6)
             "#,
         )
         .bind(unit_id)
         .bind(eq_id)
         .bind(entry.location)   // Option<&'static str> → cast to enum in SQL
         .bind(entry.quantity)
         .bind(entry.is_rear)    // is_rear_facing column
+        .bind(entry.slots.as_deref()) // Option<&[i32]> → INTEGER[]
         .execute(pool)
         .await
         .with_context(|| format!("insert loadout entry {} for unit {unit_id}", entry.equipment))?;