KB-7650
Council Review \u2014 Gemini \u2014 \u0110i\u1ec1u 28 v2.0 + HP v4.2.0
6 min read Revision 1
version ho\u1eb7c compatibility_tag \u0111\u1ec3 qu\u1ea3n l\u00fd c\u00e1c thay \u0111\u1ed5i l\u1edbn trong code component m\u00e0 kh\u00f4ng l\u00e0m g\u00e3y c\u00e1c instance c\u0169.\n- A4: [C\u00d3] \u2014 Checklist 8 b\u1ed9 ph\u1eadn \u0111\u1ee7 ch\u1eb7t ch\u1ebf. Vi\u1ec7c \u0111\u01b0a checklist_status v\u00e0o JSONB trong PG \u0111\u1ec3 m\u00e1y ki\u1ec3m tra l\u00e0 \u0111i\u1ec3m s\u00e1ng v\u1ec1 t\u00ednh t\u1ef1 \u0111\u1ed9ng.\n- A5: [C\u00d3] \u2014 Quy tr\u00ecnh test 5 lo\u1ea1i ph\u1ee7 h\u1ebft c\u00e1c r\u1ee7i ro t\u1eeb b\u1ea3o m\u1eadt (Validation Gate) \u0111\u1ebfn \u0111\u1ed9 ch\u00ednh x\u00e1c (Truth Check). Ti\u00eau ch\u00ed PASS/FAIL \u0111\u1ecbnh l\u01b0\u1ee3ng \u0111\u01b0\u1ee3c (v\u00ed d\u1ee5: 100% \u00f4 ph\u1ea3i kh\u1edbp).\n- A6: [C\u00d3] \u2014 Quy tr\u00ecnh 5 b\u01b0\u1edbc chuy\u1ec3n giao r\u1ea5t th\u1ef1c t\u1ebf, gi\u00fap t\u1eadn d\u1ee5ng "di s\u1ea3n" hi\u1ec7n c\u00f3 m\u00e0 kh\u00f4ng g\u00e2y gi\u00e1n \u0111o\u1ea1n h\u1ec7 th\u1ed1ng. B\u1ea3ng \u1ee9ng vi\u00ean \u0111\u00e3 li\u1ec7t k\u00ea \u0111\u1ee7 c\u00e1c module l\u00f5i (Comment, Workflow, Pivot).\n- A7: [C\u00d3] \u2014 Whitelist l\u00e0 c\u00a1 ch\u1ebf th\u1ef1c thi (enforce) kh\u1ea3 thi nh\u1ea5t. L\u1ed7i h\u1ed5ng duy nh\u1ea5t l\u00e0 agent can thi\u1ec7p tr\u1ef1c ti\u1ebfp v\u00e0o filesystem c\u1ee7a Nuxt, nh\u01b0ng \u0111i\u1ec1u n\u00e0y \u0111\u00e3 b\u1ecb c\u1ea4M b\u1edfi Hi\u1ebfn ph\u00e1p v\u00e0 c\u00f3 th\u1ec3 qu\u00e9t b\u1eb1ng DOT-integrity.\n- A8: [C\u00d3] \u2014 Thi\u1ebft k\u1ebf ho\u00e0n to\u00e0n ch\u1ecbu t\u1ea3i \u0111\u01b0\u1ee3c. Vi\u1ec7c t\u1eadp trung logic v\u00e0o m\u1ed9t s\u1ed1 \u00edt khu\u00f4n m\u1eabu gi\u00fap gi\u1ea3m complexity khi h\u1ec7 th\u1ed1ng ph\u00ecnh to v\u1ec1 s\u1ed1 l\u01b0\u1ee3ng instance.\n\n## B. NT10\n\n- B1: [Tr\u1ea3 l\u1eddi] \u2014 \u0110\u1ecbnh ngh\u0129a r\u1ea5t s\u1eafc b\u00e9n: "Mu\u1ed1n t\u1ef1 \u0111\u1ed9ng = ph\u1ea3i c\u00f3 collection + field trong PG". Agent kh\u00f4ng th\u1ec3 hi\u1ec3u nh\u1ea7m v\u00ec n\u00f3 ph\u00e2n \u0111\u1ecbnh r\u00f5 Documentation (Text) vs. Operational Truth (PG).\n- B2: [Tr\u1ea3 l\u1eddi] \u2014 Ph\u1ea1m vi ph\u00f9 h\u1ee3p. Ngo\u1ea1i l\u1ec7 duy nh\u1ea5t n\u00ean l\u00e0 c\u00e1c t\u00e0i li\u1ec7u tri\u1ebft l\u00fd/t\u1ea7m nh\u00ecn c\u1ea5p cao ho\u1eb7c Secrets (\u0111\u01b0\u1ee3c qu\u1ea3n l\u00fd b\u1eb1ng Secret Manager).\n- B3: [Tr\u1ea3 l\u1eddi] \u2014 KH\u00d4NG. NT10 l\u00e0 m\u1ea3nh gh\u00e9p c\u00f2n thi\u1ebfu \u0111\u1ec3 th\u1ef1c thi tri\u1ec7t \u0111\u1ec3 NT1 (SSOT) v\u00e0 NT3 (DOT 100%).\n- B4: [Tr\u1ea3 l\u1eddi] \u2014 Hi\u1ec7n t\u1ea1i c\u00e1c "\u0110i\u1ec1u lu\u1eadt" v\u1eabn \u0111ang \u1edf d\u1ea1ng Text (Markdown). \u0110\u1ec3 NT10 ho\u00e0n h\u1ea3o, b\u1ea3n th\u00e2n c\u00e1c quy t\u1eafc trong lu\u1eadt c\u1ea7n \u0111\u01b0\u1ee3c chuy\u1ec3n h\u00f3a th\u00e0nh b\u1ea3ng law_rules trong PG \u0111\u1ec3 DOT c\u00f3 th\u1ec3 t\u1ef1 check-in/check-out.\n\n## C. T\u1ed5ng th\u1ec3\n\n- C1: [L\u1ed7 h\u1ed5ng] \u2014 Ch\u01b0a c\u00f3 chi\u1ebfn l\u01b0\u1ee3c versioning cho khu\u00f4n m\u1eabu. N\u1ebfu code component thay \u0111\u1ed5i m\u00e0 schema c\u0169 kh\u00f4ng t\u01b0\u01a1ng th\u00edch, h\u1ec7 th\u1ed1ng c\u00f3 th\u1ec3 l\u1ed7i h\u00e0ng lo\u1ea1t. C\u1ea7n c\u00a1 ch\u1ebf "Template Versioning".\n- C2: [Over-engineering] \u2014 Checklist 8 b\u1ed9 ph\u1eadn c\u00f3 th\u1ec3 h\u01a1i n\u1eb7ng cho c\u00e1c UI component c\u1ef1c \u0111\u01a1n gi\u1ea3n (v\u00ed d\u1ee5: m\u1ed9t c\u00e1i badge m\u00e0u). C\u1ea7n ph\u00e2n lo\u1ea1i "Lightweight Template" vs "Core Template".\n- C3: [Thi\u1ebfu g\u00ec] \u2014 Thi\u1ebfu quy \u0111\u1ecbnh v\u1ec1 th\u1eddi gian s\u1ed1ng (TTL) ho\u1eb7c quy tr\u00ecnh "ngh\u1ec9 h\u01b0u" (Retirement) c\u1ee5 th\u1ec3 cho c\u00e1c instance c\u0169 khi khu\u00f4n m\u1eabu \u0111\u01b0\u1ee3c n\u00e2ng c\u1ea5p.\n- C4: \u0110i\u1ec3m 9/10. Thi\u1ebft k\u1ebf c\u1ef1c k\u1ef3 chuy\u00ean nghi\u1ec7p, b\u00e1m s\u00e1t tri\u1ebft l\u00fd "Gi\u1ea3i quy\u1ebft v\u1ea5n \u0111\u1ec1 V\u0121NH VI\u1ebeN".\n\n## Khuy\u1ebfn ngh\u1ecb c\u1ee5 th\u1ec3\n\n- S\u1eeda tr\u01b0\u1edbc khi ban h\u00e0nh: B\u1ed5 sung field version (INT) v\u00e0 min_app_version v\u00e0o collection design_templates.\n- B\u1ed5 sung: Th\u00eam m\u1ed9t m\u1ee5c nh\u1ecf trong Section IV v\u1ec1 "Performance Benchmark" cho c\u00e1c khu\u00f4n m\u1eabu ph\u1ee9c t\u1ea1p nh\u01b0 Matrix (TPL-002).\n- Gi\u1eef nguy\u00ean: To\u00e0n b\u1ed9 quy tr\u00ecnh test 5 lo\u1ea1i v\u00e0 c\u00a1 ch\u1ebf Whitelist.