headquarter/apps/api/src/scripts/.pi-map.md

apps/api/src/scripts

dir: apps/api/src/scripts

index: apps/api/src/scripts/.pi-map.index.md

role

Provides utility scripts for database initialization and maintenance tasks for the API.

files

• __init__.py | Marks the directory as a Python package and provides a module docstring for API utility scripts.
• seed.py | Seeds a development user into the database, creating it if it doesn't already exist based on email. | exp: func:build_seed_user() → Mapping[str, str | None], func:seed_database(session: AsyncSession) → User, call:build_seed_user, call:session.scalar, call:select(User).where, call:User, call:session.add, call:session.commit, call:session.refresh, func:run() → None, call:SessionLocal, call:seed_database, call:print, call:str, func:main() → None, call:asyncio.run, call:run | dep: collections.abc, sqlalchemy, sqlalchemy.ext.asyncio, src.database, src.models.user, asyncio

arch

Simple procedural script pattern with direct database access via SQLAlchemy models, no service layer abstraction.

tags

seed, user, database, init, call:build, call:session.scalar, call:select, call:user

symbols

• build_seed_user
• seed_database
• run
• main
• call:build_seed_user
• call:session.scalar
• call:select(User).where
• call:User

workflows

• change scripts behavior read: __init__.py, seed.py

dirty