feat(frontend) qwik init

.gitignore

@@ -8,6 +8,3 @@
 
 # exclude post repo
 /blog_posts_git
-
-# rustc ICE dump
-rustc-ice-*.txt

Makefile

@@ -3,7 +3,14 @@ ifeq ($(ARCH), arm64)
     ARCH := aarch64
 endif
 
-.PHONY: up
+all: release
-clean:
+
-	echo "todo"
+release:
+	docker compose -f prod.compose.yaml build --build-arg ARCH=$(ARCH)
+
+dev:
+	docker-compose -f dev.compose.yaml up --build
+
+clean:
+	docker-compose -f prod.compose.yaml -f dev.compose.yaml rm -fsv
 

README.md

@@ -7,4 +7,10 @@ content (blog posts etc.) repo.
 Powered by Next.js and Rust, built with passion and love
 
 > [!NOTE]
-> This is an unstable branch, checkout `release` for the (guaranteed) working version
+> This system is not production ready, and contains bugs, (security risk potentially).
+> But have fun on it =)
+
+# Todos
+
+- [ ] the todo list lol
+- [ ] and much more...

backend/Cargo.toml

@@ -1,5 +1,5 @@
 [workspace]
-resolver = "3"
+resolver = "2"
 members = [
     "server",
     "macros",

backend/macros/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "macros"
 version = "0.1.0"
-edition = "2024"
+edition = "2021"
 
 [dependencies]
 tracing = "0.1.40"

backend/macros/src/dev.rs

@@ -1,6 +0,0 @@
-#[macro_export]
-macro_rules! dev_consume {
-    ($($var:ident),+) => {
-        $(let _ = $var;)*
-    };
-}

backend/macros/src/include_str.rs

@@ -1,24 +0,0 @@
-/// Includes a UTF-8 encoded file as a string
-///
-/// The file is located relative to `CARGO_MANIFEST_DIR`.
-///
-/// # Example
-/// ```rust
-/// use macros::include_str_from_crate_root;
-///
-/// let str: &str = include_str_from_crate_root!("/query/scheme.sql");
-///
-// todo: impl
-// const PATH_PREFIX: &str = "/src";
-// let str: &str = include_str_from_crate_root!("{}/query/scheme.sql", PATH_PREFIX);
-/// ```
-#[macro_export]
-macro_rules! include_str_from_crate_root {
-    // ($path:literal $(, $($arg:tt)*)?) => {
-    // ($path:expr, $($args:tt)*) => {
-    //     include_str!(concat!(env!("CARGO_MANIFEST_DIR"), format_args!($path, $($args)*)))
-    // };
-    ($path:expr) => {
-        include_str!(concat!(env!("CARGO_MANIFEST_DIR"), $path))
-    };
-}

backend/macros/src/lib.rs

@@ -1,3 +1 @@
-mod dev;
-mod include_str;
 mod log;

backend/macros/src/log.rs

@@ -44,7 +44,7 @@ mod tests {
         use std::io;
         use tracing::Level;
         use tracing_subscriber::prelude::*;
-        use tracing_subscriber::{Registry, fmt};
+        use tracing_subscriber::{fmt, Registry};
 
         let format = tracing_subscriber::fmt::format()
             .with_level(true)

backend/markdown/Cargo.toml

@@ -1,14 +1,14 @@
 [package]
 name = "markdown"
 version = "0.1.0"
-edition = "2024"
+edition = "2021"
 
 [dependencies]
 uuid = { version = "1.10.0", features = ["v4", "fast-rng", "serde"] }
 serde = { version = "1.0.209", features = ["derive"] }
 serde_json = "1.0.128"
 regex = "1.10.4"
-yaml-rust2 = "0.10.0"
+yaml-rust2 = "0.9.0"
 sha2 = "0.10.8"
 base64 = "0.22.1"
 thiserror = "2.0.3"

backend/markdown/src/error.rs

@@ -2,6 +2,12 @@ use thiserror::Error;
 
 #[derive(Error, Debug)]
 pub enum Error {
+    #[error("missing front-matter field: id")]
+    MissingID,
+
+    #[error("invalid file id: {}", msg)]
+    InvalidID { msg: String },
+
     #[error("invalid front-matter: {}", msg)]
     InvalidFrontMatter { msg: String },
 

backend/markdown/src/lib.rs

@@ -1,20 +1,23 @@
-pub mod error;
+mod error;
 mod utils;
 
-use std::{fs, path::Path, str::FromStr};
+use std::fs;
+use std::path::Path;
+use std::str::FromStr;
 
-use crate::{
+use crate::error::Error;
-    error::Error,
+use crate::utils::front_matter::{parse_front_matter, split_md_front_matter};
-    utils::front_matter::{parse_front_matter, split_md_front_matter},
-};
 
-use base64::{Engine, engine::general_purpose};
+use base64::{engine::general_purpose, Engine};
 use serde::Serialize;
 use serde_json::Value;
 use sha2::{Digest, Sha256};
+use uuid::Uuid;
 
-#[derive(Default, Debug, Serialize, Clone)]
+#[derive(Default, Debug, Serialize)]
 pub struct MdFile {
+    pub file_id: Uuid,
+    pub filename: String,
     pub meta: Value,
     pub content: String,
     pub hash: String,
@@ -26,22 +29,30 @@ impl MdFile {
             Ok(file) => file,
             Err(e) => return Err(Error::FSError { msg: e.to_string() }),
         };
-        Self::from_str(&raw_file)
+        let raw_file_bytes = raw_file.as_bytes().to_vec();
-    }
+        let (front_matter_str, content) = split_md_front_matter(raw_file);
-}
-
-impl FromStr for MdFile {
-    type Err = Error;
-
-    fn from_str(s: &str) -> Result<Self, Self::Err> {
-        let bytes = s.as_bytes().to_vec();
-        let (front_matter_str, content) = split_md_front_matter(s);
         let front_matter = match parse_front_matter(&front_matter_str) {
             Ok(front_matter) => front_matter,
             Err(e) => return Err(Error::InvalidFrontMatter { msg: e.to_string() }),
         };
-        let hash = calculate_hash_base64(&bytes);
+        let hash = calculate_hash_base64(&raw_file_bytes);
+        let file_id = match front_matter["id"].as_str() {
+            Some(id) => match Uuid::from_str(id) {
+                Ok(id) => id,
+                Err(e) => return Err(Error::InvalidID { msg: e.to_string() }),
+            },
+            None => return Err(Error::MissingID),
+        };
+        let file_name = Path::new(file_path)
+            .file_name()
+            .unwrap()
+            .to_str()
+            .unwrap()
+            .to_string();
+
         Ok(MdFile {
+            file_id,
+            filename: file_name,
             meta: front_matter,
             content,
             hash,

backend/markdown/src/utils/front_matter.rs

@@ -1,19 +1,17 @@
-use std::error::Error;
-
 use crate::utils::yaml::yaml_to_serde;
-
 use regex::Regex;
 use serde_json::Value;
+use std::error::Error;
 use yaml_rust2::YamlLoader;
 
-pub fn split_md_front_matter(raw_file: &str) -> (String, String) {
+pub fn split_md_front_matter(raw_file: String) -> (String, String) {
     let re = Regex::new(r"(?s)^(---\n.*?\n---\n)(.*)").unwrap();
-    if let Some(captures) = re.captures(raw_file) {
+    if let Some(captures) = re.captures(raw_file.as_str()) {
         let front_matter = captures.get(1).map_or("", |m| m.as_str()).to_string();
         let main_content = captures.get(2).map_or("", |m| m.as_str()).to_string();
         (front_matter, main_content)
     } else {
-        (String::new(), raw_file.to_string())
+        (String::new(), raw_file)
     }
 }
 
@@ -45,7 +43,8 @@ tags: [ "test1", "test2" ]
 
 test body
 
-"##,
+"##
+            .to_string(),
         );
         assert_eq!(
             front_matter,
@@ -65,7 +64,7 @@ tags: [ "test1", "test2" ]
 
     #[test]
     fn test_front_matter_parser() {
-        parse_front_matter(
+        dbg!(parse_front_matter(
             r##"---
 title: test_title
 date: 0000-00-00+0000
@@ -76,7 +75,7 @@ summary: summary
 tags: [ "test1", "test2" ]
 ---
 "##,
-        )
+        ))
         .expect("Failed to parse front matter");
     }
 }

backend/server/Cargo.toml

@@ -1,29 +1,15 @@
 [package]
 name = "server"
 version = "0.1.0"
-edition = "2024"
+edition = "2021"
 
 [dependencies]
 macros = { path = "../macros" }
-markdown = { path = "../markdown" }
 
-axum = { version = "0.8.1", features = ["macros"] }
+
-tracing = { version = "0.1.41", features = ["log"] }
+tracing = "0.1.41"
 git2 = "0.20.0"
-chrono = { version = "0.4.39", features = ["serde"] }
-cron = "0.15.0"
-sqlx = { version = "0.8.3", features = ["runtime-tokio", "tls-native-tls", "postgres", "chrono", "uuid"] }
-serde_json = "1.0.133"
-serde = { version = "1.0.215", features = ["derive"] }
-tracing-subscriber = "0.3.18"
-tracing-appender = "0.2.3"
-dirs = "6.0.0"
-thiserror = "2.0.11"
-tokio = { version = "1.42.0", features = ["rt", "rt-multi-thread", "macros", "sync"] }
-dotenv = "0.15.0"
-uuid = { version = "1.13.2", features = ["v4"] }
-futures = "0.3.31"
 
 [build-dependencies]
 git2 = "0.20.0"
-chrono = "0.4.39"
+chrono = "0.4.39"

backend/server/build.rs

@@ -9,8 +9,7 @@ fn main() {
         .peel_to_commit()
         .expect("failed to get HEAD commit");
     let hash = commit.id().to_string();
-    let utc_timestamp = Utc::now().date_naive().format("%Y%m%d").to_string();
+    let utc_date = Utc::now().date_naive().format("%Y%m%d").to_string();
-    let pkg_version = env!("CARGO_PKG_VERSION");
+    let build_id = format!("{}@{}", utc_date, &hash[..8]);
-    let build_id = format!("{}:{}@{}", pkg_version, &hash[..8], utc_timestamp);
     println!("cargo:rustc-env=BUILD_ID={}", build_id);
 }

backend/server/schema.sql

@@ -0,0 +1,32 @@
+CREATE TABLE tag
+(
+    id          SERIAL PRIMARY KEY,
+    name        VARCHAR(20) UNIQUE NOT NULL,
+    description TEXT
+);
+
+CREATE TABLE category
+(
+    id          SERIAL PRIMARY KEY,
+    name        VARCHAR(20) UNIQUE NOT NULL,
+    description TEXT
+);
+
+CREATE TABLE post
+(
+    id             SERIAL PRIMARY KEY,
+    identifier     VARCHAR(50) UNIQUE              NOT NULL,
+    title          VARCHAR(255)                    NOT NULL,
+    subtitle       VARCHAR(255)                    NOT NULL,
+    published_date DATE                            NOT NULL,
+    last_update    DATE,
+    content        TEXT                            NOT NULL,
+
+    category       SERIAL REFERENCES category (id) NOT NULL
+);
+
+CREATE TABLE post_tag
+(
+    post SERIAL REFERENCES post (id),
+    tag  SERIAL REFERENCES tag (id)
+)

backend/server/src/constants/config.rs

@@ -1,5 +1,3 @@
-// todo: rebuild with static OnceCell
-
 // Database related
 pub mod database {
     pub mod var_name {

backend/server/src/constants/time.rs

@@ -1,3 +1,2 @@
 pub const DEFAULT_TIME_FORMAT: &str = "%Y-%m-%dT%H:%M:%S%z";
-
+pub const DEFAULT_DATE_FORMAT: &str = "%Y-%m-%d%zT%H%M%S";
-pub const DEFAULT_NAIVE_DATE_FORMAT: &str = "%Y-%m-%d";

backend/server/src/init/database.rs

@@ -1,42 +0,0 @@
-use std::env;
-use std::error::Error;
-use std::str::FromStr;
-
-use crate::constants::config::database::{default_value, var_name};
-
-use sqlx::postgres::{PgConnectOptions, PgPoolOptions};
-use sqlx::{ConnectOptions, Pool, Postgres};
-use tracing::info;
-
-pub async fn init() -> Result<Pool<Postgres>, Box<dyn Error>> {
-    let db_connect_option = PgConnectOptions::from_str(&parse_db_uri())
-        .unwrap()
-        .disable_statement_logging();
-    Ok(PgPoolOptions::new()
-        .max_connections(1) // todo: temporary solution, to be fixed
-        .connect_with(db_connect_option)
-        .await?)
-}
-
-fn parse_db_uri() -> String {
-    env::var(var_name::URI).unwrap_or_else(|_| {
-        info!(
-            "`{}` env var is not set, \
-            using `{}`, `{}`, `{}`, `{}` and `{}`",
-            var_name::URI,
-            var_name::USERNAME,
-            var_name::PASSWORD,
-            var_name::HOST,
-            var_name::PORT,
-            var_name::DBNAME
-        );
-        let postgres_user = env::var(var_name::USERNAME).unwrap_or(default_value::USERNAME.into());
-        let postgres_password =
-            env::var(var_name::PASSWORD).unwrap_or(default_value::PASSWORD.into());
-        let db_host = env::var(var_name::HOST).unwrap_or(default_value::HOST.into());
-        let db_port = env::var(var_name::PORT).unwrap_or(default_value::PORT.into());
-        let postgres_db = env::var(var_name::DBNAME).unwrap_or(default_value::DBNAME.into());
-        let db_type = default_value::DATABASE_TYPE;
-        format!("{db_type}://{postgres_user}:{postgres_password}@{db_host}:{db_port}/{postgres_db}")
-    })
-}

backend/server/src/init/logger.rs

@@ -1,107 +0,0 @@
-use std::path::Path;
-use std::{env, io};
-
-use crate::constants::config::general::{default_value, var_name};
-
-use chrono::Local;
-use dirs::home_dir;
-use tracing::info;
-use tracing_appender::{non_blocking, non_blocking::WorkerGuard, rolling};
-use tracing_subscriber::{
-    Layer, Registry, filter::LevelFilter, fmt, fmt::MakeWriter, fmt::format::Writer,
-    fmt::time::FormatTime, layer::SubscriberExt,
-};
-
-struct LocalTimer;
-
-impl FormatTime for LocalTimer {
-    fn format_time(&self, w: &mut Writer<'_>) -> std::fmt::Result {
-        write!(
-            w,
-            "{}",
-            Local::now().format(crate::constants::time::DEFAULT_TIME_FORMAT)
-        )
-    }
-}
-
-type _LogWriter = dyn for<'writer> MakeWriter<'writer, Writer = dyn io::Write + 'static> + 'static;
-
-pub fn init() -> (WorkerGuard, WorkerGuard) {
-    let log_path = match env::var(var_name::LOG_DIR) {
-        Ok(path) => Path::new(&path).to_path_buf(),
-        Err(_) => {
-            let path = if let Ok(default_log_path) = env::var(var_name::WORK_DIR) {
-                expand_home_path(default_log_path)
-            } else {
-                let fallback_path = expand_home_path(default_value::WORK_DIR.to_string());
-                println!(
-                    "[warn] unset env var `{}` and `{}`, trying to log on fallback path: {}/log",
-                    var_name::LOG_DIR,
-                    var_name::WORK_DIR,
-                    fallback_path
-                );
-                fallback_path
-            };
-            Path::new(&path).join("log")
-        }
-    };
-
-    let (info_log_writer, info_guard) = non_blocking(rolling::never(&log_path, "info.log"));
-    let (err_log_writer, error_guard) = non_blocking(rolling::never(&log_path, "error.log"));
-
-    let info_format = tracing_subscriber::fmt::format()
-        .with_level(true)
-        .with_target(true)
-        .with_source_location(true)
-        .with_ansi(false);
-    let err_format = tracing_subscriber::fmt::format()
-        .with_level(true)
-        .with_target(true)
-        .with_source_location(true)
-        .with_ansi(false);
-    let stdout_format = tracing_subscriber::fmt::format()
-        .with_level(true)
-        .with_target(true)
-        .with_source_location(true)
-        .with_timer(LocalTimer);
-
-    let subscribers = Registry::default()
-        .with(
-            fmt::Layer::default()
-                .with_writer(info_log_writer)
-                .event_format(info_format),
-        )
-        .with(
-            fmt::Layer::default()
-                .with_writer(err_log_writer)
-                .event_format(err_format)
-                .with_filter(LevelFilter::ERROR),
-        )
-        .with(
-            fmt::Layer::default()
-                .with_writer(io::stdout)
-                .with_ansi(true)
-                .event_format(stdout_format),
-        );
-
-    tracing::subscriber::set_global_default(subscribers)
-        .expect("[fatal] failed to setup logging system");
-
-    info!("logging to dir: {}", log_path.to_str().unwrap());
-
-    (info_guard, error_guard)
-}
-
-fn expand_home_path(path: String) -> String {
-    if path.starts_with('~') {
-        let home_path = home_dir()
-            .unwrap_or_else(|| panic!("[fatal] unable to locate home dir when parsing env `{}`, try to use absolute path instead", var_name::WORK_DIR));
-        home_path
-            .join(path.strip_prefix("~/").unwrap())
-            .into_os_string()
-            .into_string()
-            .unwrap()
-    } else {
-        path
-    }
-}

backend/server/src/init/misc.rs

@@ -1,14 +0,0 @@
-use git2::opts::{set_server_connect_timeout_in_milliseconds, set_server_timeout_in_milliseconds};
-use tracing::warn;
-
-pub fn init() {
-    // git2 option
-    unsafe {
-        if let Err(e) = set_server_connect_timeout_in_milliseconds(10_000) {
-            warn!("failed to set git2 server connect timeout: {}", e);
-        }
-        if let Err(e) = set_server_timeout_in_milliseconds(60_000) {
-            warn!("failed to set git2 server timeout: {}", e);
-        }
-    }
-}

backend/server/src/init/mod.rs

@@ -1,50 +0,0 @@
-mod database;
-pub mod logger;
-mod misc;
-
-use std::{env, panic};
-
-use crate::modules::{ModuleTree, blog::Blog};
-use macros::error_panic;
-
-use tracing::info;
-
-pub fn load_env() {
-    if let Some(env_file) = env::args().nth(1) {
-        match dotenv::from_filename(&env_file) {
-            Ok(_) => {
-                println!("[info] env loaded from {}, starting up", env_file);
-            }
-            Err(e) => {
-                panic!("[fatal] failed to read {}: {}", env_file, e);
-            }
-        }
-    } else {
-        println!("[info] no .env file referred, starting up")
-    }
-}
-
-pub async fn start() {
-    misc::init();
-
-    // connect database
-    let db_pool = match database::init().await {
-        Ok(pool) => {
-            info!("database connection pool initialized");
-            pool
-        }
-        Err(e) => {
-            error_panic!("database connection pool failed to initialize: {}", e);
-        }
-    };
-
-    // // schema init
-    // schema::init(&db_pool).await;
-
-    ModuleTree::new()
-        .add_module(Blog {
-            db_handler: db_pool,
-        })
-        .blocking_serve()
-        .await
-}

backend/server/src/main.rs

@@ -1,22 +1,7 @@
-#[allow(dead_code)]
 mod constants;
 
-mod scheduler;
-
-mod init;
-mod modules;
-mod utils;
-
-use crate::init::{logger, start};
-
 const BUILD_ID: &str = env!("BUILD_ID");
 
-#[tokio::main]
+fn main() {
-async fn main() {
     println!("{}", BUILD_ID);
-
-    init::load_env();
-    let _guards = logger::init();
-
-    start().await;
 }

backend/server/src/modules/blog/api/get_page_count/mod.rs

@@ -1,25 +0,0 @@
-use crate::constants::blog::PAGE_SIZE;
-
-use axum::{Json, extract::State};
-use serde_json::{Value, json};
-use sqlx::{PgPool, Row, query};
-use tracing::error;
-
-const GET_PAGE_COUNT_QUERY: &str = include_str!("post_page_count.sql");
-
-pub async fn handler(State(db_connection): State<PgPool>) -> Result<Json<Value>, Json<Value>> {
-    match query(GET_PAGE_COUNT_QUERY)
-        .bind(PAGE_SIZE as i64)
-        .fetch_one(&db_connection)
-        .await
-    {
-        Ok(res) => {
-            let res: i32 = res.get("count");
-            Ok(Json::from(json!({"res": res})))
-        }
-        Err(e) => {
-            error!("failed to get blog page count: {}", e.to_string());
-            Err(Json::from(json!({"error": e.to_string()})))
-        }
-    }
-}

backend/server/src/modules/blog/api/get_page_count/post_page_count.sql

@@ -1,2 +0,0 @@
-SELECT cast(ceil(count(*) / cast($1 AS FLOAT)) AS INTEGER) AS count
-FROM posts;

backend/server/src/modules/blog/api/get_post/get_post_by_i64_id.sql

@@ -1 +0,0 @@
-SELECT 

backend/server/src/modules/blog/api/get_post/mod.rs

@@ -1,35 +0,0 @@
-use macros::dev_consume;
-
-use axum::{
-    Json,
-    extract::{Path, State},
-    response::IntoResponse,
-};
-use serde_json::json;
-use sqlx::PgPool;
-use uuid::Uuid;
-
-const GET_POST_BY_UUID: &str = include_str!("get_post_by_uuid.sql");
-const GET_POST_BY_STR_ID: &str = include_str!("get_post_by_str_id.sql");
-
-pub async fn handler(
-    State(db_connection): State<PgPool>,
-    Path(identifier): Path<String>,
-) -> impl IntoResponse {
-    if let Ok(id) = identifier.parse::<Uuid>() {
-        select_post_by_uuid(&db_connection, id).await
-    } else {
-        select_post_by_str_id(&db_connection, &identifier).await
-    };
-    Json::from(json!({"res": "ok"})).into_response()
-}
-
-async fn select_post_by_uuid(db: &PgPool, id: Uuid) {
-    dev_consume!(db, id);
-    todo!()
-}
-
-async fn select_post_by_str_id(db: &PgPool, id: &str) {
-    dev_consume!(db, id);
-    todo!()
-}

backend/server/src/modules/blog/api/get_post_list.rs

@@ -1,130 +0,0 @@
-use std::error::Error;
-
-use crate::constants::blog::PAGE_SIZE;
-
-use axum::{extract::Query, extract::State, http::StatusCode, Json};
-use chrono::{DateTime, Utc};
-use futures::future::join_all;
-use serde::Deserialize;
-use serde_json::{json, Map, Value};
-use sqlx::{postgres::PgRow, query, PgPool, Row};
-use tracing::error;
-use uuid::Uuid;
-
-#[derive(Deserialize)]
-pub struct Params {
-    page: Option<u32>,
-}
-
-#[axum::debug_handler]
-pub async fn get_post_list(
-    State(db_connection): State<PgPool>,
-    Query(params): Query<Params>,
-) -> Result<Json<Value>, (StatusCode, Json<Value>)> {
-    let search_param_page = params.page.unwrap_or(1);
-    if search_param_page < 1 {
-        return Err((
-            StatusCode::BAD_REQUEST,
-            Json::from(json!({"error": "`page` should be greater than 0"})),
-        ));
-    }
-
-    let offset = PAGE_SIZE * (search_param_page - 1);
-
-    let post_list = sqlx::query("SELECT * FROM post ORDER BY first_update DESC LIMIT $1 OFFSET $2")
-        .bind(PAGE_SIZE as i32)
-        .bind(offset as i32)
-        .fetch_all(&db_connection)
-        .await;
-    let post_list = match post_list {
-        Ok(post_list) => post_list,
-        Err(e) => {
-            error!(
-                "Database query error on fetching post list: {}",
-                e.to_string()
-            );
-            return Err((
-                StatusCode::INTERNAL_SERVER_ERROR,
-                Json::from(json!({"error": e.to_string()})),
-            ));
-        }
-    };
-
-    let mut res = Vec::new();
-    let posts: Vec<_> = post_list
-        .into_iter()
-        .map(|post| async { analyze_post(&db_connection, post).await })
-        .collect();
-    let posts = join_all(posts).await;
-    for post in posts {
-        match post {
-            Ok(p) => res.push(p),
-            Err(e) => {
-                return Err((
-                    StatusCode::INTERNAL_SERVER_ERROR,
-                    Json::from(json!(("error", e.to_string()))),
-                ))
-            }
-        }
-    }
-
-    // res.insert("posts".to_string(), Value::from(posts));
-    Ok(Json::from(Value::from(res)))
-}
-
-async fn analyze_post(db_connection: &PgPool, post: PgRow) -> Result<Value, Box<dyn Error + Send>> {
-    let post_id: Uuid = post.get("post_id");
-    let tags = fetch_post_tags(db_connection, post_id).await;
-    let meta = fetch_post_meta(db_connection, post_id).await.unwrap();
-    let header_img = meta.get("header_img");
-    let last_update = meta.get("last_update");
-
-    Ok(json!({
-        "post_id": post_id.to_string(),
-        "title": post.get::<String, _>("title"),
-        "category": post.get::<String, _>("category"),
-        "header_img": header_img,
-        "sub_title": post.get::<String, _>("sub_title"),
-        "summary": post.get::<String, _>("summary"),
-        "last_update": last_update,
-        "first_update": post.get::<DateTime<Utc>, _>("first_update"),
-        "tags": tags,
-    }))
-}
-
-async fn fetch_post_meta(db_connection: &PgPool, post_id: Uuid) -> Option<Value> {
-    match query(
-        r#"
-SELECT jsonb_strip_nulls(to_jsonb(t.*)) - 'post_id' AS meta
-FROM meta t
-WHERE post_id = $1;
-        "#,
-    )
-    .bind(post_id)
-    .fetch_one(db_connection)
-    .await
-    {
-        Ok(value) => Some(value.get::<Value, _>("meta")),
-        Err(e) => {
-            error!(
-                "Database error on Reading `{}` from table `{}`: <{}>: {}",
-                "post meta data",
-                "meta",
-                post_id.to_string(),
-                e.to_string()
-            );
-            None
-        }
-    }
-}
-
-async fn fetch_post_tags(db_connection: &PgPool, post_id: Uuid) -> Vec<String> {
-    match query("SELECT tag FROM Tag WHERE post_id = $1")
-        .bind(post_id)
-        .fetch_all(db_connection)
-        .await
-    {
-        Ok(res) => res.iter().map(|tag| tag.get::<String, _>("tag")).collect(),
-        Err(_) => vec![],
-    }
-}

backend/server/src/modules/blog/api/mod.rs

@@ -1,6 +0,0 @@
-pub mod get_page_count;
-
-// todo: remove exception tag
-#[allow(dead_code)]
-pub mod get_post;
-// pub mod get_post_list;

backend/server/src/modules/blog/components/check_update/apply.rs

@@ -1,208 +0,0 @@
-use crate::modules::blog::components::check_update::{
-    changes::{Change, Create, Delete, Move, Update},
-    error::Error,
-    utils::{parse_naive_date_str, parse_post_identifier},
-};
-
-use futures::{
-    future::{join_all, BoxFuture},
-    FutureExt,
-};
-use sqlx::{query, PgPool, Postgres, Row, Transaction};
-use tracing::error;
-
-const DELETE_POST_BY_ID: &str = include_str!("sql/delete_post_by_id.sql");
-const GET_TAG_ID: &str = include_str!("sql/get_tag_id.sql");
-const GET_CATEGORY_ID: &str = include_str!("sql/get_category_id.sql");
-const CREATE_RETURN_TAG_ID: &str = include_str!("sql/create_return_tag_id.sql");
-const CREATE_RETURN_CATEGORY_ID: &str = include_str!("sql/create_return_category_id.sql");
-const CREATE_POST: &str = include_str!("sql/create_post.sql");
-
-pub async fn apply_deltas(db_conn: &PgPool, changes: Vec<Change>) {
-    let handlers = changes
-        .into_iter()
-        .map(|change| match change {
-            Change::Delete(del) => handle_delete(db_conn, del).boxed(),
-            Change::Move(mv) => handle_move(db_conn, mv).boxed(),
-            Change::Update(update) => handle_update(db_conn, update).boxed(),
-            Change::Create(create) => handle_create(db_conn, create).boxed(),
-        })
-        .collect::<Vec<BoxFuture<'_, ()>>>();
-
-    join_all(handlers).await;
-}
-
-async fn handle_delete(db: &PgPool, del: Delete) {
-    if let Err(e) = query(DELETE_POST_BY_ID).bind(del.uuid).execute(db).await {
-        error!(
-            "failed to delete post: {}, {}",
-            del.uuid.to_string(),
-            e.to_string()
-        )
-    }
-}
-
-async fn handle_move(db: &PgPool, mv: Move) {
-    handle_delete(
-        db,
-        Delete {
-            uuid: mv.uuid,
-            path: mv.from,
-        },
-    )
-    .await;
-    handle_create(
-        db,
-        Create {
-            uuid: mv.uuid,
-            path: mv.to,
-            payload: mv.payload,
-        },
-    )
-    .await;
-}
-
-async fn handle_update(db: &PgPool, update: Update) {
-    handle_delete(
-        db,
-        Delete {
-            uuid: update.uuid,
-            path: update.path.clone(),
-        },
-    )
-    .await;
-    handle_create(
-        db,
-        Create {
-            uuid: update.uuid,
-            path: update.path,
-            payload: update.payload,
-        },
-    )
-    .await;
-}
-
-async fn handle_create(db: &PgPool, create: Create) {
-    let mut tx = db.begin().await.unwrap();
-
-    let identifier = parse_post_identifier(&create.path).unwrap();
-
-    let tags_json = create.payload.meta["tags"].clone();
-    let tags: Vec<_> = if let Some(tags) = tags_json.as_array() {
-        tags.iter().filter_map(|tag| tag.as_str()).collect()
-    } else {
-        vec![]
-    };
-    let mut tag_ids = vec![];
-    for tag in tags {
-        match get_or_create_tag_id(&mut tx, tag).await {
-            Ok(tid) => tag_ids.push(tid),
-            Err(e) => {
-                error!("failed to fetch or create tag ({}): {}", tag, e);
-                return;
-            }
-        }
-    }
-
-    let category_json = create.payload.meta["category"].clone();
-    let category = category_json.as_str().unwrap_or("Uncategorized");
-    let category_id = match get_or_create_category_id(&mut tx, category).await {
-        Ok(id) => id,
-        Err(e) => {
-            error!(
-                "failed to fetch category id for post {}: {}",
-                &identifier, e
-            );
-            return;
-        }
-    };
-
-    let meta = create.payload.meta;
-    let post_id = create.uuid;
-    let post_identifier = &identifier;
-    let post_title = meta
-        .get("title")
-        .map(|t| t.as_str().unwrap())
-        .unwrap_or("Untitled");
-    let post_subtitle = meta
-        .get("subtitle")
-        .map(|t| t.as_str().unwrap())
-        .unwrap_or("");
-    let post_date_created = if let Some(Some(date)) = meta
-        .get("date")
-        .map(|d| parse_naive_date_str(d.as_str().unwrap_or("")))
-    {
-        date
-    } else {
-        error!("failed to parse `date` for post: {}", post_identifier);
-        return;
-    };
-    let post_date_updated = meta
-        .get("update")
-        .map(|d| parse_naive_date_str(d.as_str().unwrap_or("")))
-        .unwrap_or(None);
-    let post_status = meta.get("status").map(|v| v.as_str()).unwrap_or(None);
-    let post_content = create.payload.content;
-
-    if let Err(e) = query(CREATE_POST)
-        .bind(post_id)
-        .bind(post_identifier)
-        .bind(post_title)
-        .bind(post_subtitle)
-        .bind(post_date_created)
-        .bind(post_date_updated)
-        .bind(post_status)
-        .bind(post_content)
-        .bind(category_id)
-        .bind(tag_ids)
-        .execute(&mut *tx)
-        .await
-    {
-        error!("failed to insert post {}: {}", &identifier, e);
-        return;
-    }
-
-    tx.commit().await.unwrap();
-}
-
-async fn get_or_create_tag_id(
-    db: &mut Transaction<'_, Postgres>,
-    tag_name: &str,
-) -> Result<i32, Error> {
-    get_create_id(db, tag_name, GET_TAG_ID, CREATE_RETURN_TAG_ID).await
-}
-
-async fn get_or_create_category_id(
-    db: &mut Transaction<'_, Postgres>,
-    category_name: &str,
-) -> Result<i32, Error> {
-    get_create_id(
-        db,
-        category_name,
-        GET_CATEGORY_ID,
-        CREATE_RETURN_CATEGORY_ID,
-    )
-    .await
-}
-
-async fn get_create_id(
-    db: &mut Transaction<'_, Postgres>,
-    field_name: &str,
-    fetch_query: &str,
-    create_fetch_query: &str,
-) -> Result<i32, Error> {
-    if let Some(id) = query(fetch_query)
-        .bind(field_name)
-        .fetch_optional(&mut **db)
-        .await?
-    {
-        Ok(id.get("id"))
-    } else {
-        let id = query(create_fetch_query)
-            .bind(field_name)
-            .fetch_one(&mut **db)
-            .await?
-            .get("id");
-        Ok(id)
-    }
-}

backend/server/src/modules/blog/components/check_update/changes.rs

@@ -1,68 +0,0 @@
-use std::path::PathBuf;
-
-use markdown::MdFile;
-
-use uuid::Uuid;
-
-#[allow(dead_code)]
-#[derive(Debug)]
-pub enum Change {
-    Delete(Delete),
-    Move(Move),
-    Update(Update),
-    Create(Create),
-}
-
-#[allow(dead_code)]
-#[derive(Debug, Clone)]
-pub struct Delete {
-    pub uuid: Uuid,
-    pub path: PathBuf,
-}
-
-#[allow(dead_code)]
-#[derive(Debug, Clone)]
-pub struct Move {
-    pub uuid: Uuid,
-    pub from: PathBuf,
-    pub to: PathBuf,
-    pub payload: MdFile,
-}
-
-#[allow(dead_code)]
-#[derive(Debug, Clone)]
-pub struct Update {
-    pub uuid: Uuid,
-    pub path: PathBuf,
-    pub payload: MdFile,
-}
-
-#[allow(dead_code)]
-#[derive(Debug, Clone)]
-pub struct Create {
-    pub uuid: Uuid,
-    pub path: PathBuf,
-    pub payload: MdFile,
-}
-
-#[derive(Debug, Clone, Default)]
-pub struct CreateDelete2UpdateSlot {
-    pub create: Option<Create>,
-    pub delete: Option<Delete>,
-}
-
-impl CreateDelete2UpdateSlot {
-    pub fn to_change(&self) -> Option<Change> {
-        match (&self.create, &self.delete) {
-            (Some(create), Some(delete)) => Some(Change::Move(Move {
-                uuid: create.uuid,
-                from: delete.path.clone(),
-                to: create.path.clone(),
-                payload: create.payload.clone(),
-            })),
-            (Some(create), None) => Some(Change::Create(create.clone())),
-            (None, Some(delete)) => Some(Change::Delete(delete.clone())),
-            (None, None) => None,
-        }
-    }
-}

backend/server/src/modules/blog/components/check_update/error.rs

@@ -1,18 +0,0 @@
-use markdown::error::Error as MarkdownError;
-
-use thiserror::Error;
-
-#[derive(Error, Debug)]
-pub enum Error {
-    #[error("markdown file error")]
-    MdFile(#[from] MarkdownError),
-
-    #[error("db error")]
-    Db(#[from] sqlx::Error),
-
-    #[error("git error")]
-    Git2(#[from] git2::Error),
-
-    #[error("git remote url mismatch")]
-    GitUrlMismatch,
-}

backend/server/src/modules/blog/components/check_update/mod.rs

@@ -1,103 +0,0 @@
-use std::{
-    env,
-    path::{Path, PathBuf},
-    sync::Arc,
-};
-
-use crate::{
-    constants::config::general::{default_value, var_name},
-    modules::blog::components::check_update::{
-        apply::apply_deltas, pull::fetch_deltas, utils::expand_path,
-    },
-    scheduler::task_func::AsyncTaskFunc,
-};
-use macros::panic_with_log;
-
-use sqlx::PgPool;
-use tracing::{log::error, trace, warn, Level};
-
-// mod error;
-// mod index;
-mod apply;
-mod changes;
-mod error;
-mod pull;
-mod utils;
-
-#[derive(Debug)]
-struct Args {
-    db_connection: PgPool,
-    git_work_dir: PathBuf,
-    git_url: String,
-    git_remote_name: String,
-    git_remote_branch: String,
-}
-
-pub fn task(db_connection: PgPool) -> impl AsyncTaskFunc {
-    // init
-    let git_work_dir = {
-        let path = if let Ok(default_log_path) = env::var(var_name::WORK_DIR) {
-            expand_path(default_log_path)
-        } else {
-            let fallback_path = expand_path(default_value::WORK_DIR.to_string());
-            warn!(
-                "unset env var `{}`, using default path: {}/blog_git",
-                var_name::WORK_DIR,
-                fallback_path
-            );
-            fallback_path
-        };
-        Path::new(&path).join("blog_git")
-    };
-
-    // clone & check update
-    let git_url = match env::var(var_name::BLOG_GIT_URL) {
-        Ok(url) => url,
-        Err(e) => {
-            panic_with_log!(
-                Level::ERROR,
-                "failed to read `{}`: {}",
-                var_name::BLOG_GIT_URL,
-                e
-            )
-        }
-    };
-    let git_remote_name = env::var(var_name::BLOG_GIT_REMOTE_NAME)
-        .unwrap_or(default_value::BLOG_GIT_REMOTE_NAME.to_string());
-    let git_remote_branch = env::var(var_name::BLOG_GIT_REMOTE_BRANCH)
-        .unwrap_or(default_value::BLOG_GIT_REMOTE_BRANCH.to_string());
-
-    let arc_args = Arc::new(Args {
-        db_connection,
-        git_work_dir,
-        git_url,
-        git_remote_name,
-        git_remote_branch,
-    });
-
-    move || Box::pin(workflow(arc_args.clone()))
-}
-
-async fn workflow(args: Arc<Args>) {
-    let deltas = match fetch_deltas(
-        &args.git_url,
-        &args.git_remote_name,
-        &args.git_remote_branch,
-        &args.git_work_dir,
-    )
-    .await
-    {
-        Ok(updates) => updates,
-        Err(e) => {
-            error!("delta parsing error: {}", e);
-            return;
-        }
-    };
-
-    if deltas.is_empty() {
-        trace!("blog git already up-to-date");
-        return;
-    }
-
-    apply_deltas(&args.db_connection, deltas).await;
-}

backend/server/src/modules/blog/components/check_update/pull.rs

@@ -1,171 +0,0 @@
-use std::{collections::HashMap, fs::remove_dir_all, path::PathBuf};
-
-use crate::{
-    modules::blog::components::check_update::{
-        changes::{Change, Create, CreateDelete2UpdateSlot, Delete, Update},
-        error::Error,
-    },
-    utils::{git, git::FileDelta},
-};
-use markdown::MdFile;
-
-use git2::{Delta, Repository};
-use tracing::{error, warn};
-use uuid::Uuid;
-
-pub async fn fetch_deltas(
-    git_url: &str,
-    git_remote_name: &str,
-    git_remote_branch: &str,
-    git_work_dir: &PathBuf,
-) -> Result<Vec<Change>, Error> {
-    let repo = match Repository::open(git_work_dir) {
-        Ok(repo) => repo,
-        Err(_) => match Repository::clone(git_url, git_work_dir) {
-            Ok(repo) => repo,
-            Err(e) => {
-                error!("failed to clone blog content git({}): {}", &git_url, e);
-                return Err(e.into());
-            }
-        },
-    };
-
-    let mut remote = match repo.find_remote(git_remote_name) {
-        Ok(remote) => remote,
-        Err(e) => {
-            remove_dir_all(git_work_dir).unwrap();
-            warn!(
-                "cannot find git remote ({}), reinitializing: {}",
-                git_remote_name, e
-            );
-            return Err(e.into());
-        }
-    };
-    if remote.url().is_some_and(|url| url != git_url) {
-        remove_dir_all(git_work_dir).unwrap();
-        warn!(
-            "git remote url mismatch (expected: {}, actual: {}), reinitializing",
-            git_url,
-            remote.url().unwrap()
-        );
-        return Err(Error::GitUrlMismatch);
-    }
-
-    let fetched_commit = git::do_fetch(&repo, &[git_remote_branch], &mut remote)?;
-    let commit_deltas = git::calculate_diff(
-        &repo,
-        &repo.reference_to_annotated_commit(&repo.head()?)?,
-        &fetched_commit,
-    )?;
-
-    // dbg!(&commit_deltas);
-    let mut changes: Vec<Change> = vec![];
-    let mut non_delete_deltas: Vec<FileDelta> = vec![];
-
-    // process deleted deltas before merging commit to prevent "file not found" os error
-    for delta in commit_deltas.into_iter() {
-        // todo: limit scanning scope to post only OR extract merging logic to external component
-
-        if delta.status == Delta::Deleted {
-            let file_path = &git_work_dir.join(
-                delta
-                    .new_path
-                    .expect("cannot parse modified post `new_path`"),
-            );
-            if let Some(id) = extract_post_id(&MdFile::from_file(file_path)?) {
-                changes.push(Change::Delete(Delete {
-                    uuid: id,
-                    path: file_path.clone(),
-                }))
-            } else {
-                error!("failed to parse uuid for file {}", file_path.display());
-                // todo: add to unresolved error list
-            }
-        } else {
-            non_delete_deltas.push(delta);
-        }
-    }
-
-    git::do_merge(&repo, git_remote_branch, fetched_commit)?;
-
-    // process adds and modifies deltas
-    for delta in non_delete_deltas.into_iter() {
-        let file_path = &git_work_dir.join(
-            delta
-                .new_path
-                .expect("cannot parse modified post `new_path`"),
-        );
-        match delta.status {
-            Delta::Added => {
-                let md_file = MdFile::from_file(file_path)?;
-                if let Some(id) = extract_post_id(&md_file) {
-                    changes.push(Change::Create(Create {
-                        uuid: id,
-                        path: file_path.clone(),
-                        payload: md_file,
-                    }))
-                } else {
-                    error!("failed to parse uuid for file {}", file_path.display());
-                    // todo: add to unresolved error list
-                }
-            }
-            Delta::Modified => {
-                let md_file = MdFile::from_file(file_path)?;
-                if let Some(id) = extract_post_id(&md_file) {
-                    changes.push(Change::Update(Update {
-                        uuid: id,
-                        path: file_path.clone(),
-                        payload: md_file,
-                    }))
-                } else {
-                    error!("failed to parse uuid for file {}", file_path.display());
-                    // todo: add to unresolved error list
-                }
-            }
-            Delta::Deleted => continue,
-            _ => {
-                error!("unsupported delta type on file {}", file_path.display());
-                continue;
-            }
-        }
-    }
-
-    // merge adds and deletes deltas to moves
-    let changes = dbg!(merge_changes(changes));
-
-    Ok(changes)
-}
-
-fn extract_post_id(post: &MdFile) -> Option<Uuid> {
-    match post.meta["uuid"].as_str() {
-        Some(id) => Uuid::parse_str(id).ok(),
-        None => None,
-    }
-}
-
-fn merge_changes(changes: Vec<Change>) -> Vec<Change> {
-    let mut slots: HashMap<Uuid, CreateDelete2UpdateSlot> = HashMap::new();
-    let mut merged: Vec<Change> = Vec::new();
-
-    for change in changes {
-        match change {
-            Change::Create(create) => {
-                let id = create.uuid;
-                slots.entry(id).or_default().create = Some(create);
-            }
-            Change::Delete(delete) => {
-                let id = delete.uuid;
-                slots.entry(id).or_default().delete = Some(delete);
-            }
-            _ => merged.push(change),
-        }
-    }
-
-    for slot in slots.values() {
-        if let Some(change) = slot.to_change() {
-            merged.push(change);
-        }
-    }
-
-    merged
-}

backend/server/src/modules/blog/components/check_update/sql/create_post.sql

@@ -1,7 +0,0 @@
-INSERT INTO posts
-(id, identifier, title, subtitle, date_created, date_updated, status, content, category)
-VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9);
-
-INSERT INTO post_tag (post, tag)
-SELECT $1, tag
-FROM UNNEST($10) AS t(tag);

backend/server/src/modules/blog/components/check_update/sql/create_return_category_id.sql

@@ -1,3 +0,0 @@
-INSERT INTO categories(name)
-VALUES ($1)
-RETURNING id;

backend/server/src/modules/blog/components/check_update/sql/create_return_tag_id.sql

@@ -1,3 +0,0 @@
-INSERT INTO tags(name)
-VALUES ($1)
-RETURNING id;

backend/server/src/modules/blog/components/check_update/sql/delete_post_by_id.sql

@@ -1,3 +0,0 @@
-DELETE
-FROM posts
-WHERE id = $1;

backend/server/src/modules/blog/components/check_update/sql/get_category_id.sql

@@ -1,3 +0,0 @@
-SELECT id
-FROM categories
-WHERE name = $1;

backend/server/src/modules/blog/components/check_update/sql/get_tag_id.sql

@@ -1,3 +0,0 @@
-SELECT id
-FROM tags
-WHERE name = $1;

backend/server/src/modules/blog/components/check_update/utils.rs

@@ -1,58 +0,0 @@
-use std::path::Path;
-
-use crate::constants::{
-    config::general::{default_value, var_name},
-    time::DEFAULT_NAIVE_DATE_FORMAT,
-};
-
-use chrono::NaiveDate;
-use dirs::home_dir;
-use tracing::warn;
-
-pub fn expand_path(path: String) -> String {
-    if path.starts_with('~') {
-        home_dir()
-            .map(|dir| {
-                dir.join(path.strip_prefix("~/").unwrap())
-                    .into_os_string()
-                    .into_string()
-                    .unwrap()
-            })
-            .unwrap_or_else(|| {
-                warn!(
-                    "failed to parse env var `{}`, using default value `{}`",
-                    var_name::WORK_DIR,
-                    default_value::WORK_DIR
-                );
-                default_value::WORK_DIR.to_string()
-            })
-    } else {
-        path
-    }
-}
-
-pub fn parse_post_identifier(path: &Path) -> Option<String> {
-    if let Some(comp) = path.components().nth_back(1) {
-        comp.as_os_str().to_str().map(|s| s.to_string())
-    } else {
-        None
-    }
-}
-
-pub fn parse_naive_date_str(date_str: &str) -> Option<NaiveDate> {
-    NaiveDate::parse_from_str(date_str, DEFAULT_NAIVE_DATE_FORMAT).ok()
-}
-
-#[cfg(test)]
-mod tests {
-    use crate::modules::blog::components::check_update::utils::parse_naive_date_str;
-    use chrono::NaiveDate;
-
-    #[test]
-    fn test_parse_naive_date() {
-        assert_eq!(
-            NaiveDate::from_ymd_opt(2015, 1, 1),
-            parse_naive_date_str("2015-1-01")
-        );
-    }
-}

backend/server/src/modules/blog/components/consistency_guard/mod.rs

@@ -1 +0,0 @@
-

backend/server/src/modules/blog/components/mod.rs

@@ -1,3 +0,0 @@
-pub mod check_update;
-mod consistency_guard;
-mod rag;

backend/server/src/modules/blog/components/rag/mod.rs

@@ -1 +0,0 @@
-

backend/server/src/modules/blog/mod.rs

@@ -1,55 +0,0 @@
-mod api;
-mod components;
-
-use crate::modules::blog::components::check_update;
-use crate::scheduler::tasks::async_basic::AsyncBasic;
-use crate::{
-    modules::{
-        Module,
-        blog::{
-            api::{
-                get_page_count,
-                get_post,
-                // get_post_list::get_post_list,
-            },
-            // cron::check_update,
-        },
-    },
-    scheduler::tasks::CronTask,
-};
-
-use axum::{Router, routing::get};
-use sqlx::PgPool;
-
-const MOUNT_POINT: &str = "/blog";
-
-pub struct Blog {
-    pub db_handler: PgPool,
-}
-
-impl Module for Blog {
-    fn get_server_router(&self) -> Router {
-        let db_handler = self.db_handler.clone();
-        // todo: move resource init to new func
-        // todo: remove debug comment
-        Router::new()
-            // .route("/get_post_list", get(get_post_list))
-            .route("/get_page_count", get(get_page_count::handler))
-            .route("/get_post/{identifier}", get(get_post::handler))
-            .with_state(db_handler)
-    }
-
-    fn get_mount_point(&self) -> &'static str {
-        MOUNT_POINT
-    }
-
-    fn get_cron_tasks(&self) -> Vec<(&str, Box<dyn CronTask>)> {
-        let db_handler = self.db_handler.clone();
-        vec![(
-            "Blog Check Update",
-            AsyncBasic::new(check_update::task(db_handler.clone()), "*/5 * * * * *")
-                .unwrap()
-                .to_task(),
-        )]
-    }
-}

backend/server/src/modules/blog/schema.sql

@@ -1,65 +0,0 @@
-CREATE TABLE tags
-(
-    id          SERIAL PRIMARY KEY,
-    name        VARCHAR(20) UNIQUE NOT NULL,
-    description TEXT DEFAULT ''
-);
-
-CREATE TABLE categories
-(
-    id          SERIAL PRIMARY KEY,
-    name        VARCHAR(20) UNIQUE NOT NULL,
-    description TEXT DEFAULT ''
-);
-
-CREATE TABLE post_status
-(
-    id   SERIAL PRIMARY KEY,
-    name VARCHAR(20) UNIQUE NOT NULL
-);
-
-INSERT INTO post_status (name)
-VALUES ('draft'),
-       ('published'),
-       ('planned'),
-       ('hidden');
-
-CREATE TABLE posts
-(
-    id           UUID PRIMARY KEY,
-    identifier   VARCHAR(100) UNIQUE                           NOT NULL,
-    title        VARCHAR(255)                                  NOT NULL,
-    subtitle     VARCHAR(255)                                  NOT NULL,
-    date_created DATE                                          NOT NULL,
-    date_updated DATE,
-    status       INTEGER REFERENCES post_status (id) DEFAULT 1 NOT NULL,
-    content      TEXT                                          NOT NULL,
-    category     INTEGER REFERENCES categories (id)            NOT NULL
-);
-
-CREATE TABLE post_tag
-(
-    post UUID REFERENCES posts (id) ON DELETE CASCADE,
-    tag  INTEGER REFERENCES tags (id) ON DELETE CASCADE,
-
-    CONSTRAINT post_tag_pk PRIMARY KEY (post, tag)
-);
-
-CREATE TABLE metadata
-(
-    pid        UUID REFERENCES posts (id) ON DELETE CASCADE NOT NULL,
-    meta_key   VARCHAR(50)                                  NOT NULL,
-    meta_value TEXT                                         NOT NULL,
-
-    CONSTRAINT metadata_pk PRIMARY KEY (pid, meta_key)
-);
-
--- index
-CREATE INDEX idx_tags_name ON tags (name);
-CREATE INDEX idx_categories_name ON categories (name);
-CREATE INDEX idx_posts_identifier ON posts (identifier);
-CREATE INDEX idx_posts_status ON posts (status);
-CREATE INDEX idx_posts_category ON posts (category);
-CREATE INDEX idx_post_tag_post ON post_tag (post);
-CREATE INDEX idx_post_tag_tag ON post_tag (tag);
-CREATE INDEX idx_metadata_pid ON metadata (pid);

backend/server/src/modules/mod.rs

@@ -1,82 +0,0 @@
-use std::{env, num::ParseIntError};
-
-use crate::{
-    constants::config::server::{default_value, var_name},
-    scheduler::{Scheduler, tasks::CronTask},
-};
-use macros::error_panic;
-
-use axum::Router;
-use tokio::net::TcpListener;
-use tracing::{info, warn};
-
-pub mod blog;
-
-// todo: merge `get_server_router` & `get_mount_point`, make Option
-pub trait Module {
-    fn get_server_router(&self) -> Router;
-
-    fn get_mount_point(&self) -> &'static str;
-
-    fn get_cron_tasks(&self) -> Vec<(&str, Box<dyn CronTask>)>;
-}
-
-pub struct ModuleTree {
-    pub modules: Vec<Box<dyn Module>>,
-}
-
-impl ModuleTree {
-    pub fn new() -> Self {
-        ModuleTree { modules: vec![] }
-    }
-
-    pub fn add_module(&mut self, module: impl Module + 'static) -> &mut Self {
-        self.modules.push(Box::new(module));
-        self
-    }
-
-    pub async fn blocking_serve(&self) {
-        let mut scheduler = Scheduler::new();
-        let mut app = Router::new();
-
-        let port: u32 = match env::var(var_name::PORT) {
-            Ok(value) => value.parse().unwrap_or_else(|e: ParseIntError| {
-                warn!(
-                    "failed to parse `{}`, using default port: {}",
-                    var_name::PORT,
-                    e.to_string()
-                );
-                default_value::PORT
-            }),
-            Err(_) => default_value::PORT,
-        };
-
-        let listener = match TcpListener::bind(format!("{}:{}", default_value::HOST, port)).await {
-            Ok(listener) => {
-                info!("server starting on {}:{}", default_value::HOST, port);
-                listener
-            }
-            Err(e) => {
-                error_panic!(
-                    "failed to start server on {}:{}: {}",
-                    default_value::HOST,
-                    port,
-                    e.to_string()
-                );
-            }
-        };
-
-        for module in &self.modules {
-            let _ = scheduler.insert_list(module.get_cron_tasks());
-            app = app.nest(module.get_mount_point(), module.get_server_router());
-        }
-
-        tokio::spawn(async move {
-            scheduler.start().await;
-        });
-
-        axum::serve(listener, app).await.unwrap_or_else(|e| {
-            error_panic!("failed to start axum: {}", e.to_string());
-        });
-    }
-}

backend/server/src/scheduler/error.rs

@@ -1,49 +0,0 @@
-use std::{
-    error::Error,
-    fmt::{Debug, Display, Formatter},
-    sync::PoisonError,
-};
-
-use crate::scheduler::error::SchedulerError::MutexPoison;
-
-// todo: refactor with thiserror
-#[allow(dead_code)]
-pub enum SchedulerError {
-    IdNotFound,
-    IdAlreadyRunning,
-    MutexPoison(String),
-}
-
-impl<T> From<PoisonError<T>> for SchedulerError {
-    fn from(value: PoisonError<T>) -> Self {
-        MutexPoison(value.to_string())
-    }
-}
-
-impl Debug for SchedulerError {
-    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
-        write!(f, "{}", self)
-    }
-}
-
-impl Display for SchedulerError {
-    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
-        write!(
-            f,
-            "{}",
-            match self {
-                SchedulerError::IdNotFound => {
-                    "SchedulerError::IdNotFound".to_string()
-                }
-                SchedulerError::IdAlreadyRunning => {
-                    "SchedulerError::IdAlreadyRunning".to_string()
-                }
-                MutexPoison(str) => {
-                    format!("SchedulerError::MutexPoison: {}", str)
-                }
-            }
-        )
-    }
-}
-
-impl Error for SchedulerError {}

backend/server/src/scheduler/mod.rs

@@ -1,54 +0,0 @@
-use std::{collections::HashMap, sync::Arc};
-
-use crate::scheduler::{error::SchedulerError, tasks::CronTask, utils::execute};
-
-use futures::future::join_all;
-use tracing::warn;
-
-pub mod error;
-pub mod task_func;
-pub mod tasks;
-mod utils;
-
-pub type TaskPool = HashMap<String, Arc<Box<dyn CronTask>>>;
-
-#[derive(Default)]
-pub struct Scheduler {
-    task_pool: TaskPool,
-}
-
-impl Scheduler {
-    /// Start all tasks in the scheduler
-    pub async fn start(&self) {
-        let fut = self
-            .task_pool
-            .clone()
-            .into_iter()
-            .map(|(name, task)| execute(name, task))
-            .collect::<Vec<_>>();
-        // self.runner.run_all().await
-        join_all(fut).await;
-    }
-
-    pub fn insert(&mut self, task: (&str, Box<dyn CronTask>)) -> Result<&Self, SchedulerError> {
-        let (k, v) = task;
-        if self.task_pool.insert(k.into(), v.into()).is_some() {
-            warn!("task list duplicated key detected: {}", k);
-        }
-        Ok(self)
-    }
-
-    pub fn insert_list(
-        &mut self,
-        tasks: Vec<(&str, Box<dyn CronTask>)>,
-    ) -> Result<&Self, SchedulerError> {
-        for task in tasks {
-            self.insert(task)?;
-        }
-        Ok(self)
-    }
-
-    pub fn new() -> Self {
-        Self::default()
-    }
-}

backend/server/src/scheduler/task_func.rs

@@ -1,15 +0,0 @@
-use std::pin::Pin;
-
-pub trait TaskFunc: Fn() + Send + Sync + 'static {}
-
-impl<T> TaskFunc for T where T: Fn() + Send + Sync + Clone + 'static {}
-
-pub trait AsyncTaskFunc:
-    Fn() -> Pin<Box<dyn Future<Output = ()> + Send>> + Send + Sync + 'static
-{
-}
-
-impl<T> AsyncTaskFunc for T where
-    T: Fn() -> Pin<Box<dyn Future<Output = ()> + Send>> + Send + Sync + Clone + 'static
-{
-}

backend/server/src/scheduler/tasks/async_basic.rs

@@ -1,37 +0,0 @@
-use std::{error::Error, pin::Pin, str::FromStr};
-
-use crate::{scheduler::task_func::AsyncTaskFunc, scheduler::tasks::CronTask};
-
-use chrono::{DateTime, Utc};
-use cron::Schedule;
-
-pub struct AsyncBasic {
-    schedule: Schedule,
-    func: Box<dyn AsyncTaskFunc>,
-}
-
-impl AsyncBasic {
-    pub fn new<F>(func: F, cron_expr: &str) -> Result<Self, Box<dyn Error>>
-    where
-        F: AsyncTaskFunc,
-    {
-        Ok(AsyncBasic {
-            schedule: Schedule::from_str(cron_expr)?,
-            func: Box::new(func),
-        })
-    }
-
-    pub fn to_task(self) -> Box<dyn CronTask> {
-        Box::new(self)
-    }
-}
-
-impl CronTask for AsyncBasic {
-    fn get_next_execution(&self) -> Option<DateTime<Utc>> {
-        self.schedule.upcoming(Utc).next()
-    }
-
-    fn call(&self) -> Pin<Box<(dyn Future<Output = ()> + Send)>> {
-        Box::pin((self.func)())
-    }
-}

backend/server/src/scheduler/tasks/basic.rs

@@ -1,37 +0,0 @@
-use std::{error::Error, pin::Pin, str::FromStr};
-
-use crate::scheduler::{task_func::TaskFunc, tasks::CronTask};
-
-use chrono::{DateTime, Utc};
-use cron::Schedule;
-
-pub struct BasicTask {
-    schedule: Schedule,
-    func: Box<dyn TaskFunc>,
-}
-
-impl BasicTask {
-    pub fn new<F>(func: F, cron_expr: &str) -> Result<Self, Box<dyn Error>>
-    where
-        F: TaskFunc,
-    {
-        Ok(BasicTask {
-            schedule: Schedule::from_str(cron_expr)?,
-            func: Box::new(func),
-        })
-    }
-
-    pub fn to_task(self) -> Box<dyn CronTask> {
-        Box::new(self)
-    }
-}
-
-impl CronTask for BasicTask {
-    fn get_next_execution(&self) -> Option<DateTime<Utc>> {
-        self.schedule.upcoming(Utc).next()
-    }
-
-    fn call(&self) -> Pin<Box<dyn Future<Output = ()> + Send + '_>> {
-        Box::pin(async { (self.func)() })
-    }
-}

backend/server/src/scheduler/tasks/mod.rs

@@ -1,14 +0,0 @@
-use std::pin::Pin;
-
-use chrono::{DateTime, Utc};
-
-#[allow(dead_code)]
-pub mod async_basic;
-
-#[allow(dead_code)]
-pub mod basic;
-
-pub trait CronTask: Send + Sync {
-    fn get_next_execution(&self) -> Option<DateTime<Utc>>;
-    fn call(&self) -> Pin<Box<dyn Future<Output = ()> + Send + '_>>;
-}

backend/server/src/scheduler/utils.rs

@@ -1,32 +0,0 @@
-use std::{sync::Arc, time::Duration};
-
-use crate::scheduler::{error::SchedulerError, tasks::CronTask};
-
-use chrono::{DateTime, Utc};
-use tokio::time::{Sleep, sleep};
-
-pub fn duration_from_now(future: DateTime<Utc>) -> Duration {
-    future
-        .signed_duration_since(Utc::now())
-        .to_std()
-        .unwrap_or(Duration::ZERO)
-}
-
-pub fn sleeper_from_now(future: DateTime<Utc>) -> Sleep {
-    sleep(duration_from_now(future))
-}
-
-#[allow(unused_variables)]
-pub async fn execute(name: String, func: Arc<Box<dyn CronTask>>) -> Result<(), SchedulerError> {
-    // todo: stats
-    while let Some(next_execution) = func.get_next_execution() {
-        let sleeper = sleeper_from_now(next_execution);
-        tokio::pin!(sleeper);
-        tokio::select! {
-            _ = sleeper => {
-                func.call().await
-            }
-        }
-    }
-    Ok(())
-}

backend/server/src/utils/git.rs

@@ -1,166 +0,0 @@
-/// git operations
-/// based on https://github.com/rust-lang/git2-rs/blob/master/examples/pull.rs
-/// https://github.com/rust-lang/git2-rs/commit/f3b87baed1e33d6c2d94fe1fa6aa6503a071d837
-///
-use git2::{
-    AnnotatedCommit, AutotagOption, Delta, FetchOptions, Reference, Remote, Repository, build,
-};
-use std::path::PathBuf;
-use tracing::{error, warn};
-
-#[derive(Debug, Eq, PartialEq)]
-pub struct FileDelta {
-    pub old_path: Option<PathBuf>,
-    pub new_path: Option<PathBuf>,
-    pub status: Delta,
-}
-
-pub fn do_fetch<'a>(
-    repo: &'a Repository,
-    refs: &[&str],
-    remote: &'a mut Remote,
-) -> Result<AnnotatedCommit<'a>, git2::Error> {
-    let mut fetch_option = FetchOptions::new();
-
-    fetch_option.download_tags(AutotagOption::All);
-    remote.fetch(refs, Some(&mut fetch_option), None)?;
-
-    let fetch_head = repo.find_reference("FETCH_HEAD")?;
-    repo.reference_to_annotated_commit(&fetch_head)
-}
-
-fn fast_forward(
-    repo: &Repository,
-    lb: &mut Reference,
-    rc: &AnnotatedCommit,
-) -> Result<(), git2::Error> {
-    let name = match lb.name() {
-        Some(s) => s.to_string(),
-        None => String::from_utf8_lossy(lb.name_bytes()).to_string(),
-    };
-    let msg = format!("fast-forward({}) -> {}", name, rc.id());
-    lb.set_target(rc.id(), &msg)?;
-    repo.set_head(&name)?;
-    repo.checkout_head(Some(build::CheckoutBuilder::default().force()))?;
-    Ok(())
-}
-
-fn normal_merge(
-    repo: &Repository,
-    local: &AnnotatedCommit,
-    remote: &AnnotatedCommit,
-) -> Result<(), git2::Error> {
-    let local_tree = repo.find_commit(local.id())?.tree()?;
-    let remote_tree = repo.find_commit(remote.id())?.tree()?;
-    let ancestor = repo
-        .find_commit(repo.merge_base(local.id(), remote.id())?)?
-        .tree()?;
-    let mut idx = repo.merge_trees(&ancestor, &local_tree, &remote_tree, None)?;
-
-    if idx.has_conflicts() {
-        warn!("merge conflicts detected");
-        repo.checkout_index(Some(&mut idx), None)?;
-        return Ok(());
-    }
-    let result_tree = repo.find_tree(idx.write_tree_to(repo)?)?;
-
-    let msg = format!("merge({}) -> {}", remote.id(), local.id());
-    let sig = repo.signature()?;
-    let local_commit = repo.find_commit(local.id())?;
-    let remote_commit = repo.find_commit(remote.id())?;
-
-    let _merge_commit = repo.commit(
-        Some("HEAD"),
-        &sig,
-        &sig,
-        &msg,
-        &result_tree,
-        &[&local_commit, &remote_commit],
-    )?;
-    repo.checkout_head(None)?;
-    Ok(())
-}
-
-pub fn do_merge<'a>(
-    repo: &'a Repository,
-    remote_branch: &str,
-    fetch_commit: AnnotatedCommit<'a>,
-) -> Result<(), git2::Error> {
-    let analysis = repo.merge_analysis(&[&fetch_commit])?;
-    let head_commit = repo.reference_to_annotated_commit(&repo.head()?)?;
-
-    if analysis.0.is_fast_forward() {
-        let ref_name = format!("refs/heads/{}", remote_branch);
-        match repo.find_reference(&ref_name) {
-            Ok(mut r) => {
-                fast_forward(repo, &mut r, &fetch_commit)?;
-            }
-            Err(_) => {
-                repo.reference(
-                    &ref_name,
-                    fetch_commit.id(),
-                    true,
-                    &format!("({}) -> {}", remote_branch, fetch_commit.id()),
-                )?;
-                repo.set_head(&ref_name)?;
-                repo.checkout_head(Some(
-                    build::CheckoutBuilder::default()
-                        .allow_conflicts(true)
-                        .conflict_style_merge(true)
-                        .force(),
-                ))?;
-            }
-        };
-    } else if analysis.0.is_normal() {
-        normal_merge(repo, &head_commit, &fetch_commit)?;
-    }
-
-    Ok(())
-}
-
-pub fn calculate_diff(
-    repo: &Repository,
-    local: &AnnotatedCommit,
-    remote: &AnnotatedCommit,
-) -> Result<Vec<FileDelta>, git2::Error> {
-    let local_tree = repo.find_commit(local.id())?.tree()?;
-    let remote_tree = repo.find_commit(remote.id())?.tree()?;
-    let diff = repo.diff_tree_to_tree(Some(&local_tree), Some(&remote_tree), None)?;
-
-    let mut updated_files: Vec<FileDelta> = Vec::new();
-
-    if let Err(e) = diff.foreach(
-        &mut |d, _| {
-            updated_files.push(FileDelta {
-                old_path: d.old_file().path().map(PathBuf::from),
-                new_path: d.new_file().path().map(PathBuf::from),
-                status: d.status(),
-            });
-            true
-        },
-        None,
-        None,
-        None,
-    ) {
-        error!("error at calculating diff: {:?}", e);
-    }
-
-    Ok(updated_files.into_iter().collect())
-}
-
-#[allow(dead_code)]
-pub fn sync(
-    remote_name: &str,
-    remote_branch: &str,
-    repo: &Repository,
-) -> Result<Vec<FileDelta>, git2::Error> {
-    let mut remote = repo.find_remote(remote_name)?;
-    let fetch_commit = do_fetch(repo, &[remote_branch], &mut remote)?;
-    let delta = calculate_diff(
-        repo,
-        &repo.reference_to_annotated_commit(&repo.head()?)?,
-        &fetch_commit,
-    );
-    do_merge(repo, remote_branch, fetch_commit)?;
-    delta
-}

backend/server/src/utils/mod.rs

@@ -1 +0,0 @@
-pub mod git;

client/.gitignore

@@ -1,11 +0,0 @@
-.venv/
-
-.idea/
-
-.DS_store
-
-__pycache__
-
-.cache
-
-content/*

client/README.md

@@ -1,30 +0,0 @@
-## Module Structure
-
-```shell
-.
-├── README.md
-├── cli
-├── content
-│   ├── pages
-│   │   └── about
-│   │       └── <static_page>.md
-│   └── posts
-│       └── <year>
-│           └── <identifier>
-│               ├── assets
-│               │   └── <assets>
-│               ├── translate_<lang>.md
-│               └── index.md
-├── requirements.txt
-├── templates
-│   ├── <template>.py
-│   └── ...
-└── utils
-    └── ...
-```
-
-### About `posts`
-
-- Will render to `https://<DOMAIN>/blog/post/<identifier>`.
-- Files under `assets/` (where images etc. located) should be pushed to OSS.
-- For identifiers, use prefix `-` to indicate private (hidden) visibility. EX: `-hello-world`.

client/cli

@@ -1,27 +0,0 @@
-#!/usr/bin/env python3
-
-import argparse
-
-import rich
-
-from templates.post import BlogPost
-from utils.cache import init_cache
-from utils.index import build_post_idx
-
-
-def main():
-    # if args.new:
-    #     new_post()
-    init_cache()
-    build_post_idx()
-    bp = BlogPost()
-    bp.init()
-
-
-parser = argparse.ArgumentParser()
-parser.add_argument("-n", "--new", help="Create a post with build-in template", type=str)
-args = parser.parse_args(namespace=rich)
-# todo: cli
-
-if __name__ == '__main__':
-    main()

client/requirements.txt

@@ -1,4 +0,0 @@
-rich~=13.9.4
-prompt_toolkit~=3.0.50
-pypinyin~=0.53.0
-python-frontmatter~=1.1.0

client/templates/post.py

@@ -1,87 +0,0 @@
-import uuid
-from datetime import date
-from datetime import datetime as dt
-from typing import Dict, Optional
-
-from templates.utils import Template, create_all_files
-from utils.autocompletion import input_autocompletion, fuzzy_pinyin_matcher
-from utils.cache import get_tags_cache, get_categories_cache
-from utils.lang import eprint, wprint
-
-POST_TEMPLATE = '''
----
-title: {{ title }}
-subtitle: {{ subtitle }}
-published_date: {{ published_date }}
-last_updated: {{ last_update }}
-category: {{ category }}
-tags: {{ tags }}
-uuid: {{ uuid }}
----
-
-WIP
-
-'''
-
-
-def get_title():
-    while True:
-        i = input("title > ")
-        if i.strip() == "":
-            eprint("empty title")
-            continue
-        else:
-            return i.strip()
-
-
-def get_subtitle():
-    return input("subtitle > ")
-
-
-def get_published_date():
-    while True:
-        d = input("published_date (YYYY-MM-DD) > ")
-        if d == "":
-            wprint("using today's date")
-            return dt.today().strftime("%Y-%m-%d")
-        else:
-            try:
-                _validate = dt.strptime(d, "%Y-%m-%d")
-                return d
-            except ValueError:
-                eprint("invalid date")
-                continue
-
-
-def get_tags():
-    # todo: multi tags support
-    return input_autocompletion("tags > ", get_tags_cache(), fuzzy_pinyin_matcher)
-
-
-def get_category():
-    while True:
-        i = input_autocompletion("category > ", get_categories_cache(), fuzzy_pinyin_matcher)
-        if i.strip() == "":
-            eprint("empty category")
-            continue
-        else:
-            return i.strip()
-
-
-class BlogPost(Template):
-    WORK_PATH: str = "content/posts/{year}/{identifier}/"
-    ITEMS: Dict[str, Optional[str]] = {"index.md": POST_TEMPLATE, "assets/": None}
-
-    def init(self):
-        year = date.today().year
-
-        index_md = POST_TEMPLATE.format(
-            title=get_title(),
-            subtitle=get_subtitle(),
-            published_date=get_published_date(),
-            last_update=dt.today().strftime("%Y-%m-%d"),
-            tags=get_tags(),
-            category=get_category(),
-            uuid=uuid.uuid4()
-        )
-        create_all_files(self.WORK_PATH.format(year=year, identifier="test"), self.ITEMS)

client/templates/utils.py

@@ -1,17 +0,0 @@
-import os
-from abc import ABC, abstractmethod
-from typing import Dict, Optional
-
-
-class Template(ABC):
-    @abstractmethod
-    def init(self):
-        pass
-
-
-def create_all_files(relative_work_path: str, items: Dict[str, Optional[str]]):
-    absolute_path = os.path.abspath(relative_work_path)
-    for item in items:
-        if item.endswith("/"):
-            print(absolute_path + item)
-    # todo: create files

client/utils/ansi.py

@@ -1,31 +0,0 @@
-class Ansi:
-    HEADER = '\033[95m'
-    BLUE = '\033[94m'
-    GREEN = '\033[92m'
-    WARNING = '\033[93m'
-    FAIL = '\033[91m'
-    BOLD = '\033[1m'
-    UNDERLINE = '\033[4m'
-    END = '\033[0m'
-
-    def disable(self) -> None:
-        self.HEADER = ''
-        self.BLUE = ''
-        self.GREEN = ''
-        self.WARNING = ''
-        self.FAIL = ''
-        self.BOLD = ''
-        self.UNDERLINE = ''
-        self.END = ''
-
-    @staticmethod
-    def blend(color: list[str], text: str) -> str:
-        return f"{"".join(color)}{text}{Ansi.END}"
-
-    @staticmethod
-    def bold(text: str) -> str:
-        return f"{Ansi.BOLD}{text}{Ansi.END}"
-
-    @staticmethod
-    def underline(text: str) -> str:
-        return f"{Ansi.UNDERLINE}{text}{Ansi.END}"

client/utils/autocompletion.py

@@ -1,46 +0,0 @@
-from collections.abc import Callable
-from typing import List, Iterable
-
-import prompt_toolkit
-from prompt_toolkit.completion import Completer, CompleteEvent, Completion
-from prompt_toolkit.document import Document
-from pypinyin import lazy_pinyin, Style
-
-
-class AutoCompleter(Completer):
-    def __init__(self, candidates: List[str], matching_algorithm: Callable[[str, str], bool]):
-        self.candidates = candidates
-        self.matching_algorithm = matching_algorithm
-
-    def get_completions(self, document: Document, complete_event: CompleteEvent) -> Iterable[Completion]:
-        curr_word = document.text_before_cursor
-        for c in self.candidates:
-            if self.matching_algorithm(curr_word, c):
-                yield Completion(c, start_position=-len(curr_word))
-
-
-def exact_matcher(word: str, candidate: str, case_sensitive: bool = False) -> bool:
-    if case_sensitive:
-        return word == candidate
-    else:
-        return word.lower() == candidate.lower()
-
-
-def fuzzy_matcher(word: str, candidate: str) -> bool:
-    return word.lower() in candidate.lower()
-
-
-def fuzzy_pinyin_matcher(word: str, candidate: str) -> bool:
-    try:
-        word_matcher = ''.join(lazy_pinyin(word, style=Style.NORMAL))
-        candidate_matcher = ''.join(lazy_pinyin(candidate, style=Style.NORMAL))
-        return candidate_matcher.startswith(word_matcher)
-
-    except e:
-        return fuzzy_matcher(word, candidate)
-
-
-def input_autocompletion(prompt: str, candidates: List[str],
-                         matching_algorithm: Callable[[str, str], bool] = exact_matcher) -> str:
-    completer = AutoCompleter(candidates, matching_algorithm)
-    return prompt_toolkit.prompt(prompt, completer=completer, complete_in_thread=True)

client/utils/cache.py

@@ -1,49 +0,0 @@
-import json
-import os
-from typing import TextIO
-
-CACHE_DIR = ".cache"
-ITEMS = {"register": "register.json"}
-
-
-def overwrite_json_file(file: TextIO, json_data: dict):
-    file.seek(0)
-    file.write(json.dumps(json_data, indent=4, ensure_ascii=False))
-    file.truncate()
-
-
-def init_cache():
-    if not os.path.exists(CACHE_DIR):
-        os.makedirs(CACHE_DIR)
-    for item in ITEMS.values():
-        item_path = os.path.join(CACHE_DIR, item)
-        if not os.path.exists(item_path):
-            with open(item_path, 'w') as cache_file:
-                match item:
-                    case "register.json":
-                        overwrite_json_file(cache_file, {})
-                        break
-
-
-def write_tags_cache(tags: list[str]):
-    with open(os.path.join(CACHE_DIR, ITEMS["register"]), 'r+') as tags_cache_file:
-        cache = json.load(tags_cache_file)
-        cache["tags"] = tags
-        overwrite_json_file(tags_cache_file, cache)
-
-
-def write_category_cache(categories: list[str]):
-    with open(os.path.join(CACHE_DIR, ITEMS["register"]), 'r+') as categories_cache_file:
-        cache = json.load(categories_cache_file)
-        cache["categories"] = categories
-        overwrite_json_file(categories_cache_file, cache)
-
-
-def get_tags_cache() -> list[str]:
-    with open(os.path.join(CACHE_DIR, ITEMS["register"]), 'r') as tags_cache_file:
-        return json.load(tags_cache_file)["tags"]
-
-
-def get_categories_cache() -> list[str]:
-    with open(os.path.join(CACHE_DIR, ITEMS["register"]), 'r') as categories_cache_file:
-        return json.load(categories_cache_file)["categories"]

client/utils/index.py

@@ -1,27 +0,0 @@
-import os
-
-import frontmatter
-
-from utils.cache import write_tags_cache, write_category_cache
-from utils.lang import list_exclude
-
-EXCLUDE = [".DS_Store"]
-POSTS_DIR = "content/posts"
-
-
-def build_post_idx():
-    tags = set()
-    categories = set()
-    for year in list_exclude(os.listdir(POSTS_DIR), EXCLUDE):
-        for post_dir in list_exclude(os.listdir(os.path.join(POSTS_DIR, year)), EXCLUDE):
-            target_file = os.path.join(POSTS_DIR, year, post_dir, "index.md")
-            with open(target_file, "r") as f:
-                post = frontmatter.loads(f.read())
-                try:
-                    for tag in post.metadata["tags"]:
-                        tags.add(tag)
-                    categories.add(post.metadata["category"])
-                except KeyError:
-                    print(f"failed to parse {target_file}")
-    write_tags_cache(list(tags))
-    write_category_cache(list(categories))

client/utils/lang.py

@@ -1,13 +0,0 @@
-from utils.ansi import Ansi
-
-
-def list_exclude(source: list, exclude: list):
-    return filter(lambda item: item not in exclude, source)
-
-
-def eprint(msg: str):
-    print(Ansi.blend([Ansi.FAIL], "error: ") + msg)
-
-
-def wprint(msg: str):
-    print(Ansi.blend([Ansi.WARNING], "warn: ") + msg)

frontend/.dockerignore

@@ -1,10 +0,0 @@
-/node_modules
-
-/.next
-/out
-/build
-
-.DS_Store
-*.pem
-
-.env*.local

frontend/.eslintignore

@@ -0,0 +1,38 @@
+**/*.log
+**/.DS_Store
+*.
+.vscode/settings.json
+.history
+.yarn
+bazel-*
+bazel-bin
+bazel-out
+bazel-qwik
+bazel-testlogs
+dist
+dist-dev
+lib
+lib-types
+etc
+external
+node_modules
+temp
+tsc-out
+tsdoc-metadata.json
+target
+output
+rollup.config.js
+build
+.cache
+.vscode
+.rollup.cache
+dist
+tsconfig.tsbuildinfo
+vite.config.ts
+*.spec.tsx
+*.spec.ts
+.netlify
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+server

frontend/.eslintrc.cjs

@@ -0,0 +1,42 @@
+module.exports = {
+  root: true,
+  env: {
+    browser: true,
+    es2021: true,
+    node: true,
+  },
+  extends: [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:qwik/recommended",
+  ],
+  parser: "@typescript-eslint/parser",
+  parserOptions: {
+    tsconfigRootDir: __dirname,
+    project: ["./tsconfig.json"],
+    ecmaVersion: 2021,
+    sourceType: "module",
+    ecmaFeatures: {
+      jsx: true,
+    },
+  },
+  plugins: ["@typescript-eslint"],
+  rules: {
+    "@typescript-eslint/no-explicit-any": "off",
+    "@typescript-eslint/explicit-module-boundary-types": "off",
+    "@typescript-eslint/no-inferrable-types": "off",
+    "@typescript-eslint/no-non-null-assertion": "off",
+    "@typescript-eslint/no-empty-interface": "off",
+    "@typescript-eslint/no-namespace": "off",
+    "@typescript-eslint/no-empty-function": "off",
+    "@typescript-eslint/no-this-alias": "off",
+    "@typescript-eslint/ban-types": "off",
+    "@typescript-eslint/ban-ts-comment": "off",
+    "prefer-spread": "off",
+    "no-case-declarations": "off",
+    "no-console": "off",
+    "@typescript-eslint/no-unused-vars": ["error"],
+    "@typescript-eslint/consistent-type-imports": "warn",
+    "@typescript-eslint/no-unnecessary-condition": "warn",
+  },
+};

frontend/.eslintrc.json

@@ -1,3 +0,0 @@
-{
-  "extends": "next/core-web-vitals"
-}

frontend/.gitignore

@@ -1,43 +1,42 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+# Build
+/dist
+/lib
+/lib-types
+/server
 
-# dependencies
+# Development
-/node_modules
+node_modules
-/.pnp
+.env
-.pnp.js
+*.local
-.yarn/install-state.gz
 
-# testing
+# Cache
-/coverage
+.cache
+.mf
+.rollup.cache
+tsconfig.tsbuildinfo
 
-# next.js
+# Logs
-/.next/
+logs
-/out/
+*.log
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
 
-# local env files
+# Editor
-.env*.local
+.vscode/*
+!.vscode/launch.json
+!.vscode/*.code-snippets
 
-# vercel
-.vercel
-
-# typescript
-*.tsbuildinfo
-next-env.d.ts
-
-# bun
-bun.lockb
-
-# ide related
 .idea
-/package-lock.json
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Yarn
+.yarn/*
+!.yarn/releases

frontend/.prettierignore

@@ -0,0 +1,37 @@
+**/*.log
+**/.DS_Store
+*.
+.vscode/settings.json
+.history
+.yarn
+bazel-*
+bazel-bin
+bazel-out
+bazel-qwik
+bazel-testlogs
+dist
+dist-dev
+lib
+lib-types
+etc
+external
+node_modules
+temp
+tsc-out
+tsdoc-metadata.json
+target
+output
+rollup.config.js
+build
+.cache
+.vscode
+.rollup.cache
+tsconfig.tsbuildinfo
+vite.config.ts
+*.spec.tsx
+*.spec.ts
+.netlify
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+server

frontend/README.md

@@ -0,0 +1,65 @@
+# Qwik City App ⚡️
+
+- [Qwik Docs](https://qwik.dev/)
+- [Discord](https://qwik.dev/chat)
+- [Qwik GitHub](https://github.com/QwikDev/qwik)
+- [@QwikDev](https://twitter.com/QwikDev)
+- [Vite](https://vitejs.dev/)
+
+---
+
+## Project Structure
+
+This project is using Qwik with [QwikCity](https://qwik.dev/qwikcity/overview/). QwikCity is just an extra set of tools on top of Qwik to make it easier to build a full site, including directory-based routing, layouts, and more.
+
+Inside your project, you'll see the following directory structure:
+
+```
+├── public/
+│   └── ...
+└── src/
+    ├── components/
+    │   └── ...
+    └── routes/
+        └── ...
+```
+
+- `src/routes`: Provides the directory-based routing, which can include a hierarchy of `layout.tsx` layout files, and an `index.tsx` file as the page. Additionally, `index.ts` files are endpoints. Please see the [routing docs](https://qwik.dev/qwikcity/routing/overview/) for more info.
+
+- `src/components`: Recommended directory for components.
+
+- `public`: Any static assets, like images, can be placed in the public directory. Please see the [Vite public directory](https://vitejs.dev/guide/assets.html#the-public-directory) for more info.
+
+## Add Integrations and deployment
+
+Use the `npm run qwik add` command to add additional integrations. Some examples of integrations includes: Cloudflare, Netlify or Express Server, and the [Static Site Generator (SSG)](https://qwik.dev/qwikcity/guides/static-site-generation/).
+
+```shell
+npm run qwik add # or `yarn qwik add`
+```
+
+## Development
+
+Development mode uses [Vite's development server](https://vitejs.dev/). The `dev` command will server-side render (SSR) the output during development.
+
+```shell
+npm start # or `yarn start`
+```
+
+> Note: during dev mode, Vite may request a significant number of `.js` files. This does not represent a Qwik production build.
+
+## Preview
+
+The preview command will create a production build of the client modules, a production build of `src/entry.preview.tsx`, and run a local server. The preview server is only for convenience to preview a production build locally and should not be used as a production server.
+
+```shell
+npm run preview # or `yarn preview`
+```
+
+## Production
+
+The production build will generate client and server modules by running both client and server build commands. The build command will use Typescript to run a type check on the source code.
+
+```shell
+npm run build # or `yarn build`
+```

frontend/app/(pages)/about/layout.tsx

@@ -1,21 +0,0 @@
-import React from 'react';
-import { Metadata } from 'next';
-import { SITE_CONFIG } from '@/src/constants';
-
-export const metadata: Metadata = {
-    title: `About - ${ SITE_CONFIG.name }`
-};
-
-function Layout({
-    children
-}: {
-    children: React.ReactNode;
-}) {
-    return (
-        <div className={ 'flex p-7' }>
-            { children }
-        </div>
-    );
-}
-
-export default Layout;

frontend/app/(pages)/about/me/page.tsx

@@ -1,15 +0,0 @@
-import React from 'react';
-import MarkdownRenderer from '@/app/(pages)/public/MarkdownRenderer';
-import { fetchText } from '@/app/fetch';
-
-const Me = async () => {
-    return (
-        <div className={ 'p-5' }>
-            <MarkdownRenderer>
-                { await fetchText('https://raw.githubusercontent.com/lumither/blog-posts/master/about/me.md') }
-            </MarkdownRenderer>
-        </div>
-    );
-};
-
-export default Me;

frontend/app/(pages)/about/page.tsx

@@ -1,58 +0,0 @@
-import { Card } from '@nextui-org/react';
-import React from 'react';
-import { CardBody } from '@nextui-org/card';
-import Link from 'next/link';
-
-const About = () => {
-    return (
-        <div className={ `flex flex-col w-full justify-center align-middle h-dvh` }>
-            <div className={ 'md:relative md:h-[130px] mb-4 md:mb-0' }>
-                <div className={ 'md:relative md:left-[20%] flex flex-col w-fit' }>
-                    <p className={ 'text-pretty text-3xl' }>{ '讷，远道而来的' }<span
-                        className={ 'break-keep underline decoration-sky-400 dark:decoration-sky-700 decoration-4 underline-offset-0' }>旅人</span>
-                    </p>
-                    <p className={ 'text-pretty md:text-2xl mt-1 md:ml-4' }>{ '愿意坐下来听个故事吗...' }</p>
-                    <p className={ 'hidden md:block text-lg md:ml-8' }>{ '一个关于一位' }<span
-                        className={ 'text-gray-700 dark:text-gray-400 text-sm transition-colors' }>{ '█' }</span>{ '追寻' }<span
-                        className={ 'text-gray-700 dark:text-gray-400 text-sm transition-colors' }>{ '█' }</span>{ '，探索' }<span
-                        className={ 'text-gray-700 dark:text-gray-400 text-sm transition-colors' }>{ '█' }</span>{ '的故事' }
-                    </p>
-                </div>
-            </div>
-            <div className={ `flex justify-center w-full h-[60%] md:h-[40%]` }>
-                <div
-                    className={ `flex flex-col md:flex-row w-full md:w-[85%] lg:w-[90%] xl:w-[85%] p-4 gap-x-7 gap-y-5` }>
-                    <Card
-                        isHoverable
-                        className={ 'w-full h-[45%] md:h-full' }
-                        as={ Link }
-                        href={ '/about/me' }
-                        isPressable
-                    >
-                        <CardBody>
-                            <div className={ 'h-full flex flex-col justify-center' }>
-                                <p className={ 'text-center text-3xl h-fit' }>关于我</p>
-                            </div>
-                        </CardBody>
-                    </Card>
-                    <Card
-                        isHoverable
-                        className={ 'w-full h-[45%] md:h-full' }
-                        as={ Link }
-                        href={ '/about/website' }
-                        isPressable
-                    >
-                        <CardBody>
-                            <div className={ 'h-full flex flex-col justify-center' }>
-                                <p className={ 'text-center text-3xl h-fit' }>关于这个网站</p>
-                            </div>
-                        </CardBody>
-                    </Card>
-                </div>
-            </div>
-            <p className={ 'text-center' }>*目前还没想到如何设计这一页，先摸鱼会（笑）</p>
-        </div>
-    );
-};
-
-export default About;

frontend/app/(pages)/about/website/page.tsx

@@ -1,14 +0,0 @@
-import React from 'react';
-import MarkdownRenderer from '@/app/(pages)/public/MarkdownRenderer';
-import { fetchText } from '@/app/fetch';
-
-const Website = async () => {
-    return (
-        <div className={ 'p-5' }>
-            <MarkdownRenderer>
-                { await fetchText('https://raw.githubusercontent.com/lumither/blog-posts/master/about/website.md') }
-            </MarkdownRenderer>
-        </div>
-    );
-};
-export default Website;

frontend/app/(pages)/blog/BlogPostCard.tsx

@@ -1,92 +0,0 @@
-import React from 'react';
-import { Card, CardBody, CardFooter } from '@nextui-org/card';
-import { Chip } from '@nextui-org/react';
-import Image from 'next/image';
-import Link from 'next/link';
-import { MdCalendarMonth, MdNorthEast } from 'react-icons/md';
-
-type Props = {
-    post: JSON
-}
-
-function BlogPostCard({ post }: Props) {
-    let title = (post as any)['title'];
-    let sub_title = (post as any)['sub_title'];
-    // let summary = (post as any)['summary'];
-    let category = (post as any)['category'];
-    let tags = (post as any)['tags'];
-    // let last_update = new Date((post as any)['last_update']);
-    let first_update = new Date((post as any)['first_update']);
-    let post_id = (post as any)['post_id'];
-    let header_img = ((post as any)['header_img'] as string | null);
-
-    return (
-
-        <div className={ `w-full` }>
-            <Card as={ Link } href={ `/blog/post/${ post_id }` }
-                  className={ `group` }
-                  isPressable
-                  isHoverable
-            >
-
-                { header_img && <div className={ `w-full overflow h-80 relative` }>
-                    <Image
-                        alt={ 'cover picture' }
-                        src={ header_img }
-                        className={ `w-full object-cover rounded-b-none z-10` }
-                        loading={ 'eager' }
-                        fill
-                    ></Image>
-                    <Image
-                        alt={ 'cover picture shadow' }
-                        src={ header_img }
-                        loading={ 'eager' }
-                        className={ `w-full object-cover rounded-b-none scale-y-110 blur-2xl` }
-                        fill
-                    ></Image>
-                </div> }
-
-                <CardBody className={ `overflow-visible` }>
-                    <div className={ `flex flex-row justify-between` }>
-                        <div className={ `mx-2 ${ header_img ? '-mt-6' : 'mt-2' }` }>
-                            <Chip className={ `mb-2 z-30 text-lg` } radius={ `sm` } size={ 'lg' } color={ `secondary` }
-                                  variant={ `solid` }>{ category }</Chip>
-                            <p className={ `text-4xl font-bold` }> { title }</p>
-                            <p className={ `text-xl` }> { sub_title }</p>
-                        </div>
-                        <MdNorthEast className={ `mt-1 mr-2` } size={ `40px` } />
-                    </div>
-                </CardBody>
-
-                <CardFooter className={ 'pt-0' }>
-                    <div className={ `flex flex-row flex-wrap justify-between w-full` }>
-                        <div>
-                            <ul className={ `flex flex-row flex-wrap` }>
-                                {
-                                    tags.map((tag: string, key: any) => (
-                                        <li key={ key } className={ `mx-1 mb-1` }>
-                                            <Chip>{ tag }</Chip>
-                                        </li>
-                                    ))
-                                }
-                            </ul>
-                        </div>
-                        <div className={ `flex flex-row place-content-end mb-1 items-center mx-1` }>
-                            <MdCalendarMonth />
-                            <p className={ `text-zinc-500 dark:text-zinc-400 ml-1` }>
-                                { first_update.toLocaleString('default', {
-                                    month: `long`,
-                                    day: `numeric`,
-                                    year: `numeric`
-                                }) }
-                            </p>
-                        </div>
-                    </div>
-                </CardFooter>
-            </Card>
-        </div>
-    );
-
-}
-
-export default BlogPostCard;

frontend/app/(pages)/blog/Error.tsx

@@ -1 +0,0 @@
-// todo: create component

frontend/app/(pages)/blog/Pagination.tsx

@@ -1,37 +0,0 @@
-'use client';
-
-import React from 'react';
-import { Pagination as NextUIPagination } from '@nextui-org/react';
-import { useRouter, useSearchParams } from 'next/navigation';
-import { useScreenSizeTrigger } from '@/app/(pages)/public/screenSizeTrigger';
-
-const Pagination = ({ total }: {
-    total: number,
-}) => {
-    const parsePage = Number(useSearchParams().get('page'));
-    const currPage = parsePage > 0 ? parsePage : 1;
-
-    const router = useRouter();
-
-    const isMobile = useScreenSizeTrigger('md');
-
-    return (
-        <div className={ 'w-full p-4 pt-6 flex justify-center' }>
-            <NextUIPagination
-                initialPage={ currPage }
-                total={ total }
-                siblings={ isMobile ? 0 : 1 }
-                size={ isMobile ? 'sm' : 'md' }
-                showControls
-                showShadow
-                color={ 'default' }
-                variant={ 'light' }
-                onChange={ (page) => {
-                    router.push(`?page=${ page }`, { scroll: false });
-                } }
-            />
-        </div>
-
-    );
-};
-export default Pagination;

frontend/app/(pages)/blog/PostList.tsx

@@ -1,43 +0,0 @@
-'use server';
-
-import React from 'react';
-import { fetchNocturneApi } from '@/app/(pages)/blog/api';
-import BlogPostCard from '@/app/(pages)/blog/BlogPostCard';
-import { Card, CardBody } from '@nextui-org/card';
-
-import * as motion from 'motion/react-client';
-
-const PostList = async ({ page }: { page: number }) => {
-    try {
-        const res = await fetchNocturneApi(`/blog/get_post_list?page=${ page }`);
-        const posts = await res.json();
-        return (
-            // blog list
-            <div className={ 'w-full' }>
-                <ul className={ 'flex flex-col items-center w-full space-y-7' }>
-                    { posts.map((post: JSON, key: number) => (
-                        <li key={ key } className={ 'w-full' }>
-                            <motion.div
-                                initial={ { y: 20, opacity: 0 } }
-                                animate={ { y: 0, opacity: 1 } }
-                                transition={ { ease: 'easeInOut', duration: 0.5, delay: key * .2 + .25 } }
-                            >
-                                <BlogPostCard post={ post } />
-                            </motion.div>
-                        </li>)
-                    ) }
-                </ul>
-
-            </div>
-        );
-    } catch (e: any) {
-        return (
-            // todo:  use Error.tsx
-            <Card className={ `w-full` }>
-                <CardBody>
-                    Fatal: { e.toString() }
-                </CardBody>
-            </Card>);
-    }
-};
-export default PostList;

frontend/app/(pages)/blog/api.ts

@@ -1,21 +0,0 @@
-const LOCAL_ENDPOINT = process.env.API_LOCAL_URL;
-const REMOTE_ENDPOINT = process.env.API_REMOTE_URL;
-
-const NOCTURNE_ENDPOINT = ((isServerSide = true) => {
-    if (process.env.NODE_ENV === 'production') {
-        if (isServerSide) {
-            return LOCAL_ENDPOINT;
-        } else {
-            return REMOTE_ENDPOINT;
-        }
-    } else {
-        return LOCAL_ENDPOINT;
-    }
-});
-
-export async function fetchNocturneApi(path: string, isServerSideRequest = true) {
-    return await fetch(`${ NOCTURNE_ENDPOINT(isServerSideRequest) }${ path }`, {
-        cache: 'no-cache'
-    });
-}
-

frontend/app/(pages)/blog/layout.tsx

@@ -1,23 +0,0 @@
-import React from 'react';
-import { Metadata } from 'next';
-import { SITE_CONFIG } from '@/src/constants';
-
-export const metadata: Metadata = {
-    title: `Blog - ${ SITE_CONFIG.name }`
-};
-
-function Layout({
-    children
-}: {
-    children: React.ReactNode;
-}) {
-    return (
-        <div className={ 'flex flex-auto p-7 pl-2 lg:pl-7 w-full justify-center' }>
-            <main className={ 'w-full' }>
-                { children }
-            </main>
-        </div>
-    );
-}
-
-export default Layout;

frontend/app/(pages)/blog/page.tsx

@@ -1,24 +0,0 @@
-import PostList from '@/app/(pages)/blog/PostList';
-import Pagination from '@/app/(pages)/blog/Pagination';
-import { fetchNocturneApi } from '@/app/(pages)/blog/api';
-
-async function Blog({
-    searchParams
-}: {
-    searchParams: Promise<{ [key: string]: string | string[] | undefined }>
-}) {
-
-    const parsePage = Number((await searchParams)?.page);
-    const currPage = parsePage > 0 ? parsePage : 1;
-    const ret = await fetchNocturneApi(`/blog/get_page_count`);
-    const pageCount = (await ret.json() as any)['res'] as number;
-
-    return (
-        <div className={ 'w-full min-w-full space-y-4' }>
-            <PostList page={ currPage } />
-            <Pagination total={ pageCount } />
-        </div>
-    );
-}
-
-export default Blog;

frontend/app/(pages)/blog/post/[id]/ButtonGoBack.tsx

@@ -1,21 +0,0 @@
-'use client';
-
-import React from 'react';
-import { useRouter } from 'next/navigation';
-import { Button } from '@nextui-org/react';
-import { IoArrowBackOutline } from 'react-icons/io5';
-
-const ButtonGoBack = () => {
-    const router = useRouter();
-
-    return (
-        <Button
-            startContent={ <IoArrowBackOutline /> }
-            variant={ 'light' }
-            onClick={ () => router.back() }
-        >
-            { 'Back' }
-        </Button>
-    );
-};
-export default ButtonGoBack;

frontend/app/(pages)/blog/post/[id]/Footer.tsx

@@ -1,104 +0,0 @@
-import React from 'react';
-import MinifyPostCard from '@/app/(pages)/blog/post/[id]/MinifyPostCard';
-import Link from 'next/link';
-import { FaCreativeCommons } from 'react-icons/fa6';
-
-type Props = {
-    // post: any
-    post_id: string;
-    adjacent_posts: any
-    perm_link: string | undefined;
-    author: string | undefined;
-    author_link: string | undefined;
-    first_update: string;
-    last_update: string | undefined;
-    cc: string | undefined;
-    title: string;
-}
-
-const Footer = (props: Props) => {
-    const { adjacent_posts, perm_link, post_id, first_update, last_update, title } = props;
-
-    const prev_post = adjacent_posts.prev;
-    const next_post = adjacent_posts.next;
-    const link = perm_link ?? `https://lumither.com/blog/post/${ post_id }`;
-    const author = props.author ?? 'Tao';
-    const author_link = props.author_link ?? '/about/me';
-    const post_date = new Date(first_update);
-    const update_date: Date | undefined = last_update ? new Date(last_update) : undefined;
-    const cc = props.cc ?? 'by-nc-sa';
-
-
-    return (
-        <div className={ `w-full` }>
-
-            <div className={ 'flex transition bg-zinc-300/80 dark:bg-gray-600/25' }>
-                <div className={ `p-8 w-full overflow-hidden` }>
-                    <div className={ 'relative' }>
-                        <FaCreativeCommons
-                            size={ '160px' }
-                            className={ 'absolute right-0 top-0 -mt-[4.8rem] -mr-16 opacity-30 brightness-50  ' }
-                        />
-                    </div>
-
-                    <div className={ 'flex flex-col space-y-4 relative' }>
-                        <div className={ 'z-[2]' }>
-                            <p className={ 'text-xl font-bold' }>{ title }</p>
-                            <Link href={ link }>
-                                <p className={ 'text-sm underline decoration-indigo-500 dark:decoration-sky-500' }>{ link }</p>
-                            </Link>
-                        </div>
-                        <div className={ 'z-[2] flex flex-row flex-wrap gap-x-7 gap-y-2' }>
-                            <div>
-                                <p className={ 'text-lg font-bold' }>Author</p>
-                                <Link href={ author_link }>
-                                    <p className={ 'underline decoration-indigo-500 dark:decoration-sky-500' }>{ author }</p>
-                                </Link>
-                            </div>
-                            <div>
-                                <p className={ 'text-lg font-bold' }>Posted on</p>
-                                <p>{ post_date.toLocaleString('default', {
-                                    month: `long`,
-                                    day: `numeric`,
-                                    year: `numeric`
-                                }) }</p>
-                            </div>
-                            { update_date &&
-                                <div>
-                                    <p className={ 'text-lg font-bold' }>Updated on</p>
-                                    <p>{ update_date.toLocaleString('default', {
-                                        month: `long`,
-                                        day: `numeric`,
-                                        year: `numeric`
-                                    }) }</p>
-                                </div>
-                            }
-                            <div>
-                                <p className={ 'text-lg font-bold' }>Published under</p>
-                                <Link href={ `https://creativecommons.org/licenses/${ cc }/4.0/` }>
-                                    <p className={ 'underline decoration-indigo-500 dark:decoration-sky-500' }>{ `CC ${ cc.toUpperCase() } 4.0` }</p>
-                                </Link>
-                            </div>
-                        </div>
-                    </div>
-                </div>
-            </div>
-
-            <div className={ `flex justify-center` }>
-                <div className={ `w-full shadow-2xl ` }>
-                    <div className={ `flex flex-col md:flex-row w-full` }>
-                        {
-                            next_post &&
-                            <MinifyPostCard post={ next_post } desc={ 'prev' }></MinifyPostCard>
-                        }
-                        {
-                            prev_post &&
-                            <MinifyPostCard post={ prev_post } desc={ 'next' }></MinifyPostCard>
-                        }
-                    </div>
-                </div>
-            </div>
-        </div>
-    );
-};
-export default Footer;

frontend/app/(pages)/blog/post/[id]/Headers.tsx

@@ -1,80 +0,0 @@
-import React from 'react';
-import Image from 'next/image';
-import { Chip } from '@nextui-org/react';
-import { MdCalendarMonth } from 'react-icons/md';
-
-// type Props = {
-//     post: any
-// };
-
-type Props = {
-    title: string;
-    subtitle: string;
-    summary: string | undefined;
-    category: string;
-    tags: string[];
-    first_update: string;
-    header_img: string | undefined;
-}
-
-
-const Headers = (post: Props) => {
-
-    return (
-        <>
-            { post.header_img && <div className={ `w-full overflow h-96 relative` }>
-                <Image
-                    alt={ 'cover picture' }
-                    src={ post.header_img }
-                    className={ `w-full object-cover rounded-b-none z-[5]` }
-                    fill
-                ></Image>
-                <Image
-                    alt={ 'cover picture' }
-                    src={ post.header_img }
-                    className={ `w-full relative scale-110 blur-3xl object-cover rounded-b-none` }
-                    fill
-                ></Image>
-            </div> }
-
-            <div
-                className={ post.header_img ?
-                    'mx-8 -mt-16 backdrop-blur transition bg-zinc-300/80 dark:bg-gray-600/25 rounded-2xl z-30'
-                    : 'mx-6 mt-6'
-                }>
-                <div className={ post.header_img ? `p-4` : 'p-4 pt-2' }>
-                    <Chip className={ `mb-2` } radius={ `sm` } color={ `secondary` }
-                          variant={ `solid` }>{ post.category }</Chip>
-                    <p className={ `text-4xl font-bold` }> { post.title }</p>
-                    <p className={ `text-xl` }> { post.subtitle }</p>
-                </div>
-
-                <div className={ `mx-2 -mt-2 mb-2 flex flex-row flex-wrap justify-between w-full` }>
-                    <div>
-                        <ul className={ `flex flex-row flex-wrap` }>
-                            {
-                                post.tags.map((tag: string, key: any) => (
-                                    <li key={ key } className={ `mx-1 mb-1` }>
-                                        <Chip>{ tag }</Chip>
-                                    </li>
-                                ))
-                            }
-                        </ul>
-                    </div>
-                    <div className={ `flex flex-row place-content-end mb-1 mr-6 items-center mx-1` }>
-                        <MdCalendarMonth />
-                        <p className={ `text-zinc-500 dark:text-zinc-400 ml-1` }>
-                            { (new Date(post.first_update)).toLocaleString('default', {
-                                month: `long`,
-                                day: `numeric`,
-                                year: `numeric`
-                            }) }
-                        </p>
-                    </div>
-                </div>
-            </div>
-
-        </>
-    );
-};
-export default Headers;

frontend/app/(pages)/blog/post/[id]/MinifyPostCard.tsx

@@ -1,58 +0,0 @@
-import React from 'react';
-import { Card, CardFooter, CardHeader } from '@nextui-org/card';
-import Image from 'next/image';
-import Link from 'next/link';
-
-type Props = {
-    post: any
-    desc: string
-}
-
-const MinifyPostCard = (props: Props) => {
-    const { post, desc } = props;
-    const img_url = post['header_img'] as string;
-    return (
-        <div className={ 'w-full transition hover:brightness-75' }>
-            <Card isFooterBlurred
-                  className="w-full h-[300px] shadow-none border-0 rounded-none overflow-hidden"
-                  as={ Link }
-                  isPressable
-                  href={ `/blog/post/${ post['id'] }` }
-            >
-                <CardHeader className="absolute z-10 top-1 flex-col items-start">
-                    <p className={ `text-tiny uppercase font-bold ${ img_url ? 'text-white/60' : 'text-black/60 dark:text-white/60' }` }>{ desc }</p>
-                </CardHeader>
-                { img_url &&
-                    <div className={ 'h-full' }>
-                        <div className={ 'relative h-[300px] overflow-hidden' }>
-                            <Image
-                                className={ 'object-cover object-center ' }
-                                src={ img_url }
-                                alt={ post.title }
-                                fill
-                            />
-                        </div>
-                        <CardFooter
-                            className="absolute transition-colors bg-zinc-300/80 dark:bg-gray-600/25 dark:backdrop-brightness-75 bottom-0  justify-between rounded-none">
-                            <div>
-                                <p className="text-2xl font-bold">{ post['title'] }</p>
-                                <p className="">{ post['sub_title'] }</p>
-                            </div>
-                        </CardFooter>
-                    </div>
-                }
-                { !img_url &&
-                    <div className={ 'h-full grid p-6 place-content-center' }>
-                        <div className={ 'flex flex-col max-h-fit text-left' }>
-                            <p className={ 'text-3xl font-bold text-balance' }>{ post['title'] }</p>
-                            <div className={ 'w-1/4 h-[2px] my-2 bg-zinc-500 dark:bg-zinc-400' }></div>
-                            <p className={ 'text-xl text-pretty break-words' }>{ post['sub_title'] }</p>
-                        </div>
-                    </div>
-                }
-            </Card>
-
-        </div>
-    );
-};
-export default MinifyPostCard;

frontend/app/(pages)/blog/post/[id]/PostCard.tsx

@@ -1,55 +0,0 @@
-import React from 'react';
-import { Card, CardBody } from '@nextui-org/card';
-import Headers from '@/app/(pages)/blog/post/[id]/Headers';
-import Footer from '@/app/(pages)/blog/post/[id]/Footer';
-import MarkdownRenderer from '@/app/(pages)/public/MarkdownRenderer';
-
-type Props = {
-    post: any
-}
-
-async function PostCard(props: Props) {
-    let post = props.post;
-    return (
-        <div>
-            <Card className={ `max-w-full relative` }>
-
-                {/* card headers */ }
-                <Headers title={ post.title }
-                         subtitle={ post.sub_title }
-                         summary={ post.summary }
-                         category={ post.category }
-                         tags={ post.tags }
-                         first_update={ post.first_update }
-                         header_img={ post.meta.header_img }
-                />
-
-                {/* card body */ }
-                <CardBody>
-                    <div className={ 'p-5' }>
-                        <MarkdownRenderer>
-                            { post.content }
-                        </MarkdownRenderer>
-                    </div>
-                </CardBody>
-
-
-                {/* card footer */ }
-                <Footer
-                    adjacent_posts={ post.adj }
-                    perm_link={ post.meta.link }
-                    author={ post.meta.author }
-                    author_link={ post.meta.author_link }
-                    first_update={ post.first_update }
-                    last_update={ post.last_update }
-                    cc={ post.meta.cc }
-                    post_id={ post.meta.id }
-                    title={ post.title }
-                />
-
-            </Card>
-        </div>
-    );
-}
-
-export default PostCard;

frontend/app/(pages)/blog/post/[id]/page.tsx

@@ -1,70 +0,0 @@
-import React, { cache } from 'react';
-import PostCard from '@/app/(pages)/blog/post/[id]/PostCard';
-import ButtonGoBack from '@/app/(pages)/blog/post/[id]/ButtonGoBack';
-import * as motion from 'motion/react-client';
-import { fetchNocturneApi } from '@/app/(pages)/blog/api';
-import { Metadata } from 'next';
-import { SITE_CONFIG } from '@/src/constants';
-
-const fetchPost = cache(async (id: string) => {
-    const res = await fetchNocturneApi(`/blog/get_post/${ id }`);
-    // throw Error('Not Found');
-    return await res.json();
-});
-
-export async function generateMetadata(
-    { params }: { params: Promise<{ id: string }> })
-    : Promise<Metadata> {
-    try {
-        const title = (await fetchPost((await params).id)).title as string;
-        return {
-            title: `${ title } - ${ SITE_CONFIG.name }`
-        };
-    } catch (e) {
-        return {
-            title: 'Unexpected Error'
-        };
-    }
-}
-
-async function BlogReader({
-    params
-}: {
-    params: Promise<{ id: string }>
-}) {
-    try {
-        let post = await fetchPost((await params).id);
-
-        return (
-            <motion.div
-                className={ `max-w-full` }
-                initial={ { y: 20, opacity: 0 } }
-                animate={ { y: 0, opacity: 1 } }
-                transition={ { ease: 'easeInOut', duration: 0.5 } }
-            >
-                <div className={ `max-w-full` }>
-                    <PostCard post={ post } />
-                </div>
-                <div className={ 'mt-3' }>
-                    <ButtonGoBack />
-                </div>
-            </motion.div>
-        );
-    } catch (e: any) {
-        return (
-            <div className={ `flex h-full w-full justify-center items-center` }>
-                <div className={ `flex-row` }>
-                    <p className={ `text-xl font-bold` }>
-                        { 'Unexpected Error:' }
-                    </p>
-                    <p className={ `font-bold` }>
-                        { e.message }
-                    </p>
-                </div>
-            </div>
-        );
-    }
-
-}
-
-export default BlogReader;

frontend/app/(pages)/friends/layout.tsx

@@ -1,21 +0,0 @@
-import React from 'react';
-import { Metadata } from 'next';
-import { SITE_CONFIG } from '@/src/constants';
-
-export const metadata: Metadata = {
-    title: `Friends - ${ SITE_CONFIG.name }`
-};
-
-function Layout({
-    children
-}: {
-    children: React.ReactNode;
-}) {
-    return (
-        <div className={ 'p-7' }>
-            { children }
-        </div>
-    );
-}
-
-export default Layout;

frontend/app/(pages)/friends/page.tsx

@@ -1,93 +0,0 @@
-import React from 'react';
-import { fetchJson } from '@/app/fetch';
-import { Card, CardBody } from '@nextui-org/react';
-import Image from 'next/image';
-import Link from 'next/link';
-
-export default async function Friends() {
-
-    const list = await fetchJson('https://raw.githubusercontent.com/Lumither/friends/master/friends.json');
-    const listLength = list.length;
-    const listMaxIdx = listLength - 1;
-    const listIsOdd = listLength % 2 !== 0;
-
-    return (
-        <div>
-            <div className={ `min-h-dvh pb-10` }>
-                <div className={ 'p-7 pt-[10%] md:pt-[20%]' }>
-                    <div className={ 'flex flex-col md:flex-row gap-x-3 justify-center' }>
-                        <p className={ 'text-3xl text-center text-balance' }>海内存知己</p>
-                        <p className={ 'text-3xl text-center text-balance' }>天涯若比邻</p>
-                    </div>
-                    <p className={ 'text-center text-balance text-zinc-500 dark:text-zinc-400' }>{ 'Though far apart, kin at heart' }</p>
-                </div>
-                <div className={ 'flex w-full h-full justify-center pt-3' }>
-                    <ul className={ 'grid grid-cols-2 gap-x-6 gap-y-3 md:max-w-[90%] xl:max-w-[85%] w-full' }>
-                        {
-                            list.map((friend: any, key: number) => (
-                                <li
-                                    key={ key }
-                                    className={ (key === listMaxIdx && listIsOdd) ? 'col-span-2 flex justify-center' : 'col-span-2 md:col-span-1' }
-                                >
-                                    <Card
-                                        isHoverable
-                                        isPressable
-                                        shadow={ 'none' }
-                                        as={ Link }
-                                        href={ friend['url'] }
-                                        className={ 'dark:bg-[#282830] w-full md:w-fit max-w-full shadow' }
-                                    >
-                                        <CardBody className={ 'overflow-visible pb-0.5' }>
-                                            <div className={ 'flex flex-row' }>
-                                                <div className={ 'flex p-2' }>
-                                                    <div
-                                                        className={ 'h-[80px] w-[80px] relative rounded-2xl' }>
-                                                        <Image
-                                                            alt="avatar"
-                                                            className="object-cover rounded-2xl z-10"
-                                                            fill
-                                                            unoptimized
-                                                            src={ friend['avatar'] }
-                                                        />
-                                                        <Image
-                                                            alt="avatar"
-                                                            className="relative object-cover rounded-2xl scale-110 blur-3xl"
-                                                            fill
-                                                            unoptimized
-                                                            src={ friend['avatar'] }
-                                                        />
-                                                    </div>
-                                                </div>
-                                                <div className={ 'p-2 flex-col max-w-full' }>
-                                                    <p className={ 'text-xl' }>{ friend['title'] }</p>
-                                                    { (friend['name'] === undefined || friend['name'].isNull) ??
-                                                        <p className={ 'text-zinc-600 dark:text-zinc-400' }>{ `@ ${ friend['name'] }` }</p> }
-                                                    { (friend['desc'] === undefined || friend['desc'].isNull) ??
-                                                        <p className={ 'text-sm text-pretty text-zinc-600 dark:text-zinc-300 mt-1' }>{ friend['desc'] }</p> }
-                                                </div>
-                                            </div>
-                                        </CardBody>
-                                        <div className={ 'h-2 relative w-full' }>
-                                            <Image
-                                                alt="theme bar"
-                                                draggable={ false }
-                                                className="object-cover object-center scale-110 blur-lg"
-                                                fill
-                                                unoptimized
-                                                src={ friend['avatar'] }
-                                            />
-                                        </div>
-                                    </Card>
-                                </li>
-                            ))
-                        }
-                    </ul>
-                </div>
-            </div>
-            <p className={ 'text-center' }>想要成为好伙伴嘛，向<span
-                className={ 'text-blue-800 dark:text-blue-500' }><Link
-                href={ 'https://github.com/Lumither/friends/' }>这里</Link></span>发起PR吧
-            </p>
-        </div>
-    );
-}

frontend/app/(pages)/layout.tsx

@@ -1,30 +0,0 @@
-import React from 'react';
-import Navbar from '@/components/Navbar';
-import Footer from '@/components/Footer';
-
-import * as motion from 'motion/react-client';
-
-function Layout({
-    children
-}: {
-    children: React.ReactNode;
-}) {
-    return (
-        <div>
-            <motion.div
-                initial={ { opacity: 0 } }
-                animate={ { opacity: 1 } }
-                transition={ { ease: 'easeInOut', duration: 0.3, delay: 0.5 } }
-                className={ `justify-center flex flex-row w-full max-w-full` }>
-                <Navbar />
-                <div className={ `flex flex-col flex-1 max-w-[1024px] min-w-0` }>
-                    { children }
-                    <Footer />
-                </div>
-            </motion.div>
-        </div>
-    )
-        ;
-}
-
-export default Layout;

frontend/app/(pages)/public/MarkdownRenderer.tsx

@@ -1,64 +0,0 @@
-import React from 'react';
-import Markdown from 'react-markdown';
-import remarkGfm from 'remark-gfm';
-import remarkToc from 'remark-toc';
-import remarkFrontmatter from 'remark-frontmatter';
-import rehypeRaw from 'rehype-raw';
-import rehypeSanitize from 'rehype-sanitize';
-import { Prism as SyntaxHighlighter } from 'react-syntax-highlighter';
-import { oneDark } from 'react-syntax-highlighter/dist/esm/styles/prism';
-
-const MarkdownRenderer = ({ children }: { children: React.ReactNode }) => {
-    return (
-        <div className={ 'w-full' }>
-            <Markdown
-                className={ `max-w-full text-justify text-pretty prose prose-sm prose-neutral dark:prose-invert
-                 md:prose-md lg:prose-lg prose-code:overflow-x-scroll`
-                }
-                remarkPlugins={ [ remarkGfm, remarkToc, remarkFrontmatter ] }
-                rehypePlugins={ [ rehypeRaw, rehypeSanitize ] }
-                components={ {
-                    pre(props) {
-                        const { node, className, children, ...rest } = props;
-                        if ((children as any)['type'] === 'code') {
-                            const match = /language-(\w+)/.exec((children as any)['props']['className'] || '');
-                            let lang = match ? match[1] : 'text';
-                            return (
-                                <pre className={ `not-prose` }>
-                                    <SyntaxHighlighter
-                                        // @ts-ignore
-                                        style={ oneDark }
-                                        language={ lang }
-                                        showLineNumbers
-                                        // wrapLongLines
-                                        // wrapLines
-                                        classNames={ className }
-                                        PreTag="div"
-                                        { ...rest }
-                                    >
-                                        {
-                                            String((children as any)['props']['children']).replace(/\n$/, '')
-                                        }
-                                    </SyntaxHighlighter>
-                                </pre>
-                            );
-                        } else {
-                            return (
-                                <pre className={ `not-prose` }>
-                                    <code className={ className } { ...props }>
-                                        { children }
-                                    </code>
-                               </pre>
-                            );
-                        }
-                    }
-                } }
-            >
-                {
-                    children as any
-                }
-            </Markdown>
-        </div>
-    );
-};
-export default MarkdownRenderer;

frontend/app/(pages)/public/screenSizeTrigger.ts

@@ -1,35 +0,0 @@
-import { useEffect, useState } from 'react';
-
-const screenSize = new Map<string, number>(
-    [
-        [ 'sm', 640 ],
-        [ 'md', 768 ],
-        [ 'lg', 1024 ],
-        [ 'xl', 1280 ],
-        [ '2xl', 2536 ]
-    ]
-);
-
-export const useScreenSizeTrigger = (size: number | string) => {
-    const criticalSize = (typeof size === 'string') ? (screenSize.get(size) ?? 768) : size;
-
-    const [ isCritical, setIsCritical ] = useState(false);
-    useEffect(() => {
-        const updateMobileWidth = () => {
-            if (window.innerWidth < criticalSize) {
-                setIsCritical(true);
-            } else {
-                setIsCritical(false);
-            }
-        };
-        updateMobileWidth();
-        window.addEventListener('resize', updateMobileWidth);
-        return () => {
-            window.removeEventListener('resize', updateMobileWidth);
-        };
-
-    });
-
-    return isCritical;
-
-};

frontend/app/(pages)/public/type/Result.ts

@@ -1,7 +0,0 @@
-export type Result<T, E> = {
-    ok: true;
-    value: T;
-} | {
-    ok: false;
-    error: E;
-};

frontend/app/(pages)/search/page.tsx

@@ -1,13 +0,0 @@
-import React from 'react';
-import ConstructionPlaceHolder from '@/components/ConstructionPlaceHolder';
-
-const Search = () => {
-    return (
-        <div className={ `h-dvh` }>
-            <ConstructionPlaceHolder />
-        </div>
-
-    );
-};
-
-export default Search;

frontend/app/Activities.tsx

@@ -1,43 +0,0 @@
-import React, { useEffect, useState } from 'react';
-import { Activity } from '@/src/HomePageActivities/activity';
-import { getGhActivities } from '@/src/HomePageActivities/ghActivity';
-import * as motion from 'motion/react-client';
-
-const Activities = () => {
-
-    const [ activities, setActivities ] = useState<Activity[] | null>(null);
-
-    useEffect(() => {
-        getGhActivities().then(data => setActivities(data));
-    }, []);
-
-    if (!activities) {
-        return (
-            <div>
-                <p>loading</p>
-            </div>
-        );
-    } else {
-        return (
-            <div>
-                <ul className={ 'flex flex-col gap-y-3 items-end' }>
-                    { activities.map((activity, key) => (
-                        <motion.div
-                            key={ key }
-                            initial={ { opacity: 0, y: 20 } }
-                            animate={ { opacity: 1, y: 0 } }
-                            transition={ { ease: 'easeInOut', duration: 0.2 } }
-                        >
-                            <li className={ 'backdrop-blur bg-white/75 dark:bg-black/45 rounded-xl w-fit' }>
-                                { activity.toElement() }
-                            </li>
-                        </motion.div>
-                    )) }
-                </ul>
-            </div>
-        );
-    }
-
-};
-
-export default Activities;

frontend/app/entries.tsx

@@ -1,56 +0,0 @@
-import React from 'react';
-import {
-    IoFlask,
-    IoHome,
-    IoInformationCircle,
-    IoLink,
-    IoLogoGithub,
-    IoMail,
-    IoPencil,
-    IoSearch
-} from 'react-icons/io5';
-
-export const entries: { display_name: string; href: string; icon: React.ReactNode }[] = [
-    {
-        icon: <IoHome size={ `20px` }></IoHome>,
-        display_name: 'Home',
-        href: '/'
-    },
-    {
-        icon: <IoInformationCircle size={ `20px` }></IoInformationCircle>,
-        display_name: 'About',
-        href: '/about'
-    },
-    {
-        icon: <IoPencil size={ `20px` }></IoPencil>,
-        display_name: 'Blog',
-        href: '/blog'
-    },
-    {
-        icon: <IoLink size={ `20px` }></IoLink>,
-        display_name: 'Friends',
-        href: '/friends'
-    },
-    {
-        icon: <IoSearch size={ `20px` }></IoSearch>,
-        display_name: 'Search',
-        href: '/search'
-    }, {
-        icon: <IoFlask size={ '20px' } />,
-        display_name: 'Lab',
-        href: 'https://lab.lmt.moe'
-    }
-];
-
-export const connections: { label: string, href: string, icon: React.ReactNode }[] = [
-    {
-        label: 'Github',
-        href: 'https://github.com/Lumither',
-        icon: <IoLogoGithub size={ `30px` } />
-    },
-    {
-        label: 'email',
-        href: 'mailto:lumither@outlook.com',
-        icon: <IoMail size={ `30px` } />
-    }
-];