89088414/16gagent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b87cac57cea1e934c81083bc5897fbb9db5bd53c
16gagent/.benchmark/blog-cms/arch.json
T
大海 a188ee1426 🎉 init: 小龙的工作空间
2026-06-06 10:40:48 +08:00

1 line
23 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{"projectName":"SocialApp","domain":"social","contract":{"projectName":"SocialApp","domain":"social","entities":[{"name":"User","table":"users","description":"系统用户","fields":[{"name":"id","type":"UUID","isPrimary":true,"isAuto":true},{"name":"username","type":"VARCHAR(128)","required":true,"unique":true,"validation":{"minLength":2,"maxLength":50}},{"name":"password_hash","type":"VARCHAR(256)","required":true,"isSecret":true},{"name":"nickname","type":"VARCHAR(128)"},{"name":"role","type":"VARCHAR(32)","defaultValue":"user","enum":["user","admin"]},{"name":"phone","type":"VARCHAR(20)"},{"name":"avatar_url","type":"TEXT"},{"name":"created_at","type":"TIMESTAMP","isAuto":true},{"name":"updated_at","type":"TIMESTAMP","isAuto":true}],"relationships":[{"type":"hasMany","entity":"contracts","via":"user_id"},{"type":"hasMany","entity":"customers","via":"user_id"}]},{"name":"Contract","table":"contracts","description":"合同","fields":[{"name":"id","type":"UUID","isPrimary":true,"isAuto":true},{"name":"user_id","type":"UUID","required":true,"fkEntity":"users","fkColumn":"id"},{"name":"title","type":"VARCHAR(256)","required":true},{"name":"party_a","type":"VARCHAR(128)"},{"name":"party_b","type":"VARCHAR(128)"},{"name":"amount","type":"DECIMAL(14,2)"},{"name":"signed_at","type":"DATE"},{"name":"expires_at","type":"DATE"},{"name":"status","type":"VARCHAR(32)","defaultValue":"draft","enum":["draft","pending","active","expired","terminated"]},{"name":"file_url","type":"TEXT"},{"name":"created_at","type":"TIMESTAMP","isAuto":true},{"name":"updated_at","type":"TIMESTAMP","isAuto":true}],"relationships":[{"type":"belongsTo","entity":"users","via":"user_id"}]},{"name":"Approval","table":"approvals","description":"审批流程","fields":[{"name":"id","type":"UUID","isPrimary":true,"isAuto":true},{"name":"user_id","type":"UUID","required":true,"fkEntity":"users","fkColumn":"id"},{"name":"entity_type","type":"VARCHAR(32)","required":true},{"name":"entity_id","type":"UUID"},{"name":"applicant_id","type":"UUID","required":true,"fkEntity":"users","fkColumn":"id"},{"name":"status","type":"VARCHAR(32)","defaultValue":"pending","enum":["pending","approved","rejected"]},{"name":"form_data","type":"JSONB"},{"name":"created_at","type":"TIMESTAMP","isAuto":true},{"name":"updated_at","type":"TIMESTAMP","isAuto":true}],"relationships":[{"type":"belongsTo","entity":"users","via":"user_id"},{"type":"belongsTo","entity":"users","via":"applicant_id","as":"applicant"}]},{"name":"Customer","table":"customers","description":"客户","fields":[{"name":"id","type":"UUID","isPrimary":true,"isAuto":true},{"name":"user_id","type":"UUID","required":true,"fkEntity":"users","fkColumn":"id"},{"name":"name","type":"VARCHAR(128)","required":true},{"name":"email","type":"VARCHAR(256)"},{"name":"phone","type":"VARCHAR(20)"},{"name":"company","type":"VARCHAR(128)"},{"name":"source","type":"VARCHAR(64)"},{"name":"tags","type":"JSONB","defaultValue":"[]"},{"name":"created_at","type":"TIMESTAMP","isAuto":true},{"name":"updated_at","type":"TIMESTAMP","isAuto":true}],"relationships":[{"type":"belongsTo","entity":"users","via":"user_id"}]},{"name":"Reminder","table":"reminders","description":"到期提醒","fields":[{"name":"id","type":"UUID","isPrimary":true,"isAuto":true},{"name":"user_id","type":"UUID","required":true,"fkEntity":"users","fkColumn":"id"},{"name":"entity_type","type":"VARCHAR(32)","required":true},{"name":"entity_id","type":"UUID"},{"name":"remind_at","type":"TIMESTAMP","required":true},{"name":"message","type":"TEXT"},{"name":"sent","type":"BOOLEAN","defaultValue":"false"},{"name":"created_at","type":"TIMESTAMP","isAuto":true},{"name":"updated_at","type":"TIMESTAMP","isAuto":true}],"relationships":[{"type":"belongsTo","entity":"users","via":"user_id"}]},{"name":"Articles","table":"articles","description":"文章发布表","fields":[{"name":"id","type":"UUID","required":true,"isPrimary":true,"isAuto":true},{"name":"user_id","type":"UUID","required":false,"isPrimary":false,"isAuto":false,"fkEntity":"users","fkColumn":"id"},{"name":"title","type":"VARCHAR(256)","required":true,"isPrimary":false,"isAuto":false},{"name":"content","type":"TEXT","required":false,"isPrimary":false,"isAuto":false},{"name":"excerpt","type":"TEXT","required":false,"isPrimary":false,"isAuto":false},{"name":"cover_url","type":"TEXT","required":false,"isPrimary":false,"isAuto":false},{"name":"status","type":"VARCHAR(32)","required":false,"isPrimary":false,"isAuto":true},{"name":"author_id","type":"UUID","required":false,"isPrimary":false,"isAuto":false,"fkEntity":"authors","fkColumn":"id"},{"name":"category","type":"VARCHAR(64)","required":false,"isPrimary":false,"isAuto":false},{"name":"published_at","type":"TIMESTAMPTZ","required":false,"isPrimary":false,"isAuto":false},{"name":"created_at","type":"TIMESTAMPTZ","required":false,"isPrimary":false,"isAuto":true},{"name":"updated_at","type":"TIMESTAMPTZ","required":false,"isPrimary":false,"isAuto":true}],"relationships":[{"type":"belongsTo","entity":"users","via":"user_id"},{"type":"belongsTo","entity":"authors","via":"author_id"}]},{"name":"Tags","table":"tags","description":"分类标签表","fields":[{"name":"id","type":"UUID","required":true,"isPrimary":true,"isAuto":true},{"name":"user_id","type":"UUID","required":false,"isPrimary":false,"isAuto":false,"fkEntity":"users","fkColumn":"id"},{"name":"name","type":"VARCHAR(64)","required":true,"isPrimary":false,"isAuto":false,"unique":true},{"name":"color","type":"VARCHAR(7)","required":false,"isPrimary":false,"isAuto":false},{"name":"created_at","type":"TIMESTAMPTZ","required":false,"isPrimary":false,"isAuto":true},{"name":"updated_at","type":"TIMESTAMPTZ","required":false,"isPrimary":false,"isAuto":true}],"relationships":[{"type":"belongsTo","entity":"users","via":"user_id"}]},{"name":"Comments","table":"comments","description":"评论管理表","fields":[{"name":"id","type":"UUID","required":true,"isPrimary":true,"isAuto":true},{"name":"user_id","type":"UUID","required":false,"isPrimary":false,"isAuto":false,"fkEntity":"users","fkColumn":"id"},{"name":"entity_type","type":"VARCHAR(32)","required":true,"isPrimary":false,"isAuto":false},{"name":"entity_id","type":"UUID","required":true,"isPrimary":false,"isAuto":false},{"name":"content","type":"TEXT","required":true,"isPrimary":false,"isAuto":false},{"name":"parent_id","type":"UUID","required":false,"isPrimary":false,"isAuto":false,"fkEntity":"parents","fkColumn":"id"},{"name":"created_at","type":"TIMESTAMPTZ","required":false,"isPrimary":false,"isAuto":true},{"name":"updated_at","type":"TIMESTAMPTZ","required":false,"isPrimary":false,"isAuto":true}],"relationships":[{"type":"belongsTo","entity":"users","via":"user_id"},{"type":"belongsTo","entity":"parents","via":"parent_id"}]},{"name":"Media","table":"media","description":"媒体库表","fields":[{"name":"id","type":"UUID","required":true,"isPrimary":true,"isAuto":true},{"name":"user_id","type":"UUID","required":false,"isPrimary":false,"isAuto":false,"fkEntity":"users","fkColumn":"id"},{"name":"filename","type":"VARCHAR(256)","required":true,"isPrimary":false,"isAuto":false},{"name":"url","type":"TEXT","required":true,"isPrimary":false,"isAuto":false},{"name":"mime_type","type":"VARCHAR(64)","required":false,"isPrimary":false,"isAuto":false},{"name":"size_bytes","type":"INTEGER","required":false,"isPrimary":false,"isAuto":false},{"name":"created_at","type":"TIMESTAMPTZ","required":false,"isPrimary":false,"isAuto":true},{"name":"updated_at","type":"TIMESTAMPTZ","required":false,"isPrimary":false,"isAuto":true}],"relationships":[{"type":"belongsTo","entity":"users","via":"user_id"}]}],"auth":{"registrationFields":["username","password","nickname"],"loginFields":["username","password"],"jwtPayload":["userId","username","role"],"passwordPolicy":{"minLength":6,"requireSpecial":false}},"permissions":[{"role":"admin","allow":["*"]},{"role":"user","allow":["read:own","create:*","update:own","delete:own"]}],"fieldMapping":{"snakeToCamel":{"created_at":"createdAt","updated_at":"updatedAt","user_id":"userId","password_hash":"passwordHash","avatar_url":"avatarUrl","party_a":"partyA","party_b":"partyB","signed_at":"signedAt","expires_at":"expiresAt","file_url":"fileUrl","entity_type":"entityType","entity_id":"entityId","applicant_id":"applicantId","form_data":"formData","remind_at":"remindAt","cover_url":"coverUrl","author_id":"authorId","published_at":"publishedAt","parent_id":"parentId","mime_type":"mimeType","size_bytes":"sizeBytes","id":"id","username":"username","nickname":"nickname","role":"role","phone":"phone","title":"title","description":"description","status":"status","data":"data","amount":"amount","name":"name","email":"email","company":"company","source":"source","tags":"tags","breed":"breed","species":"species","birth_date":"birthDate","weight_kg":"weightKg","price":"price","stock":"stock","images":"images","total_amount":"totalAmount","address_id":"addressId","message":"message","sent":"sent"},"camelToSnake":{"createdAt":"created_at","updatedAt":"updated_at","userId":"user_id","passwordHash":"password_hash","avatarUrl":"avatar_url","partyA":"party_a","partyB":"party_b","signedAt":"signed_at","expiresAt":"expires_at","fileUrl":"file_url","entityType":"entity_type","entityId":"entity_id","applicantId":"applicant_id","formData":"form_data","remindAt":"remind_at","coverUrl":"cover_url","authorId":"author_id","publishedAt":"published_at","parentId":"parent_id","mimeType":"mime_type","sizeBytes":"size_bytes","id":"id","username":"username","nickname":"nickname","role":"role","phone":"phone","title":"title","description":"description","status":"status","data":"data","amount":"amount","name":"name","email":"email","company":"company","source":"source","tags":"tags","breed":"breed","species":"species","birthDate":"birth_date","weightKg":"weight_kg","price":"price","stock":"stock","images":"images","totalAmount":"total_amount","addressId":"address_id","message":"message","sent":"sent"}},"validation":{"User":{"username":{"minLength":2,"maxLength":50,"required":true,"unique":true},"password_hash":{"required":true},"role":{"enum":["user","admin"],"defaultValue":"user"}},"Contract":{"user_id":{"required":true},"title":{"required":true},"status":{"enum":["draft","pending","active","expired","terminated"],"defaultValue":"draft"}},"Approval":{"user_id":{"required":true},"entity_type":{"required":true},"applicant_id":{"required":true},"status":{"enum":["pending","approved","rejected"],"defaultValue":"pending"}},"Customer":{"user_id":{"required":true},"name":{"required":true},"tags":{"defaultValue":"[]"}},"Reminder":{"user_id":{"required":true},"entity_type":{"required":true},"remind_at":{"required":true},"sent":{"defaultValue":"false"}},"Articles":{"id":{"required":true},"title":{"required":true}},"Tags":{"id":{"required":true},"name":{"required":true,"unique":true}},"Comments":{"id":{"required":true},"entity_type":{"required":true},"entity_id":{"required":true},"content":{"required":true}},"Media":{"id":{"required":true},"filename":{"required":true},"url":{"required":true}}}},"techStack":{"frontend":"React Native 0.76 + Expo / Flutter 3.x","backend":"NestJS + Prisma","database":"PostgreSQL 15 + Redis 7 + MinIO（文件存储）","deployment":"Docker Compose + Nginx / K8s（规模化）","considerations":[]},"architectureDiagram":"┌─────────────────────────────────────────────────────────┐\n│ SocialApp — System Architecture │\n├─────────────────────────────────────────────────────────┤\n│ │\n│ ┌──────────────────────┐ ┌──────────────────────┐ │\n│ │ Client Layer │ │ Admin / Web │ │\n│ │ React Native 0.76 + Expo / Flutter 3.x │ │ React + Vite (Web) │ │\n│ └──────────┬───────────┘ └──────────┬───────────┘ │\n│ │ │ │\n│ └──────────┬────────────────┘ │\n│ │ │\n│ ┌─────────▼──────────┐ │\n│ │ API Gateway │ │\n│ │ Nginx / Kong │ │\n│ └─────────┬──────────┘ │\n│ │ │\n│ ┌─────────▼──────────┐ │\n│ │ Backend Services │ │\n│ │ NestJS + Prisma │ │\n│ └─────────┬──────────┘ │\n│ │ │\n│ ┌───────────────┼───────────────┐ │\n│ │ │ │ │\n│ ┌─────▼─────┐ ┌──────▼──────┐ ┌────▼─────┐ │\n│ │ PostgreSQL 15│ │ Redis Cache │ │ MinIO │ │\n│ │ Primary │ │ Session │ │ Files │ │\n│ └───────────┘ └─────────────┘ └──────────┘ │\n│ │\n├─────────────────────────────────────────────────────────┤\n│ Modules: │\n│ 1 文章发布 │\n│ 2 分类标签 │\n│ 3 Content │\n│ 4 媒体库 │\n│ │\n└─────────────────────────────────────────────────────────┘","dataFlows":[{"page":"文章发布","route":"/articles","description":"文章发布","dataFlow":["GET /api/articles → 获取文章发布列表","POST /api/articles → 创建文章发布"],"direction":"Client → API Gateway → Backend → Database → Response → Client"},{"page":"分类标签","route":"/tags","description":"分类标签","dataFlow":["GET /api/tags → 获取分类标签列表","POST /api/tags → 创建分类标签"],"direction":"Client → API Gateway → Backend → Database → Response → Client"},{"page":"评论管理","route":"/comments","description":"评论管理","dataFlow":["GET /api/comments → 获取评论管理列表","POST /api/comments → 创建评论管理"],"direction":"Client → API Gateway → Backend → Database → Response → Client"},{"page":"媒体库","route":"/media","description":"媒体库","dataFlow":["GET /api/media → 获取媒体库列表","POST /api/media → 创建媒体库"],"direction":"Client → API Gateway → Backend → Database → Response → Client"}],"modules":[{"name":"文章发布","label":"文章发布","features":["文章发布"],"responsibilities":["提供 文章发布 相关功能"]},{"name":"分类标签","label":"分类标签","features":["分类标签"],"responsibilities":["提供 分类标签 相关功能"]},{"name":"content","label":"Content","features":["评论管理"],"responsibilities":["提供 评论管理 相关功能"]},{"name":"媒体库","label":"媒体库","features":["媒体库"],"responsibilities":["提供 媒体库 相关功能"]}],"databaseSchema":[{"table":"users","description":"用户表","fields":[{"name":"id","type":"UUID","constraints":"PK, DEFAULT gen_random_uuid()"},{"name":"phone","type":"VARCHAR(20)","constraints":"UNIQUE"},{"name":"nickname","type":"VARCHAR(64)"},{"name":"avatar_url","type":"TEXT"},{"name":"created_at","type":"TIMESTAMPTZ","constraints":"DEFAULT NOW()"},{"name":"updated_at","type":"TIMESTAMPTZ","constraints":"DEFAULT NOW()"}],"indexes":["idx_users_phone ON users(phone)"]},{"table":"articles","description":"文章发布表","fields":[{"name":"id","type":"UUID","constraints":"PK, DEFAULT gen_random_uuid()"},{"name":"user_id","type":"UUID","constraints":"FK → users.id"},{"name":"title","type":"VARCHAR(256)","constraints":"NOT NULL"},{"name":"content","type":"TEXT"},{"name":"excerpt","type":"TEXT"},{"name":"cover_url","type":"TEXT"},{"name":"status","type":"VARCHAR(32)","constraints":"DEFAULT 'draft'"},{"name":"author_id","type":"UUID","constraints":"FK → users.id"},{"name":"category","type":"VARCHAR(64)"},{"name":"published_at","type":"TIMESTAMPTZ"},{"name":"created_at","type":"TIMESTAMPTZ","constraints":"DEFAULT NOW()"},{"name":"updated_at","type":"TIMESTAMPTZ","constraints":"DEFAULT NOW()"}],"indexes":["idx_articles_user ON articles(user_id)"]},{"table":"tags","description":"分类标签表","fields":[{"name":"id","type":"UUID","constraints":"PK, DEFAULT gen_random_uuid()"},{"name":"user_id","type":"UUID","constraints":"FK → users.id"},{"name":"name","type":"VARCHAR(64)","constraints":"NOT NULL, UNIQUE"},{"name":"color","type":"VARCHAR(7)"},{"name":"created_at","type":"TIMESTAMPTZ","constraints":"DEFAULT NOW()"},{"name":"updated_at","type":"TIMESTAMPTZ","constraints":"DEFAULT NOW()"}],"indexes":["idx_tags_user ON tags(user_id)"]},{"table":"comments","description":"评论管理表","fields":[{"name":"id","type":"UUID","constraints":"PK, DEFAULT gen_random_uuid()"},{"name":"user_id","type":"UUID","constraints":"FK → users.id"},{"name":"entity_type","type":"VARCHAR(32)","constraints":"NOT NULL"},{"name":"entity_id","type":"UUID","constraints":"NOT NULL"},{"name":"content","type":"TEXT","constraints":"NOT NULL"},{"name":"parent_id","type":"UUID","constraints":"FK → comments.id (自引用)"},{"name":"created_at","type":"TIMESTAMPTZ","constraints":"DEFAULT NOW()"},{"name":"updated_at","type":"TIMESTAMPTZ","constraints":"DEFAULT NOW()"}],"indexes":["idx_comments_user ON comments(user_id)"]},{"table":"media","description":"媒体库表","fields":[{"name":"id","type":"UUID","constraints":"PK, DEFAULT gen_random_uuid()"},{"name":"user_id","type":"UUID","constraints":"FK → users.id"},{"name":"filename","type":"VARCHAR(256)","constraints":"NOT NULL"},{"name":"url","type":"TEXT","constraints":"NOT NULL"},{"name":"mime_type","type":"VARCHAR(64)"},{"name":"size_bytes","type":"INTEGER"},{"name":"created_at","type":"TIMESTAMPTZ","constraints":"DEFAULT NOW()"},{"name":"updated_at","type":"TIMESTAMPTZ","constraints":"DEFAULT NOW()"}],"indexes":["idx_media_user ON media(user_id)"]}],"apiDesign":[{"resource":"articles","basePath":"/api/articles","endpoints":[{"method":"GET","path":"/api/articles","description":"获取文章发布列表"},{"method":"POST","path":"/api/articles","description":"创建文章发布"}]},{"resource":"auth","basePath":"/api/auth","endpoints":[{"method":"POST","path":"/api/auth/login","description":"用户登录"},{"method":"GET","path":"/api/auth/me","description":"获取当前用户"}]},{"resource":"comments","basePath":"/api/comments","endpoints":[{"method":"GET","path":"/api/comments","description":"获取评论管理列表"},{"method":"POST","path":"/api/comments","description":"创建评论管理"}]},{"resource":"media","basePath":"/api/media","endpoints":[{"method":"GET","path":"/api/media","description":"获取媒体库列表"},{"method":"POST","path":"/api/media","description":"创建媒体库"}]},{"resource":"tags","basePath":"/api/tags","endpoints":[{"method":"GET","path":"/api/tags","description":"获取分类标签列表"},{"method":"POST","path":"/api/tags","description":"创建分类标签"}]}],"directoryStructure":["socialapp/","├── apps/","│ ├── mobile/ # React Native / Flutter 移动端","│ │ ├── src/","│ │ │ ├── screens/ # 页面组件","│ │ │ │ ├── 文章发布/","│ │ │ │ ├── 分类标签/","│ │ │ │ ├── content/","│ │ │ │ ├── 媒体库/","│ │ │ ├── components/ # 通用组件","│ │ │ ├── hooks/ # 自定义 Hooks","│ │ │ ├── services/ # API 调用层","│ │ │ ├── store/ # 状态管理","│ │ │ └── utils/ # 工具函数","│ │ ├── app.json","│ │ └── package.json","│ └── web/ # Web 管理后台","│ ├── src/","│ │ ├── pages/","│ │ ├── components/","│ │ └── layouts/","│ └── package.json","├── packages/","│ └── shared/ # 共享类型/常量","├── server/ # NestJS 后端服务","│ ├── src/","│ │ ├── modules/ # 业务模块","│ │ │ ├── 文章发布/","│ │ │ │ ├── 文章发布.controller.ts","│ │ │ │ ├── 文章发布.service.ts","│ │ │ │ ├── 文章发布.module.ts","│ │ │ │ └── dto/","│ │ │ ├── 分类标签/","│ │ │ │ ├── 分类标签.controller.ts","│ │ │ │ ├── 分类标签.service.ts","│ │ │ │ ├── 分类标签.module.ts","│ │ │ │ └── dto/","│ │ │ ├── content/","│ │ │ │ ├── content.controller.ts","│ │ │ │ ├── content.service.ts","│ │ │ │ ├── content.module.ts","│ │ │ │ └── dto/","│ │ │ ├── 媒体库/","│ │ │ │ ├── 媒体库.controller.ts","│ │ │ │ ├── 媒体库.service.ts","│ │ │ │ ├── 媒体库.module.ts","│ │ │ │ └── dto/","│ │ ├── common/ # 通用（guards, filters, interceptors）","│ │ ├── prisma/ # Prisma ORM","│ │ │ └── schema.prisma","│ │ ├── config/ # 环境配置","│ │ └── main.ts","│ ├── test/","│ ├── Dockerfile","│ └── package.json","├── docker-compose.yml","├── .github/workflows/ # CI/CD","│ └── ci.yml","├── .env.example","├── README.md","└── turbo.json # Monorepo 配置"],"deployment":{"environments":["development","staging","production"],"strategy":"Docker Compose + Nginx / K8s（规模化）","services":["API Server (NestJS)","PostgreSQL 15","Redis 7"],"ci":"GitHub Actions → Build → Test → Deploy"},"meta":{"generatedAt":"2026-06-05T22:08:35.601Z","sourceDomain":"social","moduleCount":4,"tableCount":5,"apiEndpointCount":10}}
Reference in New Issue View Git Blame Copy Permalink