apunkt/trustgraph
1
0
Fork 0
mirror of https://github.com/trustgraph-ai/trustgraph.git synced 2026-07-27 22:21:04 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Tech spec updates

Browse source
This commit is contained in:
Cyber MacGeddon 2025-09-17 12:24:50 +01:00
parent 5cb04aaff1
commit a1d1065c57
1 changed files with 7 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

14
docs/tech-specs/collection-management.md
View file

@ -83,7 +83,7 @@ CREATE TABLE collections (
``` ```
Table structure: Table structure:
- **user_id** + **collection_id**: Composite primary key ensuring user isolation - **user** + **collection_id**: Composite primary key ensuring user isolation
- **name**: Human-readable collection name - **name**: Human-readable collection name
- **description**: Detailed description of collection purpose - **description**: Detailed description of collection purpose
- **tags**: Set of tags for categorization and filtering - **tags**: Set of tags for categorization and filtering
@ -142,9 +142,9 @@ New APIs:
- **Collection Use Notification** (Internal): Ensure metadata record exists when collection is referenced - **Collection Use Notification** (Internal): Ensure metadata record exists when collection is referenced
Store Writer APIs (Enhanced): Store Writer APIs (Enhanced):
- **Vector Store Collection Deletion**: Remove vector data for specified collection - **Vector Store Collection Deletion**: Remove vector data for specified user and collection
- **Object Store Collection Deletion**: Remove object/document data for specified collection - **Object Store Collection Deletion**: Remove object/document data for specified user and collection
- **Triple Store Collection Deletion**: Remove graph/RDF data for specified collection - **Triple Store Collection Deletion**: Remove graph/RDF data for specified user and collection
Modified APIs: Modified APIs:
- **Data Loading APIs**: Enhanced to trigger collection use notification for lazy metadata creation - **Data Loading APIs**: Enhanced to trigger collection use notification for lazy metadata creation
@ -160,9 +160,9 @@ When a user initiates collection deletion through the librarian service:
1. **Metadata Validation**: Verify collection exists and user has permission to delete 1. **Metadata Validation**: Verify collection exists and user has permission to delete
2. **Store Cascade**: Librarian coordinates deletion across all store writers: 2. **Store Cascade**: Librarian coordinates deletion across all store writers:
- Vector store writer: Remove embeddings and vector indexes for the collection - Vector store writer: Remove embeddings and vector indexes for the user and collection
- Object store writer: Remove documents and files for the collection - Object store writer: Remove documents and files for the user and collection
- Triple store writer: Remove graph data and triples for the collection - Triple store writer: Remove graph data and triples for the user and collection
3. **Metadata Cleanup**: Remove collection metadata record from Cassandra 3. **Metadata Cleanup**: Remove collection metadata record from Cassandra
4. **Error Handling**: If any store deletion fails, maintain consistency through rollback or retry mechanisms 4. **Error Handling**: If any store deletion fails, maintain consistency through rollback or retry mechanisms