v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:16:00.000Z▲ 0 upvotes

Solicitud inversa: cómo restaurar PRD y la arquitectura utilizando una interfaz existente

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Cuando sea necesario

Tienes una interfaz sin documentación: un proyecto heredado que necesita ser reescrito, el MVP de un contratista o tu propio código de hace dos años. Antes de cambiar algo, es necesario comprender qué hace el producto: qué pantallas, qué scripts, qué reglas de validación, qué API llama. La indicación inversa es la recopilación de hechos del código y su transferencia al modelo con la tarea de restaurar los requisitos.

Estamos hablando de un código al que tienes acceso legal. Restaurar los requisitos del producto de otra persona a partir de su paquete minimizado con el fin de copiarlo es una receta para problemas legales y un mal resultado: no queda claro en el paquete por qué el producto está diseñado de esta manera.

Por qué "leer el repositorio y escribir especificaciones técnicas" no funciona

En un proyecto con cientos de archivos, el agente no lo leerá hasta el final o llenará el contexto con fuentes y comenzará a generalizar desde los primeros archivos que encuentre. Como resultado, el PRD describe tres pantallas de veinte y presenta con confianza el resto. Se necesita una capa intermedia: un inventario comprimido, que recopilarás con scripts y comprobarás.

Paso 1. Rutas de inventario

Para el enrutador de aplicaciones Next.js:

find app -name 'page.tsx' -o -name 'page.jsx' | sed 's#/page\.[jt]sx$##; s#^app##' | sort > docs/re/routes.txt
find app -name 'route.ts' | sort > docs/re/api-routes.txt

Para React Router, busque declaraciones de ruta:

grep -rn --include='*.tsx' -E 'path:\s*"|<Route ' src | sort > docs/re/routes.txt

Paso 2. Llamadas de red

grep -rnE --include='*.ts' --include='*.tsx' \
  'fetch\(|axios\.(get|post|put|patch|delete)|useQuery|useMutation' src app \
  > docs/re/network-calls.txt

La búsqueda estática no ve las URL recopiladas dinámicamente. Complételo con tráfico real: revise los escenarios básicos en un navegador con la pestaña Red abierta y guarde el HAR. Antes de transferir el modelo, borre las cookies, los tokens de autorización y los datos personales de HAR.

Paso 3. Formularios y reglas de validación

grep -rnE --include='*.ts' --include='*.tsx' \
  'z\.object|yup\.object|useForm\(|required:|pattern:' src app > docs/re/validation.txt

Los esquemas de validación son la fuente más densa de reglas comerciales: longitudes mínimas, formatos telefónicos, campos obligatorios, dependencias entre campos.

Paso 4. Transferir el modelo en partes

No envíes todo a la vez. Primero el mapa del producto:

Ниже список маршрутов приложения и список сетевых вызовов с путями к файлам.
Составь карту продукта:
1. Группы экранов по пользовательским задачам.
2. Для каждого экрана: назначение, откуда на него попадают, какие API вызывает.
3. Роли пользователей, если их можно вывести из маршрутов (admin, dashboard и т.п.).

Правила:
- Каждое утверждение помечай [код: путь/к/файлу] или [гипотеза].
- Если назначение экрана неочевидно из названия и вызовов, напиши "не определено" и укажи,
  какой файл нужно прочитать, чтобы это выяснить.
- Не придумывай функциональность, которой нет во входных данных.

Luego, para cada grupo de pantallas, una solicitud separada con las fuentes de solo estos archivos y la tarea de describir los escenarios, estados (vacío, cargando, error, sin derechos) y reglas de validación.

Paso 5. Armado del PRD

Es útil mantener el documento resultante en una estructura fija para que pueda compararse entre iteraciones:

# PRD: <продукт> (восстановлен по коду, дата)

## Пользователи и роли
## Сценарии
### <Сценарий>: шаги, экраны, API, правила, ошибки
## Модель данных (по ответам API и типам)
## Внешние интеграции
## Нефункциональные наблюдения (авторизация, кеширование, i18n)
## Открытые вопросы
## Расхождения и подозрительные места

La sección de discrepancia suele ser la más valiosa: validación en el cliente que no está presente en el servidor; pantallas sin enlaces a ellas; Llamadas API cuya respuesta no se utiliza en ninguna parte.

Paso 6. Verificar

El modelo escribe con confianza cosas plausibles. Se requiere verificación:

  • Tome cinco declaraciones aleatorias marcadas [код: ...] y abra los archivos especificados.
  • Confirme todos los puntos [гипотеза] con el propietario del producto o muévalos a preguntas abiertas.
  • Recorra un escenario utilizando el PRD con las manos, desde la entrada hasta el resultado. Si los pasos no coinciden con la realidad, regrese al grupo de pantallas correspondiente.

Arquitectura separada de los requisitos

La descripción de la arquitectura (capas, gestión de estado, trabajo con datos) es otra tarea con una entrada diferente: árbol de directorios, package.json, configuraciones de ensamblaje, varios archivos de características de cada tipo. No lo mezcle con PRD en la misma consulta: el modelo comenzará a describir detalles técnicos en lugar del comportamiento del producto.

Limitaciones del enfoque

El código muestra qué hace el producto, pero no por qué. Los motivos comerciales, los requisitos legales y los acuerdos con socios no se pueden restaurar desde el principio. La lógica del backend, al que no tienes acceso, sólo es visible en forma de solicitudes y respuestas. Si el propietario del producto está disponible, una hora de conversación con él sobre el borrador terminado del PRD producirá más que unas pocas iteraciones más de indicaciones.

Нужна реализация под ваш проект или аудит архитектуры?

Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.

Обсуждение (0)

Ещё на vbcd4u.com