standards clean
This commit is contained in:
@@ -1,5 +1,5 @@
|
|||||||
# [DEF:Std:API_FastAPI:Standard]
|
# [DEF:Std:API_FastAPI:Standard]
|
||||||
# @TIER: CRITICAL
|
# @COMPLEXITY: 5
|
||||||
# @PURPOSE: Unification of all FastAPI endpoints following GRACE-Poly.
|
# @PURPOSE: Unification of all FastAPI endpoints following GRACE-Poly.
|
||||||
# @LAYER: UI (API)
|
# @LAYER: UI (API)
|
||||||
# @INVARIANT: All non-trivial route logic must be wrapped in `belief_scope`.
|
# @INVARIANT: All non-trivial route logic must be wrapped in `belief_scope`.
|
||||||
@@ -9,7 +9,7 @@
|
|||||||
Every API route file must start with a module definition header:
|
Every API route file must start with a module definition header:
|
||||||
```python
|
```python
|
||||||
# [DEF:ModuleName:Module]
|
# [DEF:ModuleName:Module]
|
||||||
# @TIER: [CRITICAL | STANDARD | TRIVIAL]
|
# @COMPLEXITY: [1-5]
|
||||||
# @SEMANTICS: list, of, keywords
|
# @SEMANTICS: list, of, keywords
|
||||||
# @PURPOSE: High-level purpose of the module.
|
# @PURPOSE: High-level purpose of the module.
|
||||||
# @LAYER: UI (API)
|
# @LAYER: UI (API)
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
# [DEF:Std:Architecture:Standard]
|
# [DEF:Std:Architecture:Standard]
|
||||||
# @TIER: CRITICAL
|
# @COMPLEXITY: 5
|
||||||
# @PURPOSE: Core architectural decisions and service boundaries.
|
# @PURPOSE: Core architectural decisions and service boundaries.
|
||||||
# @LAYER: Infra
|
# @LAYER: Infra
|
||||||
# @INVARIANT: ss-tools MUST remain a standalone service (Orchestrator).
|
# @INVARIANT: ss-tools MUST remain a standalone service (Orchestrator).
|
||||||
@@ -15,11 +15,9 @@
|
|||||||
## 2. COMPONENT BOUNDARIES
|
## 2. COMPONENT BOUNDARIES
|
||||||
* **Plugins:** All business logic must be encapsulated in Plugins (`backend/src/plugins/`).
|
* **Plugins:** All business logic must be encapsulated in Plugins (`backend/src/plugins/`).
|
||||||
* **TaskManager:** All long-running operations MUST be handled by the TaskManager.
|
* **TaskManager:** All long-running operations MUST be handled by the TaskManager.
|
||||||
* **Security:** Independent RBAC system managed in `auth.db`.
|
|
||||||
|
|
||||||
## 3. INTEGRATION STRATEGY
|
## 3. INTEGRATION STRATEGY
|
||||||
* **Superset API:** Communication via REST API.
|
* **Superset API:** Communication via REST API.
|
||||||
* **Database:** Local SQLite for metadata (`tasks.db`, `auth.db`, `migrations.db`).
|
|
||||||
* **Filesystem:** Local storage for backups and git repositories.
|
* **Filesystem:** Local storage for backups and git repositories.
|
||||||
|
|
||||||
# [/DEF:Std:Architecture]
|
# [/DEF:Std:Architecture]
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
# [DEF:Std:Constitution:Standard]
|
# [DEF:Std:Constitution:Standard]
|
||||||
# @TIER: CRITICAL
|
# @COMPLEXITY: 5
|
||||||
# @PURPOSE: Supreme Law of the Repository. High-level architectural and business invariants.
|
# @PURPOSE: Supreme Law of the Repository. High-level architectural and business invariants.
|
||||||
# @VERSION: 2.3.0
|
# @VERSION: 2.3.0
|
||||||
# @LAST_UPDATE: 2026-02-19
|
# @LAST_UPDATE: 2026-02-19
|
||||||
@@ -23,7 +23,6 @@
|
|||||||
|
|
||||||
### IV. Security & RBAC
|
### IV. Security & RBAC
|
||||||
* **Permissions:** Every Plugin must define unique permission strings (e.g., `plugin:name:execute`).
|
* **Permissions:** Every Plugin must define unique permission strings (e.g., `plugin:name:execute`).
|
||||||
* **Auth:** Mandatory registration in `auth.db`.
|
|
||||||
|
|
||||||
### V. Independent Testability
|
### V. Independent Testability
|
||||||
* **Requirement:** Every feature must define "Independent Tests" for isolated verification.
|
* **Requirement:** Every feature must define "Independent Tests" for isolated verification.
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
# [DEF:Std:Plugin:Standard]
|
# [DEF:Std:Plugin:Standard]
|
||||||
# @TIER: CRITICAL
|
# @COMPLEXITY: 5
|
||||||
# @PURPOSE: Standards for building and integrating Plugins.
|
# @PURPOSE: Standards for building and integrating Plugins.
|
||||||
# @LAYER: Domain (Plugin)
|
# @LAYER: Domain (Plugin)
|
||||||
# @INVARIANT: All plugins MUST inherit from `PluginBase`.
|
# @INVARIANT: All plugins MUST inherit from `PluginBase`.
|
||||||
|
|||||||
@@ -30,7 +30,7 @@
|
|||||||
|
|
||||||
## III. ТОПОЛОГИЯ ФАЙЛА (СТРОГИЙ ПОРЯДОК)
|
## III. ТОПОЛОГИЯ ФАЙЛА (СТРОГИЙ ПОРЯДОК)
|
||||||
1. **HEADER (Заголовок):**[DEF:filename:Module]
|
1. **HEADER (Заголовок):**[DEF:filename:Module]
|
||||||
@COMPLEXITY: [1|2|3|4|5] *(алиас: `@C:`; legacy `@TIER` допустим только для обратной совместимости)*
|
@COMPLEXITY: [1|2|3|4|5] *(алиас: `@C:`)*
|
||||||
@SEMANTICS: [keywords]
|
@SEMANTICS: [keywords]
|
||||||
@PURPOSE: [Однострочная суть]
|
@PURPOSE: [Однострочная суть]
|
||||||
@LAYER: [Domain | UI | Infra]
|
@LAYER: [Domain | UI | Infra]
|
||||||
@@ -92,10 +92,6 @@
|
|||||||
- Для UI требуются UX-контракты.
|
- Для UI требуются UX-контракты.
|
||||||
- Использование `belief_scope` строго обязательно.
|
- Использование `belief_scope` строго обязательно.
|
||||||
|
|
||||||
**Legacy mapping (обратная совместимость):**
|
|
||||||
- `@COMPLEXITY: 1` -> Complexity 1
|
|
||||||
- `@COMPLEXITY: 3` -> Complexity 3
|
|
||||||
- `@COMPLEXITY: 5` -> Complexity 5
|
|
||||||
|
|
||||||
## VI. ПРОТОКОЛ ЛОГИРОВАНИЯ (THREAD-LOCAL BELIEF STATE)
|
## VI. ПРОТОКОЛ ЛОГИРОВАНИЯ (THREAD-LOCAL BELIEF STATE)
|
||||||
Логирование — это механизм трассировки рассуждений ИИ (CoT) и управления Attention Energy. Архитектура использует Thread-local storage (`_belief_state`), поэтому `ID` прокидывается автоматически.
|
Логирование — это механизм трассировки рассуждений ИИ (CoT) и управления Attention Energy. Архитектура использует Thread-local storage (`_belief_state`), поэтому `ID` прокидывается автоматически.
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
# [DEF:Std:UI_Svelte:Standard]
|
# [DEF:Std:UI_Svelte:Standard]
|
||||||
# @TIER: CRITICAL
|
# @COMPLEXITY: 5
|
||||||
# @PURPOSE: Unification of all Svelte components following GRACE-Poly (UX Edition).
|
# @PURPOSE: Unification of all Svelte components following GRACE-Poly (UX Edition).
|
||||||
# @LAYER: UI
|
# @LAYER: UI
|
||||||
# @INVARIANT: Every component MUST have `<!-- [DEF:] -->` anchors and UX tags.
|
# @INVARIANT: Every component MUST have `<!-- [DEF:] -->` anchors and UX tags.
|
||||||
@@ -28,7 +28,7 @@ Each Svelte file must follow this structure:
|
|||||||
<!-- [DEF:ComponentName:Component] -->
|
<!-- [DEF:ComponentName:Component] -->
|
||||||
<script>
|
<script>
|
||||||
/**
|
/**
|
||||||
* @TIER: [CRITICAL | STANDARD | TRIVIAL]
|
* @COMPLEXITY: [1-5]
|
||||||
* @PURPOSE: Brief description of the component purpose.
|
* @PURPOSE: Brief description of the component purpose.
|
||||||
* @LAYER: UI
|
* @LAYER: UI
|
||||||
* @SEMANTICS: list, of, keywords
|
* @SEMANTICS: list, of, keywords
|
||||||
|
|||||||
16580
.ai/structure/PROJECT_MAP.md
Normal file
16580
.ai/structure/PROJECT_MAP.md
Normal file
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user