# zhtyyx/ioe

One-Stop Retail Inventory Solution

Repository: https://github.com/zhtyyx/ioe
Canonical: https://ross.abutalabs.com/products/ioe
Homepage: https://ioea.xianist.com/
Language: HTML
License: MIT
License Family: permissive
Last push: 2026-07-07T11:09:47+00:00

## Health v2 (maintenance only)
Score: 61/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 91, release rhythm 35, longevity 37
- inputs: {"age_days": 520, "days_push": 57, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1461, forks 285 (observed 2026-08-28T04:04:47.414197+00:00)

## What it is
IOE is a self-hosted Django web application for retail inventory management, covering product catalogs, stock movements, sales checkout, and member loyalty operations. It bundles inventory counting, reports, operation logs, and backup tools into a single customizable codebase deployable via Docker.

## Use cases
- manage retail store inventory and cashier checkout in one system
- track stock inbound, outbound, and low-stock warnings for a small warehouse
- run a member program with points, recharge, and account balances
- self-host an inventory system I can customize in Django
- count physical inventory and generate sales reports
- look up products by barcode and manage pricing

## When to choose
- you run a small retail store or shop needing product, stock, and sales workflows together
- you want a self-hosted, MIT-licensed alternative to SaaS inventory tools
- you need member loyalty features like points and balances built in
- you want a Django codebase you can extend and deploy yourself, including via Docker

## When to avoid
- you need a full multi-channel e-commerce platform with online storefronts
- you require multi-warehouse enterprise ERP with complex supply chains
- you prefer a non-Python stack or managed cloud service
- you need offline-first POS hardware integration out of the box

## Facets
- artifact type: application
- maturity: active
- function: self-hosted, developer-tools, analytics, backup
- domain: e-commerce, self-hosted, developer-tools, backend
- platform: python, self-hosted, cross-platform
- tags: inventory-management, retail, point-of-sale, django, stock-control, member-management, barcode, docker, web-server

## Member repositories
- zhtyyx/ioe (main) score 61

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:47.414197+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:35:22.537947+00:00, confidence not recorded.
  - readme: https://github.com/zhtyyx/ioe (fetched 2026-08-28T04:04:47.414197+00:00, sha 698efb2fcdeb)
- Data as of 2026-08-30T08:39:29.467469+00:00.