# apps/api/src/scripts
dir: apps/api/src/scripts

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

## role
Provides utility scripts for administrative and setup tasks for the API application.
## files
- __init__.py | Marks the directory as a Python package and provides a docstring describing it as utility scripts for the API package.
- seed.py | Seeds a development user into the database using SQLAlchemy async operations, with idempotency check to avoid duplicates. | 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 scripts using async SQLAlchemy for database operations, with idempotency guards for safe re-runs.
## tags
seed, user, database, sqlalchemy, package, init, call:build, call:session.scalar
## 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
-