chore(repo): add .gitignore and prepare push

Author: shayancoin

.env.example

@@ -1,73 +1,55 @@
-# Dependencies
-node_modules/
-.pnp/
-.pnp.js
-.npm
+# macOS
+.DS_Store
+
+# Editors/IDE
+.vscode/
+.idea/
 
 # Python
 __pycache__/
 *.py[cod]
-*$py.class
-*.so
-.Python
+*.pyo
+*.pyd
+*.egg-info/
+.python-version
+.venv/
+venv/
+.mypy_cache/
+.ruff_cache/
 .pytest_cache/
-.coverage
+coverage/
 htmlcov/
-.tox/
-.nox/
-.hypothesis/
-.pytest_cache/
-.coverage
-.env
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
 
-# Build outputs
-.next/
-/out/
-/build
-/dist
-/site/
-/combined_site/
-frontend/out/
-*/out/
-tmp_next_out/
-docs/assets/template-ui/
+# FastAPI/Build
+dist/
+build/
 
-# Environment files
-.env.local
-.env.development
-.env.test
-.env.production
+# Alembic (keep versions tracked)
+# alembic/  <-- do NOT ignore versions
 
-# Logs
-logs
-*.log
+# Node/Next.js
+node_modules/
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+.pnpm-store/
+.next/
+out/
+.cache/
 
-# Misc
-.DS_Store
-*.pem
-Thumbs.db
-
-# Editor directories and files
-.idea/
-.vscode/
-*.swp
-*.swo
+# Env files (keep example)
+.env
+.env.*
+!.env.example
 
-# Vercel
-.vercel
+# Docker
+**/.dockerignore
+docker-data/
+*.pid
 
-# Typescript
-*.tsbuildinfo
-next-env.d.ts
+# Frontend assets generated locally
+frontend/public/models/*.tmp
 
-# Docker volumes
-*.volume
+# Large design/BIM assets (avoid pushing huge binaries; use LFS or separate storage)
+docs/kitchen-system-prime/**
+docs/kitchen-system-vvd/**

.gitignore

@@ -20,4 +20,5 @@ ENV BACKEND_PORT=${BACKEND_PORT} \
 
 EXPOSE ${BACKEND_PORT}
 
-CMD ["uvicorn", "api.main:app", "--host", "0.0.0.0", "--port", "${BACKEND_PORT}"]
+# Use shell to expand ${BACKEND_PORT}
+CMD ["sh", "-lc", "uvicorn api.main:app --host 0.0.0.0 --port ${BACKEND_PORT}"]

backend/Dockerfile

@@ -15,4 +15,5 @@ ENV BACKEND_PORT=${BACKEND_PORT} \
 
 EXPOSE ${BACKEND_PORT}
 
-CMD ["uvicorn", "api.main:app", "--host", "0.0.0.0", "--port", "${BACKEND_PORT}", "--reload"]
+# Use shell form to allow env var expansion for BACKEND_PORT
+CMD ["sh", "-lc", "uvicorn api.main:app --host 0.0.0.0 --port ${BACKEND_PORT} --reload"]

backend/Dockerfile.dev

@@ -0,0 +1,43 @@
+[alembic]
+script_location = alembic
+prepend_sys_path = .
+file_template = %%(rev)s_%%(slug)s
+timezone = UTC
+
+[alembic:runtime]
+sqlalchemy.url =
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers = console
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(asctime)s %(levelname)-5.5s [%(name)s] %(message)s
+
+

backend/alembic.ini

@@ -0,0 +1,80 @@
+"""Alembic environment configuration.
+
+This config reads the database URL from the environment variable ``DATABASE_URL``
+or falls back to the application's settings. It sets up both offline and online
+migration contexts and uses the application's Base metadata for autogenerate.
+"""
+
+from __future__ import annotations
+
+import os
+from logging.config import fileConfig
+
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+# Interpret the config file for Python logging.
+config = context.config
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+# Import application metadata
+from api.db import Base, get_engine_url  # noqa: E402
+
+target_metadata = Base.metadata
+
+
+def get_url() -> str:
+    env_url = os.getenv("DATABASE_URL")
+    if env_url:
+        return env_url
+    return get_engine_url()
+
+
+def run_migrations_offline() -> None:
+    """Run migrations in 'offline' mode."""
+
+    url = get_url()
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+        compare_type=True,
+        render_as_batch=url.startswith("sqlite"),
+    )
+
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    """Run migrations in 'online' mode."""
+
+    configuration = config.get_section(config.config_ini_section) or {}
+    configuration["sqlalchemy.url"] = get_url()
+
+    connectable = engine_from_config(
+        configuration,
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+
+    with connectable.connect() as connection:
+        context.configure(
+            connection=connection,
+            target_metadata=target_metadata,
+            compare_type=True,
+            render_as_batch=configuration["sqlalchemy.url"].startswith("sqlite"),
+        )
+
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()
+
+

backend/alembic/env.py

@@ -0,0 +1,2 @@
+
+

backend/alembic/versions/.gitkeep

@@ -0,0 +1,85 @@
+"""Initial Paform models
+
+Revision ID: 0001
+Revises: 
+Create Date: 2025-10-11 00:00:00
+"""
+
+from __future__ import annotations
+
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects import postgresql
+
+
+# revision identifiers, used by Alembic.
+revision = "0001"
+down_revision = None
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "materials",
+        sa.Column("id", sa.String(length=36), nullable=False),
+        sa.Column("name", sa.String(length=255), nullable=False),
+        sa.Column("texture_url", sa.String(length=2048), nullable=True),
+        sa.Column("cost_per_sq_ft", sa.Float(), nullable=False, server_default=sa.text("0")),
+        sa.Column(
+            "external_ids",
+            sa.JSON().with_variant(postgresql.JSONB(astext_type=sa.Text()), "postgresql"),
+            nullable=True,
+        ),
+        sa.Column("created_at", sa.TIMESTAMP(timezone=True), server_default=sa.text("CURRENT_TIMESTAMP"), nullable=False),
+        sa.Column("updated_at", sa.TIMESTAMP(timezone=True), server_default=sa.text("CURRENT_TIMESTAMP"), nullable=True),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index(op.f("ix_materials_name"), "materials", ["name"], unique=False)
+
+    op.create_table(
+        "modules",
+        sa.Column("id", sa.String(length=36), nullable=False),
+        sa.Column("name", sa.String(length=255), nullable=False),
+        sa.Column("width", sa.Float(), nullable=False),
+        sa.Column("height", sa.Float(), nullable=False),
+        sa.Column("depth", sa.Float(), nullable=False),
+        sa.Column("base_price", sa.Float(), nullable=False, server_default=sa.text("0")),
+        sa.Column("material_id", sa.String(length=36), nullable=False),
+        sa.Column(
+            "assembly_attributes",
+            sa.JSON().with_variant(postgresql.JSONB(astext_type=sa.Text()), "postgresql"),
+            nullable=True,
+        ),
+        sa.Column(
+            "placement_constraints",
+            sa.JSON().with_variant(postgresql.JSONB(astext_type=sa.Text()), "postgresql"),
+            nullable=True,
+        ),
+        sa.Column(
+            "connection_points",
+            sa.JSON().with_variant(postgresql.JSONB(astext_type=sa.Text()), "postgresql"),
+            nullable=True,
+        ),
+        sa.Column(
+            "external_ids",
+            sa.JSON().with_variant(postgresql.JSONB(astext_type=sa.Text()), "postgresql"),
+            nullable=True,
+        ),
+        sa.Column("created_at", sa.TIMESTAMP(timezone=True), server_default=sa.text("CURRENT_TIMESTAMP"), nullable=False),
+        sa.Column("updated_at", sa.TIMESTAMP(timezone=True), server_default=sa.text("CURRENT_TIMESTAMP"), nullable=True),
+        sa.ForeignKeyConstraint(["material_id"], ["materials.id"], ondelete="RESTRICT"),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index(op.f("ix_modules_name"), "modules", ["name"], unique=False)
+    op.create_index("ix_modules_material_name", "modules", ["material_id", "name"], unique=False)
+
+
+def downgrade() -> None:
+    op.drop_index("ix_modules_material_name", table_name="modules")
+    op.drop_index(op.f("ix_modules_name"), table_name="modules")
+    op.drop_table("modules")
+    op.drop_index(op.f("ix_materials_name"), table_name="materials")
+    op.drop_table("materials")
+
+

backend/alembic/versions/0001_initial_models.py

@@ -20,6 +20,21 @@ class Settings(BaseSettings):
         default=3000, description="Port for the frontend service"
     )
 
+    # Database and integration settings
+    database_url: str = Field(
+        default="sqlite:///./paform.db",
+        description="SQLAlchemy database URL",
+    )
+    environment: str = Field(
+        default="development", description="Runtime environment"
+    )
+    hygraph_endpoint: str = Field(
+        default="", description="Hygraph GraphQL endpoint"
+    )
+    hygraph_token: str = Field(
+        default="", description="Hygraph access token"
+    )
+
     # Add your custom settings here
     # example_api_key: str = Field(
     #     default="", description="API key for Example service"