Estado y Hoja de Ruta
Qué se ha lanzado, qué está en progreso y qué está planificado para AACsearch.
Esta página es la referencia autorizada para el estado de las características. Úsela para comprender qué es seguro
utilizar en producción, qué se está construyendo activamente y qué permanece en la hoja de ruta.
Estas características existen en el código base y están listas para usar.
| Característica | Paquete / archivo |
|---|
| Cliente AACSearch (solo lado del servidor) | packages/search/lib/client.ts |
| Gestión del esquema de colección + versionado | packages/search/lib/collections.ts |
| Buffer de ingestión con prioridad en base de datos | packages/search/lib/buffer.ts |
| searchDocuments / multiSearchDocuments | packages/search/lib/search.ts |
| Reindexación con intercambio de alias sin tiempo de inactividad | packages/search/lib/reindex.ts |
| Generación + hash de API keys | packages/search/lib/keys.ts |
| SDK del navegador | packages/search-client/src/index.ts |
| Característica | Notas |
|---|
| Autenticación con ámbito de organización vía Better Auth | Las organizaciones son el workspace principal |
| API keys (hasheadas, con ámbito, restricción de origen) | Prefijos: ss_search_*, ss_connector_*, ss_scoped_* |
| Tokens de búsqueda con ámbito (HMAC) | Sin estado, firmados sobre BETTER_AUTH_SECRET |
| Aplicación de cuota por plan | packages/api/modules/entitlements/ |
| Límite de velocidad por clave/IP | packages/search/lib/keys.ts + bucket de base de datos |
| Característica | Notas |
|---|
| Widget alojado | packages/widget/ — Vanilla JS, Shadow DOM, 14 KB |
| API de conector | 7 endpoints: handshake, heartbeat, sync.full, sync.delta, delete, diagnostics, sync/status |
| CRUD de token de conector | searchRouter.{createConnectorToken, listConnectorTokens, revokeConnectorToken} |
| Seguimiento de trabajos de sincronización (en memoria) | Se pierde al reiniciar — aceptable para MVP |
| Característica | Notas |
|---|
| Sinónimos | searchRouter.synonyms.{get,update} |
| Curaciones | searchRouter.curations.{get,update} |
| Gestión del esquema de colección | searchRouter.schema.{get,update} |
RAG/GraphRAG sobre documentos. Superficie de producto separada de la búsqueda en tienda.
- Modelos Prisma:
KnowledgeSpace, DataSource, IngestionJob, KnowledgeDocument, KnowledgeChunk, GraphNode, GraphEdge
- 10 procedimientos oRPC: listar/crear espacios, listar/crear fuentes, listar trabajos de ingestión, ingestar-archivo, preguntar, graphrag-explicar, métricas-uso
- UI
KnowledgeWorkbench.tsx, rutas de ámbito de org + ámbito de cuenta
Estas características están en desarrollo activo y pueden cambiar.
| Característica | Estado |
|---|
| Medición v0.6 (recarga Tochka, wallet) | packages/billing-wallet/, packages/payments/provider/tochka-wallet/ |
Agregación de resumen de recordSearchUsage | Las filas crudas existen; tabla UsageCounter diferida |
| Páginas de administración (auditoría, wallet, notificaciones, seguridad) | Confirmadas como stubs — contenido operativo pendiente |
| Característica | Notas |
|---|
| Módulo PrestaShop | modules/prestashop/aacsearch/ — PHP, pista de confirmación separada |
| Módulo Bitrix | modules/bitrix/aac.search/ — PHP, pista de confirmación separada |
Estos módulos tienen la estructura de archivos correcta (Aacsearch.php, config.xml, classes/, controllers/, views/)
pero no se rastrean en el repositorio principal. Siguen el contrato de la API de conector descrito en
Ciclo de vida de la API de conector.
| Característica | Objetivo |
|---|
| Inicio rápido autoalojado + Helm chart | v1.0 |
Project como entidad de primera clase en BD | v1.x (requiere descongelamiento de BD) |
Modelo BD WidgetConfig | v1.x (requiere descongelamiento de BD) |
Endpoint de captura de AnalyticsEvent | v1.x |
Procedimiento recentActivity | v1.x |
| Sub-pestañas de Stopwords + Presets | v1.x |
| UI del Gestor de esquemas | v1.x |
Los siguientes están explícitamente no planificados para v1:
- Chat de IA / búsqueda conversacional
- Perfiles de personalización por visitante
- Motor de recomendaciones
- Pruebas A/B para relevancia
- SSO empresarial (SAML/OIDC)
- Replicación multi-región de AACSearch
- Clústeres dedicados de un solo tenant
- Conectores más allá de PrestaShop y Bitrix
- Analíticas BI profundas más allá de las tarjetas del panel
| Versión | Objetivo | Estado |
|---|
| R0 | Fundación — andamiaje AACSearch + AACsearch | ✅ Completado |
| R1 | Corte vertical — la búsqueda funciona de extremo a extremo sin CMS | ✅ Completado |
| R2 | Alpha de conector — las tiendas reales comienzan a sincronizar | 🟡 Parcialmente lanzado |
| R2.5 | Módulo de conocimiento (RAG/GraphRAG) | ✅ Completado |
| v0.5 | Rediseño del sitio de marketing en 5 idiomas | ✅ Completado |
| v0.6 | Medición de unidades de búsqueda vinculada al proveedor de pago | 🟡 En desarrollo activo |
| v0.7 | Sitio de documentación pública | 🟡 Aquí está usted |
| v1.0 | Inicio rápido autoalojado + Helm chart | ⏳ Planificado |
