Nightly sweep with two directions: attachments still unclaimed (pageId null) after a 24 h grace period - claimed by no collab persist, page upload, or import - are reclaimed (row, file, quota released); files on the uploads volume without a database row (drift after a crashed upload) are removed once older than the grace period. The grace period protects the paste-then-insert window. Deliberate deviation from the issue's content-reference idea, documented in schema comment and operations.md: claimed attachments whose page content no longer embeds them are NOT auto-deleted. The page attachments panel lists claimed files as user-managed objects (inserting into the document is optional there), so 'not embedded' is not 'unused' - an auto-delete would destroy panel assets. Humans clean those up in the panel or the pond file manager, which flags orphans already. Attachment.deletedAt is removed by migration - deletion is hard everywhere (sweep, purge, manual), there is no soft-delete state; the never-true deletedAt:null filters in files/export queries went with it. Refs #194 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0168Ph5uBmHm8X28CSVpbpnJ
39 lines
1.3 KiB
TypeScript
39 lines
1.3 KiB
TypeScript
import { Module, OnModuleInit } from '@nestjs/common';
|
|
|
|
import { CommonModule } from '../common/common.module';
|
|
import { PondsModule } from '../ponds/ponds.module';
|
|
import { QuotasModule } from '../quotas/quotas.module';
|
|
import { SchedulerModule } from '../scheduler/scheduler.module';
|
|
import { SchedulerService } from '../scheduler/scheduler.service';
|
|
|
|
import { FileStorageService } from './file-storage.service';
|
|
import { FilesController } from './files.controller';
|
|
import { FilesService } from './files.service';
|
|
import { OrphanSweepService } from './orphan-sweep.service';
|
|
|
|
/** Nightly, per operations.md's maintenance-jobs table (issue #194). */
|
|
const ORPHAN_SWEEP_CADENCE_SECONDS = 24 * 60 * 60;
|
|
|
|
@Module({
|
|
imports: [CommonModule, PondsModule, QuotasModule, SchedulerModule],
|
|
controllers: [FilesController],
|
|
providers: [FilesService, FileStorageService, OrphanSweepService],
|
|
exports: [FileStorageService, FilesService],
|
|
})
|
|
export class FilesModule implements OnModuleInit {
|
|
constructor(
|
|
private readonly scheduler: SchedulerService,
|
|
private readonly sweep: OrphanSweepService,
|
|
) {}
|
|
|
|
onModuleInit(): void {
|
|
this.scheduler.register({
|
|
name: 'orphan-file-sweep',
|
|
cadenceSeconds: ORPHAN_SWEEP_CADENCE_SECONDS,
|
|
run: async () => {
|
|
await this.sweep.sweep();
|
|
},
|
|
});
|
|
}
|
|
}
|