Rebuild guidance wiki as a unified SaaS workspace

This commit is contained in:
2026-10-29 20:26:24 +08:00
parent f490543853
commit 0d8aacb9a2
25 changed files with 5778 additions and 208 deletions
+54 -14
View File
@@ -1,15 +1,55 @@
import { db,transaction } from './db';
import { documentInput } from './guidance-input';
import { findGuide,type Guidance } from '../content/guides/catalog';
export async function resolveDocument(id:string,revision?:number):Promise<Guidance|null>{
if(!id.startsWith('user-'))return findGuide(id,revision)||null;
const r=await db().query(`SELECT r.content FROM guidance_documents d JOIN guidance_revisions r ON r.document_id=d.id AND r.revision=COALESCE($2,d.latest) WHERE d.id=$1 AND ($2::integer IS NOT NULL OR d.deleted_at IS NULL)`,[id,revision??null]);return r.rows[0]?.content||null;
import { db, transaction } from "./db";
import { documentInput } from "./guidance-input";
import { findGuide, type Guidance } from "../content/guides/catalog";
export async function resolveDocument(
id: string,
revision?: number,
): Promise<Guidance | null> {
if (!id.startsWith("user-")) return findGuide(id, revision) || null;
const r = await db().query(
`SELECT r.content FROM guidance_documents d JOIN guidance_revisions r ON r.document_id=d.id AND r.revision=COALESCE($2,d.latest) WHERE d.id=$1 AND ($2::integer IS NOT NULL OR d.deleted_at IS NULL)`,
[id, revision ?? null],
);
return r.rows[0]?.content || null;
}
export async function publishDocument(owner: string, value: unknown) {
const content = documentInput.parse(value);
if (!content.id.startsWith("user-" + owner + "-")) throw Error("INVALID_ID");
return transaction(async (c) => {
await c.query(
"INSERT INTO guidance_documents(id,owner_id) VALUES($1,$2) ON CONFLICT DO NOTHING",
[content.id, owner],
);
const d = (
await c.query("SELECT * FROM guidance_documents WHERE id=$1 FOR UPDATE", [
content.id,
])
).rows[0];
if (d.owner_id !== owner) throw Error("FORBIDDEN");
if (d.deleted_at || content.revision !== d.latest + 1)
throw Error("CONFLICT");
await c.query(
"INSERT INTO guidance_revisions(document_id,revision,content) VALUES($1,$2,$3)",
[content.id, content.revision, content],
);
await c.query("UPDATE guidance_documents SET latest=$2 WHERE id=$1", [
content.id,
content.revision,
]);
return content;
});
}
export async function withdrawDocument(owner: string, id: string) {
const r = await db().query(
"UPDATE guidance_documents SET deleted_at=COALESCE(deleted_at,now()) WHERE id=$1 AND owner_id=$2 RETURNING id",
[id, owner],
);
return !!r.rowCount;
}
export async function discoverDocuments(author?: string) {
const r = await db().query(
`SELECT d.id,d.latest AS revision,r.content->>'title' AS title,r.content->>'summary' AS summary,r.content->>'kind' AS kind,d.owner_id AS author FROM guidance_documents d JOIN guidance_revisions r ON r.document_id=d.id AND r.revision=d.latest WHERE d.deleted_at IS NULL AND ($1::uuid IS NULL OR d.owner_id=$1::uuid) ORDER BY r.created_at DESC LIMIT 100`,
[author ?? null],
);
return r.rows;
}
export async function publishDocument(owner:string,value:unknown){const content=documentInput.parse(value);if(!content.id.startsWith('user-'+owner+'-'))throw Error('INVALID_ID');return transaction(async c=>{
await c.query('INSERT INTO guidance_documents(id,owner_id) VALUES($1,$2) ON CONFLICT DO NOTHING',[content.id,owner]);
const d=(await c.query('SELECT * FROM guidance_documents WHERE id=$1 FOR UPDATE',[content.id])).rows[0];
if(d.owner_id!==owner)throw Error('FORBIDDEN');if(d.deleted_at||content.revision!==d.latest+1)throw Error('CONFLICT');
await c.query('INSERT INTO guidance_revisions(document_id,revision,content) VALUES($1,$2,$3)',[content.id,content.revision,content]);await c.query('UPDATE guidance_documents SET latest=$2 WHERE id=$1',[content.id,content.revision]);return content;
});}
export async function withdrawDocument(owner:string,id:string){const r=await db().query('UPDATE guidance_documents SET deleted_at=COALESCE(deleted_at,now()) WHERE id=$1 AND owner_id=$2 RETURNING id',[id,owner]);return !!r.rowCount;}
export async function discoverDocuments(){const r=await db().query(`SELECT d.id,d.latest AS revision,r.content->>'title' AS title,r.content->>'summary' AS summary,r.content->>'kind' AS kind,d.owner_id AS author FROM guidance_documents d JOIN guidance_revisions r ON r.document_id=d.id AND r.revision=d.latest WHERE d.deleted_at IS NULL ORDER BY r.created_at DESC LIMIT 100`);return r.rows;}