Race-Inventorytools 0.1.0__tar.gz

race_inventorytools-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include requirements.txt
+recursive-include src/flask_crud_competition/templates *.html

race_inventorytools-0.1.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: Race-Inventorytools
+Version: 0.1.0
+Summary: A Flask-Admin inventory CRUD demo application.
+Author: Competition Demo Team
+Keywords: flask,crud,inventory,admin,sqlite
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Flask
+Classifier: Intended Audience :: Education
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: Flask==3.0.0
+Requires-Dist: Flask-SQLAlchemy==3.1.1
+Requires-Dist: Flask-Admin==1.6.1
+Requires-Dist: WTForms==3.1.2
+Requires-Dist: SQLAlchemy>=2.0
+Requires-Dist: Flask-Babel==4.0.0
+
+# Race Inventory CRUD Demo
+
+这是一个用于演示的 Flask-Admin 库存 CRUD 应用，包含产品管理和出入库流水管理。
+
+## 安装运行
+
+```powershell
+python -m pip install Race-Inventorytools
+race-inventory-admin
+```
+
+默认访问地址：
+
+```text
+http://127.0.0.1:5000/admin
+```
+
+可选环境变量：
+
+```powershell
+$env:FLASK_RUN_HOST = "127.0.0.1"
+$env:FLASK_RUN_PORT = "5000"
+$env:FLASK_DEBUG = "1"
+$env:RACE_DEMO_SECRET_KEY = "replace-with-your-secret"
+$env:RACE_INVENTORY_DB = "D:\path\to\data.db"
+```
+
+## 本地打包
+
+```powershell
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+构建产物会生成在 `dist/` 目录。
+
+## 准备离线依赖
+
+```powershell
+.\scripts\download_dependencies.ps1
+```
+
+脚本会把依赖包下载到 `wheelhouse/`，并在已经构建 `dist/` 的情况下把本项目 wheel 一起复制进去。比赛方可用下面命令离线安装：
+
+```powershell
+python -m pip install --no-index --find-links wheelhouse Race-Inventorytools
+```
+
+## 上传 PyPI
+
+```powershell
+python -m twine upload dist/*
+```
+
+建议先上传 TestPyPI 验证：
+
+```powershell
+python -m twine upload --repository testpypi dist/*
+```

race_inventorytools-0.1.0/README.md

@@ -0,0 +1,60 @@
+# Race Inventory CRUD Demo
+
+这是一个用于演示的 Flask-Admin 库存 CRUD 应用，包含产品管理和出入库流水管理。
+
+## 安装运行
+
+```powershell
+python -m pip install Race-Inventorytools
+race-inventory-admin
+```
+
+默认访问地址：
+
+```text
+http://127.0.0.1:5000/admin
+```
+
+可选环境变量：
+
+```powershell
+$env:FLASK_RUN_HOST = "127.0.0.1"
+$env:FLASK_RUN_PORT = "5000"
+$env:FLASK_DEBUG = "1"
+$env:RACE_DEMO_SECRET_KEY = "replace-with-your-secret"
+$env:RACE_INVENTORY_DB = "D:\path\to\data.db"
+```
+
+## 本地打包
+
+```powershell
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+构建产物会生成在 `dist/` 目录。
+
+## 准备离线依赖
+
+```powershell
+.\scripts\download_dependencies.ps1
+```
+
+脚本会把依赖包下载到 `wheelhouse/`，并在已经构建 `dist/` 的情况下把本项目 wheel 一起复制进去。比赛方可用下面命令离线安装：
+
+```powershell
+python -m pip install --no-index --find-links wheelhouse Race-Inventorytools
+```
+
+## 上传 PyPI
+
+```powershell
+python -m twine upload dist/*
+```
+
+建议先上传 TestPyPI 验证：
+
+```powershell
+python -m twine upload --repository testpypi dist/*
+```

race_inventorytools-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "Race-Inventorytools"
+version = "0.1.0"
+description = "A Flask-Admin inventory CRUD demo application."
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [
+    { name = "Competition Demo Team" }
+]
+keywords = ["flask", "crud", "inventory", "admin", "sqlite"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: Flask",
+    "Intended Audience :: Education",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "Flask==3.0.0",
+    "Flask-SQLAlchemy==3.1.1",
+    "Flask-Admin==1.6.1",
+    "WTForms==3.1.2",
+    "SQLAlchemy>=2.0",
+    "Flask-Babel==4.0.0",
+]
+
+[project.scripts]
+race-inventory-admin = "flask_crud_competition.app:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+flask_crud_competition = ["templates/*.html"]

race_inventorytools-0.1.0/requirements.txt

@@ -0,0 +1,6 @@
+Flask==3.0.0
+Flask-SQLAlchemy==3.1.1
+Flask-Admin==1.6.1
+WTForms==3.1.2
+SQLAlchemy>=2.0
+Flask-Babel==4.0.0

race_inventorytools-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

race_inventorytools-0.1.0/src/Race_Inventorytools.egg-info/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: Race-Inventorytools
+Version: 0.1.0
+Summary: A Flask-Admin inventory CRUD demo application.
+Author: Competition Demo Team
+Keywords: flask,crud,inventory,admin,sqlite
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Flask
+Classifier: Intended Audience :: Education
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: Flask==3.0.0
+Requires-Dist: Flask-SQLAlchemy==3.1.1
+Requires-Dist: Flask-Admin==1.6.1
+Requires-Dist: WTForms==3.1.2
+Requires-Dist: SQLAlchemy>=2.0
+Requires-Dist: Flask-Babel==4.0.0
+
+# Race Inventory CRUD Demo
+
+这是一个用于演示的 Flask-Admin 库存 CRUD 应用，包含产品管理和出入库流水管理。
+
+## 安装运行
+
+```powershell
+python -m pip install Race-Inventorytools
+race-inventory-admin
+```
+
+默认访问地址：
+
+```text
+http://127.0.0.1:5000/admin
+```
+
+可选环境变量：
+
+```powershell
+$env:FLASK_RUN_HOST = "127.0.0.1"
+$env:FLASK_RUN_PORT = "5000"
+$env:FLASK_DEBUG = "1"
+$env:RACE_DEMO_SECRET_KEY = "replace-with-your-secret"
+$env:RACE_INVENTORY_DB = "D:\path\to\data.db"
+```
+
+## 本地打包
+
+```powershell
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+构建产物会生成在 `dist/` 目录。
+
+## 准备离线依赖
+
+```powershell
+.\scripts\download_dependencies.ps1
+```
+
+脚本会把依赖包下载到 `wheelhouse/`，并在已经构建 `dist/` 的情况下把本项目 wheel 一起复制进去。比赛方可用下面命令离线安装：
+
+```powershell
+python -m pip install --no-index --find-links wheelhouse Race-Inventorytools
+```
+
+## 上传 PyPI
+
+```powershell
+python -m twine upload dist/*
+```
+
+建议先上传 TestPyPI 验证：
+
+```powershell
+python -m twine upload --repository testpypi dist/*
+```

race_inventorytools-0.1.0/src/Race_Inventorytools.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+MANIFEST.in
+README.md
+pyproject.toml
+requirements.txt
+src/Race_Inventorytools.egg-info/PKG-INFO
+src/Race_Inventorytools.egg-info/SOURCES.txt
+src/Race_Inventorytools.egg-info/dependency_links.txt
+src/Race_Inventorytools.egg-info/entry_points.txt
+src/Race_Inventorytools.egg-info/requires.txt
+src/Race_Inventorytools.egg-info/top_level.txt
+src/flask_crud_competition/__init__.py
+src/flask_crud_competition/__main__.py
+src/flask_crud_competition/app.py
+src/flask_crud_competition/app1.py
+src/flask_crud_competition/demo.py
+src/flask_crud_competition/templates/index.html

race_inventorytools-0.1.0/src/Race_Inventorytools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

race_inventorytools-0.1.0/src/Race_Inventorytools.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+race-inventory-admin = flask_crud_competition.app:main

race_inventorytools-0.1.0/src/Race_Inventorytools.egg-info/requires.txt

@@ -0,0 +1,6 @@
+Flask==3.0.0
+Flask-SQLAlchemy==3.1.1
+Flask-Admin==1.6.1
+WTForms==3.1.2
+SQLAlchemy>=2.0
+Flask-Babel==4.0.0

race_inventorytools-0.1.0/src/Race_Inventorytools.egg-info/top_level.txt

@@ -0,0 +1 @@
+flask_crud_competition

race_inventorytools-0.1.0/src/flask_crud_competition/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

race_inventorytools-0.1.0/src/flask_crud_competition/__main__.py

@@ -0,0 +1,5 @@
+from .app import main
+
+
+if __name__ == "__main__":
+    main()

race_inventorytools-0.1.0/src/flask_crud_competition/app.py

@@ -0,0 +1,388 @@
+import os
+from datetime import datetime
+from pathlib import Path
+
+from flask import Flask, flash, redirect
+from flask_babel import Babel
+from flask_sqlalchemy import SQLAlchemy
+from flask_admin import Admin, AdminIndexView
+from flask_admin.contrib.sqla import ModelView
+from flask_admin.form import SecureForm
+from wtforms import validators
+
+# ===================== 初始化Flask与数据库 =====================
+app = Flask(__name__, instance_relative_config=True)
+Path(app.instance_path).mkdir(parents=True, exist_ok=True)
+
+# 密钥必须配置，表单校验、flash提示依赖；正式环境可通过环境变量覆盖
+app.config["SECRET_KEY"] = os.environ.get(
+    "RACE_DEMO_SECRET_KEY",
+    "race_demo_local_dev_key_change_me"
+)
+
+database_url = os.environ.get("DATABASE_URL")
+if database_url:
+    app.config["SQLALCHEMY_DATABASE_URI"] = database_url
+else:
+    database_path = Path(os.environ.get("RACE_INVENTORY_DB", Path(app.instance_path) / "data.db"))
+    if not database_path.is_absolute():
+        database_path = Path.cwd() / database_path
+    database_path.parent.mkdir(parents=True, exist_ok=True)
+    app.config["SQLALCHEMY_DATABASE_URI"] = f"sqlite:///{database_path.as_posix()}"
+app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False
+# Flask-Admin / WTForms 中文化
+app.config["BABEL_DEFAULT_LOCALE"] = "zh_Hans_CN"
+app.config["BABEL_DEFAULT_TIMEZONE"] = "Asia/Shanghai"
+
+db = SQLAlchemy(app)
+# 固定使用简体中文，后台按钮/提示全部中文化
+babel = Babel(app, locale_selector=lambda: "zh_Hans_CN")
+
+# ===================== 数据库模型（产品表） =====================
+class Product(db.Model):
+    __tablename__ = "product"
+    id = db.Column(db.Integer, primary_key=True, autoincrement=True, comment="主键ID")
+    code = db.Column(db.String(30), unique=True, nullable=False, comment="产品编号(唯一)")
+    name = db.Column(db.String(100), nullable=False, comment="产品名称")
+    count = db.Column(db.Integer, nullable=False, comment="库存数量")
+    price = db.Column(db.Float, nullable=False, comment="单价")
+    remark = db.Column(db.Text, comment="备注信息")
+    stock_records = db.relationship(
+        "StockRecord",
+        back_populates="product",
+        cascade="all, delete-orphan"
+    )
+
+    def __repr__(self):
+        return f"{self.code} - {self.name}"
+
+
+# ===================== 数据库模型（出入库流水表） =====================
+class StockRecord(db.Model):
+    __tablename__ = "stock_record"
+    id = db.Column(db.Integer, primary_key=True, autoincrement=True, comment="主键ID")
+    product_id = db.Column(db.Integer, db.ForeignKey("product.id"), nullable=False, comment="产品ID")
+    type = db.Column(db.String(10), nullable=False, comment="操作类型")
+    quantity = db.Column(db.Integer, nullable=False, comment="出入库数量")
+    before_count = db.Column(db.Integer, nullable=False, default=0, comment="操作前库存")
+    after_count = db.Column(db.Integer, nullable=False, default=0, comment="操作后库存")
+    operator = db.Column(db.String(50), nullable=False, default="管理员", comment="操作人")
+    created_at = db.Column(db.DateTime, nullable=False, default=datetime.now, comment="操作时间")
+    remark = db.Column(db.Text, comment="备注信息")
+    product = db.relationship("Product", back_populates="stock_records")
+
+    def __repr__(self):
+        product_name = self.product.name if self.product else "未知产品"
+        return f"{product_name} {self.type} {self.quantity}"
+
+# ===================== 自定义Admin视图 + 表单校验核心 =====================
+class HiddenAdminIndexView(AdminIndexView):
+    def is_visible(self):
+        return False
+
+
+class ProductAdmin(ModelView):
+    # 开启CSRF安全表单
+    form_base_class = SecureForm
+
+    # 列表页弹窗新增/编辑，不跳转新页面
+    create_modal = True
+    edit_modal = True
+
+    # 补充中文标题（Flask-Babel 覆盖 Create/Save/Delete 等按钮）
+    create_modal_title = "新建产品"
+    edit_modal_title = "编辑产品"
+    details_modal_title = "详情"
+
+    # 页面展示配置
+    column_list = ["id", "code", "name", "count", "price", "remark"]  # 列表显示字段
+    column_searchable_list = ["code", "name"]  # 可搜索字段
+    column_sortable_list = ["id", "count", "price"]  # 可排序
+    column_labels = {
+        "id": "序号",
+        "code": "产品编号",
+        "name": "产品名称",
+        "count": "库存数量",
+
+        "price": "单价(元)",
+        "remark": "备注"
+    }
+
+    # 表单字段顺序
+    form_columns = ["code", "name", "count", "price", "remark"]
+
+    # 全局基础校验规则
+    form_args = {
+        "code": {
+            "validators": [
+                validators.DataRequired(message="产品编号不能为空"),
+                validators.Length(min=3, max=30, message="编号长度3~30位")
+            ]
+        },
+        "name": {
+            "validators": [
+                validators.DataRequired(message="产品名称不能为空"),
+                validators.Length(min=2, max=100, message="名称长度2~100位")
+            ]
+        },
+        "count": {
+            "validators": [validators.InputRequired(message="库存不能为空")]
+        },
+        "price": {
+            "validators": [validators.DataRequired(message="价格不能为空")]
+        }
+    }
+
+    # 【重点：自定义业务校验】仅新增/编辑执行；删除表单无业务字段
+    def validate_form(self, form):
+        # 删除确认表单(DeleteForm)只有 id/csrf，没有 count/code 等字段
+        if not hasattr(form, "code") or not hasattr(form, "count") or not hasattr(form, "price"):
+            return super().validate_form(form)
+
+        # 1. 校验库存不能小于0，出库后允许库存归零
+        if form.count.data is not None and form.count.data < 0:
+            flash("库存数量不能小于0！", "error")
+            return False
+
+        # 2. 校验价格必须大于0
+        if form.price.data is not None and form.price.data <= 0:
+            flash("商品单价必须大于0！", "error")
+            return False
+
+        # 3. 校验产品编号唯一性（区分新增和编辑）
+        code = (form.code.data or "").strip()
+        if not code:
+            return super().validate_form(form)
+
+        # 获取当前编辑对象（编辑时存在，新增为None）
+        model_id = form._obj.id if getattr(form, "_obj", None) else None
+        exist = Product.query.filter_by(code=code).first()
+
+        # 新增：编号已存在
+        if model_id is None and exist:
+            flash(f"编号 {code} 已存在，不可重复！", "error")
+            return False
+        # 编辑：修改为其他已存在编号
+        if model_id is not None and exist and exist.id != model_id:
+            flash(f"编号 {code} 已被其他产品占用！", "error")
+            return False
+
+        return super().validate_form(form)
+
+
+# ===================== 自定义Admin视图（出入库管理） =====================
+class StockRecordAdmin(ModelView):
+    form_base_class = SecureForm
+
+    create_modal = True
+    edit_modal = True
+    can_view_details = True
+
+    create_modal_title = "新建出入库记录"
+    edit_modal_title = "编辑出入库记录"
+    details_modal_title = "出入库详情"
+
+    column_list = [
+        "id",
+        "product",
+        "type",
+        "quantity",
+        "before_count",
+        "after_count",
+        "operator",
+        "created_at",
+        "remark"
+    ]
+    column_searchable_list = ["operator", "remark"]
+    column_sortable_list = ["id", "type", "quantity", "before_count", "after_count", "created_at"]
+    column_filters = ["type", "operator", "created_at"]
+    column_default_sort = ("id", True)
+    column_labels = {
+        "id": "序号",
+        "product": "产品",
+        "type": "类型",
+        "quantity": "数量",
+        "before_count": "操作前库存",
+        "after_count": "操作后库存",
+        "operator": "操作人",
+        "created_at": "操作时间",
+        "remark": "备注"
+    }
+    column_formatters = {
+        "created_at": lambda view, context, model, name: (
+            model.created_at.strftime("%Y-%m-%d %H:%M:%S") if model.created_at else ""
+        )
+    }
+
+    form_columns = ["product", "type", "quantity", "operator", "remark"]
+    form_choices = {
+        "type": [("入库", "入库"), ("出库", "出库")]
+    }
+    form_args = {
+        "product": {
+            "validators": [validators.DataRequired(message="产品不能为空")]
+        },
+        "type": {
+            "validators": [
+                validators.DataRequired(message="类型不能为空"),
+                validators.AnyOf(["入库", "出库"], message="类型只能选择入库或出库")
+            ]
+        },
+        "quantity": {
+            "validators": [validators.DataRequired(message="数量不能为空")]
+        },
+        "operator": {
+            "validators": [
+                validators.DataRequired(message="操作人不能为空"),
+                validators.Length(min=2, max=50, message="操作人长度2~50位")
+            ]
+        }
+    }
+
+    @staticmethod
+    def _stock_effect(record_type, quantity):
+        return quantity if record_type == "入库" else -quantity
+
+    def _get_old_stock_info(self, form):
+        old_model = getattr(form, "_obj", None)
+        if not old_model or not old_model.id:
+            return None
+        return {
+            "product_id": old_model.product_id,
+            "type": old_model.type,
+            "quantity": old_model.quantity
+        }
+
+    def _preview_stock_change(self, product, record_type, quantity, old_info=None):
+        old_effect = 0
+        if old_info and old_info["product_id"] == product.id:
+            old_effect = self._stock_effect(old_info["type"], old_info["quantity"])
+
+        before_count = (product.count or 0) - old_effect
+        after_count = before_count + self._stock_effect(record_type, quantity)
+        return before_count, after_count
+
+    def _preview_old_product_after_rollback(self, old_info, new_product_id):
+        if not old_info or old_info["product_id"] == new_product_id:
+            return None, None
+
+        old_product = Product.query.get(old_info["product_id"])
+        if not old_product:
+            return None, None
+
+        old_effect = self._stock_effect(old_info["type"], old_info["quantity"])
+        return old_product, (old_product.count or 0) - old_effect
+
+    def validate_form(self, form):
+        if not super().validate_form(form):
+            return False
+
+        if not hasattr(form, "product") or not hasattr(form, "type") or not hasattr(form, "quantity"):
+            return True
+
+        product = form.product.data
+        record_type = form.type.data
+        quantity = form.quantity.data
+        old_info = self._get_old_stock_info(form)
+        form._old_stock_info = old_info
+
+        if not product:
+            flash("请选择产品！", "error")
+            return False
+
+        if quantity is None or quantity <= 0:
+            flash("出入库数量必须大于0！", "error")
+            return False
+
+        old_product, old_product_after = self._preview_old_product_after_rollback(old_info, product.id)
+        if old_product and old_product_after < 0:
+            flash(f"调整后 {old_product.name} 的库存会小于0，请先调整相关出库记录！", "error")
+            return False
+
+        before_count, after_count = self._preview_stock_change(product, record_type, quantity, old_info)
+        if after_count < 0:
+            flash(f"库存不足，当前可出库数量为 {before_count}！", "error")
+            return False
+
+        return True
+
+    def on_model_change(self, form, model, is_created):
+        old_info = getattr(form, "_old_stock_info", None)
+        product = model.product
+        before_count, after_count = self._preview_stock_change(
+            product,
+            model.type,
+            model.quantity,
+            old_info
+        )
+
+        if old_info and old_info["product_id"] != product.id:
+            old_product = Product.query.get(old_info["product_id"])
+            if old_product:
+                old_product.count = (old_product.count or 0) - self._stock_effect(
+                    old_info["type"],
+                    old_info["quantity"]
+                )
+
+        model.before_count = before_count
+        model.after_count = after_count
+        product.count = after_count
+
+        return super().on_model_change(form, model, is_created)
+
+    def delete_model(self, model):
+        product = model.product
+        after_count = (product.count or 0) - self._stock_effect(model.type, model.quantity)
+        if after_count < 0:
+            flash("删除该入库记录会导致库存小于0，请先调整相关出库记录！", "error")
+            return False
+
+        try:
+            product.count = after_count
+            self.session.delete(model)
+            self.session.commit()
+            flash("出入库记录删除成功，库存已同步回滚。", "success")
+            return True
+        except Exception:
+            self.session.rollback()
+            raise
+
+# ===================== 初始化后台管理 =====================
+admin = Admin(
+    app,
+    name="管理后台",
+    template_mode="bootstrap3",
+    index_view=HiddenAdminIndexView(url="/admin", endpoint="admin")
+)
+admin.add_view(ProductAdmin(Product, db.session, name="产品管理", category="库存管理"))
+admin.add_view(StockRecordAdmin(StockRecord, db.session, name="出入库管理", category="库存管理"))
+
+
+@app.route("/")
+def index():
+    return redirect("/admin")
+
+
+# ===================== 创建数据库表（程序启动自动执行） =====================
+def init_database():
+    """Create demo tables if they do not exist."""
+    with app.app_context():
+        db.create_all()
+
+
+init_database()
+
+
+def main():
+    host = os.environ.get("FLASK_RUN_HOST", "127.0.0.1")
+    port = int(os.environ.get("FLASK_RUN_PORT", "5000"))
+    debug = os.environ.get("FLASK_DEBUG", "1").lower() in {"1", "true", "yes", "on"}
+
+    init_database()
+    print(f"数据库表初始化完成，访问 http://{host}:{port}/admin 使用后台")
+    app.run(debug=debug, host=host, port=port)
+
+
+# ===================== 启动入口 =====================
+if __name__ == "__main__":
+    main()

race_inventorytools-0.1.0/src/flask_crud_competition/app1.py

@@ -0,0 +1,98 @@
+#   1. 先写 Flask 基础结构：app = Flask(__name__)
+#   2. 再写数据库：数据库文件名、建表函数 init_db()
+#   3. 再写数据库操作函数：查、新增、修改、删除
+#   4. 前端页面已拆分到 templates/index.html
+#   5. 最后写路由：/、/edit/<id>、/save、/del/<id>
+
+#   可以记成一句话：先数据表，再操作函数，再页面，最后接路由。
+
+from flask import Flask, render_template, request, redirect, url_for  # 从 Flask 导入需要用到的工具：创建网站、渲染模板、读取表单、跳转页面、生成路由地址
+import sqlite3  # 导入 Python 自带的 sqlite3 模块，用来操作本地 SQLite 数据库文件
+
+app = Flask(__name__)  # 创建一个 Flask 应用对象，__name__ 表示当前这个 Python 文件
+DB_FILE = "user.db"  # 定义数据库文件名，后面所有数据库操作都连接这个文件
+
+
+# 初始化数据表：程序启动时先保证 user 表存在
+def init_db():  # 定义一个函数，专门负责创建数据库表
+    conn = sqlite3.connect(DB_FILE)  # 连接数据库；如果 user.db 不存在，SQLite 会自动创建
+    c = conn.cursor()  # 创建游标对象，游标可以执行 SQL 语句
+    c.execute('''CREATE TABLE IF NOT EXISTS user
+                 (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, phone TEXT)''')  # 如果 user 表不存在，就创建一个包含 id、name、phone 的表
+    conn.commit()  # 提交更改，让建表操作真正保存到数据库文件
+    conn.close()  # 关闭数据库连接，避免资源一直占用
+
+
+# 查询全部用户：给首页表格使用
+def get_all_users():  # 定义查询函数，返回数据库里所有用户数据
+    conn = sqlite3.connect(DB_FILE)  # 打开数据库连接
+    data = conn.execute("SELECT * FROM user").fetchall()  # 执行查询语句，并用 fetchall 取出全部结果
+    conn.close()  # 查询完成后关闭连接
+    return data  # 把查询到的数据返回给调用者，格式类似 [(1, "张三", "138..."), ...]
+
+
+# 新增用户：把表单里的姓名和电话插入数据库
+def add_user(name, phone):  # 定义新增函数，需要传入 name 和 phone
+    conn = sqlite3.connect(DB_FILE)  # 打开数据库连接
+    conn.execute("INSERT INTO user(name,phone) VALUES (?,?)", (name, phone))  # 用占位符 ? 插入数据，避免直接拼接字符串
+    conn.commit()  # 提交事务，让新增的数据真正写入数据库
+    conn.close()  # 关闭数据库连接
+
+
+# 修改用户：根据 id 更新姓名和电话
+def edit_user(uid, name, phone):  # 定义修改函数，uid 是要修改的用户编号
+    conn = sqlite3.connect(DB_FILE)  # 打开数据库连接
+    conn.execute("UPDATE user SET name=?,phone=? WHERE id=?", (name, phone, uid))  # 按 id 找到对应用户，并更新 name 和 phone
+    conn.commit()  # 提交事务，让修改结果保存
+    conn.close()  # 关闭数据库连接
+
+
+# 删除用户：根据 id 删除一条记录
+def del_user(uid):  # 定义删除函数，uid 是要删除的用户编号
+    conn = sqlite3.connect(DB_FILE)  # 打开数据库连接
+    conn.execute("DELETE FROM user WHERE id=?", (uid,))  # 删除 id 等于 uid 的用户；单个参数也要写成元组，所以这里有逗号
+    conn.commit()  # 提交事务，让删除操作生效
+    conn.close()  # 关闭数据库连接
+
+
+# 首页路由：展示全部数据
+@app.route('/')  # 当浏览器访问 / 时，Flask 会执行下面的 index 函数
+def index():  # 定义首页处理函数
+    return render_template("index.html", list_data=get_all_users(), edit_row=None)  # 渲染前端模板，把用户列表传进去；首页没有编辑对象，所以 edit_row 是 None
+
+
+# 编辑路由：点击编辑按钮后，回填对应用户的数据到表单
+@app.route('/edit/<int:uid>')  # <int:uid> 表示从网址里接收一个整数参数，例如 /edit/3
+def edit(uid):  # uid 会自动接收网址里的用户 id
+    rows = get_all_users()  # 先查询全部用户，表格还要继续展示这些数据
+    target = None  # 先假设没有找到要编辑的那一行
+    for r in rows:  # 遍历所有用户记录
+        if r[0] == uid:  # r[0] 是用户 id，如果等于网址里的 uid，说明找到了
+            target = r  # 把这条记录保存到 target，用来回填表单
+            break  # 找到后就停止循环，没必要继续找
+    return render_template("index.html", list_data=rows, edit_row=target)  # 渲染同一个页面，但把 target 传给 edit_row，实现表单回填
+
+
+# 保存路由：新增和修改共用这一个接口
+@app.route('/save', methods=["POST"])  # 只有 POST 请求才能访问这个地址，因为它负责接收表单提交
+def save():  # 定义保存处理函数
+    uid = request.form.get("id")  # 从表单中取隐藏字段 id；有 id 表示编辑，没有 id 表示新增
+    name = request.form["name"]  # 从表单中取姓名；因为姓名 required，所以这里直接用 [] 读取
+    phone = request.form["phone"]  # 从表单中取电话
+    if uid:  # 如果 uid 有值，说明这次提交是修改已有用户
+        edit_user(uid, name, phone)  # 调用修改函数，按 id 更新数据
+    else:  # 如果 uid 为空，说明这次提交是新增用户
+        add_user(name, phone)  # 调用新增函数，插入一条新数据
+    return redirect(url_for("index"))  # 保存完成后跳转回首页，避免刷新页面重复提交表单
+
+
+# 删除路由：根据网址里的 id 删除用户
+@app.route('/del/<int:uid>')  # 访问 /del/用户id 时，执行下面的 delete 函数
+def delete(uid):  # uid 自动接收网址里的用户 id
+    del_user(uid)  # 调用删除函数，从数据库删除对应用户
+    return redirect(url_for("index"))  # 删除后跳转回首页，重新显示最新列表
+
+
+if __name__ == '__main__':  # 只有直接运行这个文件时，下面的代码才会执行；被别的文件导入时不会执行
+    init_db()  # 启动网站前先初始化数据库表，确保 user 表存在
+    app.run(debug=True)  # 启动 Flask 开发服务器；debug=True 方便开发时看到错误并自动重载

race_inventorytools-0.1.0/src/flask_crud_competition/demo.py

@@ -0,0 +1,31 @@
+from flask import Flask
+from flask_admin import Admin
+from flask_admin.contrib.sqla import ModelView
+from flask_sqlalchemy import SQLAlchemy
+
+app = Flask(__name__)
+app.config['SECRET_KEY'] = 'race_demo_2026_secret_key_123456'
+# 数据库配置
+app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///demo.db'
+app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
+
+db = SQLAlchemy(app)
+
+class User(db.Model):
+    id = db.Column(db.Integer, primary_key=True)
+    name = db.Column(db.String(128))
+
+# 首页路由
+@app.route('/')
+def index():
+    return '<h3>首页</h3><p>后台管理地址：<a href="/admin">/admin</a></p>'
+
+admin = Admin(app, name='My Admin', template_mode='bootstrap3')
+admin.add_view(ModelView(User, db.session))
+
+# 创建数据表
+with app.app_context():
+    db.create_all()
+
+if __name__ == '__main__':
+    app.run(debug=True)

race_inventorytools-0.1.0/src/flask_crud_competition/templates/index.html

@@ -0,0 +1,51 @@
+<!DOCTYPE html> <!-- 声明这是 HTML5 页面 -->
+<html> <!-- HTML 文档开始 -->
+<head> <!-- head 里放网页编码、标题、样式等信息 -->
+    <meta charset="utf-8"> <!-- 设置网页字符编码，避免中文乱码 -->
+    <title>网页CRUD</title> <!-- 浏览器标签页显示的标题 -->
+    <style> /* style 标签里写 CSS，用来控制页面外观 */
+        table{border-collapse: collapse;width:100%;margin:20px 0;} /* 表格边框合并、宽度占满、上下留间距 */
+        td,th{border:1px solid #999;padding:8px 12px} /* 单元格和表头设置边框与内边距 */
+        .form{margin:15px 0;} /* 表单区域上下留一点距离 */
+        input{padding:6px;margin:0 5px;} /* 输入框内部留白，并和旁边元素拉开距离 */
+        button{padding:6px 12px;cursor:pointer} /* 按钮设置大小，鼠标悬停时显示手型 */
+    </style> <!-- CSS 样式结束 -->
+</head> <!-- head 结束 -->
+<body> <!-- body 里放用户能看到的页面内容 -->
+    <h2>人员信息管理（增删改查）</h2> <!-- 页面主标题 -->
+
+    <!-- 新增/编辑表单：新增和编辑共用同一个表单 -->
+    <div class="form"> <!-- 给表单外面套一层 div，方便用 CSS 控制间距 -->
+        <form method="post" action="/save"> <!-- 表单提交方式是 POST，提交地址是 /save -->
+            <input type="hidden" name="id" value="{{ edit_row[0] if edit_row else '' }}"> <!-- 隐藏字段保存用户 id；编辑时有 id，新增时为空 -->
+            姓名：<input name="name" required value="{{ edit_row[1] if edit_row else '' }}"> <!-- 姓名输入框；required 表示必填；编辑时自动回填姓名 -->
+            电话：<input name="phone" value="{{ edit_row[2] if edit_row else '' }}"> <!-- 电话输入框；编辑时自动回填电话 -->
+            <button type="submit">提交保存</button> <!-- 点击后提交表单到 /save -->
+            <a href="/"><button type="button">清空</button></a> <!-- 回到首页，相当于清空编辑状态和输入框 -->
+        </form> <!-- 表单结束 -->
+    </div> <!-- 表单区域结束 -->
+
+    <!-- 数据列表：把数据库里的用户数据展示成表格 -->
+    <table> <!-- 表格开始 -->
+        <tr> <!-- 表头行开始 -->
+            <th>编号</th> <!-- 第一列：用户编号 -->
+            <th>姓名</th> <!-- 第二列：用户姓名 -->
+            <th>电话</th> <!-- 第三列：用户电话 -->
+            <th>操作</th> <!-- 第四列：编辑和删除按钮 -->
+        </tr> <!-- 表头行结束 -->
+        {% for item in list_data %} <!-- Jinja 循环：list_data 里有几条数据，就生成几行表格 -->
+        <tr> <!-- 一条用户数据对应一行 -->
+            <td>{{ item[0] }}</td> <!-- 显示用户 id；item[0] 对应数据库查询结果的第一列 -->
+            <td>{{ item[1] }}</td> <!-- 显示用户姓名；item[1] 对应第二列 -->
+            <td>{{ item[2] }}</td> <!-- 显示用户电话；item[2] 对应第三列 -->
+            <td> <!-- 操作列开始 -->
+                <a href="/edit/{{ item[0] }}"><button>编辑</button></a> <!-- 点击编辑，访问 /edit/用户id，让表单回填这条数据 -->
+                <a href="/del/{{ item[0] }}" onclick="return confirm('确定删除？')"> <!-- 点击删除前先弹出确认框，确认后访问 /del/用户id -->
+                    <button style="background:#f44;color:#fff;border:0">删除</button> <!-- 删除按钮用红色强调危险操作 -->
+                </a> <!-- 删除链接结束 -->
+            </td> <!-- 操作列结束 -->
+        </tr> <!-- 当前用户这一行结束 -->
+        {% endfor %} <!-- Jinja 循环结束 -->
+    </table> <!-- 表格结束 -->
+</body> <!-- 页面主体结束 -->
+</html> <!-- HTML 文档结束 -->