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

apps/api/src/seeds

dir: apps/api/src/seeds

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

role

Provides database seeding utilities to populate initial built-in tool type configurations for the API application.

files

• __init__.py | Marks directory as Python package for database seeding utilities
• builtin_tool_types.py | Seeds built-in tool types (code-server, jupyter-notebook, opencode) into the database with Docker Compose templates, creating or updating records as needed. | exp: func:_table_exists(session, table_name: str) → bool, call:session.execute, call:text, call:result.scalar, func:seed_builtin_tool_types(), call:SessionLocal, call:_table_exists, call:logger.warning, call:session.scalar, call:select(ToolType).where, call:ToolType, call:tool_data.get, call:session.add, call:logger.info, call:session.commit | dep: logging, sqlalchemy, src.database, src.models

arch

Simple procedural seeding pattern with idempotent upsert operations, directly importing and executing database model creation logic with embedded Docker Compose template definitions.

tags

tool, types, table, exists, builtin, call:tool, database, init

symbols

• _table_exists
• seed_builtin_tool_types
• call:session.execute
• call:text
• call:result.scalar
• call:SessionLocal
• call:_table_exists
• call:logger.warning

workflows

• change seeds behavior read: __init__.py, builtin_tool_types.py

dirty