Initial commit: Expense Tracker API with Docker

Author: nexapytech

.dockerignore

@@ -0,0 +1,6 @@
+venv/
+__pycache__/
+*.pyc
+.git
+.gitignore
+node_modules/

.env

@@ -0,0 +1,11 @@
+SECRET_KEY='your_secreat_key'
+
+
+
+
+
+
+
+DB_NAME='expense_tracker_db'
+DB_USER='expense_tracker_2025'
+DB_PASSWORD='expense@nexapytech'

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: Django CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+      - name: Run migrations
+        run: |
+          python manage.py makemigrations    
+
+      - name: Run migrations
+        run: |
+          python manage.py migrate
+
+      - name: Run tests
+        run: |
+          python manage.py test

.gitignore

@@ -0,0 +1,12 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.sqlite3
+*.log
+
+# Virtual environment
+venv/
+
+

Dockerfile

@@ -0,0 +1,35 @@
+# Use official lightweight Python image (Linux-based)
+FROM python:3.11-slim
+
+# Prevent Python from writing .pyc files and unbuffer stdout/stderr
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+
+# Set working directory inside container
+WORKDIR /app
+
+# Install system dependencies required for MySQL & building Python packages
+RUN apt-get update && apt-get install -y \
+    build-essential \
+    default-libmysqlclient-dev \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first (for Docker caching)
+COPY requirements.txt .
+
+# Upgrade pip
+RUN pip install --upgrade pip
+
+# Install the rest of the requirements (Django, mysqlclient, spacy, etc.)
+RUN pip install -r requirements.txt
+
+
+# Copy all project files into the container
+COPY . .
+
+# Expose Django default port
+EXPOSE 8000
+
+# Run migrations and start server
+CMD ["sh", "-c", "python manage.py makemigrations && python manage.py migrate && python manage.py runserver 0.0.0.0:8000"]

LICENSE

@@ -0,0 +1,14 @@
+MIT License
+
+Copyright (c) 2026 Nexapy Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

README.md

@@ -0,0 +1,88 @@
+# Nexpenz API 💰📊
+
+**Nexpenz API** is a simple, fast, and secure backend API for a personal finance
+tracking mobile application.  
+It powers the Nexpenz Android app, enabling users to track income, expenses,
+and view financial summaries — without signup or ads.
+
+---
+
+## 🚀 Features
+
+- ✅ Add income & expenses instantly
+- 📈 Monthly summaries & category-based analytics
+- 🧾 Full transaction history
+- 🌍 Multi-currency support
+- 🔐 API key authentication (no login/signup)
+- 🧡 100% free — no ads, no tracking
+- 🐳 Docker-ready
+- 🧪 CI-tested on Linux
+
+---
+
+## 🛠️ Tech Stack
+
+- **Python 3.11**
+- **Django**
+- **Django REST Framework**
+- **djangorestframework-api-key**
+- **SQLite / PostgreSQL**
+- **Docker & Docker Compose**
+- **GitHub Actions (CI)**
+
+---
+
+## 🐧 OS Support
+
+| OS      | Status |
+|--------|--------|
+| Linux  | ✅ Fully supported & recommended |
+| macOS  | ✅ Supported |
+| Windows| ⚠️ Supported (WSL recommended) |
+
+> **Tested on Linux (Ubuntu). Linux is recommended for production.**
+
+---
+
+### API Authentication
+
+This API uses API Key authentication.
+- Create API Key
+- Log in to Django Admin
+- Navigate to API Keys
+- Create a key
+-Copy it once (shown only once)
+
+or goto nexpenz.nexapytechnologies.com/api/signup  to generate a key
+
+## ⚙️ Local Setup (Linux / Windows)
+
+Follow these steps to run the project locally:
+
+
+
+
+api will be accessible at
+http://locahost:8000
+
+
+##  Example code
+GET /api/transactions/
+X-API-KEY: your_api_key_here
+
+
+## 1. DOWNLOAD APK FILE
+http://locahost:8000/downoad_nexpenz
+
+### 1. Clone the repo
+
+```bash
+git clone https://github.com/nexapytech/Expense-Tracker-app
+cd Expense-Tracker-app
+
+### Docker Setup (Recommended)
+docker build -t nexpenz .
+docker run -p 8000:8000 nexpenz
+
+
+

api/__init__.py

@@ -0,0 +1,5 @@
+from django.contrib import admin
+from .models import AppSetting, AddTransaction
+# Register your models here.
+admin.site.register(AppSetting)
+admin.site.register(AddTransaction)

api/admin.py

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