Set up dev environment (Python 3.8 + MariaDB) and add AGENTS.md

[soaringsoul]

Summary

Sets up a working development environment for this legacy Flask-AppBuilder 1.12.0 admin app ("数喆数据管理后台" / API 管理中心), which requires an old Python stack and a MySQL/MariaDB backend. No application code was modified.

What was done

• Installed a Python 3.8 virtualenv (via uv) at /workspace/venv with an era-appropriate pinned dependency set. Old pins are required because run.py imports werkzeug.contrib.fixers (removed in Werkzeug ≥ 1.0) and the app pins flask-appbuilder==1.12.0 / SQLAlchemy==1.2.12.
• Worked around flask-openid==1.2.5's use_2to3 build failure by installing setuptools<58 and using --no-build-isolation.
• Installed and started MariaDB, created the hardcoded api_manager database and root/adas123456 credentials from config.py, and created an admin user (admin/admin).
• Verified the dev server (python run.py) serves at http://localhost:8080/ and completed an end-to-end hello-world: logged in and created a "数据供应商" (Data Supplier) record via the UI.
• Added AGENTS.md documenting non-obvious startup caveats (DB must be up before import due to db.create_all() at import time, how to start MariaDB, the pinned Python stack, credentials).

Notes

• The startup update script refreshes the pinned deps into /workspace/venv (idempotent).
• There are no automated tests, no linter config, and no build step in this repo.

Walkthrough

login_and_create_provider.mp4

Login as admin and create a new Data Supplier record end-to-end.

New supplier record in list with success banner

_{To show artifacts inline, enable in settings.}