اتفاقية NPA-045-2026 · المكون 3 — تحديث أدوات العرض

Ficha técnica del proyecto

Qué es la plataforma de los Visores Territoriales, su arquitectura tecnológica, metodología de datos oficiales y fuentes verificables, y las respuestas a las preguntas más frecuentes.

Ruta Milagro - Regiones Más Competitivas

1 · البطاقة الفنية للمشروع

Identificación de la plataforma y su marco contractual. Corte de datos vigente: 2025.

الاسم	العارضات الإقليمية — Ruta Milagro - Regiones Más Competitivas
الطبيعة	المنفعة العامة الرقمية (الحاشية 8 من الاتفاقية): الوصول الحر، والاستخدام، والاستغلال من قبل الأقاليم، مع استعلام منظم، ومحدَّث، وقابل للتتبع.
الإطار التعاقدي	اتفاقية NPA-045-2026 (iNNpulsa Colombia · FUNDETEC)، المكون 3 «تحديث أدوات العرض»، الصفحات 22–24؛ في إطار Ruta Milagro - Regiones Más Competitivas التابعة لـ MinCIT.
النطاق	Cinco Visores de Apoyo: V1 Economía, empleo y productividad · V2 Brechas de competitividad (IDC) · V3 Caracterización sectorial · V4 Brechas y vocaciones territoriales · V5 Cadenas productivas. Serie 2016–2025, 32 departamentos y Bogotá D.C.
العنوان العام	visores.regionesmascompetitivas.co (HTTPS, certificado automático Let's Encrypt)
حزمة التكنولوجيا	PHP 8.3 مع بنية MVC (Composer، PSR-4) · قاعدة بيانات MariaDB · خادم Caddy + PHP-FPM · ETL في Python (واجهات برمجة تطبيقات Socrata لـ datos.gov.co، DIAN، GEIH، CPC، SECOP) · عرض باستخدام Chart.js، وتصدير إلى Excel عبر ExcelJS وإلى PDF عبر jsPDF، وخريطة كلوروبثية SVG خاصة مبنية على GeoJSON · API REST v1. التفاصيل حسب الطبقة متوفرة في القسم 2.
نموذج البيانات	Cada conjunto de datos vive como una tabla propia en la base: hoy 24 tablas con 693.607 filas consultables por SQL y por la API, y su diccionario de columnas registrado. Los archivos de datos versionados con integridad `sha256` son respaldo derivado, no la fuente de servicio. Los visores nunca leen archivos Excel. Detalle vivo en la sección 8 y en كيف تعمل المنصة.
المصادر الرسمية	DANE · DNP (مرصد نظام المدن) · المجلس الخاص للتنافسية (IDC و ICC) · CRC/MinTIC · DIAN · UPRA · SECOP · السجلات القطاعية — وفقًا للملاحظة السفلية 9 من الاتفاقية، مع إمكانية التتبع والاتساق المنهجي.
الأمن	جلسات مُعزَّزة، كلمات مرور ARGON2ID، حماية CSRF، CSP مع nonce، تحديد معدل الطلبات، أدوار (مدير/محرر/قارئ)، مفاتيح API بتجزئة SHA-256 ومراجعة إجراءات النظام.
التوثيق	الدليل التعليمي بالإضافة إلى دليل لكل أداة عرض · تقرير التحديث (E10) · البنية المعمارية، وETL، وAPIودليل النقل في مستودع المشروع.
البيانات المفتوحة	API REST عامة (/api/v1/capabilities)، تصدير CSV/JSON لـ Power BI و Tableau، و llms.txt للتنقل القائم على الوكلاء.

2 · هندسة الحل، المكدس التقني والاستدامة

كيف تتم معالجة المعلومات وتحديثها من طرف إلى طرف، وما التقنية المستخدمة، ولماذا يستمر التحديث تلقائيًا بمجرد إغلاق الاتفاقية.

2.1 · تدفق المعالجة والتحديث (نهج ETL)

تدفق التحديث من البداية إلى النهاية. الكتلة الصلبة في النهاية هي المُخرَج: أدوات العرض الويب الخمسة. أما الكتلة ذات الخط المتقطع فهي قنوات استهلاك اختيارية —Power BI، Tableau، Excel أو بوابات أخرى— تتغذى من نفس API باستخدام مفتاح وصول؛ وليست هي الأداة التي بُنيت عليها أدوات العرض. تتقارب مسارات الإدخال —المراقبة التلقائية (المسار 1) والتحديث من خلال لوحة التحكم، عبر نموذج أو ملف (المساران 2 و3)— في قاعدة البيانات نفسها وتخرج من خلال طبقة النشر نفسها: لا توجد مسارات متوازية ولا نسخ خارجة عن السيطرة. الوصف النصي الكامل موضح أدناه.

الاستخراج. تقوم برامج الاستخراج في Python بالاستعلام عن واجهات برمجة التطبيقات Socrata لـ البيانات.gov.co وتقوم بتنزيل الملفات المنشورة من قِبل DANE (GEIH، EVA)، وDIAN، والمجلس الخاص للتنافسية (أساس IDC)، وSECOP وMinTIC. كل مصدر مسجّل —مع عنوان URL الخاص به، ومعرفه، ومجال سريانه— في فهرس يمكن إدارته من خلال لوحة التحكم: إضافة أو تغيير مصدر لا يتطلب تعديل الكود.
التحويل. يتم توحيد أسماء الأقسام مقابل DIVIPOLA، وتصنيف السجلات وإزالة التكرار منها، والتحقق من كل صف مقابل عقد الأعمدة لمجموعة البيانات، وحساب sha256 للمُخرَج الناتج. كل عملية تحويل قابلة لإعادة الإنتاج: نفس المدخلات، نفس قيمة التجزئة.
التحميل. يتم إسقاط كل مجموعة على جدولها الخاص في MariaDB —مع تسجيل أسماء الأعمدة، وأنواع البيانات، وعمود سريان المفعول—، وهذا الجدول هو المصدر الذي يغذي العارض وAPI. يُحتفظ بالملف المُصدَّر مع sha256 الخاص به كنسخة احتياطية، لتنزيلات المجموعات الكبيرة ولإعادة إصدار نسخة دقيقة. إن تقليص البيانات حتى تاريخ النشر العام هو شرط من شروط الاستعلام، وليس ملفاً ثانياً قد يصبح غير متزامن. ولا يقرأ أي عارض ever ملف Excel.
النشر. تخدم API REST v1 وبوابة البيانات ما هو موجود في قاعدة البيانات، مع تطبيق تقليم انتهاء الصلاحية العام، والأدوار، ومفاتيح API. يُنتج كل نشر إصدارًا قابلًا للعكس.
الاستهلاك. إن مخرجات الاتفاقية هي خمس أدوات عرض ويب، مُصممة خصيصًا باستخدام مكتبة رسومية (Chart.js) وخريطة كلورية خاصة مبنية على قاعدة البيانات. لا تُعد Power BI وTableau وExcel الأداة التي بُنيت عليها؛ بل هي قنوات استهلاك اختيارية تتصل بنفس API باستخدام مفتاح وصول، في JSON أو CSV، مثل أي بوابة أخرى أو لوحة معلومات أخرى. وجميعها تقرأ نفس مصدر الحقيقة بدقة.
الرقابة. تُقارن عملية مُبرمجة أسبوعيًّا الصلاحية المُحمَّلة بتلك المتوفرة في كل مصدر رسمي، وعند اكتشاف قطع جديد، يتم الإخطار به، ويُترك الناتج قابلاً للتحقق في سجل عمليات التدقيق. إن الإدراج قرار يتخذه الفريق: يُحمَّل من لوحة التحكم، بعد تحقق مسبق وبإصدار قابل للعكس. وعليه، لا يدخل أي عام جديد إلى العارض دون أن يراجعه شخص ما.

2.2 · مصدر البيانات: مصادر رسمية مُتحقَّق منها

المصادر التي تغذي لوحات العرض، مع العنوان الدقيق الذي تُستقى منه كل بيانات، وفترة الصلاحية التي توفرها كل منها. جميعها مصادر عامة ولا تتطلب أي بيانات اعتماد. تُطبَع هذه الجدولة مباشرة من السجل نفسه الذي يدير عرض المصادر الرسمية في لوحة التحكم، بحيث لا يمكن الإعلان عن مصدر مختلف عن المصدر المستخدم فعليًا؛ وإذا غيّرت أي جهة عنوانًا، يتم تصحيحه عبر نموذج — دون الحاجة إلى مطور أو نشر. وتتوفر المعلومات نفسها، مصدرًا تلو الآخر، مع شرح طريقة الحصول عليها، في المنهجية والمصادر.

العارض	المصدر	الكيان	العنوان (URL)	المسار	الصلاحية المُقدَّمة
Todos	Libros MÁgil — insumo oficial de los 5 visores	iNNpulsa Colombia · MinCIT	innpulsacolombia.com	Página oficial	V1 2016–2023 (8 años) · V2 2018–2023 (6) · V3 2023 · V4 y V5 sin año
1	PIB departamental por actividad económica	DANE — Dirección de Síntesis y Cuentas Nacionales	dane.gov.co	Descarga oficial	2005–2025 (anexo 2025 preliminar)
1	Personas ocupadas por departamento y rama (GEIH)	DANE — Gran Encuesta Integrada de Hogares	dane.gov.co	Descarga oficial	2016–2025
1	Mercado laboral · año móvil de las 32 ciudades	DANE — Gran Encuesta Integrada de Hogares	dane.gov.co	Descarga oficial	2016–2025 (año móvil)
2	Índice Departamental de Competitividad (IDC)	Consejo Privado de Competitividad · U. del Rosario	compite.com.co	Página oficial	edición 2026 (datos 2019–2025)
3	GEIH — ocupados (microdatos)	DANE	microdatos.dane.gov.co	Página oficial	2024–2025 (12 meses por año)
3	Exportaciones — microdatos EXPO	DIAN · DANE	microdatos.dane.gov.co	Página oficial	2021–2025 (12 meses por año)
3	Exportaciones agrícolas por departamento	Ministerio de Agricultura y Desarrollo Rural	datos.gov.co	API de datos abiertos	2024–2025
3	Importaciones — microdatos IMPO	DIAN · DANE	microdatos.dane.gov.co	Página oficial	2021–2025 (12 meses por año)
4	Evaluaciones Agropecuarias (EVA)	UPRA · Ministerio de Agricultura y Desarrollo Rural	upra.gov.co	Descarga oficial	2019–2025 (base agrícola)
4	Cobertura móvil por centro poblado y operador	CRC · Ministerio TIC — POSTDATA	postdata.gov.co	Descarga oficial	2023-T1 a 2025-T4 (cargados los cierres 2023, 2024 y 2025)
4	Observatorio del Sistema de Ciudades	DNP — Departamento Nacional de Planeación	osc.dnp.gov.co	Página oficial	sin vigencia anual (estructural)
4	Índice de Competitividad de Ciudades (ICC)	Consejo Privado de Competitividad · U. del Rosario	compite.com.co	Descarga oficial	edición 2025
5	SECOP II — procesos de contratación	Colombia Compra Eficiente	datos.gov.co	API de datos abiertos	2024–2025

تتم مقارنة السنة المعروضة في العارض أسبوعيًّا مع السنة التي نشرتها المصدر بالفعل، ويتم الإخطار عند توفر قطع بيانات جديد؛ ويتولى الفريق تحديد وتنفيذ عملية التحميل من خلال لوحة التحكم. بعض هذه المصادر لا تدعم الاستعلام الآلي — حيث يرفض DANE وصول البرامج وينشر مرفقاته للتحميل؛ بينما ينشر المجلس الخاص للتنافسية تقاريره السنوية —: لذا تتم مراقبتها يدويًّا، ويتم تحميل أرشيفها عبر لوحة التحكم، وهي الطريقة المخصصة للتحديث.

2.3 · حزمة التكنولوجيا حسب الطبقة

جميع المكونات هي برمجيات مفتوحة المصدر، دون تكلفة أو تجديد ترخيص للدولة. ويمكن استبدال كل طبقة بشكل مستقل: فلا يربط أي قرار بمورّد معيّن.

طبقة	التكنولوجيا	لماذا والترخيص
الاستيعاب / ETL	Python 3 — مستخرجات حسب المصدر (عميل Socrata/SoQL، قارئات CSV/XLSX/ZIP) + مراقب عمليات التقليم	المعيار الفعلي للتحليلات العامة؛ نصوص برمجية قابلة للقراءة وإعادة التنفيذ من سطر الأوامر بواسطة أي فريق تقني. تراخيص غير تقييدية. بدون أداة ETL خاصة: لا يوجد خادم تنسيق يتطلب ترخيصًا أو تجديدًا.
الاستمرارية	MariaDB — una tabla propia por conjunto de datos (24 hoy) con su diccionario de columnas versionado, más los indicadores como registros ordenados (una fila por año, territorio e indicador) y los archivos de datos versionados con `sha256` como respaldo	SQL قياسي، قابل للنسخ الاحتياطي باستخدام `mysqldump` وقابل للاستعادة على أي محرك متوافق. مخطط مُدار للإصدارات عبر هجرات قابلة للتكرار. رخصة GPL v2 — بدون تكلفة.
التطبيق	PHP 8.3، بنية MVC خاصة (Composer، PSR-4) — عارضات عامة، لوحة إدارة ومساعد تحميل	بدون إطار عمل ثقيل أو تبعيات ذات دورة حياة قصيرة: يُعدّ الكود بحد ذاته الأصل القابل للنقل والمراجعة.
الخادم	Caddy + PHP-FPM، TLS تلقائي (Let's Encrypt)	شهادات تتجدد تلقائياً: صفر مهام تشغيلية يدوية. Apache 2.0.
العرض	Chart.js 4.4.3 (السلاسل ولوحات العرض) + ExcelJS 4.4.0 (كتاب Excel متعدد الصفحات) + jsPDF 2.5.2 مع autotable (PDF مع ترويسة مؤسسية)، وكلاهما بتحميل كسول + خريطة كلوربيثية SVG مخصصة بناءً على GeoJSON DIVIPOLA — و إخراج أصلي إلى Power BI، وTableau وExcel عبر API JSON/CSV	مسار مزدوج مقصود: لا يتطلب العارض العام من المواطن أي ترخيص؛ بينما يربط محلل الوزارة Power BI بـ API نفسها دون تكرار البيانات (الحصول على البيانات → الويب). ولا يزال تعريف المحرك المطلوب (راجع RT‑4) قيد النقاش في اللجنة التقنية: فالبنية المعمارية تقبل أيّ محرك دون الحاجة إلى إعادة تصميم عملية الإدخال.
التشغيل البيني	API REST v1 ذاتية الوصف · بوابة بيانات · llms.txt	قابل للربط والاتحاد من خلال منصات تنافسية.gov.co عبر عنوان URL ثابت. إن API هو العقد: حيث يمكن لأي مستهلك مستقبلي (بوابة إلكترونية، لوحة معلومات، أو منصة أخرى) الاتصال دون المساس بالمنصة.
الأتمتة	cron للنظام (المراقبة الأسبوعية للانقطاعات) + النشر التلقائي عبر ويب هوك	بدون مخطط خاص: سطر كرون يفهمه أي مسؤول ويمكن نقله ومراجعته.

2.4 · مَن يُحدّث البيانات وما الذي يحتاج إلى معرفته

طلبت اللجنة التقنية (RF‑3) أن يتمكن شخص مسؤول من تحديث المعلومات بدون معرفة بلغة SQL. تم تنفيذ طريقتين، وليس طريقة واحدة، لأن تصحيح بيانات معينة يختلف عن تحميل فترة صلاحية كاملة. لا تتطلب أي من الطريقتين ملفًا تقنيًا:

✍️ بيانات ببيانات، في نموذج

في عرض السجلات ضمن اللوحة، ياطّلع الموظف على بيانات العارض في جدول مزوّد بمرشحات، ويصحّح قيمة في الصف نفسه، أو يضيف سجلاً، أو يحذفه. كل ذلك عبر نموذج: بدون ملفات، بدون قوالب، وبدون تثبيت أي شيء.

صُمِّم النموذج بحيث يستحيل الوقوع في أخطاء تقنية: إذ يُختار المؤشر و الإدارة من قوائم؛ وتُرشَّح البلديات تلقائيًّا وفقًا للإدارة؛ ويُملأ الرمز DIVIPOLA آليًّا (لا يكتبه أحد)؛ أما الوحدة، فإن تُركت فارغة، ورِثَت قيمتها من الفهرس. وعند الحذف، تصف المنصة نصّيًّا ما سيتم حذفه. يُحدَّث العارض تلقائيًّا: فلا توجد خطوة «نشر» قد يُغفَل عنها.

📄 العديد من البيانات، باستخدام قالب العارض

لتحميل العديد من السجلات دفعة واحدة، توفر المنصة القالب الجاهز: عند اختيار العارض في مساعد التحميل، تظهر أزرار التنزيل في Excel (XLSX) وCSV، المخصصة لمجموعة البيانات هذه.

يتم إنشاء كل نموذج استناداً إلى التعريف الفعلي للمجموعة —ولهذا السبب لا يمكن أن يصبح غير محدّث— ويتضمن الأعمدة الدقيقة مرتبة حسب تسلسلها، وما يصل إلى خمسة صفوف حقيقية كمثال، بالإضافة إلى ورقة «تعليمات» توضح، عموداً تلو الآخر، نوع البيانات، وما إذا كانت إلزامية، وكيفية تعبئتها. يتم التعبئة في Excel، ثم رفع الملف، وتقوم المنصة بالتحقق من صحته قبل التطبيق: فإذا وُجد أي خطأ، لا يتم تفعيل الزر ويُشار إلى ما يجب تصحيحه.

في كلتا الحالتين، يخضع التغيير لـ إصدار نسخ، ومراجعة، وإمكانية التراجع: فتكلفة الخطأ هي نقرة واحدة، وليست حادثًا. وباختصار، لا يحتاج من يقوم بالتحديث إلى معرفة ما هي قاعدة البيانات، ولا لغة SQL، ولا فتح وحدة تحكم، ولا معرفة رموز الإقليم: بل يحتاج فقط إلى متصفح، وللتحميل الجماعي، Excel. وقد تم شرح المصطلحات التقنية الواردة في هذه الصفحة ضمن المسرد.

2.5 · التحديث الذاتي بعد انتهاء الاتفاقية

لا يتمثل الشرط في أن تعمل المنصة عند الإغلاق، بل في استمرار تحديثها دون الحاجة إلى المشغّل. تعالج البنية الاعتماديات التي تقضي عادةً على منصات البيانات: الشخص الذي كان يمتلك المعرفة، والمورّد الذي يمنح الترخيص، والملف الذي لا يجده أحد، والإجراء الذي لم يوثقه أحد.

🔁 لا يعتمد على شخص بعينه

القناة الرئيسية للتحديث هي تلقائية: تكشف العملية المبرمجة أسبوعيًا عن القطع الجديد في المصدر الرسمي، وتُدمجه وتعيد توليد العناصر التقنية العامة. وإذا لم يتخذ أحد أي إجراء، فإن المنصة مع ذلك تتنبه لوجود بيانات جديدة وتسجل الاكتشاف.

🙋 لا يتطلّب ملفًا شخصيًا تقنيًا

يُشغِّل أي موظف مُخوَّل القناتين الروتينيتين —النموذج والقالب— عبر متصفح إنترنت (انظر 2.4). أما للتغييرات الجوهرية، فهناك قناة ثالثة: يقوم فريق تقنية المعلومات بإعادة تنفيذ العمليات الموثقة، دون الاعتماد على المشغل الحالي.

🔓 لا يعتمد على مزوّد خدمة

صفر تراخيص تجارية في كامل البنية التقنية. تُدار المصادر الرسمية من خلال لوحة التحكم (عنوان URL، المعرف، وحقل سريان المفعول)، وليس عبر الكود البرمجي: فإذا غيّرت جهة ما عنوان URL، يتم التصحيح عبر نموذج، دون الحاجة إلى مطور أو نشر.

📦 لا يعتمد على المشغّل

تُنقل الأصول مفككة القيد (الصفحات 40–43 من الاتفاقية): الكود المصدري، والنصوص البرمجية والاستعلامات، وتعريفات لغة تعريف البيانات (DDL) ونسخ قواعد البيانات، ونموذج استخراج البيانات وتحويلها وتحميلها (ETL) الموثّق، والأدلة التقنية، ومحضر التسليم الموقع. يمكن لأي فريق تقني تشغيل المنصة كاملةً على بنية تحتية خاصة به اتباعاً لدليل النقل.

🧾 لا يعتمد على الذاكرة

كُلّ المعرفة التشغيلية مُدوَّنة ومُرقّمة الإصدار جنبًا إلى جنب مع الكود: وثائق البنية، وعمليات ETL، API، ودليل المسؤول، وفهرس النصوص البرمجية. وتنتقل الوثائق مع المنصة، وليس عبر البريد الإلكتروني.

🛡️ لا يعتمد على الصدفة

الحقيقة المنشورة قابلة لإعادة الإنتاج: يعلن كل بيانات عن مصدره، وكل عنصر تقني عن بصمته sha256، وكل منشور عن إصداره. ويتم تدقيق أي تناقض مستقبلي بدلاً من مناقشته — ويُصحَّح عبر تحميل إصدار مُرقَّم.

نقاط الحوكمة التي ليست تقنية —مثل جهة الاستضافة (RG‑1) وجهة إدارة المنصة بعد التسليم (RG‑2)— هي قرارات مؤسسية تتخذها MinCIT/iNNpulsa ولا تزال قيد الدراسة. صُمّمت المنصة لدعم أي سيناريو من السيناريوهات التالية: نطاق فرعي خاص بالوزارة، أو بنية تحتية تابعة لـ iNNpulsa، أو استمرار الاستضافة الحالية، دون أي تغييرات في عمليات إدخال البيانات أو في API.

2.6 · الأمن والاستعداد لفحص الثغرات الأمنية

صُممت المنصة على افتراض أنها ستخضع للمراجعة. يلتزم المشغل بالتعاون مع مكتب أنظمة المعلومات التابع للوزارة لإجراء فحص الثغرات الأمنية الذي تقرره الوزارة —ضمن الإطار الزمني وباستخدام الأداة وفقًا للقواعد التي تحددها الوزارة— ولإصلاح النتائج ضمن نطاق الاتفاقية. الضوابط المُنفذة حاليًا:

النقل	إلزامية HTTPS مع شهادة تلقائية، HSTS، إعادة التوجيه القسري من HTTP، ورؤوس `nosniff`، و`frame-ancestors`، و`referrer-policy`.
حقن الكود	سياسة أمان المحتوى الصارمة: بدون `'unsafe-inline'` لا في النصوص البرمجية ولا في الأنماط — كل نص برمجي مضمن مُوقَّع بـ nonce لكل طلب، وكل نمط موروث له تجزئة SHA-256 الخاصة به. صفر معالجات أحداث مضمنة.
حقن SQL	الوصول إلى البيانات حصريًا عبر استعلامات مُعَلمة (PDO دون محاكاة prepares). لا تُشتق أبدًا معرفات الجداول والأعمدة من الطلب.
المصادقة	كلمات مرور باستخدام ARGON2ID، وجلسات مُعززة (ملف تعريف ارتباط `__Host-`، `HttpOnly`، `SameSite`، تخزين معزول)، وحماية CSRF لكل نموذج، وحدّ معدل عند النقاط الحساسة.
الإذن	الأدوار مسؤول / محرر / قارئ؛ مفاتيح API ذات نطاقات وحصص، تُحفظ فقط كـ تجزئة SHA-256 (تُعرض القيمة النصية الصريحة مرة واحدة فقط). لا تُقدَّم العناصر الثابتة أبدًا بشكل ثابت: فهي تمر عبر بوابة تحتوي على إغلاق افتراضي في حالة حدوث خطأ.
إمكانية التتبع	سجل تدقيق إجراءات لوحة التحكم، وإصدار كل عملية تحميل مع إمكانية التراجع وضمان النزاهة `sha256` لكل مخرج.
الأسرار	بيانات اعتماد ومفاتيح الموردين فقط في قاعدة البيانات أو في ملفات خارج هيكل الويب مع صلاحيات مقيدة؛ ولا تُودع أبدًا في المستودع أو السجلات أو سجلات التدقيق.
السطح المُعرَّض	لوحة تحكم وAPI إدارة خلف نظام المصادقة؛ المجلدات الحساسة غير قابلة للخدمة؛ النطاق الفرعي لا يرسل بريدًا إلكترونيًا (SPF `-all` + DMARC `p=reject` + CAA).
التدقيق المسبق	خضعت المنصة لمراجعة تقنية خارجية مستقلة تتعلق بالأمن والأداء وإمكانية الوصول والممارسات الجيدة، وأسفرت عن نتائج مُرضية في جميع المحاور دون وجود توصيات معلقة. يُعد هذا سجلًا سابقًا، وليس بديلاً عن الفحص الرسمي الصادر عن مكتب أنظمة المعلومات.

المُخرَج المرتبط: يتم تسليم التوثيق التقني الكامل (الهندسة المعمارية، نموذج ETL، API، مخطط قاعدة البيانات، دليل المسؤول، فهرس النصوص البرمجية، ودليل النقل) مُرقَّم الإصدار جنبًا إلى جنب مع الكود المصدري، وهو جزء من محضر التسليم، وفقًا للصفحات 40–43 من الاتفاقية.

Supervisión y cumplimiento contractual

La matriz técnica de cumplimiento punto por punto del Convenio 521 de 2025 / NPA-045-2026, los entregables (E10, E11, E12) y los requerimientos funcionales de la mesa técnica han sido consolidados en el módulo interno de supervisión.

Para mantener la experiencia ciudadana y territorial enfocada en los visores, los datos abiertos y la metodología, todos los aspectos demostrativos del convenio se encuentran disponibles en la vista interna de gestión para la interventoría, supervisión del MinCIT e iNNpulsa Colombia.

Consultar cumplimiento del convenio (Módulo de Gestión) → Manual instructivo (PDF) Manual técnico (PDF)

5 · دليل الأسلوب: المواءمة مع مواقع GOV.CO

تطبق المنصة مجموعة واجهة المستخدم الحكومية، الإصدار 9.2، بالإضافة إلى إرشادات إمكانية الوصول وسهولة الاستخدام الصادرة عن الوكالة الرقمية الوطنية:

🏛️ الشريط العلوي GOV.CO

تحتوي جميع الصفحات على الشريط المؤسسي بشعار GOV.CO مرتبطًا بالبوابات الموحّدة للدولة، بالألوان والأبعاد المحدّدة في المجموعة المعيارية. وتُدرَج ضمنها ضوابط إمكانية الوصول —التباين وحجم النص— في جميع الصفحات.

🧭 تذييل مؤسسي

يُعلن عن الكيان المسؤول مع بيانات الاتصال الخاصة به، والرمز البريدي، وساعات العمل، ولوحة المفاتيح الهاتفية، والخط المجاني، وخط مكافحة الفساد، وعنوان البريد الإلكتروني للإخطارات القضائية؛ وقسم السياسات · خريطة الموقع · الشروط والأحكام · إمكانية الوصول؛ وشعارات GOV.CO وشعار العلامة الوطنية Colombia.

🎨 ألوان وخطوط الدولة

اللون المخصص لوزارة التجارة والصناعة والسياحة في دليل الهوية البصرية للحكومة، والعائلتان الخطيتان الوحيدتان اللتان تدعمهما المجموعة: Nunito Sans للعناوين وVerdana للنصوص. ويُقدَّم كلاهما مباشرة من الخادم الخاص، دون الاعتماد على أطراف ثالثة.

♿ إمكانية الوصول مستوى AA

وفقًا للمادة 3 من القرار 1519 لعام 2020: الانتقال إلى المحتوى الرئيسي، التنقل الكامل عبر لوحة المفاتيح، ظهور مؤشر التركيز بوضوح، التحقق من التباين، والهيكل الدلالي. توجد حالة إمكانية الوصول، والمهام المعلقة، وقناة الإبلاغ في إعلان إمكانية الوصول.

🔒 الأمن والثقة الرقمية

إلزامية HTTPS مع شهادات تلقائية، ورؤوس أمان صارمة (CSP مع nonce، وHSTS، وnosniff)، وحماية النماذج، والمراجعة — ممارسات مطلوبة للخدمات الرقمية الموجهة للمواطنين.

📖 البيانات المفتوحة افتراضيًا

متوافق مع السياسة الوطنية للبيانات المفتوحة: استشارة حرة دون تسجيل، API عامة ذاتية الوصف، صادرات قابلة لإعادة الاستخدام (CSV/JSON)، وبيانات وصفية للمصدر لكل منشور بيانات.

6 · لوحة الإدارة والمسرد

ما هي العروض المتاحة للمنصة لإدارتها، وما معنى كل مصطلح تقني أو اختصار يظهر في هذه الصفحة.

6.1 · عروض اللوحة

تتطلب لوحة الإدارة حسابًا وتضم ثلاثة أدوار: المسؤول (كامل الصلاحيات)، المحرر (البيانات والتحميلات)، والقارئ (للاستعلام فقط). لا تتطلب أي من هذه الواجهات معرفة تقنية، إلا حيث يُشار إلى ذلك.

العرض	الغرض من الاستخدام	مَن
لوحة التحكم	حالة العوارض الخمسة والنشاط الأخير، بنظرة شاملة.	الجميع
السجلات	عرض البيانات وتصحيحها وإضافتها وحذفها بيانةً تلو الأخرى، عبر عارض مع تطبيق مرشحات. وهي الآلية اليومية للعمل (انظر 2.4).	يقوم بالتعديل المسؤول والمحرر
رفع ملف	مساعد مكون من 3 خطوات (عارض → سريان → أرشفة) مع تنزيل قالب العارض، وتحقق مسبق باستخدام نظام إشارات ضوئية، وتطبيق قابل للتراجع.	يقوم بالتعديل المسؤول والمحرر
سجل التحميلات	ما تم تحميله، ومتى، ومن، وفي أي حالة؛ مما يسمح بالرجوع عنه.	يرى الجميع
العارضات	حالة كل عارض، وبياناته وتحليلاته؛ وتحرير بطاقته.	يقوم بالتعديل المسؤول والمحرر
المؤشرات	الفهرس الرسمي للمؤشرات حسب العارض. وهو القائمة التي تغذي نموذج السجلات: فإذا لم يكن المؤشر موجودًا هنا، لا يمكن تحميله. ويتوقف عرض المؤشر غير النشط دون حذف سجله التاريخي.	للمسؤول فقط
المصادر الرسمية	يُدير مصدر البيانات (الاسم، والكيان، والعارض، والعنوان، وحقل السنة) ويختبر الاتصال المباشر، مع سرد فترات الصلاحية المتاحة (انظر 2.2).	يتم اختبار الجميع؛ ويقوم المسؤول بالتحرير
الصفحة العامة	قم بتعديل نصوص الغلاف والتذييل وبطاقات العارضين، وارفع الأدلة في PDF. يُعيد الحقل الفارغ النص الأصلي. العلامة المؤسسية غير قابلة للتعديل.	المسؤول والمحرر
مجموعات البيانات	جرد تقني كامل؛ يوفر القوالب حسب المجموعة.	الجميع
المستخدمون	إنشاء الحسابات وتعيين الأدوار الثلاثة.	للمسؤول فقط
مفاتيح API	يُنشئ ويُبطِل المفاتيح المخصصة للاستهلاك البرمجي (Power BI، Tableau، وأنظمة أخرى)، ويقرر ما إذا كان الوصول إلى البيانات يتم بواسطة مفتاح أم مفتوحًا دون بيانات اعتماد —ويكون هذا الأخير فقط عند تفويض الإشراف بذلك—. ولا يُحتفظ في قاعدة البيانات إلا بالملخص المشفّر لكل مفتاح.	للمسؤول فقط
مقدمو خدمات الذكاء الاصطناعي	تشغيل أو إيقاف المساعدة الاختيارية بالذكاء الاصطناعي. هي حالياً مُعطَّلة: فهي قيمة مضافة لم تُصرّح بها بعد جهة الإشراف على الاتفاقية. وفي حال التصريح بها، ستعمل باستخدام نموذج مُثبَّت على الخادم ذاته، ولن تغادر أي استعلام هذا الخادم.	للمسؤول فقط
الحالة	الخادم، الخدمات، قاعدة البيانات، سياسة صلاحية الميزانيات، ومزودو الذكاء الاصطناعي.	للمسؤول فقط
التدقيق	مَن فعل ماذا ومتى، مع حالة البيانات قبل وبعد كل تعديل.	الجميع

6.2 · مسرد المصطلحات والاختصارات

كُتبت هذه الصفحة ليفهمها أي قارئ، سواء كان من المجال التقني أم لا. ويُشرح هنا، بلغة مبسطة، كل مصطلح متخصص وارد فيها.

الكيانات والبرامج والأدوات

MinCIT	وزارة التجارة والصناعة والسياحة.
iNNpulsa Colombia	كيان حكومي معني بريادة الأعمال والتنافسية؛ يوقّع الاتفاقية ويشرف عليها.
Ruta Milagro - Regiones Más Competitivas	استراتيجية MinCIT لتخطيط التنمية الإنتاجية الإقليمية.
الاتفاقية NPA-045-2026	اتفاقية التعاون التي يُؤطَّر بها هذا العمل. ويُمثِّل «المكوّن 3» منها تحديث العوارض.
CRCI	اللجان الإقليمية للتنافسية والابتكار: الهيئات الإقليمية التي تستخدم أدوات العرض.
MÁA · MÁgil	منهجية أجايل المُعدّلة، وهي منهجية الاستراتيجية. إن «كتب MÁgil» هي الملفات Excel التي قدّمتها iNNpulsa كمدخلات رسمية.
DANE	الإدارة الإدارية الوطنية للإحصاء: السلطة الإحصائية للبلاد.
DNP	الإدارة الوطنية للتخطيط.
DIAN	مديرية الضرائب والجمارك الوطنية.
MinTIC · UPRA	وزارة تكنولوجيا المعلومات والاتصالات · وحدة التخطيط الريفي الزراعي.
CPC	المجلس الخاص للتنافسية: كيان خاص ينشر IDC.
كونفيكاماراس	اتحاد غرف التجارة؛ يدير RUES.

المصادر والمؤشرات والبيانات الإقليمية

DIVIPOLA	التقسيم السياسي والإداري: الفهرس الرسمي الصادر عن DANE الذي يخصص رمزاً فريداً لكل إدارة وبلدية. ويهدف إلى ضمان فهم أن «Bogotá د.ك.» و«بوغوتا» و«11» تشير إلى الإقليم نفسه. ولا يكتبه مطلقاً من يقوم بتحميل البيانات: بل يختار البلدية من قائمة فيُملأ الرمز تلقائياً.
توحيد المعايير	الاعتراف بأن طريقتين مختلفتين لكتابة اسم إقليم واحد تشيران إلى الإقليم نفسه (مثل «فالي» و«فالي دل كاوكا») وتوحيدهما وفق الرمز الرسمي.
PIB	الناتج المحلي الإجمالي: قيمة ما ينتجه إقليم ما.
IDC	Índice Departamental de Competitividad, del Consejo Privado de Competitividad y la Universidad del Rosario: mide la competitividad de los 32 departamentos y Bogotá D.C. y es la fuente de las brechas del Visor 2.
GEIH	المسح المتكامل الكبير للأسر المعيشية (DANE): منه تُستمد بيانات التوظيف.
السكان في سن العمل	الأشخاص الذين تبلغ أعمارهم 15 عاماً أو أكثر، وهم الفئة المستهدفة في استقصاء الأسر حول العمل. لا يشمل هذا التعريف من هم دون هذه السن.
معدل الإشغال	من كل 100 شخص في سن العمل، كم لديهم عمل. هذه نسبة مئوية وليست عدد أفراد.
الأشخاص المشتغلون	الأشخاص الذين كانوا يعملون أو كانوا في وضع عمل خلال الفترة المرجعية. وهو مقياس التوظيف المستخدم في أدوات العرض.
حساب داخلي	شارة يضعها العارض على رقم تحسبه هذه المنصة بدلاً من اعتماده منشوراً. تظهر، على سبيل المثال، في بيانات التوظيف بالأقاليم حيث لا تشمل عينة استقصاء الأسر سوى العاصمة: هناك يُعاد بناء الرقم منها، وفق الطريقة المعلنة في التسليم الأصلي. وتهدف إلى منع الخلط بين البيانات المحسوبة والبيانات المنشورة من قبل المصدر.
EVA	التقييمات الزراعية البلدية (UPRA/وزارة الزراعة): المساحة والإنتاج الزراعي.
RUES · CIIU	السجل الموحد للشركات والشؤون الاجتماعية (سجل الشركات) · التصنيف الصناعي الدولي الموحد (رمز النشاط الاقتصادي للشركة).
SECOP	النظام الإلكتروني للعقود العامة: حيث تُسجَّل عقود الدولة.
الصلاحية · تاريخ القطع	السنة التي ينتمي إليها البيانات. يُقصد بـ«القطع العام» آخر سنة يمكن للمواطن الاطلاع عليها.
بيئة الاختبار · مسودة	بيانات تم تحميلها بالفعل ولكنها ليست عامة بعد: تنتظر التحقق من قبل اللجنة الفنية.
السلسلة التاريخية	سلسلة السنوات لنفس المؤشر، والتي تتيح إجراء مقارنات عبر الزمن.
مؤشر	ما يتم قياسه (على سبيل المثال «PIB للفرد»). لا تتوفر سوى المؤشرات الواردة في الكتالوج الرسمي لكل عارض بيانات.
نظرة عامة	جدول بيانات لوحة العرض، مُنظَّم على هيئة سنة × إقليم × مؤشر.
البُعد	المجموعة الموضوعية التي ينتمي إليها مؤشر ما. في العارض 2، تُجمَّع مؤشرات التنافسية الـ45 ضمن 6 أبعاد (التعليم المتوسط والعالي، رأس المال البشري، كفاءة السوق والنظام المالي، البنية التحتية واعتماد تقنيات المعلومات والاتصالات، الاستدامة البيئية، والابتكار وديناميكية الأعمال). وعند عرض الأبعاد في رسم بياني، يلخّص كل عمود عدة مؤشرات ويوضح ذلك بين قوسين.
مجموعة المقارنة · الهيكل	تتم مقارنة كل إدارة مع تلك التي تمتلك هيكلاً إنتاجياً مشابهاً، وليس مع الدولة بأكملها. فهناك ثلاث مجموعات حدّدتها وزارة التجارة والصناعة والسياحة وفقاً للكثافة المؤسسية وتركيز المؤسسات في كل إدارة.
الحدود	خط الأساس الذي تُقاس به الإدارة. في التحليل الثابت، هو متوسط المؤشر ضمن مجموعة المقارنة الخاصة بها؛ وفي التحليل الديناميكي، هي الإدارة ذات أعلى درجة على مستوى البلاد في آخر سنة تم قياسها.
الفجوة الثابتة	المسافة بين قيمة الإدارة وحد مجموعة التي تنتمي إليها، في سنة محددة. تشير القيمة السالبة إلى تأخر؛ والقيمة الموجبة إلى ميزة.
الفجوة الديناميكية	الفرق بين معدل النمو للإدارة ومعدل النمو الوطني المرجعي، طوال السلسلة الزمنية بأكملها. يوضح ما إذا كان هناك تقارب أو تباعد، ولا يحدد الوضع الحالي.
يتقارب · يتباعد · يحافظ على الوتيرة	كيف تُصنَّف الفجوة الديناميكية: تتقارب إذا اقتربت الإدارة من المرجع، وتتباعد إذا ابتعدت، وتحافظ على الوتيرة إذا نمت بوتيرة مماثلة. يُحدِّد المصدر العتبة التي تفصل بين الحالات الثلاث.
مجموعة المقارنة · الهيكل CRCI	المجموعات الثلاث التي تقسم بها وزارة التجارة والصناعة والسياحة الأقسام وفقًا لكثافتها المؤسسية وتركيزها المؤسسي. تقارن أدوات العرض كل قسم بمتوسط مجموعته، وليس بالبلد بأكمله: فمن الأكثر عدلاً القياس مقابل أقاليم مماثلة.
حدود الإنتاجية	المنطقة المرجعية التي يُقاس مقابلها متوسط إنتاجية كل عامل. تقترب الإدارة الإقليمية منها إذا نما ناتجها بسرعة أكبر، وتبتعد عنها إذا نما ببطء أكثر.
الإنتاجية غير التعدينية	الإنتاجية المحسوبة باستبعاد قطاع التعدين، حيث إن تقلبات أسعاره قد تشوّه المقارنات بين الأقاليم. وهذا هو المقياس المعتمد في أدوات العرض.
الأسعار الجارية · الأسعار الثابتة	الجارية: القيمة بأسعار السنة نفسها؛ وتُستخدم لمعرفة وزن كل نشاط ضمن سنة معينة. الثابتة: القيمة بعد خصم التضخم؛ وتُستخدم لمقارنة السنوات فيما بينها.
ميزة نسبية	عندما يكون وزن قطاع ما داخل إدارة أكبر من وزنه على مستوى الدولة. يشير إلى التخصص الإقليمي لتلك المنطقة.
التعقيد الاقتصادي	مدى تنوع وخصوصية المعرفة اللازمة لإنتاج سلعة ما. فكلما زاد تعقيد المنتج، قل عدد الأقاليم القادرة على تصنيعه، وصعبت محاكاته.
قيمة استراتيجية	تدمج تعقيد قطاع ما مع المسافة: أي مدى قرب القدرات المطلوبة من تلك المتوفرة بالفعل في الإقليم. يُعدّ القطاع المعقد والقريب رهانًا معقولاً؛ أمّا المعقد والبعيد فصعب.
سلاسل الإنتاج	مدى اعتماد قطاع ما على قطاعات أخرى ومدى اعتماد القطاعات الأخرى عليه. فكلما زادت الروابط التشابكية، زاد تأثيره في سحب بقية الاقتصاد نحو النمو عند توسعه.
الميل الإنتاجي	ما يتمتع به الإقليم بأفضل تجهيز، يُرى من خلال أماكن تركّز شركاته فعليًا. وعند تقاطعها مع الفجوات، تُظهر أي رهان إنتاجي معوق بسبب مشكلة محددة.
ICC · مؤشر تنافسية المدن	مؤشر المجلس الخاص للتنافسية وجامعة روساريو الذي يقيّم عواصم الولايات الـ 32 ومناطقها الحضرية. لا يُطابق IDC، الذي يقيس الإدارات: ولا يمكن مقارنتهما ببعضهما البعض.
ن.ن. (نقاط نسبية)	الوحدة التي تُعبَّر بها الفجوات. وهي الفرق بين نسبتين مئويتين: فالانتقال من 10% إلى 13% يمثل زيادة قدرها 3 نقاط مئوية، وليس 3%.
data.gov.co	بوابة البيانات المفتوحة التابعة للدولة الكولومبية، والتي تُستقى منها مصادر متعددة.
Socrata · SoQL	التقنية التي تعمل بها `البياناتgov.co` وطريقة الاستعلام عنها: تتيح طلب البيانات الضرورية فقط دون تنزيل整套 البيانات.
مجموعة البيانات	مجموعة من البيانات تُجمع وتُستعلم عنها معًا (على سبيل المثال: «PIB، العاملون والإنتاجية حسب القسم»). لكل مجموعة جدولها الخاص في قاعدة البيانات وقاموسها الخاص للأعمدة.
عمود سارية المفعول	العمود الذي يحدد السنة التي ينتمي إليها كل صف. لا تحتوي جميع المجموعات على هذا العمود: ففي بعضها تُذكر السنة في اسم العمود (على سبيل المثال «المشتغلون 2025») بينما لا تحتوي مجموعات أخرى على سنة لأنها كتالوجات.
البيانات الدقيقة	السجلات مُدرجة واحدة تلو الأخرى دون تجميع (مثل كل إ_declaration تصدير على حدة). يتم تنزيلها كاملةً لأغراض التحليل؛ ولا يُسمح بالاستعلام عنها سجلاً بسجل.

تكنولوجيا الحل

ETL	الاستخراج والتحويل والتحميل: العملية التي تأخذ البيانات من المصدر الرسمي، وتنظمها، وتحفظها في قاعدة البيانات. وهي «أنبوب» البيانات.
قاعدة البيانات · MariaDB	المكان الذي تُحفظ فيه البيانات بشكل منظم وقابل للاستعلام. منصتنا هي MariaDB، مفتوحة المصدر.
SQL	اللغة المستخدمة للاستعلام عن قاعدة البيانات. لا يحتاج أي موظف إلى معرفتها: فهذا هو دور النموذج والقوالب.
API · API REST	«نافذة» آلية يطلب من خلالها برنامج آخر (Power BI، Tableau، أو صفحة ويب) البيانات ويستلمها فورًا دون تدخل بشري.
مفتاح الوصول · مفتاح API	كلمة مرور طويلة تُمنح لكل جهة للاستعلام عن البيانات عبر النافذة الآلية. لا تقيد الوصول إلى البيانات —التي تكون عامة في أصلها— بل تنسب كل استعلام إلى صاحبه، مع تحديد حد الاستخدام وتسجيل العملية، ريثما يتم إضفاء الطابع الرسمي على النشر المفتوح. تحتفظ المنصة فقط بملخص مشفر للمفتاح؛ ويُعرض القيمة الكاملة مرة واحدة فقط عند إنشائه.
JSON · CSV · XLSX · ZIP	تنسيقات الملفات. JSON: التنسيق الذي تفهمه البرامج. CSV: نص مفصول بفواصل، يفتحه Excel. XLSX: Excel. ZIP: ملف مضغوط.
قالب	الملف Excel أو CSV الذي تولّده المنصة متضمّنًا الأعمدة الدقيقة لعارض معين، مع أمثلة وتعليمات، بحيث لا يتطلّب الأمر سوى ملئه.
عقد الأعمدة	تحديد الأعمدة التي يتكون منها مجموعة البيانات، وترتيبها، وأنواعها. وهذا هو المعيار الذي يُتحقق منه عند تحميل ملف.
الأداة	ملف البيانات الذي تحفظه المنصة وتُصدر منه نسخًا احتياطية بصيغة نسخة احتياطية. اعتبارًا من يوليو 2026، يصبح المصدر الذي يغذي العارض هو الجدول الموجود في قاعدة البيانات؛ ويُحفظ الملف لتمكين تنزيل مجموعة كاملة دفعة واحدة ولإمكانية استعادة نسخة دقيقة.
sha256	«بصمة رقمية» للملف: فإذا تغير حرف واحد فقط، تتغير البصمة. وتُستخدم لإثبات عدم تعديل البيانات وللاستعادة الدقيقة لنسخة سابقة.
الإصدار · التراجع	يُحفظ كل تغيير كإصدار؛ و«التراجع» يعني العودة إلى الإصدار السابق مع بصمة مُتحقَّق منها.
معامَلي	إما يُطبَّق التغيير بالكامل، أو لا يُطبَّق أبدًا: فلا يبقى جزئيًا.
التدقيق · سجل الأحداث	سجل يوضح من نفذ ماذا ومتى.
PHP · Python · JavaScript	لغات البرمجة. PHP: تطبيق الويب. Python: عملية استخراج البيانات وتحويلها وتحميلها (ETL). JavaScript: الرسوم البيانية في المتصفح.
MVC	الشكل القياسي لتنظيم الكود بحيث يتمكن فريق آخر من قراءته وصيانته.
Caddy · PHP-FPM	خادم الويب الذي يستقبل الزيارات ويجدد شهادة الأمان تلقائيًا.
Chart.js · ExcelJS · jsPDF	مكتبات مجانية: الأولى ترسم الرسوم البيانية، والثانية تولّد كتاب Excel للتنزيل، والثالثة تُنتج PDF بورقة رسمية.
جدول	ورقة عمل إلكترونية خاضعة لقواعد محددة: فكل عمود يحمل اسمًا ثابتًا ويقبل نوعًا واحدًا فقط من البيانات، وبالتالي لا يمكن إدخال نص حيث يُتوقع رقم.
صف · عمود · سجل	الـ صف هو سجل (على سبيل المثال، إدارة في سنة معينة). والـ عمود هو نفس النوع من البيانات عبر جميع الصفوف (على سبيل المثال، الـ PIB).
نوع البيانات	ما الذي تسمح به العمود: عدد صحيح، أو عدد عشري، أو نص، أو سنة. يضمن تحديدها عدم تسرب قيمة غير ممكنة.
قاموس البيانات	قائمة أعمدة الجدول التي تشرح محتوى كل عمود. يتم نشرها وحسابها مباشرة في كيفية عمل المنصة.
المخطط · الترحيل	المخطط: مجموعة الجداول والأعمدة في قاعدة البيانات. الترحيل: تغيير في هذا الهيكل، مُرقَّم ومُسجَّل، يمكن إعادة تطبيقه دون تكرار أي بيانات.
عرض في جدول	تحويل ملف بيانات إلى صفوف وأعمدة في قاعدة البيانات، مع تحديد نوعها الصحيح. وهي الخطوة التي تجعل أداة العرض غير مضطرة لفتح أي ملف.
القاعدة هي المرجع	النموذج الساري منذ يوليو 2026: حيث إن قاعدة البيانات هي ما يُقدَّم إلى العارض وAPI، بينما تظل الملفات كنسخة احتياطية. وكان الأمر عكس ذلك سابقًا.
المؤشر (قاعدة بيانات)	اختصار داخلي للعثور بسرعة على الصفوف، كفهرس الكتاب. لا يغير البيانات، بل يقلل الوقت اللازم لظهورها.
GeoJSON · الخريطة الكوروبليثية	GeoJSON: الملف الذي يحدد شكل الأقسام الإدارية. الخريطة الكوروبليثية: الخريطة التي تلوّن كل قسم إداري وفقًا لقيمة المؤشر.
Power BI · Tableau	أدوات تجارية للوحات المعلومات. تتصل بـ API وتستخدم البيانات نفسها دون تكرارها.
cron	«منبّه» الخادم: ينفّذ مهمة في وقت محدّد (هنا، الرقابة الأسبوعية).
المستودع	الملف التاريخي للكود، حيث يُسجّل كل تغيير ومن قام به.
الهجرة	تغيير مُصدّر للإصدار خاص بمخطط قاعدة البيانات؛ يمكن إعادة تنفيذه دون التسبب في أي خلل.
DDL · تفريغ قاعدة البيانات	DDL: التعليمات التي تنشئ قاعدة بيانات فارغة. تفريغ قاعدة البيانات: نسخة كاملة من البيانات. باستخدام كليهما، يتم إعادة بناء المنصة من الصفر.
مفتوح المصدر	برمجيات حرة الاستخدام، دون حاجة لدفع رسوم ترخيص أو تجديدها.

الأمن

HTTPS · TLS · شهادة	الاتصال المشفر بين المتصفح والخادم (قفل المتصفح). يتم تجديد الشهادة تلقائيًا.
الإغلاق الافتراضي	في حال فشل التحقق من أي إذن، فإن المنصة لا تعرض البيانات. فالخطأ لا يفتح الباب أبدًا؛ بل يبقيه مغلقًا.
بوابة البيانات	النقطة الموحدة التي تُصدر منها البيانات. تتحقق من الصلاحية وتطبق قطع سريان المفعول قبل تسليم أي بيانات، وبالتالي لا توجد مخرجات متوازية.
Let's Encrypt	الجهة المصدرة لتلك الشهادة، دون تكلفة.
HSTS	يُلزم المتصفح باستخدام الاتصال المُشفَّر دائمًا.
CSP	سياسة أمان المحتوى: تُخبر المتصفح بالضبط أي رمز يمكنه تنفيذه. وهي الدفاع الرئيسي ضد حقن الرموز الضارة.
CSRF	هجوم يجعل المستخدم المصادَق عليه ينفذ إجراءً دون قصد. يحتوي كل نموذج على رمز فريد يمنع ذلك.
حقن SQL	هجوم يحاول إدخال تعليمات في نموذج للتلاعب بقاعدة البيانات. يتم منعه باستخدام استعلامات مُعَلمة.
ARGON2ID · hash	الطريقة التي تُحفَظ بها كلمات المرور: وهي ملخّص غير قابل للعكس. فحتى لو اطّلع شخص على قاعدة البيانات، لا يمكنه استنتاجها.
الدور	صلاحية كل حساب: مسؤول، أو محرر، أو قارئ.
مفتاح API	اعتماد يسمح لبرنامج ما بالوصول إلى البيانات. يتم في قاعدة البيانات حفظ تجزئته (Hash) فقط.
Rate limit	حد أقصى لعدد الطلبات في الدقيقة: يمنع سوء الاستخدام وانقطاع الخدمة.
فحص الثغرات الأمنية	مراجعة آلية للكشف عن ثغرات الأمان المعروفة.

7 · الأسئلة الشائعة

ردود مباشرة للأقاليم والكيانات والفرق التقنية.

¿Qué son los Visores Territoriales?

Son cinco tableros públicos de información territorial (economía y empleo, competitividad, caracterización sectorial, brechas y vocaciones, y cadenas productivas) que apoyan la Metodología Ágil Ajustada (MÁA) de Ruta Milagro - Regiones Más Competitivas. Presentan datos oficiales por departamento y año para que las Comisiones Regionales de Competitividad e Innovación (CRCI) prioricen programas y proyectos.

¿Quién desarrolla y opera esta plataforma?

La plataforma es un bien público digital del Convenio NPA-045-2026 entre iNNpulsa Colombia y FUNDETEC, en el marco de Ruta Milagro - Regiones Más Competitivas del Ministerio de Comercio, Industria y Turismo. FUNDETEC, como aliado operador, aporta el diseño, la infraestructura y el soporte técnico como contrapartida, y al cierre del convenio transfiere la totalidad de los activos técnicos.

¿De dónde salen los datos y cómo sé que son confiables?

Exclusivamente de fuentes oficiales y técnicas públicas: DANE, DNP, Consejo Privado de Competitividad (Índice Departamental de Competitividad), MinTIC, DIAN, SECOP y registros sectoriales. Cada dato declara su fuente verificable (entidad, conjunto de datos, vigencia y enlace) y el puntaje del IDC publicado se corroboró 66/66 contra la base oficial del CPC.

¿Con qué frecuencia se actualizan los visores?

Los datos están al corte más reciente disponible (2024/2025 según la fuente). Un proceso de vigilancia revisa cada semana si las fuentes oficiales publicaron una vigencia nueva y avisa cuando aparece un corte; la incorporación la decide el equipo, que carga la vigencia desde el panel conservando la serie histórica desde 2016. La revisión es automática; la publicación de un año nuevo es una decisión, no un efecto secundario.

¿Necesito registrarme para usar los visores?

No. La consulta de los visores, los manuales y la API de datos abiertos son públicos y gratuitos. Solo el panel de gestión (carga de datos, usuarios, claves) requiere una cuenta con rol autorizado.

¿Puedo descargar los datos o conectarlos a Power BI / Tableau?

Sí. La API v1 entrega los panoramas en JSON (Power BI: Obtener datos → Web) y en CSV descargable (Tableau, Excel). El acceso a los datos se hace con una clave que se emite a cada entidad, con su límite de uso y su registro de consultas; la apertura sin credencial queda sujeta a la autorización de la supervisión del convenio. La autodescripción, que declara el modo vigente, está en /api/v1/capabilities y no requiere clave.

¿Cómo se cargan datos nuevos sin saber SQL?

Desde el panel de gestión, un usuario autorizado sube un archivo CSV o Excel; la plataforma lo valida contra el contrato de columnas del dataset (tipos, departamentos DIVIPOLA, vigencias, duplicados), muestra el resultado y solo entonces permite aplicar. Cada carga queda versionada, auditada y es reversible.

¿Cómo se relaciona esta plataforma con competitivas.gov.co?

Los visores hacen parte del ecosistema del Sistema Nacional de Competitividad e Innovación y están construidos para enlazarse desde el sitio institucional sin duplicar información. El alojamiento definitivo (dominio del Ministerio o infraestructura de iNNpulsa) es una decisión de gobernanza en curso; la arquitectura (subdominio + API + transferencia documentada) admite cualquiera de las opciones.

¿Qué recibe el MinCIT / iNNpulsa al cierre del convenio?

La totalidad de los activos técnicos, desbloqueados: código fuente, scripts y consultas, DDL y dumps de la base de datos, modelo ETL documentado, manuales y acta de entrega firmada — conforme a las páginas 40 a 43 del convenio. La guía de transferencia que acompaña la entrega inventaría cada activo.

¿Cómo se seguirá actualizando la plataforma cuando termine el convenio?

La actualización no depende de ninguna persona ni de ningún proveedor. La vía prevista es el panel de gestión, y admite dos formas sin escribir una línea de código: (1) corregir o agregar el dato uno a uno en un formulario con listas de indicadores, departamentos y municipios; (2) cargar el archivo de la vigencia nueva con la plantilla del propio conjunto, que se descarga desde el panel con sus columnas y sus ejemplos; la plataforma lo valida, muestra el resultado y solo entonces permite aplicar, con reversión en un clic. Además, un equipo técnico puede reejecutar los scripts documentados, y un proceso semanal avisa cuando una fuente publica un corte nuevo para que alguien decida cargarlo. Todo se entrega operativo, documentado y sin licencias comerciales de por medio. La designación de quién administra la plataforma tras la entrega es una decisión institucional de MinCIT e iNNpulsa.

¿La plataforma resiste un escaneo de vulnerabilidades?

Está construida para ello y el operador queda a disposición de la Oficina de Sistemas de Información del Ministerio para el escaneo que esta disponga, en la ventana y con la herramienta que defina, incluyendo la remediación de los hallazgos. Los controles ya implementados incluyen HTTPS obligatorio, Content Security Policy estricta sin código en línea sin firmar, contraseñas con ARGON2ID, protección CSRF, límite de tasa, roles, claves de API almacenadas solo como hash, auditoría de acciones y consultas parametrizadas contra inyección SQL. La plataforma ya superó una auditoría técnica externa sin recomendaciones abiertas.

¿A quién reporto un error o una inconsistencia en un dato?

Al canal del convenio con iNNpulsa Colombia o al correo institucional de Ruta Milagro - Regiones Más Competitivas. Toda corrección se traza: se identifica la fuente oficial, se corrige por carga versionada y queda registrada en la auditoría de la plataforma.

¿La plataforma cumple los lineamientos de los sitios GOV.CO?

La plataforma aplica el Kit de interfaz de usuario del Estado, en su versión 9.2, y las guías de accesibilidad y usabilidad de la Agencia Nacional Digital: barra superior con el logotipo de GOV.CO enlazado al portal único, pie de página institucional con los datos de contacto y el bloque de cierre obligatorio, el color asignado al Ministerio en el Manual de imagen de Gobierno, tipografías Nunito Sans y Verdana, lenguaje claro, HTML semántico y accesible en nivel AA, HTTPS con certificado automático y datos abiertos documentados. El detalle está en la sección de manual de estilo de esta misma página, y el estado de accesibilidad, con sus pendientes, en la página Declaración de Accesibilidad.

ألم تجد إجابة لسؤالك هنا؟ يرجى الاطلاع على الأدلة، أو الوصف الذاتي لـ API، أو التواصل عبر القناة المؤسسية لRuta Milagro - Regiones Más Competitivas.

8 · كيف يعمل داخليًا: الهندسة المعمارية، والبيانات، والجداول

تؤكد هذه البطاقة أن المنصة قابلة للتتبع والنقل. توجد صفحة تثبت ذلك: فهي تنشر نموذج البيانات، وجرد الجداول، وقاموس الأعمدة، وكلها مُقاسة في لحظة فتحها.

24tablas de datos

693.607filas consultables

200columnas descritas

45tablas en total

🗄️ من الملف إلى الجدول

يُعرض كل مجموعة بيانات في جدولها الخاص ضمن قاعدة البيانات، مع تسجيل أسماء الأعمدة وأنواعها. وهذا الجدول —وليس ملفًا— هو ما يستعلم عنه العارض وAPI. وقد تم التحقق من التحويل قيمةً بقيمة: فالنتيجة المُعاد بناؤها مطابقة تمامًا للملف الأصلي.

📖 قاموس البيانات المنشور

محتوى كل عمود من كل مجموعة بيانات، مع اسمه بلغة واضحة ونوع بياناته. هذه هي المعلومات التي تُترك عادةً في وثيقة داخلية؛ هنا يتم نشرها وحسابها تلقائيًا، لذا لا يمكن أن تصبح غير محدثة.

🔍 مَن يرى ماذا، مُوضَّحًا

ما يمكن الاستعلام عنه دون حساب، وما يتطلب حسابًا، وإلى أي سنة تمتد كل مسار. مع تتبع رحلة بيانات حقيقية من البداية إلى النهاية وروابط للتحقق من كل خطوة بشكل شخصي.

عرض كيفية عمل المنصة نموذج البيانات، مُقدَّمًا في شكل بيانات

يُنشَر نموذج البيانات أيضًا كـ بيانات قابلة للاستعلام: وبذلك تستطيع الوزارة التحقق من الهيكلية عبر استعلام، بدلًا من قراءة مخطط.

البيانات متاحة للجميع

استكشف أدوات العرض الخمسة أو قم بربطها بأداة التحليل الخاصة بك.

استكشاف أدوات العرض البيانات المفتوحة (API)