feat: first cut on M0 - base structure of project

crates/bds-core/src/model/generation.rs

@@ -0,0 +1,38 @@
+use serde::{Deserialize, Serialize};
+
+/// Tracks content hashes of generated files to skip unchanged writes.
+/// Matches the `generated_file_hashes` table.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct GeneratedFileHash {
+    pub project_id: String,
+    pub relative_path: String,
+    pub content_hash: String,
+    pub updated_at: i64,
+}
+
+/// Notification for CLI-to-app synchronization.
+/// Matches the `db_notifications` table.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct DbNotification {
+    pub id: i64,
+    pub entity: String,
+    pub entity_id: String,
+    pub action: String,
+    pub from_cli: bool,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub seen_at: Option<i64>,
+    pub created_at: i64,
+}
+
+/// Publishing preferences stored in meta/publishing.json.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct PublishingPreferences {
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub ssh_host: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub ssh_user: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub ssh_remote_path: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub ssh_mode: Option<String>,
+}

crates/bds-core/src/model/media.rs

@@ -0,0 +1,54 @@
+use serde::{Deserialize, Serialize};
+
+/// A media item (image, video, etc.).
+/// Matches the `media` table schema.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Media {
+    pub id: String,
+    pub project_id: String,
+    pub filename: String,
+    pub original_name: String,
+    pub mime_type: String,
+    pub size: i64,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub width: Option<i32>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub height: Option<i32>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub title: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub alt: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub caption: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub author: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub language: Option<String>,
+    pub file_path: String,
+    pub sidecar_path: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub checksum: Option<String>,
+    /// JSON-serialized string array in DB.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub tags: Option<String>,
+    pub created_at: i64,
+    pub updated_at: i64,
+}
+
+/// A translation of media metadata into another language.
+/// Matches the `media_translations` table.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct MediaTranslation {
+    pub id: String,
+    pub project_id: String,
+    pub translation_for: String,
+    pub language: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub title: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub alt: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub caption: Option<String>,
+    pub created_at: i64,
+    pub updated_at: i64,
+}

crates/bds-core/src/model/mod.rs

@@ -0,0 +1,15 @@
+mod post;
+mod media;
+mod tag;
+mod project;
+mod template;
+mod script;
+mod generation;
+
+pub use post::{Post, PostLink, PostMedia, PostStatus, PostTranslation};
+pub use media::{Media, MediaTranslation};
+pub use tag::Tag;
+pub use project::{Project, Setting};
+pub use template::Template;
+pub use script::Script;
+pub use generation::{DbNotification, GeneratedFileHash, PublishingPreferences};

crates/bds-core/src/model/post.rs

@@ -0,0 +1,107 @@
+use serde::{Deserialize, Serialize};
+
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+#[serde(rename_all = "lowercase")]
+pub enum PostStatus {
+    Draft,
+    Published,
+    Archived,
+}
+
+/// A blog post. Matches the `posts` table schema.
+///
+/// NOTE: `content` is null for published posts — body lives in the filesystem
+/// `.md` file only. Draft content is stored in DB.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Post {
+    pub id: String,
+    pub project_id: String,
+    pub title: String,
+    pub slug: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub excerpt: Option<String>,
+    /// Draft body text. Null/empty when published (content is in the file).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub content: Option<String>,
+    pub status: PostStatus,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub author: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub language: Option<String>,
+    #[serde(default)]
+    pub do_not_translate: bool,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub template_slug: Option<String>,
+    pub file_path: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub checksum: Option<String>,
+    /// JSON-serialized string array in DB.
+    #[serde(default)]
+    pub tags: Vec<String>,
+    /// JSON-serialized string array in DB.
+    #[serde(default)]
+    pub categories: Vec<String>,
+    // Published snapshot fields (used for diff detection)
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub published_title: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub published_content: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub published_tags: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub published_categories: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub published_excerpt: Option<String>,
+    /// Unix timestamp (integer in DB).
+    pub created_at: i64,
+    pub updated_at: i64,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub published_at: Option<i64>,
+}
+
+/// A translation of a post into another language.
+/// Matches the `post_translations` table.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct PostTranslation {
+    pub id: String,
+    pub project_id: String,
+    pub translation_for: String,
+    pub language: String,
+    pub title: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub excerpt: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub content: Option<String>,
+    pub status: PostStatus,
+    pub file_path: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub checksum: Option<String>,
+    pub created_at: i64,
+    pub updated_at: i64,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub published_at: Option<i64>,
+}
+
+/// A link between two posts (tracked for backlinks).
+/// Matches the `post_links` table.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct PostLink {
+    pub id: String,
+    pub source_post_id: String,
+    pub target_post_id: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub link_text: Option<String>,
+    pub created_at: i64,
+}
+
+/// Association between a post and media item.
+/// Matches the `post_media` table.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct PostMedia {
+    pub id: String,
+    pub project_id: String,
+    pub post_id: String,
+    pub media_id: String,
+    pub sort_order: i32,
+    pub created_at: i64,
+}

crates/bds-core/src/model/project.rs

@@ -0,0 +1,24 @@
+use serde::{Deserialize, Serialize};
+
+/// A bDS project. Matches the `projects` table schema.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Project {
+    pub id: String,
+    pub name: String,
+    pub slug: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub description: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub data_path: Option<String>,
+    pub is_active: bool,
+    pub created_at: i64,
+    pub updated_at: i64,
+}
+
+/// Key-value settings. Matches the `settings` table.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Setting {
+    pub key: String,
+    pub value: String,
+    pub updated_at: i64,
+}

crates/bds-core/src/model/script.rs

@@ -0,0 +1,21 @@
+use serde::{Deserialize, Serialize};
+
+/// A user-authored script. Matches the `scripts` table.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Script {
+    pub id: String,
+    pub project_id: String,
+    pub slug: String,
+    pub title: String,
+    /// "macro", "transform", or "utility"
+    pub kind: String,
+    pub entrypoint: String,
+    pub enabled: bool,
+    pub version: i32,
+    pub file_path: String,
+    pub status: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub content: Option<String>,
+    pub created_at: i64,
+    pub updated_at: i64,
+}

crates/bds-core/src/model/tag.rs

@@ -0,0 +1,14 @@
+use serde::{Deserialize, Serialize};
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Tag {
+    pub id: String,
+    pub project_id: String,
+    pub name: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub color: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub post_template_slug: Option<String>,
+    pub created_at: i64,
+    pub updated_at: i64,
+}

crates/bds-core/src/model/template.rs

@@ -0,0 +1,19 @@
+use serde::{Deserialize, Serialize};
+
+/// A Liquid template. Matches the `templates` table.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Template {
+    pub id: String,
+    pub project_id: String,
+    pub slug: String,
+    pub title: String,
+    pub kind: String,
+    pub enabled: bool,
+    pub version: i32,
+    pub file_path: String,
+    pub status: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub content: Option<String>,
+    pub created_at: i64,
+    pub updated_at: i64,
+}