HaHafeng
1b53ab9d52
Major Changes: - Add StreamingService with OpenAI Compatible format - Upgrade Chat component V2 with Ant Design X integration - Implement AIA module with 12 intelligent agents - Update API routes to unified /api/v1 prefix - Update system documentation Backend (~1300 lines): - common/streaming: OpenAI Compatible adapter - modules/aia: 12 agents, conversation service, streaming integration - Update route versions (RVW, PKB to v1) Frontend (~3500 lines): - modules/aia: AgentHub + ChatWorkspace (100% prototype restoration) - shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook - Update API endpoints to v1 Documentation: - AIA module status guide - Universal capabilities catalog - System overview updates - All module documentation sync Tested: Stream response verified, authentication working Status: AIA V2.0 core completed (85%)
621 lines
16 KiB
Markdown
621 lines
16 KiB
Markdown
# Postgres-Only 蠑よｭ･莉ｻ蜉｡螟<EFBDA1>炊謖<E7828A>漉
|
||
|
||
> **譁<>｡｣迚域悽<E59F9F>?* v1.0
|
||
> **蛻帛ｻｺ譌･譛滂ｼ?* 2025-12-22
|
||
> **扈ｴ謚､閠<EFBDA4>ｼ<EFBFBD>** 蟷ｳ蜿ｰ譫ｶ譫<EFBDB6>屬髦<E5B1AC>
|
||
> **騾ら畑蝨ｺ譎ｯ<E8AD8E>?* 髟ｿ譌ｶ髣ｴ莉ｻ蜉｡<E89C89><EFBDA1>>30遘抵ｼ峨∝､ｧ譁<EFBDA7>ｻｶ螟<EFBDB6>炊縲∝錘蜿ｰWorker
|
||
> **蜿り<E3828A>ｮ樒鴫<E6A892><E9B4AB>** DC Tool C Excel隗｣譫舌、SL譁<4C>鍵遲幃峨．C Tool B謨ｰ謐ｮ謠仙叙
|
||
|
||
---
|
||
|
||
## <20>搭 讎りｿｰ
|
||
|
||
譛ｬ譁<EFBFBD>｡｣蝓ｺ莠?**DC Tool C Excel隗｣譫仙粥閭ｽ** 逧<>ｮ梧紛螳櫁ｷｵ<EFBDB7>梧ｻ扈<EFBDBB> Postgres-Only 譫ｶ譫<EFBDB6>ｸ句ｼよｭ･莉ｻ蜉｡螟<EFBDA1>炊逧<E7828A><E980A7><EFBFBD>㊥讓｡蠑上?
|
||
|
||
### 譬ｸ蠢<EFBDB8>ｻｷ蛟?
|
||
|
||
1. 笨?**驕ｿ蜈工TTP雜<50>慮**<2A>壻ｸ贋ｼ<E8B48B>謗･蜿?遘定ｿ泌屓<E6B38C>瑚ｧ｣譫仙惠蜷主床螳梧<E89EB3><E6A2A7><EFBFBD>30-60遘抵ｼ<E68AB5>
|
||
2. 笨?**逕ｨ謌ｷ菴馴ｪ御ｼ倡ｧ**<2A>壼ｮ樊慮霑帛ｺｦ蜿埼ｦ茨ｼ御ｸ埼怙隕∝そ遲?
|
||
3. 笨?**隨ｦ蜷井ｺ大次逕溯ｧ<E6BAAF><EFBDA7>?*<2A>啀latform-Only讓｡蠑擾ｼ継g-boss髦溷<E9ABA6>
|
||
4. 笨?**諤ｧ閭ｽ莨伜喧**<2A>喞lean data郛灘ｭ假ｼ碁∩蜈埼㍾螟崎ｮ｡邂暦ｼ<E69AA6>-99%閠玲慮<E78EB2>?
|
||
|
||
---
|
||
|
||
## <20>女<EFBFBD>?譫ｶ譫<EFBDB6>ｮｾ隶｡
|
||
|
||
### 荳牙ｱよ楔譫<E6A594>
|
||
|
||
```
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 蜑咲ｫｯ螻ゑｼ<E38291>eact + React Query<72>? 笏?
|
||
笏? - 荳贋ｼ<E8B48B>譁<EFBFBD>ｻｶ<EFBDBB>育ｫ句叉霑泌<E99C91>?sessionId + jobId<49>? 笏?
|
||
笏? - 霓ｮ隸｢迥ｶ諤<EFBDB6>ｼ<EFBFBD>seQuery + refetchInterval<61>瑚<EFBFBD>蜉ｨ荳ｲ陦鯉ｼ<E9AF89> 笏?
|
||
笏? - 逶大成 status='ready'<27>悟刈霓ｽ謨ｰ謐? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?HTTP
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 蜷守ｫｯ螻ゑｼ<E38291>astify + Prisma<6D>? 笏?
|
||
笏? - 蠢ｫ騾滉ｸ贋ｼ<E8B48B>蛻ｰ OSS<53>?-3遘抵ｼ<E68AB5> 笏?
|
||
笏? - 蛻帛ｻｺ Session<6F>育憾諤<E686BE>ｼ嗔rocessing<6E>? 笏?
|
||
笏? - 謗ｨ騾∽ｻｻ蜉｡蛻ｰ pg-boss<73>育ｫ句叉霑泌屓<E6B38C><E5B193> 笏?
|
||
笏? - 謠蝉ｾ帷憾諤∵衍隸?API 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?pg-boss
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? Worker螻ゑｼ<E38291>g-boss + Platform螻ゑｼ<E38291> 笏?
|
||
笏? - 莉朱弌蛻怜叙莉ｻ蜉｡<E89C89>郁<EFBFBD>蜉ｨ荳ｲ陦鯉ｼ<E9AF89> 笏?
|
||
笏? - 謇ｧ陦瑚玲慮謫堺ｽ懶ｼ郁ｧ｣譫舌∵ｸ<E288B5>ｴ励∫ｻ溯ｮ｡<EFBDAE><EFBDA1> 笏?
|
||
笏? - 菫晏ｭ倡ｻ捺棡<E68DBA><E6A3A1>lean data 蛻?OSS<53>? 笏?
|
||
笏? - 譖ｴ譁ｰ Session<6F>亥｡ｫ蜈<EFBDAB><E89C88>謨ｰ謐ｮ<E8AC90>? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
```
|
||
|
||
---
|
||
|
||
## <20>噫 螳梧紛螳樊命豁･鬪､
|
||
|
||
### 豁･鬪､1<EFBDA4>壽焚謐ｮ蠎鉄chema隶ｾ隶｡
|
||
|
||
```prisma
|
||
// 荳壼苅陦ｨ蜿ｪ蟄倅ｸ壼苅菫｡諱ｯ<E8ABB1>御ｸ榊ｭ倅ｻｻ蜉｡邂｡逅<EFBDA1>ｿ｡諱ｯ
|
||
model YourBusinessTable {
|
||
id String @id
|
||
userId String
|
||
fileKey String // OSS蜴溷ｧ区枚莉ｶ
|
||
|
||
// 笨?諤ｧ閭ｽ莨伜喧<E4BC9C>壻ｿ晏ｭ伜､<E4BC9C>炊扈捺<E68988>?
|
||
cleanDataKey String? // 貂<>ｴ<EFBFBD>/螟<>炊蜷守噪謨ｰ謐ｮ<E8AC90>磯∩蜈埼㍾螟崎ｮ｡邂暦ｼ<E69AA6>
|
||
|
||
// 謨ｰ謐ｮ蜈<EFBDAE>ｿ｡諱ｯ<E8ABB1>亥ｼよｭ･蝪ｫ蜈<EFBDAB>ｼ?
|
||
totalRows Int?
|
||
totalCols Int?
|
||
columns Json?
|
||
|
||
// 譌ｶ髣ｴ謌?
|
||
createdAt DateTime
|
||
updatedAt DateTime
|
||
expiresAt DateTime
|
||
|
||
@@schema("your_schema")
|
||
}
|
||
```
|
||
|
||
**蜈ｳ髞ｮ轤?*<2A>?
|
||
- 笶?荳崎ｦ∵ｷｻ蜉<EFBDBB> `status`縲～progress`縲～errorMessage` 遲我ｻｻ蜉｡邂｡逅<EFBDA1>ｭ玲ｮ?
|
||
- 笨?霑吩ｺ帛ｭ玲ｮｵ逕?pg-boss 逧?`job` 陦ｨ邂｡逅?
|
||
|
||
---
|
||
|
||
### 豁･鬪､2<EFBDA4>售ervice螻?- 蠢ｫ騾滉ｸ贋ｼ?謗ｨ騾∽ｻｻ蜉?
|
||
|
||
```typescript
|
||
// backend/src/modules/your-module/services/YourService.ts
|
||
|
||
import { storage } from '@/common/storage';
|
||
import { jobQueue } from '@/common/jobs';
|
||
import { prisma } from '@/config/database';
|
||
|
||
export class YourService {
|
||
/**
|
||
* 蛻帛ｻｺ莉ｻ蜉｡蟷ｶ謗ｨ騾∝芦髦溷<E9ABA6><E6BAB7><EFBFBD>ostgres-Only譫ｶ譫<EFBDB6>ｼ?
|
||
*
|
||
* 笨?Platform-Only 讓｡蠑擾ｼ?
|
||
* - 遶句叉荳贋ｼ<E8B48B>譁<EFBFBD>ｻｶ蛻?OSS
|
||
* - 蛻帛ｻｺ荳壼苅隶ｰ蠖包ｼ亥<EFBDBC>謨ｰ謐ｮ荳ｺnull<6C>?
|
||
* - 謗ｨ騾∽ｻｻ蜉｡蛻ｰ髦溷<E9ABA6>
|
||
* - 遶句叉霑泌屓<E6B38C>井ｸ埼仆蝪櫁ｯｷ豎ゑｼ?
|
||
*/
|
||
async createTask(userId: string, fileName: string, fileBuffer: Buffer) {
|
||
// 1. 鬪瑚ｯ∵枚莉ｶ
|
||
if (fileBuffer.length > MAX_FILE_SIZE) {
|
||
throw new Error('譁<>ｻｶ螟ｪ螟ｧ');
|
||
}
|
||
|
||
// 2. 笞?遶句叉荳贋ｼ<E8B48B>蛻?OSS<53>?-3遘抵ｼ<E68AB5>
|
||
const fileKey = `path/${userId}/${Date.now()}-${fileName}`;
|
||
await storage.upload(fileKey, fileBuffer);
|
||
|
||
// 3. 笞?蛻帛ｻｺ荳壼苅隶ｰ蠖包ｼ亥<EFBDBC>謨ｰ謐ｮ荳ｺnull<6C>檎ｭ姥orker蝪ｫ蜈<EFBDAB>ｼ?
|
||
const record = await prisma.yourTable.create({
|
||
data: {
|
||
userId,
|
||
fileName,
|
||
fileKey,
|
||
// 笞<><E7AC9E><EFBFBD> 螟<>炊扈捺棡蟄玲ｮｵ荳?null
|
||
totalRows: null,
|
||
columns: null,
|
||
expiresAt: new Date(Date.now() + 10 * 60 * 1000),
|
||
},
|
||
});
|
||
|
||
// 4. 笞?謗ｨ騾∽ｻｻ蜉｡蛻ｰ pg-boss<73><73>latform-Only<6C>?
|
||
const job = await jobQueue.push('your_module_process', {
|
||
recordId: record.id,
|
||
fileKey,
|
||
userId,
|
||
});
|
||
|
||
// 5. 笞?遶句叉霑泌屓<E6B38C>域ｻ閠玲慮<3遘抵ｼ<E68AB5>
|
||
return {
|
||
...record,
|
||
jobId: job.id, // 笨?霑泌屓 jobId 萓帛燕遶ｯ霓ｮ隸?
|
||
};
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 豁･鬪､3<EFBDA4>啗orker螻?- 蜷主床螟<E5BA8A>炊
|
||
|
||
```typescript
|
||
// backend/src/modules/your-module/workers/yourWorker.ts
|
||
|
||
import { jobQueue } from '@/common/jobs';
|
||
import { storage } from '@/common/storage';
|
||
import { prisma } from '@/config/database';
|
||
import { logger } from '@/common/logging';
|
||
|
||
interface YourJob {
|
||
recordId: string;
|
||
fileKey: string;
|
||
userId: string;
|
||
}
|
||
|
||
/**
|
||
* 豕ｨ蜀<EFBDA8> Worker 蛻ｰ髦溷<E9ABA6>?
|
||
*/
|
||
export function registerYourWorker() {
|
||
logger.info('[YourWorker] Registering worker');
|
||
|
||
// 笞<><E7AC9E><EFBFBD> 髦溷<E9ABA6>蜷咲ｧｰ<EFBDA7>壼宵閭ｽ逕ｨ蟄玲ｯ阪∵焚蟄励∽ｸ句<EFBDB8>郤ｿ縲∬ｿ槫ｭ礼ｬｦ
|
||
jobQueue.process<YourJob>('your_module_process', async (job) => {
|
||
const { recordId, fileKey } = job.data;
|
||
|
||
logger.info('[YourWorker] Processing job', { jobId: job.id, recordId });
|
||
|
||
try {
|
||
// 1. 莉?OSS 荳玖ｽｽ譁<EFBDBD>ｻｶ
|
||
const buffer = await storage.download(fileKey);
|
||
|
||
// 2. 謇ｧ陦瑚玲慮謫堺ｽ懶ｼ郁ｧ｣譫舌∝､<E2889D>炊縲∬ｮ｡邂暦ｼ<E69AA6>
|
||
const result = await yourLongTimeProcess(buffer);
|
||
const { processedData, totalRows, columns } = result;
|
||
|
||
// 3. 笨?菫晏ｭ伜､<E4BC9C>炊扈捺棡蛻?OSS<53>磯∩蜈埼㍾螟崎ｮ｡邂暦ｼ<E69AA6>
|
||
const cleanDataKey = `${fileKey}_clean.json`;
|
||
const cleanDataBuffer = Buffer.from(JSON.stringify(processedData), 'utf-8');
|
||
await storage.upload(cleanDataKey, cleanDataBuffer);
|
||
|
||
logger.info('[YourWorker] Clean data saved', {
|
||
size: `${(cleanDataBuffer.length / 1024).toFixed(2)} KB`
|
||
});
|
||
|
||
// 4. 譖ｴ譁ｰ荳壼苅隶ｰ蠖包ｼ亥｡ｫ蜈<EFBDAB><E89C88>謨ｰ謐ｮ<E8AC90>?
|
||
await prisma.yourTable.update({
|
||
where: { id: recordId },
|
||
data: {
|
||
cleanDataKey, // 笨?菫晏ｭ<E6998F> clean data 菴咲ｽｮ
|
||
totalRows,
|
||
columns,
|
||
updatedAt: new Date(),
|
||
},
|
||
});
|
||
|
||
logger.info('[YourWorker] 笨?Job completed', { jobId: job.id });
|
||
|
||
return { success: true, recordId, totalRows };
|
||
} catch (error: any) {
|
||
logger.error('[YourWorker] 笶?Job failed', {
|
||
jobId: job.id,
|
||
error: error.message
|
||
});
|
||
throw error; // 隶?pg-boss 螟<>炊驥崎ｯ<E5B48E>
|
||
}
|
||
});
|
||
|
||
logger.info('[YourWorker] 笨?Worker registered: your_module_process');
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 豁･鬪､4<EFBDA4>咾ontroller螻?- 迥ｶ諤∵衍隸｢API
|
||
|
||
```typescript
|
||
// backend/src/modules/your-module/controllers/YourController.ts
|
||
|
||
import { jobQueue } from '@/common/jobs';
|
||
|
||
export class YourController {
|
||
/**
|
||
* 闔ｷ蜿紋ｻｻ蜉｡迥ｶ諤<EFBDB6>ｼ<EFBFBD>latform-Only讓｡蠑擾ｼ?
|
||
*
|
||
* GET /api/v1/your-module/tasks/:id/status
|
||
* Query: jobId (蜿ｯ騾?
|
||
*/
|
||
async getTaskStatus(request, reply) {
|
||
const { id: recordId } = request.params;
|
||
const { jobId } = request.query;
|
||
|
||
// 1. 譟･隸｢荳壼苅隶ｰ蠖<EFBDB0>
|
||
const record = await prisma.yourTable.findUnique({
|
||
where: { id: recordId }
|
||
});
|
||
|
||
if (!record) {
|
||
return reply.code(404).send({ success: false, error: '隶ｰ蠖穂ｸ榊ｭ伜<EFBDAD>? });
|
||
}
|
||
|
||
// 2. 蛻､譁ｭ迥ｶ諤?
|
||
// - 螯よ棡 totalRows 荳堺ｸｺ null<6C>瑚ｯｴ譏主､<E4B8BB>炊螳梧<E89EB3>?
|
||
// - 蜷ｦ蛻呎衍隸｢ job 迥ｶ諤?
|
||
if (record.totalRows !== null) {
|
||
return reply.send({
|
||
success: true,
|
||
data: {
|
||
recordId,
|
||
status: 'ready', // 笨?螟<>炊螳梧<E89EB3>
|
||
progress: 100,
|
||
record,
|
||
},
|
||
});
|
||
}
|
||
|
||
// 3. 螟<>炊荳ｭ<E88DB3>梧衍隸｢ pg-boss
|
||
if (!jobId) {
|
||
return reply.send({
|
||
success: true,
|
||
data: {
|
||
recordId,
|
||
status: 'processing',
|
||
progress: 50,
|
||
},
|
||
});
|
||
}
|
||
|
||
// 4. 莉?pg-boss 譟･隸｢ job 迥ｶ諤?
|
||
const job = await jobQueue.getJob(jobId);
|
||
|
||
const status = job?.status === 'completed' ? 'ready' :
|
||
job?.status === 'failed' ? 'error' : 'processing';
|
||
|
||
const progress = status === 'ready' ? 100 :
|
||
status === 'error' ? 0 : 70;
|
||
|
||
return reply.send({
|
||
success: true,
|
||
data: {
|
||
recordId,
|
||
jobId,
|
||
status,
|
||
progress,
|
||
record,
|
||
},
|
||
});
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 豁･鬪､5<EFBDA4>壼燕遶?- React Query 霓ｮ隸｢
|
||
|
||
```typescript
|
||
// frontend-v2/src/modules/your-module/hooks/useTaskStatus.ts
|
||
|
||
import { useQuery } from '@tanstack/react-query';
|
||
import * as api from '../api';
|
||
|
||
/**
|
||
* 莉ｻ蜉｡迥ｶ諤∬ｽｮ隸?Hook
|
||
*
|
||
* 迚ｹ轤ｹ<E8BDA4>?
|
||
* - 閾ｪ蜉ｨ荳ｲ陦瑚ｽｮ隸｢<E99AB8><EFBDA2>eact Query 蜀<>ｽｮ髦ｲ蟷ｶ蜿托ｼ<E68998>
|
||
* - 閾ｪ蜉ｨ貂<EFBDA8>炊<EFBFBD>育ｻ<E882B2>ｻｶ蜊ｸ霓ｽ譌ｶ蛛懈ｭ｢<EFBDAD>?
|
||
* - 譚｡莉ｶ蛛懈ｭ｢<EFBDAD>亥ｮ梧<EFBDAE>?螟ｱ雍･譌ｶ閾ｪ蜉ｨ蛛懈ｭ｢<EFBDAD><EFBDA2>
|
||
*/
|
||
export function useTaskStatus({
|
||
recordId,
|
||
jobId,
|
||
enabled = true,
|
||
}) {
|
||
const { data, isLoading, error } = useQuery({
|
||
queryKey: ['taskStatus', recordId, jobId],
|
||
queryFn: () => api.getTaskStatus(recordId, jobId),
|
||
enabled: enabled && !!recordId && !!jobId,
|
||
refetchInterval: (query) => {
|
||
const status = query.state.data?.data?.status;
|
||
|
||
// 笨?螳梧<E89EB3>謌門､ｱ雍･譌ｶ蛛懈ｭ｢霓ｮ隸｢
|
||
if (status === 'ready' || status === 'error') {
|
||
return false;
|
||
}
|
||
|
||
// 笨?螟<>炊荳ｭ譌ｶ豈?遘定ｽｮ隸｢<E99AB8>郁<EFBFBD>蜉ｨ荳ｲ陦鯉ｼ?
|
||
return 2000;
|
||
},
|
||
staleTime: 0, // 蟋狗ｻ郁ｧ<E98381>ｸｺ霑<EFBDBA>慮<EFBFBD>檎｡ｮ菫晁ｽｮ隸?
|
||
retry: 1,
|
||
});
|
||
|
||
const statusInfo = data?.data;
|
||
const status = statusInfo?.status || 'processing';
|
||
const progress = statusInfo?.progress || 0;
|
||
|
||
return {
|
||
status,
|
||
progress,
|
||
isReady: status === 'ready',
|
||
isError: status === 'error',
|
||
isLoading,
|
||
error,
|
||
};
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 豁･鬪､6<EFBDA4>壼燕遶ｯ扈<EFBDAF>ｻ?- 菴ｿ逕ｨHook
|
||
|
||
```typescript
|
||
// frontend-v2/src/modules/your-module/pages/YourPage.tsx
|
||
|
||
import { useTaskStatus } from '../hooks/useTaskStatus';
|
||
|
||
const YourPage = () => {
|
||
const [pollingInfo, setPollingInfo] = useState<{
|
||
recordId: string;
|
||
jobId: string;
|
||
} | null>(null);
|
||
|
||
// 笨?菴ｿ逕ｨ React Query Hook 閾ｪ蜉ｨ霓ｮ隸｢
|
||
const { status, progress, isReady } = useTaskStatus({
|
||
recordId: pollingInfo?.recordId || null,
|
||
jobId: pollingInfo?.jobId || null,
|
||
enabled: !!pollingInfo,
|
||
});
|
||
|
||
// 笨?逶大成迥ｶ諤∝序蛹?
|
||
useEffect(() => {
|
||
if (isReady && pollingInfo) {
|
||
console.log('笨?螟<EFBFBD>炊螳梧<EFBFBD><EFBFBD>悟刈霓ｽ謨ｰ謐?);
|
||
|
||
// 蛛懈ｭ｢霓ｮ隸｢
|
||
setPollingInfo(null);
|
||
|
||
// 蜉<>霓ｽ謨ｰ謐ｮ
|
||
loadData(pollingInfo.recordId);
|
||
}
|
||
}, [isReady, pollingInfo]);
|
||
|
||
// 荳贋ｼ<E8B48B>譁<EFBFBD>ｻｶ
|
||
const handleUpload = async (file) => {
|
||
const result = await api.uploadFile(file);
|
||
const { recordId, jobId } = result.data;
|
||
|
||
// 笨?蜷ｯ蜉ｨ霓ｮ隸｢<E99AB8>郁ｮｾ鄂ｮ迥ｶ諤<EFBDB6>ｼ軍eact Query閾ｪ蜉ｨ蠑蟋具ｼ<E585B7>
|
||
setPollingInfo({ recordId, jobId });
|
||
};
|
||
|
||
return (
|
||
<div>
|
||
{/* 霑帛ｺｦ譚?*/}
|
||
{pollingInfo && (
|
||
<div className="progress-bar">
|
||
<div style={{ width: `${progress}%` }} />
|
||
<span>{progress}%</span>
|
||
</div>
|
||
)}
|
||
|
||
{/* 荳贋ｼ<E8B48B>謖蛾聴 */}
|
||
<button onClick={() => handleUpload(file)}>荳贋ｼ<EFBFBD></button>
|
||
</div>
|
||
);
|
||
};
|
||
```
|
||
|
||
---
|
||
|
||
## <20>識 蜈ｳ髞ｮ謚譛ｯ轤ｹ
|
||
|
||
### 1. 髦溷<E9ABA6>蜷咲ｧｰ隗<EFBDB0>激
|
||
|
||
**髞呵ｯｯ**<EFBFBD>?
|
||
```typescript
|
||
笶?'asl:screening:batch' // 蛹<>性蜀貞捷<E8B29E>継g-boss荳肴髪謖?
|
||
笶?'dc.toolc.parse' // 蛹<>性轤ｹ蜿ｷ<E89CBF>御ｸ肴耳闕<E880B3>
|
||
```
|
||
|
||
**豁｣遑ｮ**<EFBFBD>?
|
||
```typescript
|
||
笨?'asl_screening_batch' // 荳句<E88DB3>郤?
|
||
笨?'dc_toolc_parse_excel' // 荳句<E88DB3>郤?
|
||
```
|
||
|
||
---
|
||
|
||
### 2. Worker豕ｨ蜀梧慮譛ｺ
|
||
|
||
```typescript
|
||
// backend/src/index.ts
|
||
|
||
await jobQueue.start(); // 竊?蠢<>｡ｻ蜈亥星蜉ｨ髦溷<E9ABA6>?
|
||
|
||
registerYourWorker(); // 竊?蜀肴ｳｨ蜀?Worker
|
||
registerOtherWorker();
|
||
|
||
// 笨?遲牙ｾ<E78999>3遘抵ｼ檎｡ｮ菫晏ｼよｭ･豕ｨ蜀悟ｮ梧<EFBDAE>
|
||
await new Promise(resolve => setTimeout(resolve, 3000));
|
||
|
||
logger.info('笨?All workers registered');
|
||
```
|
||
|
||
---
|
||
|
||
### 3. clean data 郛灘ｭ俶惻蛻ｶ
|
||
|
||
**逶ｮ逧<EFBDAE>**<EFBFBD>夐∩蜈埼㍾螟崎ｮ｡邂暦ｼ域ｧ閭ｽ謠仙合99%<25>?
|
||
|
||
```typescript
|
||
// Worker 菫晏ｭ<E6998F> clean data
|
||
const cleanDataKey = `${fileKey}_clean.json`;
|
||
await storage.upload(cleanDataKey, JSON.stringify(processedData));
|
||
|
||
await prisma.update({
|
||
where: { id },
|
||
data: {
|
||
cleanDataKey, // 竊?隶ｰ蠖穂ｽ咲ｽｮ
|
||
totalRows,
|
||
columns,
|
||
}
|
||
});
|
||
|
||
// Service 隸ｻ蜿匁焚謐ｮ<E8AC90>井ｼ伜<EFBDBC>?clean data<74>?
|
||
async getFullData(recordId) {
|
||
const record = await prisma.findUnique({ where: { id: recordId } });
|
||
|
||
// 笨?莨伜<E88EA8>隸ｻ蜿<EFBDBB> clean data<74>?1遘抵ｼ<E68AB5>
|
||
if (record.cleanDataKey) {
|
||
const buffer = await storage.download(record.cleanDataKey);
|
||
return JSON.parse(buffer.toString('utf-8'));
|
||
}
|
||
|
||
// 笞<><E7AC9E><EFBFBD> Fallback<63>夐㍾譁ｰ隗｣譫撰ｼ亥<EFBDBC>螳ｹ譌ｧ謨ｰ謐ｮ<E8AC90><EFBDAE>
|
||
const buffer = await storage.download(record.fileKey);
|
||
return parseFile(buffer);
|
||
}
|
||
|
||
// 笞<><E7AC9E><EFBFBD> 驥崎ｦ<E5B48E>ｼ壽桃菴懷錘隕∝酔豁･譖ｴ譁?clean data
|
||
async saveProcessedData(recordId, newData) {
|
||
const record = await getRecord(recordId);
|
||
|
||
// 隕<>尠蜴滓枚莉?
|
||
await storage.upload(record.fileKey, toExcel(newData));
|
||
|
||
// 笨?蜷梧慮譖ｴ譁ｰ clean data
|
||
if (record.cleanDataKey) {
|
||
await storage.upload(record.cleanDataKey, JSON.stringify(newData));
|
||
}
|
||
|
||
// 譖ｴ譁ｰ蜈<EFBDB0>焚謐?
|
||
await prisma.update({ where: { id: recordId }, data: { ... } });
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 4. React Query 霓ｮ隸｢<E99AB8>域耳闕撰ｼ<E692B0>
|
||
|
||
**莨倡せ**<EFBFBD>?
|
||
- 笨?閾ｪ蜉ｨ荳ｲ陦鯉ｼ磯亟蟷ｶ蜿鷹｣取垓<E58F96>?
|
||
- 笨?閾ｪ蜉ｨ蜴ｻ驥搾ｼ亥酔荳queryKey蜿ｪ譛我ｸ荳ｪ隸ｷ豎ゑｼ<E38291>
|
||
- 笨?閾ｪ蜉ｨ貂<EFBDA8>炊<EFBFBD>育ｻ<E882B2>ｻｶ蜊ｸ霓ｽ譌ｶ蛛懈ｭ｢<EFBDAD>?
|
||
- 笨?譚｡莉ｶ蛛懈ｭ｢<EFBDAD>亥勘諤∵而蛻ｶ<E89BBB><EFBDB6>
|
||
|
||
**荳崎ｦ∽ｽｿ逕ｨ setInterval**<EFBFBD>?
|
||
```typescript
|
||
笶?const pollInterval = setInterval(() => {
|
||
api.getStatus(); // 蜿ｯ閭ｽ蟷ｶ蜿<EFBDB6>
|
||
}, 2000);
|
||
```
|
||
|
||
---
|
||
|
||
## <20>投 諤ｧ閭ｽ蟇ｹ豈<EFBDB9>
|
||
|
||
### DC Tool C 螳樣刔謨ｰ謐ｮ<E8AC90>?339陦古?51蛻玲枚莉ｶ<E88E89><EFBDB6>
|
||
|
||
| 謖<><E8AC96><EFBFBD> | 蜷梧ｭ･螟<EFBDA5>炊 | 蠑よｭ･螟<EFBDA5>炊 | 謾ｹ蝟<EFBDB9> |
|
||
|------|---------|---------|------|
|
||
| **荳贋ｼ<E8B48B>閠玲慮** | 47遘抵ｼ磯仆蝪橸ｼ?| 3遘抵ｼ育ｫ句叉霑泌屓<E6B38C>?| 笨?-94% |
|
||
| **HTTP雜<50>慮** | 笶?扈丞ｸｸ雜<EFBDB8>慮 | 笨?荳堺ｼ夊ｶ<E5A48A>慮 | 笨?100% |
|
||
| **getPreviewData** | 43遘抵ｼ磯㍾螟崎ｧ｣譫撰ｼ?| 0.5遘抵ｼ育ｼ灘ｭ假ｼ?| 笨?-99% |
|
||
| **getFullData** | 43遘抵ｼ磯㍾螟崎ｧ｣譫撰ｼ?| 0.5遘抵ｼ育ｼ灘ｭ假ｼ?| 笨?-99% |
|
||
| **QuickAction謫堺ｽ<E5A0BA>** | 43遘?+ Python | 0.5遘?+ Python | 笨?-95% |
|
||
| **蟷ｶ蜿題ｯｷ豎<EFBDB7>** | 15+荳?| 1荳ｪ<E88DB3>井ｸｲ陦鯉ｼ?| 笨?-93% |
|
||
|
||
---
|
||
|
||
## 笞<><E7AC9E><EFBFBD> 蟶ｸ隗<EFBDB8>琉鬚<E79089>
|
||
|
||
### Q1: Worker 豕ｨ蜀御ｺ<E5BEA1>ｽ<EFBFBD>ｸ榊ｷ･菴懶ｼ<E687B6>
|
||
|
||
**譽譟?*<2A>?
|
||
- 髦溷<E9ABA6>蜷咲ｧｰ譏ｯ蜷ｦ蛹<EFBDA6>性蜀貞捷<E8B29E><E68DB7>:`<60>会ｼ滓隼荳ｺ荳句<E88DB3>郤ｿ<E983A4><EFBDBF>_`<EFBFBD>?
|
||
- 邇ｯ蠅<EFBDAF>序驥<E5BA8F> `QUEUE_TYPE=pgboss` 譏ｯ蜷ｦ隶ｾ鄂ｮ<E98482>?
|
||
- Worker 豕ｨ蜀梧弍蜷ｦ蝨?`jobQueue.start()` 荵句錘<E58FA5>?
|
||
|
||
### Q2: 霓ｮ隸｢鬟取垓<E58F96>亥､壻ｸｪ蟷ｶ蜿題ｯｷ豎ゑｼ会ｼ?
|
||
|
||
**隗｣蜀ｳ**<EFBFBD>壻ｽｿ逕?React Query<72>御ｸ崎ｦ∫畑 setInterval
|
||
|
||
### Q3: 蟇ｼ蜃ｺ謨ｰ謐ｮ荳榊ｯｹ<EFBDAF>域弍蜴溷ｧ区焚謐ｮ<E8AC90>会ｼ<E4BC9A>
|
||
|
||
**蜴溷屏**<EFBFBD>啻saveProcessedData` 豐｡譛画峩譁ｰ clean data
|
||
**隗｣蜀ｳ**<2A>壼酔譌ｶ譖ｴ譁?fileKey 蜥?cleanDataKey
|
||
|
||
---
|
||
|
||
## <20>答 蜿り<E3828A>ｮ樒<EFBDAE>?
|
||
|
||
| 讓｡蝮<EFBDA1> | Worker | 蜑咲ｫｯHook | 譁<>｡｣ |
|
||
|------|--------|---------|------|
|
||
| **DC Tool C** | `parseExcelWorker.ts` | `useSessionStatus.ts` | 譛ｬ謖<EFBDAC>漉蝓ｺ遑 |
|
||
| **ASL 譎ｺ閭ｽ譁<EFBDBD>鍵** | `screeningWorker.ts` | `useScreeningTask.ts` | [ASL讓｡蝮礼憾諤‐(../03-荳壼苅讓｡蝮<EFBDA1>/ASL-AI譎ｺ閭ｽ譁<EFBDBD>鍵/00-讓｡蝮怜ｽ灘燕迥ｶ諤∽ｸ主ｼ蜿第欠蜊?md) |
|
||
| **DC Tool B** | `extractionWorker.ts` | - | [DC讓｡蝮礼憾諤‐(../03-荳壼苅讓｡蝮<EFBDA1>/DC-謨ｰ謐ｮ貂<EFBDAE>ｴ玲紛逅<E7B49B>/00-讓｡蝮怜ｽ灘燕迥ｶ諤∽ｸ主ｼ蜿第欠蜊?md) |
|
||
|
||
---
|
||
|
||
## 笨?譽譟･貂<EFBDA5><E8B282>?
|
||
|
||
蝨ｨ螳樊命蠑よｭ･莉ｻ蜉｡蜑搾ｼ瑚ｯｷ遑ｮ隶､<EFBFBD>?
|
||
|
||
- [ ] 荳壼苅陦ｨ蜿ｪ蟄倅ｸ壼苅菫｡諱ｯ<E8ABB1>井ｸ榊桁蜷?status 遲牙ｭ玲ｮｵ<EFBDAE><EFBDB5>
|
||
- [ ] 髦溷<E9ABA6>蜷咲ｧｰ菴ｿ逕ｨ荳句<E88DB3>郤ｿ<E983A4>井ｸ榊性蜀貞捷<E8B29E>?
|
||
- [ ] 邇ｯ蠅<EFBDAF>序驥<E5BA8F> `QUEUE_TYPE=pgboss` 蟾ｲ隶ｾ鄂?
|
||
- [ ] Worker 蝨?`jobQueue.start()` 荵句錘豕ｨ蜀<EFBDA8>
|
||
- [ ] 蜑咲ｫｯ菴ｿ逕ｨ React Query 霓ｮ隸｢
|
||
- [ ] Service 莨伜<E88EA8>隸ｻ蜿<EFBDBB> clean data
|
||
- [ ] saveProcessedData 蜷梧ｭ･譖ｴ譁ｰ clean data
|
||
|
||
---
|
||
|
||
**扈ｴ謚､閠?*: 蟷ｳ蜿ｰ譫ｶ譫<EFBDB6>屬髦<E5B1AC>
|
||
**譛蜷取峩譁?*: 2025-12-22
|
||
**譁<>｡｣迥ｶ諤?*: 笨?蟾ｲ螳梧<E89EB3>?
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|