sqlserver-project-structure

SQL Server Project Structure

SSDT Project Layout

database/
├── database.sqlproj                  # SSDT project file
├── dbo/
│   ├── Tables/
│   │   ├── Orders.sql
│   │   ├── OrderItems.sql
│   │   └── Customers.sql
│   ├── Views/
│   │   └── vw_ActiveCustomers.sql
│   ├── StoredProcedures/
│   │   ├── usp_GetOrderById.sql
│   │   └── usp_CreateOrder.sql
│   ├── Functions/
│   │   └── fn_CalculateTotal.sql
│   └── Indexes/
│       ├── IX_Orders_CustomerId.sql
│       └── IX_OrderItems_OrderId.sql
├── auth/
│   ├── Tables/
│   │   ├── Users.sql
│   │   └── Roles.sql
│   └── StoredProcedures/
│       └── usp_AuthenticateUser.sql
├── Security/
│   ├── Roles/
│   │   ├── AppReadRole.sql
│   │   └── AppWriteRole.sql
│   └── RLS/
│       └── TenantPolicy.sql
├── migrations/
│   ├── V001__Create_Orders_Table.sql
│   ├── V002__Add_Customer_Email.sql
│   └── V003__Create_Auth_Schema.sql
├── seed/
│   ├── lookup/
│   │   ├── OrderStatuses.sql
│   │   └── Countries.sql
│   └── dev/
│       └── SampleOrders.sql
└── tests/
    └── tSQLt/
        ├── OrderTests.sql
        └── AuthTests.sql

Rules

• One file per database object
• Organize by schema, then by object type
• migrations/ for versioned change scripts (V001, V002, ...)
• seed/lookup/ for reference/lookup data (always applied)
• seed/dev/ for development-only sample data (never in production)
• tests/tSQLt/ for in-database unit tests
• Schema separation: dbo for core domain, auth for authentication, audit for logging