AI Powered SaaS: Stripe + Auth + Billing + Deploy · Lesson

Database Schema & ORM

Design an efficient database schema for core SaaS entities and integrate an Object-Relational Mapper (ORM) for data interaction.

Database Schema & ORM is a free AI Powered SaaS: Stripe + Auth + Billing + Deploy lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the AI Powered SaaS: Stripe + Auth + Billing + Deploy learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Database Schema: The Blueprint

Imagine building a house. You wouldn't just start laying bricks, right? You'd need a blueprint!

A database schema is exactly that: a blueprint for your database. It defines the structure of your data, including the tables, columns, data types, and relationships between them.

For a SaaS application, a well-designed schema ensures your data is consistent, easy to manage, and performs efficiently as your user base grows.

Core SaaS Entities

Every SaaS application deals with certain fundamental pieces of information. These are often called entities.

Common entities you'll find in most SaaS apps include:

Users: Who uses your service?
Products/Plans: What do you offer?
Subscriptions: How do users pay for your service?
Payments: Records of transactions.

Each entity will become a table in your database.

Designing the User Table

Let's start with the User entity. What information do we need for each user?

A basic users table might look like this:

id (Primary Key, unique identifier for each user)
email (Unique, for login)
password_hash (Securely stored password)
created_at (Timestamp when the user registered)
updated_at (Timestamp for last profile update)

Each column has a specific data type, like text, number, or date.

Designing Product & Subscription Tables

Next, let's consider products and subscriptions.

Products Table:

id (Primary Key)
name (e.g., 'Basic Plan', 'Premium Plan')
description (Features included)
price (Cost of the product/plan)

Subscriptions Table:

id (Primary Key)
user_id (Foreign Key, links to the users table)
product_id (Foreign Key, links to the products table)
status (e.g., 'active', 'canceled')
start_date, end_date

Foreign Keys are crucial for linking related data across tables.

Introducing the ORM

Interacting with databases directly using SQL can be repetitive and error-prone. This is where an Object-Relational Mapper (ORM) comes in.

An ORM acts as a bridge between your application's object-oriented code (like Java classes) and your relational database tables. It allows you to interact with your database using familiar programming language objects instead of writing raw SQL queries.

Think of it: you work with 'User' objects, and the ORM translates that into database commands.

ORM: Mapping Objects to Tables

With an ORM, each database table often corresponds to a model or entity class in your code. Each row in the table becomes an instance of that class.

For example, your users table would map to a User class in your programming language.

The ORM handles the complex details of mapping class properties (like email) to database columns (like email).

ORM in Action: Data Manipulation

Instead of writing SQL like INSERT INTO users (email, password_hash) VALUES ('...', '...'), an ORM lets you do this:

public class Main {
  // Represents a User entity/model
  static class User {
    int id; // Maps to 'id' column
    String email; // Maps to 'email' column
    String passwordHash; // Maps to 'password_hash' column

    public User(String email, String passwordHash) {
      this.email = email;
      this.passwordHash = passwordHash;
    }

    // In a real app, ID would be set by DB or ORM upon saving
    public void setId(int id) { this.id = id; }

    @Override
    public String toString() {
      return "User{id=" + id + ", email='" + email + "'}";
    }
  }

  // Mock Repository to simulate ORM interaction
  static class UserRepository {
    private int nextId = 1;

    public User save(User user) {
      // Simulates ORM inserting into DB and setting ID
      user.setId(nextId++);
      System.out.println("Simulating saving user: " + user.email + " with ID " + user.id);
      return user;
    }
  }

  public static void main(String[] args) {
    UserRepository userRepository = new UserRepository();

    // Create a new User object
    User newUser = new User("alice@example.com", "hashedpass123");
    
    // Use the ORM (via repository) to save the user
    userRepository.save(newUser);

    System.out.println("User object after save: " + newUser);
  }
}

ORM in Action: Retrieving Data

Similarly, fetching data becomes working with objects. No more `SELECT * FROM users WHERE id = 1;`

public class Main {
  static class User {
    int id;
    String email;
    String passwordHash;

    public User(int id, String email, String passwordHash) {
      this.id = id;
      this.email = email;
      this.passwordHash = passwordHash;
    }

    @Override
    public String toString() {
      return "User{id=" + id + ", email='" + email + "'}";
    }
  }

  static class UserRepository {
    // Mock data storage for demonstration
    private java.util.Map<Integer, User> users = new java.util.HashMap<>();

    public UserRepository() {
      users.put(1, new User(1, "bob@example.com", "hashed_bob"));
      users.put(2, new User(2, "charlie@example.com", "hashed_charlie"));
    }

    public User findById(int id) {
      System.out.println("Simulating finding user with ID: " + id);
      return users.get(id);
    }
  }

  public static void main(String[] args) {
    UserRepository userRepository = new UserRepository();

    // Use the ORM to find a user by ID
    User foundUser = userRepository.findById(1);

    if (foundUser != null) {
      System.out.println("Found user: " + foundUser);
    } else {
      System.out.println("User not found.");
    }

    User anotherUser = userRepository.findById(99);
    if (anotherUser == null) {
        System.out.println("User with ID 99 not found (as expected).");
    }
  }
}

Benefits of Using an ORM

ORMs offer several advantages for SaaS development:

Reduced SQL Code: You write less boilerplate SQL, focusing on business logic.
Type Safety: Work with objects in your programming language, leveraging its type system to prevent common errors.
Database Portability: Many ORMs allow you to switch databases (e.g., from PostgreSQL to MySQL) with minimal code changes.
Improved Productivity: Faster development cycles due to abstraction.

Popular ORMs include Hibernate (Java), SQLAlchemy (Python), and Entity Framework (.NET).

Schema & ORM Check

Consider a simple SaaS application that allows users to create tasks. Each task belongs to a user.

Which of the following statements is TRUE regarding the database schema and ORM interaction for this scenario?

Recap: Schema & ORM

In this lesson, we explored the critical role of a database schema as the blueprint for your SaaS data, defining tables, columns, and relationships.

We designed basic schemas for core entities like User, Product, and Subscription, highlighting the importance of primary and foreign keys.

Finally, we introduced Object-Relational Mappers (ORMs) as powerful tools that simplify database interactions by allowing you to work with objects instead of raw SQL, boosting productivity and code maintainability.

Frequently asked questions

Is the “Database Schema & ORM” lesson free?

Yes — the full text of “Database Schema & ORM” is free to read here on the web, and the AI Powered SaaS: Stripe + Auth + Billing + Deploy course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the AI Powered SaaS: Stripe + Auth + Billing + Deploy course, upgrade to CoddyKit PRO.

What will I learn in “Database Schema & ORM”?

Design an efficient database schema for core SaaS entities and integrate an Object-Relational Mapper (ORM) for data interaction. You practise AI Powered SaaS: Stripe + Auth + Billing + Deploy with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start AI Powered SaaS: Stripe + Auth + Billing + Deploy?

No prior experience is required. AI Powered SaaS: Stripe + Auth + Billing + Deploy on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Database Schema & ORM” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this AI Powered SaaS: Stripe + Auth + Billing + Deploy lesson?

Yes. Every AI Powered SaaS: Stripe + Auth + Billing + Deploy lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

← Back to AI Powered SaaS: Stripe + Auth + Billing + Deploy