ваше сообщение коммита

backend/db/data/jurisdiction_codes_analysis.md

@@ -0,0 +1,136 @@
+# Анализ кодов по юрисдикциям для 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. **Практичность** - фокус на реально используемых юрисдикциях