feat: improve inventory context and uex sync flow

- persist inventory view mode and density across refresh

- add org-mode banner and outline for inventory

- populate locations table after uex locations sync

- register additional seeder repositories

Author: GitAddRemote

README.md

@@ -175,6 +175,40 @@ cd frontend && pnpm dev   # Frontend only
 
 **Note**: Redis is optional. The application will fall back to in-memory caching if Redis is unavailable.
 
+### Dependency Health Check
+
+If TypeScript suddenly cannot resolve NestJS/TypeORM/Node types (missing modules, missing `lib.es6.d.ts`, or "Cannot find global type"), re-install dependencies:
+
+```bash
+pnpm install
+pnpm -C backend install
+```
+
+### Clean Reset (Local Dev)
+
+If you want a full clean reset of dependencies and data:
+
+```bash
+# Stop containers and drop volumes
+docker-compose down -v
+
+# Reinstall dependencies
+pnpm install
+
+# Rebuild packages
+pnpm build
+
+# Start infrastructure services
+docker-compose up -d
+
+# Run migrations and seed data
+pnpm --filter backend migration:run
+pnpm --filter backend seed
+
+# Start apps
+pnpm dev
+```
+
 ### Building for Production
 
 ```bash

backend/docs/uex/locations-sync.md

@@ -0,0 +1,25 @@
+# UEX Locations Sync Relationships
+
+## Overview
+
+UEX location data includes multiple parent references that are not always
+planets or moons. Station persists those relationships so sync and location
+population can resolve a valid star system and hierarchy path.
+
+## Relationships Captured
+
+- Orbits are stored in `uex_orbits` and linked to star systems.
+- Space stations can reference a planet, moon, or orbit.
+- POIs can reference a star system, planet, moon, orbit, space station, city,
+  or outpost.
+- Moons can reference either a planet or a star system directly (when
+  `id_planet` is missing but `id_star_system` is present).
+
+## Sync and Population Notes
+
+- The locations sync order includes `orbits` before planets/moons, so orbit
+  references can resolve immediately.
+- Space stations and POIs resolve their star system from orbit or related
+  entities when a direct star system ID is missing.
+- Location population prefers the most specific parent (station/city/outpost,
+  then planet/moon, then orbit, then star system) when building hierarchy paths.

backend/src/data-source.ts

@@ -17,6 +17,7 @@ import { UexItem } from './modules/uex/entities/uex-item.entity';
 import { UexCategory } from './modules/uex/entities/uex-category.entity';
 import { UexCompany } from './modules/uex/entities/uex-company.entity';
 import { UexStarSystem } from './modules/uex/entities/uex-star-system.entity';
+import { UexOrbit } from './modules/uex/entities/uex-orbit.entity';
 import { UexPlanet } from './modules/uex/entities/uex-planet.entity';
 import { UexMoon } from './modules/uex/entities/uex-moon.entity';
 import { UexSpaceStation } from './modules/uex/entities/uex-space-station.entity';
@@ -39,6 +40,8 @@ import { SeedSystemUser1764791795973 } from './migrations/1764791795973-SeedSyst
 import { CreateUexBaseTables1764802822073 } from './migrations/1764802822073-CreateUexBaseTables';
 import { CreateUexItemsTable1764802975691 } from './migrations/1764802975691-CreateUexItemsTable';
 import { CreateUexLocationTables1764803020274 } from './migrations/1764803020274-CreateUexLocationTables';
+import { CreateUexOrbitsTable1767050000000 } from './migrations/1767050000000-CreateUexOrbitsTable';
+import { AddOrbitRelationsToUexLocations1767051000000 } from './migrations/1767051000000-AddOrbitRelationsToUexLocations';
 import { AddUexSyncStateTables1764812815840 } from './migrations/1764812815840-AddUexSyncStateTables';
 import { CreateLocationsTable1764949892544 } from './migrations/1764949892544-CreateLocationsTable';
 import { CreateUserInventoryItemsTable1764950546163 } from './migrations/1764950546163-CreateUserInventoryItemsTable';
@@ -73,6 +76,7 @@ export const AppDataSource = new DataSource({
     UexCategory,
     UexCompany,
     UexStarSystem,
+    UexOrbit,
     UexPlanet,
     UexMoon,
     UexSpaceStation,
@@ -101,6 +105,8 @@ export const AppDataSource = new DataSource({
     CreateUexBaseTables1764802822073,
     CreateUexItemsTable1764802975691,
     CreateUexLocationTables1764803020274,
+    CreateUexOrbitsTable1767050000000,
+    AddOrbitRelationsToUexLocations1767051000000,
     AddUexSyncStateTables1764812815840,
 
     // Locations (depends on games + UEX tables)

backend/src/database/seeds/database-seeder.module.ts

@@ -6,6 +6,9 @@ import { Organization } from '../../modules/organizations/organization.entity';
 import { User } from '../../modules/users/user.entity';
 import { UserOrganizationRole } from '../../modules/user-organization-roles/user-organization-role.entity';
 import { Game } from '../../modules/games/game.entity';
+import { OrgInventoryItem } from '../../modules/org-inventory/entities/org-inventory-item.entity';
+import { Location } from '../../modules/locations/entities/location.entity';
+import { UexItem } from '../../modules/uex/entities/uex-item.entity';
 
 @Module({
   imports: [
@@ -15,6 +18,9 @@ import { Game } from '../../modules/games/game.entity';
       User,
       UserOrganizationRole,
       Game,
+      OrgInventoryItem,
+      Location,
+      UexItem,
     ]),
   ],
   providers: [DatabaseSeederService],

backend/src/database/seeds/database-seeder.service.spec.ts

@@ -25,13 +25,20 @@ describe('DatabaseSeederService', () => {
   let loggerWarnSpy: jest.SpyInstance;
   let loggerErrorSpy: jest.SpyInstance;
 
-  const mockGame = {
+  const mockGameSc = {
     id: 1,
     name: 'Star Citizen',
     code: 'sc',
     description: 'Star Citizen MMO',
     active: true,
   };
+  const mockGameSq42 = {
+    id: 2,
+    name: 'Squadron 42',
+    code: 'sq42',
+    description: 'Squadron 42',
+    active: true,
+  };
 
   const mockRole = {
     id: 1,
@@ -47,6 +54,20 @@ describe('DatabaseSeederService', () => {
     isActive: true,
     gameId: 1,
   };
+  const mockOrgTwo = {
+    id: 2,
+    name: 'Dreadnought Industries',
+    description: 'Test org',
+    isActive: true,
+    gameId: 1,
+  };
+  const mockOrgThree = {
+    id: 3,
+    name: 'Frontier Syndicate',
+    description: 'Test org',
+    isActive: true,
+    gameId: 2,
+  };
 
   const mockUser = {
     id: 1,
@@ -55,6 +76,20 @@ describe('DatabaseSeederService', () => {
     password: 'hashed',
     isActive: true,
   };
+  const mockOrgAdmin = {
+    id: 2,
+    username: 'orgadmin',
+    email: 'orgadmin@example.com',
+    password: 'hashed',
+    isActive: true,
+  };
+  const mockMember = {
+    id: 3,
+    username: 'member1',
+    email: 'member1@example.com',
+    password: 'hashed',
+    isActive: true,
+  };
 
   const mockUserOrgRole = {
     id: 1,
@@ -101,6 +136,7 @@ describe('DatabaseSeederService', () => {
           provide: getRepositoryToken(Organization),
           useValue: {
             findOne: jest.fn(),
+            find: jest.fn(),
             create: jest.fn(),
             save: jest.fn(),
           },
@@ -109,6 +145,7 @@ describe('DatabaseSeederService', () => {
           provide: getRepositoryToken(User),
           useValue: {
             findOne: jest.fn(),
+            find: jest.fn(),
             create: jest.fn(),
             save: jest.fn(),
           },
@@ -150,20 +187,19 @@ describe('DatabaseSeederService', () => {
 
   describe('seedAll', () => {
     it('should seed all data successfully', async () => {
-      // Mock games seeding - first call returns null (new game), second call returns the game for org creation
       jest
         .spyOn(gamesRepository, 'findOne')
-        .mockResolvedValueOnce(null) // First game check (sc)
-        .mockResolvedValueOnce(null) // Second game check (sq42)
-        .mockResolvedValueOnce(mockGame as any) // Get sc game for org creation
-        .mockResolvedValueOnce(null); // Org check
-
-      jest.spyOn(gamesRepository, 'create').mockReturnValue(mockGame as any);
-      jest.spyOn(gamesRepository, 'save').mockResolvedValue(mockGame as any);
+        .mockImplementation((query: any) => {
+          if (query?.where?.code === 'sc') {
+            return Promise.resolve(mockGameSc as any);
+          }
+          if (query?.where?.code === 'sq42') {
+            return Promise.resolve(mockGameSq42 as any);
+          }
+          return Promise.resolve(null);
+        });
 
-      jest.spyOn(rolesRepository, 'findOne').mockResolvedValue(null);
-      jest.spyOn(rolesRepository, 'create').mockReturnValue(mockRole as any);
-      jest.spyOn(rolesRepository, 'save').mockResolvedValue(mockRole as any);
+      jest.spyOn(rolesRepository, 'findOne').mockResolvedValue(mockRole as any);
 
       jest.spyOn(organizationsRepository, 'findOne').mockResolvedValue(null);
       jest
@@ -172,10 +208,16 @@ describe('DatabaseSeederService', () => {
       jest
         .spyOn(organizationsRepository, 'save')
         .mockResolvedValue(mockOrganization as any);
+      jest
+        .spyOn(organizationsRepository, 'find')
+        .mockResolvedValue([mockOrganization, mockOrgTwo, mockOrgThree] as any);
 
       jest.spyOn(usersRepository, 'findOne').mockResolvedValue(null);
       jest.spyOn(usersRepository, 'create').mockReturnValue(mockUser as any);
       jest.spyOn(usersRepository, 'save').mockResolvedValue(mockUser as any);
+      jest
+        .spyOn(usersRepository, 'find')
+        .mockResolvedValue([mockUser, mockOrgAdmin, mockMember] as any);
 
       jest.spyOn(userOrgRolesRepository, 'findOne').mockResolvedValue(null);
       jest
@@ -189,12 +231,18 @@ describe('DatabaseSeederService', () => {
     });
 
     it('should handle existing data gracefully', async () => {
-      jest.spyOn(gamesRepository, 'findOne').mockResolvedValue(mockGame as any);
+      jest
+        .spyOn(gamesRepository, 'findOne')
+        .mockResolvedValue(mockGameSc as any);
       jest.spyOn(rolesRepository, 'findOne').mockResolvedValue(mockRole as any);
       jest
         .spyOn(organizationsRepository, 'findOne')
         .mockResolvedValue(mockOrganization as any);
+      jest
+        .spyOn(organizationsRepository, 'find')
+        .mockResolvedValue([mockOrganization] as any);
       jest.spyOn(usersRepository, 'findOne').mockResolvedValue(mockUser as any);
+      jest.spyOn(usersRepository, 'find').mockResolvedValue([mockUser] as any);
       jest
         .spyOn(userOrgRolesRepository, 'findOne')
         .mockResolvedValue(mockUserOrgRole as any);