Major UI overhaul and code restructuring

Features implemented:
• Smart breadcrumb navigation system with URL pattern matching
• Public Sans font integration for improved typography
• Comprehensive template partials system for reusable components
• Color-coded resource format badges (CSV, JSON, XML, PDF, XLSX)
• Enhanced CSV/Excel preview functionality using pandas DataFrame.head()
• Mutual exclusive filtering system for topics and organizations
• Resource card optimization with footer-based counts and direct linking

Technical improvements:
• Project restructure: web/ → app/, ekan/ → project/
• Modern dependency management with uv and pyproject.toml
• Custom Django template tags for breadcrumbs and query management
• Bootstrap 5.3.8 integration with enhanced styling
• Database seeding with 5 standardized format types
• Improved data preview with better table rendering and hover effects

UI/UX enhancements:
• Consistent card layouts across datasets, organizations, and topics
• Responsive design improvements with proper spacing
• Enhanced sidebar filtering with clear visual feedback
• Better resource preview with shape information display
• Professional color scheme for format identification

Author: Shaji Ahmed

.env.example

@@ -1,110 +1,34 @@
-# Byte-compiled / optimized / DLL files
+# Python
+*.pyc
 __pycache__/
-*.py[cod]
-*$py.class
-
-# C extensions
-*.so
-
-# Distribution / packaging
 .Python
 build/
 develop-eggs/
 dist/
-downloads/
 eggs/
-.eggs/
 lib/
 lib64/
 parts/
 sdist/
 var/
-wheels/
 *.egg-info/
 .installed.cfg
 *.egg
-MANIFEST
-
-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*.cover
-.hypothesis/
-.pytest_cache/
-
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
-local_settings.py
-db.sqlite3
-
-# Flask stuff:
-instance/
-.webassets-cache
-
-# Scrapy stuff:
-.scrapy
 
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-target/
-
-# Jupyter Notebook
-.ipynb_checkpoints
-
-# pyenv
-.python-version
-
-# celery beat schedule file
-celerybeat-schedule
-
-# SageMath parsed files
-*.sage.py
-
-# Environments
-.env
-.venv
+# Virtual Environment
+.venv/
 env/
-venv/
-ENV/
-env.bak/
-venv.bak/
+.env/
 
-# Spyder project settings
-.spyderproject
-.spyproject
-
-# Rope project settings
-.ropeproject
-
-# mkdocs documentation
-/site
-
-# mypy
-.mypy_cache/
+# Django
+db.sqlite3
+media/
+static_root/
+local_settings.py
 
-# VS Code
+# IDE specific files
+.idea/
 .vscode/
 
-# Uploaded Files
-uploads/
+# Logs
+*.log

.gitignore

@@ -0,0 +1 @@
+3.13

.python-version

@@ -3,17 +3,6 @@ A simplified and 'Easier' version of a Knowledge Archive Network, inspired from
 
 ![alt text](https://github.com/schajee/ekan/blob/master/web/static/images/screenshot.png "Logo Title Text 1")
 
-## Installation
-1. Install Python 3.5+ and PIP
-2. Clone repository (`git clone https://github.com/schajee/ekan.git`)
-3. Create and activate virtual environment (`virtualenv env` and `source env/bin/activate`)
-4. Install dependencies (`pip install -r requirements.txt`)
-5. Copy `.env.example` to `.env` and adjust as required
-6. Build and run migrations (`python manage.py makemigrations` and `python manage.py migrate`)
-7. Create Superuser (`python manage.py createsuperuser` or `python manage.py seed admin`)
-8. Load initial data through fixtures (`python manage.py loaddata init.json`)
-9. Run server (`python manage.py runserver`)
-
 ## Information Architecture
 The system consists of a few basic entities...
 * A Resource is the basic unit of information or data. A resource can be a file or a url to a file that contains data. 
@@ -22,6 +11,3 @@ The system consists of a few basic entities...
 * A Topic is a classification mechanism to tag datasets into thematic areas. This allows users to find related datasets. A dataset can belong to multiple topics. 
 
 In addition, a resource can be of a Format, while a dataset is released under a License. Organisation's managers are Staff users who have access to Admin for editing and managing content.
-
-## Current Status
-EKAN is currently under active development. Contributions, discussions, and especially pull-requests are very welcome.

LICENSE

@@ -2,4 +2,5 @@
 
 
 class ApiConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
     name = 'api'

README.md

@@ -1,21 +1,85 @@
-from django.contrib.auth.models import User, Group
-from web.models import Dataset
 from rest_framework import serializers
+from app.models import Dataset, Organisation, Topic, Resource, License, Format
 
 
-class UserSerializer(serializers.HyperlinkedModelSerializer):
+class LicenseSerializer(serializers.ModelSerializer):
     class Meta:
-        model = User
-        fields = ('url', 'username', 'email', 'groups')
+        model = License
+        fields = ['id', 'title', 'slug', 'description', 'url', 'icon', 'is_open']
 
 
-class GroupSerializer(serializers.HyperlinkedModelSerializer):
+class FormatSerializer(serializers.ModelSerializer):
     class Meta:
-        model = Group
-        fields = ('url', 'name')
+        model = Format
+        fields = ['id', 'title', 'slug', 'description', 'icon', 'mime_type', 'is_data_format']
 
 
-class DatasetSerializer(serializers.HyperlinkedModelSerializer):
+class TopicSerializer(serializers.ModelSerializer):
+    dataset_count = serializers.SerializerMethodField()
+    
+    class Meta:
+        model = Topic
+        fields = ['id', 'title', 'slug', 'description', 'icon', 'color', 'is_featured', 'dataset_count']
+    
+    def get_dataset_count(self, obj):
+        return obj.datasets.filter(is_published=True).count()
+
+
+class OrganisationSerializer(serializers.ModelSerializer):
+    dataset_count = serializers.SerializerMethodField()
+    manager_name = serializers.SerializerMethodField()
+    
+    class Meta:
+        model = Organisation
+        fields = ['id', 'title', 'slug', 'description', 'url', 'logo', 'manager_name', 
+                 'is_active', 'created', 'updated', 'dataset_count']
+    
+    def get_dataset_count(self, obj):
+        return obj.datasets.filter(is_published=True).count()
+    
+    def get_manager_name(self, obj):
+        return obj.manager.get_full_name() if obj.manager else None
+
+
+class ResourceSerializer(serializers.ModelSerializer):
+    format_details = FormatSerializer(source='format', read_only=True)
+    file_size_human = serializers.ReadOnlyField()
+    is_file_upload = serializers.ReadOnlyField()
+    is_external_url = serializers.ReadOnlyField()
+    download_url = serializers.SerializerMethodField()
+    
+    class Meta:
+        model = Resource
+        fields = ['id', 'title', 'slug', 'description', 'file', 'url', 'size', 
+                 'file_size_human', 'mimetype', 'encoding', 'format_details',
+                 'is_preview_available', 'download_count', 'is_file_upload', 
+                 'is_external_url', 'download_url', 'created', 'updated']
+    
+    def get_download_url(self, obj):
+        request = self.context.get('request')
+        if request:
+            from django.urls import reverse
+            return request.build_absolute_uri(
+                reverse('app:resource_download', kwargs={'slug': obj.slug})
+            )
+        return None
+
+
+class DatasetSerializer(serializers.ModelSerializer):
+    organisation_details = OrganisationSerializer(source='organisation', read_only=True)
+    topics_details = TopicSerializer(source='topics', many=True, read_only=True)
+    license_details = LicenseSerializer(source='license', read_only=True)
+    resources = ResourceSerializer(many=True, read_only=True)
+    resource_count = serializers.ReadOnlyField()
+    author_name = serializers.SerializerMethodField()
+    
     class Meta:
         model = Dataset
-        fields = ('title', 'slug')
+        fields = ['id', 'title', 'slug', 'description', 'notes', 'organisation', 
+                 'organisation_details', 'topics', 'topics_details', 'license', 
+                 'license_details', 'author_name', 'maintainer_name', 'maintainer_email',
+                 'is_published', 'is_featured', 'resource_count', 'resources',
+                 'created', 'updated', 'published_date']
+    
+    def get_author_name(self, obj):
+        return obj.author.get_full_name() if obj.author else obj.author.username

api/apps.py

@@ -0,0 +1,15 @@
+from django.urls import path, include
+from rest_framework.routers import DefaultRouter
+from . import views
+
+# Create a router and register our viewsets with it.
+router = DefaultRouter()
+router.register(r'datasets', views.DatasetViewSet)
+router.register(r'organisations', views.OrganisationViewSet)
+router.register(r'topics', views.TopicViewSet)
+router.register(r'resources', views.ResourceViewSet)
+
+# The API URLs are now determined automatically by the router.
+urlpatterns = [
+    path('v1/', include(router.urls)),
+]