ተማር ልጄ - Learn for Ethiopia

Django>=4.2 djangorestframework django-cors-headers channels channels-redis psycopg2-binary djangorestframework-simplejwt django-environ requests Pillow django-extensions drf-yasg python-dotenv #!/usr/bin/env python import os import sys def main(): os.environ.setdefault("DJANGO_SETTINGS_MODULE", "temarlije.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?" ) from exc execute_from_command_line(sys.argv) if __name__ == "__main__": main() # temarlije project package import os from django.core.asgi import get_asgi_application from channels.auth import AuthMiddlewareStack from channels.routing import ProtocolTypeRouter, URLRouter import chat.routing os.environ.setdefault("DJANGO_SETTINGS_MODULE", "temarlije.settings") django_asgi_app = get_asgi_application() application = ProtocolTypeRouter({ "http": django_asgi_app, "websocket": AuthMiddlewareStack( URLRouter( chat.routing.websocket_urlpatterns ) ), }) import os from django.core.wsgi import get_wsgi_application os.environ.setdefault("DJANGO_SETTINGS_MODULE", "temarlije.settings") application = get_wsgi_application() import os from pathlib import Path BASE_DIR = Path(__file__).resolve().parent.parent SECRET_KEY = os.environ.get("DJANGO_SECRET_KEY", "replace-this-in-prod") DEBUG = os.environ.get("DJANGO_DEBUG", "True") == "True" ALLOWED_HOSTS = ["*"] INSTALLED_APPS = [ "django.contrib.admin", "django.contrib.auth", "django.contrib.contenttypes", "django.contrib.sessions", "django.contrib.messages", "django.contrib.staticfiles", "rest_framework", "corsheaders", "channels", "drf_yasg", "users", "courses", "payments", "chatbot", "chat", ] MIDDLEWARE = [ "corsheaders.middleware.CorsMiddleware", "django.middleware.security.SecurityMiddleware", "django.contrib.sessions.middleware.SessionMiddleware", "django.middleware.locale.LocaleMiddleware", "django.middleware.common.CommonMiddleware", "django.middleware.csrf.CsrfViewMiddleware", "django.contrib.auth.middleware.AuthenticationMiddleware", "django.contrib.messages.middleware.MessageMiddleware", "django.middleware.clickjacking.XFrameOptionsMiddleware", ] ROOT_URLCONF = "temarlije.urls" TEMPLATES = [ { "BACKEND": "django.template.backends.django.DjangoTemplates", "DIRS": [BASE_DIR / "templates"], "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 = "temarlije.wsgi.application" ASGI_APPLICATION = "temarlije.asgi.application" # Channels (Redis recommended in production) CHANNEL_LAYERS = { "default": { "BACKEND": "channels.layers.InMemoryChannelLayer" # For production use redis: # "BACKEND": "channels_redis.core.RedisChannelLayer", # "CONFIG": {"hosts": [("redis", 6379)]}, } } DATABASES = { "default": { "ENGINE": "django.db.backends.sqlite3", "NAME": BASE_DIR / "db.sqlite3", } } AUTH_USER_MODEL = "users.User" REST_FRAMEWORK = { "DEFAULT_AUTHENTICATION_CLASSES": ( "rest_framework_simplejwt.authentication.JWTAuthentication", ), "DEFAULT_PERMISSION_CLASSES": ( "rest_framework.permissions.IsAuthenticatedOrReadOnly", ), } LANGUAGE_CODE = "en-us" TIME_ZONE = "Africa/Addis_Ababa" USE_I18N = True USE_TZ = True # Internationalization - provide Amharic and English from django.utils.translation import gettext_lazy as _ LANGUAGES = [ ("en", _("English")), ("am", _("አማርኛ")), ] LOCALE_PATHS = [BASE_DIR / "locale"] STATIC_URL = "/static/" STATIC_ROOT = BASE_DIR / "staticfiles" MEDIA_URL = "/media/" MEDIA_ROOT = BASE_DIR / "media" CORS_ALLOW_ALL_ORIGINS = True DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField" from django.contrib import admin from django.urls import path, include from rest_framework import routers from users.views import UserViewSet from courses.views import CourseViewSet, LessonViewSet from payments.views import ChapaInitView, ChapaVerifyView from chatbot.views import AIChatView from django.conf import settings from django.conf.urls.static import static router = routers.DefaultRouter() router.register(r"users", UserViewSet) router.register(r"courses", CourseViewSet) router.register(r"lessons", LessonViewSet) urlpatterns = [ path("admin/", admin.site.urls), path("api/", include(router.urls)), path("api/payments/init/", ChapaInitView.as_view(), name="chapa-init"), path("api/payments/verify/", ChapaVerifyView.as_view(), name="chapa-verify"), path("api/ai/chat/", AIChatView.as_view(), name="ai-chat"), path("api/auth/", include("rest_framework.urls")), ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) from django.apps import AppConfig class UsersConfig(AppConfig): default_auto_field = "django.db.models.BigAutoField" name = "users" from django.db import models from django.contrib.auth.models import AbstractUser class User(AbstractUser): is_teacher = models.BooleanField(default=False) is_student = models.BooleanField(default=True) profile_image = models.ImageField(upload_to="profiles/%Y/%m/", blank=True, null=True) bio = models.TextField(blank=True) def __str__(self): return self.username from django.contrib import admin from .models import User from django.contrib.auth.admin import UserAdmin @admin.register(User) class CustomUserAdmin(UserAdmin): list_display = ("username", "email", "is_teacher", "is_student", "is_staff") search_fields = ("username", "email") from rest_framework import serializers from .models import User class UserSerializer(serializers.ModelSerializer): class Meta: model = User fields = ("id", "username", "email", "first_name", "last_name", "is_teacher", "is_student", "profile_image", "bio") from rest_framework import viewsets, permissions from .models import User from .serializers import UserSerializer class UserViewSet(viewsets.ModelViewSet): queryset = User.objects.all().order_by("username") serializer_class = UserSerializer permission_classes = [permissions.IsAuthenticatedOrReadOnly] from django.apps import AppConfig class CoursesConfig(AppConfig): default_auto_field = "django.db.models.BigAutoField" name = "courses" from django.db import models from django.conf import settings class Course(models.Model): LEVEL_CHOICES = [ ("9", "Grade 9"), ("10", "Grade 10"), ("11", "Grade 11"), ("12", "Grade 12"), ("prog", "Programming"), ] title = models.CharField(max_length=255) slug = models.SlugField(unique=True) description = models.TextField() teacher = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.SET_NULL, null=True, related_name="courses") cover_image = models.ImageField(upload_to="courses/covers/", blank=True, null=True) level = models.CharField(max_length=10, choices=LEVEL_CHOICES, default="9") is_premium = models.BooleanField(default=False) price = models.DecimalField(max_digits=8, decimal_places=2, default=0.00) created_at = models.DateTimeField(auto_now_add=True) def __str__(self): return self.title class Lesson(models.Model): course = models.ForeignKey(Course, on_delete=models.CASCADE, related_name="lessons") title = models.CharField(max_length=255) slug = models.SlugField() video = models.URLField(blank=True, null=True) content = models.TextField(blank=True) order = models.PositiveIntegerField(default=0) class Meta: ordering = ["order"] def __str__(self): return f"{self.course.title} - {self.title}" class FlashCard(models.Model): lesson = models.ForeignKey(Lesson, on_delete=models.CASCADE, related_name="flashcards") question = models.TextField() answer = models.TextField() class Exam(models.Model): course = models.ForeignKey(Course, on_delete=models.CASCADE, related_name="exams") title = models.CharField(max_length=255) description = models.TextField(blank=True) created_at = models.DateTimeField(auto_now_add=True) from django.contrib import admin from .models import Course, Lesson, FlashCard, Exam @admin.register(Course) class CourseAdmin(admin.ModelAdmin): list_display = ("title", "slug", "teacher", "level", "is_premium", "price") prepopulated_fields = {"slug": ("title",)} @admin.register(Lesson) class LessonAdmin(admin.ModelAdmin): list_display = ("title", "course", "order") prepopulated_fields = {"slug": ("title",)} @admin.register(FlashCard) class FlashCardAdmin(admin.ModelAdmin): list_display = ("lesson", "question") @admin.register(Exam) class ExamAdmin(admin.ModelAdmin): list_display = ("title", "course", "created_at") from rest_framework import serializers from .models import Course, Lesson, FlashCard, Exam from users.serializers import UserSerializer class LessonSerializer(serializers.ModelSerializer): class Meta: model = Lesson fields = "__all__" class CourseSerializer(serializers.ModelSerializer): teacher = UserSerializer(read_only=True) lessons = LessonSerializer(many=True, read_only=True) class Meta: model = Course fields = "__all__" class FlashCardSerializer(serializers.ModelSerializer): class Meta: model = FlashCard fields = "__all__" class ExamSerializer(serializers.ModelSerializer): class Meta: model = Exam fields = "__all__" from rest_framework import viewsets, permissions from .models import Course, Lesson from .serializers import CourseSerializer, LessonSerializer class IsTeacherOrReadOnly(permissions.BasePermission): def has_permission(self, request, view): if request.method in permissions.SAFE_METHODS: return True return request.user and request.user.is_authenticated and request.user.is_teacher class CourseViewSet(viewsets.ModelViewSet): queryset = Course.objects.all().order_by("-created_at") serializer_class = CourseSerializer permission_classes = [IsTeacherOrReadOnly] def perform_create(self, serializer): serializer.save(teacher=self.request.user) class LessonViewSet(viewsets.ModelViewSet): queryset = Lesson.objects.all() serializer_class = LessonSerializer permission_classes = [IsTeacherOrReadOnly] from django.apps import AppConfig class PaymentsConfig(AppConfig): default_auto_field = "django.db.models.BigAutoField" name = "payments" from django.db import models from django.conf import settings class Order(models.Model): user = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE, related_name="orders") course = models.ForeignKey("courses.Course", on_delete=models.CASCADE, related_name="orders") amount = models.DecimalField(max_digits=8, decimal_places=2) chapa_checkout_url = models.URLField(blank=True, null=True) chapa_reference = models.CharField(max_length=255, blank=True, null=True) paid = models.BooleanField(default=False) created_at = models.DateTimeField(auto_now_add=True) def __str__(self): return f"Order {self.id} - {self.user}" from django.contrib import admin from .models import Order @admin.register(Order) class OrderAdmin(admin.ModelAdmin): list_display = ("id", "user", "course", "amount", "paid", "created_at") import os import requests from rest_framework.views import APIView from rest_framework.response import Response from rest_framework import status, permissions from .models import Order from courses.models import Course CHAPA_SECRET = os.environ.get("CHAPA_SECRET", "your-chapa-secret") CHAPA_BASE = "https://api.chapa.co/v1/transaction/initialize" class ChapaInitView(APIView): permission_classes = [permissions.IsAuthenticated] def post(self, request): course_id = request.data.get("course_id") try: course = Course.objects.get(id=course_id) except Course.DoesNotExist: return Response({"detail": "Course not found"}, status=status.HTTP_404_NOT_FOUND) amount = float(course.price) order = Order.objects.create(user=request.user, course=course, amount=amount) # Create Chapa initialize payload payload = { "amount": str(amount), "email": request.user.email, "full_name": f"{request.user.first_name} {request.user.last_name}", "tx_ref": f"order_{order.id}", "currency": "ETB", "callback_url": request.build_absolute_uri("/api/payments/verify/"), } headers = {"Authorization": f"Bearer {CHAPA_SECRET}"} # In production you must call Chapa API. Here we show placeholder. try: # resp = requests.post(CHAPA_BASE, json=payload, headers=headers) # data = resp.json() # For demo stub: data = {"status": "success", "data": {"checkout_url": "https://checkout.chapa.com/demo", "reference": "ref_demo"}} order.chapa_checkout_url = data["data"]["checkout_url"] order.chapa_reference = data["data"]["reference"] order.save() return Response({"checkout_url": order.chapa_checkout_url, "order_id": order.id}) except Exception: return Response({"detail": "Payment initialization failed"}, status=status.HTTP_500_INTERNAL_SERVER_ERROR) class ChapaVerifyView(APIView): permission_classes = [permissions.AllowAny] def get(self, request): reference = request.query_params.get("reference") try: order = Order.objects.get(chapa_reference=reference) except Order.DoesNotExist: return Response({"detail": "Order not found"}, status=status.HTTP_404_NOT_FOUND) # Verify with Chapa here. For demo we set as paid. order.paid = True order.save() return Response({"status": "paid", "order_id": order.id}) from django.apps import AppConfig class ChatbotConfig(AppConfig): default_auto_field = "django.db.models.BigAutoField" name = "chatbot" import os from rest_framework.views import APIView from rest_framework.response import Response from rest_framework import permissions, status # This endpoint proxies AI chat. Integrate with your preferred provider (OpenAI, local LLM, etc.) OPENAI_API_KEY = os.environ.get("OPENAI_API_KEY", None) class AIChatView(APIView): permission_classes = [permissions.AllowAny] def post(self, request): message = request.data.get("message", "") language = request.data.get("language", "en") # For security do not include direct keys here. Implement server-side provider call. # Demo response below: reply = { "en": f"Hello! This is a demo AI response to: {message}", "am": f"ሰላም! ይህ የAI መልስ ነው፡ {message}", } return Response({"reply": reply.get(language, reply["en"])}, status=status.HTTP_200_OK) from django.apps import AppConfig class ChatConfig(AppConfig): default_auto_field = "django.db.models.BigAutoField" name = "chat" import json from channels.generic.websocket import AsyncWebsocketConsumer class GroupChatConsumer(AsyncWebsocketConsumer): async def connect(self): self.room_name = self.scope['url_route']['kwargs']['room_name'] self.group_name = f"group_{self.room_name}" await self.channel_layer.group_add(self.group_name, self.channel_name) await self.accept() async def disconnect(self, close_code): await self.channel_layer.group_discard(self.group_name, self.channel_name) async def receive(self, text_data=None, bytes_data=None): data = json.loads(text_data) await self.channel_layer.group_send( self.group_name, { "type": "chat.message", "message": data.get("message"), "user": self.scope["user"].username if self.scope["user"].is_authenticated else "anonymous", } ) async def chat_message(self, event): await self.send(text_data=json.dumps({ "message": event["message"], "user": event["user"], })) from django.urls import re_path from . import consumers websocket_urlpatterns = [ re_path(r"ws/group/(?P\w+)/$", consumers.GroupChatConsumer.as_asgi()), ] # Chat app ተማር ልጄ - Django + React E-Learning Platform ============================================== This repository is a starter full-stack platform for Ethiopian high school students (Grades 9-12) and programming courses. It contains: - Django backend with REST API (DRF) - Channels-based group chat (WebSockets) - AI chatbot endpoint (proxy stub, integrate your provider) - Chapa payment integration placeholders - React frontend skeleton with i18n (English / Amharic), dark/light themes, animations, chatbot and group study UI Instructions: 1. Create a Python virtualenv, install requirements.txt 2. Set environment variables (DJANGO_SECRET_KEY, CHAPA_SECRET, OPENAI_API_KEY) 3. Run migrations: python manage.py migrate 4. Create superuser: python manage.py createsuperuser 5. Run server: python manage.py runserver 6. Run frontend: cd frontend && npm install && npm start Customize and enhance as needed for production deployment. { "name": "temarlije-frontend", "version": "0.1.0", "private": true, "dependencies": { "react": "^18.2.0", "react-dom": "^18.2.0", "react-scripts": "5.0.1", "axios": "^1.4.0", "react-router-dom": "^6.14.1", "i18next": "^23.0.1", "react-i18next": "^13.0.4", "socket.io-client": "^4.7.2", "animejs": "^3.2.1", "framer-motion": "^10.12.16" }, "scripts": { "start": "react-scripts start", "build": "react-scripts build" } } ተማር ልጄ - Learn for Ethiopia

import React from "react"; import { createRoot } from "react-dom/client"; import App from "./App"; import "./styles.css"; import "./i18n"; const root = createRoot(document.getElementById("root")); root.render(); import i18n from "i18next"; import { initReactI18next } from "react-i18next"; const resources = { en: { translation: { "title": "Temar Lije", "home_welcome": "Welcome to Temar Lije - Learn for Ethiopia", "about_title": "About Us", "about_content": "Temar Lije is a dedicated platform for Ethiopian high school students..." } }, am: { translation: { "title": "ተማር ልጄ", "home_welcome": "እንኳን ደህና መጡ - ተማር ልጄ", "about_title": "ስለ እኛ", "about_content": "ተማር ልጄ ለየሚማሩ የኢትዮጵያ ተማሪዎች የተሰራ መድረክ ነው..." } } }; i18n .use(initReactI18next) .init({ resources, lng: "en", fallbackLng: "en", interpolation: { escapeValue: false } }); export default i18n; import axios from "axios"; const API_BASE = process.env.REACT_APP_API_BASE || "http://localhost:8000/api"; export const api = axios.create({ baseURL: API_BASE, }); export async function fetchCourses() { const res = await api.get("/courses/"); return res.data; } export async function initPayment(course_id, token) { const res = await api.post("/payments/init/", { course_id }, { headers: { Authorization: `Bearer ${token}` } }); return res.data; } export async function postAI(message, language="en") { const res = await axios.post((process.env.REACT_APP_API_BASE || "http://localhost:8000") + "/api/ai/chat/", { message, language }); return res.data; } :root { --bg: #0f172a; --card: #111827; --accent: #06b6d4; --text: #e6eef6; } [data-theme="light"] { --bg: #f8fafc; --card: #ffffff; --accent: #0ea5a5; --text: #0f172a; } html, body, #root { height: 100%; margin: 0; font-family: Inter, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial; background: linear-gradient(180deg, var(--bg), #071124); color: var(--text); } .navbar { display:flex; align-items:center; justify-content:space-between; gap:1rem; padding:1rem 2rem; position:sticky; top:0; backdrop-filter: blur(6px); background: rgba(0,0,0,0.25); } .brand { display:flex; align-items:center; gap:0.75rem; font-weight:700; font-size:1.25rem; } .brand img { width:40px; height:40px; border-radius:8px; object-fit:cover; } .nav-links { display:flex; gap:1rem; align-items:center; } .btn { padding:0.5rem 0.9rem; border-radius:8px; background:var(--accent); color:#fff; border:none; cursor:pointer; } .container { padding:2rem; max-width:1200px; margin:0 auto; } .grid { display:grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap:1rem; } .card { background: linear-gradient(180deg, rgba(255,255,255,0.03), rgba(255,255,255,0.01)); padding:1rem; border-radius:12px; box-shadow: 0 8px 30px rgba(2,6,23,0.6); } .footer { margin-top:3rem; padding:2rem; text-align:center; opacity:0.8; } .chatbox { display:flex; flex-direction:column; gap:0.5rem; } .chat-messages { max-height:300px; overflow:auto; padding:1rem; background:rgba(0,0,0,0.15); border-radius:8px; } import React from "react"; import { useTranslation } from "react-i18next"; export default function Navbar({ theme, setTheme }) { const { t, i18n } = useTranslation(); const toggleTheme = () => setTheme(theme === "dark" ? "light" : "dark"); const changeLang = (lang) => i18n.changeLanguage(lang); return ( ); } import React, { useEffect, useState } from "react"; import { fetchCourses } from "../api"; import CourseCard from "./CourseCard"; import { useTranslation } from "react-i18next"; import { motion } from "framer-motion"; export default function Home() { const { t } = useTranslation(); const [courses, setCourses] = useState([]); useEffect(() => { (async () => { try { const data = await fetchCourses(); setCourses(data); } catch (e) { // fallback demo cards setCourses([]); } })(); }, []); return (

{t("home_welcome")}

Featured Courses

{courses.length ? courses.map(c => ) : ( [1,2,3,4].map(i => ) )}

About Us

ተማር ልጄ is crafted to empower Ethiopian students (Grades 9-12) with high-quality curriculum-aligned content, interactive lessons, flashcards, exams and modern programming courses like Python, Django, and React. We combine AI-powered tutoring, group study rooms, and seamless premium access via Chapa to deliver localized, accessible education.

Our platform supports Amharic and English, offers dark/light themes, and provides an instructor-friendly admin dashboard for content management. Join group studies, use the AI chatbot for personalized help, and access structured exam preparation.

); } import React from "react"; export default function CourseCard({ course }) { return (

{course.title}

{course.description}

{course.is_premium ? `${course.price} ETB` : "Free"}

); } import React, { useState } from "react"; import { postAI } from "../api"; import { useTranslation } from "react-i18next"; export default function Chatbot() { const { i18n } = useTranslation(); const [message, setMessage] = useState(""); const [messages, setMessages] = useState([]); const send = async () => { if (!message) return; setMessages(prev => [...prev, {from:"user", text:message}]); try { const res = await postAI(message, i18n.language); setMessages(prev => [...prev, {from:"ai", text:res.reply}]); } catch (e) { setMessages(prev => [...prev, {from:"ai", text:"AI service unavailable."}]); } setMessage(""); }; return (

AI Tutor

{messages.map((m, i) =>

{m.from}: {m.text}

)}

setMessage(e.target.value)} placeholder="Ask your question..." style={{flex:1, padding:"0.6rem", borderRadius:8}}/>

); } import React, { useEffect, useState, useRef } from "react"; export default function GroupStudy({ roomName = "math101" }) { const [messages, setMessages] = useState([]); const [text, setText] = useState(""); const ws = useRef(null); useEffect(() => { const protocol = window.location.protocol === "https:" ? "wss" : "ws"; const url = `${protocol}://${window.location.hostname}:8000/ws/group/${roomName}/`; ws.current = new WebSocket(url); ws.current.onmessage = (e) => { const data = JSON.parse(e.data); setMessages(prev => [...prev, data]); }; return () => ws.current.close(); }, [roomName]); const send = () => { if (!text) return; ws.current.send(JSON.stringify({message: text})); setText(""); }; return (

Group Study - {roomName}

{messages.map((m, i) =>

{m.user}: {m.message}

)}

setText(e.target.value)} style={{flex:1, padding:8, borderRadius:6}}/>

); } import React, { useEffect, useState } from "react"; import Navbar from "./components/Navbar"; import Home from "./components/Home"; import Chatbot from "./components/Chatbot"; import GroupStudy from "./components/GroupStudy"; function App() { const [theme, setTheme] = useState("dark"); useEffect(() => { document.documentElement.setAttribute("data-theme", theme); }, [theme]); return (

Courses & Materials

Accessnotes, videos, flashcards and exams. Admins manage everything from the Django admin dashboard.

Premium Content

Purchase premium courses via Chapa. Secure checkout and access controls are handled by backend.

); } export default App;