<!--
  Copyright (c) 2024-2025 Тарабанов Александр Викторович
  All rights reserved.
  
  This software is proprietary and confidential.
  Unauthorized copying, modification, or distribution is prohibited.
  
  For licensing inquiries: info@hb3-accelerator.com
  Website: https://hb3-accelerator.com
  GitHub: https://github.com/HB3-ACCELERATOR
-->

# Анализ кодов по юрисдикциям для DLE

## 🌍 ГЛОБАЛЬНЫЕ (МЕЖДУНАРОДНЫЕ) КОДЫ

### Используются во ВСЕХ юрисдикциях:
- **ISO 3166-1** - Коды стран ✅ (у нас есть)
- **ISO 4217** - Коды валют ❌ (нужно создать)
- **ISIC Rev.4** - Международная стандартная отраслевая классификация ✅ (у нас есть CSV)
- **HS Codes** - Гармонизированная система описания и кодирования товаров ❌ (нужно создать)

## 🇷🇺 РОССИЙСКАЯ ФЕДЕРАЦИЯ

### Обязательные для регистрации юридических лиц:
- **ОКВЭД** - Виды экономической деятельности ✅
- **ОКАТО/ОКТМО** - Территориальные коды ✅
- **КПП** - Коды причин постановки на учет ✅

### Для налогообложения и отчетности:
- **КБК** - Коды бюджетной классификации ✅
- **ОКПД2** - Продукция по видам деятельности ✅
- **ОКУН** - Услуги населению ✅
- **ТН ВЭД** - Товарная номенклатура внешнеэкономической деятельности ✅

### Статистические и отчетные:
- **Коды операций** ✅
- **Формы отчетности** ✅

## 🇺🇸 СОЕДИНЕННЫЕ ШТАТЫ АМЕРИКИ

### Обязательные для бизнеса:
- **NAICS** - North American Industry Classification System ❌
- **State Codes** - Коды штатов ❌
- **EIN/SSN** - Налоговые идентификаторы (не коды, генерируются)
- **SIC Codes** - Standard Industrial Classification ❌

### Федеральные коды:
- **Federal Tax Codes** ❌
- **DUNS Numbers** (не коды, но важно для B2B)

## 🇪🇺 ЕВРОПЕЙСКИЙ СОЮЗ

### Общеевропейские:
- **NACE Rev.2** - Статистическая классификация экономических видов деятельности ❌
- **VAT Codes** - НДС коды по странам ЕС ❌
- **IBAN Country Codes** - для банковских операций ❌

### Германия:
- **WZ 2008** - Классификация экономической деятельности ❌
- **Bundesland Codes** - Коды федеральных земель ❌

### Франция:
- **NAF** - Nomenclature d'Activités Française ❌
- **APE Codes** - Коды основной деятельности ❌

## 🇬🇧 ВЕЛИКОБРИТАНИЯ

### После Brexit:
- **SIC 2007** - Standard Industrial Classification ❌
- **UK Region Codes** ❌
- **Companies House Codes** ❌

## 🇨🇳 КИТАЙ

### Для иностранных компаний:
- **GB/T 4754** - Отраслевая классификация ❌
- **Administrative Division Codes** - Коды административных единиц ❌

## 🇯🇵 ЯПОНИЯ

### Коды для бизнеса:
- **JSIC** - Japan Standard Industrial Classification ❌
- **Prefecture Codes** - Коды префектур ❌

## 📊 ПРИОРИТИЗАЦИЯ ДЛЯ DLE

### 🔴 КРИТИЧНО (нужно создать немедленно):
1. **ISO 4217** - Коды валют (для всех стран)
2. **NAICS** - США (крупнейшая экономика)
3. **NACE Rev.2** - ЕС (большой рынок)

### 🟡 ВАЖНО (следующая очередь):
4. **SIC 2007** - Великобритания
5. **State Codes** - США (штаты)
6. **VAT Codes** - ЕС

### 🟢 ЖЕЛАТЕЛЬНО (по запросу):
7. Азиатские юрисдикции (Китай, Япония)
8. Другие развитые страны

## 🎯 АРХИТЕКТУРНОЕ РЕШЕНИЕ

### Структура файлов:
```
/backend/db/data/
├── global/
│   ├── countries.json ✅
│   ├── currencies.json ❌
│   ├── isic.json ❌ (конвертировать из CSV)
│   └── hs_codes.json ❌
├── jurisdictions/
│   ├── RU/ ✅ (все файлы готовы)
│   ├── US/
│   │   ├── naics.json ❌
│   │   ├── states.json ❌
│   │   └── sic.json ❌
│   ├── EU/
│   │   ├── nace.json ❌
│   │   ├── vat_codes.json ❌
│   │   └── countries/ (DE, FR, IT, etc.)
│   └── GB/
│       ├── sic_2007.json ❌
│       └── regions.json ❌
```

## 🚀 ПЛАН РЕАЛИЗАЦИИ

### Фаза 1 (немедленно):
- [ ] Создать currencies.json (ISO 4217)
- [ ] Конвертировать ISIC из CSV в JSON
- [ ] Создать базовую структуру папок

### Фаза 2 (первый квартал):
- [ ] Добавить NAICS (США)
- [ ] Добавить NACE Rev.2 (ЕС)
- [ ] Добать коды штатов США

### Фаза 3 (по требованию):
- [ ] Расширение по другим юрисдикциям
- [ ] Локализация названий кодов

## 💡 КЛЮЧЕВЫЕ ПРИНЦИПЫ

1. **Модульность** - каждая юрисдикция в отдельной папке
2. **Стандартизация** - единый формат JSON для всех кодов
3. **Глобальность** - приоритет международным стандартам
4. **Практичность** - фокус на реально используемых юрисдикциях 