pharmacy-erp 1.0.0

package/.env.example

@@ -0,0 +1,34 @@
+# ============================================================
+# Pharmacy ERP & POS — Environment Variables
+# Copy this to .env and update values
+# ============================================================
+
+# Application
+APP_NAME=Pharmacy ERP
+APP_ENV=development
+DEBUG=true
+
+# Database
+# For local development (SQLite — no setup needed):
+DATABASE_URL=sqlite+aiosqlite:///./data/pharmacy.db
+
+# For production (PostgreSQL):
+# DATABASE_URL=postgresql+asyncpg://user:password@localhost:5432/pharmacy_erp
+
+# Security
+SECRET_KEY=your-secret-key-change-this-in-production-min-32-chars
+ACCESS_TOKEN_EXPIRE_MINUTES=30
+REFRESH_TOKEN_EXPIRE_DAYS=7
+
+# CORS
+CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000
+
+# Frontend
+NEXT_PUBLIC_API_URL=http://localhost:8000/api/v1
+
+# Redis (optional — for production)
+# REDIS_URL=redis://localhost:6379/0
+
+# File Storage
+UPLOAD_DIR=./data/uploads
+MAX_UPLOAD_SIZE_MB=10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pharmacy ERP Contributors
+
+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, and to permit persons to whom the Software is
+furnished to do so, 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, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,479 @@
+<div align="center">
+
+<img src="img/logo.png" alt="Pharmacy ERP Logo" width="120" />
+
+# Pharmacy ERP & POS System
+
+**A modern, open-source Pharmacy ERP & Point of Sale system built for independent pharmacies, chains, and hospitals.**
+
+*Full Arabic (RTL) & English support · Designed for the Gulf/MENA market*
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![CI](https://github.com/omersx/pharmacy-erp/actions/workflows/ci.yml/badge.svg)](https://github.com/omersx/pharmacy-erp/actions/workflows/ci.yml)
+[![Docker](https://img.shields.io/badge/Docker_Hub-images-2496ED?logo=docker&logoColor=white)](https://hub.docker.com/u/omersx)
+[![npm](https://img.shields.io/npm/v/pharmacy-erp?color=CB3837&logo=npm)](https://www.npmjs.com/package/pharmacy-erp)
+[![Python 3.12+](https://img.shields.io/badge/Python-3.12+-3776AB?logo=python&logoColor=white)](https://python.org)
+[![Node.js 18+](https://img.shields.io/badge/Node.js-18+-339933?logo=node.js&logoColor=white)](https://nodejs.org)
+[![FastAPI](https://img.shields.io/badge/FastAPI-0.115+-009688?logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com)
+[![Next.js 15](https://img.shields.io/badge/Next.js-15-000000?logo=next.js&logoColor=white)](https://nextjs.org)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+
+[Features](#-features) · [Quick Start](#-quick-start) · [Screenshots](#-screenshots) · [Architecture](#-architecture) · [API Docs](#-api-documentation) · [Docker](#-docker-deployment) · [Contributing](#-contributing)
+
+</div>
+
+---
+
+## ✨ Features
+
+<table>
+<tr>
+<td width="50%">
+
+### 🏪 Point of Sale
+- Fullscreen, keyboard-first, touch-friendly POS
+- Barcode/search product lookup
+- Hold & recall sales
+- Split payments (cash, card, credit)
+- Receipt printing (PDF export)
+
+</td>
+<td width="50%">
+
+### 💊 Medicine Management
+- Complete product catalog with categories
+- Batch tracking with expiry dates
+- FEFO (First Expiry, First Out) allocation
+- CSV/Excel bulk import
+- Low stock & expiry alerts
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### 📦 Inventory & Purchasing
+- Append-only inventory ledger
+- Real-time stock levels per branch
+- Purchase orders & goods receipt
+- Supplier management & tracking
+- Automated stock alerts
+
+</td>
+<td width="50%">
+
+### 💰 Sales & Cash Management
+- Sales invoices & returns
+- Cash session management (open/close)
+- Opening float & blind close
+- X-Report & Z-Report generation
+- Customer credit tracking
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### 📊 Reports & Analytics
+- Sales reports (daily, weekly, monthly)
+- Inventory valuation reports
+- Profit & margin analysis
+- Top-selling products
+- Exportable to Excel/PDF
+
+</td>
+<td width="50%">
+
+### 🌍 Enterprise Features
+- **Bilingual**: Full Arabic (RTL) + English
+- **Dark/Light Theme**: Premium UI design
+- **RBAC**: Role-based access control
+- **Multi-branch**: Branch management
+- **Responsive**: Desktop, tablet, & mobile
+
+</td>
+</tr>
+</table>
+
+---
+
+## 📸 Screenshots
+
+> **Coming soon** — Screenshots of the Dashboard, POS, Inventory, and Reports pages will be added here.
+>
+> Want to see the app in action? Follow the [Quick Start](#-quick-start) guide to run it locally in under 5 minutes!
+
+<!-- Uncomment and add your screenshots:
+<div align="center">
+
+| Dashboard | Point of Sale |
+|:---------:|:------------:|
+| ![Dashboard](img/screenshots/dashboard.png) | ![POS](img/screenshots/pos.png) |
+
+| Inventory | Reports |
+|:---------:|:-------:|
+| ![Inventory](img/screenshots/inventory.png) | ![Reports](img/screenshots/reports.png) |
+
+</div>
+-->
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+| Tool | Version | Download |
+|------|---------|----------|
+| **Node.js** | 18+ | [nodejs.org](https://nodejs.org) |
+| **pnpm** | 9+ | `npm install -g pnpm` |
+| **Python** | 3.12+ | [python.org](https://python.org) |
+
+### Option A: One-Command Setup
+
+<details>
+<summary><b>🪟 Windows</b></summary>
+
+```batch
+git clone https://github.com/omersx/pharmacy-erp.git
+cd pharmacy-erp
+start.bat
+```
+
+This will automatically:
+1. Create the `.env` config file
+2. Install all frontend & backend dependencies
+3. Seed the database with demo data
+4. Start both servers
+
+</details>
+
+<details>
+<summary><b>🐧 Linux / 🍎 macOS</b></summary>
+
+```bash
+git clone https://github.com/omersx/pharmacy-erp.git
+cd pharmacy-erp
+chmod +x start.sh
+./start.sh
+```
+
+</details>
+
+### Option B: Step-by-Step
+
+```bash
+# 1. Clone the repository
+git clone https://github.com/omersx/pharmacy-erp.git
+cd pharmacy-erp
+
+# 2. Install root dependencies (concurrently)
+pnpm install
+
+# 3. Setup frontend
+pnpm run setup:frontend
+
+# 4. Setup backend (auto-detects Windows/Linux/macOS)
+pnpm run setup:backend
+
+# 5. Configure environment
+cp .env.example .env   # Linux/macOS
+# copy .env.example .env  # Windows
+
+# 6. Seed demo data
+pnpm run seed
+
+# 7. Start development servers
+pnpm dev
+```
+
+### 🎉 You're Ready!
+
+| Service | URL |
+|---------|-----|
+| 🌐 **Frontend** | [http://localhost:3000](http://localhost:3000) |
+| 🔧 **Backend API** | [http://localhost:8000](http://localhost:8000) |
+| 📚 **API Docs (Swagger)** | [http://localhost:8000/docs](http://localhost:8000/docs) |
+
+### Default Login
+
+| Role | Email | Password |
+|------|-------|----------|
+| Super Admin | `admin@pharmacy.com` | `admin123` |
+
+> ⚠️ **Change the default credentials** before deploying to production!
+
+---
+
+## 🏗️ Architecture
+
+```mermaid
+graph TB
+    subgraph Client
+        A[Browser] -->|HTTP/HTTPS| B[Next.js Frontend]
+    end
+
+    subgraph Frontend["Frontend — Next.js 15"]
+        B --> C[App Router]
+        C --> D[POS Module]
+        C --> E[ERP Dashboard]
+        C --> F[Auth Pages]
+        B --> G[Zustand Store]
+        B --> H[next-intl i18n]
+    end
+
+    subgraph Backend["Backend — FastAPI"]
+        I[API Gateway] --> J[Auth & RBAC]
+        I --> K[Medicines]
+        I --> L[Inventory]
+        I --> M[Sales & POS]
+        I --> N[Purchases]
+        I --> O[Customers]
+        I --> P[Cash Sessions]
+        I --> Q[Reports]
+        I --> R[Admin & Audit]
+    end
+
+    subgraph Data["Data Layer"]
+        S[(SQLite / PostgreSQL)]
+    end
+
+    B -->|REST API| I
+    J --> S
+    K --> S
+    L --> S
+    M --> S
+    N --> S
+    O --> S
+    P --> S
+    Q --> S
+    R --> S
+```
+
+### Project Structure
+
+```
+pharmacy-erp/
+├── frontend/                 # Next.js 15 (App Router)
+│   ├── src/
+│   │   ├── app/              # Routes & pages
+│   │   │   └── [locale]/     # i18n routing (en, ar)
+│   │   │       ├── (app)/    # ERP dashboard pages
+│   │   │       ├── (auth)/   # Login / register
+│   │   │       └── (pos)/    # Point of Sale
+│   │   ├── components/       # Reusable UI components
+│   │   │   ├── ui/           # Base components (Radix UI)
+│   │   │   └── pos/          # POS-specific components
+│   │   ├── lib/              # API client, utilities
+│   │   ├── store/            # Zustand state stores
+│   │   ├── messages/         # i18n translations (en.json, ar.json)
+│   │   └── i18n/             # i18n configuration
+│   ├── Dockerfile
+│   └── package.json
+│
+├── backend/                  # FastAPI (Python 3.12)
+│   ├── app/
+│   │   ├── core/             # Config, database, security, exceptions
+│   │   ├── modules/          # Business logic modules
+│   │   │   ├── auth/         # Authentication & JWT
+│   │   │   ├── users/        # User management
+│   │   │   ├── roles/        # RBAC roles & permissions
+│   │   │   ├── organizations/# Branch management
+│   │   │   ├── medicines/    # Product catalog & batches
+│   │   │   ├── inventory/    # Stock movements & ledger
+│   │   │   ├── sales/        # Invoices, returns, held sales
+│   │   │   ├── purchases/    # Purchase orders
+│   │   │   ├── suppliers/    # Supplier management
+│   │   │   ├── customers/    # Customer & credit management
+│   │   │   ├── cash_sessions/# Cash register sessions
+│   │   │   ├── reports/      # Analytics & reporting
+│   │   │   ├── notifications/# System notifications
+│   │   │   └── admin/        # Audit logs & admin tools
+│   │   ├── main.py           # FastAPI application entry
+│   │   └── seed.py           # Demo data seeder
+│   ├── Dockerfile
+│   └── requirements.txt
+│
+├── nginx/                    # Nginx reverse proxy config
+├── img/                      # Logo and brand assets
+├── docker-compose.yml        # Production deployment
+├── package.json              # Root orchestration scripts
+├── start.bat                 # One-click setup (Windows)
+├── start.sh                  # One-click setup (Linux/macOS)
+├── .env.example              # Environment template
+└── README.md
+```
+
+---
+
+## 🖥️ Tech Stack
+
+| Layer | Technologies |
+|-------|-------------|
+| **Frontend** | [Next.js 15](https://nextjs.org) · [React 19](https://react.dev) · [TypeScript](https://typescriptlang.org) · [Tailwind CSS](https://tailwindcss.com) |
+| **UI Components** | [Radix UI](https://radix-ui.com) · [Lucide Icons](https://lucide.dev) · [Framer Motion](https://framer.com/motion) · [Recharts](https://recharts.org) |
+| **State & i18n** | [Zustand](https://zustand-demo.pmnd.rs) · [next-intl](https://next-intl-docs.vercel.app) |
+| **Backend** | [FastAPI](https://fastapi.tiangolo.com) · [Python 3.12](https://python.org) · [Pydantic v2](https://docs.pydantic.dev) · [SQLAlchemy 2](https://sqlalchemy.org) |
+| **Database** | [SQLite](https://sqlite.org) (dev) · [PostgreSQL](https://postgresql.org) (production) |
+| **Auth** | JWT (httpOnly cookies) · [Argon2](https://github.com/P-H-C/phc-winner-argon2) password hashing |
+| **DevOps** | [Docker](https://docker.com) · [Nginx](https://nginx.org) · [Uvicorn](https://uvicorn.org) |
+
+---
+
+## 📖 API Documentation
+
+Once the backend is running, interactive API documentation is available at:
+
+| Format | URL |
+|--------|-----|
+| **Swagger UI** | [http://localhost:8000/docs](http://localhost:8000/docs) |
+| **ReDoc** | [http://localhost:8000/redoc](http://localhost:8000/redoc) |
+
+### API Modules
+
+| Endpoint Prefix | Module | Description |
+|----------------|--------|-------------|
+| `/api/v1/auth` | Authentication | Login, register, refresh tokens |
+| `/api/v1/medicines` | Medicines | CRUD, batches, categories, import |
+| `/api/v1/inventory` | Inventory | Stock movements, alerts, ledger |
+| `/api/v1/sales` | Sales | Invoices, returns, held sales |
+| `/api/v1/cash-sessions` | Cash Sessions | Open, close, X/Z reports |
+| `/api/v1/customers` | Customers | Customer management, credit |
+| `/api/v1/suppliers` | Suppliers | Supplier directory |
+| `/api/v1/branches` | Branches | Multi-branch management |
+| `/api/v1/reports` | Reports | Sales, inventory, profit analytics |
+| `/api/v1/users` | Users | User management |
+| `/api/v1/roles` | Roles | RBAC roles & permissions |
+| `/api/v1/admin` | Admin | Audit logs, system admin |
+| `/api/v1/notifications` | Notifications | System notifications |
+
+---
+
+## 🐳 Docker Deployment
+
+### Quick Deploy (from Docker Hub)
+
+```bash
+# Pull pre-built images and start
+docker compose up -d
+
+# This starts:
+#   - FastAPI backend  → port 8000
+#   - Next.js frontend → port 3000
+#   - Nginx proxy      → port 80
+```
+
+Or pull images individually:
+
+```bash
+docker pull omersx/pharmacy-erp-backend:latest
+docker pull omersx/pharmacy-erp-frontend:latest
+```
+
+### Build from Source (for contributors)
+
+```bash
+docker compose -f docker-compose.dev.yml up --build
+```
+
+### Production Checklist
+
+- [ ] Change `SECRET_KEY` to a strong random value (32+ characters)
+- [ ] Change default admin credentials
+- [ ] Set `APP_ENV=production` and `DEBUG=false`
+- [ ] Switch database to PostgreSQL
+- [ ] Configure proper `CORS_ORIGINS`
+- [ ] Enable HTTPS via reverse proxy
+- [ ] Set up automated backups
+
+---
+
+## ⚙️ Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `APP_NAME` | Application name | `Pharmacy ERP` |
+| `APP_ENV` | Environment (`development` / `production`) | `development` |
+| `DEBUG` | Enable debug mode | `true` |
+| `DATABASE_URL` | Database connection string | `sqlite+aiosqlite:///./data/pharmacy.db` |
+| `SECRET_KEY` | JWT signing key (change in production!) | `dev-secret-key-...` |
+| `ACCESS_TOKEN_EXPIRE_MINUTES` | Access token TTL | `30` |
+| `REFRESH_TOKEN_EXPIRE_DAYS` | Refresh token TTL | `7` |
+| `CORS_ORIGINS` | Allowed CORS origins (comma-separated) | `http://localhost:3000` |
+| `NEXT_PUBLIC_API_URL` | API URL for the frontend | `http://localhost:8000/api/v1` |
+| `REDIS_URL` | Redis URL (optional, for production) | — |
+| `UPLOAD_DIR` | File upload directory | `./data/uploads` |
+| `MAX_UPLOAD_SIZE_MB` | Max upload file size | `10` |
+
+See [`.env.example`](.env.example) for the full template.
+
+---
+
+## 🌍 Internationalization
+
+Pharmacy ERP ships with complete support for:
+
+| Language | Direction | Status |
+|----------|-----------|--------|
+| 🇬🇧 English | LTR (Left-to-Right) | ✅ Complete |
+| 🇸🇦 العربية (Arabic) | RTL (Right-to-Left) | ✅ Complete |
+
+Switch languages from any page — the entire UI, including layout direction, updates instantly.
+
+**Adding a new language:**
+
+1. Create a new translation file: `frontend/src/messages/<locale>.json`
+2. Add the locale to `frontend/src/i18n/` configuration
+3. All strings are externalized — no hardcoded text in components
+
+---
+
+## 🤝 Contributing
+
+We love contributions! Whether it's fixing bugs, adding features, improving docs, or suggesting ideas — all contributions are welcome.
+
+1. **Fork** the repository
+2. **Create** a feature branch: `git checkout -b feature/amazing-feature`
+3. **Commit** your changes: `git commit -m 'feat: add amazing feature'`
+4. **Push** to the branch: `git push origin feature/amazing-feature`
+5. **Open** a Pull Request
+
+Please read our [Contributing Guide](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md) before getting started.
+
+---
+
+## 🗺️ Roadmap
+
+- [ ] 📱 Mobile app (React Native)
+- [ ] 🔌 Barcode scanner hardware integration
+- [ ] 📊 Advanced analytics dashboard
+- [ ] 🏥 Insurance claims module
+- [ ] 💳 Payment gateway integration
+- [ ] 📧 Email notifications & alerts
+- [ ] 🔄 Real-time sync across branches
+- [ ] 📋 Prescription management
+- [ ] 🧪 Lab integration module
+
+Have a feature idea? [Open a feature request!](../../issues/new?template=feature_request.md)
+
+---
+
+## ⭐ Show Your Support
+
+If this project helps you, give it a ⭐ on GitHub — it means a lot and helps others discover it!
+
+---
+
+## 📄 License
+
+This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.
+
+---
+
+<div align="center">
+
+**Built with ❤️ for pharmacies everywhere**
+
+[Report Bug](../../issues/new?template=bug_report.md) · [Request Feature](../../issues/new?template=feature_request.md) · [Contribute](CONTRIBUTING.md)
+
+</div>

package/backend/Dockerfile

@@ -0,0 +1,44 @@
+FROM python:3.12-slim AS base
+
+LABEL org.opencontainers.image.title="Pharmacy ERP Backend"
+LABEL org.opencontainers.image.description="FastAPI backend for Pharmacy ERP & POS System"
+LABEL org.opencontainers.image.source="https://github.com/omersx/pharmacy-erp"
+LABEL org.opencontainers.image.licenses="MIT"
+
+# ── Dependencies stage ──────────────────────────────────
+FROM base AS deps
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# ── Production stage ────────────────────────────────────
+FROM base AS runner
+
+WORKDIR /app
+
+# Create non-root user
+RUN groupadd --system --gid 1001 appuser && \
+    useradd --system --uid 1001 --gid appuser appuser
+
+# Copy installed packages from deps stage
+COPY --from=deps /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
+COPY --from=deps /usr/local/bin /usr/local/bin
+
+# Copy application code
+COPY . .
+
+# Create data directory
+RUN mkdir -p /app/data && chown -R appuser:appuser /app/data
+
+# Switch to non-root user
+USER appuser
+
+EXPOSE 8000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/docs')" || exit 1
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

package/backend/app/__init__.py

@@ -0,0 +1 @@
+

package/backend/app/core/__init__.py

@@ -0,0 +1 @@
+

package/backend/app/core/audit.py

@@ -0,0 +1,33 @@
+from sqlalchemy.ext.asyncio import AsyncSession
+from app.modules.admin.models import AuditLog
+from app.modules.auth.models import User
+from typing import Optional
+
+async def log_action(
+    db: AsyncSession,
+    action: str,
+    module: str,
+    details: str,
+    user: Optional[User] = None,
+    entity_type: Optional[str] = None,
+    entity_id: Optional[str] = None,
+    ip_address: Optional[str] = None
+):
+    """Log an audit action to the database."""
+    log = AuditLog(
+        user_id=user.id if user else None,
+        user_email=user.email if user else "System",
+        action=action,
+        module=module,
+        entity_type=entity_type,
+        entity_id=str(entity_id) if entity_id else None,
+        details=details,
+        ip_address=ip_address
+    )
+    db.add(log)
+    # Don't commit here — let the caller's transaction handle it
+    # But for standalone audit logs (like login), we flush
+    try:
+        await db.flush()
+    except Exception:
+        pass

package/backend/app/core/config.py

@@ -0,0 +1,16 @@
+from pydantic_settings import BaseSettings, SettingsConfigDict
+from typing import List
+
+class Settings(BaseSettings):
+    APP_NAME: str = "Pharma ERP"
+    APP_ENV: str = "development"
+    DEBUG: bool = True
+    DATABASE_URL: str = "sqlite+aiosqlite:///./data/pharmacy.db"
+    SECRET_KEY: str = "supersecretkey_change_in_production"
+    ACCESS_TOKEN_EXPIRE_MINUTES: int = 120
+    REFRESH_TOKEN_EXPIRE_DAYS: int = 7
+    CORS_ORIGINS: List[str] = ["*"]
+    
+    model_config = SettingsConfigDict(env_file=".env", env_file_encoding="utf-8", extra="ignore")
+
+settings = Settings()

package/backend/app/core/database.py

@@ -0,0 +1,26 @@
+import uuid
+from datetime import datetime
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine, async_sessionmaker
+from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
+from app.core.config import settings
+
+engine = create_async_engine(
+    settings.DATABASE_URL,
+    echo=settings.DEBUG,
+    connect_args={"check_same_thread": False} if settings.DATABASE_URL.startswith("sqlite") else {}
+)
+
+AsyncSessionLocal = async_sessionmaker(bind=engine, class_=AsyncSession, expire_on_commit=False)
+
+class Base(DeclarativeBase):
+    id: Mapped[uuid.UUID] = mapped_column(primary_key=True, default=uuid.uuid4)
+    created_at: Mapped[datetime] = mapped_column(default=datetime.utcnow)
+    updated_at: Mapped[datetime] = mapped_column(default=datetime.utcnow, onupdate=datetime.utcnow)
+
+async def get_db():
+    async with AsyncSessionLocal() as session:
+        yield session
+
+async def init_db():
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)