wanzi/ftb-project-management
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(v2.4): 切换计划与开发任务主写

Browse Source
This commit is contained in:
。
2026-07-08 12:34:33 +08:00
parent 5f5a211c99
commit 1bf630a7bc
21 changed files with 1612 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files

113
apps/web/stores/useDevTaskStore.ts
View File

@@ -3,9 +3,18 @@ import { create } from 'zustand';
import type { DevTask, DevTaskStatus } from '@/lib/dev-task';
import { generateTaskNo, isLegacyTask } from '@/lib/dev-task';
import { applyDevTaskTransition, normalizeDevTaskOnCreate } from '@/lib/dev-task-workflow';
import {
createDevTaskByVersionId,
deleteDevTaskByVersionId,
listDevTasksByVersionId,
setDevTaskBlockedByVersionId,
updateDevTaskByVersionId,
updateDevTaskStatusByVersionId,
} from '@/lib/domain-api';
import { createEntityId, dedupeEntityIds } from '@/lib/entity-id';
import { scheduleSaveWithOptimisticRollback } from '@/lib/optimistic-persistence';
import { loadServerData, saveServerData, SERVER_DATA_CACHE_MS } from '@/lib/server-data';
import type { WorkActivity } from '@/lib/work-activity';
import {
makeDevTaskBlockedActivity,
makeDevTaskCreatedActivity,
@@ -38,7 +47,7 @@ async function loadStored(): Promise<DevTask[] | null> {
interface DevTaskState {
tasks: DevTask[];
loaded: boolean;
fetchTasks: (options?: { force?: boolean }) => Promise<void>;
fetchTasks: (options?: { force?: boolean; versionId?: string }) => Promise<void>;
createTask: (data: Omit<DevTask, 'id' | 'taskNo' | 'createdAt' | 'updatedAt' | 'isBlocked'>) => DevTask;
updateTask: (id: string, data: Partial<DevTask>) => void;
deleteTask: (id: string) => void;
@@ -55,7 +64,9 @@ export const useDevTaskStore = create<DevTaskState>((set, get) => ({
fetchTasks: async (options) => {
if (!options?.force && get().loaded && Date.now() - lastTasksFetchAt < SERVER_DATA_CACHE_MS) return;
const cached = await loadStored();
const cached = options?.versionId
? await listDevTasksByVersionId(options.versionId).catch(loadStored)
: await loadStored();
if (!options?.force && get().loaded && Date.now() - lastTasksFetchAt < SERVER_DATA_CACHE_MS) return;
lastTasksFetchAt = Date.now();
set({ tasks: cached ?? [], loaded: true });
@@ -75,12 +86,24 @@ export const useDevTaskStore = create<DevTaskState>((set, get) => ({
const updated = [...list, task];
set({ tasks: updated, loaded: true });
scheduleSaveWithOptimisticRollback({
save: () => saveServerData('dev-tasks', updated),
save: async () => {
try {
if (!task.versionId) throw new Error('missing versionId');
const result = await createDevTaskByVersionId(task.versionId, task);
set({
tasks: get().tasks.map((item) => (item.id === task.id ? { ...task, ...result.item } : item)),
loaded: true,
});
appendDomainActivities(result.activities);
} catch {
await saveDevTasksFallback(updated);
useWorkActivityStore.getState().addActivity(makeDevTaskCreatedActivity(task, task.createdBy || task.assigneeId));
}
},
expected: updated,
getCurrent: () => get().tasks,
rollback: () => set({ tasks: list, loaded: true }),
});
useWorkActivityStore.getState().addActivity(makeDevTaskCreatedActivity(task, task.createdBy || task.assigneeId));
return task;
},
@@ -91,7 +114,16 @@ export const useDevTaskStore = create<DevTaskState>((set, get) => ({
);
set({ tasks: updated, loaded: true });
scheduleSaveWithOptimisticRollback({
save: () => saveServerData('dev-tasks', updated),
save: async () => {
try {
const versionId = previous.find((task) => task.id === id)?.versionId;
if (!versionId) throw new Error('missing versionId');
const result = await updateDevTaskByVersionId(versionId, id, data);
appendDomainActivities(result.activities);
} catch {
await saveDevTasksFallback(updated);
}
},
expected: updated,
getCurrent: () => get().tasks,
rollback: () => set({ tasks: previous, loaded: true }),
@@ -103,7 +135,15 @@ export const useDevTaskStore = create<DevTaskState>((set, get) => ({
const updated = previous.filter((t) => t.id !== id);
set({ tasks: updated, loaded: true });
scheduleSaveWithOptimisticRollback({
save: () => saveServerData('dev-tasks', updated),
save: async () => {
try {
const versionId = previous.find((task) => task.id === id)?.versionId;
if (!versionId) throw new Error('missing versionId');
await deleteDevTaskByVersionId(versionId, id);
} catch {
await saveDevTasksFallback(updated);
}
},
expected: updated,
getCurrent: () => get().tasks,
rollback: () => set({ tasks: previous, loaded: true }),
@@ -118,24 +158,63 @@ export const useDevTaskStore = create<DevTaskState>((set, get) => ({
delayReason: opts?.delayReason,
});
if (!result.ok || !result.patch) return { ok: false, message: result.message };
get().updateTask(id, result.patch);
const previous = get().tasks;
const updated = previous.map((t) =>
t.id === id ? { ...t, ...result.patch, aiDraft: false, updatedAt: new Date().toISOString() } : t,
);
set({ tasks: updated, loaded: true });
const activity = makeDevTaskStatusActivity(task, task.status, to, task.assigneeId);
if (activity) useWorkActivityStore.getState().addActivity(activity);
scheduleSaveWithOptimisticRollback({
save: async () => {
try {
if (!task.versionId) throw new Error('missing versionId');
const result = await updateDevTaskStatusByVersionId(task.versionId, id, to);
appendDomainActivities(result.activities);
if (result.activities.length === 0 && activity) useWorkActivityStore.getState().addActivity(activity);
} catch {
await saveDevTasksFallback(updated);
if (activity) useWorkActivityStore.getState().addActivity(activity);
}
},
expected: updated,
getCurrent: () => get().tasks,
rollback: () => set({ tasks: previous, loaded: true }),
});
return { ok: true };
},
setBlocked: (id, blocked, reason, blockedById) => {
const task = get().tasks.find((t) => t.id === id);
if (!task) return;
get().updateTask(id, {
const previous = get().tasks;
const patch = {
isBlocked: blocked,
blockReason: blocked ? reason : undefined,
blockedById: blocked ? blockedById : undefined,
});
};
const updated = previous.map((item) =>
item.id === id ? { ...item, ...patch, aiDraft: false, updatedAt: new Date().toISOString() } : item,
);
set({ tasks: updated, loaded: true });
const activity = blocked
? makeDevTaskBlockedActivity(task, task.assigneeId, reason, blockedById)
: makeDevTaskUnblockedActivity(task, task.assigneeId);
useWorkActivityStore.getState().addActivity(activity);
scheduleSaveWithOptimisticRollback({
save: async () => {
try {
if (!task.versionId) throw new Error('missing versionId');
const result = await setDevTaskBlockedByVersionId(task.versionId, id, blocked, reason);
appendDomainActivities(result.activities);
if (result.activities.length === 0) useWorkActivityStore.getState().addActivity(activity);
} catch {
await saveDevTasksFallback(updated);
useWorkActivityStore.getState().addActivity(activity);
}
},
expected: updated,
getCurrent: () => get().tasks,
rollback: () => set({ tasks: previous, loaded: true }),
});
},
getByRequirement: (requirementId) => {
@@ -151,3 +230,15 @@ export const useDevTaskStore = create<DevTaskState>((set, get) => ({
return get().tasks.filter((t) => t.assigneeId === assigneeId);
},
}));
async function saveDevTasksFallback(tasks: DevTask[]) {
await saveServerData('dev-tasks', tasks);
}
function appendDomainActivities(activities: WorkActivity[]) {
if (activities.length === 0) return;
useWorkActivityStore.setState((state) => ({
activities: [...state.activities, ...activities],
loaded: true,
}));
}

80
apps/web/stores/useVersionPlanStore.ts
View File

@@ -1,6 +1,13 @@
'use client';
import { create } from 'zustand';
import type { VersionPlan, PlanType } from '@/lib/version-plan';
import {
completeVersionPlanByVersionId,
createVersionPlanByVersionId,
deleteVersionPlanByVersionId,
listVersionPlansByVersionId,
updateVersionPlanByVersionId,
} from '@/lib/domain-api';
import { scheduleSaveWithOptimisticRollback } from '@/lib/optimistic-persistence';
import { loadServerData, saveServerData, SERVER_DATA_CACHE_MS } from '@/lib/server-data';
import { getPlanCompletionState } from '@/lib/version-plan-workflow';
@@ -13,6 +20,7 @@ import {
makeVersionPlanStartedActivity,
} from '@/lib/work-activity-factory';
import type { WorkActivityDraft } from '@/lib/work-activity';
import type { WorkActivity } from '@/lib/work-activity';
import { useWorkActivityStore } from './useWorkActivityStore';
const MOCK_PLANS: VersionPlan[] = [];
@@ -28,7 +36,7 @@ async function loadStored(): Promise<VersionPlan[] | null> {
interface VersionPlanState {
plans: VersionPlan[];
loaded: boolean;
fetchPlans: (options?: { force?: boolean }) => Promise<void>;
fetchPlans: (options?: { force?: boolean; versionId?: string }) => Promise<void>;
createPlan: (data: Omit<VersionPlan, 'id' | 'createdAt'>) => void;
updatePlan: (id: string, data: Partial<VersionPlan>) => void;
completePlan: (id: string, result: PlanResultPayload) => { ok: boolean; message?: string };
@@ -41,7 +49,9 @@ export const useVersionPlanStore = create<VersionPlanState>((set, get) => ({
fetchPlans: async (options) => {
if (!options?.force && get().loaded && Date.now() - lastPlansFetchAt < SERVER_DATA_CACHE_MS) return;
const cached = await loadStored();
const cached = options?.versionId
? await listVersionPlansByVersionId(options.versionId).catch(loadStored)
: await loadStored();
if (!options?.force && get().loaded && Date.now() - lastPlansFetchAt < SERVER_DATA_CACHE_MS) return;
lastPlansFetchAt = Date.now();
set({ plans: cached ?? MOCK_PLANS, loaded: true });
@@ -53,12 +63,25 @@ export const useVersionPlanStore = create<VersionPlanState>((set, get) => ({
const plans = [...previous, plan];
set({ plans, loaded: true });
scheduleSaveWithOptimisticRollback({
save: () => saveServerData('version-plans', plans),
save: async () => {
try {
const result = await createVersionPlanByVersionId(plan.versionId, plan);
set({
plans: get().plans.map((item) => (
item.id === plan.id ? { ...plan, ...result.item, tasks: plan.tasks } : item
)),
loaded: true,
});
appendDomainActivities(result.activities);
} catch {
await saveVersionPlansFallback(plans);
useWorkActivityStore.getState().addActivity(makeVersionPlanCreatedActivity(plan, plan.addedBy || plan.owner));
}
},
expected: plans,
getCurrent: () => get().plans,
rollback: () => set({ plans: previous, loaded: true }),
});
useWorkActivityStore.getState().addActivity(makeVersionPlanCreatedActivity(plan, plan.addedBy || plan.owner));
},
updatePlan: (id, data) => {
@@ -93,12 +116,24 @@ export const useVersionPlanStore = create<VersionPlanState>((set, get) => ({
});
set({ plans, loaded: true });
scheduleSaveWithOptimisticRollback({
save: () => saveServerData('version-plans', plans),
save: async () => {
try {
const versionId = previous.find((plan) => plan.id === id)?.versionId;
if (!versionId) throw new Error('missing versionId');
const result = await updateVersionPlanByVersionId(versionId, id, data);
appendDomainActivities(result.activities);
if (result.activities.length === 0) {
activities.forEach((activity) => useWorkActivityStore.getState().addActivity(activity));
}
} catch {
await saveVersionPlansFallback(plans);
activities.forEach((activity) => useWorkActivityStore.getState().addActivity(activity));
}
},
expected: plans,
getCurrent: () => get().plans,
rollback: () => set({ plans: previous, loaded: true }),
});
activities.forEach((activity) => useWorkActivityStore.getState().addActivity(activity));
},
completePlan: (id, result) => {
@@ -118,7 +153,16 @@ export const useVersionPlanStore = create<VersionPlanState>((set, get) => ({
});
set({ plans, loaded: true });
scheduleSaveWithOptimisticRollback({
save: () => saveServerData('version-plans', plans),
save: async () => {
try {
const versionId = previous.find((plan) => plan.id === id)?.versionId;
if (!versionId) throw new Error('missing versionId');
const apiResult = await completeVersionPlanByVersionId(versionId, id, result);
appendDomainActivities(apiResult.activities);
} catch {
await saveVersionPlansFallback(plans);
}
},
expected: plans,
getCurrent: () => get().plans,
rollback: () => set({ plans: previous, loaded: true }),
@@ -131,10 +175,30 @@ export const useVersionPlanStore = create<VersionPlanState>((set, get) => ({
const plans = previous.filter((p) => p.id !== id);
set({ plans, loaded: true });
scheduleSaveWithOptimisticRollback({
save: () => saveServerData('version-plans', plans),
save: async () => {
try {
const versionId = previous.find((plan) => plan.id === id)?.versionId;
if (!versionId) throw new Error('missing versionId');
await deleteVersionPlanByVersionId(versionId, id);
} catch {
await saveVersionPlansFallback(plans);
}
},
expected: plans,
getCurrent: () => get().plans,
rollback: () => set({ plans: previous, loaded: true }),
});
},
}));
async function saveVersionPlansFallback(plans: VersionPlan[]) {
await saveServerData('version-plans', plans);
}
function appendDomainActivities(activities: WorkActivity[]) {
if (activities.length === 0) return;
useWorkActivityStore.setState((state) => ({
activities: [...state.activities, ...activities],
loaded: true,
}));
}