first commit

.gitignore

@@ -0,0 +1,113 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Django specific
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+media/
+
+# If you are using the default SQLite database:
+*.sqlite3
+
+# Environment variables
+.env
+*.env
+
+# Virtual environment
+venv/
+env/
+ENV/
+*.virtualenv
+
+# Python egg files
+*.egg
+*.egg-info/
+dist/
+build/
+*.wheel
+
+# Coverage reports
+htmlcov/
+.coverage
+.coverage.*
+
+# Testing
+.pytest_cache/
+.tox/
+.nox/
+*.cover
+*.hypothesis/
+*.pytest_cache/
+.cache/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IDEs and editors
+.vscode/
+.idea/
+*.swp
+*.swo
+*.swn
+*~
+
+# macOS specific files
+.DS_Store
+
+# Docker
+*.log
+docker-compose.override.yml
+*.pid
+*.crt
+*.key
+mssql.*
+
+# Generated static files
+staticfiles/
+node_modules/
+
+# Yarn and npm
+yarn.lock
+package-lock.json
+
+# Pipenv
+Pipfile
+Pipfile.lock
+
+# Gunicorn
+gunicorn.log
+gunicorn.err
+
+# MyPy
+.mypy_cache/
+dmypy.json
+dmypy.json.*/
+
+# Pyre
+.pyre/
+
+# Celery beat schedule file
+celerybeat-schedule
+
+# Sphinx documentation
+docs/_build/
+
+# Temporary files and backups
+*.bak
+*.tmp
+*.temp
+*.old
+*.orig
+*.swp
+*.swo
+*.sw~
+
+# Security sensitive files
+secrets.json

Dockerfile

@@ -0,0 +1,27 @@
+# Use Python 3.10-slim as a base
+FROM python:3.10-slim
+
+# Install system dependencies for MS SQL ODBC (comment out if not using MSSQL)
+# Install system dependencies for MS SQL ODBC and command-line tools
+RUN apt-get update && apt-get install -y curl gnupg apt-transport-https \
+    && curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add - \
+    && curl https://packages.microsoft.com/config/debian/11/prod.list \
+       | tee /etc/apt/sources.list.d/mssql-release.list \
+    && apt-get update && ACCEPT_EULA=Y apt-get install -y msodbcsql18 mssql-tools18 unixodbc-dev \
+    && echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc \
+    && apt-get clean && rm -rf /var/lib/apt/lists/*
+# Set the working directory
+WORKDIR /app
+
+# Copy requirements and install Python dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy the Django project (app/ folder) into the container
+COPY app/ /app/
+
+# Expose Django's default port
+EXPOSE 8000
+
+# Default command: run Django's development server
+CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

app/coi/asgi.py

@@ -0,0 +1,16 @@
+"""
+ASGI config for coi project.
+
+It exposes the ASGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.1/howto/deployment/asgi/
+"""
+
+import os
+
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "coi.settings")
+
+application = get_asgi_application()

app/coi/settings.py

@@ -0,0 +1,133 @@
+"""
+Django settings for coi project.
+
+Generated by 'django-admin startproject' using Django 5.1.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.1/topics/settings/
+
+For the full list of settings and their values, see
+https://docs.djangoproject.com/en/5.1/ref/settings/
+"""
+
+from pathlib import Path
+import os
+
+# Build paths inside the project like this: BASE_DIR / 'subdir'.
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+
+# Quick-start development settings - unsuitable for production
+# See https://docs.djangoproject.com/en/5.1/howto/deployment/checklist/
+
+# SECURITY WARNING: keep the secret key used in production secret!
+SECRET_KEY = "django-insecure-#td578+^qcir9s!0pb7lxh!4tefib7t&x7^p4+=5$vpvujjumn"
+
+# SECURITY WARNING: don't run with debug turned on in production!
+DEBUG = True
+
+ALLOWED_HOSTS = []
+
+
+# Application definition
+
+INSTALLED_APPS = [
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+    "core.apps.CoreConfig"
+]
+
+MIDDLEWARE = [
+    "django.middleware.security.SecurityMiddleware",
+    "django.contrib.sessions.middleware.SessionMiddleware",
+    "django.middleware.common.CommonMiddleware",
+    "django.middleware.csrf.CsrfViewMiddleware",
+    "django.contrib.auth.middleware.AuthenticationMiddleware",
+    "django.contrib.messages.middleware.MessageMiddleware",
+    "django.middleware.clickjacking.XFrameOptionsMiddleware",
+]
+
+ROOT_URLCONF = "coi.urls"
+
+TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.django.DjangoTemplates",
+        "DIRS": [],
+        "APP_DIRS": True,
+        "OPTIONS": {
+            "context_processors": [
+                "django.template.context_processors.debug",
+                "django.template.context_processors.request",
+                "django.contrib.auth.context_processors.auth",
+                "django.contrib.messages.context_processors.messages",
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = "coi.wsgi.application"
+
+
+# Database
+# https://docs.djangoproject.com/en/5.1/ref/settings/#databases
+
+DATABASES = {
+    'default': {
+        'ENGINE': 'mssql',
+        'NAME': os.environ.get('DB_NAME', 'coi_db'),
+        'USER': os.environ.get('DB_USER', 'sa'),
+        'PASSWORD': os.environ.get('DB_PASSWORD', ''),
+        'HOST': os.environ.get('DB_HOST', 'db'),
+        'PORT': os.environ.get('DB_PORT', '1433'),
+        'OPTIONS': {
+            'driver': 'ODBC Driver 18 for SQL Server',
+            'extra_params':  'Encrypt=no',
+        },
+    },
+}
+
+
+# Password validation
+# https://docs.djangoproject.com/en/5.1/ref/settings/#auth-password-validators
+
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        "NAME": "django.contrib.auth.password_validation.UserAttributeSimilarityValidator",
+    },
+    {
+        "NAME": "django.contrib.auth.password_validation.MinimumLengthValidator",
+    },
+    {
+        "NAME": "django.contrib.auth.password_validation.CommonPasswordValidator",
+    },
+    {
+        "NAME": "django.contrib.auth.password_validation.NumericPasswordValidator",
+    },
+]
+
+
+# Internationalization
+# https://docs.djangoproject.com/en/5.1/topics/i18n/
+
+LANGUAGE_CODE = "en-us"
+
+TIME_ZONE = "UTC"
+
+USE_I18N = True
+
+USE_TZ = True
+
+
+# Static files (CSS, JavaScript, Images)
+# https://docs.djangoproject.com/en/5.1/howto/static-files/
+
+STATIC_URL = "static/"
+
+# Default primary key field type
+# https://docs.djangoproject.com/en/5.1/ref/settings/#default-auto-field
+
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"

app/coi/urls.py

@@ -0,0 +1,23 @@
+"""
+URL configuration for coi project.
+
+The `urlpatterns` list routes URLs to views. For more information please see:
+    https://docs.djangoproject.com/en/5.1/topics/http/urls/
+Examples:
+Function views
+    1. Add an import:  from my_app import views
+    2. Add a URL to urlpatterns:  path('', views.home, name='home')
+Class-based views
+    1. Add an import:  from other_app.views import Home
+    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
+Including another URLconf
+    1. Import the include() function: from django.urls import include, path
+    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
+"""
+
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path("admin/", admin.site.urls),
+]

app/coi/wsgi.py

@@ -0,0 +1,16 @@
+"""
+WSGI config for coi project.
+
+It exposes the WSGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.1/howto/deployment/wsgi/
+"""
+
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "coi.settings")
+
+application = get_wsgi_application()

app/core/admin.py

@@ -0,0 +1,9 @@
+from django.contrib import admin
+
+# Register your models here.
+from django.contrib import admin
+from .models import Report
+
+@admin.register(Report)
+class ReportAdmin(admin.ModelAdmin):
+    list_display = ('name', 'created_by', 'created_at', 'updated_at')

app/core/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class CoreConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'core'

app/core/migrations/0001_initial.py

@@ -0,0 +1,27 @@
+# Generated by Django 5.0 on 2024-12-21 13:45
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Report',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=255)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('created_by', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='reports', to=settings.AUTH_USER_MODEL)),
+            ],
+        ),
+    ]

app/core/models.py

@@ -0,0 +1,17 @@
+from django.db import models
+
+# Create your models here.
+from django.contrib.auth.models import User  # Assuming you're using Django's built-in User model
+
+class Report(models.Model):
+    name = models.CharField(max_length=255)  # Name of the report
+    created_by = models.ForeignKey(
+        User,
+        on_delete=models.CASCADE,
+        related_name="reports"
+    )  # Reference to the user who created the report
+    created_at = models.DateTimeField(auto_now_add=True)  # Automatically set when created
+    updated_at = models.DateTimeField(auto_now=True)  # Automatically updated when modified
+
+    def __str__(self):
+        return self.name

app/core/tests.py

@@ -0,0 +1,3 @@
+from django.test import TestCase
+
+# Create your tests here.

app/core/views.py

@@ -0,0 +1,3 @@
+from django.shortcuts import render
+
+# Create your views here.

app/manage.py

@@ -0,0 +1,22 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+
+
+def main():
+    """Run administrative tasks."""
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "coi.settings")
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()

db-init/create-database.sql

@@ -0,0 +1,5 @@
+IF NOT EXISTS (SELECT name FROM sys.databases WHERE name = N'coi_db')
+BEGIN
+    CREATE DATABASE coi_db;
+END;
+GO

docker-compose.yml

@@ -0,0 +1,46 @@
+version: '3.9'
+
+services:
+  db:
+    image: mcr.microsoft.com/mssql/server:2019-latest
+    user: root
+    container_name: mssql_db
+    environment:
+      SA_PASSWORD: "StrongPassw0rd!"
+      ACCEPT_EULA: "Y"
+    ports:
+      - "1433:1433"
+    volumes:
+      - db_data:/var/opt/mssql/data
+      - ./db-init:/init-scripts  # Add this line to mount the initialization script
+      - ./entrypoint.sh:/usr/local/bin/entrypoint.sh
+    #command: /bin/bash -c "/opt/mssql/bin/sqlservr && sleep 5 && /opt/mssql-tools18/bin/sqlcmd -C -S db -U sa -P StrongPassw0rd! -i /init-scripts/create-database.sql"
+    #healthcheck:
+      #test: ["CMD-SHELL", "/opt/mssql-tools18/bin/sqlcmd -C -S localhost -U sa -P StrongPassw0rd! -Q 'SELECT 1'"]
+      #interval: 10s
+      #timeout: 5s
+      #retries: 5
+    entrypoint: ["/usr/local/bin/entrypoint.sh"]
+    restart: always
+
+  web:
+    build: .
+    container_name: django_web
+    volumes:
+      - ./app:/app
+    ports:
+      - "8000:8000"
+    depends_on:
+      db:
+        condition: service_started
+        #condition: service_healthy
+    environment:
+      DB_NAME: "coi_db"
+      DB_USER: "sa"
+      DB_PASSWORD: "StrongPassw0rd!"
+      DB_HOST: "db"
+      DB_PORT: "1433"
+    restart: always
+
+volumes:
+  db_data:

entrypoint.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+# Start SQL Server in the background
+/opt/mssql/bin/sqlservr &
+
+# Wait for SQL Server to start
+echo "Waiting for SQL Server to start..."
+sleep 15
+
+# Run the database initialization script
+echo "Running initialization script..."
+/opt/mssql-tools18/bin/sqlcmd -C -S localhost -U sa -P StrongPassw0rd! -i /init-scripts/create-database.sql
+
+# Wait indefinitely to keep the container running
+wait

requirements.txt

@@ -0,0 +1,39 @@
+Django==5.0
+mssql-django
+pyodbc==4.0.39
+# For filtering and querying
+django-filter  # Simplified filtering
+
+# For tables/grid view
+django-tables2  # HTML table rendering
+
+# For exporting to Excel
+openpyxl  # Generating Excel files
+
+# For API development (optional)
+djangorestframework  # REST API support
+drf-yasg  # Swagger and ReDoc for API documentation (optional)
+
+# Admin enhancements (optional)
+django-import-export  # Export/import for admin
+
+# Authentication enhancements (optional)
+django-allauth  # For user authentication (optional)
+
+# Debugging and performance
+django-debug-toolbar  # Debugging SQL queries and performance issues
+
+# Testing (optional)
+pytest
+pytest-django
+factory-boy  # Test data creation
+
+# Frontend styling (if using Bootstrap or TailwindCSS)
+django-crispy-forms  # Styling for forms
+crispy-bootstrap5  # For Bootstrap 5 support (optional)
+
+# If using TailwindCSS instead of Bootstrap
+django-tailwind  # For TailwindCSS integration
+
+# Cache optimization (optional)
+django-cacheops  # Caching ORM QuerySets